bladeworks 0.1.0__tar.gz

bladeworks-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: bladeworks
+Version: 0.1.0
+Summary: Render portable Final Cut Pro XML projects to video.
+Project-URL: Homepage, https://github.com/bladeworks-ai/bladeworks
+Project-URL: Repository, https://github.com/bladeworks-ai/bladeworks
+Project-URL: Issues, https://github.com/bladeworks-ai/bladeworks/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: torch>=2
+Requires-Dist: av>=15
+Requires-Dist: numpy
+Requires-Dist: tqdm
+Requires-Dist: Pillow>=10
+Requires-Dist: fonttools>=4.50
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.29
+Requires-Dist: aiortc>=1.14
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: httpx>=0.27; extra == "test"
+
+# Bladeworks
+
+Bladeworks renders portable Final Cut Pro XML projects (`.fcpxml` files and
+`.fcpxmld` bundles) to video.
+
+## Install
+
+```bash
+python -m pip install bladeworks
+```
+
+Bladeworks requires `ffprobe` on `PATH` to inspect source media. Run the
+prerequisite check after installation:
+
+```bash
+bladeworks doctor
+```
+
+## Render
+
+```bash
+bladeworks render path/to/project.fcpxmld --output output.mp4
+```
+
+See all commands and options:
+
+```bash
+bladeworks --help
+```
+
+## Test a checkout
+
+```bash
+python -m pip install -r requirements.txt
+python -m pip install -e . --no-deps
+python -m pytest -q
+```

bladeworks-0.1.0/README.md

@@ -0,0 +1,37 @@
+# Bladeworks
+
+Bladeworks renders portable Final Cut Pro XML projects (`.fcpxml` files and
+`.fcpxmld` bundles) to video.
+
+## Install
+
+```bash
+python -m pip install bladeworks
+```
+
+Bladeworks requires `ffprobe` on `PATH` to inspect source media. Run the
+prerequisite check after installation:
+
+```bash
+bladeworks doctor
+```
+
+## Render
+
+```bash
+bladeworks render path/to/project.fcpxmld --output output.mp4
+```
+
+See all commands and options:
+
+```bash
+bladeworks --help
+```
+
+## Test a checkout
+
+```bash
+python -m pip install -r requirements.txt
+python -m pip install -e . --no-deps
+python -m pytest -q
+```

bladeworks-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bladeworks"
+version = "0.1.0"
+description = "Render portable Final Cut Pro XML projects to video."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "torch>=2",
+    "av>=15",
+    "numpy",
+    "tqdm",
+    "Pillow>=10",
+    "fonttools>=4.50",
+    "fastapi>=0.110",
+    "uvicorn>=0.29",
+    "aiortc>=1.14",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=8", "httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://github.com/bladeworks-ai/bladeworks"
+Repository = "https://github.com/bladeworks-ai/bladeworks"
+Issues = "https://github.com/bladeworks-ai/bladeworks/issues"
+
+[project.scripts]
+bladeworks = "bladeworks.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["bladeworks*"]
+
+[tool.setuptools.package-data]
+bladeworks = ["**/*"]

bladeworks-0.1.0/setup.cfg

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

bladeworks-0.1.0/src/bladeworks/__init__.py

@@ -0,0 +1,56 @@
+"""Portable FCPXML compiler and renderer.
+
+Architecture map
+================
+
+``parse_fcpxml`` keeps source hierarchy and rational time intact.
+``compile_fcpxml`` resolves that source graph into renderer-facing clips.
+``execute_render`` turns the render document into a video.
+
+The package deliberately does not import the existing Swift/SPLYML converter:
+that converter targets edit interchange and is allowed to lose Final Cut-only
+details, while this package needs those details to explain every render choice.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .core.compiler import CompileResult
+    from .executor import RenderResult
+
+__all__ = [
+    "CompileResult",
+    "RenderResult",
+    "compile_fcpxml",
+    "execute_render",
+    "parse_fcpxml",
+]
+
+
+def __getattr__(name: str) -> Any:
+    """Load renderer APIs only when a caller asks for one.
+
+    Main callers:
+        Users importing a symbol from the package root.
+
+    Why this exists:
+        Python imports the package before running ``python -m bladeworks``.
+        Keeping the root lightweight lets help and package introspection work
+        without initializing PyTorch and the video runtime.
+    """
+
+    if name in {"CompileResult", "compile_fcpxml"}:
+        from .core import compiler
+
+        return getattr(compiler, name)
+    if name in {"RenderResult", "execute_render"}:
+        from . import executor
+
+        return getattr(executor, name)
+    if name == "parse_fcpxml":
+        from .core.parser import parse_fcpxml
+
+        return parse_fcpxml
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

bladeworks-0.1.0/src/bladeworks/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+
+raise SystemExit(main())