durable-workflow 2.6.0rc3__tar.gz → 2.6.1__tar.gz

{durable_workflow-2.6.0rc3/src/durable_workflow.egg-info → durable_workflow-2.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: durable-workflow
-Version: 2.6.0rc3
+Version: 2.6.1
 Summary: Python client and worker SDK for Durable Workflow Cloud and self-hosted Server
 Author: Durable Workflow Contributors
 License-Expression: MIT
@@ -139,6 +139,7 @@ for the complete cross-SDK contract.
 - [Python SDK guide](https://durable-workflow.com/docs/2.0/polyglot/python/)
 - [Complete SDK reference](docs/sdk-reference.md)
 - [Runnable examples](examples/)
+- [Separate workflow and activity worker processes](docs/guides/separate-workers.md)
 - [Symmetric SDK playground](https://github.com/durable-workflow/sample-app#symmetric-sdk-playground)
 
 ## Runtime choices

{durable_workflow-2.6.0rc3 → durable_workflow-2.6.1}/README.md

@@ -99,6 +99,7 @@ for the complete cross-SDK contract.
 - [Python SDK guide](https://durable-workflow.com/docs/2.0/polyglot/python/)
 - [Complete SDK reference](docs/sdk-reference.md)
 - [Runnable examples](examples/)
+- [Separate workflow and activity worker processes](docs/guides/separate-workers.md)
 - [Symmetric SDK playground](https://github.com/durable-workflow/sample-app#symmetric-sdk-playground)
 
 ## Runtime choices

{durable_workflow-2.6.0rc3 → durable_workflow-2.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "durable-workflow"
-version = "2.6.0-rc.3"
+version = "2.6.1"
 description = "Python client and worker SDK for Durable Workflow Cloud and self-hosted Server"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -71,8 +71,8 @@ durable-workflow-replay-conformance = "durable_workflow.replay_conformance:main"
 durable-workflow-workflow-updates-conformance = "durable_workflow.workflow_updates_conformance:main"
 
 [tool.durable-workflow]
-product-train = "2.6.0-rc.3"
-registry-version = "2.6.0rc3"
+product-train = "2.6.1"
+registry-version = "2.6.1"
 supported-server-versions = "2.8.0"
 worker-protocol-version = "1.20"
 control-plane-version = "2"

{durable_workflow-2.6.0rc3 → durable_workflow-2.6.1}/src/durable_workflow/client.py

@@ -3527,9 +3527,18 @@ class Client:
         ``workflow_type`` is the language-neutral type key registered via
         :func:`durable_workflow.workflow.defn`. ``task_queue`` selects which
         worker pool picks up the workflow. ``workflow_id`` is the
-        caller-supplied instance id — if it collides with an existing
-        workflow, behavior depends on ``duplicate_policy``
-        (``reject`` | ``allow`` | ``terminate_existing``).
+        caller-supplied instance ID. The PHP Server start contract accepts
+        ``duplicate_policy="fail"`` (also the default when omitted) or
+        ``"use-existing"``. ``fail`` raises :class:`WorkflowAlreadyStarted`
+        if the ID already exists. ``use-existing`` returns the original run
+        only while it is pending, running or waiting. Both policies reject
+        a closed instance. Neither replaces a run or changes its input or
+        deadlines. Use a new workflow ID for a new independent execution.
+
+        The SDK forwards the policy unchanged. ``reject``, ``allow`` and
+        ``terminate_existing`` are not supported wire values. A resource-keyed
+        workflow ID coordinates start admission; it does not revoke work
+        already running in an external system.
 
         ``input`` is a list of positional arguments passed to the workflow's
         ``run`` method; the SDK encodes the list with the default payload

{durable_workflow-2.6.0rc3 → durable_workflow-2.6.1}/src/durable_workflow/errors.py

@@ -312,8 +312,10 @@ class WorkflowNotFound(DurableWorkflowError):
 class WorkflowAlreadyStarted(DurableWorkflowError):
     """A start request collided with an existing instance id.
 
-    Raised when duplicate-start policy is ``reject`` (the default) and the
-    caller-supplied ``workflow_id`` is already in use.
+    The PHP Server raises this for an existing ``workflow_id`` when the
+    duplicate policy is ``fail`` (the default), or when ``use-existing``
+    addresses a closed instance. ``use-existing`` returns a handle only
+    while the original run is pending, running or waiting.
     """
 
     def __init__(self, workflow_id: str) -> None:
@@ -874,7 +876,7 @@ def _raise_for_status(status: int, body: object, *, context: str = "") -> None:
     if status == 409:
         if reason == "schedule_already_exists":
             raise ScheduleAlreadyExists(context)
-        if reason == "duplicate_not_allowed":
+        if reason in ("duplicate_not_allowed", "instance_already_started"):
             raise WorkflowAlreadyStarted(context)
         if reason == "run_not_active":
             if operation == "signal":

{durable_workflow-2.6.0rc3 → durable_workflow-2.6.1/src/durable_workflow.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: durable-workflow
-Version: 2.6.0rc3
+Version: 2.6.1
 Summary: Python client and worker SDK for Durable Workflow Cloud and self-hosted Server
 Author: Durable Workflow Contributors
 License-Expression: MIT
@@ -139,6 +139,7 @@ for the complete cross-SDK contract.
 - [Python SDK guide](https://durable-workflow.com/docs/2.0/polyglot/python/)
 - [Complete SDK reference](docs/sdk-reference.md)
 - [Runnable examples](examples/)
+- [Separate workflow and activity worker processes](docs/guides/separate-workers.md)
 - [Symmetric SDK playground](https://github.com/durable-workflow/sample-app#symmetric-sdk-playground)
 
 ## Runtime choices

{durable_workflow-2.6.0rc3 → durable_workflow-2.6.1}/tests/test_errors.py

@@ -57,9 +57,11 @@ class TestRaiseForStatus:
         with pytest.raises(ServerError):
             _raise_for_status(404, {"reason": "other"})
 
-    def test_409_duplicate(self) -> None:
-        with pytest.raises(WorkflowAlreadyStarted):
-            _raise_for_status(409, {"reason": "duplicate_not_allowed"}, context="wf-1")
+    @pytest.mark.parametrize("reason", ["duplicate_not_allowed", "instance_already_started"])
+    def test_409_duplicate(self, reason: str) -> None:
+        with pytest.raises(WorkflowAlreadyStarted) as duplicate:
+            _raise_for_status(409, {"reason": reason}, context="resource-017")
+        assert duplicate.value.workflow_id == "resource-017"
 
     def test_409_query_rejected(self) -> None:
         with pytest.raises(QueryFailed):