127 lines
2.9 KiB
Python
127 lines
2.9 KiB
Python
"""TV Show repository interfaces (abstract)."""
|
|
|
|
from abc import ABC, abstractmethod
|
|
|
|
from ..shared.value_objects import ImdbId
|
|
from .entities import Episode, Season, TVShow
|
|
from .value_objects import EpisodeNumber, SeasonNumber
|
|
|
|
|
|
class TVShowRepository(ABC):
|
|
"""
|
|
Abstract repository for TV show persistence.
|
|
|
|
This defines the interface that infrastructure implementations must follow.
|
|
"""
|
|
|
|
@abstractmethod
|
|
def save(self, show: TVShow) -> None:
|
|
"""
|
|
Save a TV show to the repository.
|
|
|
|
Args:
|
|
show: TVShow entity to save
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_by_imdb_id(self, imdb_id: ImdbId) -> TVShow | None:
|
|
"""
|
|
Find a TV show by its IMDb ID.
|
|
|
|
Args:
|
|
imdb_id: IMDb ID to search for
|
|
|
|
Returns:
|
|
TVShow if found, None otherwise
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_all(self) -> list[TVShow]:
|
|
"""
|
|
Get all TV shows in the repository.
|
|
|
|
Returns:
|
|
List of all TV shows
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def delete(self, imdb_id: ImdbId) -> bool:
|
|
"""
|
|
Delete a TV show from the repository.
|
|
|
|
Args:
|
|
imdb_id: IMDb ID of the show to delete
|
|
|
|
Returns:
|
|
True if deleted, False if not found
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def exists(self, imdb_id: ImdbId) -> bool:
|
|
"""
|
|
Check if a TV show exists in the repository.
|
|
|
|
Args:
|
|
imdb_id: IMDb ID to check
|
|
|
|
Returns:
|
|
True if exists, False otherwise
|
|
"""
|
|
pass
|
|
|
|
|
|
class SeasonRepository(ABC):
|
|
"""Abstract repository for season persistence."""
|
|
|
|
@abstractmethod
|
|
def save(self, season: Season) -> None:
|
|
"""Save a season."""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_by_show_and_number(
|
|
self, show_imdb_id: ImdbId, season_number: SeasonNumber
|
|
) -> Season | None:
|
|
"""Find a season by show and season number."""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_all_by_show(self, show_imdb_id: ImdbId) -> list[Season]:
|
|
"""Get all seasons for a show."""
|
|
pass
|
|
|
|
|
|
class EpisodeRepository(ABC):
|
|
"""Abstract repository for episode persistence."""
|
|
|
|
@abstractmethod
|
|
def save(self, episode: Episode) -> None:
|
|
"""Save an episode."""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_by_show_season_episode(
|
|
self,
|
|
show_imdb_id: ImdbId,
|
|
season_number: SeasonNumber,
|
|
episode_number: EpisodeNumber,
|
|
) -> Episode | None:
|
|
"""Find an episode by show, season, and episode number."""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_all_by_season(
|
|
self, show_imdb_id: ImdbId, season_number: SeasonNumber
|
|
) -> list[Episode]:
|
|
"""Get all episodes for a season."""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_all_by_show(self, show_imdb_id: ImdbId) -> list[Episode]:
|
|
"""Get all episodes for a show."""
|
|
pass
|