reedapt 0.1.0__tar.gz

reedapt-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+dist/
+__pycache__/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

reedapt-0.1.0/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0
+
+`dubs.transcript()`, `dubs.subtitles()` (SRT or WebVTT) and `webhook_endpoints.resend_delivery()`.
+
+`usage.report()` for a month of minutes and dubs per key and per language.
+
+First release: sync and asyncio clients for uploads in parts and from links, dubs, languages, usage, webhook endpoints and webhook signature checks, with retries and idempotency keys.

reedapt-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reedapt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reedapt-0.1.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.5
+Name: reedapt
+Version: 0.1.0
+Summary: The official Python library for the Reedapt API.
+Project-URL: Homepage, https://docs.reedapt.com
+Project-URL: Documentation, https://docs.reedapt.com
+Project-URL: Source, https://github.com/Reedapt/reedapt-python
+Project-URL: Issues, https://github.com/Reedapt/reedapt-python/issues
+Author-email: Reedapt <support@reedapt.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,dubbing,reedapt,translation,voice
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.23
+Requires-Dist: typing-extensions>=4.7
+Description-Content-Type: text/markdown
+
+# Reedapt Python library
+
+The official Python library for the [Reedapt API](https://docs.reedapt.com). Upload video or audio, dub it into other languages in each speaker's own voice, and get the files back.
+
+## Install
+
+```bash
+pip install reedapt
+```
+
+Python 3.9 or later. Sync and asyncio clients, fully typed.
+
+## Quickstart
+
+Make a key under **Developers** in [Reedapt](https://dub.reedapt.com/developers) and keep it in `REEDAPT_API_KEY`. Test keys are free and dub the first 60 seconds with a watermark.
+
+```python
+from reedapt import Reedapt
+
+reedapt = Reedapt()  # reads REEDAPT_API_KEY
+
+created = reedapt.dub(
+    "interview.mp4",
+    source_language="en",
+    target_languages=["fr", "es"],
+)
+
+for started in created["dubs"]:
+    dub = reedapt.dubs.wait_until_done(started["id"])
+    if dub["status"] == "completed":
+        files = reedapt.dubs.files(dub["id"])["files"]
+        print(dub["target_language"], files[0]["url"])
+    else:
+        print(dub["target_language"], "failed:", dub["error"]["message"])
+```
+
+`dub()` takes a path, bytes (with `filename=`), a binary file object, or a public `https://` link that Reedapt downloads itself. In production, use [webhooks](#webhooks) instead of `wait_until_done`.
+
+## Async
+
+```python
+import asyncio
+from reedapt import AsyncReedapt
+
+
+async def main() -> None:
+    async with AsyncReedapt() as reedapt:
+        created = await reedapt.dub("interview.mp4", source_language="en", target_languages=["fr"])
+        dub = await reedapt.dubs.wait_until_done(created["dubs"][0]["id"])
+        print(dub["status"])
+
+
+asyncio.run(main())
+```
+
+## Uploads
+
+`uploads.upload_file` sends the file straight to storage in parts, four at a time, signs more links as it needs them, and retries parts that fail:
+
+```python
+upload = reedapt.uploads.upload_file(
+    "film.mov",
+    concurrency=4,
+    on_progress=lambda done, total: print(f"{100 * done // total}%"),
+)
+
+created = reedapt.dubs.create(
+    upload_id=upload["id"],
+    source_language="en",
+    target_languages=["yo"],
+    metadata={"order_id": "1042"},
+)
+```
+
+For a file that's already online:
+
+```python
+upload = reedapt.uploads.from_url("https://example.com/media/talk.mp4")
+```
+
+## Dubs
+
+```python
+reedapt.dubs.retrieve("job_3f9a2c7e1b4d")
+reedapt.dubs.list(limit=20)
+for dub in reedapt.dubs.list_all():
+    print(dub["id"], dub["status"])
+reedapt.dubs.files("job_3f9a2c7e1b4d")  # links last an hour
+reedapt.dubs.cancel("job_3f9a2c7e1b4d")  # minutes are returned
+reedapt.dubs.transcript("job_3f9a2c7e1b4d")  # every line, with timing, speaker and translation
+reedapt.dubs.subtitles("job_3f9a2c7e1b4d", format="vtt")  # SRT (default) or WebVTT text
+
+reedapt.languages.list()  # {"target_languages": [...]}
+reedapt.usage.retrieve()  # plan, key mode and minutes left
+reedapt.usage.report(month="2026-10")  # minutes and dubs per key and per language
+```
+
+Results are plain dictionaries, typed with `TypedDict`s in `reedapt.types`.
+
+## Webhooks
+
+Add an endpoint under **Developers**, or with `reedapt.webhook_endpoints.create(url=...)`, and keep its `whsec_` secret. `reedapt.webhook_endpoints.resend_delivery(endpoint_id, delivery_id)` sends a past delivery again. Check every delivery against the raw body:
+
+```python
+import os
+from flask import Flask, abort, request
+from reedapt import WebhookVerificationError, construct_webhook_event
+
+app = Flask(__name__)
+
+
+@app.post("/reedapt/webhooks")
+def reedapt_webhook():
+    try:
+        event = construct_webhook_event(
+            request.get_data(),
+            request.headers.get("Reedapt-Signature"),
+            os.environ["REEDAPT_WEBHOOK_SECRET"],
+        )
+    except WebhookVerificationError:
+        abort(400)
+    if event["type"] == "dub.completed":
+        dub = event["data"]["dub"]  # queue the work, then answer quickly
+    return "", 200
+```
+
+An event can arrive more than once, so skip any `event["id"]` you've already handled.
+
+## Errors
+
+Failed requests raise a subclass of `APIError` with the HTTP `status`, a stable `code`, a plain-English `message` and the `request_id` to quote to support:
+
+```python
+from reedapt import APIError, RateLimitError
+
+try:
+    reedapt.dubs.create(upload_id=upload_id, source_language="en", target_languages=["fr"])
+except RateLimitError as e:
+    if e.code == "TOO_MANY_DUBS_RUNNING":
+        ...  # start more once some finish
+except APIError as e:
+    print(e.status, e.code, e.message, e.request_id)
+```
+
+| Class | When |
+| --- | --- |
+| `AuthenticationError` | 401: the key is missing, wrong or revoked. |
+| `NotFoundError` | 404 |
+| `ConflictError` | 409: the object isn't in a state that allows this. |
+| `InvalidRequestError` | 400, 411, 413, 422. `fields` lists invalid fields. |
+| `RateLimitError` | 429. `retry_after` is in seconds. |
+| `ServerError` | 5xx |
+| `ConnectionError`, `TimeoutError` | No answer arrived. |
+| `UploadError` | A part couldn't be sent to storage. |
+| `WaitError` | A `wait_until_…` helper ran out of time, or the upload failed. |
+| `WebhookVerificationError` | A delivery's signature didn't check out. |
+
+All of them derive from `ReedaptError`. The [error codes](https://docs.reedapt.com/errors) are listed in the docs.
+
+## Retries and repeated requests
+
+Network failures, `500`, `502`, `503`, `504` and per-minute rate limits are retried twice, with backoff, honouring `Retry-After`. Creating uploads and dubs always sends an `Idempotency-Key`, so a retry never makes a second dub. Pass your own to make a repeat safe across restarts:
+
+```python
+reedapt.dubs.create(..., idempotency_key=f"order-{order.id}")
+```
+
+## Configuration
+
+```python
+reedapt = Reedapt(
+    api_key=os.environ["REEDAPT_API_KEY"],
+    timeout=60.0,  # per request, in seconds
+    max_retries=2,
+)
+
+reedapt.dubs.retrieve(dub_id, timeout=10.0, max_retries=0)
+```
+
+Pass `http_client=httpx.Client(...)` to set proxies or transport options. Keep keys on your server. Never put one in an app people can download.
+
+## Links
+
+- [Documentation](https://docs.reedapt.com)
+- [API reference](https://docs.reedapt.com/api-reference/introduction)
+- [Status](https://status.reedapt.com)
+- Support: support@reedapt.com

reedapt-0.1.0/README.md

@@ -0,0 +1,187 @@
+# Reedapt Python library
+
+The official Python library for the [Reedapt API](https://docs.reedapt.com). Upload video or audio, dub it into other languages in each speaker's own voice, and get the files back.
+
+## Install
+
+```bash
+pip install reedapt
+```
+
+Python 3.9 or later. Sync and asyncio clients, fully typed.
+
+## Quickstart
+
+Make a key under **Developers** in [Reedapt](https://dub.reedapt.com/developers) and keep it in `REEDAPT_API_KEY`. Test keys are free and dub the first 60 seconds with a watermark.
+
+```python
+from reedapt import Reedapt
+
+reedapt = Reedapt()  # reads REEDAPT_API_KEY
+
+created = reedapt.dub(
+    "interview.mp4",
+    source_language="en",
+    target_languages=["fr", "es"],
+)
+
+for started in created["dubs"]:
+    dub = reedapt.dubs.wait_until_done(started["id"])
+    if dub["status"] == "completed":
+        files = reedapt.dubs.files(dub["id"])["files"]
+        print(dub["target_language"], files[0]["url"])
+    else:
+        print(dub["target_language"], "failed:", dub["error"]["message"])
+```
+
+`dub()` takes a path, bytes (with `filename=`), a binary file object, or a public `https://` link that Reedapt downloads itself. In production, use [webhooks](#webhooks) instead of `wait_until_done`.
+
+## Async
+
+```python
+import asyncio
+from reedapt import AsyncReedapt
+
+
+async def main() -> None:
+    async with AsyncReedapt() as reedapt:
+        created = await reedapt.dub("interview.mp4", source_language="en", target_languages=["fr"])
+        dub = await reedapt.dubs.wait_until_done(created["dubs"][0]["id"])
+        print(dub["status"])
+
+
+asyncio.run(main())
+```
+
+## Uploads
+
+`uploads.upload_file` sends the file straight to storage in parts, four at a time, signs more links as it needs them, and retries parts that fail:
+
+```python
+upload = reedapt.uploads.upload_file(
+    "film.mov",
+    concurrency=4,
+    on_progress=lambda done, total: print(f"{100 * done // total}%"),
+)
+
+created = reedapt.dubs.create(
+    upload_id=upload["id"],
+    source_language="en",
+    target_languages=["yo"],
+    metadata={"order_id": "1042"},
+)
+```
+
+For a file that's already online:
+
+```python
+upload = reedapt.uploads.from_url("https://example.com/media/talk.mp4")
+```
+
+## Dubs
+
+```python
+reedapt.dubs.retrieve("job_3f9a2c7e1b4d")
+reedapt.dubs.list(limit=20)
+for dub in reedapt.dubs.list_all():
+    print(dub["id"], dub["status"])
+reedapt.dubs.files("job_3f9a2c7e1b4d")  # links last an hour
+reedapt.dubs.cancel("job_3f9a2c7e1b4d")  # minutes are returned
+reedapt.dubs.transcript("job_3f9a2c7e1b4d")  # every line, with timing, speaker and translation
+reedapt.dubs.subtitles("job_3f9a2c7e1b4d", format="vtt")  # SRT (default) or WebVTT text
+
+reedapt.languages.list()  # {"target_languages": [...]}
+reedapt.usage.retrieve()  # plan, key mode and minutes left
+reedapt.usage.report(month="2026-10")  # minutes and dubs per key and per language
+```
+
+Results are plain dictionaries, typed with `TypedDict`s in `reedapt.types`.
+
+## Webhooks
+
+Add an endpoint under **Developers**, or with `reedapt.webhook_endpoints.create(url=...)`, and keep its `whsec_` secret. `reedapt.webhook_endpoints.resend_delivery(endpoint_id, delivery_id)` sends a past delivery again. Check every delivery against the raw body:
+
+```python
+import os
+from flask import Flask, abort, request
+from reedapt import WebhookVerificationError, construct_webhook_event
+
+app = Flask(__name__)
+
+
+@app.post("/reedapt/webhooks")
+def reedapt_webhook():
+    try:
+        event = construct_webhook_event(
+            request.get_data(),
+            request.headers.get("Reedapt-Signature"),
+            os.environ["REEDAPT_WEBHOOK_SECRET"],
+        )
+    except WebhookVerificationError:
+        abort(400)
+    if event["type"] == "dub.completed":
+        dub = event["data"]["dub"]  # queue the work, then answer quickly
+    return "", 200
+```
+
+An event can arrive more than once, so skip any `event["id"]` you've already handled.
+
+## Errors
+
+Failed requests raise a subclass of `APIError` with the HTTP `status`, a stable `code`, a plain-English `message` and the `request_id` to quote to support:
+
+```python
+from reedapt import APIError, RateLimitError
+
+try:
+    reedapt.dubs.create(upload_id=upload_id, source_language="en", target_languages=["fr"])
+except RateLimitError as e:
+    if e.code == "TOO_MANY_DUBS_RUNNING":
+        ...  # start more once some finish
+except APIError as e:
+    print(e.status, e.code, e.message, e.request_id)
+```
+
+| Class | When |
+| --- | --- |
+| `AuthenticationError` | 401: the key is missing, wrong or revoked. |
+| `NotFoundError` | 404 |
+| `ConflictError` | 409: the object isn't in a state that allows this. |
+| `InvalidRequestError` | 400, 411, 413, 422. `fields` lists invalid fields. |
+| `RateLimitError` | 429. `retry_after` is in seconds. |
+| `ServerError` | 5xx |
+| `ConnectionError`, `TimeoutError` | No answer arrived. |
+| `UploadError` | A part couldn't be sent to storage. |
+| `WaitError` | A `wait_until_…` helper ran out of time, or the upload failed. |
+| `WebhookVerificationError` | A delivery's signature didn't check out. |
+
+All of them derive from `ReedaptError`. The [error codes](https://docs.reedapt.com/errors) are listed in the docs.
+
+## Retries and repeated requests
+
+Network failures, `500`, `502`, `503`, `504` and per-minute rate limits are retried twice, with backoff, honouring `Retry-After`. Creating uploads and dubs always sends an `Idempotency-Key`, so a retry never makes a second dub. Pass your own to make a repeat safe across restarts:
+
+```python
+reedapt.dubs.create(..., idempotency_key=f"order-{order.id}")
+```
+
+## Configuration
+
+```python
+reedapt = Reedapt(
+    api_key=os.environ["REEDAPT_API_KEY"],
+    timeout=60.0,  # per request, in seconds
+    max_retries=2,
+)
+
+reedapt.dubs.retrieve(dub_id, timeout=10.0, max_retries=0)
+```
+
+Pass `http_client=httpx.Client(...)` to set proxies or transport options. Keep keys on your server. Never put one in an app people can download.
+
+## Links
+
+- [Documentation](https://docs.reedapt.com)
+- [API reference](https://docs.reedapt.com/api-reference/introduction)
+- [Status](https://status.reedapt.com)
+- Support: support@reedapt.com

reedapt-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "reedapt"
+dynamic = ["version"]
+description = "The official Python library for the Reedapt API."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "Reedapt", email = "support@reedapt.com" }]
+keywords = ["reedapt", "dubbing", "translation", "voice", "api"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.23,<1",
+  "typing_extensions>=4.7",
+]
+
+[project.urls]
+Homepage = "https://docs.reedapt.com"
+Documentation = "https://docs.reedapt.com"
+Source = "https://github.com/Reedapt/reedapt-python"
+Issues = "https://github.com/Reedapt/reedapt-python/issues"
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.23", "mypy>=1.10", "ruff>=0.6"]
+
+[tool.hatch.version]
+path = "src/reedapt/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/reedapt"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "LICENSE", "CHANGELOG.md"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.mypy]
+strict = true
+# Results are JSON shaped as the TypedDicts in reedapt.types.
+warn_return_any = false
+files = ["src"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "RUF", "SIM", "PYI"]
+# typing.Optional/List/Dict stay: they also work where annotations are evaluated on 3.9.
+ignore = ["UP006", "UP007", "UP035", "UP045", "RUF022"]

reedapt-0.1.0/src/reedapt/__init__.py

@@ -0,0 +1,46 @@
+"""The official Python library for the Reedapt API. See https://docs.reedapt.com."""
+
+from . import types
+from ._async_client import AsyncReedapt
+from ._base import RequestOptions
+from ._client import Reedapt
+from ._errors import (
+    APIError,
+    AuthenticationError,
+    ConflictError,
+    ConnectionError,
+    InvalidRequestError,
+    NotFoundError,
+    RateLimitError,
+    ReedaptError,
+    ServerError,
+    TimeoutError,
+    UploadError,
+    WaitError,
+    WebhookVerificationError,
+)
+from ._version import __version__
+from ._webhooks import construct_webhook_event, verify_webhook
+
+__all__ = [
+    "Reedapt",
+    "AsyncReedapt",
+    "RequestOptions",
+    "types",
+    "verify_webhook",
+    "construct_webhook_event",
+    "ReedaptError",
+    "APIError",
+    "AuthenticationError",
+    "NotFoundError",
+    "ConflictError",
+    "InvalidRequestError",
+    "RateLimitError",
+    "ServerError",
+    "ConnectionError",
+    "TimeoutError",
+    "UploadError",
+    "WaitError",
+    "WebhookVerificationError",
+    "__version__",
+]