imdbio 0.0.1__tar.gz

imdbio-0.0.1/.gitignore

@@ -0,0 +1,213 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+.idea
+# C extensions
+*.so
+
+imdbinfo_aws
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Firecrawl research cache
+.firecrawl/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

imdbio-0.0.1/DISCLAIMER.txt

@@ -0,0 +1,20 @@
+Disclaimer
+
+The Author is not affiliated with Internet Movie Database Inc.
+
+This library provides functionality to access and work with movie-related data that may originate from IMDb (www.imdb.com).
+IMDb is a trademark of Internet Movie Database Inc., and all content and data
+included on the IMDb's site is the property of IMDb or its content suppliers
+and protected by the United States and international copyright laws.
+
+Use of IMDb data through this library is subject to IMDb’s Terms and Conditions of Use (https://www.imdb.com/conditions/).
+By using this library, you acknowledge and agree that:
+
+1. You are solely responsible for ensuring that your use of IMDb data complies with IMDb’s Terms of Service and any applicable laws.
+2. This library is provided "as is" without any warranty or guarantee of compliance with IMDb’s terms.
+3. The author(s) of this library do not endorse or encourage any use of IMDb data that violates IMDb’s Terms of Service.
+4. The author(s) of this library assume no liability for any misuse of the library, including but not limited to violations of IMDb’s Terms of Service.
+
+If you require IMDb data for commercial or public-facing projects, you must obtain proper licensing directly from IMDb (https://developer.imdb.com/).
+
+Please read any other notice on the https://www.imdb.com/ site.

imdbio-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Riajul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

imdbio-0.0.1/MANIFEST.in

@@ -0,0 +1,2 @@
+graft sample_json_source
+graft tests

imdbio-0.0.1/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: imdbio
+Version: 0.0.1
+Summary: A Python service for querying IMDb data
+Project-URL: Homepage, https://rjriajul.github.io/imdbio/
+Project-URL: Source, https://github.com/rjriajul/imdbio
+Project-URL: Issues, https://github.com/rjriajul/imdbio/issues
+Author: rjriajul
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,data,film,imdb,information,metadata,movie,python,scraper,tv
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: deprecated
+Requires-Dist: imdbinfo-aws
+Requires-Dist: jmespath
+Requires-Dist: lxml
+Requires-Dist: niquests
+Requires-Dist: pydantic
+Provides-Extra: dev
+Requires-Dist: poethepoet>=0.32; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: twine>=5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+[![PyPI Downloads](https://static.pepy.tech/badge/imdbio)](https://pepy.tech/projects/imdbio)
+[![PyPI Version](https://img.shields.io/pypi/v/imdbio?style=flat-square)](https://pypi.org/project/imdbio/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/imdbio?style=flat-square)](https://pypi.org/project/imdbio/)
+
+# imdbio
+
+**Your personal gateway to IMDb data** — no API keys required.
+
+## Features
+
+- Search movies, series, and people by name or title
+- Detailed movie info: cast, crew, ratings, box office, company credits
+- TV series support with seasons and episodes
+- Person details with biography, filmography and images
+- Localized results in multiple languages (global or per-request)
+- User reviews, trivia, parental guide, awards info
+- Typed Pydantic models
+- Built-in caching
+
+## Installation
+
+```bash
+pip install imdbio
+```
+
+## Quick Start
+
+```python
+from imdbio import search_title, get_movie, get_name
+
+# Search for a title
+results = search_title("The Matrix")
+for movie in results.titles:
+    print(f"{movie.title} ({movie.year}) - {movie.imdb_id}")
+
+# Get movie details
+movie = get_movie("0133093")
+print(movie.title, movie.year, movie.rating, movie.kind)
+
+# Get person details
+person = get_name("nm0000206")
+print(person.name, person.birth_date)
+
+# Series example
+from imdbio import get_season_episodes
+episodes = get_season_episodes("tt1520211", season=1)  # Walking Dead
+for ep in episodes[:3]:
+    print(ep.title, ep.rating)
+```
+
+📝 More examples in the [examples](examples/) folder.
+
+## Why choose imdbio?
+
+- Clean structured data via Pydantic models
+- No API keys or external dependencies
+- Powered by niquests and lxml
+- Ideal for scripts and data analysis
+
+## Disclaimer
+
+Not affiliated with IMDb Inc. See [DISCLAIMER](DISCLAIMER.txt).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

imdbio-0.0.1/README.md

@@ -0,0 +1,66 @@
+[![PyPI Downloads](https://static.pepy.tech/badge/imdbio)](https://pepy.tech/projects/imdbio)
+[![PyPI Version](https://img.shields.io/pypi/v/imdbio?style=flat-square)](https://pypi.org/project/imdbio/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/imdbio?style=flat-square)](https://pypi.org/project/imdbio/)
+
+# imdbio
+
+**Your personal gateway to IMDb data** — no API keys required.
+
+## Features
+
+- Search movies, series, and people by name or title
+- Detailed movie info: cast, crew, ratings, box office, company credits
+- TV series support with seasons and episodes
+- Person details with biography, filmography and images
+- Localized results in multiple languages (global or per-request)
+- User reviews, trivia, parental guide, awards info
+- Typed Pydantic models
+- Built-in caching
+
+## Installation
+
+```bash
+pip install imdbio
+```
+
+## Quick Start
+
+```python
+from imdbio import search_title, get_movie, get_name
+
+# Search for a title
+results = search_title("The Matrix")
+for movie in results.titles:
+    print(f"{movie.title} ({movie.year}) - {movie.imdb_id}")
+
+# Get movie details
+movie = get_movie("0133093")
+print(movie.title, movie.year, movie.rating, movie.kind)
+
+# Get person details
+person = get_name("nm0000206")
+print(person.name, person.birth_date)
+
+# Series example
+from imdbio import get_season_episodes
+episodes = get_season_episodes("tt1520211", season=1)  # Walking Dead
+for ep in episodes[:3]:
+    print(ep.title, ep.rating)
+```
+
+📝 More examples in the [examples](examples/) folder.
+
+## Why choose imdbio?
+
+- Clean structured data via Pydantic models
+- No API keys or external dependencies
+- Powered by niquests and lxml
+- Ideal for scripts and data analysis
+
+## Disclaimer
+
+Not affiliated with IMDb Inc. See [DISCLAIMER](DISCLAIMER.txt).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

imdbio-0.0.1/examples/example_akas.py

@@ -0,0 +1,36 @@
+import logging
+from imdbio import get_akas, get_reviews, get_trivia, get_parental_guide
+
+logging.basicConfig(level=logging.WARNING)
+
+movies_list = [
+    "tt0133093",  # The Matrix (movie)
+    "tt1520211",  # The Walking Dead (tvSeries)
+    "tt30406366",  # The Walking Dead: Daryl Dixon (tvMiniSeries)
+    "tt1589921",  # The Walking Dead S01E01 (tvEpisode series)
+    "tt12326830",  #  'The Sandman' (podcastSeries)
+    "tt15110916",  # 'The Sandman' (2022)  s01e01 (podcastEpisode)
+    "tt2080323",  # Hotel Desire (short)
+    "tt36048590",  # Marc Maron: Panicked (tvSpecial)
+    "tt6582384",  # Red Nose Day Actually (tvShort)
+    "tt33238076",  # Mafia: The Old Country (videoGame)
+    "tt11771594",  # American Pie Presents: Girls' Rules (video)
+    "tt37195825",  # Talking Heads: Psycho Killer (musicVideo)
+    "tt33501878",  # title akas
+]
+
+for imdb_id in movies_list:
+    movie_akas = get_akas(imdb_id)
+    movie_reviews = get_reviews(imdb_id)
+    movie_trivia = get_trivia(imdb_id)
+    parental_guide = get_parental_guide(imdb_id)
+    print("##########################################################################")
+    print(movie_akas["akas"])
+    print(f"Reviews: {movie_reviews[:5]}")
+    print(f"Trivia: {movie_trivia[:5]}")
+    print(f"Parental Guide: {parental_guide}")
+    print("##########################################################################")
+    for category in parental_guide.categories:
+        print(category)
+        for category_text in category.content_descriptions:
+            print(f" - {category_text.text} (SPOILER: {category_text.is_spoiler})")

imdbio-0.0.1/examples/example_all_episodes.py

@@ -0,0 +1,30 @@
+from imdbio import get_movie, get_all_episodes
+
+series_ids = [
+    "tt1520211",  # The Walking Dead
+    "tt0944947",  # Game of Thrones
+    "tt0903747",  # Breaking Bad
+    "tt1838556",  # a movie ... skip it
+    "tt4574334",  # The Mandalorian
+    "tt0071007",  # little house on the prairie
+    "tt35373097",  # seires with no episodes
+]
+
+for series_id in series_ids:
+    series = get_movie(series_id)
+    if not series.is_series():
+        print(f"Series with ID {series_id} not found.")
+        continue
+    print(f"Movie Title: {series.title} ({series.year}) - {series.imdbId}")
+    print(f"Kind: {series.kind}")
+    print(f"Series Info: {series.info_series or 'N/A'}")
+    # creators
+    creators = series.info_series.get_creators()
+    print(f"Creators: {', '.join([str(creator) for creator in creators]) or 'N/A'}")
+    print("----------------------------------------------")
+
+    all_episodes = get_all_episodes(series_id)
+    print(f"\nTotal Episodes in Series: {len(all_episodes)}")
+    for episode in all_episodes:
+        print(f"{episode}")
+    print("\n" + "=" * 50 + "\n")

imdbio-0.0.1/examples/example_basic.py

@@ -0,0 +1,51 @@
+from time import time
+from imdbio import search_title, get_movie, get_name
+
+import logging
+
+logging.basicConfig(level=logging.WARNING)
+# list_q = "little house|matrix|walking dead|horizon".split("|")
+list_q = "France to find his estate confiscated by governor Narbonne, for back taxes, and resold to Katrina, a Dutch Countess. Katrina offers to return Pierre's property if he will help her get possession".split(
+    " "
+)
+# Example 1: Search for a movie by title
+
+for word in list_q:
+    print(f"Searching for movies with title containing: {word}")
+    results = search_title(word)
+    if results:
+        for movie in results.titles:
+            print(f"{movie.title} ({movie.year}) - {movie.imdb_id}")
+            movie = get_movie(movie.imdb_id)
+            print(f"  URL: {movie.url}")
+            print(f"  Rating: {movie.rating}")
+            print(f"  MPAA: {movie.mpaa}")
+            print(
+                f"  Countries: {', '.join(movie.countries) if movie.countries else 'N/A'}"
+            )
+            print(
+                f"  Languages codes: {', '.join(movie.languages) if movie.languages else 'N/A'}"
+            )
+            print(
+                f"  Languages: {', '.join(movie.languages_text) if movie.languages_text else 'N/A'}"
+            )
+
+            print(f"  Kind: {movie.kind}")
+            if movie.is_series():
+                print(f"  Series Info: {movie.info_series or 'N/A'}")
+            if movie.is_episode():
+                print(f"  Episode Info: {movie.info_episode or 'N/A'}")
+            for director in movie.directors:
+                print(f"  Director: {director.name}")
+            for c in movie.categories["cast"][
+                :1
+            ]:  # Limit to first 3 cast members for brevity
+                # print(c)
+                t0 = time()
+                person = get_name(c.imdb_id)
+                t1 = time()
+                print(
+                    f"  Cast: \n\t{person.name} ({', '.join(c.characters)}) - {' ° '.join(person.primary_profession[:2])} - {person.url} "
+                )
+            # DONE
+            print("----------------------------------------------")

imdbio-0.0.1/examples/example_custom_user_agent.py

@@ -0,0 +1,31 @@
+"""
+Example: Using a custom User-Agent
+
+This example demonstrates how to override the default User-Agent
+used for HTTP requests to IMDb.
+"""
+
+from imdbio import get_movie
+from imdbio.services import USER_AGENTS_LIST
+
+# Check the default User-Agent
+print(f"Default User-Agent List: {USER_AGENTS_LIST}")
+
+# Override with a custom User-Agent
+USER_AGENTS_LIST = [
+    "MyCustomApp/1.0 (Contact: myemail@example.com)",
+    "AnotherUserAgent/2.0",
+]
+
+print(f"Custom User-Agent List: {USER_AGENTS_LIST}")
+
+# Now all requests will use the custom User-Agent
+try:
+    movie = get_movie("tt0133093")  # The Matrix
+    print(f"\nFetched movie: {movie.title} ({movie.year})")
+    print(f"Rating: {movie.rating}")
+except Exception as e:
+    print(f"Error: {e}")
+
+# Note: If you get an error, the error message will now include
+# more details like HTTP status code and response text

imdbio-0.0.1/examples/example_filmography.py

@@ -0,0 +1,16 @@
+from imdbio import get_filmography
+
+import logging
+
+logging.basicConfig(level=logging.WARNING)
+
+n = "nm0000206"
+
+filmography_results = get_filmography(n)
+if filmography_results:
+    for role, films in filmography_results.items():
+        print(f"\nRole: {role}")
+        for film in films:
+            print(f" - {film.title} ({film.year}) [{film.imdbId}]")
+            # cover
+            print(f"   Cover URL: {film.cover_url}")

imdbio-0.0.1/examples/example_genres_interests.py

@@ -0,0 +1,22 @@
+from imdbio import get_movie, get_all_interests
+import logging
+
+
+logging.basicConfig(level=logging.WARNING)
+
+# List of movie IMDb IDs with comments for maintainability
+MOVIE_IDS = [
+    "tt1490017",  # Frozen (2013)
+    "tt0133093",  # The Matrix (1999)
+    "tt2347569",  # Pacific Rim (2013)
+    "tt31184028",  # Dune: Part Two (2024)
+    "tt1745960",  # Top Gun: Maverick (2022)
+]
+
+for imdb_id in MOVIE_IDS:
+    movie_details = get_movie(imdb_id)
+    print(f"#{movie_details.title} ({movie_details.year})")
+    interests = get_all_interests(imdb_id)
+    print("Genres:", movie_details.genres)
+    print(f"Interests : {interests}")
+    print("-----------------------")

imdbio-0.0.1/examples/example_person_detail.py

@@ -0,0 +1,58 @@
+from imdbio import search_title, get_name, get_movie
+
+import logging
+
+from imdbio.services import get_filmography
+
+logging.basicConfig(level=logging.WARNING)
+
+# Example 1: Search for a person by name
+person_results = search_title("Mary")
+for p in person_results.names:
+    print(f"{p.name} - {p.job} ({p.id})")
+    person = get_name(p.id)
+    if person:
+        print(f"Known For: {', '.join(person.knownfor)}")
+        print(f"Image URL: {person.image_url}")
+        print(f"IMDb URL: {person.url}")
+        print(f"Name: {person.name}")
+        print(f"Known For: {', '.join(person.knownfor)}")
+        print(f"Birth Date: {person.birth_date}")
+        print(f"Birth Place: {person.birth_place}")
+        print(f"Death Date: {person.death_date}")
+        print(f"Death Place: {person.death_place}")
+        print(f"Death Reason: {person.death_reason}")
+        print(f"Bio: {person.bio[:100]}...")  # Print first 100 characters of bio
+        print(f"Height: {person.height}")
+        print(f"Primary Profession: {', '.join(person.primary_profession)}")
+        print(f"Image URL: {person.image_url}")
+        print(f"IMDb URL: {person.url}")
+
+movie = get_movie("0133093")
+for p in movie.categories["cast"]:
+    print(f"{p.name} - {p.job} ({p.id})")
+    person = get_name(p.id)
+    if person:
+        print(f"Known For: {', '.join(person.knownfor)}")
+        print(f"Image URL: {person.image_url}")
+        print(f"IMDb URL: {person.url}")
+        print(f"Name: {person.name}")
+        print(f"Known For: {', '.join(person.knownfor)}")
+        print(f"Birth Date: {person.birth_date}")
+        print(f"Birth Place: {person.birth_place}")
+        print(f"Death Date: {person.death_date}")
+        print(f"Death Place: {person.death_place}")
+        print(f"Death Reason: {person.death_reason}")
+        print(f"Bio: {person.bio[:100]}...")  # Print first 100 characters of bio
+        print(f"Height: {person.height}")
+        print(f"Primary Profession: {', '.join(person.primary_profession)}")
+        print(f"Image URL: {person.image_url}")
+        print(f"IMDb URL: {person.url}")
+
+        # filmography
+        filmography_results = get_filmography(person.id)
+        if filmography_results:
+            for role, films in filmography_results.items():
+                print(f"\nRole: {role}")
+                for film in films:
+                    print(f" - {film.title} ({film.year}) [{film.imdbId}]")