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

creative_render_engine/settings.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from .errors import ConfigurationError
+
+
+class EngineSettings:
+    def __init__(self) -> None:
+        self._output_root: Path | None = None
+
+    @property
+    def output_root(self) -> Path | None:
+        return self._output_root
+
+    @output_root.setter
+    def output_root(self, value: str | Path | None) -> None:
+        self._output_root = None if value is None else Path(value).expanduser().resolve()
+
+    def require_output_root(self) -> Path:
+        if self._output_root is None:
+            raise ConfigurationError(
+                "settings.output_root must be configured before writing files",
+                code="output_root_not_configured",
+                field_path="settings.output_root",
+            )
+        self._output_root.mkdir(parents=True, exist_ok=True)
+        return self._output_root
+
+
+settings = EngineSettings()

creative_render_engine-0.7.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,19 @@
+creative_render_engine/__init__.py,sha256=NYNdDeyNlm1sbwpryzaF4cXG9WOz9tiZEW3x_6N0XEY,1669
+creative_render_engine/api.py,sha256=h3UPcMiB-VXJS_6qYeO-sI_Cr16---bIe6ny36JkqIU,2117
+creative_render_engine/compiler.py,sha256=Uq32ac9KGWeWk9RnSpZQWmn5mn-DQTZrAcJymiH93Rw,53423
+creative_render_engine/errors.py,sha256=Ck3n0xDJbKyrWnOsXf9XJ2Xbk43TlqnQnELqjTyy8eM,1148
+creative_render_engine/hashing.py,sha256=XV7E3pe2kvB2c3ek-W84eMGqEcTY-OoMaqqh16gZcUk,810
+creative_render_engine/output_paths.py,sha256=cE9XHujzcV1VHQHUHhlkMggpHM-VnndGXVRzaeJtXNc,2717
+creative_render_engine/plans.py,sha256=HK2hhDeyMh3Z_pgnb9sTZ7s29mMXdtQ2KEOps3jL2Is,6688
+creative_render_engine/preview.py,sha256=ZDmPktjMoP-E16kyUCddj0SYi7pw4QDJlAYCOZnt2pE,7300
+creative_render_engine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+creative_render_engine/render.py,sha256=CeMddOuDbWlj9flbHngrjq5TamOPSLhSf6-EBhFjI50,10630
+creative_render_engine/schemas.py,sha256=cnmxXlSgamWHZbKrQLc3pNDoeeRXDaU5gie_fntbyZg,25178
+creative_render_engine/settings.py,sha256=ZKowD1NGRoMRG800MXpIvt2be-nRKZqJDgwAfI_iiqk,909
+creative_render_engine/engines/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+creative_render_engine/engines/common.py,sha256=cm3XDrEfqWRss6um8AtZ1H5YqcSB_ci1_40rc-dgDlI,18102
+creative_render_engine/engines/pure_image.py,sha256=g8VLYE4v0WK3gcsLN0YTTTN8Pv4nD7nLGF5JUjHJbfw,3562
+creative_render_engine-0.7.0.dist-info/METADATA,sha256=RBvLhlo4HXpmPMr6z2UTkLR5RodEIf7WVOyFmH9nBTE,2003
+creative_render_engine-0.7.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+creative_render_engine-0.7.0.dist-info/top_level.txt,sha256=9SHV2hJ8auuZHZVohkfFBX8DW0fU-_CadloGEJrr_bo,23
+creative_render_engine-0.7.0.dist-info/RECORD,,

creative_render_engine-0.7.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

creative_render_engine-0.7.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+creative_render_engine