dex-python-sdk 0.2.10__tar.gz → 0.2.11__tar.gz

{dex_python_sdk-0.2.10 → dex_python_sdk-0.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dex-python-sdk
-Version: 0.2.10
+Version: 0.2.11
 Requires-Dist: grpcio>=1.83.0
 Requires-Dist: grpcio-status>=1.83.0
 Requires-Dist: protobuf>=7.35.1
@@ -49,7 +49,8 @@ def snapshot(self, context: dex.Context) -> dex.RPCResult[Snapshot]:
 Put an AttributeMap or ChannelMap directly in its plural load option when every
 current instance is needed. Use the singular instance options for the less common
 exact-instance case. A selected empty queue returns an empty tuple; reading an
-unselected map entry or pending-message snapshot raises **StateNotLoadedError**.
+unselected map entry raises **AttributeMapNotLoadedError**. An unselected pending-message
+snapshot raises **ChannelMessagesNotLoadedError**.
 Pending messages preserve FIFO order and include the server-assigned message ID.
 The snapshot does not change after the handler stages a publish or deletion.
 

{dex_python_sdk-0.2.10 → dex_python_sdk-0.2.11}/README.md

@@ -33,7 +33,8 @@ def snapshot(self, context: dex.Context) -> dex.RPCResult[Snapshot]:
 Put an AttributeMap or ChannelMap directly in its plural load option when every
 current instance is needed. Use the singular instance options for the less common
 exact-instance case. A selected empty queue returns an empty tuple; reading an
-unselected map entry or pending-message snapshot raises **StateNotLoadedError**.
+unselected map entry raises **AttributeMapNotLoadedError**. An unselected pending-message
+snapshot raises **ChannelMessagesNotLoadedError**.
 Pending messages preserve FIFO order and include the server-assigned message ID.
 The snapshot does not change after the handler stages a publish or deletion.
 

{dex_python_sdk-0.2.10 → dex_python_sdk-0.2.11}/dex/__init__.py

@@ -62,6 +62,8 @@ from dex.flow_result import FlowResult, StepCompletion
 from dex.runtime_errors import (
     DexServiceError,
     ErrorSubStatus,
+    AttributeMapNotLoadedError,
+    ChannelMessagesNotLoadedError,
     FlowAlreadyStartedError,
     FlowDefinitionError,
     FlowErrorType,
@@ -71,7 +73,6 @@ from dex.runtime_errors import (
     LongPollTimeoutError,
     ChannelMessageNotFoundError,
     RpcLockConflictError,
-    StateNotLoadedError,
     ValueMappingError,
     WorkerInvocationError,
 )
@@ -119,6 +120,7 @@ __all__ = [
     "AttributeLock",
     "AttributeMap",
     "AttributeMapLoad",
+    "AttributeMapNotLoadedError",
     "AsyncContext",
     "AsyncClient",
     "AsyncBufferedTextStream",
@@ -131,6 +133,7 @@ __all__ = [
     "ChannelMapLoad",
     "ChannelMessage",
     "ChannelMessageNotFoundError",
+    "ChannelMessagesNotLoadedError",
     "Client",
     "ClientOptions",
     "Codec",
@@ -160,7 +163,6 @@ __all__ = [
     "RPCResult",
     "RetryAfterError",
     "RpcLockConflictError",
-    "StateNotLoadedError",
     "Registry",
     "TimeTravelOptions",
     "TimeTravelStepMethod",

{dex_python_sdk-0.2.10 → dex_python_sdk-0.2.11}/dex/_invocation_context.py

@@ -20,7 +20,10 @@ from dex.codec import Codec
 from dex.dexpb import dex_pb2 as pb
 from dex.flow import Registry, _RegisteredFlow
 from dex.flow_result import FlowResult, flow_result_from_proto
-from dex.runtime_errors import StateNotLoadedError
+from dex.runtime_errors import (
+    AttributeMapNotLoadedError,
+    ChannelMessagesNotLoadedError,
+)
 from dex.step import (
     _NO_HEARTBEAT_VALUE,
     StepOutput,
@@ -445,7 +448,7 @@ class InvocationContext:
             channel_name = self._physical_name(definition, instance)
             is_loaded = definition.name in self._loaded_channel_names
         if not is_loaded:
-            raise StateNotLoadedError(
+            raise ChannelMessagesNotLoadedError(
                 f"Channel messages were not loaded for RPC: {definition.name}"
             )
         values = self._loaded_channel_messages.get(channel_name)
@@ -495,7 +498,7 @@ class InvocationContext:
             f"{definition.name}/" not in self._loaded_attribute_map_instances
             and physical_name not in self._loaded_attribute_map_instances
         ):
-            raise StateNotLoadedError(
+            raise AttributeMapNotLoadedError(
                 f"AttributeMap instance was not loaded for RPC: {physical_name}"
             )
 
@@ -507,7 +510,7 @@ class InvocationContext:
             self._method is InvocationMethod.RPC
             and f"{definition.name}/" not in self._loaded_attribute_map_instances
         ):
-            raise StateNotLoadedError(
+            raise AttributeMapNotLoadedError(
                 f"all AttributeMap instances were not loaded for RPC: {definition.name}"
             )
 

{dex_python_sdk-0.2.10 → dex_python_sdk-0.2.11}/dex/channel.py

@@ -132,7 +132,7 @@ class Channel(Generic[ValueT]):
             Pending message IDs and decoded values in FIFO order.
 
         Raises:
-            StateNotLoadedError: If the RPC did not load this Channel.
+            ChannelMessagesNotLoadedError: If the RPC did not load this Channel's messages.
         """
         return cast(
             Sequence[ChannelMessage[ValueT]],
@@ -355,7 +355,7 @@ class ChannelMap(Generic[ValueT]):
             Pending message IDs and decoded values in FIFO order.
 
         Raises:
-            StateNotLoadedError: If the RPC did not load this ChannelMap.
+            ChannelMessagesNotLoadedError: If the RPC did not load this ChannelMap's messages.
         """
         return cast(
             Sequence[ChannelMessage[ValueT]],

{dex_python_sdk-0.2.10 → dex_python_sdk-0.2.11}/dex/runtime_errors.py

@@ -175,8 +175,14 @@ class FlowDefinitionError(RuntimeError):
     pass
 
 
-class StateNotLoadedError(RuntimeError):
-    """Indicate that an RPC read state omitted from its load configuration."""
+class AttributeMapNotLoadedError(RuntimeError):
+    """Indicate that an RPC did not load the requested AttributeMap entries."""
+
+    pass
+
+
+class ChannelMessagesNotLoadedError(RuntimeError):
+    """Indicate that an RPC did not load the requested pending Channel messages."""
 
     pass
 

{dex_python_sdk-0.2.10 → dex_python_sdk-0.2.11}/pyproject.toml

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