# tmdb-async-movies
[![PyPI](https://img.shields.io/pypi/v/tmdb-async-movies.svg)][pypi_]
[![Status](https://img.shields.io/pypi/status/tmdb-async-movies.svg)][status]
[![Python Version](https://img.shields.io/pypi/pyversions/tmdb-async-movies)][python version]
[![License](https://img.shields.io/pypi/l/tmdb-async-movies)][license]
[![Read the documentation at https://tmdb-async-movies.readthedocs.io/](https://img.shields.io/readthedocs/tmdb-async-movies/latest.svg?label=Read%20the%20Docs)][read the docs]
[![Tests](https://github.com/tilschuenemann/tmdb-async-movies/workflows/Tests/badge.svg)][tests]
[![Codecov](https://codecov.io/gh/tilschuenemann/tmdb-async-movies/branch/main/graph/badge.svg)][codecov]
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]
[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][black]
[pypi_]: https://pypi.org/project/tmdb-async-movies/
[status]: https://pypi.org/project/tmdb-async-movies/
[python version]: https://pypi.org/project/tmdb-async-movies
[read the docs]: https://tmdb-async-movies.readthedocs.io/
[tests]: https://github.com/tilschuenemann/tmdb-async-movies/actions?workflow=Tests
[codecov]: https://app.codecov.io/gh/tilschuenemann/tmdb-async-movies
[pre-commit]: https://github.com/pre-commit/pre-commit
[black]: https://github.com/psf/black
## Features
`tmdb-async-movies` is an asynchronous utility for fetching bulk movie data from [TMDB](https://www.themoviedb.org/) 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:
```bash
$ export TMDB_API_KEY="your_api_key_here"
```
Python:
```python
from tmdb_async_movies.main import TmdbAsyncMovies
t = TmdbAsyncMovies(tmdb_api_key="your_api_key_here")
```
CLI:
```bash
tmdb-async-movies -t "your_api_key_here" from_input "1999 The Matrix"
```
## Installation
You can install _tmdb-async-movies_ via [pip] from [PyPI]:
```console
$ 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][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.
[@cjolowicz]: https://github.com/cjolowicz
[pypi]: https://pypi.org/
[hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python
[file an issue]: https://github.com/tilschuenemann/tmdb-async-movies/issues
[pip]: https://pip.pypa.io/
<!-- github-only -->
[license]: https://github.com/tilschuenemann/tmdb-async-movies/blob/main/LICENSE
[contributor guide]: https://github.com/tilschuenemann/tmdb-async-movies/blob/main/CONTRIBUTING.md
[documentation]: https://tmdb-async-movies.readthedocs.io/en/latest/
Raw data
{
"_id": null,
"home_page": "https://github.com/tilschuenemann/tmdb-async-movies",
"name": "tmdb-async-movies",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "tmdb,api,movies,bulk,async,tmdb-api,tmdb-movie,movie,aiohttp,tmdb-async-movies",
"author": "Til Sch\u00fcnemann",
"author_email": "til.schuenemann@mailbox.org",
"download_url": "https://files.pythonhosted.org/packages/af/c4/3d15709518aadb985f48b982b1b7a52bd5ca838f44080b0d07596c7424f7/tmdb_async_movies-0.1.2.tar.gz",
"platform": null,
"description": "# tmdb-async-movies\n\n[![PyPI](https://img.shields.io/pypi/v/tmdb-async-movies.svg)][pypi_]\n[![Status](https://img.shields.io/pypi/status/tmdb-async-movies.svg)][status]\n[![Python Version](https://img.shields.io/pypi/pyversions/tmdb-async-movies)][python version]\n[![License](https://img.shields.io/pypi/l/tmdb-async-movies)][license]\n\n[![Read the documentation at https://tmdb-async-movies.readthedocs.io/](https://img.shields.io/readthedocs/tmdb-async-movies/latest.svg?label=Read%20the%20Docs)][read the docs]\n[![Tests](https://github.com/tilschuenemann/tmdb-async-movies/workflows/Tests/badge.svg)][tests]\n[![Codecov](https://codecov.io/gh/tilschuenemann/tmdb-async-movies/branch/main/graph/badge.svg)][codecov]\n\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]\n[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][black]\n\n[pypi_]: https://pypi.org/project/tmdb-async-movies/\n[status]: https://pypi.org/project/tmdb-async-movies/\n[python version]: https://pypi.org/project/tmdb-async-movies\n[read the docs]: https://tmdb-async-movies.readthedocs.io/\n[tests]: https://github.com/tilschuenemann/tmdb-async-movies/actions?workflow=Tests\n[codecov]: https://app.codecov.io/gh/tilschuenemann/tmdb-async-movies\n[pre-commit]: https://github.com/pre-commit/pre-commit\n[black]: https://github.com/psf/black\n\n## Features\n\n`tmdb-async-movies` is an asynchronous utility for fetching bulk movie data from [TMDB](https://www.themoviedb.org/) using movie title and optionally release year.\n\n- Designed for bulk usage: Pipe in a list of queries and get results immediately.\n- Blazing fast: Asynchronous calls enable you to get metadata from hundreds of movies in a couple of seconds.\n- Typed: Metadata dataframes are strictly cast so you don't have to do it yourself.\n- Hackable: It's a small project with ~500 LOC.\n- Accessible: It has both a Python API and a CLI.\n\n## Requirements\n\nYou'll need to have a TMDB API key in order to make API requests.\n\nDefault environment variable:\n\n```bash\n$ export TMDB_API_KEY=\"your_api_key_here\"\n```\n\nPython:\n\n```python\nfrom tmdb_async_movies.main import TmdbAsyncMovies\nt = TmdbAsyncMovies(tmdb_api_key=\"your_api_key_here\")\n```\n\nCLI:\n\n```bash\ntmdb-async-movies -t \"your_api_key_here\" from_input \"1999 The Matrix\"\n```\n\n## Installation\n\nYou can install _tmdb-async-movies_ via [pip] from [PyPI]:\n\n```console\n$ pip install tmdb-async-movies\n```\n\n## Documentation\n\nPlease see the [documentation] for details.\n\n## Contributing\n\nContributions are very welcome.\nTo learn more, see the [Contributor Guide].\n\n## License\n\nDistributed under the terms of the [MIT license][license],\n_tmdb_async_movies_ is free and open source software.\n\n## Issues\n\nIf you encounter any problems,\nplease [file an issue] along with a detailed description.\n\n## Credits\n\nThis project was generated from [@cjolowicz]'s [Hypermodern Python Cookiecutter] template.\n\n[@cjolowicz]: https://github.com/cjolowicz\n[pypi]: https://pypi.org/\n[hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python\n[file an issue]: https://github.com/tilschuenemann/tmdb-async-movies/issues\n[pip]: https://pip.pypa.io/\n\n<!-- github-only -->\n\n[license]: https://github.com/tilschuenemann/tmdb-async-movies/blob/main/LICENSE\n[contributor guide]: https://github.com/tilschuenemann/tmdb-async-movies/blob/main/CONTRIBUTING.md\n[documentation]: https://tmdb-async-movies.readthedocs.io/en/latest/\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "tmdb-async-movies is an asynchronous utility for fetching bulk movie data from TMDB using movie title and optionally release year.",
"version": "0.1.2",
"project_urls": {
"Changelog": "https://github.com/tilschuenemann/tmdb-async-movies/releases",
"Documentation": "https://tmdb-async-movies.readthedocs.io",
"Homepage": "https://github.com/tilschuenemann/tmdb-async-movies",
"Repository": "https://github.com/tilschuenemann/tmdb-async-movies"
},
"split_keywords": [
"tmdb",
"api",
"movies",
"bulk",
"async",
"tmdb-api",
"tmdb-movie",
"movie",
"aiohttp",
"tmdb-async-movies"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5c5a754ffbfc7650e0855e0541ca827a649943cd15deca2e9a8948ddfa27dc3a",
"md5": "0485f622c2b224a4837ef21a999733a4",
"sha256": "8218c6b2e2ba5174acd79ceac716573cf3d895b416d6b09447fdbf161375dd6d"
},
"downloads": -1,
"filename": "tmdb_async_movies-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0485f622c2b224a4837ef21a999733a4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 10282,
"upload_time": "2023-09-08T10:00:45",
"upload_time_iso_8601": "2023-09-08T10:00:45.382484Z",
"url": "https://files.pythonhosted.org/packages/5c/5a/754ffbfc7650e0855e0541ca827a649943cd15deca2e9a8948ddfa27dc3a/tmdb_async_movies-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "afc43d15709518aadb985f48b982b1b7a52bd5ca838f44080b0d07596c7424f7",
"md5": "6f107ffd9fd75f7437d8390bc64ba75c",
"sha256": "4489820f4bec621393ed2f8fd2fea83b4d718d4dd8fc4eb4bc1d075f14f38fc5"
},
"downloads": -1,
"filename": "tmdb_async_movies-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "6f107ffd9fd75f7437d8390bc64ba75c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 10555,
"upload_time": "2023-09-08T10:00:47",
"upload_time_iso_8601": "2023-09-08T10:00:47.197469Z",
"url": "https://files.pythonhosted.org/packages/af/c4/3d15709518aadb985f48b982b1b7a52bd5ca838f44080b0d07596c7424f7/tmdb_async_movies-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-08 10:00:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tilschuenemann",
"github_project": "tmdb-async-movies",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tmdb-async-movies"
}