cinemagoerng


Namecinemagoerng JSON
Version 0.4 PyPI version JSON
download
home_pageNone
SummaryRetrieve data from the IMDb.
upload_time2025-07-25 08:41:56
maintainerNone
docs_urlNone
authorH. Turgut Uyar, Davide Alberani
requires_python~=3.10
licenseNone
keywords imdb cinema movie film cast actor director
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # CinemagoerNG

CinemagoerNG (Next Generation) is a Python library and command-line utility
for retrieving data from IMDb.
It provides a clean, modern API for accessing movie, TV show,
and celebrity information from IMDb.

> [!Note]
> This project and its authors are not affiliated
| with the Internet Movie Database Inc.
> See the [`DISCLAIMER.txt`](https://raw.githubusercontent.com/cinemagoer/cinemagoerng/main/DISCLAIMER.txt)
> file for details about terms of use.

## Features

- Retrieve comprehensive movie and TV show information.
- Support for alternate titles (AKAs).
- Taglines and parental guide information.
- Episode data for TV series.
- Modern Python typing support.
- Clean, intuitive API.

## Installation

You can install CinemagoerNG using pip:

```bash
# Basic installation
pip install cinemagoerng

# For development
pip install cinemagoerng[dev]
```

## Basic Usage

Here's a simple example of retrieving movie information:

```python
from cinemagoerng import web

# Get basic movie information
movie = web.get_title("tt0133093")  # The Matrix
print(movie.title)       # "The Matrix"
print(movie.sort_title)  # "Matrix"
print(movie.year)        # 1999
print(movie.runtime)     # 136

# Access movie genres
for genre in movie.genres:
    print(genre)         # "Action", "Sci-Fi"

# Get director information
for credit in movie.directors:
    print(credit.name)   # "Lana Wachowski", "Lilly Wachowski"
```

### Retrieving Additional Information

You can fetch additional details using the `update_title` method:

```python
# Get all taglines
web.update_title(movie, page="taglines", keys=["taglines"])
for tagline in movie.taglines:
    print(tagline)

# Get alternate titles (AKAs)
web.update_title(movie, page="akas", keys=["akas"])
for aka in movie.akas:
    print(f"{aka.title} ({aka.country})")
```

## Available Data

CinemagoerNG can retrieve various types of information:

### Basic Information

- Title
- Year
- Runtime
- Genres
- Plot summary
- Rating
- Number of votes

### Credits

- Directors
- Writers
- Cast members
- Producers
- Composers

### Additional Details

- Taglines
- Alternative titles (AKAs)
- Episode information (for TV series)
- Parental guide
- Reference information

## Development

To set up for development:

```bash
# Clone the repository
git clone https://github.com/cinemagoer/cinemagoerng.git
cd cinemagoerng

# Install development dependencies
pip install -e .[dev]

# Run tests
pytest

# Run type checks
mypy cinemagoerng

# Check code style
ruff check --preview cinemagoerng tests

# Format code
ruff format cinemagoerng tests
```

## Python Version Support

CinemagoerNG supports Python 3.10 and later versions, including:

- Python 3.10
- Python 3.11
- Python 3.12
- Python 3.13
- PyPy 3.10

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.
For major changes, please open an issue first to discuss what you would like
to change.

## License

This project is licensed under the
GNU General Public License v3 or later (GPLv3+) - see the
[LICENSE.txt](LICENSE.txt) file for details.

## Acknowledgments

CinemagoerNG is a modern reimagining of the original Cinemagoer/IMDbPY project.
Special thanks to:

- All contributors to the original Cinemagoer (IMDbPY) project.
- The IMDb website for providing the data.
- The Python community for their invaluable feedback and contributions.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "cinemagoerng",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "~=3.10",
    "maintainer_email": null,
    "keywords": "imdb, cinema, movie, film, cast, actor, director",
    "author": "H. Turgut Uyar, Davide Alberani",
    "author_email": "H. Turgut Uyar <uyar@tekir.org>, Davide Alberani <da@mimante.net>",
    "download_url": "https://files.pythonhosted.org/packages/18/0c/ea6037fe73d3268d21a8cba3391051d68898e544b47d2a01dd9ca27489a9/cinemagoerng-0.4.tar.gz",
    "platform": null,
    "description": "# CinemagoerNG\n\nCinemagoerNG (Next Generation) is a Python library and command-line utility\nfor retrieving data from IMDb.\nIt provides a clean, modern API for accessing movie, TV show,\nand celebrity information from IMDb.\n\n> [!Note]\n> This project and its authors are not affiliated\n| with the Internet Movie Database Inc.\n> See the [`DISCLAIMER.txt`](https://raw.githubusercontent.com/cinemagoer/cinemagoerng/main/DISCLAIMER.txt)\n> file for details about terms of use.\n\n## Features\n\n- Retrieve comprehensive movie and TV show information.\n- Support for alternate titles (AKAs).\n- Taglines and parental guide information.\n- Episode data for TV series.\n- Modern Python typing support.\n- Clean, intuitive API.\n\n## Installation\n\nYou can install CinemagoerNG using pip:\n\n```bash\n# Basic installation\npip install cinemagoerng\n\n# For development\npip install cinemagoerng[dev]\n```\n\n## Basic Usage\n\nHere's a simple example of retrieving movie information:\n\n```python\nfrom cinemagoerng import web\n\n# Get basic movie information\nmovie = web.get_title(\"tt0133093\")  # The Matrix\nprint(movie.title)       # \"The Matrix\"\nprint(movie.sort_title)  # \"Matrix\"\nprint(movie.year)        # 1999\nprint(movie.runtime)     # 136\n\n# Access movie genres\nfor genre in movie.genres:\n    print(genre)         # \"Action\", \"Sci-Fi\"\n\n# Get director information\nfor credit in movie.directors:\n    print(credit.name)   # \"Lana Wachowski\", \"Lilly Wachowski\"\n```\n\n### Retrieving Additional Information\n\nYou can fetch additional details using the `update_title` method:\n\n```python\n# Get all taglines\nweb.update_title(movie, page=\"taglines\", keys=[\"taglines\"])\nfor tagline in movie.taglines:\n    print(tagline)\n\n# Get alternate titles (AKAs)\nweb.update_title(movie, page=\"akas\", keys=[\"akas\"])\nfor aka in movie.akas:\n    print(f\"{aka.title} ({aka.country})\")\n```\n\n## Available Data\n\nCinemagoerNG can retrieve various types of information:\n\n### Basic Information\n\n- Title\n- Year\n- Runtime\n- Genres\n- Plot summary\n- Rating\n- Number of votes\n\n### Credits\n\n- Directors\n- Writers\n- Cast members\n- Producers\n- Composers\n\n### Additional Details\n\n- Taglines\n- Alternative titles (AKAs)\n- Episode information (for TV series)\n- Parental guide\n- Reference information\n\n## Development\n\nTo set up for development:\n\n```bash\n# Clone the repository\ngit clone https://github.com/cinemagoer/cinemagoerng.git\ncd cinemagoerng\n\n# Install development dependencies\npip install -e .[dev]\n\n# Run tests\npytest\n\n# Run type checks\nmypy cinemagoerng\n\n# Check code style\nruff check --preview cinemagoerng tests\n\n# Format code\nruff format cinemagoerng tests\n```\n\n## Python Version Support\n\nCinemagoerNG supports Python 3.10 and later versions, including:\n\n- Python 3.10\n- Python 3.11\n- Python 3.12\n- Python 3.13\n- PyPy 3.10\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\nFor major changes, please open an issue first to discuss what you would like\nto change.\n\n## License\n\nThis project is licensed under the\nGNU General Public License v3 or later (GPLv3+) - see the\n[LICENSE.txt](LICENSE.txt) file for details.\n\n## Acknowledgments\n\nCinemagoerNG is a modern reimagining of the original Cinemagoer/IMDbPY project.\nSpecial thanks to:\n\n- All contributors to the original Cinemagoer (IMDbPY) project.\n- The IMDb website for providing the data.\n- The Python community for their invaluable feedback and contributions.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Retrieve data from the IMDb.",
    "version": "0.4",
    "project_urls": {
        "repository": "https://github.com/cinemagoer/cinemagoerng"
    },
    "split_keywords": [
        "imdb",
        " cinema",
        " movie",
        " film",
        " cast",
        " actor",
        " director"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "eba79f47ed6b822a500a9d6de87f4083fb28450e6b1c6a35f15fc6d159b1573d",
                "md5": "e52ea4ff4f213d8ee48caf8f7d29977e",
                "sha256": "cbcec4c574837917c67f18ba442a383060bab236af5b7845163f7fa00a8c2f66"
            },
            "downloads": -1,
            "filename": "cinemagoerng-0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e52ea4ff4f213d8ee48caf8f7d29977e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "~=3.10",
            "size": 30911,
            "upload_time": "2025-07-25T08:41:54",
            "upload_time_iso_8601": "2025-07-25T08:41:54.150264Z",
            "url": "https://files.pythonhosted.org/packages/eb/a7/9f47ed6b822a500a9d6de87f4083fb28450e6b1c6a35f15fc6d159b1573d/cinemagoerng-0.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "180cea6037fe73d3268d21a8cba3391051d68898e544b47d2a01dd9ca27489a9",
                "md5": "7051d22a0657ae2fed479626a08a3157",
                "sha256": "b322556345cdd38866433b77e7cfcbcf4c9386cf115330b7caaab8da62fa4a80"
            },
            "downloads": -1,
            "filename": "cinemagoerng-0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "7051d22a0657ae2fed479626a08a3157",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "~=3.10",
            "size": 22506,
            "upload_time": "2025-07-25T08:41:56",
            "upload_time_iso_8601": "2025-07-25T08:41:56.809220Z",
            "url": "https://files.pythonhosted.org/packages/18/0c/ea6037fe73d3268d21a8cba3391051d68898e544b47d2a01dd9ca27489a9/cinemagoerng-0.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-25 08:41:56",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "cinemagoer",
    "github_project": "cinemagoerng",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "cinemagoerng"
}
        
Elapsed time: 0.58262s