creative-render-engine 0.7.0__tar.gz

creative_render_engine-0.7.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: creative-render-engine
+Version: 0.7.0
+Summary: Standalone creative image, scroll, and timeline rendering engine
+Keywords: image,video,rendering,subtitle,timeline
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic<3,>=2.12
+Requires-Dist: pillow<12,>=11
+Requires-Dist: numpy<3,>=2
+Requires-Dist: moviepy<3,>=2.2
+Requires-Dist: proglog<1,>=0.1.12
+Requires-Dist: text-block-renderer<4,>=3.2.2
+Provides-Extra: publish
+Requires-Dist: setuptools>=78; extra == "publish"
+Requires-Dist: mypy<2,>=1.19; extra == "publish"
+Requires-Dist: build<2,>=1.2; extra == "publish"
+Requires-Dist: twine<7,>=6; extra == "publish"
+
+# Creative Render Engine
+
+独立的创意图片、滚动视频和时间线渲染引擎，提供基于 Pydantic 的任务模型、编译、预览和渲染接口。
+
+## 安装
+
+需要 Python 3.12 或更高版本。
+
+```shell
+python -m pip install creative-render-engine
+```
+
+发行包名为 `creative-render-engine`，Python 导入名为 `creative_render_engine`。
+
+## 使用
+
+```python
+import creative_render_engine as engine
+
+# 获取任务 JSON Schema，查看支持的任务类型和字段。
+schema = engine.render_task_json_schema()
+
+# 写入文件前必须配置输出根目录。
+engine.settings.output_root = "./output"
+
+# task 为符合 Schema 的任务字典或 RenderTask 模型：
+# plan = engine.compile(task)
+# preview = engine.preview(plan)
+# result = engine.render(plan)
+```
+
+支持纯图片、图文、滚动和时间线任务，以及时间线字幕生成。字体、图片、音视频等素材由调用方提供，不随包分发；视频处理依赖 MoviePy 和可用的 FFmpeg。
+
+## 发布
+
+本地打包、校验及上传 PyPI 的步骤见源码目录中的 `build_pypi.md`。

creative_render_engine-0.7.0/README.md

@@ -0,0 +1,36 @@
+# Creative Render Engine
+
+独立的创意图片、滚动视频和时间线渲染引擎，提供基于 Pydantic 的任务模型、编译、预览和渲染接口。
+
+## 安装
+
+需要 Python 3.12 或更高版本。
+
+```shell
+python -m pip install creative-render-engine
+```
+
+发行包名为 `creative-render-engine`，Python 导入名为 `creative_render_engine`。
+
+## 使用
+
+```python
+import creative_render_engine as engine
+
+# 获取任务 JSON Schema，查看支持的任务类型和字段。
+schema = engine.render_task_json_schema()
+
+# 写入文件前必须配置输出根目录。
+engine.settings.output_root = "./output"
+
+# task 为符合 Schema 的任务字典或 RenderTask 模型：
+# plan = engine.compile(task)
+# preview = engine.preview(plan)
+# result = engine.render(plan)
+```
+
+支持纯图片、图文、滚动和时间线任务，以及时间线字幕生成。字体、图片、音视频等素材由调用方提供，不随包分发；视频处理依赖 MoviePy 和可用的 FFmpeg。
+
+## 发布
+
+本地打包、校验及上传 PyPI 的步骤见源码目录中的 `build_pypi.md`。

creative_render_engine-0.7.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=78"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "creative-render-engine"
+version = "0.7.0"
+description = "Standalone creative image, scroll, and timeline rendering engine"
+readme = "README.md"
+keywords = ["image", "video", "rendering", "subtitle", "timeline"]
+classifiers = [
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "pydantic>=2.12,<3",
+    "pillow>=11,<12",
+    "numpy>=2,<3",
+    "moviepy>=2.2,<3",
+    "proglog>=0.1.12,<1",
+    "text-block-renderer>=3.2.2,<4",
+]
+
+[project.optional-dependencies]
+publish = [
+    "setuptools>=78",
+    "mypy>=1.19,<2",
+    "build>=1.2,<2",
+    "twine>=6,<7",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+creative_render_engine = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.12"
+mypy_path = ["src"]
+ignore_missing_imports = true
+disable_error_code = ["import-untyped"]

creative_render_engine-0.7.0/setup.cfg

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

creative_render_engine-0.7.0/src/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-0.7.0/src/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",
+]