vention-state-machine 0.4__tar.gz → 0.4.4__tar.gz

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vention-state-machine
-Version: 0.4
+Version: 0.4.4
 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.4/pyproject.toml

@@ -0,0 +1,130 @@
+[tool.poetry]
+name = "vention-state-machine"
+version = "0.4.4"
+description = "Declarative state machine framework for machine apps"
+authors = [ "VentionCo" ]
+readme = "README.md"
+license = "Proprietary"
+
+  [[tool.poetry.packages]]
+  include = "state_machine"
+  from = "src"
+
+  [tool.poetry.build]
+  generate-setup-file = false
+
+  [tool.poetry.dependencies]
+  python = ">=3.10,<3.11"
+
+    [tool.poetry.dependencies.annotated-doc]
+    version = "0.0.4"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.annotated-types]
+    version = "0.7.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.anyio]
+    version = "4.11.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.asyncio]
+    version = "3.4.3"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.click]
+    version = "8.1.8"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.colorama]
+    version = "0.4.6"
+    markers = 'python_version == "3.10" and platform_system == "Windows"'
+    optional = false
+
+    [tool.poetry.dependencies.coverage]
+    version = "7.10.7"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.exceptiongroup]
+    version = "1.3.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.fastapi]
+    version = "0.121.1"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.graphviz]
+    version = "0.21"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.h11]
+    version = "0.16.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.idna]
+    version = "3.11"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.pydantic-core]
+    version = "2.41.4"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.pydantic]
+    version = "2.12.3"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.six]
+    version = "1.17.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.sniffio]
+    version = "1.3.1"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.starlette]
+    version = "0.48.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.transitions]
+    version = "0.9.3"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.typing-extensions]
+    version = "4.15.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.typing-inspection]
+    version = "0.4.2"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.uvicorn]
+    version = "0.35.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+    [tool.poetry.dependencies.vention-communication]
+    version = "0.3.0"
+    markers = 'python_version == "3.10"'
+    optional = false
+
+[tool.poetry.group.dev]
+dependencies = { }

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/src/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.
 

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/src/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"):

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/src/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)}")
 

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/src/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.

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/src/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(

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/src/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

{vention_state_machine-0.4 → vention_state_machine-0.4.4}/src/state_machine/vention_communication.py

@@ -15,11 +15,11 @@ from state_machine.utils import (
 )
 
 
-__all__ = ["build_state_machine_bundle"]
+__all__ = ["build_state_machine_rpc_bundle"]
 
 
-def build_state_machine_bundle(
-    sm: StateMachine,
+def build_state_machine_rpc_bundle(
+    state_machine: StateMachine,
     *,
     include_state_actions: bool = True,
     include_history_action: bool = True,
@@ -44,8 +44,8 @@ def build_state_machine_bundle(
     if include_state_actions:
 
         async def get_state() -> StateResponse:
-            last = getattr(sm, "get_last_state", lambda: None)()
-            return StateResponse(state=sm.state, last_state=last)
+            last = getattr(state_machine, "get_last_state", lambda: None)()
+            return StateResponse(state=state_machine.state, last_state=last)
 
         bundle.actions.append(
             ActionEntry(
@@ -62,17 +62,15 @@ def build_state_machine_bundle(
     if include_history_action:
 
         async def get_history() -> HistoryResponse:
-            raw = getattr(sm, "history", [])
+            raw = getattr(state_machine, "history", [])
             out = []
 
             for item in raw:
                 if isinstance(item, dict):
-                    # Handle dict items from history
                     state_str = str(item.get("state", ""))
                     duration_ms: Optional[int] = item.get("duration_ms")
                     if duration_ms is not None and not isinstance(duration_ms, int):
                         duration_ms = None
-                    # Add timestamp if present, otherwise use current time
                     timestamp: datetime
                     if "timestamp" in item and isinstance(item["timestamp"], datetime):
                         timestamp = item["timestamp"]
@@ -86,7 +84,6 @@ def build_state_machine_bundle(
                         )
                     )
                 else:
-                    # Handle simple state strings
                     out.append(HistoryEntry(state=str(item), timestamp=datetime.now()))
 
             return HistoryResponse(history=out, buffer_size=len(raw))
@@ -103,8 +100,8 @@ def build_state_machine_bundle(
     # ======================================================
     # Triggers
     # ======================================================
-    # Source of truth: transitions registered on SM
-    all_triggers = sorted(sm.events.keys())
+    # Source of truth: transitions registered on state machine
+    all_triggers = sorted(state_machine.events.keys())
     selected = all_triggers if triggers is None else list(triggers)
 
     # ---------- factory function (fixes closure bug) ----------
@@ -112,22 +109,19 @@ def build_state_machine_bundle(
         trigger_name: str,
     ) -> Callable[[], Coroutine[Any, Any, TriggerResponse]]:
         async def trigger_call() -> TriggerResponse:
-            current = sm.state
-            allowed = sm.get_triggers(current)
+            current = state_machine.state
+            allowed = state_machine.get_triggers(current)
 
             # Precondition error if invalid in current state
             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
             try:
-                method = getattr(sm, trigger_name)
+                method = getattr(state_machine, trigger_name)
             except AttributeError as e:
                 raise ConnectError(
                     code="internal",
@@ -148,7 +142,7 @@ def build_state_machine_bundle(
             return TriggerResponse(
                 result=trigger_name,
                 previous_state=current,
-                new_state=sm.state,
+                new_state=state_machine.state,
             )
 
         return trigger_call

vention_state_machine-0.4/pyproject.toml

@@ -1,21 +0,0 @@
-[tool.poetry]
-name = "vention-state-machine"
-version = "0.4"
-description = "Declarative state machine framework for machine apps"
-authors = [ "VentionCo" ]
-readme = "README.md"
-license = "Proprietary"
-packages = [{ include = "state_machine", from = "src" }]
-
-[tool.poetry.dependencies]
-asyncio = "^3.4.3"
-python = ">=3.10,<3.11"
-uvicorn = "^0.35.0"
-transitions = "^0.9.3"
-graphviz = "^0.21"
-coverage = "^7.10.1"
-vention-communication = "^0.2.2"
-
-[tool.poetry.group.dev.dependencies]
-pytest = "^8.3.4"
-ruff = "^0.8.0"