vention-state-machine 0.4__py3-none-any.whl → 0.4.2__py3-none-any.whl

state_machine/core.py

@@ -58,19 +58,12 @@ class StateMachine(HierarchicalGraphMachine):
     ) -> None:
         # Normalize state definitions
         if is_state_container(states):
-            state_groups = [
-                value
-                for value in vars(states).values()
-                if isinstance(value, StateGroup)
-            ]
+            state_groups = [value for value in vars(states).values() if isinstance(value, StateGroup)]
             resolved_states = [group.to_state_list()[0] for group in state_groups]
         elif isinstance(states, list):
             resolved_states = states
         else:
-            raise TypeError(
-                f"`states` must be either a StateGroup container or a list of state dicts. "
-                f"Got: {type(states).__name__}"
-            )
+            raise TypeError(f"`states` must be either a StateGroup container or a list of state dicts. " f"Got: {type(states).__name__}")
 
         self._declared_states: list[dict[str, Any]] = resolved_states
 
@@ -95,9 +88,7 @@ class StateMachine(HierarchicalGraphMachine):
         self._timeouts: dict[str, asyncio.Task[Any]] = {}
         self._last_state: Optional[str] = None
         self._enable_recovery: bool = enable_last_state_recovery
-        self._history: deque[dict[str, Any]] = deque(
-            maxlen=history_size or self.DEFAULT_HISTORY_SIZE
-        )
+        self._history: deque[dict[str, Any]] = deque(maxlen=history_size or self.DEFAULT_HISTORY_SIZE)
         self._current_start: Optional[datetime] = None
         self._guard_conditions: dict[str, List[Callable[[], bool]]] = {}
         self._state_change_callbacks: List[Callable[[str, str, str], None]] = []
@@ -110,9 +101,7 @@ class StateMachine(HierarchicalGraphMachine):
             BaseStates.FAULT.value,
             before="cancel_tasks",
         )
-        self.add_transition(
-            BaseTriggers.RESET.value, BaseStates.FAULT.value, BaseStates.READY.value
-        )
+        self.add_transition(BaseTriggers.RESET.value, BaseStates.FAULT.value, BaseStates.READY.value)
         self._attach_after_hooks()
         self._add_guard_conditions_to_transitions()
 
@@ -137,9 +126,7 @@ class StateMachine(HierarchicalGraphMachine):
             except asyncio.CancelledError:
                 pass
 
-    def set_timeout(
-        self, state_name: str, seconds: float, trigger_fn: Callable[[], str]
-    ) -> None:
+    def set_timeout(self, state_name: str, seconds: float, trigger_fn: Callable[[], str]) -> None:
         """
         Schedule a timeout: if `state_name` remains active after `seconds`, fire `trigger_fn()`.
         """
@@ -191,9 +178,7 @@ class StateMachine(HierarchicalGraphMachine):
         """Get the last `n` history entries."""
         return list(self._history)[-n:] if n > 0 else []
 
-    def add_transition_condition(
-        self, trigger_name: str, condition_fn: Callable[[], bool]
-    ) -> None:
+    def add_transition_condition(self, trigger_name: str, condition_fn: Callable[[], bool]) -> None:
         """
         Add a guard condition to a transition trigger.
         Multiple conditions can be added for the same trigger - ALL must pass for the transition to be allowed.
@@ -202,9 +187,7 @@ class StateMachine(HierarchicalGraphMachine):
             self._guard_conditions[trigger_name] = []
         self._guard_conditions[trigger_name].append(condition_fn)
 
-    def add_state_change_callback(
-        self, callback: Callable[[str, str, str], None]
-    ) -> None:
+    def add_state_change_callback(self, callback: Callable[[str, str, str], None]) -> None:
         """
         Add a callback that fires on any state change.
 

state_machine/decorator_manager.py

@@ -38,14 +38,10 @@ class DecoratorManager:
     def _discover_state_callbacks(self, callback_fn: Any) -> None:
         """Discover on_enter_state and on_exit_state decorators."""
         if hasattr(callback_fn, "_on_enter_state"):
-            self._decorator_bindings.append(
-                (callback_fn._on_enter_state, "enter", callback_fn)
-            )
+            self._decorator_bindings.append((callback_fn._on_enter_state, "enter", callback_fn))
 
         if hasattr(callback_fn, "_on_exit_state"):
-            self._exit_decorator_bindings.append(
-                (callback_fn._on_exit_state, "exit", callback_fn)
-            )
+            self._exit_decorator_bindings.append((callback_fn._on_exit_state, "exit", callback_fn))
 
     def _discover_guard_conditions(self, callback_fn: Any) -> None:
         """Discover guard decorators."""
@@ -70,9 +66,7 @@ class DecoratorManager:
 
     def _bind_state_callbacks(self, instance: Any) -> None:
         """Bind state entry/exit callbacks."""
-        for state_name, hook_type, callback_fn in (
-            self._decorator_bindings + self._exit_decorator_bindings
-        ):
+        for state_name, hook_type, callback_fn in self._decorator_bindings + self._exit_decorator_bindings:
             bound_fn = callback_fn.__get__(instance)
 
             if hook_type == "enter" and hasattr(callback_fn, "_timeout_config"):

state_machine/decorators.py

@@ -54,9 +54,7 @@ def on_exit_state(
     return decorator
 
 
-def auto_timeout(
-    seconds: float, trigger: Union[str, Callable[[], str]] = "to_fault"
-) -> Callable[[CallableType], CallableType]:
+def auto_timeout(seconds: float, trigger: Union[str, Callable[[], str]] = "to_fault") -> Callable[[CallableType], CallableType]:
     """
     Decorator that applies an auto-timeout configuration to a state entry handler.
     """
@@ -90,11 +88,7 @@ def guard(
             guard_fn._guard_conditions = {}
 
         for trigger in triggers:
-            trigger_name = (
-                getattr(trigger, "name", trigger)
-                if hasattr(trigger, "name")
-                else trigger
-            )
+            trigger_name = getattr(trigger, "name", trigger) if hasattr(trigger, "name") else trigger
             if not isinstance(trigger_name, str):
                 raise TypeError(f"Expected a Trigger or str, got {type(trigger)}")
 

state_machine/defs.py

@@ -88,9 +88,7 @@ class Trigger:
     def __call__(self) -> str:
         return self.name
 
-    def transition(
-        self, source: Union[str, State], dest: Union[str, State]
-    ) -> Dict[str, str]:
+    def transition(self, source: Union[str, State], dest: Union[str, State]) -> Dict[str, str]:
         """
         Build {"trigger": self.name, "source": <src>, "dest": <dst>}.
         `source` / `dest` may be raw strings or StateKey instances.

state_machine/machine_protocols.py

@@ -2,9 +2,7 @@ from typing import Protocol, Callable, Any
 
 
 class SupportsTimeout(Protocol):
-    def set_timeout(
-        self, state_name: str, seconds: float, trigger_fn: Callable[[], str]
-    ) -> None: ...
+    def set_timeout(self, state_name: str, seconds: float, trigger_fn: Callable[[], str]) -> None: ...
 
 
 class SupportsStateCallbacks(Protocol):
@@ -12,15 +10,11 @@ class SupportsStateCallbacks(Protocol):
 
 
 class SupportsGuardConditions(Protocol):
-    def add_transition_condition(
-        self, trigger_name: str, condition_fn: Callable[[], bool]
-    ) -> None: ...
+    def add_transition_condition(self, trigger_name: str, condition_fn: Callable[[], bool]) -> None: ...
 
 
 class SupportsStateChangeCallbacks(Protocol):
-    def add_state_change_callback(
-        self, callback: Callable[[str, str, str], None]
-    ) -> None: ...
+    def add_state_change_callback(self, callback: Callable[[str, str, str], None]) -> None: ...
 
 
 class StateMachineProtocol(

state_machine/utils.py

@@ -48,11 +48,8 @@ def is_state_container(state_source: object) -> bool:
     Return True if `obj` is an instance or class that contains StateGroup(s).
     """
     try:
-        return any(
-            isinstance(value, StateGroup) for value in vars(state_source).values()
-        ) or any(
-            isinstance(value, StateGroup)
-            for value in vars(state_source.__class__).values()
+        return any(isinstance(value, StateGroup) for value in vars(state_source).values()) or any(
+            isinstance(value, StateGroup) for value in vars(state_source.__class__).values()
         )
     except TypeError:
         return False

state_machine/vention_communication.py

@@ -116,10 +116,7 @@ def build_state_machine_rpc_bundle(
             if trigger_name not in allowed:
                 raise ConnectError(
                     code="failed_precondition",
-                    message=(
-                        f"Trigger '{trigger_name}' cannot run from '{current}'. "
-                        f"Allowed: {sorted(allowed)}"
-                    ),
+                    message=(f"Trigger '{trigger_name}' cannot run from '{current}'. " f"Allowed: {sorted(allowed)}"),
                 )
 
             # Fetch bound trigger method

{vention_state_machine-0.4.0.dist-info → vention_state_machine-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vention-state-machine
-Version: 0.4.0
+Version: 0.4.2
 Summary: Declarative state machine framework for machine apps
 License: Proprietary
 Author: VentionCo
@@ -8,12 +8,28 @@ Requires-Python: >=3.10,<3.11
 Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
-Requires-Dist: asyncio (>=3.4.3,<4.0.0)
-Requires-Dist: coverage (>=7.10.1,<8.0.0)
-Requires-Dist: graphviz (>=0.21,<0.22)
-Requires-Dist: transitions (>=0.9.3,<0.10.0)
-Requires-Dist: uvicorn (>=0.35.0,<0.36.0)
-Requires-Dist: vention-communication (>=0.2.2,<0.3.0)
+Requires-Dist: annotated-doc (==0.0.4) ; python_version == "3.10"
+Requires-Dist: annotated-types (==0.7.0) ; python_version == "3.10"
+Requires-Dist: anyio (==4.11.0) ; python_version == "3.10"
+Requires-Dist: asyncio (==3.4.3) ; python_version == "3.10"
+Requires-Dist: click (==8.1.8) ; python_version == "3.10"
+Requires-Dist: colorama (==0.4.6) ; python_version == "3.10" and platform_system == "Windows"
+Requires-Dist: coverage (==7.10.7) ; python_version == "3.10"
+Requires-Dist: exceptiongroup (==1.3.0) ; python_version == "3.10"
+Requires-Dist: fastapi (==0.121.1) ; python_version == "3.10"
+Requires-Dist: graphviz (==0.21) ; python_version == "3.10"
+Requires-Dist: h11 (==0.16.0) ; python_version == "3.10"
+Requires-Dist: idna (==3.11) ; python_version == "3.10"
+Requires-Dist: pydantic (==2.12.3) ; python_version == "3.10"
+Requires-Dist: pydantic-core (==2.41.4) ; python_version == "3.10"
+Requires-Dist: six (==1.17.0) ; python_version == "3.10"
+Requires-Dist: sniffio (==1.3.1) ; python_version == "3.10"
+Requires-Dist: starlette (==0.48.0) ; python_version == "3.10"
+Requires-Dist: transitions (==0.9.3) ; python_version == "3.10"
+Requires-Dist: typing-extensions (==4.15.0) ; python_version == "3.10"
+Requires-Dist: typing-inspection (==0.4.2) ; python_version == "3.10"
+Requires-Dist: uvicorn (==0.35.0) ; python_version == "3.10"
+Requires-Dist: vention-communication (==0.3.0) ; python_version == "3.10"
 Description-Content-Type: text/markdown
 
 # vention-state-machine

vention_state_machine-0.4.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+state_machine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+state_machine/core.py,sha256=w0dmNx2MUCGSwVOs6Y9dGiHuRVNn7lWYskYtm1zpo4g,11007
+state_machine/decorator_manager.py,sha256=rKyDKFMh-NmOrYntVwQNslSmW5Ac85BPzo0CXwe2Ixs,4336
+state_machine/decorator_protocols.py,sha256=E6_xflTPxxTqDBa4Dj4p3OdPvR_EW0jA3PAjHTDlG8c,485
+state_machine/decorators.py,sha256=mqlbbZ59d-eeRCmidbkFKGcjN4KPlF7l0Z6nEJwvt_Y,3598
+state_machine/defs.py,sha256=RrM5SVgptfPZNu-AeRN56lk8QVRT1Uwot2xCx3SJpPo,2822
+state_machine/machine_protocols.py,sha256=Q_rjlFTGrf3EvCndY4SWfurFNdJg4hB3qZkM0ISQxXI,784
+state_machine/utils.py,sha256=1b54DZPv7s6hK0ud2KT4k1s1R1Li7wFUowKGTwMwxfw,2361
+state_machine/vention_communication.py,sha256=Ggg4FvQzruHfpNJmPtDmdZM46w0JwH-BATDtsCS6T_I,5460
+vention_state_machine-0.4.2.dist-info/METADATA,sha256=kb6qjgj-Ckjr8eBgn71n5AAqUuiUSvy3iY4vX68_A4k,12827
+vention_state_machine-0.4.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+vention_state_machine-0.4.2.dist-info/RECORD,,

vention_state_machine-0.4.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-state_machine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-state_machine/core.py,sha256=lAiGGPtWCiYQPCh1iz3P26YFrz8VvveIGlL5k2AFvKs,11201
-state_machine/decorator_manager.py,sha256=uHhbtR1vS7idcn4kJsaNtJ1Z_7kiHf9YVa_cxkb-WNk,4420
-state_machine/decorator_protocols.py,sha256=E6_xflTPxxTqDBa4Dj4p3OdPvR_EW0jA3PAjHTDlG8c,485
-state_machine/decorators.py,sha256=V-KBJ6fSvINi7JHN_VmrQLTnOxGPy5iRV5QzXLKwWDw,3668
-state_machine/defs.py,sha256=eYtkTqRMm89ZHFKs3p7H3HyGNZbrOnoCzAJbSeMxSDg,2836
-state_machine/machine_protocols.py,sha256=Yxs4aw2-NJ1RluygbthsquVKn35-xMYae7PB7xlqQmE,826
-state_machine/utils.py,sha256=3eWL63_RAk_Jijh0ZIArBsUF3A7f0vQmwTjDRwRvpIs,2395
-state_machine/vention_communication.py,sha256=BZjHC1SsXFqLiSpX0ChCEGfhkEeitpXmLClZCQIgOrA,5530
-vention_state_machine-0.4.0.dist-info/METADATA,sha256=UlROQZDnqaO5j0AbfJJ2KofpSrrr_woWR8xPWbJY35c,11671
-vention_state_machine-0.4.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-vention_state_machine-0.4.0.dist-info/RECORD,,