Metadata-Version: 2.4
Name: cinemagoerng
Version: 0.7
Summary: Retrieve data from the IMDb.
Keywords: imdb,cinema,movie,film,cast,actor,director
Author: H. Turgut Uyar
Author-email: H. Turgut Uyar <uyar@tekir.org>
License-Expression: LGPL-3.0-or-later
License-File: LICENSE.txt
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Database :: Front-Ends
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: typedload~=2.39
Requires-Dist: lxml~=5.4.0
Requires-Dist: jmespath~=1.0.1
Requires-Python: ~=3.11
Project-URL: repository, https://github.com/cinemagoer/cinemagoerng
Description-Content-Type: text/markdown

# CinemagoerNG

CinemagoerNG 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`](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

CinemagoerNG supports Python 3.11 and later versions.
You can install it using pip:

```bash
pip install cinemagoerng
```

## Basic usage

Here's a simple example of retrieving movie information:

```python
from cinemagoerng import web as imdb

# Get basic movie information
movie = imdb.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 relevant `set_` functions:

```python
# Set all taglines
imdb.set_taglines(movie)
for tagline in movie.taglines:
    print(tagline)

# Get alternate titles (AKAs)
imdb.set_akas(movie)
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
- Crew members

### Additional details

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

## Development

It is recommended to use `uv` for development:

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

# Set up environment
uv sync

# Run tests
uv run pytest

# Run type checks
uv run mypy src tests

# Check code style
uv run ruff check --preview src tests

# Test under all supported Python versions
uv run tox
```

## License

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

## Acknowledgments

CinemagoerNG is a modern reimagining of the original
[Cinemagoer/IMDbPY](https://github.com/cinemagoer/cinemagoer) project.
Special thanks to:

- All contributors to the original Cinemagoer (IMDbPY) project.
- The IMDb website for providing the data.
