creative-render-engine 0.7.0__py3-none-any.whl

creative_render_engine/__init__.py

@@ -0,0 +1,72 @@
+from .api import (
+    compile,
+    generate_timeline_subtitles,
+    measure_graphic_text,
+    preview,
+    render,
+    render_task_hash,
+    render_task_json_schema,
+    validate_render_task,
+)
+from .errors import (
+    AssetError,
+    CompileError,
+    ConfigurationError,
+    ContractError,
+    CreativeRenderEngineError,
+    RenderError,
+)
+from .plans import GraphicTextMeasurement, PreviewManifest, RenderManifest, RenderPlan
+from .schemas import (
+    GraphicTextRenderTask,
+    PureImageRenderTask,
+    RenderTask,
+    ScrollRenderTask,
+    TimelineRenderTask,
+    TimelineSubtitleBlock,
+    TimelineSubtitleConfig,
+    TimelineSubtitleFrame,
+    TimelineSubtitleFrameItem,
+    TimelineSubtitleLayout,
+    TimelineSubtitleTemplate,
+    TimelineTemplate,
+    WpmSubtitleGenerationOptions,
+)
+from .settings import settings
+
+__version__ = "0.7.0"
+
+__all__ = [
+    "AssetError",
+    "CompileError",
+    "ConfigurationError",
+    "ContractError",
+    "CreativeRenderEngineError",
+    "GraphicTextMeasurement",
+    "GraphicTextRenderTask",
+    "PreviewManifest",
+    "PureImageRenderTask",
+    "RenderError",
+    "RenderManifest",
+    "RenderPlan",
+    "RenderTask",
+    "ScrollRenderTask",
+    "TimelineRenderTask",
+    "TimelineSubtitleBlock",
+    "TimelineSubtitleConfig",
+    "TimelineSubtitleFrame",
+    "TimelineSubtitleFrameItem",
+    "TimelineSubtitleLayout",
+    "TimelineSubtitleTemplate",
+    "TimelineTemplate",
+    "WpmSubtitleGenerationOptions",
+    "compile",
+    "generate_timeline_subtitles",
+    "measure_graphic_text",
+    "preview",
+    "render",
+    "render_task_hash",
+    "render_task_json_schema",
+    "settings",
+    "validate_render_task",
+]

creative_render_engine/api.py

@@ -0,0 +1,79 @@
+from __future__ import annotations
+
+from collections.abc import Sequence
+from pathlib import Path
+from typing import Any
+
+from pydantic import TypeAdapter
+
+from .compiler import (
+    compile_task,
+    generate_timeline_subtitles,
+    measure_graphic_text_task,
+    validate_render_task,
+)
+from .hashing import stable_sha256
+from .output_paths import resolve_preview_dir, resolve_render_path
+from .plans import GraphicTextMeasurement, PreviewManifest, RenderManifest, RenderPlan
+from .preview import preview_plan
+from .render import render_plan
+from .schemas import GraphicTextRenderTask, RenderTask
+
+_RENDER_TASK_ADAPTER: TypeAdapter[RenderTask] = TypeAdapter(RenderTask)
+
+
+def compile(value: RenderTask | dict[str, Any]) -> RenderPlan:
+    return compile_task(value)
+
+
+def measure_graphic_text(
+    value: GraphicTextRenderTask | dict[str, Any],
+) -> GraphicTextMeasurement:
+    return measure_graphic_text_task(value)
+
+
+def preview(
+    plan: RenderPlan,
+    output_dir: str | Path | None = None,
+    *,
+    timestamps: Sequence[float] | None = None,
+) -> PreviewManifest:
+    return preview_plan(plan, resolve_preview_dir(output_dir), timestamps=timestamps)
+
+
+def render(
+    plan: RenderPlan,
+    output_path: str | Path | None = None,
+    *,
+    output_dir: str | Path | None = None,
+    output_filename: str | None = None,
+    show_progress: bool = False,
+) -> RenderManifest:
+    destination = resolve_render_path(
+        output_path,
+        output_dir=output_dir,
+        output_filename=output_filename,
+        kind=plan.kind,
+    )
+    return render_plan(plan, destination, show_progress=show_progress)
+
+
+def render_task_hash(value: RenderTask | dict[str, Any]) -> str:
+    """Return the SHA-256 of the strictly normalized RenderTask payload."""
+    return stable_sha256(validate_render_task(value))
+
+
+def render_task_json_schema() -> dict[str, Any]:
+    return _RENDER_TASK_ADAPTER.json_schema()
+
+
+__all__ = [
+    "compile",
+    "generate_timeline_subtitles",
+    "measure_graphic_text",
+    "preview",
+    "render",
+    "render_task_hash",
+    "render_task_json_schema",
+    "validate_render_task",
+]