blendjob 0.1.5__tar.gz

blendjob-0.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OmooLab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

blendjob-0.1.5/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: blendjob
+Version: 0.1.5
+Summary: Reusable local Job Server runtime for Blender add-ons
+Keywords: blender,addon,job,server,runtime
+Author: OmooLab
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: fastapi==0.139.2 ; extra == 'server'
+Requires-Dist: uvicorn==0.51.0 ; extra == 'server'
+Requires-Python: >=3.10
+Project-URL: Documentation, https://docs.omoolab.xyz/blendjob/
+Project-URL: Issues, https://github.com/OmooLab/BlendJob/issues
+Project-URL: Repository, https://github.com/OmooLab/BlendJob
+Provides-Extra: server
+Description-Content-Type: text/markdown
+
+# BlendJob
+
+BlendJob 是面向 Blender Add-on 的本地 Job Server 运行时。它把 Blender Operator、独立 Python Environment、HTTP Job Server、FIFO Queue、进度、取消和 Resource 生命周期组合成一套可复用 API。
+
+BlendJob 适合需要在 Blender 界面之外运行 AI 推理、模型下载、媒体处理或其它重型 Python 任务的 Add-on。Blender 主进程只保留轻量 Client 和 UI 逻辑，业务依赖安装在独立 Environment 中。
+
+## 要求
+
+- Python 3.10 或更高版本
+- 支持 Python 3.10+ 的 Blender 版本
+- Windows x64、macOS arm64 或 Linux x64；内建 uv 安装器目前只提供这些平台
+
+## 安装
+
+普通 Python 项目可以使用 pip 或 uv：
+
+```bash
+python -m pip install blendjob
+```
+
+```bash
+uv add blendjob
+```
+
+默认安装保持零依赖，适合 Blender 主进程。需要在普通 Python 环境中直接创建 FastAPI App 或运行 Runner 时，安装 `server` extra：
+
+```bash
+python -m pip install "blendjob[server]"
+```
+
+Blender Extension 需要把 BlendJob wheel 随扩展分发，并在 `blender_manifest.toml` 中声明：
+
+```toml
+wheels = ["./wheels/blendjob-0.1.5-py3-none-any.whl"]
+```
+
+同一个 wheel 还需要加入 Runtime 的独立 Environment，使 Server Python 可以执行 `python -m blendjob.runner`：
+
+```python
+from pathlib import Path
+
+
+blendjob_wheel = Path(__file__).parent / "wheels" / "blendjob-0.1.5-py3-none-any.whl"
+
+environment = {
+    "python": "3.10",
+    "packages": [str(blendjob_wheel)],
+    "platform_packages": {},
+}
+```
+
+## 最小示例
+
+Server package 导出一个 `JobServer`：
+
+```python
+from blendjob import JobServer
+
+
+server = JobServer("Example Job Server")
+
+
+@server.job("double")
+def double(context, parameters):
+    context.progress(0.5, "Calculating")
+    return {"value": parameters["value"] * 2}
+```
+
+Blender 侧创建一个 Runtime，并让业务 Operator 继承绑定后的基类：
+
+```python
+from pathlib import Path
+
+from blendjob import JobRuntime
+
+
+runtime = JobRuntime(
+    "server:server",
+    entrypoint_root=Path(__file__).parent,
+    storage_root=Path.home() / ".example-addon",
+    environment=environment,
+    namespace="example_addon",
+)
+
+JobOperatorBase = runtime.JobOperatorBase
+```
+
+完整的 Runtime、Operator、Server Handler、Resource 和存储结构说明见 [开发者指南](https://docs.omoolab.xyz/blendjob/)。
+
+## 开发
+
+```bash
+uv sync
+uv run pytest
+uv build
+uv run mkdocs build --strict
+```
+
+版本化文档使用 Mike：
+
+```bash
+uv run mike deploy --update-aliases 0.1 latest
+uv run mike set-default latest
+```
+
+## License
+
+BlendJob 使用 [MIT License](https://github.com/OmooLab/BlendJob/blob/main/LICENSE)。

blendjob-0.1.5/README.md

@@ -0,0 +1,108 @@
+# BlendJob
+
+BlendJob 是面向 Blender Add-on 的本地 Job Server 运行时。它把 Blender Operator、独立 Python Environment、HTTP Job Server、FIFO Queue、进度、取消和 Resource 生命周期组合成一套可复用 API。
+
+BlendJob 适合需要在 Blender 界面之外运行 AI 推理、模型下载、媒体处理或其它重型 Python 任务的 Add-on。Blender 主进程只保留轻量 Client 和 UI 逻辑，业务依赖安装在独立 Environment 中。
+
+## 要求
+
+- Python 3.10 或更高版本
+- 支持 Python 3.10+ 的 Blender 版本
+- Windows x64、macOS arm64 或 Linux x64；内建 uv 安装器目前只提供这些平台
+
+## 安装
+
+普通 Python 项目可以使用 pip 或 uv：
+
+```bash
+python -m pip install blendjob
+```
+
+```bash
+uv add blendjob
+```
+
+默认安装保持零依赖，适合 Blender 主进程。需要在普通 Python 环境中直接创建 FastAPI App 或运行 Runner 时，安装 `server` extra：
+
+```bash
+python -m pip install "blendjob[server]"
+```
+
+Blender Extension 需要把 BlendJob wheel 随扩展分发，并在 `blender_manifest.toml` 中声明：
+
+```toml
+wheels = ["./wheels/blendjob-0.1.5-py3-none-any.whl"]
+```
+
+同一个 wheel 还需要加入 Runtime 的独立 Environment，使 Server Python 可以执行 `python -m blendjob.runner`：
+
+```python
+from pathlib import Path
+
+
+blendjob_wheel = Path(__file__).parent / "wheels" / "blendjob-0.1.5-py3-none-any.whl"
+
+environment = {
+    "python": "3.10",
+    "packages": [str(blendjob_wheel)],
+    "platform_packages": {},
+}
+```
+
+## 最小示例
+
+Server package 导出一个 `JobServer`：
+
+```python
+from blendjob import JobServer
+
+
+server = JobServer("Example Job Server")
+
+
+@server.job("double")
+def double(context, parameters):
+    context.progress(0.5, "Calculating")
+    return {"value": parameters["value"] * 2}
+```
+
+Blender 侧创建一个 Runtime，并让业务 Operator 继承绑定后的基类：
+
+```python
+from pathlib import Path
+
+from blendjob import JobRuntime
+
+
+runtime = JobRuntime(
+    "server:server",
+    entrypoint_root=Path(__file__).parent,
+    storage_root=Path.home() / ".example-addon",
+    environment=environment,
+    namespace="example_addon",
+)
+
+JobOperatorBase = runtime.JobOperatorBase
+```
+
+完整的 Runtime、Operator、Server Handler、Resource 和存储结构说明见 [开发者指南](https://docs.omoolab.xyz/blendjob/)。
+
+## 开发
+
+```bash
+uv sync
+uv run pytest
+uv build
+uv run mkdocs build --strict
+```
+
+版本化文档使用 Mike：
+
+```bash
+uv run mike deploy --update-aliases 0.1 latest
+uv run mike set-default latest
+```
+
+## License
+
+BlendJob 使用 [MIT License](https://github.com/OmooLab/BlendJob/blob/main/LICENSE)。

blendjob-0.1.5/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "blendjob"
+version = "0.1.5"
+description = "Reusable local Job Server runtime for Blender add-ons"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "blender",
+    "addon",
+    "job",
+    "server",
+    "runtime",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = []
+
+[[project.authors]]
+name = "OmooLab"
+
+[project.urls]
+Documentation = "https://docs.omoolab.xyz/blendjob/"
+Issues = "https://github.com/OmooLab/BlendJob/issues"
+Repository = "https://github.com/OmooLab/BlendJob"
+
+[project.optional-dependencies]
+server = [
+    "fastapi==0.139.2",
+    "uvicorn==0.51.0",
+]
+
+[dependency-groups]
+dev = [
+    "fastapi==0.139.2",
+    "mike>=2.1,<3",
+    "mkdocs-material>=9.6,<10",
+    "mkdocstrings[python]>=0.30,<1",
+    "pytest>=8.4,<9",
+    "uvicorn==0.51.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.3,<0.13.0"]
+build-backend = "uv_build"

blendjob-0.1.5/pyproject.toml.orig

@@ -0,0 +1,45 @@
+[project]
+name = "blendjob"
+version = "0.1.5"
+description = "Reusable local Job Server runtime for Blender add-ons"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "OmooLab" }]
+keywords = ["blender", "addon", "job", "server", "runtime"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = []
+
+[project.urls]
+Documentation = "https://docs.omoolab.xyz/blendjob/"
+Issues = "https://github.com/OmooLab/BlendJob/issues"
+Repository = "https://github.com/OmooLab/BlendJob"
+
+[project.optional-dependencies]
+server = [
+    "fastapi==0.139.2",
+    "uvicorn==0.51.0",
+]
+
+[dependency-groups]
+dev = [
+    "fastapi==0.139.2",
+    "mike>=2.1,<3",
+    "mkdocs-material>=9.6,<10",
+    "mkdocstrings[python]>=0.30,<1",
+    "pytest>=8.4,<9",
+    "uvicorn==0.51.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.3,<0.13.0"]
+build-backend = "uv_build"

blendjob-0.1.5/src/blendjob/__init__.py

@@ -0,0 +1,21 @@
+"""Reusable local HTTP Job Server for Blender add-ons."""
+
+from .client import JobClient, JobResult
+from .controller import ServerConnection, ServerController
+from .operator import JobOperatorBase, JobOperatorState
+from .runtime import JobRuntime
+from .server import JobCancelled, JobContext, JobServer
+
+
+__all__ = (
+    "JobCancelled",
+    "JobClient",
+    "JobContext",
+    "JobResult",
+    "JobServer",
+    "JobRuntime",
+    "JobOperatorBase",
+    "JobOperatorState",
+    "ServerConnection",
+    "ServerController",
+)

blendjob-0.1.5/src/blendjob/client.py

@@ -0,0 +1,101 @@
+import json
+from dataclasses import dataclass
+from pathlib import Path
+from urllib.error import HTTPError, URLError
+from urllib.request import ProxyHandler, Request, build_opener
+
+
+class JobClient:
+    """Dependency-free HTTP client for a local :class:`JobServer`."""
+
+    def __init__(self, host, port, *, timeout=2.0):
+        self.base_url = f"http://{host}:{int(port)}"
+        self.timeout = timeout
+        self.opener = build_opener(ProxyHandler({}))
+
+    def request(self, method, path, payload=None, timeout=None):
+        data = None
+        headers = {}
+        if payload is not None:
+            data = json.dumps(payload).encode("utf-8")
+            headers["Content-Type"] = "application/json"
+        request = Request(
+            f"{self.base_url}{path}",
+            data=data,
+            headers=headers,
+            method=method,
+        )
+        try:
+            with self.opener.open(
+                request,
+                timeout=self.timeout if timeout is None else timeout,
+            ) as response:
+                return json.loads(response.read().decode("utf-8"))
+        except HTTPError as error:
+            try:
+                detail = json.loads(error.read().decode("utf-8")).get("detail")
+            except (json.JSONDecodeError, UnicodeDecodeError):
+                detail = None
+            raise RuntimeError(detail or f"Job Server returned HTTP {error.code}")
+        except (OSError, URLError) as error:
+            raise RuntimeError(f"Unable to reach Job Server: {error}")
+
+    def health(self):
+        return self.request("GET", "/health")
+
+    def submit(self, job_type, parameters):
+        return self.request(
+            "POST",
+            "/jobs",
+            {"job_type": str(job_type), "parameters": dict(parameters)},
+        )
+
+    def status(self, job_id):
+        return self.request("GET", f"/jobs/{job_id}")
+
+    def cancel(self, job_id):
+        return self.request("DELETE", f"/jobs/{job_id}")
+
+    def resources(self):
+        return self.request("GET", "/resources")
+
+    def resource(self, name):
+        return self.request("GET", f"/resources/{name}")
+
+    def clear_resource(self, name):
+        return self.request("POST", f"/resources/{name}/clear")
+
+    def shutdown(self):
+        return self.request("POST", "/shutdown")
+@dataclass(frozen=True)
+class JobResult:
+    """Successful Job value and files returned to a Blender Operator."""
+
+    job_id: str
+    directory: Path
+    value: object
+    status: dict
+
+    @classmethod
+    def from_status(cls, status):
+        return cls(
+            job_id=str(status.get("job_id", "")),
+            directory=Path(status["directory"]),
+            value=status.get("result"),
+            status=dict(status),
+        )
+
+    def file(self, name):
+        if not isinstance(self.value, dict):
+            raise RuntimeError("Job result does not contain named files")
+        try:
+            relative = self.value[name]
+        except KeyError:
+            raise RuntimeError(f"Job result does not contain file: {name}") from None
+        root = self.directory.resolve()
+        path = (root / str(relative)).resolve()
+        if path != root and root not in path.parents:
+            raise RuntimeError(f"Job result file escapes its directory: {relative}")
+        if not path.is_file():
+            raise RuntimeError(f"Job result file does not exist: {path}")
+        return path