# themoviedb-lib
Python library providing useful tools for [The Movie Database (TMDb)](https://www.themoviedb.org/) without depending on API-Keys
## Features
- Comprehensive tools for retrieving movie / TV show data
- No dependence on API-Keys
- The data is web scraped from TMDb
- Focus on simplicity and functionality
### Installation
```sh
pip install themoviedb-lib
```
Or if you have multiple Python / pip versions installed, use `pip3`:
```sh
pip3 install themoviedb-lib
```
### Usage
Simple usage examples:
```py
import tmdb
# Search for 'Star Wars' movies and TV shows
search_results = tmdb.API.search(query="Star Wars")
# Display search results on the screen
for result in search_results:
print(result)
# Download poster images for the search results
posters = []
for result in search_results:
posters.append(result.poster())
# Display movies on the screen
for result in search_results:
if result.is_movie():
print(result)
# For every TV show display the episodes for the first season on the screen
for result in search_results:
if result.is_tv() and "1" in result.seasons():
print(result.episodes(season_id="1"))
```
### Utilities
| Method | Description |
|-----------------------------------|------------------------------------------------|
| `tmdb.API.search()` | Search for movies and TV shows |
| `tmdb.API.languages()` | Get a list of languages supported by TMDb |
| `tmdb.API.categories()` | Get a list of categories supported by TMDb |
| `tmdb.API.poster_path()` | Generate a poster path for a movie / TV series |
| `tmdb.API.TV.seasons()` | Get a list of seasons for a TV series |
| `tmdb.API.TV.number_of_seasons()` | Get the season count for a TV series |
| `tmdb.API.TV.episodes()` | Get a list of episodes for a TV series season |
| `tmdb.API...()` | MORE UTILITIES COMING SOON |
Raw data
{
"_id": null,
"home_page": "https://github.com/inwerk/themoviedb-lib",
"name": "themoviedb-lib",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "tmdb, themoviedb, the movie database, the movie db, movie, movies, tv, tv show, tv shows",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/fe/66/b4e7a5dcefe6429444f78682aa69ffcde492d66cdac26c488448ccfc6fa9/themoviedb_lib-0.0.4.tar.gz",
"platform": null,
"description": "# themoviedb-lib\n\nPython library providing useful tools for [The Movie Database (TMDb)](https://www.themoviedb.org/) without depending on API-Keys \n\n## Features\n\n- Comprehensive tools for retrieving movie / TV show data\n- No dependence on API-Keys\n- The data is web scraped from TMDb\n- Focus on simplicity and functionality\n\n### Installation\n\n```sh\npip install themoviedb-lib\n```\n\nOr if you have multiple Python / pip versions installed, use `pip3`:\n\n```sh\npip3 install themoviedb-lib\n```\n\n### Usage\n\nSimple usage examples:\n\n```py\nimport tmdb\n\n# Search for 'Star Wars' movies and TV shows\nsearch_results = tmdb.API.search(query=\"Star Wars\")\n\n# Display search results on the screen\nfor result in search_results:\n print(result)\n\n# Download poster images for the search results\nposters = []\nfor result in search_results:\n posters.append(result.poster())\n\n# Display movies on the screen\nfor result in search_results:\n if result.is_movie():\n print(result)\n\n# For every TV show display the episodes for the first season on the screen\nfor result in search_results:\n if result.is_tv() and \"1\" in result.seasons():\n print(result.episodes(season_id=\"1\"))\n```\n\n### Utilities\n\n| Method | Description |\n|-----------------------------------|------------------------------------------------|\n| `tmdb.API.search()` | Search for movies and TV shows |\n| `tmdb.API.languages()` | Get a list of languages supported by TMDb |\n| `tmdb.API.categories()` | Get a list of categories supported by TMDb |\n| `tmdb.API.poster_path()` | Generate a poster path for a movie / TV series |\n| `tmdb.API.TV.seasons()` | Get a list of seasons for a TV series |\n| `tmdb.API.TV.number_of_seasons()` | Get the season count for a TV series |\n| `tmdb.API.TV.episodes()` | Get a list of episodes for a TV series season |\n| `tmdb.API...()` | MORE UTILITIES COMING SOON |\n",
"bugtrack_url": null,
"license": null,
"summary": "Library providing useful tools for The Movie Database (TMDb). Not dependent on API-keys.",
"version": "0.0.4",
"project_urls": {
"Homepage": "https://github.com/inwerk/themoviedb-lib"
},
"split_keywords": [
"tmdb",
" themoviedb",
" the movie database",
" the movie db",
" movie",
" movies",
" tv",
" tv show",
" tv shows"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "16565c46d1cfeb4e9a3104085e3d9476653d4f13c1114a26d4344d10eefe5680",
"md5": "1f40161ad353d15c279766275ae17422",
"sha256": "73c453782d90859e394be2d0048084707eca9ef3eeb253bcdcbd20098a3db325"
},
"downloads": -1,
"filename": "themoviedb_lib-0.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1f40161ad353d15c279766275ae17422",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 11531,
"upload_time": "2024-05-19T17:50:46",
"upload_time_iso_8601": "2024-05-19T17:50:46.069290Z",
"url": "https://files.pythonhosted.org/packages/16/56/5c46d1cfeb4e9a3104085e3d9476653d4f13c1114a26d4344d10eefe5680/themoviedb_lib-0.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fe66b4e7a5dcefe6429444f78682aa69ffcde492d66cdac26c488448ccfc6fa9",
"md5": "18b3043b36c071e82e420e90f6efe7e6",
"sha256": "355cf73729f21a82037e8938666d5aeb944988813d0da58e78743971ea1cfb08"
},
"downloads": -1,
"filename": "themoviedb_lib-0.0.4.tar.gz",
"has_sig": false,
"md5_digest": "18b3043b36c071e82e420e90f6efe7e6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9714,
"upload_time": "2024-05-19T17:50:47",
"upload_time_iso_8601": "2024-05-19T17:50:47.495052Z",
"url": "https://files.pythonhosted.org/packages/fe/66/b4e7a5dcefe6429444f78682aa69ffcde492d66cdac26c488448ccfc6fa9/themoviedb_lib-0.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-19 17:50:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "inwerk",
"github_project": "themoviedb-lib",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "themoviedb-lib"
}
JSON
