MediaManager/media_manager/metadataProvider/tvdb.py

import tvdb_v4_official
import logging

from pydantic_settings import BaseSettings

import media_manager.metadataProvider.utils
from media_manager.exceptions import InvalidConfigError
from media_manager.metadataProvider.abstractMetaDataProvider import (
    AbstractMetadataProvider,
)
from media_manager.metadataProvider.schemas import MetaDataProviderSearchResult
from media_manager.tv.schemas import Episode, Season, Show, SeasonNumber
from media_manager.movies.schemas import Movie


class TvdbConfig(BaseSettings):
    TVDB_API_KEY: str | None = None


log = logging.getLogger(__name__)


class TvdbMetadataProvider(AbstractMetadataProvider):
    name = "tvdb"

    tvdb_client: tvdb_v4_official.TVDB

    def __init__(self):
        config = TvdbConfig()
        if config.TVDB_API_KEY is None:
            raise InvalidConfigError("TVDB_API_KEY is not set")
        self.tvdb_client = tvdb_v4_official.TVDB(config.TVDB_API_KEY)

    def download_show_poster_image(self, show: Show) -> bool:
        show_metadata = self.tvdb_client.get_series_extended(show.external_id)

        if show_metadata["image"] is not None:
            media_manager.metadataProvider.utils.download_poster_image(
                storage_path=self.storage_path,
                poster_url=show_metadata["image"],
                id=show.id,
            )
            log.info("Successfully downloaded poster image for show " + show.name)
            return True
        else:
            log.warning(f"image for show {show.name} could not be downloaded")
            return False

    def get_show_metadata(self, id: int = None) -> Show:
        """

        :param id: the external id of the show
        :type id: int
        :return: returns a ShowMetadata object
        :rtype: ShowMetadata
        """
        series = self.tvdb_client.get_series_extended(id)
        seasons = []
        seasons_ids = [season["id"] for season in series["seasons"]]

        for season in seasons_ids:
            s = self.tvdb_client.get_season_extended(season)
            # the seasons need to be filtered to a certain type,
            # otherwise the same season will be imported in aired and dvd order,
            # which causes duplicate season number + show ids which in turn violates a unique constraint of the season table
            if s["type"]["id"] != 1:
                log.info(
                    f"Season {s['type']['id']} will not be downloaded because it is not a 'aired order' season"
                )
                continue

            episodes = [
                Episode(
                    number=episode["number"],
                    external_id=episode["id"],
                    title=episode["name"],
                )
                for episode in s["episodes"]
            ]
            seasons.append(
                Season(
                    number=SeasonNumber(s["number"]),
                    name="TVDB doesn't provide Season Names",
                    overview="TVDB doesn't provide Season Overviews",
                    external_id=int(s["id"]),
                    episodes=episodes,
                )
            )
        try:
            year = series["year"]
        except KeyError:
            year = None
        # NOTE: the TVDB API is fucking shit and seems to be very poorly documentated, I can't for the life of me
        #  figure out which statuses this fucking api returns
        show = Show(
            name=series["name"],
            overview=series["overview"],
            year=year,
            external_id=series["id"],
            metadata_provider=self.name,
            seasons=seasons,
            ended=False,
        )

        return show

    def search_show(
        self, query: str | None = None
    ) -> list[MetaDataProviderSearchResult]:
        if query is None:
            results = self.tvdb_client.get_all_series()
        else:
            results = self.tvdb_client.search(query)
        formatted_results = []
        for result in results:
            try:
                if result["type"] == "series":
                    try:
                        year = result["year"]
                    except KeyError:
                        year = None

                    formatted_results.append(
                        MetaDataProviderSearchResult(
                            poster_path=result["image_url"],
                            overview=result["overview"],
                            name=result["name"],
                            external_id=result["tvdb_id"],
                            year=year,
                            metadata_provider=self.name,
                            added=False,
                            vote_average=None,
                        )
                    )
            except Exception as e:
                log.warning(f"Error processing search result {result}: {e}")
        return formatted_results

    def search_movie(self, query: str | None = None) -> list[MetaDataProviderSearchResult]:
        if query is None:
            results = self.tvdb_client.get_all_movies()
        else:
            results = self.tvdb_client.search(query)
        formatted_results = []
        for result in results:
            try:
                if result["type"] == "movie":
                    try:
                        year = result["year"]
                    except KeyError:
                        year = None

                    formatted_results.append(
                        MetaDataProviderSearchResult(
                            poster_path=result["image_url"],
                            overview="TVDB doesn't provide Movie Overviews",
                            name=result["name"],
                            external_id=result["tvdb_id"],
                            year=year,
                            metadata_provider=self.name,
                            added=False,
                            vote_average=None,
                        )
                    )
            except Exception as e:
                log.warning(f"Error processing search result {result}: {e}")
        return formatted_results

    def download_movie_poster_image(self, movie: Movie) -> bool:
        movie_metadata = self.tvdb_client.get_movie_extended(movie.external_id)

        if movie_metadata["image"] is not None:
            media_manager.metadataProvider.utils.download_poster_image(
                storage_path=self.storage_path,
                poster_url=movie_metadata["image"],
                id=movie.id,
            )
            log.info("Successfully downloaded poster image for show " + movie.name)
            return True
        else:
            log.warning(f"image for show {movie.name} could not be downloaded")
            return False

    def get_movie_metadata(self, id: int = None) -> Movie:
        """

        :param id: the external id of the movie
        :type id: int
        :return: returns a Movie object
        :rtype: Movie
        """
        movie = self.tvdb_client.get_movie_extended(id)
        try:
            year = movie["year"]
        except KeyError:
            year = None

        movie = Movie(
            name=movie["name"],
            overview="TVDB doesn't provide Movie Overviews",
            year=year,
            external_id=movie["id"],
            metadata_provider=self.name,
        )

        return movie