61 lines
1.4 KiB
Python
61 lines
1.4 KiB
Python
"""Subtitle repository interfaces (abstract)."""
|
|
|
|
from abc import ABC, abstractmethod
|
|
|
|
from ..shared.value_objects import ImdbId
|
|
from .entities import Subtitle
|
|
from .value_objects import Language
|
|
|
|
|
|
class SubtitleRepository(ABC):
|
|
"""
|
|
Abstract repository for subtitle persistence.
|
|
|
|
This defines the interface that infrastructure implementations must follow.
|
|
"""
|
|
|
|
@abstractmethod
|
|
def save(self, subtitle: Subtitle) -> None:
|
|
"""
|
|
Save a subtitle to the repository.
|
|
|
|
Args:
|
|
subtitle: Subtitle entity to save
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def find_by_media(
|
|
self,
|
|
media_imdb_id: ImdbId,
|
|
language: Language | None = None,
|
|
season: int | None = None,
|
|
episode: int | None = None,
|
|
) -> list[Subtitle]:
|
|
"""
|
|
Find subtitles for a media item.
|
|
|
|
Args:
|
|
media_imdb_id: IMDb ID of the media
|
|
language: Optional language filter
|
|
season: Optional season number (for TV shows)
|
|
episode: Optional episode number (for TV shows)
|
|
|
|
Returns:
|
|
List of matching subtitles
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def delete(self, subtitle: Subtitle) -> bool:
|
|
"""
|
|
Delete a subtitle from the repository.
|
|
|
|
Args:
|
|
subtitle: Subtitle to delete
|
|
|
|
Returns:
|
|
True if deleted, False if not found
|
|
"""
|
|
pass
|