lavendly 0.0.1__tar.gz

lavendly-0.0.1/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: lavendly
+Version: 0.0.1
+Summary: Official Python SDK for Lavendly - generate AI video with one API call.
+Author: Lavendly
+License: MIT
+Project-URL: Homepage, https://docs.lavendly.ai/sdks/python
+Project-URL: Repository, https://github.com/barlou83/lavendly
+Project-URL: Documentation, https://docs.lavendly.ai
+Keywords: lavendly,ai-video,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24
+
+# lavendly
+
+Official Python SDK for Lavendly.
+
+```bash
+pip install lavendly
+```
+
+```python
+from lavendly import Lavendly
+
+vs = Lavendly(api_key="lv_...")
+
+wf = vs.workflows.create(
+    name="Fox in a bookshop",
+    shots=[{"prompt": "a sleepy fox in a bookshop", "duration": 5}],
+)
+
+video = vs.renders.run(wf["id"])
+print(video.url)
+```
+
+## Highlights
+
+- **Sync + async.** Same surface; `Lavendly` and `AsyncLavendly`.
+- **Idempotent by default.** Every mutating method accepts `idempotency_key`.
+- **One-call renders.** `vs.renders.run()` creates + polls to completion.
+- **Tool-use dispatcher.** `vs.call(operation, args)` for the Anthropic SDK tool_use pattern.
+- **Bundled skills.** `from lavendly.skills import load_skill` returns the markdown body of `storyteller`, `multi-clip`, `cost-aware`.
+
+## Async
+
+```python
+import asyncio
+from lavendly import AsyncLavendly
+
+async def main():
+    async with AsyncLavendly(api_key="...") as lavendly:
+        wf = await vs.workflows.create(name="x", shots=[...])
+        return await vs.renders.run(wf["id"])
+
+result = asyncio.run(main())
+```
+
+## Errors
+
+```python
+from lavendly import LavendlyError
+try:
+    vs.workflows.create(name="...", shots=[...])
+except LavendlyError as e:
+    print(e.code, e.status, e.details)
+```
+
+## Full docs
+
+<https://docs.lavendly.ai/sdks/python>
+
+## License
+
+MIT

lavendly-0.0.1/README.md

@@ -0,0 +1,61 @@
+# lavendly
+
+Official Python SDK for Lavendly.
+
+```bash
+pip install lavendly
+```
+
+```python
+from lavendly import Lavendly
+
+vs = Lavendly(api_key="lv_...")
+
+wf = vs.workflows.create(
+    name="Fox in a bookshop",
+    shots=[{"prompt": "a sleepy fox in a bookshop", "duration": 5}],
+)
+
+video = vs.renders.run(wf["id"])
+print(video.url)
+```
+
+## Highlights
+
+- **Sync + async.** Same surface; `Lavendly` and `AsyncLavendly`.
+- **Idempotent by default.** Every mutating method accepts `idempotency_key`.
+- **One-call renders.** `vs.renders.run()` creates + polls to completion.
+- **Tool-use dispatcher.** `vs.call(operation, args)` for the Anthropic SDK tool_use pattern.
+- **Bundled skills.** `from lavendly.skills import load_skill` returns the markdown body of `storyteller`, `multi-clip`, `cost-aware`.
+
+## Async
+
+```python
+import asyncio
+from lavendly import AsyncLavendly
+
+async def main():
+    async with AsyncLavendly(api_key="...") as lavendly:
+        wf = await vs.workflows.create(name="x", shots=[...])
+        return await vs.renders.run(wf["id"])
+
+result = asyncio.run(main())
+```
+
+## Errors
+
+```python
+from lavendly import LavendlyError
+try:
+    vs.workflows.create(name="...", shots=[...])
+except LavendlyError as e:
+    print(e.code, e.status, e.details)
+```
+
+## Full docs
+
+<https://docs.lavendly.ai/sdks/python>
+
+## License
+
+MIT

lavendly-0.0.1/lavendly.egg-info/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: lavendly
+Version: 0.0.1
+Summary: Official Python SDK for Lavendly - generate AI video with one API call.
+Author: Lavendly
+License: MIT
+Project-URL: Homepage, https://docs.lavendly.ai/sdks/python
+Project-URL: Repository, https://github.com/barlou83/lavendly
+Project-URL: Documentation, https://docs.lavendly.ai
+Keywords: lavendly,ai-video,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24
+
+# lavendly
+
+Official Python SDK for Lavendly.
+
+```bash
+pip install lavendly
+```
+
+```python
+from lavendly import Lavendly
+
+vs = Lavendly(api_key="lv_...")
+
+wf = vs.workflows.create(
+    name="Fox in a bookshop",
+    shots=[{"prompt": "a sleepy fox in a bookshop", "duration": 5}],
+)
+
+video = vs.renders.run(wf["id"])
+print(video.url)
+```
+
+## Highlights
+
+- **Sync + async.** Same surface; `Lavendly` and `AsyncLavendly`.
+- **Idempotent by default.** Every mutating method accepts `idempotency_key`.
+- **One-call renders.** `vs.renders.run()` creates + polls to completion.
+- **Tool-use dispatcher.** `vs.call(operation, args)` for the Anthropic SDK tool_use pattern.
+- **Bundled skills.** `from lavendly.skills import load_skill` returns the markdown body of `storyteller`, `multi-clip`, `cost-aware`.
+
+## Async
+
+```python
+import asyncio
+from lavendly import AsyncLavendly
+
+async def main():
+    async with AsyncLavendly(api_key="...") as lavendly:
+        wf = await vs.workflows.create(name="x", shots=[...])
+        return await vs.renders.run(wf["id"])
+
+result = asyncio.run(main())
+```
+
+## Errors
+
+```python
+from lavendly import LavendlyError
+try:
+    vs.workflows.create(name="...", shots=[...])
+except LavendlyError as e:
+    print(e.code, e.status, e.details)
+```
+
+## Full docs
+
+<https://docs.lavendly.ai/sdks/python>
+
+## License
+
+MIT

lavendly-0.0.1/lavendly.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+lavendly.egg-info/PKG-INFO
+lavendly.egg-info/SOURCES.txt
+lavendly.egg-info/dependency_links.txt
+lavendly.egg-info/requires.txt
+lavendly.egg-info/top_level.txt
+tests/test_sdk.py

lavendly-0.0.1/lavendly.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

lavendly-0.0.1/lavendly.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.24

lavendly-0.0.1/lavendly.egg-info/top_level.txt

@@ -0,0 +1 @@
+

lavendly-0.0.1/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lavendly"
+version = "0.0.1"
+description = "Official Python SDK for Lavendly - generate AI video with one API call."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Lavendly" }]
+keywords = ["lavendly", "ai-video", "sdk"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+  "httpx>=0.24",
+]
+
+[project.urls]
+Homepage      = "https://docs.lavendly.ai/sdks/python"
+Repository    = "https://github.com/barlou83/lavendly"
+Documentation = "https://docs.lavendly.ai"
+
+[tool.setuptools.packages.find]
+include = ["lavendly*"]

lavendly-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lavendly-0.0.1/tests/test_sdk.py

@@ -0,0 +1,106 @@
+"""Offline tests for the Python SDK using httpx MockTransport.
+
+Run:  python -m unittest tests/test_sdk.py
+"""
+from __future__ import annotations
+
+import json
+import sys
+import unittest
+import pathlib
+
+# Allow running directly: tests/ is sibling of lavendly/
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[1]))
+
+import httpx
+from lavendly import Lavendly, LavendlyError
+
+
+def make_transport(handler):
+    calls = []
+    def _handle(request):
+        body = json.loads(request.content) if request.content else None
+        calls.append({
+            "method":  request.method,
+            "url":     str(request.url),
+            "headers": dict(request.headers),
+            "body":    body,
+        })
+        out = handler(request, calls) or {}
+        return httpx.Response(
+            status_code=out.get("status", 200),
+            json=out.get("json", {}),
+        )
+    return httpx.MockTransport(_handle), calls
+
+
+class TestSDK(unittest.TestCase):
+
+    def test_missing_api_key(self):
+        with self.assertRaises(LavendlyError) as ctx:
+            Lavendly(api_key="")
+        self.assertEqual(ctx.exception.code, "missing_api_key")
+
+    def test_workflow_create_idempotency(self):
+        transport, calls = make_transport(
+            lambda req, calls: {"json": {"id": "wf_xyz", "name": "fox"}}
+        )
+        vs = Lavendly(api_key="lv_test_123", transport=transport)
+        wf = vs.workflows.create(name="fox", shots=[{"prompt": "x", "duration": 5}],
+                                 idempotency_key="create-fox")
+        self.assertEqual(wf["id"], "wf_xyz")
+        self.assertEqual(calls[0]["method"], "POST")
+        self.assertTrue(calls[0]["url"].endswith("/v1/workflows"))
+        self.assertEqual(calls[0]["headers"]["authorization"], "Bearer lv_test_123")
+        self.assertEqual(calls[0]["headers"]["idempotency-key"], "create-fox")
+        self.assertNotIn("idempotency_key", calls[0]["body"])
+
+    def test_render_run_polls_to_done(self):
+        states = [
+            {"id": "j", "status": "queued"},
+            {"id": "j", "status": "running", "progress": 0.5},
+            {"id": "j", "status": "done", "result": {"video_url": "https://x.mp4", "duration": 5}},
+        ]
+        idx = {"n": -1}
+
+        def h(req, calls):
+            if req.method == "POST":
+                return {"json": {"job_id": "j", "status": "queued"}}
+            idx["n"] += 1
+            return {"json": states[min(idx["n"], len(states) - 1)]}
+
+        transport, calls = make_transport(h)
+        vs = Lavendly(api_key="k", transport=transport)
+        ticks = []
+        result = vs.renders.run("wf", poll_interval=0.001, max_wait=5,
+                                 on_progress=lambda j: ticks.append(j["status"]))
+        self.assertEqual(result.url, "https://x.mp4")
+        self.assertEqual(result.duration, 5)
+        self.assertEqual(ticks[-1], "done")
+
+    def test_error_envelope(self):
+        transport, _ = make_transport(
+            lambda req, calls: {
+                "status": 402,
+                "json": {"error": {"code": "insufficient_credits",
+                                   "message": "too poor", "needed": 10, "have": 4}},
+            }
+        )
+        vs = Lavendly(api_key="k", transport=transport)
+        with self.assertRaises(LavendlyError) as ctx:
+            vs.ledger.reserve(10)
+        self.assertEqual(ctx.exception.code, "insufficient_credits")
+        self.assertEqual(ctx.exception.status, 402)
+        self.assertEqual(ctx.exception.details["needed"], 10)
+
+    def test_call_dispatcher(self):
+        transport, calls = make_transport(
+            lambda req, c: {"json": {"id": "wf_x"}}
+        )
+        vs = Lavendly(api_key="k", transport=transport)
+        out = vs.call("create_workflow", {"name": "n", "shots": []})
+        self.assertEqual(out["id"], "wf_x")
+
+
+if __name__ == "__main__":
+    unittest.main()