# 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/49/e2/8a33fd2c3885c3bd752fd3c2c48502d11f903f89c35ad8a84c057e2f4bac/themoviedb-lib-0.0.2.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.2",
"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": "efe4185d220a4d51efa4d84b9fbc0ab294b8dac4ffbabfc7e8fad5797d4a88de",
"md5": "64ba89d30f9c80facf1800820a2ba4ce",
"sha256": "a6e82bd59f07e0831d5174c41776f7b49123ddfb967ef0fd6612a1d35c655872"
},
"downloads": -1,
"filename": "themoviedb_lib-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "64ba89d30f9c80facf1800820a2ba4ce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 11512,
"upload_time": "2024-04-04T14:37:36",
"upload_time_iso_8601": "2024-04-04T14:37:36.027299Z",
"url": "https://files.pythonhosted.org/packages/ef/e4/185d220a4d51efa4d84b9fbc0ab294b8dac4ffbabfc7e8fad5797d4a88de/themoviedb_lib-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "49e28a33fd2c3885c3bd752fd3c2c48502d11f903f89c35ad8a84c057e2f4bac",
"md5": "5adac04e4b4457c7a1aaaa1783d0c500",
"sha256": "cdc8ffd865b26f051344a5724c54ca48fb7af20baba46d7523eaf856dc4b235c"
},
"downloads": -1,
"filename": "themoviedb-lib-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "5adac04e4b4457c7a1aaaa1783d0c500",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9719,
"upload_time": "2024-04-04T14:37:37",
"upload_time_iso_8601": "2024-04-04T14:37:37.930818Z",
"url": "https://files.pythonhosted.org/packages/49/e2/8a33fd2c3885c3bd752fd3c2c48502d11f903f89c35ad8a84c057e2f4bac/themoviedb-lib-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-04 14:37:37",
"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"
}