dex-python-sdk 1.2.0__tar.gz → 1.2.1__tar.gz

{dex_python_sdk-1.2.0 → dex_python_sdk-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dex-python-sdk
-Version: 1.2.0
+Version: 1.2.1
 Requires-Dist: grpcio>=1.83.0
 Requires-Dist: grpcio-status>=1.83.0
 Requires-Dist: protobuf>=7.35.1

{dex_python_sdk-1.2.0 → dex_python_sdk-1.2.1}/dex/__init__.py

@@ -70,7 +70,7 @@ from dex.runtime_errors import (
     FlowAlreadyStartedError,
     FlowDefinitionError,
     FlowErrorType,
-    FlowNotActiveError,
+    FlowNotActiveOrNotFoundError,
     FlowNotFoundError,
     InvalidStepResultError,
     LongPollTimeoutError,
@@ -156,7 +156,7 @@ __all__ = [
     "FlowErrorType",
     "FlowInfo",
     "FlowResult",
-    "FlowNotActiveError",
+    "FlowNotActiveOrNotFoundError",
     "FlowNotFoundError",
     "FlowStatus",
     "FlowTimeoutHandlerOptions",

{dex_python_sdk-1.2.0 → dex_python_sdk-1.2.1}/dex/_grpc_errors.py

@@ -23,7 +23,7 @@ from dex.runtime_errors import (
     DexServiceError,
     ErrorSubStatus,
     FlowAlreadyStartedError,
-    FlowNotActiveError,
+    FlowNotActiveOrNotFoundError,
     FlowNotFoundError,
     LongPollTimeoutError,
     RequestTimeoutError,
@@ -129,7 +129,7 @@ def translate_rpc_error(
         if requirement == "existing":
             return FlowNotFoundError(*parameters)
         if requirement == "active":
-            return FlowNotActiveError(*parameters)
+            return FlowNotActiveOrNotFoundError(*parameters)
         return DexServiceError(*parameters)
     if sub_status is ErrorSubStatus.WORKER_API_ERROR:
         if code is grpc.StatusCode.ABORTED:

{dex_python_sdk-1.2.0 → dex_python_sdk-1.2.1}/dex/async_client.py

@@ -283,8 +283,9 @@ class AsyncClient:
             RpcLockConflictError: If Attribute locks cannot be acquired.
             WorkerInvocationError: If the application handler fails.
             ValueMappingError: If input or output mapping fails.
-            DexServiceError: If the selected path requires an active execution or the
-                service call otherwise fails.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or the selected path
+                cannot use its closed execution.
+            DexServiceError: If the service call otherwise fails.
         """
         registered_flow, rpc = self.registry._rpc_for_method(rpc_method)
         (
@@ -566,7 +567,7 @@ class AsyncClient:
             options: Stop mode and optional recorded reason.
 
         Raises:
-            FlowNotActiveError: If no active run exists.
+            FlowNotActiveOrNotFoundError: If no active run exists.
             DexServiceError: If FlowService rejects or cannot perform the request.
         """
         await self._call(
@@ -747,7 +748,7 @@ class AsyncClient:
             timer_id: Exactly one Timer condition ID or zero-based index.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If an identifier is invalid.
             DexServiceError: If FlowService cannot skip the Timer.
         """
@@ -787,7 +788,7 @@ class AsyncClient:
         Raises:
             ValueError: If the Request ID or request timeout is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         request_budget = _ClientRequestBudget(options.request_timeout)
@@ -858,7 +859,7 @@ class AsyncClient:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -890,7 +891,7 @@ class AsyncClient:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -920,7 +921,7 @@ class AsyncClient:
             TypeError: If arguments do not match the Attribute definition.
             ValueError: If an identifier, option, or expected value is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         instance, match, options = self._attribute_wait_arguments(
@@ -1000,7 +1001,7 @@ class AsyncClient:
             config: New optional fields applied to later decisions.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If a configuration value is invalid.
             DexServiceError: If FlowService cannot apply the update.
         """
@@ -1024,7 +1025,7 @@ class AsyncClient:
             flow_id: The non-empty active Flow ID.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             DexServiceError: If FlowService cannot accept the request.
         """
         await self._call(

{dex_python_sdk-1.2.0 → dex_python_sdk-1.2.1}/dex/client.py

@@ -282,8 +282,9 @@ class Client:
             RpcLockConflictError: If requested Attribute locks cannot be acquired.
             WorkerInvocationError: If the application handler fails.
             ValueMappingError: If input or output mapping fails.
-            DexServiceError: If the selected path requires an active execution or the
-                service call otherwise fails.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or the selected path
+                cannot use its closed execution.
+            DexServiceError: If the service call otherwise fails.
         """
         registered_flow, rpc = self.registry._rpc_for_method(rpc_method)
         (
@@ -566,7 +567,7 @@ class Client:
             options: Stop mode and optional recorded reason.
 
         Raises:
-            FlowNotActiveError: If no active run exists.
+            FlowNotActiveOrNotFoundError: If no active run exists.
             DexServiceError: If FlowService rejects or cannot perform the request.
         """
         self._call(
@@ -745,7 +746,7 @@ class Client:
             timer_id: Exactly one Timer condition ID or zero-based index.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If an identifier is invalid.
             DexServiceError: If FlowService cannot skip the Timer.
         """
@@ -783,7 +784,7 @@ class Client:
         Raises:
             ValueError: If the Request ID or request timeout is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         request_budget = _ClientRequestBudget(options.request_timeout)
@@ -854,7 +855,7 @@ class Client:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -887,7 +888,7 @@ class Client:
         Raises:
             ValueError: If an identifier, option, or match operand is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         ...
@@ -917,7 +918,7 @@ class Client:
             TypeError: If arguments do not match the Attribute definition.
             ValueError: If an identifier, option, or expected value is invalid.
             RequestTimeoutError: If a positive request timeout expires first.
-            FlowNotActiveError: If the Flow closes first.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closes first.
             DexServiceError: If FlowService cannot perform the wait.
         """
         instance, match, options = self._attribute_wait_arguments(
@@ -1000,7 +1001,7 @@ class Client:
             config: The new optional configuration fields.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             ValueError: If a configuration value is invalid.
             DexServiceError: If FlowService cannot apply the update.
         """
@@ -1025,7 +1026,7 @@ class Client:
             flow_id: The non-empty active Flow ID.
 
         Raises:
-            FlowNotActiveError: If the Flow is closed.
+            FlowNotActiveOrNotFoundError: If the Flow is missing or closed.
             DexServiceError: If FlowService cannot accept the request.
         """
         self._call(

{dex_python_sdk-1.2.0 → dex_python_sdk-1.2.1}/dex/runtime_errors.py

@@ -104,8 +104,25 @@ class FlowNotFoundError(DexServiceError):
     pass
 
 
-class FlowNotActiveError(DexServiceError):
-    """Indicate that an operation requires an active but already closed Flow."""
+class FlowNotActiveOrNotFoundError(DexServiceError):
+    """Report a missing Flow or an operation that cannot use a closed Flow.
+
+    RPC calls use this error for missing targets, including query-only reads.
+    A query-only RPC can read a retained terminal execution when it has no
+    locks, transactionality, durable effects, or Server-forced Update routing.
+    At that confirmed read boundary, handle this error as not found without
+    adding a lifecycle probe. Preserve other service and Worker failures.
+
+    Mutations and active-only RPCs also use this error for closed targets.
+    The error does not distinguish a missing Flow from a closed Flow or prove
+    that the requested action succeeded. The inherited service metadata and
+    chained transport cause remain available. For example::
+
+        try:
+            client.invoke_rpc(orders.update_order, order_id, update)
+        except FlowNotActiveOrNotFoundError:
+            raise OrderUnavailableError(order_id)
+    """
 
     pass
 

{dex_python_sdk-1.2.0 → dex_python_sdk-1.2.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "dex-python-sdk"
 # Publish uses tag sdk-python/v*; CI stamps this for release builds.
-version = "1.2.0"
+version = "1.2.1"
 description = "Python SDK for the Dex workflow engine"
 authors = [{name = "Super Durable"}]
 readme = "README.md"