sonilo-cli 0.1.0__tar.gz → 0.3.0__tar.gz

{sonilo_cli-0.1.0 → sonilo_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sonilo-cli
-Version: 0.1.0
+Version: 0.3.0
 Summary: Command-line interface for the Sonilo API: generate music and sound effects from text or video
 Project-URL: Repository, https://github.com/sonilo-ai/sonilo-python
 Author: Sonilo AI
@@ -8,7 +8,7 @@ License-Expression: MIT
 License-File: LICENSE
 Keywords: ai,cli,music,sfx,sonilo,text-to-music,video-to-music
 Requires-Python: >=3.9
-Requires-Dist: sonilo<0.6,>=0.5
+Requires-Dist: sonilo<0.8,>=0.7.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == 'dev'
 Requires-Dist: respx>=0.21; extra == 'dev'
@@ -41,6 +41,8 @@ or pass `--api-key sk-...` on any command.
     sonilo video-to-sound --video clip.mp4 \
         --music-prompt "uplifting orchestral score" --sfx-prompt "match the on-screen action"
     sonilo video-to-video-sound --video clip.mp4 --music-prompt "tense synths"
+    sonilo dubbing --video-url https://example.com/clip.mp4 --languages es,fr --output dubbed.mp4
+    # writes dubbed.es.mp4 and dubbed.fr.mp4
     sonilo tasks get <task-id>
     sonilo tasks wait <task-id> --poll-interval 2 --timeout 600
 
@@ -73,15 +75,46 @@ they differ only in what comes back: `video-to-sound` writes the mixed **audio**
   music stem lands at `soundtrack.music.m4a`. `music_processed` exists only when `--preserve-speech`
   or ducking altered the music bed.
 
+### Dubbing
+
+`dubbing` dubs a video into one or more target languages in a single async call:
+
+    sonilo dubbing --video-url https://example.com/clip.mp4 --languages es,fr --output dubbed.mp4
+    # writes dubbed.es.mp4 and dubbed.fr.mp4
+
+- `--languages` is comma-separated; omit it to use the server default `zh_cn,es,fr`. Supported
+  codes: `en, zh_cn, ja, ko, pt, es, de, fr, it, ru`.
+- Source videos may be at most 180 seconds long.
+- `--output` is a filename template, not a single destination: a dubbing task returns one video
+  per language, so `--output clip.mp4` writes `clip.es.mp4`, `clip.fr.mp4`, etc.
+- Billing is per language, and dubbing has **no free trial runs** — see [Free trial](#free-trial)
+  below.
+- `--timeout` defaults to 7200 seconds, matching the backend's own ceiling for a dubbing job
+  (far longer than other commands' default, since dubbing can run well past the usual
+  `tasks wait --timeout 600`). If the wait still times out, the task keeps running
+  server-side — resume watching it with `sonilo tasks wait <task-id>`.
+
 ## Free trial
 
-Accounts created through self-serve signup start with free runs on every endpoint — no card
+Accounts created through self-serve signup start with free runs on most endpoints — no card
 required:
 
 | Free runs | Endpoints |
 | --- | --- |
 | 2 each | text-to-music, text-to-sfx, audio-ducking |
 | 1 each | video-to-music, video-to-sfx, video-to-video-music, video-to-video-sfx, video-to-sound, video-to-video-sound |
+| 0 | dubbing |
+
+Dubbing bills `video duration × number of languages`, so a free run on it would be worth far more
+than a free run on any other endpoint — it has no free allowance and bills from the first call.
+
+The table above is the current default. `sonilo account` prints the live numbers: the account JSON
+goes to stdout, and when the account has a free-trial allowance one summary line goes to stderr:
+
+    Free trial: text-to-music 1/2 left, video-to-music 0/1 left
+
+Because the summary is on stderr, `sonilo account | jq .trial` still sees clean JSON.
 
-Once an endpoint's free runs are used up, calls to it bill at the normal rate. `sonilo account`
-shows the services available to your key.
+Once an endpoint's free runs are used up, calls to it bill at the normal rate — or, if the account
+has never been funded, fail with `HTTP 402: ... (trial_exhausted)` until a payment method is added.
+That is the one 402 a retry can never fix.

{sonilo_cli-0.1.0 → sonilo_cli-0.3.0}/README.md

@@ -25,6 +25,8 @@ or pass `--api-key sk-...` on any command.
     sonilo video-to-sound --video clip.mp4 \
         --music-prompt "uplifting orchestral score" --sfx-prompt "match the on-screen action"
     sonilo video-to-video-sound --video clip.mp4 --music-prompt "tense synths"
+    sonilo dubbing --video-url https://example.com/clip.mp4 --languages es,fr --output dubbed.mp4
+    # writes dubbed.es.mp4 and dubbed.fr.mp4
     sonilo tasks get <task-id>
     sonilo tasks wait <task-id> --poll-interval 2 --timeout 600
 
@@ -57,15 +59,46 @@ they differ only in what comes back: `video-to-sound` writes the mixed **audio**
   music stem lands at `soundtrack.music.m4a`. `music_processed` exists only when `--preserve-speech`
   or ducking altered the music bed.
 
+### Dubbing
+
+`dubbing` dubs a video into one or more target languages in a single async call:
+
+    sonilo dubbing --video-url https://example.com/clip.mp4 --languages es,fr --output dubbed.mp4
+    # writes dubbed.es.mp4 and dubbed.fr.mp4
+
+- `--languages` is comma-separated; omit it to use the server default `zh_cn,es,fr`. Supported
+  codes: `en, zh_cn, ja, ko, pt, es, de, fr, it, ru`.
+- Source videos may be at most 180 seconds long.
+- `--output` is a filename template, not a single destination: a dubbing task returns one video
+  per language, so `--output clip.mp4` writes `clip.es.mp4`, `clip.fr.mp4`, etc.
+- Billing is per language, and dubbing has **no free trial runs** — see [Free trial](#free-trial)
+  below.
+- `--timeout` defaults to 7200 seconds, matching the backend's own ceiling for a dubbing job
+  (far longer than other commands' default, since dubbing can run well past the usual
+  `tasks wait --timeout 600`). If the wait still times out, the task keeps running
+  server-side — resume watching it with `sonilo tasks wait <task-id>`.
+
 ## Free trial
 
-Accounts created through self-serve signup start with free runs on every endpoint — no card
+Accounts created through self-serve signup start with free runs on most endpoints — no card
 required:
 
 | Free runs | Endpoints |
 | --- | --- |
 | 2 each | text-to-music, text-to-sfx, audio-ducking |
 | 1 each | video-to-music, video-to-sfx, video-to-video-music, video-to-video-sfx, video-to-sound, video-to-video-sound |
+| 0 | dubbing |
+
+Dubbing bills `video duration × number of languages`, so a free run on it would be worth far more
+than a free run on any other endpoint — it has no free allowance and bills from the first call.
+
+The table above is the current default. `sonilo account` prints the live numbers: the account JSON
+goes to stdout, and when the account has a free-trial allowance one summary line goes to stderr:
+
+    Free trial: text-to-music 1/2 left, video-to-music 0/1 left
+
+Because the summary is on stderr, `sonilo account | jq .trial` still sees clean JSON.
 
-Once an endpoint's free runs are used up, calls to it bill at the normal rate. `sonilo account`
-shows the services available to your key.
+Once an endpoint's free runs are used up, calls to it bill at the normal rate — or, if the account
+has never been funded, fail with `HTTP 402: ... (trial_exhausted)` until a payment method is added.
+That is the one 402 a retry can never fix.

{sonilo_cli-0.1.0 → sonilo_cli-0.3.0}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sonilo-cli"
-version = "0.1.0"
+version = "0.3.0"
 description = "Command-line interface for the Sonilo API: generate music and sound effects from text or video"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.9"
 authors = [{ name = "Sonilo AI" }]
-dependencies = ["sonilo>=0.5,<0.6"]
+dependencies = ["sonilo>=0.7.0,<0.8"]
 keywords = ["sonilo", "cli", "music", "sfx", "text-to-music", "video-to-music", "ai"]
 
 [project.urls]

{sonilo_cli-0.1.0 → sonilo_cli-0.3.0}/src/sonilo_cli/__init__.py

@@ -1,3 +1,3 @@
-__version__ = "0.1.0"
+__version__ = "0.3.0"
 
 __all__ = ["__version__"]

{sonilo_cli-0.1.0 → sonilo_cli-0.3.0}/src/sonilo_cli/__main__.py

@@ -6,11 +6,11 @@ import os
 import sys
 import time
 from pathlib import Path
-from typing import Any, List, NoReturn, Optional
+from typing import Any, Dict, List, NoReturn, Optional
 from urllib.parse import urlparse
 
 from sonilo import Sonilo
-from sonilo.errors import SoniloError
+from sonilo.errors import APIError, SoniloError
 
 from sonilo_cli import __version__
 
@@ -43,11 +43,38 @@ def build_client(api_key: Optional[str]) -> Sonilo:
             "no API key — pass --api-key <key> or set the "
             "SONILO_API_KEY environment variable"
         )
-    return Sonilo(api_key=key)
+    # Identify as the CLI rather than inheriting the SDK's own name, so CLI
+    # traffic stays separable from direct SDK use in server-side analytics.
+    return Sonilo(api_key=key, client_name="cli-python", client_version=__version__)
+
+
+def format_trial_summary(trial: Optional[Dict[str, Any]]) -> Optional[str]:
+    """One-line human summary of the free-trial allowance, e.g.
+    "Free trial: text-to-music 1/2 left, video-to-music 0/1 left".
+
+    Returns None when there is nothing to report — the `trial` field is
+    present only for self-serve accounts, and printing an empty "Free trial:"
+    label would read as a bug.
+    """
+    if not trial:
+        return None
+    parts = [
+        # Service keys are task_types (text_to_music); show them the way the
+        # endpoints and the error messages spell them (text-to-music).
+        f"{service.replace('_', '-')} {quota['remaining']}/{quota['granted']} left"
+        for service, quota in trial.items()
+    ]
+    return f"Free trial: {', '.join(parts)}"
 
 
 def cmd_account(client: Sonilo, args: argparse.Namespace) -> None:
-    _print_json(client.account.services())
+    services = client.account.services()
+    _print_json(services)
+    # stdout stays pure JSON so `sonilo account | jq` keeps working; the
+    # human-readable summary goes to stderr.
+    summary = format_trial_summary(services.get("trial"))
+    if summary is not None:
+        sys.stderr.write(f"{summary}\n")
 
 
 def cmd_usage(client: Sonilo, args: argparse.Namespace) -> None:
@@ -158,6 +185,42 @@ def cmd_video_to_video_sound(client: Sonilo, args: argparse.Namespace) -> None:
     _run_sound(client, args, client.video_to_video_sound, "mp4")
 
 
+# Matched to the dubbing backend's own ceiling: it polls its pipeline for up
+# to 7200s (2 hours), so anything shorter abandons a job the user has already
+# been charged for. The SDK's generic DEFAULT_WAIT_TIMEOUT of 600s is far too
+# short for this endpoint. --timeout overrides.
+DUBBING_WAIT_TIMEOUT = 7200.0
+
+
+def _language_path(out: str, language: str) -> str:
+    """Turn one --output value into a per-language path: `clip.mp4` + `es`
+    becomes `clip.es.mp4`. A dubbing task returns one video per language, so a
+    single literal destination cannot express the result. This is the same
+    transform _stem_path applies for --stem, so both flags read the same way."""
+    base = Path(out)
+    return str(base.with_name(f"{base.stem}.{language}{base.suffix or '.mp4'}"))
+
+
+def cmd_dubbing(client: Sonilo, args: argparse.Namespace) -> None:
+    out = args.output if args.output is not None else "output.mp4"
+    languages = None
+    if args.languages is not None:
+        languages = [code.strip() for code in args.languages.split(",") if code.strip()]
+        if not languages:
+            _fail("--languages needs at least one language code, e.g. --languages es,fr")
+    result = client.dubbing.generate(
+        video=args.video,
+        video_url=args.video_url,
+        languages=languages,
+        timeout=args.timeout,
+    )
+    if not result.outputs:
+        _fail("task succeeded but returned no dubbed videos")
+    for language in sorted(result.outputs):
+        path = result.save(language, _language_path(out, language))
+        _wrote(path, path.stat().st_size)
+
+
 def _identity(body: Any) -> Any:
     return body
 
@@ -301,6 +364,28 @@ def build_parser() -> argparse.ArgumentParser:
     p_v2vsd.add_argument("--output", default=None, help="Where to save the combined video.")
     p_v2vsd.set_defaults(func=cmd_video_to_video_sound)
 
+    p_dub = sub.add_parser("dubbing", help="Dub a video into other languages")
+    _add_global(p_dub)
+    _add_video_source(p_dub)
+    p_dub.add_argument(
+        "--languages", default=None,
+        help="Comma-separated target languages. Default: zh_cn,es,fr. "
+             "Supported: en, zh_cn, ja, ko, pt, es, de, fr, it, ru",
+    )
+    p_dub.add_argument(
+        "--output", default=None,
+        help="Filename template; one file is written per language with the code "
+             "inserted before the extension (clip.mp4 -> clip.es.mp4). "
+             "Default: output.mp4",
+    )
+    p_dub.add_argument(
+        "--timeout", type=float, default=DUBBING_WAIT_TIMEOUT,
+        help="Give up waiting after this many seconds. Default: 7200, matching the "
+             "backend's own ceiling for a dubbing job. A timed-out "
+             "task is still running — resume it with `sonilo tasks wait <task-id>`.",
+    )
+    p_dub.set_defaults(func=cmd_dubbing)
+
     p_tasks = sub.add_parser("tasks", help="Inspect async tasks")
     _add_global(p_tasks)
     tsub = p_tasks.add_subparsers(dest="tasks_command", metavar="<get|wait>")
@@ -331,6 +416,11 @@ def main(argv: Optional[List[str]] = None) -> None:
     client = build_client(getattr(args, "api_key", None))
     try:
         func(client, args)
+    except APIError as exc:
+        # Show the API's error code alongside the message: it is what the
+        # docs tell people to branch on, and "(trial_exhausted)" is the
+        # difference between "add a payment method" and "retry later".
+        _fail(f"{exc}{f' ({exc.code})' if exc.code else ''}")
     except SoniloError as exc:
         _fail(str(exc))
     finally:

{sonilo_cli-0.1.0 → sonilo_cli-0.3.0}/tests/test_cli.py

@@ -1,4 +1,5 @@
 import json
+from urllib.parse import unquote_plus
 
 import httpx
 import pytest
@@ -24,6 +25,59 @@ def test_account_prints_json(capsys):
     assert out == {"plan": "pro"}
 
 
+@respx.mock
+def test_account_prints_trial_summary_on_stderr(capsys):
+    services = {
+        "available_services": ["text_to_music", "video_to_music"],
+        "rpm_limit": 60,
+        "concurrency_limit": 5,
+        "discount_factor": 1.0,
+        "max_upload_size_mb": 300,
+        "trial": {
+            "text_to_music": {"granted": 2, "used": 1, "remaining": 1},
+            "video_to_music": {"granted": 1, "used": 1, "remaining": 0},
+        },
+    }
+    respx.get(f"{BASE}/v1/account/services").mock(
+        return_value=httpx.Response(200, json=services)
+    )
+    run(["account"])
+    captured = capsys.readouterr()
+    # stdout stays parseable JSON; the summary is on stderr.
+    assert json.loads(captured.out) == services
+    assert captured.err.strip() == (
+        "Free trial: text-to-music 1/2 left, video-to-music 0/1 left"
+    )
+
+
+@respx.mock
+def test_account_prints_no_summary_without_trial(capsys):
+    respx.get(f"{BASE}/v1/account/services").mock(
+        return_value=httpx.Response(200, json={"available_services": []})
+    )
+    run(["account"])
+    assert capsys.readouterr().err == ""
+
+
+@respx.mock
+def test_trial_exhausted_error_shows_the_code(capsys):
+    respx.get(f"{BASE}/v1/account/services").mock(
+        return_value=httpx.Response(
+            402,
+            json={
+                "code": "trial_exhausted",
+                "message": "You've used your 2 free trial calls for text-to-music.",
+            },
+        )
+    )
+    with pytest.raises(SystemExit) as exc:
+        run(["account"])
+    assert exc.value.code == 1
+    err = capsys.readouterr().err
+    assert "free trial calls for text-to-music" in err
+    assert "(trial_exhausted)" in err
+
+
 @respx.mock
 def test_usage_passes_days(capsys):
     route = respx.get(f"{BASE}/v1/account/usage").mock(
@@ -369,3 +423,116 @@ def test_video_to_video_sound_requires_a_video_source():
     with pytest.raises(SystemExit) as exc:
         run(["video-to-video-sound"])
     assert exc.value.code == 1
+
+
+def test_cli_identifies_itself_not_the_sdk():
+    """CLI traffic must be separable from direct SDK use in analytics."""
+    import sonilo_cli
+    from sonilo_cli.__main__ import build_client
+
+    client = build_client("sk-test")
+    try:
+        assert client._http.headers["x-sonilo-client"] == "cli-python"
+        assert client._http.headers["x-sonilo-client-version"] == sonilo_cli.__version__
+    finally:
+        client.close()
+
+
+DUBBING_BODY = {
+    "task_id": "db1",
+    "type": "dubbing",
+    "status": "succeeded",
+    "outputs": {"es": "https://r2/es.mp4", "fr": "https://r2/fr.mp4"},
+}
+
+
+@respx.mock
+def test_dubbing_writes_one_file_per_language(tmp_path):
+    respx.post(f"{BASE}/v1/dubbing").mock(
+        return_value=httpx.Response(202, json={"task_id": "db1", "status": "processing"})
+    )
+    respx.get(f"{BASE}/v1/tasks/db1").mock(
+        return_value=httpx.Response(200, json=DUBBING_BODY)
+    )
+    respx.get("https://r2/es.mp4").mock(
+        return_value=httpx.Response(200, content=b"es-bytes")
+    )
+    respx.get("https://r2/fr.mp4").mock(
+        return_value=httpx.Response(200, content=b"fr-bytes")
+    )
+    out = tmp_path / "clip.mp4"
+    run([
+        "dubbing",
+        "--video-url", "https://x/v.mp4",
+        "--languages", "es,fr",
+        "--output", str(out),
+    ])
+    assert (tmp_path / "clip.es.mp4").read_bytes() == b"es-bytes"
+    assert (tmp_path / "clip.fr.mp4").read_bytes() == b"fr-bytes"
+
+
+@respx.mock
+def test_dubbing_sends_languages_as_a_json_array(tmp_path):
+    route = respx.post(f"{BASE}/v1/dubbing").mock(
+        return_value=httpx.Response(202, json={"task_id": "db1", "status": "processing"})
+    )
+    respx.get(f"{BASE}/v1/tasks/db1").mock(
+        return_value=httpx.Response(200, json={
+            "task_id": "db1", "status": "succeeded",
+            "outputs": {"es": "https://r2/es.mp4"},
+        })
+    )
+    respx.get("https://r2/es.mp4").mock(
+        return_value=httpx.Response(200, content=b"es-bytes")
+    )
+    run([
+        "dubbing",
+        "--video-url", "https://x/v.mp4",
+        "--languages", " es , fr ",
+        "--output", str(tmp_path / "clip.mp4"),
+    ])
+    # With no file part the request body is form-urlencoded, so the JSON
+    # array arrives percent-encoded (spaces as `+`, quotes as `%22`, etc.).
+    # Decode before checking for the literal JSON array string.
+    body = unquote_plus(route.calls.last.request.content.decode())
+    assert '["es", "fr"]' in body
+
+
+def test_dubbing_requires_a_video_source():
+    with pytest.raises(SystemExit) as exc:
+        main(["--api-key", "sk-test", "dubbing"])
+    assert exc.value.code == 1
+
+
+@respx.mock
+def test_dubbing_non_https_url_exits_1(capsys):
+    with pytest.raises(SystemExit) as exc:
+        main(["--api-key", "sk-test", "dubbing", "--video-url", "http://x/v.mp4"])
+    assert exc.value.code == 1
+    assert "https" in capsys.readouterr().err
+
+
+@respx.mock
+def test_dubbing_without_languages_omits_the_field(tmp_path):
+    route = respx.post(f"{BASE}/v1/dubbing").mock(
+        return_value=httpx.Response(202, json={"task_id": "db1", "status": "processing"})
+    )
+    respx.get(f"{BASE}/v1/tasks/db1").mock(
+        return_value=httpx.Response(200, json={
+            "task_id": "db1", "status": "succeeded",
+            "outputs": {"es": "https://r2/es.mp4"},
+        })
+    )
+    respx.get("https://r2/es.mp4").mock(
+        return_value=httpx.Response(200, content=b"es-bytes")
+    )
+    run([
+        "dubbing",
+        "--video-url", "https://x/v.mp4",
+        "--output", str(tmp_path / "clip.mp4"),
+    ])
+    # Omitting --languages must not send a `languages` field at all — the
+    # server default (["zh_cn", "es", "fr"]) only applies when the field is
+    # absent. Sending `languages=[]` or the string "None" would silently
+    # override that default with something else.
+    assert b"languages" not in route.calls.last.request.content

sonilo_cli-0.3.0/tests/test_context7.py

@@ -0,0 +1,51 @@
+import json
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+
+
+def test_context7_json_is_valid_and_complete():
+    data = json.loads((ROOT / "context7.json").read_text())
+    # Names the language: sonilo-js publishes to Context7 too, and a title of
+    # just "Sonilo" on both left the two indistinguishable in search.
+    assert data["projectTitle"] == "Sonilo Python SDK"
+    assert data["$schema"] == "https://context7.com/schema/context7.json"
+    assert "**/__pycache__/**" in data["excludeFolders"]
+    assert isinstance(data["rules"], list) and len(data["rules"]) >= 5
+
+
+# Limits from https://context7.com/schema/context7.json. The parser tolerates
+# oversized values, so nothing complains at index time — but the ownership
+# claim validates strictly and rejects the whole file, which is how five
+# over-long rules went unnoticed until claiming failed.
+MAX_RULE_LEN = 255
+MAX_RULES = 50
+MAX_DESCRIPTION_LEN = 200
+MAX_PROJECT_TITLE_LEN = 100
+
+ALLOWED_KEYS = {
+    "$schema", "projectTitle", "description", "branch", "folders",
+    "excludeFolders", "excludeFiles", "rules", "disallow", "redirect",
+    "previousVersions", "url", "public_key",
+}
+
+
+def test_context7_json_respects_schema_limits():
+    data = json.loads((ROOT / "context7.json").read_text())
+
+    unknown = set(data) - ALLOWED_KEYS
+    assert not unknown, f"unknown top-level keys reject the claim: {unknown}"
+
+    assert len(data["rules"]) <= MAX_RULES
+    too_long = {i: len(r) for i, r in enumerate(data["rules"]) if len(r) > MAX_RULE_LEN}
+    assert not too_long, f"rules over {MAX_RULE_LEN} chars: {too_long}"
+
+    assert len(data["description"]) <= MAX_DESCRIPTION_LEN
+    assert len(data["projectTitle"]) <= MAX_PROJECT_TITLE_LEN
+
+
+def test_context7_json_carries_ownership_keys():
+    """The claim flow requires both, and the schema makes them interdependent."""
+    data = json.loads((ROOT / "context7.json").read_text())
+    assert data["url"] == "https://context7.com/sonilo-ai/sonilo-python"
+    assert data["public_key"].startswith("pk_")

sonilo_cli-0.1.0/tests/test_context7.py

@@ -1,12 +0,0 @@
-import json
-from pathlib import Path
-
-ROOT = Path(__file__).resolve().parents[2]
-
-
-def test_context7_json_is_valid_and_complete():
-    data = json.loads((ROOT / "context7.json").read_text())
-    assert data["projectTitle"] == "Sonilo"
-    assert data["$schema"] == "https://context7.com/schema/context7.json"
-    assert "**/__pycache__/**" in data["excludeFolders"]
-    assert isinstance(data["rules"], list) and len(data["rules"]) >= 5