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

{weeb_cli-2.13.2 → weeb_cli-2.14.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: weeb-cli
-Version: 2.13.2
-Summary: Tarayıcı yok, reklam yok, dikkat dağıtıcı unsur yok. Sadece siz ve eşsiz bir anime izleme deneyimi.
+Version: 2.14.2
+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
 Project-URL: Homepage, https://weeb-cli.ewgsta.me
 Project-URL: Repository, https://github.com/ewgsta/weeb-cli
 Project-URL: Issues, https://github.com/ewgsta/weeb-cli/issues
-Keywords: anime,weeb,anime-download,anizm,anime-watch,anime-watching,anime-downloading,anime-cli,allanime,animecix,anime-indir,anime-izle,weeb-cli,anime-izleme,anime-indirme,weebanime,tranime
+Keywords: terminal,anime,tui,crossplatform,anime-download,turkanime,anizm,anime-watch,aniwatch,anime-cli,ani-cli,openanime,allanime,hianime,anitr-cli,animecix,anime-indir,anime-izle,weeb-cli,katsuanime
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Classifier: Environment :: Console
@@ -32,6 +32,9 @@ Requires-Dist: winotify; sys_platform == "win32"
 Provides-Extra: serve
 Requires-Dist: flask>=3.0; extra == "serve"
 Requires-Dist: pyyaml>=6.0; extra == "serve"
+Provides-Extra: serve-restful
+Requires-Dist: flask>=3.0; extra == "serve-restful"
+Requires-Dist: flask-cors>=4.0; extra == "serve-restful"
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
 Requires-Dist: pyinstaller; extra == "dev"
@@ -52,7 +55,7 @@ Dynamic: license-file
 </p>
 
 <div align="center">
-  <a href="README.md">English</a> | <a href="md/tr/README.md">Türkçe</a> | <a href="md/de/README.md">Deutsch</a> | <a href="md/pl/README.md">Polski</a>
+  <a href="README.md">English</a> | <a href="docs/md/tr/README.md">Türkçe</a> | <a href="docs/md/de/README.md">Deutsch</a> | <a href="docs/md/pl/README.md">Polski</a>
 </div>
 <br>
 
@@ -118,6 +121,7 @@ Dynamic: license-file
 - Automatic update checks
 - Non-interactive JSON API for scripts and AI agents
 - Torznab server mode for Sonarr/*arr integration
+- RESTful API server for web/mobile applications
 
 ---
 
@@ -195,7 +199,34 @@ weeb-cli serve --port 9876 \
 
 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
+### RESTful API Server
+
+For web/mobile applications and custom integrations, weeb-cli provides a RESTful API server:
+
+```bash
+pip install weeb-cli[serve-restful]
+
+weeb-cli serve restful --port 8080 --cors
+```
+
+**API Endpoints:**
+- `GET /health` - Health check
+- `GET /api/providers` - List available providers
+- `GET /api/search?q=naruto&provider=animecix` - Search anime
+- `GET /api/anime/{id}?provider=animecix` - Get anime details
+- `GET /api/anime/{id}/episodes?season=1` - List episodes
+- `GET /api/anime/{id}/episodes/{ep_id}/streams` - Get stream URLs
+
+All available providers are loaded automatically. Select which provider to use via the `provider` query parameter.
+
+**Docker Support:**
+```bash
+docker-compose -f docs/docker-compose.restful.yml up -d
+```
+
+See [RESTful API Documentation](https://ewgsta.github.io/weeb-cli/cli/restful-api/) for full details.
+
+#### Docker (Torznab)
 
 ```dockerfile
 FROM python:3.13-slim
@@ -292,6 +323,7 @@ All settings can be modified through the interactive Settings menu.
 - [x] Keyboard shortcuts
 - [x] Non-interactive API mode (JSON output)
 - [x] Torznab server for Sonarr/*arr integration
+- [x] RESTful API server for web/mobile apps
 
 
 ### Planned
@@ -315,6 +347,7 @@ weeb-cli/
 │   │   ├── downloads.py         # Download management commands
 │   │   ├── search.py            # Anime search functionality
 │   │   ├── serve.py             # Torznab server for *arr integration
+│   │   ├── serve_restful.py     # RESTful API server
 │   │   ├── settings.py          # Settings menu and configuration
 │   │   ├── setup.py             # Initial setup wizard
 │   │   └── watchlist.py         # Watch history and progress

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

@@ -9,7 +9,7 @@
 </p>
 
 <div align="center">
-  <a href="README.md">English</a> | <a href="md/tr/README.md">Türkçe</a> | <a href="md/de/README.md">Deutsch</a> | <a href="md/pl/README.md">Polski</a>
+  <a href="README.md">English</a> | <a href="docs/md/tr/README.md">Türkçe</a> | <a href="docs/md/de/README.md">Deutsch</a> | <a href="docs/md/pl/README.md">Polski</a>
 </div>
 <br>
 
@@ -75,6 +75,7 @@
 - Automatic update checks
 - Non-interactive JSON API for scripts and AI agents
 - Torznab server mode for Sonarr/*arr integration
+- RESTful API server for web/mobile applications
 
 ---
 
@@ -152,7 +153,34 @@ weeb-cli serve --port 9876 \
 
 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
+### RESTful API Server
+
+For web/mobile applications and custom integrations, weeb-cli provides a RESTful API server:
+
+```bash
+pip install weeb-cli[serve-restful]
+
+weeb-cli serve restful --port 8080 --cors
+```
+
+**API Endpoints:**
+- `GET /health` - Health check
+- `GET /api/providers` - List available providers
+- `GET /api/search?q=naruto&provider=animecix` - Search anime
+- `GET /api/anime/{id}?provider=animecix` - Get anime details
+- `GET /api/anime/{id}/episodes?season=1` - List episodes
+- `GET /api/anime/{id}/episodes/{ep_id}/streams` - Get stream URLs
+
+All available providers are loaded automatically. Select which provider to use via the `provider` query parameter.
+
+**Docker Support:**
+```bash
+docker-compose -f docs/docker-compose.restful.yml up -d
+```
+
+See [RESTful API Documentation](https://ewgsta.github.io/weeb-cli/cli/restful-api/) for full details.
+
+#### Docker (Torznab)
 
 ```dockerfile
 FROM python:3.13-slim
@@ -249,6 +277,7 @@ All settings can be modified through the interactive Settings menu.
 - [x] Keyboard shortcuts
 - [x] Non-interactive API mode (JSON output)
 - [x] Torznab server for Sonarr/*arr integration
+- [x] RESTful API server for web/mobile apps
 
 
 ### Planned
@@ -272,6 +301,7 @@ weeb-cli/
 │   │   ├── downloads.py         # Download management commands
 │   │   ├── search.py            # Anime search functionality
 │   │   ├── serve.py             # Torznab server for *arr integration
+│   │   ├── serve_restful.py     # RESTful API server
 │   │   ├── settings.py          # Settings menu and configuration
 │   │   ├── setup.py             # Initial setup wizard
 │   │   └── watchlist.py         # Watch history and progress

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

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "weeb-cli"
-version = "2.13.2"
-description = "Tarayıcı yok, reklam yok, dikkat dağıtıcı unsur yok. Sadece siz ve eşsiz bir anime izleme deneyimi."
+version = "2.14.2"
+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" }]
 license = "GPL-3.0-only"
@@ -14,7 +14,7 @@ classifiers = [
     "Operating System :: OS Independent",
     "Environment :: Console",
 ]
-keywords = ["anime", "weeb", "anime-download", "anizm", "anime-watch", "anime-watching", "anime-downloading", "anime-cli", "allanime", "animecix", "anime-indir", "anime-izle", "weeb-cli", "anime-izleme", "anime-indirme", "weebanime", "tranime"]
+keywords = ["terminal", "anime", "tui", "crossplatform", "anime-download", "turkanime", "anizm", "anime-watch", "aniwatch", "anime-cli", "ani-cli", "openanime", "allanime", "hianime", "anitr-cli", "animecix", "anime-indir", "anime-izle", "weeb-cli", "katsuanime"]
 requires-python = ">=3.12"
 dependencies = [
     "typer[all]",
@@ -36,6 +36,7 @@ dependencies = [
 
 [project.optional-dependencies]
 serve = ["flask>=3.0", "pyyaml>=6.0"]
+serve-restful = ["flask>=3.0", "flask-cors>=4.0"]
 dev = ["build", "pyinstaller", "pytest>=7.0.0", "pytest-cov", "pytest-asyncio", "pytest-mock"]
 
 [tool.setuptools.packages.find]

weeb_cli-2.14.2/tests/test_restful_api.py

@@ -0,0 +1,227 @@
+"""Tests for RESTful API server."""
+import pytest
+from unittest.mock import Mock, patch, MagicMock
+from weeb_cli.providers.base import AnimeResult, Episode, StreamLink
+
+
+@pytest.fixture
+def mock_provider():
+    """Create a mock provider."""
+    provider = Mock()
+    provider.name = "test_provider"
+    provider.search.return_value = [
+        AnimeResult(
+            id="test123",
+            title="Test Anime",
+            type="series",
+            cover="https://example.com/cover.jpg",
+            year=2024,
+        )
+    ]
+    provider.get_episodes.return_value = [
+        Episode(id="ep1", number=1, title="Episode 1", season=1),
+        Episode(id="ep2", number=2, title="Episode 2", season=1),
+    ]
+    provider.get_streams.return_value = [
+        StreamLink(
+            url="https://example.com/stream.m3u8",
+            quality="1080p",
+            server="default",
+            headers={"Referer": "https://example.com"},
+        )
+    ]
+    return provider
+
+
+@pytest.fixture
+def mock_flask_app(mock_provider):
+    """Create a mock Flask app with routes."""
+    with patch("weeb_cli.commands.serve_restful.get_provider") as mock_get_provider:
+        mock_get_provider.return_value = mock_provider
+        
+        with patch("weeb_cli.commands.serve_restful.list_all_providers") as mock_list:
+            mock_list.return_value = [
+                {"name": "test_provider", "lang": "en", "region": "US"}
+            ]
+            
+            # Import after patching
+            from flask import Flask
+            app = Flask(__name__)
+            
+            # Mock the routes (simplified for testing)
+            @app.route("/health")
+            def health():
+                from flask import jsonify
+                return jsonify({
+                    "status": "ok",
+                    "service": "weeb-cli-restful",
+                    "providers": ["test_provider"],
+                })
+            
+            yield app
+
+
+def test_health_endpoint(mock_flask_app):
+    """Test health check endpoint."""
+    client = mock_flask_app.test_client()
+    response = client.get("/health")
+    
+    assert response.status_code == 200
+    data = response.get_json()
+    assert data["status"] == "ok"
+    assert data["service"] == "weeb-cli-restful"
+    assert "test_provider" in data["providers"]
+
+
+def test_serialize_anime_result():
+    """Test AnimeResult serialization."""
+    from weeb_cli.commands.serve_restful import _serialize_anime_result
+    
+    result = AnimeResult(
+        id="test123",
+        title="Test Anime",
+        type="series",
+        cover="https://example.com/cover.jpg",
+        year=2024,
+    )
+    
+    serialized = _serialize_anime_result(result)
+    
+    assert serialized["id"] == "test123"
+    assert serialized["title"] == "Test Anime"
+    assert serialized["type"] == "series"
+    assert serialized["cover"] == "https://example.com/cover.jpg"
+    assert serialized["year"] == 2024
+
+
+def test_serialize_episode():
+    """Test Episode serialization."""
+    from weeb_cli.commands.serve_restful import _serialize_episode
+    
+    episode = Episode(
+        id="ep1",
+        number=1,
+        title="Episode 1",
+        season=1,
+        url="https://example.com/ep1",
+    )
+    
+    serialized = _serialize_episode(episode)
+    
+    assert serialized["id"] == "ep1"
+    assert serialized["number"] == 1
+    assert serialized["title"] == "Episode 1"
+    assert serialized["season"] == 1
+    assert serialized["url"] == "https://example.com/ep1"
+
+
+def test_serialize_stream():
+    """Test StreamLink serialization."""
+    from weeb_cli.commands.serve_restful import _serialize_stream
+    
+    stream = StreamLink(
+        url="https://example.com/stream.m3u8",
+        quality="1080p",
+        server="default",
+        headers={"Referer": "https://example.com"},
+        subtitles="https://example.com/subs.vtt",
+    )
+    
+    serialized = _serialize_stream(stream)
+    
+    assert serialized["url"] == "https://example.com/stream.m3u8"
+    assert serialized["quality"] == "1080p"
+    assert serialized["server"] == "default"
+    assert serialized["headers"]["Referer"] == "https://example.com"
+    assert serialized["subtitles"] == "https://example.com/subs.vtt"
+
+
+def test_quality_score():
+    """Test quality scoring function."""
+    from weeb_cli.commands.serve_restful import _quality_score
+    
+    assert _quality_score("4k") == 5
+    assert _quality_score("2160p") == 5
+    assert _quality_score("1080p") == 4
+    assert _quality_score("720p") == 3
+    assert _quality_score("480p") == 2
+    assert _quality_score("360p") == 1
+    assert _quality_score("unknown") == 0
+    assert _quality_score(None) == 0
+
+
+@patch("weeb_cli.commands.serve_restful.get_provider")
+def test_search_with_provider(mock_get_provider, mock_provider):
+    """Test search functionality with provider selection."""
+    mock_get_provider.return_value = mock_provider
+    
+    # Simulate search
+    results = mock_provider.search("test query")
+    
+    assert len(results) == 1
+    assert results[0].title == "Test Anime"
+    assert results[0].id == "test123"
+
+
+@patch("weeb_cli.commands.serve_restful.get_provider")
+def test_get_episodes_with_season_filter(mock_get_provider, mock_provider):
+    """Test episode listing with season filter."""
+    mock_get_provider.return_value = mock_provider
+    
+    # Add episodes from different seasons
+    mock_provider.get_episodes.return_value = [
+        Episode(id="ep1", number=1, season=1),
+        Episode(id="ep2", number=2, season=1),
+        Episode(id="ep3", number=1, season=2),
+    ]
+    
+    episodes = mock_provider.get_episodes("test123")
+    season_1_episodes = [ep for ep in episodes if ep.season == 1]
+    
+    assert len(season_1_episodes) == 2
+    assert all(ep.season == 1 for ep in season_1_episodes)
+
+
+@patch("weeb_cli.commands.serve_restful.get_provider")
+def test_get_streams_sorted(mock_get_provider, mock_provider):
+    """Test stream retrieval with quality sorting."""
+    from weeb_cli.commands.serve_restful import _quality_score
+    
+    mock_get_provider.return_value = mock_provider
+    
+    # Add streams with different qualities
+    mock_provider.get_streams.return_value = [
+        StreamLink(url="url1", quality="480p"),
+        StreamLink(url="url2", quality="1080p"),
+        StreamLink(url="url3", quality="720p"),
+    ]
+    
+    streams = mock_provider.get_streams("test123", "ep1")
+    sorted_streams = sorted(streams, key=lambda s: _quality_score(s.quality), reverse=True)
+    
+    assert sorted_streams[0].quality == "1080p"
+    assert sorted_streams[1].quality == "720p"
+    assert sorted_streams[2].quality == "480p"
+
+
+def test_missing_flask_import():
+    """Test graceful handling when Flask is not installed."""
+    with patch("builtins.__import__", side_effect=ImportError("No module named 'flask'")):
+        with pytest.raises(ImportError):
+            import flask
+
+
+@pytest.mark.parametrize("quality,expected_score", [
+    ("4K", 5),
+    ("2160p", 5),
+    ("1080p", 4),
+    ("720p", 3),
+    ("480p", 2),
+    ("360p", 1),
+    ("auto", 0),
+    ("", 0),
+])
+def test_quality_score_parametrized(quality, expected_score):
+    """Test quality scoring with various inputs."""
+    from weeb_cli.commands.serve_restful import _quality_score
+    assert _quality_score(quality) == expected_score

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

@@ -22,4 +22,4 @@ Attributes:
     __version__ (str): Current version of Weeb CLI.
 """
 
-__version__ = "2.13.2"
+__version__ = "2.14.2"

{weeb_cli-2.13.2 → weeb_cli-2.14.2}/weeb_cli/commands/search/watch_flow.py

@@ -8,6 +8,10 @@ from weeb_cli.services.player import player
 from weeb_cli.services.progress import progress_tracker
 from weeb_cli.services.scraper import scraper
 from weeb_cli.services.logger import error as log_error
+from weeb_cli.services.stream_validator import stream_validator
+from weeb_cli.config import config
+from concurrent.futures import ThreadPoolExecutor
+from weeb_cli.services.tracker import anilist_tracker, mal_tracker, kitsu_tracker
 from .episode_utils import get_episodes_safe, group_episodes_by_season, make_season_episode_id
 from .stream_utils import sort_streams, extract_streams_from_response
 
@@ -148,15 +152,7 @@ def _build_episode_choices(episodes, season, completed_ids, next_ep_num):
     
     return ep_choices
 
-def _play_episode(slug, selected_ep, details, season, episodes, completed_ids):
-    ep_id = selected_ep.get("id")
-    ep_num = selected_ep.get("number") or selected_ep.get("ep_num")
-    
-    if not ep_id:
-        console.print(f"[red]{i18n.t('details.invalid_ep_id')}[/red]")
-        time.sleep(1)
-        return False
-
+def _fetch_and_validate_streams(slug, ep_id):
     with console.status(i18n.t("common.processing"), spinner="dots"):
         stream_resp = get_streams(slug, ep_id)
     
@@ -168,24 +164,40 @@ def _play_episode(slug, selected_ep, details, season, episodes, completed_ids):
             error_msg += f" [{scraper.last_error}]"
         console.print(f"[red]{error_msg}[/red]")
         time.sleep(1.5)
-        return False
+        return None
     
-    from weeb_cli.services.stream_validator import stream_validator
-    from weeb_cli.config import config
-
     valid_streams = []
     if config.get("scraping_source") == "docchi":
         valid_streams = streams_list
     else:
         console.print(f"[dim]{i18n.t('details.validating_streams')}...[/dim]")
-        for stream in streams_list:
-            is_valid, error = stream_validator.validate_url(stream.get("url"), timeout=3)
-            if is_valid:
-                valid_streams.append(stream)
+        
+        def check_stream(stream):
+            is_valid, _ = stream_validator.validate_url(stream.get("url"), timeout=3)
+            return stream if is_valid else None
+            
+        with ThreadPoolExecutor(max_workers=len(streams_list) if streams_list else 1) as executor:
+            results = executor.map(check_stream, streams_list)
+            valid_streams = [s for s in results if s is not None]
 
     if not valid_streams:
         console.print(f"[red]{i18n.t('details.no_valid_streams')}[/red]")
         time.sleep(1.5)
+        return None
+
+    return valid_streams
+
+def _play_episode(slug, selected_ep, details, season, episodes, completed_ids):
+    ep_id = selected_ep.get("id")
+    ep_num = selected_ep.get("number") or selected_ep.get("ep_num")
+    
+    if not ep_id:
+        console.print(f"[red]{i18n.t('details.invalid_ep_id')}[/red]")
+        time.sleep(1)
+        return False
+
+    valid_streams = _fetch_and_validate_streams(slug, ep_id)
+    if not valid_streams:
         return False
 
     streams_list = sort_streams(valid_streams)
@@ -222,7 +234,7 @@ def _play_episode(slug, selected_ep, details, season, episodes, completed_ids):
                 title=details.get("title"),
                 total_episodes=total_eps
             )
-            _update_trackers(details, slug)
+            _update_trackers(details, slug, n)
             auto_watched["triggered"] = True
 
     play_success = player.play(
@@ -278,7 +290,7 @@ def _mark_episode_watched(slug, details, ep_num, season, episodes, completed_ids
         )
         console.print(f"[green]✓ {i18n.t('details.marked_watched')}[/green]")
         
-        _update_trackers(details, slug)
+        _update_trackers(details, slug, n)
         
         completed_ids.add(season_ep_id)
         return True
@@ -286,12 +298,14 @@ def _mark_episode_watched(slug, details, ep_num, season, episodes, completed_ids
         log_error(f"Failed to mark episode as watched: {e}")
         return False
 
-def _update_trackers(details, slug):
-    from weeb_cli.services.tracker import anilist_tracker, mal_tracker, kitsu_tracker
-    from concurrent.futures import ThreadPoolExecutor
-    
+def _update_trackers(details, slug, ep_num=None):
     updated_prog = progress_tracker.get_anime_progress(slug)
-    total_watched = len(updated_prog.get("completed", []))
+    
+    if ep_num is not None:
+        total_watched = int(ep_num)
+    else:
+        total_watched = len(updated_prog.get("completed", []))
+        
     total_eps = details.get("total_episodes", 0)
     
     trackers = [

{weeb_cli-2.13.2 → weeb_cli-2.14.2}/weeb_cli/commands/serve.py

@@ -32,10 +32,30 @@ def _sanitize_for_release(name: str) -> str:
 
 serve_app = typer.Typer(
     name="serve",
-    help="Start a Torznab-compatible server for Sonarr/*arr integration.",
+    help="Start server modes: Torznab for Sonarr/*arr integration or RESTful API server.",
     add_completion=False,
+    invoke_without_command=True,
 )
 
+@serve_app.callback()
+def serve_callback(ctx: typer.Context):
+    """Server modes for weeb-cli.
+    
+    Available modes:
+    - torznab: Torznab-compatible server for Sonarr/*arr integration
+    - restful: RESTful API server for web/mobile applications
+    """
+    if ctx.invoked_subcommand is None:
+        typer.echo(ctx.get_help())
+        raise typer.Exit(0)
+
+# Import restful subcommand
+try:
+    from weeb_cli.commands.serve_restful import restful_app
+    serve_app.add_typer(restful_app, name="restful")
+except ImportError:
+    pass  # Flask not installed, restful mode unavailable
+
 
 # -- Helpers ------------------------------------------------------------------
 
@@ -206,10 +226,16 @@ def _get_fallback_streams(fallback_providers, sonarr_title, season, episode_num)
     return []
 
 
-# -- Main serve command -------------------------------------------------------
+# -- Torznab serve command ----------------------------------------------------
+
+torznab_app = typer.Typer(
+    name="torznab",
+    help="Start Torznab-compatible server for Sonarr/*arr integration.",
+    add_completion=False,
+)
 
-@serve_app.callback(invoke_without_command=True)
-def serve(
+@torznab_app.callback(invoke_without_command=True)
+def serve_torznab(
     ctx: typer.Context,
     port: int = typer.Option(9876, "--port", envvar="FLASK_PORT", help="HTTP port"),
     watch_dir: str = typer.Option("/downloads/weeb-cli/watch", "--watch-dir", envvar="WATCH_DIR", help="Blackhole watch directory"),
@@ -470,3 +496,7 @@ def serve(
     worker.start()
 
     flask_app.run(host="0.0.0.0", port=port, debug=False)
+
+
+# Register torznab subcommand
+serve_app.add_typer(torznab_app, name="torznab")