Skip to content

Base Provider

base

Base provider interface and data classes for anime sources.

This module defines the abstract base class and data structures that all anime providers must implement. It provides a consistent interface for searching, fetching details, and extracting streams from various sources.

Data Classes

AnimeResult: Search result representation Episode: Episode information StreamLink: Stream URL with metadata AnimeDetails: Complete anime information

Base Class

BaseProvider: Abstract interface for all providers

Example

Implementing a provider::

from weeb_cli.providers.base import BaseProvider, AnimeResult
from weeb_cli.providers.registry import register_provider

@register_provider("myprovider", lang="en", region="US")
class MyProvider(BaseProvider):
    def search(self, query: str) -> List[AnimeResult]:
        # Implementation
        pass

    def get_details(self, anime_id: str) -> Optional[AnimeDetails]:
        # Implementation
        pass

AnimeResult dataclass

Search result for an anime.

Represents a single anime in search results with basic information.

Attributes:

Name Type Description
id str

Unique identifier for the anime (provider-specific).
title str

Display title of the anime.
type str

Content type (e.g., 'series', 'movie', 'ova').
cover Optional[str]

URL to cover/poster image.
year Optional[int]

Release year.
Source code in weeb_cli/providers/base.py 
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
@dataclass
class AnimeResult:
    """Search result for an anime.

    Represents a single anime in search results with basic information.

    Attributes:
        id: Unique identifier for the anime (provider-specific).
        title: Display title of the anime.
        type: Content type (e.g., 'series', 'movie', 'ova').
        cover: URL to cover/poster image.
        year: Release year.
    """
    id: str
    title: str
    type: str = "series"
    cover: Optional[str] = None
    year: Optional[int] = None

Episode dataclass

Episode information.

Represents a single episode with metadata.

Attributes:

Name Type Description
id str

Unique identifier for the episode (provider-specific).
number int

Episode number within the season.
title Optional[str]

Episode title (if available).
season int

Season number (default: 1).
url Optional[str]

Direct URL to episode page (optional).
Source code in weeb_cli/providers/base.py 
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
@dataclass
class Episode:
    """Episode information.

    Represents a single episode with metadata.

    Attributes:
        id: Unique identifier for the episode (provider-specific).
        number: Episode number within the season.
        title: Episode title (if available).
        season: Season number (default: 1).
        url: Direct URL to episode page (optional).
    """
    id: str
    number: int
    title: Optional[str] = None
    season: int = 1
    url: Optional[str] = None

Stream URL with metadata.

Represents a playable stream with quality and server information.

Attributes:

Name Type Description
url str

Direct stream URL (HLS, MP4, etc.).
quality str

Quality label (e.g., '1080p', '720p', 'auto').
server str

Server/host name (e.g., 'megacloud', 'default').
headers Dict[str, str]

HTTP headers required for playback.
subtitles Optional[str]

URL to subtitle file (optional).
Source code in weeb_cli/providers/base.py 
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
@dataclass
class StreamLink:
    """Stream URL with metadata.

    Represents a playable stream with quality and server information.

    Attributes:
        url: Direct stream URL (HLS, MP4, etc.).
        quality: Quality label (e.g., '1080p', '720p', 'auto').
        server: Server/host name (e.g., 'megacloud', 'default').
        headers: HTTP headers required for playback.
        subtitles: URL to subtitle file (optional).
    """
    url: str
    quality: str = "auto"
    server: str = "default"
    headers: Dict[str, str] = field(default_factory=dict)
    subtitles: Optional[str] = None

AnimeDetails dataclass

Complete anime information.

Represents full details of an anime including episodes.

Attributes:

Name Type Description
id str

Unique identifier for the anime.
title str

Display title.
description Optional[str]

Synopsis/description text.
cover Optional[str]

URL to cover/poster image.
genres List[str]

List of genre tags.
year Optional[int]

Release year.
status Optional[str]

Airing status (e.g., 'ongoing', 'completed').
episodes List[Episode]

List of available episodes.
total_episodes Optional[int]

Total episode count (if known).
Source code in weeb_cli/providers/base.py 
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
@dataclass
class AnimeDetails:
    """Complete anime information.

    Represents full details of an anime including episodes.

    Attributes:
        id: Unique identifier for the anime.
        title: Display title.
        description: Synopsis/description text.
        cover: URL to cover/poster image.
        genres: List of genre tags.
        year: Release year.
        status: Airing status (e.g., 'ongoing', 'completed').
        episodes: List of available episodes.
        total_episodes: Total episode count (if known).
    """
    id: str
    title: str
    description: Optional[str] = None
    cover: Optional[str] = None
    genres: List[str] = field(default_factory=list)
    year: Optional[int] = None
    status: Optional[str] = None
    episodes: List[Episode] = field(default_factory=list)
    total_episodes: Optional[int] = None

BaseProvider

Bases: ABC

Abstract base class for anime providers.

All anime source providers must inherit from this class and implement the abstract methods. Provides common functionality like HTTP requests with retry logic.

Class Attributes

name: Provider identifier (set by @register_provider). lang: Language code (e.g., 'en', 'tr', 'de', 'pl'). region: Region code (e.g., 'US', 'TR', 'DE', 'PL').

Instance Attributes

headers: Default HTTP headers for requests.

Example

Implementing a provider::

@register_provider("myprovider", lang="en", region="US")
class MyProvider(BaseProvider):
    def search(self, query: str) -> List[AnimeResult]:
        results = self._request(f"{BASE_URL}/search?q={query}")
        return [AnimeResult(id=r['id'], title=r['title']) 
                for r in results]
Source code in weeb_cli/providers/base.py 
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
class BaseProvider(ABC):
    """Abstract base class for anime providers.

    All anime source providers must inherit from this class and implement
    the abstract methods. Provides common functionality like HTTP requests
    with retry logic.

    Class Attributes:
        name: Provider identifier (set by @register_provider).
        lang: Language code (e.g., 'en', 'tr', 'de', 'pl').
        region: Region code (e.g., 'US', 'TR', 'DE', 'PL').

    Instance Attributes:
        headers: Default HTTP headers for requests.

    Example:
        Implementing a provider::

            @register_provider("myprovider", lang="en", region="US")
            class MyProvider(BaseProvider):
                def search(self, query: str) -> List[AnimeResult]:
                    results = self._request(f"{BASE_URL}/search?q={query}")
                    return [AnimeResult(id=r['id'], title=r['title']) 
                            for r in results]
    """

    name: str = "base"
    lang: str = "tr"
    region: str = "TR"

    def __init__(self) -> None:
        """Initialize provider with default headers."""
        self.headers: Dict[str, str] = {
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
            'Accept': 'application/json, text/html, */*',
        }

    @abstractmethod
    def search(self, query: str) -> List[AnimeResult]:
        """Search for anime by query string.

        Args:
            query: Search query (anime title or keywords).

        Returns:
            List of anime search results.

        Raises:
            ProviderError: If search fails.
        """
        pass

    @abstractmethod
    def get_details(self, anime_id: str) -> Optional[AnimeDetails]:
        """Get detailed information for an anime.

        Args:
            anime_id: Unique anime identifier from search results.

        Returns:
            Complete anime details, or None if not found.

        Raises:
            ProviderError: If fetching details fails.
        """
        pass

    @abstractmethod
    def get_episodes(self, anime_id: str) -> List[Episode]:
        """Get list of available episodes for an anime.

        Args:
            anime_id: Unique anime identifier.

        Returns:
            List of episodes with metadata.

        Raises:
            ProviderError: If fetching episodes fails.
        """
        pass

    @abstractmethod
    def get_streams(self, anime_id: str, episode_id: str) -> List[StreamLink]:
        """Get stream URLs for a specific episode.

        Args:
            anime_id: Unique anime identifier.
            episode_id: Unique episode identifier.

        Returns:
            List of available stream links with quality options.

        Raises:
            ProviderError: If extracting streams fails.
        """
        pass

    def _request(
        self, 
        url: str, 
        params: Optional[dict] = None, 
        json_response: bool = True, 
        max_retries: int = 3
    ) -> Any:
        """Make HTTP GET request with retry logic.

        Provides automatic retry with exponential backoff for transient errors.
        Skips retries for permanent errors (404, 403, 401).

        Args:
            url: Target URL.
            params: Query parameters.
            json_response: Whether to parse response as JSON.
            max_retries: Maximum number of retry attempts.

        Returns:
            Parsed JSON dict/list if json_response=True, otherwise raw text.
            Returns None if all retries fail.

        Example:
            >>> data = self._request("https://api.example.com/anime")
            >>> html = self._request("https://example.com", json_response=False)
        """
        import requests
        import time
        import random

        for attempt in range(max_retries):
            try:
                response = requests.get(
                    url, 
                    headers=self.headers, 
                    params=params,
                    timeout=15
                )
                response.raise_for_status()

                if json_response:
                    return response.json()
                return response.text

            except requests.RequestException as e:
                debug(f"[HTTP] Request failed (attempt {attempt + 1}/{max_retries}): {url} - {e}")

                if attempt < max_retries - 1:
                    # Skip retries for permanent errors
                    if isinstance(e, requests.HTTPError) and e.response.status_code in [404, 403, 401]:
                        debug(f"[HTTP] Permanent error, skipping retries")
                        return None

                    # Exponential backoff with jitter
                    delay = min(2 ** attempt, 10) + random.uniform(0, 1)
                    time.sleep(delay)
                    continue

                return None

__init__ 

__init__() -> None

Initialize provider with default headers.

Source code in weeb_cli/providers/base.py 
159
160
161
162
163
164
def __init__(self) -> None:
    """Initialize provider with default headers."""
    self.headers: Dict[str, str] = {
        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
        'Accept': 'application/json, text/html, */*',
    }

search abstractmethod 

search(query: str) -> List[AnimeResult]

Search for anime by query string.

Parameters:

Name Type Description Default
query str

Search query (anime title or keywords).

 required

Returns:

Type Description
List[AnimeResult]

List of anime search results.

Raises:

Type Description
ProviderError

If search fails.
Source code in weeb_cli/providers/base.py 
166
167
168
169
170
171
172
173
174
175
176
177
178
179
@abstractmethod
def search(self, query: str) -> List[AnimeResult]:
    """Search for anime by query string.

    Args:
        query: Search query (anime title or keywords).

    Returns:
        List of anime search results.

    Raises:
        ProviderError: If search fails.
    """
    pass

get_details abstractmethod 

get_details(anime_id: str) -> Optional[AnimeDetails]

Get detailed information for an anime.

Parameters:

Name Type Description Default
anime_id str

Unique anime identifier from search results.

 required

Returns:

Type Description
Optional[AnimeDetails]

Complete anime details, or None if not found.

Raises:

Type Description
ProviderError

If fetching details fails.
Source code in weeb_cli/providers/base.py 
181
182
183
184
185
186
187
188
189
190
191
192
193
194
@abstractmethod
def get_details(self, anime_id: str) -> Optional[AnimeDetails]:
    """Get detailed information for an anime.

    Args:
        anime_id: Unique anime identifier from search results.

    Returns:
        Complete anime details, or None if not found.

    Raises:
        ProviderError: If fetching details fails.
    """
    pass

get_episodes abstractmethod 

get_episodes(anime_id: str) -> List[Episode]

Get list of available episodes for an anime.

Parameters:

Name Type Description Default
anime_id str

Unique anime identifier.

 required

Returns:

Type Description
List[Episode]

List of episodes with metadata.

Raises:

Type Description
ProviderError

If fetching episodes fails.
Source code in weeb_cli/providers/base.py 
196
197
198
199
200
201
202
203
204
205
206
207
208
209
@abstractmethod
def get_episodes(self, anime_id: str) -> List[Episode]:
    """Get list of available episodes for an anime.

    Args:
        anime_id: Unique anime identifier.

    Returns:
        List of episodes with metadata.

    Raises:
        ProviderError: If fetching episodes fails.
    """
    pass

get_streams abstractmethod 

get_streams(anime_id: str, episode_id: str) -> List[StreamLink]

Get stream URLs for a specific episode.

Parameters:

Name Type Description Default
anime_id str

Unique anime identifier.

 required
episode_id str

Unique episode identifier.

 required

Returns:

Type Description
List[StreamLink]

List of available stream links with quality options.

Raises:

Type Description
ProviderError

If extracting streams fails.
Source code in weeb_cli/providers/base.py 
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
@abstractmethod
def get_streams(self, anime_id: str, episode_id: str) -> List[StreamLink]:
    """Get stream URLs for a specific episode.

    Args:
        anime_id: Unique anime identifier.
        episode_id: Unique episode identifier.

    Returns:
        List of available stream links with quality options.

    Raises:
        ProviderError: If extracting streams fails.
    """
    pass

Overview

The base provider module defines the abstract interface and data structures that all anime providers must implement.

Data Classes

AnimeResult

Search result representation.

Episode

Episode information with metadata.

Stream URL with quality and server information.

AnimeDetails

Complete anime information including episodes.

BaseProvider Interface

Abstract base class that all providers must inherit from.

Required Methods

  • search(): Search for anime
  • get_details(): Get anime details
  • get_episodes(): Get episode list
  • get_streams(): Extract stream URLs

Helper Methods

  • _request(): HTTP request with retry logic

Implementation Example

from weeb_cli.providers.base import BaseProvider, AnimeResult
from weeb_cli.providers.registry import register_provider

@register_provider("myprovider", lang="en", region="US")
class MyProvider(BaseProvider):
    def search(self, query: str) -> List[AnimeResult]:
        # Implementation
        pass

API Reference

AnimeResult dataclass

Search result for an anime.

Represents a single anime in search results with basic information.

Attributes:

Name Type Description
id str

Unique identifier for the anime (provider-specific).
title str

Display title of the anime.
type str

Content type (e.g., 'series', 'movie', 'ova').
cover Optional[str]

URL to cover/poster image.
year Optional[int]

Release year.
Source code in weeb_cli/providers/base.py 
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
@dataclass
class AnimeResult:
    """Search result for an anime.

    Represents a single anime in search results with basic information.

    Attributes:
        id: Unique identifier for the anime (provider-specific).
        title: Display title of the anime.
        type: Content type (e.g., 'series', 'movie', 'ova').
        cover: URL to cover/poster image.
        year: Release year.
    """
    id: str
    title: str
    type: str = "series"
    cover: Optional[str] = None
    year: Optional[int] = None

Episode dataclass

Episode information.

Represents a single episode with metadata.

Attributes:

Name Type Description
id str

Unique identifier for the episode (provider-specific).
number int

Episode number within the season.
title Optional[str]

Episode title (if available).
season int

Season number (default: 1).
url Optional[str]

Direct URL to episode page (optional).
Source code in weeb_cli/providers/base.py 
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
@dataclass
class Episode:
    """Episode information.

    Represents a single episode with metadata.

    Attributes:
        id: Unique identifier for the episode (provider-specific).
        number: Episode number within the season.
        title: Episode title (if available).
        season: Season number (default: 1).
        url: Direct URL to episode page (optional).
    """
    id: str
    number: int
    title: Optional[str] = None
    season: int = 1
    url: Optional[str] = None

Stream URL with metadata.

Represents a playable stream with quality and server information.

Attributes:

Name Type Description
url str

Direct stream URL (HLS, MP4, etc.).
quality str

Quality label (e.g., '1080p', '720p', 'auto').
server str

Server/host name (e.g., 'megacloud', 'default').
headers Dict[str, str]

HTTP headers required for playback.
subtitles Optional[str]

URL to subtitle file (optional).
Source code in weeb_cli/providers/base.py 
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
@dataclass
class StreamLink:
    """Stream URL with metadata.

    Represents a playable stream with quality and server information.

    Attributes:
        url: Direct stream URL (HLS, MP4, etc.).
        quality: Quality label (e.g., '1080p', '720p', 'auto').
        server: Server/host name (e.g., 'megacloud', 'default').
        headers: HTTP headers required for playback.
        subtitles: URL to subtitle file (optional).
    """
    url: str
    quality: str = "auto"
    server: str = "default"
    headers: Dict[str, str] = field(default_factory=dict)
    subtitles: Optional[str] = None

AnimeDetails dataclass

Complete anime information.

Represents full details of an anime including episodes.

Attributes:

Name Type Description
id str

Unique identifier for the anime.
title str

Display title.
description Optional[str]

Synopsis/description text.
cover Optional[str]

URL to cover/poster image.
genres List[str]

List of genre tags.
year Optional[int]

Release year.
status Optional[str]

Airing status (e.g., 'ongoing', 'completed').
episodes List[Episode]

List of available episodes.
total_episodes Optional[int]

Total episode count (if known).
Source code in weeb_cli/providers/base.py 
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
@dataclass
class AnimeDetails:
    """Complete anime information.

    Represents full details of an anime including episodes.

    Attributes:
        id: Unique identifier for the anime.
        title: Display title.
        description: Synopsis/description text.
        cover: URL to cover/poster image.
        genres: List of genre tags.
        year: Release year.
        status: Airing status (e.g., 'ongoing', 'completed').
        episodes: List of available episodes.
        total_episodes: Total episode count (if known).
    """
    id: str
    title: str
    description: Optional[str] = None
    cover: Optional[str] = None
    genres: List[str] = field(default_factory=list)
    year: Optional[int] = None
    status: Optional[str] = None
    episodes: List[Episode] = field(default_factory=list)
    total_episodes: Optional[int] = None

BaseProvider

Bases: ABC

Abstract base class for anime providers.

All anime source providers must inherit from this class and implement the abstract methods. Provides common functionality like HTTP requests with retry logic.

Class Attributes

name: Provider identifier (set by @register_provider). lang: Language code (e.g., 'en', 'tr', 'de', 'pl'). region: Region code (e.g., 'US', 'TR', 'DE', 'PL').

Instance Attributes

headers: Default HTTP headers for requests.

Example

Implementing a provider::

@register_provider("myprovider", lang="en", region="US")
class MyProvider(BaseProvider):
    def search(self, query: str) -> List[AnimeResult]:
        results = self._request(f"{BASE_URL}/search?q={query}")
        return [AnimeResult(id=r['id'], title=r['title']) 
                for r in results]
Source code in weeb_cli/providers/base.py 
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
class BaseProvider(ABC):
    """Abstract base class for anime providers.

    All anime source providers must inherit from this class and implement
    the abstract methods. Provides common functionality like HTTP requests
    with retry logic.

    Class Attributes:
        name: Provider identifier (set by @register_provider).
        lang: Language code (e.g., 'en', 'tr', 'de', 'pl').
        region: Region code (e.g., 'US', 'TR', 'DE', 'PL').

    Instance Attributes:
        headers: Default HTTP headers for requests.

    Example:
        Implementing a provider::

            @register_provider("myprovider", lang="en", region="US")
            class MyProvider(BaseProvider):
                def search(self, query: str) -> List[AnimeResult]:
                    results = self._request(f"{BASE_URL}/search?q={query}")
                    return [AnimeResult(id=r['id'], title=r['title']) 
                            for r in results]
    """

    name: str = "base"
    lang: str = "tr"
    region: str = "TR"

    def __init__(self) -> None:
        """Initialize provider with default headers."""
        self.headers: Dict[str, str] = {
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
            'Accept': 'application/json, text/html, */*',
        }

    @abstractmethod
    def search(self, query: str) -> List[AnimeResult]:
        """Search for anime by query string.

        Args:
            query: Search query (anime title or keywords).

        Returns:
            List of anime search results.

        Raises:
            ProviderError: If search fails.
        """
        pass

    @abstractmethod
    def get_details(self, anime_id: str) -> Optional[AnimeDetails]:
        """Get detailed information for an anime.

        Args:
            anime_id: Unique anime identifier from search results.

        Returns:
            Complete anime details, or None if not found.

        Raises:
            ProviderError: If fetching details fails.
        """
        pass

    @abstractmethod
    def get_episodes(self, anime_id: str) -> List[Episode]:
        """Get list of available episodes for an anime.

        Args:
            anime_id: Unique anime identifier.

        Returns:
            List of episodes with metadata.

        Raises:
            ProviderError: If fetching episodes fails.
        """
        pass

    @abstractmethod
    def get_streams(self, anime_id: str, episode_id: str) -> List[StreamLink]:
        """Get stream URLs for a specific episode.

        Args:
            anime_id: Unique anime identifier.
            episode_id: Unique episode identifier.

        Returns:
            List of available stream links with quality options.

        Raises:
            ProviderError: If extracting streams fails.
        """
        pass

    def _request(
        self, 
        url: str, 
        params: Optional[dict] = None, 
        json_response: bool = True, 
        max_retries: int = 3
    ) -> Any:
        """Make HTTP GET request with retry logic.

        Provides automatic retry with exponential backoff for transient errors.
        Skips retries for permanent errors (404, 403, 401).

        Args:
            url: Target URL.
            params: Query parameters.
            json_response: Whether to parse response as JSON.
            max_retries: Maximum number of retry attempts.

        Returns:
            Parsed JSON dict/list if json_response=True, otherwise raw text.
            Returns None if all retries fail.

        Example:
            >>> data = self._request("https://api.example.com/anime")
            >>> html = self._request("https://example.com", json_response=False)
        """
        import requests
        import time
        import random

        for attempt in range(max_retries):
            try:
                response = requests.get(
                    url, 
                    headers=self.headers, 
                    params=params,
                    timeout=15
                )
                response.raise_for_status()

                if json_response:
                    return response.json()
                return response.text

            except requests.RequestException as e:
                debug(f"[HTTP] Request failed (attempt {attempt + 1}/{max_retries}): {url} - {e}")

                if attempt < max_retries - 1:
                    # Skip retries for permanent errors
                    if isinstance(e, requests.HTTPError) and e.response.status_code in [404, 403, 401]:
                        debug(f"[HTTP] Permanent error, skipping retries")
                        return None

                    # Exponential backoff with jitter
                    delay = min(2 ** attempt, 10) + random.uniform(0, 1)
                    time.sleep(delay)
                    continue

                return None

__init__ 

__init__() -> None

Initialize provider with default headers.

Source code in weeb_cli/providers/base.py 
159
160
161
162
163
164
def __init__(self) -> None:
    """Initialize provider with default headers."""
    self.headers: Dict[str, str] = {
        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
        'Accept': 'application/json, text/html, */*',
    }

search abstractmethod 

search(query: str) -> List[AnimeResult]

Search for anime by query string.

Parameters:

Name Type Description Default
query str

Search query (anime title or keywords).

 required

Returns:

Type Description
List[AnimeResult]

List of anime search results.

Raises:

Type Description
ProviderError

If search fails.
Source code in weeb_cli/providers/base.py 
166
167
168
169
170
171
172
173
174
175
176
177
178
179
@abstractmethod
def search(self, query: str) -> List[AnimeResult]:
    """Search for anime by query string.

    Args:
        query: Search query (anime title or keywords).

    Returns:
        List of anime search results.

    Raises:
        ProviderError: If search fails.
    """
    pass

get_details abstractmethod 

get_details(anime_id: str) -> Optional[AnimeDetails]

Get detailed information for an anime.

Parameters:

Name Type Description Default
anime_id str

Unique anime identifier from search results.

 required

Returns:

Type Description
Optional[AnimeDetails]

Complete anime details, or None if not found.

Raises:

Type Description
ProviderError

If fetching details fails.
Source code in weeb_cli/providers/base.py 
181
182
183
184
185
186
187
188
189
190
191
192
193
194
@abstractmethod
def get_details(self, anime_id: str) -> Optional[AnimeDetails]:
    """Get detailed information for an anime.

    Args:
        anime_id: Unique anime identifier from search results.

    Returns:
        Complete anime details, or None if not found.

    Raises:
        ProviderError: If fetching details fails.
    """
    pass

get_episodes abstractmethod 

get_episodes(anime_id: str) -> List[Episode]

Get list of available episodes for an anime.

Parameters:

Name Type Description Default
anime_id str

Unique anime identifier.

 required

Returns:

Type Description
List[Episode]

List of episodes with metadata.

Raises:

Type Description
ProviderError

If fetching episodes fails.
Source code in weeb_cli/providers/base.py 
196
197
198
199
200
201
202
203
204
205
206
207
208
209
@abstractmethod
def get_episodes(self, anime_id: str) -> List[Episode]:
    """Get list of available episodes for an anime.

    Args:
        anime_id: Unique anime identifier.

    Returns:
        List of episodes with metadata.

    Raises:
        ProviderError: If fetching episodes fails.
    """
    pass

get_streams abstractmethod 

get_streams(anime_id: str, episode_id: str) -> List[StreamLink]

Get stream URLs for a specific episode.

Parameters:

Name Type Description Default
anime_id str

Unique anime identifier.

 required
episode_id str

Unique episode identifier.

 required

Returns:

Type Description
List[StreamLink]

List of available stream links with quality options.

Raises:

Type Description
ProviderError

If extracting streams fails.
Source code in weeb_cli/providers/base.py 
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
@abstractmethod
def get_streams(self, anime_id: str, episode_id: str) -> List[StreamLink]:
    """Get stream URLs for a specific episode.

    Args:
        anime_id: Unique anime identifier.
        episode_id: Unique episode identifier.

    Returns:
        List of available stream links with quality options.

    Raises:
        ProviderError: If extracting streams fails.
    """
    pass