weeb-cli 2.13.0__tar.gz → 2.14.0__tar.gz

{weeb_cli-2.13.0 → weeb_cli-2.14.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: weeb-cli
-Version: 2.13.0
-Summary: Tarayıcı yok, reklam yok, dikkat dağıtıcı unsur yok. Sadece siz ve eşsiz bir anime izleme deneyimi.
+Version: 2.14.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
 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
@@ -24,7 +24,7 @@ Requires-Dist: lxml
 Requires-Dist: pycryptodome
 Requires-Dist: curl_cffi
 Requires-Dist: appdirs
-Requires-Dist: prompt_toolkit<3.0.50,>=3.0.36
+Requires-Dist: prompt_toolkit<3.0.53,>=3.0.36
 Requires-Dist: pyfiglet
 Requires-Dist: py7zr
 Requires-Dist: pypresence
@@ -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"
@@ -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 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.0 → weeb_cli-2.14.0}/README.md

@@ -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 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.0 → weeb_cli-2.14.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "weeb-cli"
-version = "2.13.0"
-description = "Tarayıcı yok, reklam yok, dikkat dağıtıcı unsur yok. Sadece siz ve eşsiz bir anime izleme deneyimi."
+version = "2.14.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" }]
 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]",
@@ -27,7 +27,7 @@ dependencies = [
     "pycryptodome",
     "curl_cffi",
     "appdirs",
-    "prompt_toolkit>=3.0.36,<3.0.50",
+    "prompt_toolkit>=3.0.36,<3.0.53",
     "pyfiglet",
     "py7zr",
     "pypresence",
@@ -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.0/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.0 → weeb_cli-2.14.0}/weeb_cli/__init__.py

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

{weeb_cli-2.13.0 → weeb_cli-2.14.0}/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")