{"id":19486214,"url":"https://github.com/textbook/atmdb","last_synced_at":"2025-04-25T18:31:49.834Z","repository":{"id":52705738,"uuid":"57880019","full_name":"textbook/atmdb","owner":"textbook","description":"Asynchronous API wrapper for TMDb (https://www.themoviedb.org/).","archived":false,"fork":false,"pushed_at":"2021-10-21T17:51:42.000Z","size":72,"stargazers_count":5,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-14T21:56:02.991Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://pythonhosted.org/atmdb/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/textbook.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-02T09:55:39.000Z","updated_at":"2021-01-07T15:25:03.000Z","dependencies_parsed_at":"2022-08-21T19:40:28.484Z","dependency_job_id":null,"html_url":"https://github.com/textbook/atmdb","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textbook%2Fatmdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textbook%2Fatmdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textbook%2Fatmdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textbook%2Fatmdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/textbook","download_url":"https://codeload.github.com/textbook/atmdb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250872191,"owners_count":21500773,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T20:35:38.553Z","updated_at":"2025-04-25T18:31:49.389Z","avatar_url":"https://github.com/textbook.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"aTMDb\n=====\n\n.. image:: https://img.shields.io/pypi/v/atmdb.svg\n    :target: https://pypi.python.org/pypi/atmdb\n    :alt: PyPI Version\n\n.. image:: https://travis-ci.org/textbook/atmdb.svg?branch=master\n    :target: https://travis-ci.org/textbook/atmdb\n    :alt: Travis Build Status\n\n.. image:: https://coveralls.io/repos/github/textbook/atmdb/badge.svg?branch=master\n    :target: https://coveralls.io/github/textbook/atmdb?branch=master\n    :alt: Code Coverage\n\n.. image:: https://www.quantifiedcode.com/api/v1/project/370d26a2062c4b148534b576ea0fc11b/badge.svg\n    :target: https://www.quantifiedcode.com/app/project/370d26a2062c4b148534b576ea0fc11b\n    :alt: Code Issues\n\n.. image:: https://img.shields.io/badge/license-ISC-blue.svg\n    :target: https://github.com/textbook/atmdb/blob/master/LICENSE\n    :alt: ISC License\n\nAsynchronous API wrapper for `TMDb`_.\n\nCompatibility\n-------------\n\naTMDb uses `asyncio`_ with the ``async`` and ``await`` syntax, so is only\ncompatible with Python versions 3.5 and above.\n\nInstallation\n------------\n\n``atmdb`` can be installed from `PyPI`_ using ``pip``::\n\n    pip install atmdb\n\nTesting\n-------\n\nYou can run the tests with ``python setup.py test``. To include the integration\nsuite, ensure that the environment variable ``TMDB_API_TOKEN`` is set to a valid\nAPI token, and use ``--runslow`` if running ``py.test`` directly.\n\nUsage\n-----\n\nClient\n......\n\nThe core ``TMDbClient`` must be instantiated with a valid API token (see the\n`API FAQ`_ for more information), either directly::\n\n    from atmdb import TMDbClient\n\n    client = TMDbClient(api_token='\u003cinsert your token here\u003e')\n\nor as the ``TMDB_API_TOKEN`` environment variable::\n\n    client = TMDbClient.from_env()\n\nYou can then access the API by calling asynchronous helper methods on the\n``client`` instance::\n\n    movie = await client.get_movie(550)\n    assert movie.title == 'Fight Club'\n\nAny API endpoints not currently exposed via the helper methods can be accessed\nby using the ``url_builder`` and ``get_data`` methods directly, for example::\n\n    url = client.url_builder('company/{company_id}', dict(company_id=508))\n                           # ^ endpoint            # ^ parameters to insert\n    company = await client.get_data(url)\n    assert company.get('name') == 'Regency Enterprises'\n\nNote that, if you aren't using a helper method, the result is just a vanilla\ndictionary.\n\nUtilities\n.........\n\naTMDb also exposes utilities for working with the API and models at a higher\nlevel of abstraction, for example::\n\n    from aTMDb import TMDbClient\n    from aTMDb.utils import find_overlapping_actors\n\n    actors = await find_overlapping_actors(\n        ['monty python holy grail', 'meaning of life'],\n        TMDbClient(api_token='\u003cinsert your token here\u003e'),\n    )\n    assert any(person.name == 'Eric Idle' for person in overlap)\n\nDocumentation\n-------------\n\nAdditional documentation is available on `PythonHosted`_. An overview of the\nproject status is shown on its `dashboard`_.\n\n.. _API FAQ:\n    https://www.themoviedb.org/faq/api\n.. _asyncio:\n    http://aiohttp.readthedocs.io/\n.. _dashboard:\n    https://atmdb-randy-campimetry.cfapps.pez.pivotal.io\n.. _PyPI:\n    https://pypi.python.org/pypi/atmdb\n.. _PythonHosted:\n    https://pythonhosted.org/atmdb/\n.. _TMDb:\n    https://www.themoviedb.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftextbook%2Fatmdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftextbook%2Fatmdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftextbook%2Fatmdb/lists"}