Metadata-Version: 2.0
Name: atmdb
Version: 0.0.2
Summary: Asynchronous API wrapper for TMDb (https://www.themoviedb.org/).
Home-page: http://github.com/textbook/atmdb/
Author: Jonathan Sharpe
Author-email: mail@jonrshar.pe
License: License :: OSI Approved :: ISC License (ISCL)
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Dist: aiohttp

aTMDb
=====

.. image:: https://img.shields.io/pypi/v/atmdb.svg
    :target: https://pypi.python.org/pypi/atmdb
    :alt: PyPI Version

.. image:: https://travis-ci.org/textbook/atmdb.svg?branch=master
    :target: https://travis-ci.org/textbook/atmdb
    :alt: Travis Build Status

.. image:: https://coveralls.io/repos/github/textbook/atmdb/badge.svg?branch=master
    :target: https://coveralls.io/github/textbook/atmdb?branch=master
    :alt: Code Coverage

.. image:: https://www.quantifiedcode.com/api/v1/project/370d26a2062c4b148534b576ea0fc11b/badge.svg
    :target: https://www.quantifiedcode.com/app/project/370d26a2062c4b148534b576ea0fc11b
    :alt: Code Issues

.. image:: https://img.shields.io/badge/license-ISC-blue.svg
    :target: https://github.com/textbook/atmdb/blob/master/LICENSE
    :alt: ISC License

Asynchronous API wrapper for `TMDb`_.

Usage
-----

``atmdb`` can be installed from `PyPI`_ using ``pip``::

    pip install atmdb

The core ``TMDbClient`` must be instantiated with a valid API token (see the
`API FAQ`_ for more information)::

    from atmdb import TMDbClient

    client = TMDbClient(api_token='<insert your token here>')

You can then access the API by calling asynchronous helper methods on the
``client`` instance::

    movie = await client.get_movie(550)
    assert movie.title == 'Fight Club'

Documentation
-------------

Documentation is available on `PythonHosted`_.

Testing
-------

You can run the tests with ``python setup.py test``. To include the integration
suite, ensure that the environment variable ``TMDB_API_TOKEN`` is set to a valid
API token.

.. _API FAQ:
    https://www.themoviedb.org/faq/api
.. _PyPI:
    https://pypi.python.org/pypi/atmdb
.. _PythonHosted:
    https://pythonhosted.org/atmdb/
.. _TMDb:
    https://www.themoviedb.org/


