tmdb-async-movies

PyPI Status Python Version License

Read the documentation at https://tmdb-async-movies.readthedocs.io/ Tests Codecov

pre-commit Black

Features

tmdb-async-movies is an asynchronous utility for fetching bulk movie data from TMDB using movie title and optionally release year.

  • Designed for bulk usage: Pipe in a list of queries and get results immediately.

  • Blazing fast: Asynchronous calls enable you to get metadata from hundreds of movies in a couple of seconds.

  • Typed: Metadata dataframes are strictly cast so you don’t have to do it yourself.

  • Hackable: It’s a small project with ~500 LOC.

  • Accessible: It has both a Python API and a CLI.

Requirements

You’ll need to have a TMDB API key in order to make API requests.

Default environment variable:

$ export TMDB_API_KEY="your_api_key_here"

Python:

from tmdb_async_movies.main import TmdbAsyncMovies
t = TmdbAsyncMovies(tmdb_api_key="your_api_key_here")

CLI:

tmdb-async-movies -t "your_api_key_here" from_input "1999 The Matrix"

Installation

You can install tmdb-async-movies via pip from PyPI:

$ pip install tmdb-async-movies

Documentation

Please see the [documentation] for details.

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, tmdb_async_movies is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.