durable-workflow 0.1.0__tar.gz

durable_workflow-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Durable Workflow
+
+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.

durable_workflow-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: durable-workflow
+Version: 0.1.0
+Summary: Python SDK for the Durable Workflow server (language-neutral HTTP protocol)
+Author: Durable Workflow Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/durable-workflow/sdk-python
+Project-URL: Documentation, https://durable-workflow.github.io/docs/2.0/sdks/python/
+Project-URL: Repository, https://github.com/durable-workflow/sdk-python
+Project-URL: Issues, https://github.com/zorporation/durable-workflow/issues
+Keywords: workflow,durable,orchestration,temporal,saga
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# durable-workflow (Python SDK)
+
+A Python SDK for the [Durable Workflow server](https://github.com/durable-workflow/server). Speaks the server's language-neutral HTTP/JSON worker protocol — no PHP runtime required.
+
+Status: **Alpha**. Supports starting workflows, registering workers, polling workflow + activity tasks, schedules, signals, and completing workflows. Queries, updates, timers, and child workflows are planned.
+
+## Install
+
+```bash
+pip install durable-workflow
+```
+
+Or for development:
+
+```bash
+pip install -e '.[dev]'
+```
+
+## Quickstart
+
+```python
+from durable_workflow import Client, Worker, workflow, activity
+
+@activity.defn(name="greet")
+def greet(name: str) -> str:
+    return f"hello, {name}"
+
+@workflow.defn(name="greeter")
+class GreeterWorkflow:
+    def run(self, ctx, name):
+        result = yield ctx.schedule_activity("greet", [name])
+        return result
+
+async def main():
+    client = Client("http://server:8080", token="dev-token-123", namespace="default")
+    worker = Worker(
+        client,
+        task_queue="python-workers",
+        workflows=[GreeterWorkflow],
+        activities=[greet],
+    )
+    handle = await client.start_workflow(
+        workflow_type="greeter",
+        workflow_id="greet-1",
+        task_queue="python-workers",
+        input=["world"],
+    )
+    await worker.run_until(workflow_id="greet-1")
+    result = await client.get_result(handle)
+    print(result)  # "hello, world"
+```
+
+## Features
+
+- **Async-first**: Built on `httpx` and `asyncio`
+- **Type-safe**: Full type hints, passes `mypy --strict`
+- **Polyglot**: Works alongside PHP workers on the same task queue
+- **HTTP/JSON protocol**: No gRPC, no protobuf dependencies
+- **Codec envelopes**: Proper `{codec: "json", blob: "..."}` serialization for cross-language workflows
+
+## Documentation
+
+Full documentation is available at [durable-workflow.github.io/docs/2.0/sdks/python/](https://durable-workflow.github.io/docs/2.0/sdks/python/):
+
+- [Quickstart](https://durable-workflow.github.io/docs/2.0/sdks/python/quickstart)
+- [Client API](https://durable-workflow.github.io/docs/2.0/sdks/python/client)
+- [Workflow Authoring](https://durable-workflow.github.io/docs/2.0/sdks/python/workflows)
+- [Activity Authoring](https://durable-workflow.github.io/docs/2.0/sdks/python/activities)
+- [Worker Configuration](https://durable-workflow.github.io/docs/2.0/sdks/python/workers)
+- [Error Handling](https://durable-workflow.github.io/docs/2.0/sdks/python/errors)
+- [Schedules (Cron)](https://durable-workflow.github.io/docs/2.0/sdks/python/schedules)
+
+## Requirements
+
+- Python ≥ 3.10
+- A running [Durable Workflow server](https://github.com/durable-workflow/server)
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e '.[dev]'
+
+# Run tests
+pytest
+
+# Run integration tests (requires Docker)
+pytest -m integration
+
+# Type check
+mypy src/durable_workflow/
+
+# Lint
+ruff check src/ tests/
+```
+
+## License
+
+MIT

durable_workflow-0.1.0/README.md

@@ -0,0 +1,99 @@
+# durable-workflow (Python SDK)
+
+A Python SDK for the [Durable Workflow server](https://github.com/durable-workflow/server). Speaks the server's language-neutral HTTP/JSON worker protocol — no PHP runtime required.
+
+Status: **Alpha**. Supports starting workflows, registering workers, polling workflow + activity tasks, schedules, signals, and completing workflows. Queries, updates, timers, and child workflows are planned.
+
+## Install
+
+```bash
+pip install durable-workflow
+```
+
+Or for development:
+
+```bash
+pip install -e '.[dev]'
+```
+
+## Quickstart
+
+```python
+from durable_workflow import Client, Worker, workflow, activity
+
+@activity.defn(name="greet")
+def greet(name: str) -> str:
+    return f"hello, {name}"
+
+@workflow.defn(name="greeter")
+class GreeterWorkflow:
+    def run(self, ctx, name):
+        result = yield ctx.schedule_activity("greet", [name])
+        return result
+
+async def main():
+    client = Client("http://server:8080", token="dev-token-123", namespace="default")
+    worker = Worker(
+        client,
+        task_queue="python-workers",
+        workflows=[GreeterWorkflow],
+        activities=[greet],
+    )
+    handle = await client.start_workflow(
+        workflow_type="greeter",
+        workflow_id="greet-1",
+        task_queue="python-workers",
+        input=["world"],
+    )
+    await worker.run_until(workflow_id="greet-1")
+    result = await client.get_result(handle)
+    print(result)  # "hello, world"
+```
+
+## Features
+
+- **Async-first**: Built on `httpx` and `asyncio`
+- **Type-safe**: Full type hints, passes `mypy --strict`
+- **Polyglot**: Works alongside PHP workers on the same task queue
+- **HTTP/JSON protocol**: No gRPC, no protobuf dependencies
+- **Codec envelopes**: Proper `{codec: "json", blob: "..."}` serialization for cross-language workflows
+
+## Documentation
+
+Full documentation is available at [durable-workflow.github.io/docs/2.0/sdks/python/](https://durable-workflow.github.io/docs/2.0/sdks/python/):
+
+- [Quickstart](https://durable-workflow.github.io/docs/2.0/sdks/python/quickstart)
+- [Client API](https://durable-workflow.github.io/docs/2.0/sdks/python/client)
+- [Workflow Authoring](https://durable-workflow.github.io/docs/2.0/sdks/python/workflows)
+- [Activity Authoring](https://durable-workflow.github.io/docs/2.0/sdks/python/activities)
+- [Worker Configuration](https://durable-workflow.github.io/docs/2.0/sdks/python/workers)
+- [Error Handling](https://durable-workflow.github.io/docs/2.0/sdks/python/errors)
+- [Schedules (Cron)](https://durable-workflow.github.io/docs/2.0/sdks/python/schedules)
+
+## Requirements
+
+- Python ≥ 3.10
+- A running [Durable Workflow server](https://github.com/durable-workflow/server)
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e '.[dev]'
+
+# Run tests
+pytest
+
+# Run integration tests (requires Docker)
+pytest -m integration
+
+# Type check
+mypy src/durable_workflow/
+
+# Lint
+ruff check src/ tests/
+```
+
+## License
+
+MIT

durable_workflow-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "durable-workflow"
+version = "0.1.0"
+description = "Python SDK for the Durable Workflow server (language-neutral HTTP protocol)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Durable Workflow Contributors" },
+]
+keywords = [
+    "workflow",
+    "durable",
+    "orchestration",
+    "temporal",
+    "saga",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "mypy>=1.10",
+    "ruff>=0.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/durable-workflow/sdk-python"
+Documentation = "https://durable-workflow.github.io/docs/2.0/sdks/python/"
+Repository = "https://github.com/durable-workflow/sdk-python"
+Issues = "https://github.com/zorporation/durable-workflow/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+markers = [
+    "integration: marks tests that require a running server (deselect with '-m \"not integration\"')",
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+packages = ["durable_workflow"]
+mypy_path = "src"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 120
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]

durable_workflow-0.1.0/setup.cfg

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

durable_workflow-0.1.0/src/durable_workflow/__init__.py

@@ -0,0 +1,75 @@
+from . import activity, sync, workflow
+from .activity import ActivityContext, ActivityInfo
+from .client import (
+    Client,
+    ScheduleAction,
+    ScheduleBackfillResult,
+    ScheduleDescription,
+    ScheduleHandle,
+    ScheduleList,
+    ScheduleSpec,
+    ScheduleTriggerResult,
+    WorkflowExecution,
+    WorkflowHandle,
+    WorkflowList,
+)
+from .errors import (
+    ActivityCancelled,
+    ChildWorkflowFailed,
+    DurableWorkflowError,
+    InvalidArgument,
+    NamespaceNotFound,
+    NonRetryableError,
+    QueryFailed,
+    ScheduleAlreadyExists,
+    ScheduleNotFound,
+    ServerError,
+    Unauthorized,
+    UpdateRejected,
+    WorkflowAlreadyStarted,
+    WorkflowCancelled,
+    WorkflowFailed,
+    WorkflowNotFound,
+    WorkflowTerminated,
+)
+from .worker import Worker
+from .workflow import ContinueAsNew, StartChildWorkflow
+
+__all__ = [
+    "ActivityCancelled",
+    "ActivityContext",
+    "ActivityInfo",
+    "ChildWorkflowFailed",
+    "Client",
+    "ContinueAsNew",
+    "NonRetryableError",
+    "ScheduleAction",
+    "ScheduleAlreadyExists",
+    "ScheduleBackfillResult",
+    "ScheduleDescription",
+    "ScheduleHandle",
+    "ScheduleList",
+    "ScheduleNotFound",
+    "ScheduleSpec",
+    "ScheduleTriggerResult",
+    "StartChildWorkflow",
+    "Worker",
+    "WorkflowExecution",
+    "WorkflowHandle",
+    "WorkflowList",
+    "activity",
+    "sync",
+    "workflow",
+    "DurableWorkflowError",
+    "InvalidArgument",
+    "NamespaceNotFound",
+    "QueryFailed",
+    "ServerError",
+    "Unauthorized",
+    "UpdateRejected",
+    "WorkflowAlreadyStarted",
+    "WorkflowCancelled",
+    "WorkflowFailed",
+    "WorkflowNotFound",
+    "WorkflowTerminated",
+]

durable_workflow-0.1.0/src/durable_workflow/activity.py

@@ -0,0 +1,83 @@
+"""Activity decorator, registry, and execution context."""
+from __future__ import annotations
+
+import contextvars
+from collections.abc import Callable
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any
+
+from .errors import ActivityCancelled
+
+if TYPE_CHECKING:
+    from .client import Client
+
+_REGISTRY: dict[str, Callable[..., Any]] = {}
+
+_current_context: contextvars.ContextVar[ActivityContext | None] = contextvars.ContextVar(
+    "activity_context", default=None
+)
+
+
+@dataclass(frozen=True)
+class ActivityInfo:
+    task_id: str
+    activity_type: str
+    activity_attempt_id: str
+    attempt_number: int
+    task_queue: str
+    worker_id: str
+
+
+class ActivityContext:
+    def __init__(
+        self,
+        *,
+        info: ActivityInfo,
+        client: Client,
+    ) -> None:
+        self._info = info
+        self._client = client
+        self._cancel_requested = False
+
+    @property
+    def info(self) -> ActivityInfo:
+        return self._info
+
+    @property
+    def is_cancelled(self) -> bool:
+        return self._cancel_requested
+
+    async def heartbeat(self, details: dict[str, Any] | None = None) -> None:
+        resp = await self._client.heartbeat_activity_task(
+            task_id=self._info.task_id,
+            activity_attempt_id=self._info.activity_attempt_id,
+            lease_owner=self._info.worker_id,
+            details=details,
+        )
+        if isinstance(resp, dict) and resp.get("cancel_requested"):
+            self._cancel_requested = True
+            raise ActivityCancelled()
+
+
+def context() -> ActivityContext:
+    ctx = _current_context.get()
+    if ctx is None:
+        raise RuntimeError("activity.context() called outside of an activity execution")
+    return ctx
+
+
+def _set_context(ctx: ActivityContext | None) -> contextvars.Token[ActivityContext | None]:
+    return _current_context.set(ctx)
+
+
+def defn(*, name: str) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
+    def wrap(fn: Callable[..., Any]) -> Callable[..., Any]:
+        fn.__activity_name__ = name  # type: ignore[attr-defined]
+        _REGISTRY[name] = fn
+        return fn
+
+    return wrap
+
+
+def registry() -> dict[str, Callable[..., Any]]:
+    return dict(_REGISTRY)