weeb-cli 2.14.2__tar.gz → 2.15.0__tar.gz

{weeb_cli-2.14.2/weeb_cli.egg-info → weeb_cli-2.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: weeb-cli
-Version: 2.14.2
+Version: 2.15.0
 Summary: No browser, no ads, no distractions. Just you and an unparalleled anime viewing experience.
 Author-email: ewgsta <ewgst@proton.me>
 License-Expression: GPL-3.0-only
@@ -164,24 +164,77 @@ For scripts, automation, and AI agents, weeb-cli provides JSON API commands that
 weeb-cli api providers
 
 # Search for anime (returns IDs)
-weeb-cli api search "Angel Beats"
+weeb-cli api search "Angel Beats" --provider hianime
 # Returns: [{"id": "12345", "title": "Angel Beats!", ...}]
 
 # List episodes (use ID from search)
-weeb-cli api episodes 12345 --season 1
+weeb-cli api episodes 12345 --season 1 --provider hianime
 
 # Get stream URLs for an episode
-weeb-cli api streams 12345 --season 1 --episode 1
+weeb-cli api streams 12345 --season 1 --episode 1 --provider hianime
 
 # Get anime details
-weeb-cli api details 12345
+weeb-cli api details 12345 --provider hianime
 
 # Download an episode
-weeb-cli api download 12345 --season 1 --episode 1 --output ./downloads
+weeb-cli api download 12345 --season 1 --episode 1 --provider hianime --output ./downloads
 ```
 
+**Provider Selection:**
+All API commands support the `--provider` (or `-p`) option to select which anime source to use:
+- Turkish: `animecix`, `turkanime`, `anizle`, `weeb`
+- English: `hianime`, `allanime`
+- German: `aniworld`
+- Polish: `docchi`
+
+Default provider is `animecix` if not specified. Use `weeb-cli api providers` to see all available providers with their language and region information.
+
 All API commands output JSON to stdout.
 
+### Python SDK (Programmatic Access)
+
+For Python applications, weeb-cli provides a native SDK that doesn't require spawning processes:
+
+```python
+from weeb_cli import WeebSDK
+
+# Initialize SDK
+sdk = WeebSDK(default_provider="hianime")
+
+# Search for anime
+results = sdk.search("One Piece")
+for anime in results:
+    print(f"{anime.title} ({anime.year})")
+
+# Get episodes
+episodes = sdk.get_episodes(results[0].id, season=1)
+
+# Get stream URLs
+streams = sdk.get_streams(
+    anime_id=results[0].id,
+    episode_id=episodes[0].id
+)
+
+# Download episode
+path = sdk.download_episode(
+    anime_id=results[0].id,
+    season=1,
+    episode=1,
+    output_dir="./downloads"
+)
+print(f"Downloaded to: {path}")
+```
+
+**SDK Features:**
+- No subprocess overhead - direct Python API
+- Type-safe with full type hints
+- Automatic provider discovery
+- Same caching as CLI mode
+- Thread-safe operations
+- Headless mode (no database/TUI dependencies)
+
+See [SDK Documentation](https://ewgsta.github.io/weeb-cli/api/sdk/) for complete API reference.
+
 ### Sonarr/*arr Integration (Serve Mode)
 
 weeb-cli can run as a Torznab-compatible server for Sonarr and other *arr applications:
@@ -193,12 +246,18 @@ weeb-cli serve --port 9876 \
   --watch-dir /downloads/watch \
   --completed-dir /downloads/completed \
   --sonarr-url http://sonarr:8989 \
-  --sonarr-api-key YOUR_KEY \
-  --providers animecix,anizle,turkanime
+  --sonarr-api-key YOUR_KEY
 ```
 
 Then add `http://weeb-cli-host:9876` as a Torznab indexer in Sonarr with category 5070 (TV/Anime). The server includes a blackhole download worker that automatically processes grabbed episodes.
 
+**Docker Support:**
+```bash
+docker-compose -f docs/docker-compose.torznab.yml up -d
+```
+
+See [Torznab Server Documentation](https://ewgsta.github.io/weeb-cli/cli/serve-mode/) for full details.
+
 ### RESTful API Server
 
 For web/mobile applications and custom integrations, weeb-cli provides a RESTful API server:

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/README.md

@@ -118,24 +118,77 @@ For scripts, automation, and AI agents, weeb-cli provides JSON API commands that
 weeb-cli api providers
 
 # Search for anime (returns IDs)
-weeb-cli api search "Angel Beats"
+weeb-cli api search "Angel Beats" --provider hianime
 # Returns: [{"id": "12345", "title": "Angel Beats!", ...}]
 
 # List episodes (use ID from search)
-weeb-cli api episodes 12345 --season 1
+weeb-cli api episodes 12345 --season 1 --provider hianime
 
 # Get stream URLs for an episode
-weeb-cli api streams 12345 --season 1 --episode 1
+weeb-cli api streams 12345 --season 1 --episode 1 --provider hianime
 
 # Get anime details
-weeb-cli api details 12345
+weeb-cli api details 12345 --provider hianime
 
 # Download an episode
-weeb-cli api download 12345 --season 1 --episode 1 --output ./downloads
+weeb-cli api download 12345 --season 1 --episode 1 --provider hianime --output ./downloads
 ```
 
+**Provider Selection:**
+All API commands support the `--provider` (or `-p`) option to select which anime source to use:
+- Turkish: `animecix`, `turkanime`, `anizle`, `weeb`
+- English: `hianime`, `allanime`
+- German: `aniworld`
+- Polish: `docchi`
+
+Default provider is `animecix` if not specified. Use `weeb-cli api providers` to see all available providers with their language and region information.
+
 All API commands output JSON to stdout.
 
+### Python SDK (Programmatic Access)
+
+For Python applications, weeb-cli provides a native SDK that doesn't require spawning processes:
+
+```python
+from weeb_cli import WeebSDK
+
+# Initialize SDK
+sdk = WeebSDK(default_provider="hianime")
+
+# Search for anime
+results = sdk.search("One Piece")
+for anime in results:
+    print(f"{anime.title} ({anime.year})")
+
+# Get episodes
+episodes = sdk.get_episodes(results[0].id, season=1)
+
+# Get stream URLs
+streams = sdk.get_streams(
+    anime_id=results[0].id,
+    episode_id=episodes[0].id
+)
+
+# Download episode
+path = sdk.download_episode(
+    anime_id=results[0].id,
+    season=1,
+    episode=1,
+    output_dir="./downloads"
+)
+print(f"Downloaded to: {path}")
+```
+
+**SDK Features:**
+- No subprocess overhead - direct Python API
+- Type-safe with full type hints
+- Automatic provider discovery
+- Same caching as CLI mode
+- Thread-safe operations
+- Headless mode (no database/TUI dependencies)
+
+See [SDK Documentation](https://ewgsta.github.io/weeb-cli/api/sdk/) for complete API reference.
+
 ### Sonarr/*arr Integration (Serve Mode)
 
 weeb-cli can run as a Torznab-compatible server for Sonarr and other *arr applications:
@@ -147,12 +200,18 @@ weeb-cli serve --port 9876 \
   --watch-dir /downloads/watch \
   --completed-dir /downloads/completed \
   --sonarr-url http://sonarr:8989 \
-  --sonarr-api-key YOUR_KEY \
-  --providers animecix,anizle,turkanime
+  --sonarr-api-key YOUR_KEY
 ```
 
 Then add `http://weeb-cli-host:9876` as a Torznab indexer in Sonarr with category 5070 (TV/Anime). The server includes a blackhole download worker that automatically processes grabbed episodes.
 
+**Docker Support:**
+```bash
+docker-compose -f docs/docker-compose.torznab.yml up -d
+```
+
+See [Torznab Server Documentation](https://ewgsta.github.io/weeb-cli/cli/serve-mode/) for full details.
+
 ### RESTful API Server
 
 For web/mobile applications and custom integrations, weeb-cli provides a RESTful API server:

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "weeb-cli"
-version = "2.14.2"
+version = "2.15.0"
 description = "No browser, no ads, no distractions. Just you and an unparalleled anime viewing experience."
 readme = "README.md"
 authors = [{ name = "ewgsta", email = "ewgst@proton.me" }]

weeb_cli-2.15.0/tests/test_sdk.py

@@ -0,0 +1,291 @@
+"""Tests for Weeb CLI SDK."""
+
+import pytest
+from unittest.mock import Mock, patch, MagicMock
+
+from weeb_cli.sdk import WeebSDK, list_providers, get_provider_info
+from weeb_cli.providers.base import AnimeResult, Episode, StreamLink, AnimeDetails
+from weeb_cli.exceptions import ProviderError, WeebCLIError
+
+
+class TestWeebSDK:
+    """Test suite for WeebSDK class."""
+    
+    def test_init_default(self):
+        """Test SDK initialization with defaults."""
+        sdk = WeebSDK()
+        assert sdk.headless is True
+        assert sdk.default_provider == "animecix"
+    
+    def test_init_custom_provider(self):
+        """Test SDK initialization with custom provider."""
+        sdk = WeebSDK(default_provider="hianime")
+        assert sdk.default_provider == "hianime"
+    
+    def test_init_non_headless(self):
+        """Test SDK initialization in non-headless mode."""
+        sdk = WeebSDK(headless=False)
+        assert sdk.headless is False
+    
+    @patch('weeb_cli.sdk._list_providers')
+    def test_list_providers(self, mock_list):
+        """Test listing providers."""
+        mock_list.return_value = [
+            {"name": "animecix", "lang": "tr", "region": "TR"},
+            {"name": "hianime", "lang": "en", "region": "US"}
+        ]
+        
+        sdk = WeebSDK()
+        providers = sdk.list_providers()
+        
+        assert len(providers) == 2
+        assert providers[0]["name"] == "animecix"
+        assert providers[1]["name"] == "hianime"
+    
+    @patch('weeb_cli.sdk._list_providers')
+    def test_get_provider_info(self, mock_list):
+        """Test getting provider info."""
+        mock_list.return_value = [
+            {"name": "animecix", "lang": "tr", "region": "TR"},
+            {"name": "hianime", "lang": "en", "region": "US"}
+        ]
+        
+        sdk = WeebSDK()
+        info = sdk.get_provider_info("hianime")
+        
+        assert info is not None
+        assert info["name"] == "hianime"
+        assert info["lang"] == "en"
+    
+    @patch('weeb_cli.sdk._list_providers')
+    def test_get_provider_info_not_found(self, mock_list):
+        """Test getting info for non-existent provider."""
+        mock_list.return_value = [
+            {"name": "animecix", "lang": "tr", "region": "TR"}
+        ]
+        
+        sdk = WeebSDK()
+        info = sdk.get_provider_info("invalid")
+        
+        assert info is None
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_search_success(self, mock_get_provider):
+        """Test successful anime search."""
+        mock_provider = Mock()
+        mock_provider.search.return_value = [
+            AnimeResult(id="1", title="Anime 1", year=2020),
+            AnimeResult(id="2", title="Anime 2", year=2021)
+        ]
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK()
+        results = sdk.search("test", provider="hianime")
+        
+        assert len(results) == 2
+        assert results[0].title == "Anime 1"
+        mock_provider.search.assert_called_once_with("test")
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_search_provider_not_found(self, mock_get_provider):
+        """Test search with invalid provider."""
+        mock_get_provider.return_value = None
+        
+        sdk = WeebSDK()
+        
+        with pytest.raises(ProviderError) as exc_info:
+            sdk.search("test", provider="invalid")
+        
+        assert "Provider not found or disabled" in str(exc_info.value)
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_search_uses_default_provider(self, mock_get_provider):
+        """Test search uses default provider when not specified."""
+        mock_provider = Mock()
+        mock_provider.search.return_value = []
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK(default_provider="hianime")
+        sdk.search("test")
+        
+        mock_get_provider.assert_called_with("hianime")
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_get_details_success(self, mock_get_provider):
+        """Test getting anime details."""
+        mock_provider = Mock()
+        mock_provider.get_details.return_value = AnimeDetails(
+            id="1",
+            title="Test Anime",
+            description="Test description",
+            genres=["Action", "Adventure"]
+        )
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK()
+        details = sdk.get_details("1", provider="hianime")
+        
+        assert details is not None
+        assert details.title == "Test Anime"
+        assert len(details.genres) == 2
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_get_episodes_success(self, mock_get_provider):
+        """Test getting episode list."""
+        mock_provider = Mock()
+        mock_provider.get_episodes.return_value = [
+            Episode(id="e1", number=1, season=1),
+            Episode(id="e2", number=2, season=1),
+            Episode(id="e3", number=1, season=2)
+        ]
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK()
+        episodes = sdk.get_episodes("anime-id", provider="hianime")
+        
+        assert len(episodes) == 3
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_get_episodes_filter_by_season(self, mock_get_provider):
+        """Test filtering episodes by season."""
+        mock_provider = Mock()
+        mock_provider.get_episodes.return_value = [
+            Episode(id="e1", number=1, season=1),
+            Episode(id="e2", number=2, season=1),
+            Episode(id="e3", number=1, season=2)
+        ]
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK()
+        episodes = sdk.get_episodes("anime-id", season=1, provider="hianime")
+        
+        assert len(episodes) == 2
+        assert all(ep.season == 1 for ep in episodes)
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_get_streams_success(self, mock_get_provider):
+        """Test getting stream URLs."""
+        mock_provider = Mock()
+        mock_provider.get_streams.return_value = [
+            StreamLink(url="http://stream1.com", quality="1080p"),
+            StreamLink(url="http://stream2.com", quality="720p")
+        ]
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK()
+        streams = sdk.get_streams("anime-id", "ep-id", provider="hianime")
+        
+        assert len(streams) == 2
+        assert streams[0].quality == "1080p"
+    
+    @patch('weeb_cli.services.headless_downloader.download_episode')
+    @patch('weeb_cli.sdk.get_provider')
+    def test_download_episode_success(self, mock_get_provider, mock_download):
+        """Test downloading an episode."""
+        mock_provider = Mock()
+        mock_provider.get_episodes.return_value = [
+            Episode(id="e1", number=1, season=1)
+        ]
+        mock_provider.get_streams.return_value = [
+            StreamLink(url="http://stream.com", quality="1080p")
+        ]
+        mock_provider.get_details.return_value = AnimeDetails(
+            id="1", title="Test Anime"
+        )
+        mock_get_provider.return_value = mock_provider
+        mock_download.return_value = "/path/to/file.mp4"
+        
+        sdk = WeebSDK()
+        path = sdk.download_episode(
+            anime_id="1",
+            season=1,
+            episode=1,
+            provider="hianime"
+        )
+        
+        assert path == "/path/to/file.mp4"
+        mock_download.assert_called_once()
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_download_episode_not_found(self, mock_get_provider):
+        """Test downloading non-existent episode."""
+        mock_provider = Mock()
+        mock_provider.get_episodes.return_value = [
+            Episode(id="e1", number=1, season=1)
+        ]
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK()
+        
+        with pytest.raises(WeebCLIError) as exc_info:
+            sdk.download_episode(
+                anime_id="1",
+                season=2,
+                episode=1,
+                provider="hianime"
+            )
+        
+        assert "not found" in str(exc_info.value)
+    
+    @patch('weeb_cli.sdk.get_provider')
+    def test_download_episode_no_streams(self, mock_get_provider):
+        """Test downloading when no streams available."""
+        mock_provider = Mock()
+        mock_provider.get_episodes.return_value = [
+            Episode(id="e1", number=1, season=1)
+        ]
+        mock_provider.get_streams.return_value = []
+        mock_get_provider.return_value = mock_provider
+        
+        sdk = WeebSDK()
+        
+        with pytest.raises(WeebCLIError) as exc_info:
+            sdk.download_episode(
+                anime_id="1",
+                season=1,
+                episode=1,
+                provider="hianime"
+            )
+        
+        assert "No streams available" in str(exc_info.value)
+    
+    @patch('weeb_cli.services.headless_downloader.download_episode')
+    def test_download_url_success(self, mock_download):
+        """Test downloading from direct URL."""
+        mock_download.return_value = "/path/to/file.mp4"
+        
+        sdk = WeebSDK()
+        path = sdk.download_url(
+            stream_url="http://stream.com/video.m3u8",
+            title="Test Anime",
+            season=1,
+            episode=1
+        )
+        
+        assert path == "/path/to/file.mp4"
+        mock_download.assert_called_once()
+
+
+class TestConvenienceFunctions:
+    """Test suite for convenience functions."""
+    
+    @patch('weeb_cli.sdk._list_providers')
+    def test_list_providers_function(self, mock_list):
+        """Test list_providers convenience function."""
+        mock_list.return_value = [
+            {"name": "animecix", "lang": "tr"}
+        ]
+        
+        providers = list_providers()
+        assert len(providers) == 1
+    
+    @patch('weeb_cli.sdk.list_providers')
+    def test_get_provider_info_function(self, mock_list):
+        """Test get_provider_info convenience function."""
+        mock_list.return_value = [
+            {"name": "animecix", "lang": "tr"},
+            {"name": "hianime", "lang": "en"}
+        ]
+        
+        info = get_provider_info("hianime")
+        assert info["name"] == "hianime"

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/weeb_cli/__init__.py

@@ -10,16 +10,35 @@ Features:
     - Advanced download queue with Aria2 and yt-dlp
     - Discord Rich Presence integration
     - Multi-language support (TR, EN, DE, PL)
+    - Python SDK for programmatic access
 
 Example:
-    Basic usage::
+    CLI usage::
 
         $ weeb-cli start
         $ weeb-cli api search "anime name"
         $ weeb-cli serve --port 8080
+    
+    SDK usage::
+
+        from weeb_cli import WeebSDK
+        
+        sdk = WeebSDK(default_provider="hianime")
+        results = sdk.search("One Piece")
+        episodes = sdk.get_episodes(results[0].id)
 
 Attributes:
     __version__ (str): Current version of Weeb CLI.
 """
 
-__version__ = "2.14.2"
+__version__ = "2.15.0"
+
+# SDK exports for easy import
+from weeb_cli.sdk import WeebSDK, list_providers, get_provider_info
+
+__all__ = [
+    "__version__",
+    "WeebSDK",
+    "list_providers",
+    "get_provider_info",
+]

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/weeb_cli/commands/downloads.py

@@ -416,8 +416,9 @@ def play_local_episode(anime, episode):
                 
         except KeyboardInterrupt:
             pass
-        except Exception:
-            pass
+        except Exception as e:
+            from weeb_cli.services.logger import debug
+            debug(f"[Downloads] Tracker sync display error: {e}")
 
 def manage_queue():
     while True:

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/weeb_cli/config.py

@@ -127,8 +127,9 @@ class Config:
                 val = self.db.get_config(key)
                 if val is not None:
                     return val
-            except Exception:
-                pass
+            except Exception as e:
+                from weeb_cli.services.logger import debug
+                debug(f"[Config] DB read failed for '{key}': {e}")
 
         # Special handling for download_dir
         if key == "download_dir":
@@ -136,7 +137,7 @@ class Config:
 
         # Use provided default, fallback to DEFAULT_CONFIG, then None
         if default is not None:
-            return DEFAULT_CONFIG.get(key, default)
+            return default
         return DEFAULT_CONFIG.get(key)
 
     def set(self, key: str, value: Any) -> None:

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/weeb_cli/i18n.py

@@ -70,7 +70,9 @@ class I18n:
         """Initialize i18n with language from config or default to English."""
         try:
             self.language: str = config.get("language", "en")
-        except Exception:
+        except Exception as e:
+            from weeb_cli.services.logger import debug
+            debug(f"[I18n] Config read failed, defaulting to English: {e}")
             self.language = "en"
         self.translations: Dict[str, Any] = {}
         self.load_translations()
@@ -98,7 +100,9 @@ class I18n:
         try:
             with open(file_path, "r", encoding="utf-8") as f:
                 self.translations = json.load(f)
-        except Exception:
+        except (json.JSONDecodeError, OSError) as e:
+            from weeb_cli.services.logger import debug
+            debug(f"[I18n] Failed to load translations for '{self.language}': {e}")
             self.translations = {}
 
     def get(self, key_path: str, default: Optional[str] = None, **kwargs: Any) -> str:

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/weeb_cli/locales/de.json

@@ -82,20 +82,7 @@
         "drive_removed": "Laufwerk entfernt.",
         "current_dir": "Aktuell: {dir}",
         "retry_delay_error": "Wiederholungsverzögerung muss zwischen 0 und 300 Sekunden liegen.",
-        "cache": {
-            "title": "Cache-Verwaltung",
-            "memory_entries": "Speichereinträge",
-            "file_entries": "Dateieinträge",
-            "total_size": "Gesamtgröße",
-            "clear_all": "Gesamten Cache leeren",
-            "clear_provider": "Aktuellen Provider-Cache leeren",
-            "cleanup_old": "Alten Cache bereinigen (>24h)",
-            "cleared": "Cache geleert",
-            "provider_cleared": "Provider-Cache geleert",
-            "cleaned": "Bereinigt",
-            "prompt": "Aktion auswählen",
-            "confirm_clear_all": "Gesamten Cache leeren?"
-        },
+        "cache": "Cache-Verwaltung",
         "anilist": "AniList",
         "anilist_connected": "Verbunden: {user}",
         "anilist_not_connected": "Verbinden Sie Ihr AniList-Konto, um Ihren Verlauf zu synchronisieren.",

{weeb_cli-2.14.2 → weeb_cli-2.15.0}/weeb_cli/locales/en.json

@@ -82,20 +82,7 @@
         "drive_removed": "Drive removed.",
         "current_dir": "Current: {dir}",
         "retry_delay_error": "Retry delay must be between 0 and 300 seconds.",
-        "cache": {
-            "title": "Cache Management",
-            "memory_entries": "Memory entries",
-            "file_entries": "File entries",
-            "total_size": "Total size",
-            "clear_all": "Clear all cache",
-            "clear_provider": "Clear current provider cache",
-            "cleanup_old": "Cleanup old cache (>24h)",
-            "cleared": "Cache cleared",
-            "provider_cleared": "Provider cache cleared",
-            "cleaned": "Cleaned",
-            "prompt": "Select action",
-            "confirm_clear_all": "Clear all cache?"
-        },
+        "cache": "Cache Management",
         "anilist": "AniList",
         "anilist_connected": "Connected: {user}",
         "anilist_not_connected": "Connect your AniList account to sync your watch history.",