# -*- coding: utf-8 -*- """ convore.api ~~~~~~~~~~~ This module implements the Convore API wrapper objects. :copyright: (c) 2011 by Kenneth Reitz. :license: ISC, see LICENSE for more details. """ from convore.packages.anyjson import deserialize import requests from types import SyncedList import models import groups API_URL = 'https://convore.com/api/' AUTH = None # ======= # Helpers # ======= def _safe_response(r, error=None): try: r.raise_for_status() return r except requests.HTTPError: if r.status_code == 401: raise LoginFailed else: raise APIError(error) if error else APIError def get(*path, **kwargs): """ Accepts optional error parameter, which will be passed in the event of a non-401 HTTP error. api.get('groups') api.get('groups', 'id') api.get('accounts', 'verify') """ url = '%s%s%s' % (API_URL, '/'.join(map(str, path)), '.json') params = kwargs.get('params', None) r = requests.get(url, params=params, auth=auth) error = kwargs.get('error', None) return _safe_response(r, error) def post(params, *path): url = '%s%s%s' % (API_URL, '/'.join(map(str, path)), '.json') r = requests.post(url, params=params, auth=auth) return _safe_response(r) # ========== # Exceptions # ========== class LoginFailed(RuntimeError): """Login falied!""" class APIError(RuntimeError): """There was a problem properly accessing the Convore API.""" def login(username, password): """Configured API Credentials""" global auth auth = (username, password) # print requests.auth_manager.__dict__ # ========== # End Points # ========== class Groups(SyncedList): __data_keys__ = ['id', 'slug'] def __init__(self): super(Groups, self).__init__() self.discover = groups.GroupsDiscover() self.discover.parent = self def joined(self): """Returns list of Joined groups.""" return [g for g in self.data if g.joined] def get(self, key): r = get('groups', key) group = models.Group() group.import_from_api(deserialize(r.content)['group']) return group def sync(self): self.data = [] r = get('groups') for _group in deserialize(r.content)['groups']: group = models.Group() group.import_from_api(_group) group.joined = True self.data.append(group) class Topics(SyncedList): __data_keys__ = [] def __init__(self): pass def import_from_api(self, d): print d