Merge pull request #12 from PokeAPI/beckett

Uses Beckett API Client Framework

Author: phalt

.gitignore

@@ -4,7 +4,8 @@
 *.so
 
 # Packages
-*.egg
+*.egg*
+*.cache
 *.egg-info
 dist
 build

.travis.yml

@@ -4,10 +4,9 @@ language: python
 
 python:
   - "2.7"
-  - "pypy"
 
 # command to install dependencies, e.g. pip install -r requirements.txt --use-mirrors
 install: pip install -r requirements.txt
 
 # command to run tests, e.g. python setup.py test
-script: python setup.py test
+script: py.test test

HISTORY.rst

@@ -3,6 +3,11 @@
 History
 -------
 
+0.2.0 (2016-06-11)
+++++++++++++++++++
+
+* Beckett API Client framework added
+
 0.1.2 (2014-1-3)
 ++++++++++++++++++
 

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2014, Paul Hallett
+Copyright (c) 2016, Paul Hallett
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Makefile

@@ -27,7 +27,7 @@ lint:
 	flake8 pykemon tests
 
 test:
-	python setup.py test
+	py.test tests/
 
 test-all:
 	tox

README.rst

@@ -32,12 +32,9 @@ Even simpler:
 .. code-block:: python
 
     >>> import pykemon
-    >>> pykemon.get(pokemon='bulbasaur')
-    <Pokemon - Bulbasaur>
-    >>> p = pykemon.get(pokemon_id=1)
-    <Pokemon - Bulbasaur>
-    >>> pykemon.get(move_id=15)
-    <Move - cut>
+    >>> client = pykemon.V1Client()
+    >>> p = client.get_pokemon(uid=1)
+    [<Pokemon - Bulbasaur>]
 
 
 Features

docs/index.rst

@@ -4,7 +4,7 @@
    contain the root `toctree` directive.
 
 Welcome to Pykemon's documentation!
-======================================
+===================================
 
 Contents:
 

docs/usage.rst

@@ -6,6 +6,33 @@ To use Pykemon in a project::
 
 >>> import pykemon
 
+=======
+New API
+=======
+
+Since version 0.2.0, Pykemon now works with `Beckett <https://phalt.github.io/beckett>`_, an easy to use API Client Framework::
+
+   >>> client = pykemon.V1Client()
+   >>> bulba = client.get_pokemon(uid=1)[0]
+   <Pokemon | Bulbasaur>
+   >>> bulba.name
+   Bulbasaur
+
+The following methods work with this client and all take a `uid` parameter:
+
+* get_pokemon
+* get_move
+* get_sprite
+* get_ability
+* get_game
+* get_type
+* get_egg
+
+
+================
+Version 0.1* API
+================
+
 Then you can start grabbing stuff from the API::
 
     >>> pykemon.get(pokemon='mew')
@@ -57,4 +84,3 @@ The Pokemon resource can also be requested using the name:
     <Pokemon - Rotom>
 
 Make sure you use lower case strings!
-

pykemon/__init__.py

@@ -3,12 +3,12 @@
 
 __author__ = 'Paul Hallett'
 __email__ = 'hello@phalt.co'
-__version__ = '0.1.2'
-__copyright__ = 'Copyright Paul Hallett 2014'
+__version__ = '0.2.0'
+__copyright__ = 'Copyright Paul Hallett 2016'
 __license__ = 'BSD'
 
-from api import get
-from exceptions import ResourceNotFoundError
+from api import get, V1Client  # NOQA
+from exceptions import ResourceNotFoundError  # NOQA
 
 
 """

pykemon/api.py

@@ -6,9 +6,16 @@
 User interaction with this package is done through this file.
 """
 
+from beckett.clients import BaseClient
+
 from request import CHOICES
 from request import make_request
 
+from .resources import (
+    MoveResource, PokemonResource, TypeResource, AbilityResource, EggResource,
+    DescriptionResource, SpriteResource, GameResource
+)
+
 
 def get(**kwargs):
     """
@@ -36,3 +43,20 @@ def get(**kwargs):
 
     else:
         raise ValueError('An invalid argument was passed')
+
+
+class V1Client(BaseClient):
+
+    class Meta(BaseClient.Meta):
+        name = 'pykemon-v1-client'
+        base_url = 'http://pokeapi.co/api/v1'
+        resources = (
+            MoveResource,
+            PokemonResource,
+            TypeResource,
+            AbilityResource,
+            EggResource,
+            DescriptionResource,
+            SpriteResource,
+            GameResource,
+        )