durable-workflow 2.0.1__tar.gz → 2.0.2__tar.gz

{durable_workflow-2.0.1/src/durable_workflow.egg-info → durable_workflow-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: durable-workflow
-Version: 2.0.1
+Version: 2.0.2
 Summary: Python client and worker SDK for Durable Workflow Cloud and self-hosted Server
 Author: Durable Workflow Contributors
 License-Expression: MIT

{durable_workflow-2.0.1 → durable_workflow-2.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "durable-workflow"
-version = "2.0.1"
+version = "2.0.2"
 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.0.1"
-registry-version = "2.0.1"
+product-train = "2.0.2"
+registry-version = "2.0.2"
 supported-server-versions = "2.0.0"
 worker-protocol-version = "1.19"
 control-plane-version = "2"

{durable_workflow-2.0.1 → durable_workflow-2.0.2}/src/durable_workflow/__init__.py

@@ -95,6 +95,7 @@ from .errors import (
     WorkflowNotFound,
     WorkflowPayloadDecodeError,
     WorkflowTerminated,
+    WorkflowTimedOut,
 )
 from .external_storage import (
     EXTERNAL_PAYLOAD_REFERENCE_SCHEMA,
@@ -374,6 +375,7 @@ __all__ = [
     "WorkflowFailed",
     "WorkflowNotFound",
     "WorkflowTerminated",
+    "WorkflowTimedOut",
     "EXTERNAL_TASK_INPUT_CONTRACT_SCHEMA",
     "EXTERNAL_TASK_INPUT_MEDIA_TYPE",
     "EXTERNAL_TASK_INPUT_SCHEMA",

{durable_workflow-2.0.1 → durable_workflow-2.0.2}/src/durable_workflow/client.py

@@ -46,6 +46,7 @@ from .errors import (
     WorkflowCancelled,
     WorkflowFailed,
     WorkflowTerminated,
+    WorkflowTimedOut,
     _raise_for_status,
 )
 from .external_storage import (
@@ -4141,8 +4142,9 @@ class Client:
         Raises :class:`~durable_workflow.errors.WorkflowFailed`,
         :class:`~durable_workflow.errors.WorkflowCancelled`, or
         :class:`~durable_workflow.errors.WorkflowTerminated` if the workflow
-        ended in a non-success state, or :class:`TimeoutError` if ``timeout``
-        seconds elapse before the workflow terminates.
+        ended in a non-success state. A persisted execution or run deadline
+        raises :class:`~durable_workflow.errors.WorkflowTimedOut`; a caller's
+        :class:`TimeoutError` means ``timeout`` seconds elapsed while waiting.
         """
         deadline = asyncio.get_running_loop().time() + timeout
         while True:
@@ -4177,6 +4179,8 @@ class Client:
                         raise WorkflowCancelled(
                             payload.get("reason", "workflow was cancelled")
                         )
+                    if etype == "WorkflowTimedOut":
+                        raise WorkflowTimedOut()
                 return None
             if asyncio.get_running_loop().time() > deadline:
                 raise TimeoutError(

{durable_workflow-2.0.1 → durable_workflow-2.0.2}/src/durable_workflow/errors.py

@@ -560,6 +560,17 @@ class WorkflowTerminated(DurableWorkflowError):
         super().__init__(message)
 
 
+class WorkflowTimedOut(DurableWorkflowError):
+    """A persisted workflow execution or run deadline expired.
+
+    Unlike a caller's :class:`TimeoutError` while polling, this is a terminal
+    workflow outcome recorded by the runtime.
+    """
+
+    def __init__(self, message: str = "workflow execution timed out") -> None:
+        super().__init__(message)
+
+
 class SagaCompensationFailed(DurableWorkflowError):
     """A saga compensation failed after an earlier workflow failure.
 

{durable_workflow-2.0.1 → durable_workflow-2.0.2/src/durable_workflow.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: durable-workflow
-Version: 2.0.1
+Version: 2.0.2
 Summary: Python client and worker SDK for Durable Workflow Cloud and self-hosted Server
 Author: Durable Workflow Contributors
 License-Expression: MIT

{durable_workflow-2.0.1 → durable_workflow-2.0.2}/src/durable_workflow.egg-info/SOURCES.txt

@@ -79,5 +79,6 @@ tests/test_update_signal_condition_replay.py
 tests/test_updates.py
 tests/test_wait_condition.py
 tests/test_worker.py
+tests/test_workflow_result_timeout.py
 tests/test_workflow_streams.py
 tests/test_workflow_updates_conformance.py

{durable_workflow-2.0.1 → durable_workflow-2.0.2}/tests/test_pypi_project_surface.py

@@ -348,7 +348,7 @@ def test_stable_audit_requires_root_and_bare_install(
     assert evidence["historical_versions"] == ["0.4.105", "0.4.106"]
 
 
-def test_stable_root_preserves_non_yanked_historical_files() -> None:
+def test_stable_root_preserves_historical_files_without_overriding_yanks() -> None:
     source = source_metadata(stable=True)
     exact_urls = verify_exact_version_json(exact_version_payload(source), source)
 
@@ -356,8 +356,7 @@ def test_stable_root_preserves_non_yanked_historical_files() -> None:
 
     payload = stable_project_payload()
     payload["releases"]["0.4.106"][0]["yanked"] = True
-    with pytest.raises(ProjectSurfaceError, match="historical release 0.4.106 must remain retained and non-yanked"):
-        verify_stable_project_json(payload, source, exact_urls)
+    assert verify_stable_project_json(payload, source, exact_urls) == ("0.4.105", "0.4.106")
 
 
 def test_prerelease_evidence_records_deferred_default_surface(

{durable_workflow-2.0.1 → durable_workflow-2.0.2}/tests/test_release_metadata.py

@@ -41,9 +41,9 @@ def test_worker_release_identity_matches_supported_server_and_protocol() -> None
     project = manifest["project"]
     release = manifest["tool"]["durable-workflow"]
 
-    assert project["version"] == "2.0.1"
+    assert project["version"] == "2.0.2"
     assert release["product-train"] == project["version"]
-    assert release["registry-version"] == "2.0.1"
+    assert release["registry-version"] == "2.0.2"
     assert release["supported-server-versions"] == "2.0.0"
     assert release["worker-protocol-version"] == PROTOCOL_VERSION == "1.19"
     assert release["durable-selection"] is True

durable_workflow-2.0.2/tests/test_workflow_result_timeout.py

@@ -0,0 +1,61 @@
+from unittest.mock import AsyncMock
+
+import pytest
+
+from durable_workflow import Client, WorkflowTimedOut
+from durable_workflow.client import WorkflowExecution, WorkflowHandle
+from durable_workflow.errors import WorkflowCancelled, WorkflowFailed, WorkflowTerminated
+
+
+def result_client(status: str, event_type: str, payload: dict) -> tuple[Client, WorkflowHandle]:
+    client = Client("https://unused.example")
+    client.describe_workflow = AsyncMock(
+        return_value=WorkflowExecution(
+            workflow_id="order", run_id="current-run", workflow_type="order", status=status,
+        )
+    )
+    client.get_history = AsyncMock(
+        return_value={"events": [{"event_type": event_type, "payload": payload}]}
+    )
+    return client, WorkflowHandle(client, workflow_id="order", run_id="selected-run", workflow_type="order")
+
+
+@pytest.mark.parametrize("kind", ["execution_timeout", "run_timeout"])
+async def test_persisted_deadline_raises_typed_timeout_for_selected_history(kind: str) -> None:
+    client, handle = result_client(
+        "failed", "WorkflowTimedOut", {"timeout_kind": kind, "deadline_at": "2026-01-01T00:00:00Z"},
+    )
+    try:
+        with pytest.raises(WorkflowTimedOut, match="workflow execution timed out"):
+            await client.get_result(handle, timeout=0)
+        client.get_history.assert_awaited_once_with("order", "selected-run")
+    finally:
+        await client.aclose()
+
+
+async def test_polling_timeout_is_not_a_terminal_workflow_timeout() -> None:
+    client, handle = result_client("waiting", "ConditionWaitOpened", {})
+    try:
+        with pytest.raises(TimeoutError, match="not terminal") as caught:
+            await client.get_result(handle, timeout=0)
+        assert not isinstance(caught.value, WorkflowTimedOut)
+        client.get_history.assert_not_awaited()
+    finally:
+        await client.aclose()
+
+
+@pytest.mark.parametrize(
+    ("status", "event_type", "exception"),
+    [
+        ("failed", "WorkflowFailed", WorkflowFailed),
+        ("cancelled", "WorkflowCancelled", WorkflowCancelled),
+        ("terminated", "WorkflowTerminated", WorkflowTerminated),
+    ],
+)
+async def test_other_terminal_failures_preserve_their_exception(status, event_type, exception) -> None:
+    client, handle = result_client(status, event_type, {"message": "stopped", "reason": "stopped"})
+    try:
+        with pytest.raises(exception, match="stopped"):
+            await client.get_result(handle, timeout=0)
+    finally:
+        await client.aclose()