Added get_past_events

Author: Steven Cummings

README.md

@@ -22,3 +22,8 @@ Example Usage
     9
     >>> next_meetup.event_url
     u'http://www.meetup.com/pythonkc/events/25940081/'
+    >>> last_meetup = meetups.get_past_events()[0]
+    >>> last_meetup.name
+    u'Monthly Meetup: Google App Engine'
+    >>> last_meetup.time
+    datetime.datetime(2011, 7, 9, 14, 0, tzinfo=tzoffset(None, -18000))

pythonkc_meetups/client.py

@@ -49,13 +49,21 @@ def __init__(self, api_key, http_timeout=1, http_retries=2):
 
     def get_upcoming_events(self):
         """
-        Get the upcoming PythonKC meetup events.
+        Get upcoming PythonKC meetup events.
 
         Returns
         -------
         List of ``pythonkc_meetups.types.MeetupEvent``, ordered by event time,
         ascending.
 
+        Exceptions
+        ----------
+        * PythonKCMeetupsBadJson
+        * PythonKCMeetupsBadResponse
+        * PythonKCMeetupsMeetupDown
+        * PythonKCMeetupsNotJson
+        * PythonKCMeetupsRateLimitExceeded
+
         """
 
         query = urllib.urlencode({'key': self._api_key,
@@ -65,6 +73,34 @@ def get_upcoming_events(self):
         events = data['results']
         return [parse_event(event) for event in events]
 
+    def get_past_events(self):
+        """
+        Get past PythonKC meetup events.
+
+        Returns
+        -------
+        List of ``pythonkc_meetups.types.MeetupEvent``, ordered by event time,
+        descending.
+
+        Exceptions
+        ----------
+        * PythonKCMeetupsBadJson
+        * PythonKCMeetupsBadResponse
+        * PythonKCMeetupsMeetupDown
+        * PythonKCMeetupsNotJson
+        * PythonKCMeetupsRateLimitExceeded
+
+        """
+
+        query = urllib.urlencode({'key': self._api_key,
+                                  'group_urlname': GROUP_URLNAME,
+                                  'status': 'past',
+                                  'desc': 'true'})
+        url = '{0}?{1}'.format(EVENTS_URL, query)
+        data = self._http_get_json(url)
+        events = data['results']
+        return [parse_event(event) for event in events]
+
     def _http_get_json(self, url):
         """
         Make an HTTP GET request to the specified URL, check that it returned a
@@ -82,10 +118,10 @@ def _http_get_json(self, url):
         Exceptions
         ----------
         * PythonKCMeetupsBadJson
-        * PythonKCMeetupsNotJson
+        * PythonKCMeetupsBadResponse
         * PythonKCMeetupsMeetupDown
+        * PythonKCMeetupsNotJson
         * PythonKCMeetupsRateLimitExceeded
-        * PythonKCMeetupsBadResponse
 
         """
         response, content = self._http_get(url)
@@ -117,9 +153,9 @@ def _http_get(self, url):
 
         Exceptions
         ----------
+        * PythonKCMeetupsBadResponse
         * PythonKCMeetupsMeetupDown
         * PythonKCMeetupsRateLimitExceeded
-        * PythonKCMeetupsBadResponse
 
         """
         for try_number in range(self._http_retries + 1):