Metadata-Version: 2.1
Name: pybomb
Version: 0.2.0
Summary: Clients for the Giant Bomb API
Home-page: https://github.com/steveYeah/PyBomb
Author: Steve Hutchins
Author-email: hutchinsteve@gmail.com
License: MIT
Download-URL: https://github.com/steveYeah/PyBomb/archive/v0.2.0.tar.gz
Keywords: giantbombgiant,bomb,game,api,client
Platform: UNKNOWN
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: dev
Requires-Dist: requests
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pycodestyle; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: sphinx; extra == 'dev'
Requires-Dist: sphinx-autobuild; extra == 'dev'

.. image:: https://img.shields.io/travis/steveYeah/PyBomb.svg?branch=master
   :target: https://travis-ci.org/steveYeah/PyBomb

PyBomb
==============

.. pull-quote::
  Simple clients for the Giant Bomb API.
  http://www.giantbomb.com/api/

This will go into version 1.0 when all resources are supported.

**Currently Supported Resources**:

* games
* game

Install
-------

.. code-block:: shell

   pip install pybomb


Examples
--------
**GamesClient - search**

.. code-block::

   import pybomb

   my_key = your_giant_bomb_api_key
   games_client = pybomb.GamesClient(my_key)

   return_fields = ('id', 'name', 'platforms')
   limit = 10
   offset = 5
   sort_by = 'name'
   filter_by = {'platforms': pybomb.PS3}

   response = games_client.search(
      filter_by=filter_by,
      return_fields=return_fields,
      sort_by=sort_by,
      desc=True,
      limit=limit,
      offset=offset
   )

   print response.results
   print response.uri
   print response.num_page_results
   print response.num_total_results

**GamesClient - quick_search**

.. code-block::

  import pybomb

  my_key = your_giant_bomb_api_key
  games_client = pybomb.GamesClient(my_key)

  response = games_client.quick_search(
    name='call of duty',
    platform=pybomb.PS3,
    sort_by='original_release_date',
    desc=True
  )

  print response.results
  print response.uri
  print response.num_page_results
  print response.num_total_results

More examples for other clients can be found in the documentation
https://pybomb.readthedocs.org

To see a working example of Pybomb, take a look at the example project GameSearch
https://github.com/steveYeah/gamesearch


