libtvdb 0.12.1

A wrapper around the TVDB API.

libtvdb

A wrapper around the TVDB API.

Installation

pip install libtvdb

Examples

Searching for shows:

import libtvdb

client = libtvdb.TVDBClient(api_key="...", pin="...")
shows = client.search_show("Doctor Who")

for show in shows:
    print(show.name)

Development

This project uses Poetry for dependency management.

# Install dependencies
poetry install

# Run tests
poetry run pytest

# Run linters and type checkers
poetry run ruff check libtvdb
poetry run black --check libtvdb tests
poetry run pylint libtvdb
poetry run mypy libtvdb
poetry run pyright libtvdb

Advanced

You can set libtvdb_api_key and libtvdb_pin in your OS X keychain if you don't want to supply these every time. If any of the values supplied to the TVDBClient constructor are None, it will look into your keychain and load the appropriate value. If it can't find them, it will throw an exception.