^ Hopefully, the build is working... but sometimes reports as broken because the API rate limit is very, very small.
Python wrapper for Marvel API
Full Documentation at http://pymarvel.readthedocs.org
PyMarvel takes care of authorization and provides convenient methods calling the API. Easily traverse the relationship between resources. PyMarvel automatically decodes Marvel's JSON response into Python objects and primitives.
pip install -U git+https://github.com/Rocked03/PyMarvel#egg=PyMarvel
Python Package Index
https://pypi.python.org/pypi/PyMarvel
>>> m = Marvel(public_key, private_key)
>>> character_data_wrapper = m.get_characters(orderBy="name,-modified", limit="5", offset="15")
>>> print character_data_wrapper.status
Ok
>>> print character_data_wrapper.data.total
1402
>>> for character in character_data_wrapper.data.results
>>> print character.name
Aginar
Air-Walker (Gabriel Lan)
Ajak
Ajaxis
Akemi
Requesting a resource returns a DataWrapper, which containers information about the the success of response. The data property of a DataWrapper is a DataContainer, which contains information about the set of resources returned. The results property of a DataContainer is a List of Resources (Character, Comic, Event, etc).
>>> m = Marvel(public_key, private_key)
>>> character_data_wrapper = m.get_characters(limit="10", offset="700")
>>> print(character_data_wrapper)
<marvel.character.CharacterDataWrapper object>
>>> print(character_data_wrapper.data)
<marvel.character.CharacterDataContainer object>
>>> print(character_data_wrapper.data.results[0])
<marvel.character.Character object>
{ __
"code": 200, |
"status": "Ok", |---- CharacterDataWrapper
"etag": "e59a70a964ab45cc40948dcd3fb7faa0783bcae7", |
"data": __|
{ __ \/
"offset": 700, |
"limit": 10, |
"total": 1402, |---- CharacterDataContainer
"count": 10, |
"results": [ __|
{ __ \/
"id": 1017477, |
"name": "Magneto (X-Men: Battle of the Atom)", |---- Character
"description": "", |
"modified": "2014-01-15T19:43:09-0500", __|
...
Find Stan Lee's comics:
>>> stan_lee = m.get_creator(30).data.result
>>> comics = stan_lee.get_comics()
You can chain methods into one line:
>>> comics = m.get_creator(30).data.result.get_comics()
or even:
>>> events = self.m.get_series(characters="1009718").data.result.get_characters().data.result.get_comics().data.results.get_creators().data.result.get_events()
would be the equivalent to calling:
https://gateway.marvel.com/v1/public/series?characters=100971
https://gateway.marvel.com/v1/public/series/15276/characters
https://gateway.marvel.com/v1/public/characters/1009351/comics
https://gateway.marvel.com/v1/public/comics/50372/creators
https://gateway.marvel.com/v1/public/creators/4600/events
>>> xmen = m.get_single_series(403).data.results.get_characters(limit=5)
>>> for xm in xmen.data.results:
... print xm.name
Archangel
Banshee
Beast
Bishop
Black Panther
>>> more_xmen = xmen.next()
>>> for xm in more_xmen.data.results:
... print xm.name
Cable
Cannonball
Colossus
Cyclops
Emma Frost
Clone the repo at http://github.com/gpennington/PyMarvel
Feel free to log issues in Github or, better yet, submit a Pull Request against the develop branch.
PyMarvel is distributed under the MIT License.