# Movieparse
[][pypi_]
[][status]
[][python version]
[][license]
[][read the docs]
[][tests]
[][codecov]
[][pre-commit]
[][black]
[pypi_]: https://pypi.org/project/movieparse/
[status]: https://pypi.org/project/movieparse/
[python version]: https://pypi.org/project/movieparse
[read the docs]: https://movieparse.readthedocs.io/
[tests]: https://github.com/tilschuenemann/movieparse/actions?workflow=Tests
[codecov]: https://app.codecov.io/gh/tilschuenemann/movieparse
[pre-commit]: https://github.com/pre-commit/pre-commit
[black]: https://github.com/psf/black
## Features
`movieparse` is an asynchronous utility for fetching bulk movie data from [TMDB](https://www.themoviedb.org/) using movie title and optionally release year. It has both a Python API and a CLI.
Distinction from other packages, `movieparse`:
- focuses on fetching movies only.
- can write metadata as CSV files, but is also keeps them within the movieparse object.
- makes all API requests asynchronously and is therefore very fast.
- casts all metadata dtypes so you don't have to.
- can uses multiple sources of input and is easily extendable, as long as the input features movie title and release year.
## Requirements
You'll need to have a TMDB API key in order to make API requests. Either specify it on initialization of Movieparse or add it as environment variable:
```bash
$ export TMDB_API_KEY="your_api_key_here"
```
## Installation
You can install _Movieparse_ via [pip] from [PyPI]:
```console
$ pip install movieparse
```
## Usage
Please see the [Command-line Reference] for details.
## Contributing
Contributions are very welcome.
To learn more, see the [Contributor Guide].
## License
Distributed under the terms of the [MIT license][license],
_Movieparse_ 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/movieparse/issues
[pip]: https://pip.pypa.io/
<!-- github-only -->
[license]: https://github.com/tilschuenemann/movieparse/blob/main/LICENSE
[contributor guide]: https://github.com/tilschuenemann/movieparse/blob/main/CONTRIBUTING.md
[command-line reference]: https://movieparse.readthedocs.io/en/latest/usage.html
Raw data
{
"_id": null,
"home_page": "https://github.com/tilschuenemann/movieparse",
"name": "movieparse",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10.7,<4.0.0",
"maintainer_email": "",
"keywords": "",
"author": "Til Sch\u00fcnemann",
"author_email": "til.schuenemann@mailbox.org",
"download_url": "https://files.pythonhosted.org/packages/ad/86/f6b82700bca0d6657ac22f0d56f78c48519b780b3ffc0d84e1a3d43847c3/movieparse-0.4.0.tar.gz",
"platform": null,
"description": "# Movieparse\n\n[][pypi_]\n[][status]\n[][python version]\n[][license]\n\n[][read the docs]\n[][tests]\n[][codecov]\n\n[][pre-commit]\n[][black]\n\n[pypi_]: https://pypi.org/project/movieparse/\n[status]: https://pypi.org/project/movieparse/\n[python version]: https://pypi.org/project/movieparse\n[read the docs]: https://movieparse.readthedocs.io/\n[tests]: https://github.com/tilschuenemann/movieparse/actions?workflow=Tests\n[codecov]: https://app.codecov.io/gh/tilschuenemann/movieparse\n[pre-commit]: https://github.com/pre-commit/pre-commit\n[black]: https://github.com/psf/black\n\n## Features\n\n`movieparse` is an asynchronous utility for fetching bulk movie data from [TMDB](https://www.themoviedb.org/) using movie title and optionally release year. It has both a Python API and a CLI.\n\nDistinction from other packages, `movieparse`:\n\n- focuses on fetching movies only.\n- can write metadata as CSV files, but is also keeps them within the movieparse object.\n- makes all API requests asynchronously and is therefore very fast.\n- casts all metadata dtypes so you don't have to.\n- can uses multiple sources of input and is easily extendable, as long as the input features movie title and release year.\n\n## Requirements\n\nYou'll need to have a TMDB API key in order to make API requests. Either specify it on initialization of Movieparse or add it as environment variable:\n\n```bash\n$ export TMDB_API_KEY=\"your_api_key_here\"\n```\n\n## Installation\n\nYou can install _Movieparse_ via [pip] from [PyPI]:\n\n```console\n$ pip install movieparse\n```\n\n## Usage\n\nPlease see the [Command-line Reference] 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_Movieparse_ 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/movieparse/issues\n[pip]: https://pip.pypa.io/\n\n<!-- github-only -->\n\n[license]: https://github.com/tilschuenemann/movieparse/blob/main/LICENSE\n[contributor guide]: https://github.com/tilschuenemann/movieparse/blob/main/CONTRIBUTING.md\n[command-line reference]: https://movieparse.readthedocs.io/en/latest/usage.html\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Movieparse",
"version": "0.4.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "006cf67232209d7d8025a9aa1eddb09e",
"sha256": "87cd7916370e94f66c5cdec78f73ac28f0971929ad9887719bc862624033a225"
},
"downloads": -1,
"filename": "movieparse-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "006cf67232209d7d8025a9aa1eddb09e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.7,<4.0.0",
"size": 9835,
"upload_time": "2022-12-03T19:07:28",
"upload_time_iso_8601": "2022-12-03T19:07:28.599384Z",
"url": "https://files.pythonhosted.org/packages/e9/d4/f49c87e125be7d15ae94d5b41ceb4d6c80d3a7ede5bd987a55f1aa9a3329/movieparse-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "08c79aadfb78c2784a8826d528c4a27e",
"sha256": "41cb3544390345a58fd2f60bbdd5b344c85b3de5ca407483d4e94db828926d6a"
},
"downloads": -1,
"filename": "movieparse-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "08c79aadfb78c2784a8826d528c4a27e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.7,<4.0.0",
"size": 10478,
"upload_time": "2022-12-03T19:07:30",
"upload_time_iso_8601": "2022-12-03T19:07:30.491401Z",
"url": "https://files.pythonhosted.org/packages/ad/86/f6b82700bca0d6657ac22f0d56f78c48519b780b3ffc0d84e1a3d43847c3/movieparse-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-03 19:07:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "tilschuenemann",
"github_project": "movieparse",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "movieparse"
}
JSON
