Added event attendees

Author: Steven Cummings

README.rst

@@ -29,3 +29,8 @@ Example Usage
     u'Monthly Meetup: Google App Engine'
     >>> last_meetup.time
     datetime.datetime(2011, 7, 9, 14, 0, tzinfo=tzoffset(None, -18000))
+    >>> an_attendee = meetups.get_event_attendees(last_meetup.id)[0]
+    >>> an_attendee.name
+    u'Steven Cummings'
+    >>> an_attendee.photo.thumb_url
+    u'http://photos1.meetupstatic.com/photos/member/2/e/f/5/thumb_16212021.jpeg'

docs/changelog.rst

@@ -4,8 +4,14 @@ Changelog
 Releases
 --------
 
+* `Release 0.0.2 - TBD`_
 * `Release 0.0.1 - August 7, 2011`_
 
+Release 0.0.2 - TBD
+-------------------
+
+* Added ``PythonKCMeetups.get_event_attendees``
+
 Release 0.0.1 - August 7, 2011
 ------------------------------
 

pythonkc_meetups/client.py

@@ -11,13 +11,16 @@
 from pythonkc_meetups.exceptions import PythonKCMeetupsNotJson
 from pythonkc_meetups.exceptions import PythonKCMeetupsRateLimitExceeded
 from pythonkc_meetups.parsers import parse_event
+from pythonkc_meetups.parsers import parse_member_from_rsvp
 import httplib2
 import json
 import mimeparse
 import urllib
 
 
-EVENTS_URL = 'https://api.meetup.com/2/events.json'
+MEETUP_API_HOST = 'https://api.meetup.com'
+EVENTS_URL = MEETUP_API_HOST + '/2/events.json'
+RSVPS_URL = MEETUP_API_HOST + '/2/rsvps.json'
 GROUP_URLNAME = 'pythonkc'
 
 
@@ -101,6 +104,35 @@ def get_past_events(self):
         events = data['results']
         return [parse_event(event) for event in events]
 
+    def get_event_attendees(self, event_id):
+        """
+        Get the attendees of the identified event.
+
+        Parameters
+        ----------
+        event_id
+            ID of the event to get attendees for.
+
+        Returns
+        -------
+        List of ``pythonkc_meetups.types.MeetupMember``.
+
+        Exceptions
+        ----------
+        * PythonKCMeetupsBadJson
+        * PythonKCMeetupsBadResponse
+        * PythonKCMeetupsMeetupDown
+        * PythonKCMeetupsNotJson
+        * PythonKCMeetupsRateLimitExceeded
+
+        """
+        query = urllib.urlencode({'key': self._api_key,
+                                  'event_id': event_id})
+        url = '{0}?{1}'.format(RSVPS_URL, query)
+        data = self._http_get_json(url)
+        rsvps = data['results']
+        return [parse_member_from_rsvp(rsvp) for rsvp in rsvps]
+
     def _http_get_json(self, url):
         """
         Make an HTTP GET request to the specified URL, check that it returned a

pythonkc_meetups/parsers.py

@@ -9,6 +9,8 @@
 from dateutil.tz import tzoffset
 from dateutil.tz import tzutc
 from pythonkc_meetups.types import MeetupEvent
+from pythonkc_meetups.types import MeetupMember
+from pythonkc_meetups.types import MeetupMemberPhoto
 from pythonkc_meetups.types import MeetupVenue
 import datetime
 
@@ -63,6 +65,41 @@ def parse_venue(data):
         )
 
 
+def parse_member_from_rsvp(data):
+    """
+    Parse a ``MeetupMember`` from the given RSVP response data.
+
+    Returns
+    -------
+    A ``pythonkc_meetups.types.MeetupMember``.
+
+    """
+    return MeetupMember(
+        id=data['member'].get('member_id', None),
+        name=data['member'].get('name', None),
+        photo=parse_member_photo(data.get('member_photo', None))
+    )
+
+
+def parse_member_photo(data):
+    """
+    Parse a ``MeetupMemberPhoto`` from the given response data.
+
+    Returns
+    -------
+    A `pythonkc_meetups.types.`MeetupMemberPhoto`` if non-empty data is given,
+    otherwise ``None``.
+
+    """
+    if data:
+        return MeetupMemberPhoto(
+            id=data.get('id', None),
+            url=data.get('photo_link', None),
+            highres_url=data.get('highres_link', None),
+            thumb_url=data.get('thumb_link', None)
+        )
+
+
 def parse_datetime(utc_timestamp_ms, utc_offset_ms):
     """
     Create a timezone-aware ``datetime.datetime`` from the given UTC timestamp

pythonkc_meetups/types.py

@@ -56,6 +56,26 @@
 lon
     Geographical longitude.
 
+MeetupMember
+------------
+id
+    Meetup.com ID for the member.
+name
+    Full name (first & last) of the member.
+photo
+    A ``MeetupMemberPhoto`` containing URLs to this member's photo resources.
+
+MeetupMemberPhoto
+-----------------
+id
+    Meetup.com ID for the member photo.
+url
+    URL of the member photo resource.
+highres_url
+    URL of the high-resolution version of the member photo.
+thumb_url
+    URL of the thumbnail version of the member photo.
+
 """
 
 
@@ -69,3 +89,8 @@
 MeetupVenue = namedtuple('MeetupVenue',
         ['id', 'name', 'address_1', 'address_2', 'address_3', 'city', 'state',
          'zip', 'country', 'lat', 'lon'])
+
+MeetupMember = namedtuple('MeetupMember', ['id', 'name', 'photo'])
+
+MeetupMemberPhoto = namedtuple('MeetupMemberPhoto', 
+        ['id', 'url', 'highres_url', 'thumb_url'])

setup.py

@@ -7,7 +7,7 @@
 
 setup(
     name='pythonkc-meetups',
-    version='0.0.1',
+    version='0.0.2',
     description='Provides PythonKC Meetup.com events.',
     license='MIT',
     url='https://github.com/estebistec/pythonkc-meetups',