Lukas
b1726968e5
- Replace callback system with events library in SerieScanner - Update SeriesApp to subscribe to loader and scanner events - Refactor ScanService to use Events instead of CallbackManager - Remove CallbackManager imports and callback classes - Add safe event calling with error handling in SerieScanner - Update AniworldLoader to use Events for download progress - Remove progress_callback parameter from download methods - Update all affected tests for Events pattern - Fix test_series_app.py for new event subscription model - Comment out obsolete callback tests in test_scan_service.py All core tests passing. Events provide cleaner event-driven architecture.
105 lines
3.0 KiB
Python
105 lines
3.0 KiB
Python
from abc import ABC, abstractmethod
|
|
from typing import Any, Dict, List
|
|
|
|
|
|
class Loader(ABC):
|
|
"""Abstract base class for anime data loaders/providers."""
|
|
@abstractmethod
|
|
def subscribe_download_progress(self, handler):
|
|
"""Subscribe a handler to the download_progress event.
|
|
Args:
|
|
handler: Callable to be called with progress dict.
|
|
"""
|
|
@abstractmethod
|
|
def unsubscribe_download_progress(self, handler):
|
|
"""Unsubscribe a handler from the download_progress event.
|
|
Args:
|
|
handler: Callable previously subscribed.
|
|
"""
|
|
|
|
@abstractmethod
|
|
def search(self, word: str) -> List[Dict[str, Any]]:
|
|
"""Search for anime series by name.
|
|
|
|
Args:
|
|
word: Search term to look for
|
|
|
|
Returns:
|
|
List of found series as dictionaries containing series information
|
|
"""
|
|
|
|
@abstractmethod
|
|
def is_language(
|
|
self,
|
|
season: int,
|
|
episode: int,
|
|
key: str,
|
|
language: str = "German Dub",
|
|
) -> bool:
|
|
"""Check if episode exists in specified language.
|
|
|
|
Args:
|
|
season: Season number (1-indexed)
|
|
episode: Episode number (1-indexed)
|
|
key: Unique series identifier/key
|
|
language: Language to check (default: German Dub)
|
|
|
|
Returns:
|
|
True if episode exists in specified language, False otherwise
|
|
"""
|
|
|
|
@abstractmethod
|
|
def download(
|
|
self,
|
|
base_directory: str,
|
|
serie_folder: str,
|
|
season: int,
|
|
episode: int,
|
|
key: str,
|
|
language: str = "German Dub"
|
|
) -> bool:
|
|
"""Download episode to specified directory.
|
|
|
|
Args:
|
|
base_directory: Base directory for downloads
|
|
serie_folder: Series folder name within base directory
|
|
season: Season number (0 for movies, 1+ for series)
|
|
episode: Episode number within season
|
|
key: Unique series identifier/key
|
|
language: Language version to download (default: German Dub)
|
|
|
|
Returns:
|
|
True if download successful, False otherwise
|
|
"""
|
|
|
|
@abstractmethod
|
|
def get_site_key(self) -> str:
|
|
"""Get the site key/identifier for this provider.
|
|
|
|
Returns:
|
|
Site key string (e.g., 'aniworld.to', 'voe.com')
|
|
"""
|
|
|
|
@abstractmethod
|
|
def get_title(self, key: str) -> str:
|
|
"""Get the human-readable title of a series.
|
|
|
|
Args:
|
|
key: Unique series identifier/key
|
|
|
|
Returns:
|
|
Series title string
|
|
"""
|
|
|
|
@abstractmethod
|
|
def get_season_episode_count(self, slug: str) -> Dict[int, int]:
|
|
"""Get season and episode counts for a series.
|
|
|
|
Args:
|
|
slug: Series slug/key identifier
|
|
|
|
Returns:
|
|
Dictionary mapping season number (int) to episode count (int)
|
|
"""
|
|
|