python-statemachine 3.1.1__py3-none-any.whl → 3.2.0__py3-none-any.whl

{python_statemachine-3.1.1.dist-info → python_statemachine-3.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-statemachine
-Version: 3.1.1
+Version: 3.2.0
 Summary: Python Finite State Machines made easy.
 Project-URL: homepage, https://github.com/fgmacedo/python-statemachine
 Author-email: Fernando Macedo <fgmacedo@gmail.com>
@@ -13,7 +13,6 @@ Classifier: Framework :: Django
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -21,9 +20,16 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Home Automation
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Provides-Extra: diagrams
 Requires-Dist: pydot>=4.0.1; extra == 'diagrams'
+Provides-Extra: io
+Requires-Dist: jsonschema>=4.18; extra == 'io'
+Requires-Dist: pyyaml>=6.0; extra == 'io'
+Provides-Extra: validation
+Requires-Dist: jsonschema>=4.18; extra == 'validation'
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0; extra == 'yaml'
 Description-Content-Type: text/markdown
 
 # Python StateMachine
@@ -400,6 +406,13 @@ To generate diagrams, install with the `diagrams` extra (requires
 pip install python-statemachine[diagrams]
 ```
 
+To load statecharts from declarative documents, install the IO extras
+(`yaml` for YAML, `validation` for `validate=True`, or `io` for both):
+
+```
+pip install python-statemachine[io]
+```
+
 
 ## Contributing
 

python_statemachine-3.2.0.dist-info/RECORD

@@ -0,0 +1,72 @@
+statemachine/__init__.py,sha256=QiHL_KGtaPxEuPtKCpwb6DssApC1jcalKYrkfNgMKc4,445
+statemachine/callbacks.py,sha256=LKX9GnDhN64yYh2EvDEYNJg0-N61Kmyd0aqTZKxujM4,14526
+statemachine/configuration.py,sha256=MblvaBwEOyooYc4Vzo-qeryF9sEmx9mdtZDY0Gf_uRU,5991
+statemachine/dispatcher.py,sha256=DyRqwgr7gXom312BIPsNZiueq5n8jNp1dBDExm7mG_g,8109
+statemachine/event.py,sha256=hYVvsNpsY0-OSebwDEpxdLXadoJS_G5pmDe34hRqnFk,7645
+statemachine/event_data.py,sha256=7_hoE0cp-0uW71Kk3erO3eYM6anTT5X3slGMcehIGIo,3111
+statemachine/events.py,sha256=11GyX8GYpsSwvW0v1b4zHUGhzKRoqNjQYtuDj8NvqOM,1212
+statemachine/exceptions.py,sha256=N6iTrin-uMyw31mbXbO6FUj0V5WGvfKaNZe6L2pV0IE,1314
+statemachine/factory.py,sha256=qIgDxBwa5xa0lgvTaV4QPqdYqqkXZCzlSq0sX4TjZvo,14640
+statemachine/graph.py,sha256=ngQ31YAetfQLQvdBU5cHwLQcD-wJL92axPJ2sUeCu1g,1999
+statemachine/i18n.py,sha256=NLvGseaORmQ0G-V_J8tkjoxh_piWMOm2CI6mBQpLamc,362
+statemachine/invoke.py,sha256=5B7XNvBFnQaKByoYM1VbRlJvJyEwXn1C0QKUCaRjmpU,24908
+statemachine/mixins.py,sha256=8qxZZfBwVdFcr3oPFVWHGzgmAubH6VgQus5x3c6VEE0,1706
+statemachine/model.py,sha256=OylI3FjMiHpYyDl9mtK1zEJMeSvemaN4giQDonpc8kI,211
+statemachine/orderedset.py,sha256=7y4Hu6vVD0LHTSJ5iTB9F-faRw0326EubR3AOrpZAHE,2570
+statemachine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+statemachine/registry.py,sha256=TmHfVU7HgaG43slG5lh8EL-8237Fm8r2UkwDj8u-t0c,700
+statemachine/signature.py,sha256=-IiRYJScx4cDKny3ictQvHwQBbaCyxWpRKSgQksMT0E,9834
+statemachine/spec_parser.py,sha256=fjiUjtzTAk6UliNsdbeInqrnp38cfHeYVlgMrbqrzxc,13450
+statemachine/state.py,sha256=kSHeJh1BlSpeDPxMKCCpwIJqzx4MPdXYZ1S24kki4os,15426
+statemachine/statemachine.py,sha256=27TRypjsh3lwlAGZAwqrt-Cnka65uBoaxMWrU27gg6M,19941
+statemachine/states.py,sha256=NRHtATtb-2Ac2nwzSn5OfHwzOSxI2FLeNR8o1v84USs,4827
+statemachine/transition.py,sha256=JtGABHJ6inZrneI70bgu4ir2BZ2YQagcYX9l6TcsHSc,6912
+statemachine/transition_list.py,sha256=zZuGWB86fL2ux-orIE7CdeCcnhaS5p2njIy8h2SuyVY,4361
+statemachine/transition_mixin.py,sha256=i9ZLDGPgE2zIkTn7IAEMjscn1gnI-HJMtxX-YG447tY,3002
+statemachine/utils.py,sha256=taCgrsRDcQQLweyq607AVZyI0NMukRP-HGpO8TiVNgk,1527
+statemachine/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+statemachine/contrib/timeout.py,sha256=VXkdLpxNeUKihkbtLv8XTWdG-meQlSFtxJfcxXgV8Uw,2251
+statemachine/contrib/weighted.py,sha256=lzcopcY0EzjJb-N4APJJc7AlgZIPtthTbBizKaDtOIk,6787
+statemachine/contrib/diagram/__init__.py,sha256=mvTluFDnhE2OzTeOhyU7aQebl79LIOsvOiNFAVIldww,7730
+statemachine/contrib/diagram/__main__.py,sha256=iPpiz09xKqtAjrhONS99OYp6R2dQ6Anbhw1qPIN8ELo,80
+statemachine/contrib/diagram/extract.py,sha256=oNy67KToH7zxgEIPavOvgbpoYTSkM3iWB-Zas1_lcqY,9854
+statemachine/contrib/diagram/formatter.py,sha256=lYdBGO3VSZnM9OipyNsuA6StMEEjrRdnksm9MmzKXBA,4724
+statemachine/contrib/diagram/model.py,sha256=pn7dzrt8U8TOn4A-Jg1Rc3b1UUlTgs75WfR2x-xtEuc,1451
+statemachine/contrib/diagram/sphinx_ext.py,sha256=HcEXU-aYz8da02XPkZKpF5HDF0XPBGGg9FCz8MtI1C8,10338
+statemachine/contrib/diagram/renderers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+statemachine/contrib/diagram/renderers/dot.py,sha256=VkWMVP1DLl1YUEUZVmBVSNQVbAG516v3hQcK4PePWD8,19772
+statemachine/contrib/diagram/renderers/mermaid.py,sha256=3N1z0klonL768exBcWp3WLMuWUgCpRso2UhpdnvHYhY,13424
+statemachine/contrib/diagram/renderers/table.py,sha256=PLVfwTIZHtv7uK3smAfN1owAOEunkBRHyEkh5ygVcfw,3711
+statemachine/engines/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+statemachine/engines/async_.py,sha256=_n7x5IDu6bucBjE7PFdHBzYwrEcPd-iRxDfMc4FE9HI,22537
+statemachine/engines/base.py,sha256=kAgpDu8iTejPBXp_4casK_rQuHkL_G3Njph8iuXzDiw,37954
+statemachine/engines/sync.py,sha256=F_bt4z1KLLcFCP77E9SNWDJMWiMTexE0iOU2XAd_x5A,9153
+statemachine/io/__init__.py,sha256=i5rGVI1ETu1hH0W8qtQMqK0WrFCYLPdV-s5VXh9vOSo,2062
+statemachine/io/actions.py,sha256=FmRjPFJkcQwtxSEaOXbvu3S5vETai2j5r8mC_4eZ8Og,18624
+statemachine/io/builder.py,sha256=yNaQrtFfbs55uRd-loZ-Vs5061liwM-np-B_2ZuJO1I,8350
+statemachine/io/class_factory.py,sha256=H8zxsfrjLw7L_X2g2hoXb2CjpHxTftsoBmPBWIcen-4,9557
+statemachine/io/evaluators.py,sha256=tMcovIr6dhysLRaxUjYbNmPu3jvOzpHOZDjevUnGEMU,10640
+statemachine/io/interpreter.py,sha256=FQUXUlt1PSPzFHyixiLNXcN-7KYBM_i5RAFPRPLu6TE,5567
+statemachine/io/invoke.py,sha256=wbeSJSlDLEvS7hXSznpMT7wd8GDcVsQSXGgFr67zVrI,9877
+statemachine/io/loader.py,sha256=GbCF0MoLxcRa84zZOZPsJpdIUeodFGcsFoWE_Wk4bqQ,6442
+statemachine/io/model.py,sha256=mTJvlbDJndX78pHfyDdEaqc9zTBWVA-OFA5xzVZbz6Y,8695
+statemachine/io/native.py,sha256=HjIOKDQIGExLMglcm8VGbga71Y1Zw-pBbKYWP-y_oiY,13758
+statemachine/io/ports.py,sha256=XoIAQfMujkEnH38t4iu766yiHycb89TNrA3owtBJU2U,2956
+statemachine/io/system_variables.py,sha256=7skuJgBL8giqzaNEyWd783xOZtVRSUHF6ETwt9fVcd4,6223
+statemachine/io/validation.py,sha256=6qiDx0gMkPAehSxJu_mrW4nEF_sebHwa5Dr_njclRcw,1662
+statemachine/io/json/__init__.py,sha256=tFWoOrD9RuKEqkOpI0XifNRP7rguSGY4k-RaSCV_GnM,38
+statemachine/io/json/reader.py,sha256=40V5T-yB1i0Qg-MkK00KHRi7eDQQk4ajfzmKtKXylHs,789
+statemachine/io/schemas/statechart.schema.json,sha256=5yNIS4M7OV6GE2doAWMk_Jct-qDyb5kQ-Dq95Es9KbM,7862
+statemachine/io/scxml/__init__.py,sha256=iGS763p9fZ6A7NVuEVpDVOS303q0dr5N4kVfOZ37jsk,660
+statemachine/io/scxml/processor.py,sha256=Ru_YQAA1OVXNS9AqfN2myL5POq-C4kI1Vpef-eO7k2M,1532
+statemachine/io/scxml/reader.py,sha256=CNUI9ARDJswRZDKqJSBY98Uoa5rQJsIU-kS9Uu5cmzg,17057
+statemachine/io/yaml/__init__.py,sha256=oMapUmquV7hb5qIGMfjDZmDHNq2fqqjJw6LOgGNKeC4,79
+statemachine/io/yaml/reader.py,sha256=mf2FaBttxQuCniSM-vHhSYDGaNLQdzRLoMUHO2kZ0xA,2208
+statemachine/locale/en/LC_MESSAGES/statemachine.po,sha256=_HrrNLQK1krOb56x5Pf1S6LihwaPwhN9_T0PUvumRA0,5338
+statemachine/locale/hi_IN/LC_MESSAGES/statemachine.po,sha256=O15jEhCNATAu6O2WhQ9RhQISB6Ueje2xbbTfEotnVSc,7948
+statemachine/locale/pt_BR/LC_MESSAGES/statemachine.po,sha256=X6-fU4JfK7VPFCRuLQ-4J-YUMF9N_RwhZ1DdCUvn74Y,5814
+statemachine/locale/zh_CN/LC_MESSAGES/statemachine.po,sha256=0_54wD7bl3RBMlYyokNFUdgMCx_1MbKzclxBUwmCNEs,5363
+python_statemachine-3.2.0.dist-info/METADATA,sha256=Vdy46mBCvmA04ruIBaTS9XklmK72ip3yycmrzgCWu48,12642
+python_statemachine-3.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+python_statemachine-3.2.0.dist-info/licenses/LICENSE,sha256=zcP7TsJMqaFxuTvLRZPT7nJl3_ppjxR9Z76BE9pL5zc,1074
+python_statemachine-3.2.0.dist-info/RECORD,,

{python_statemachine-3.1.1.dist-info → python_statemachine-3.2.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.29.0
+Generator: hatchling 1.30.1
 Root-Is-Purelib: true
 Tag: py3-none-any

statemachine/__init__.py

@@ -8,7 +8,7 @@ from .statemachine import TModel
 
 __author__ = """Fernando Macedo"""
 __email__ = "fgmacedo@gmail.com"
-__version__ = "3.1.1"
+__version__ = "3.2.0"
 
 __all__ = [
     "StateChart",

statemachine/callbacks.py

@@ -2,23 +2,17 @@ import asyncio
 from bisect import insort
 from collections import defaultdict
 from collections import deque
+from collections.abc import Callable
 from enum import IntEnum
 from enum import IntFlag
 from enum import auto
 from functools import partial
 from inspect import isawaitable
-from typing import TYPE_CHECKING
-from typing import Callable
-from typing import Dict
-from typing import List
 
 from .exceptions import AttrNotFound
 from .i18n import _
 from .utils import ensure_iterable
 
-if TYPE_CHECKING:
-    from typing import Set
-
 
 def allways_true(*args, **kwargs):
     return True
@@ -66,7 +60,7 @@ class CallbackSpec:
     before any real call is performed.
     """
 
-    names_not_found: "Set[str] | None" = None
+    names_not_found: "set[str] | None" = None
     """List of names that were not found on the model or statemachine"""
 
     def __init__(
@@ -155,9 +149,9 @@ class CallbackSpecList:
     """List of {ref}`CallbackSpec` instances"""
 
     def __init__(self, factory=CallbackSpec):
-        self.items: List[CallbackSpec] = []
+        self.items: list[CallbackSpec] = []
         self.conventional_specs = set()
-        self._groupers: Dict[CallbackGroup, SpecListGrouper] = {}
+        self._groupers: dict[CallbackGroup, SpecListGrouper] = {}
         self.factory = factory
 
     def __repr__(self):
@@ -380,7 +374,7 @@ class CallbacksExecutor:
 
 class CallbacksRegistry:
     def __init__(self) -> None:
-        self._registry: Dict[str, CallbacksExecutor] = defaultdict(CallbacksExecutor)
+        self._registry: dict[str, CallbacksExecutor] = defaultdict(CallbacksExecutor)
         self.has_async_callbacks: bool = False
 
     def __getitem__(self, key: str) -> CallbacksExecutor:

statemachine/configuration.py

@@ -1,8 +1,7 @@
+from collections.abc import Mapping
+from collections.abc import MutableSet
 from typing import TYPE_CHECKING
 from typing import Any
-from typing import Dict
-from typing import Mapping
-from typing import MutableSet
 
 from .exceptions import InvalidStateValue
 from .i18n import _
@@ -34,10 +33,10 @@ class Configuration:
 
     def __init__(
         self,
-        instance_states: "Mapping[str, State]",
+        instance_states: "Mapping[Any, State]",
         model: Any,
         state_field: str,
-        states_map: "Dict[Any, State]",
+        states_map: "dict[Any, State]",
     ):
         self._instance_states = instance_states
         self._model = model
@@ -85,7 +84,7 @@ class Configuration:
 
         # Normalize inline (avoid second getattr via _read_from_model)
         values = raw if isinstance(raw, MutableSet) else (raw,)
-        result = OrderedSet(self._instance_states[self._states_map[v].id] for v in values)
+        result = OrderedSet(self._instance_states[v] for v in values)
         self._cached = result
         self._cached_value = raw
         return result

statemachine/contrib/diagram/__init__.py

@@ -1,13 +1,14 @@
 import importlib
+from typing import TYPE_CHECKING
 from urllib.parse import quote
 from urllib.request import urlopen
 
 from .extract import extract
 from .formatter import formatter as formatter
-from .renderers.dot import DotRenderer
-from .renderers.dot import DotRendererConfig
-from .renderers.mermaid import MermaidRenderer
-from .renderers.mermaid import MermaidRendererConfig
+
+if TYPE_CHECKING:
+    from .renderers.dot import DotRendererConfig
+    from .renderers.mermaid import MermaidRendererConfig
 
 
 class DotGraphMachine:
@@ -40,7 +41,9 @@ class DotGraphMachine:
     def __init__(self, machine):
         self.machine = machine
 
-    def _build_config(self) -> DotRendererConfig:
+    def _build_config(self) -> "DotRendererConfig":
+        from .renderers.dot import DotRendererConfig
+
         return DotRendererConfig(
             graph_rankdir=self.graph_rankdir,
             font_name=self.font_name,
@@ -51,6 +54,8 @@ class DotGraphMachine:
         )
 
     def get_graph(self):
+        from .renderers.dot import DotRenderer
+
         ir = extract(self.machine)
         renderer = DotRenderer(config=self._build_config())
         return renderer.render(ir)
@@ -69,7 +74,9 @@ class MermaidGraphMachine:
     def __init__(self, machine):
         self.machine = machine
 
-    def _build_config(self) -> MermaidRendererConfig:
+    def _build_config(self) -> "MermaidRendererConfig":
+        from .renderers.mermaid import MermaidRendererConfig
+
         return MermaidRendererConfig(
             direction=self.direction,
             active_fill=self.active_fill,
@@ -77,6 +84,8 @@ class MermaidGraphMachine:
         )
 
     def get_mermaid(self) -> str:
+        from .renderers.mermaid import MermaidRenderer
+
         ir = extract(self.machine)
         renderer = MermaidRenderer(config=self._build_config())
         return renderer.render(ir)

statemachine/contrib/diagram/extract.py

@@ -1,7 +1,4 @@
 from typing import TYPE_CHECKING
-from typing import List
-from typing import Set
-from typing import Union
 
 from .model import ActionType
 from .model import DiagramAction
@@ -11,12 +8,14 @@ from .model import DiagramTransition
 from .model import StateType
 
 if TYPE_CHECKING:
+    from typing import TypeAlias
+
     from statemachine.state import State
     from statemachine.statemachine import StateChart
     from statemachine.transition import Transition
 
     # A StateChart class or instance — both expose the same structural metadata.
-    MachineRef = Union["StateChart", "type[StateChart]"]
+    MachineRef: TypeAlias = StateChart | type[StateChart]
 
 
 def _determine_state_type(state: "State") -> StateType:
@@ -50,8 +49,8 @@ def _actions_getter(machine: "MachineRef"):
     return getter
 
 
-def _extract_state_actions(state: "State", getter) -> List[DiagramAction]:
-    actions: List[DiagramAction] = []
+def _extract_state_actions(state: "State", getter) -> list[DiagramAction]:
+    actions: list[DiagramAction] = []
 
     entry = str(getter(state.enter))
     exit_ = str(getter(state.exit))
@@ -82,7 +81,7 @@ def _extract_state(
     is_active = state.value in active_values
     is_parallel_area = bool(state.parent and getattr(state.parent, "parallel", False))
 
-    children: List[DiagramState] = []
+    children: list[DiagramState] = []
     for substate in state.states:
         children.append(_extract_state(substate, machine, getter, active_values))
     for history_state in getattr(state, "history", []):
@@ -116,8 +115,8 @@ def _format_event_names(transition: "Transition") -> str:
 
     all_ids = {str(e) for e in events}
 
-    seen_ids: Set[str] = set()
-    display: List[str] = []
+    seen_ids: set[str] = set()
+    display: list[str] = []
     for event in events:
         eid = str(event)
         # Skip dot-form aliases (e.g. "done.invoke.X") when the underscore
@@ -131,9 +130,9 @@ def _format_event_names(transition: "Transition") -> str:
     return " ".join(display)
 
 
-def _extract_transitions_from_state(state: "State") -> List[DiagramTransition]:
+def _extract_transitions_from_state(state: "State") -> list[DiagramTransition]:
     """Extract transitions from a single state (non-recursive)."""
-    result: List[DiagramTransition] = []
+    result: list[DiagramTransition] = []
     for transition in state.transitions:
         targets = transition.targets if transition.targets else []
         target_ids = [t.id for t in targets]
@@ -152,9 +151,9 @@ def _extract_transitions_from_state(state: "State") -> List[DiagramTransition]:
     return result
 
 
-def _extract_all_transitions(states) -> List[DiagramTransition]:
+def _extract_all_transitions(states) -> list[DiagramTransition]:
     """Recursively extract transitions from all states."""
-    result: List[DiagramTransition] = []
+    result: list[DiagramTransition] = []
     for state in states:
         result.extend(_extract_transitions_from_state(state))
         if state.states:
@@ -166,9 +165,9 @@ def _extract_all_transitions(states) -> List[DiagramTransition]:
     return result
 
 
-def _collect_compound_ids(states: List[DiagramState]) -> Set[str]:
+def _collect_compound_ids(states: list[DiagramState]) -> set[str]:
     """Collect IDs of states that have children (compound/parallel)."""
-    result: Set[str] = set()
+    result: set[str] = set()
     for state in states:
         if state.children:
             result.add(state.id)
@@ -177,12 +176,12 @@ def _collect_compound_ids(states: List[DiagramState]) -> Set[str]:
 
 
 def _collect_bidirectional_compound_ids(
-    transitions: List[DiagramTransition],
-    compound_ids: Set[str],
-) -> Set[str]:
+    transitions: list[DiagramTransition],
+    compound_ids: set[str],
+) -> set[str]:
     """Find compound states that have both outgoing and incoming explicit edges."""
-    outgoing: Set[str] = set()
-    incoming: Set[str] = set()
+    outgoing: set[str] = set()
+    incoming: set[str] = set()
     for t in transitions:
         if t.is_internal:
             continue
@@ -198,8 +197,8 @@ def _collect_bidirectional_compound_ids(
 
 
 def _mark_initial_transitions(
-    transitions: List[DiagramTransition],
-    compound_ids: Set[str],
+    transitions: list[DiagramTransition],
+    compound_ids: set[str],
 ) -> None:
     """Mark implicit initial transitions (compound state → child, no event)."""
     for t in transitions:
@@ -207,7 +206,7 @@ def _mark_initial_transitions(
             t.is_initial = True
 
 
-def _resolve_initial_states(states: List[DiagramState]) -> None:
+def _resolve_initial_states(states: list[DiagramState]) -> None:
     """Ensure exactly one state per level has is_initial=True.
 
     Skips parallel areas and history states. Falls back to document order
@@ -268,7 +267,7 @@ def extract(machine_or_class: "MachineRef") -> DiagramGraph:
     if isinstance(machine, StateChart) and hasattr(machine, "configuration_values"):
         active_values = set(machine.configuration_values)
 
-    states: List[DiagramState] = []
+    states: list[DiagramState] = []
     for state in machine.states:
         states.append(_extract_state(state, machine, getter, active_values))
 

statemachine/contrib/diagram/formatter.py

@@ -16,24 +16,22 @@ A module-level :data:`formatter` instance is the single public entry point::
         ...
 """
 
+from collections.abc import Callable
 from typing import TYPE_CHECKING
-from typing import Callable
-from typing import Dict
-from typing import List
 
 if TYPE_CHECKING:
-    from typing import Union
+    from typing import TypeAlias
 
     from statemachine.statemachine import StateChart
 
-    MachineRef = Union["StateChart", "type[StateChart]"]
+    MachineRef: TypeAlias = StateChart | type[StateChart]
 
 
 class Formatter:
     """Unified facade for rendering state machines in multiple text formats."""
 
     def __init__(self) -> None:
-        self._formats: Dict[str, "Callable[[MachineRef], str]"] = {}
+        self._formats: dict[str, "Callable[[MachineRef], str]"] = {}
 
     def register_format(
         self, *names: str
@@ -78,7 +76,7 @@ class Formatter:
             )
         return renderer_fn(machine_or_class)
 
-    def supported_formats(self) -> List[str]:
+    def supported_formats(self) -> list[str]:
         """Return sorted list of all registered format names (including aliases)."""
         return sorted(self._formats)
 

statemachine/contrib/diagram/model.py

@@ -1,8 +1,6 @@
 from dataclasses import dataclass
 from dataclasses import field
 from enum import Enum
-from typing import List
-from typing import Set
 
 
 class StateType(Enum):
@@ -36,8 +34,8 @@ class DiagramState:
     id: str
     name: str
     type: StateType
-    actions: List[DiagramAction] = field(default_factory=list)
-    children: List["DiagramState"] = field(default_factory=list)
+    actions: list[DiagramAction] = field(default_factory=list)
+    children: list["DiagramState"] = field(default_factory=list)
     is_active: bool = False
     is_parallel_area: bool = False
     is_initial: bool = False
@@ -46,10 +44,10 @@ class DiagramState:
 @dataclass
 class DiagramTransition:
     source: str
-    targets: List[str] = field(default_factory=list)
+    targets: list[str] = field(default_factory=list)
     event: str = ""
-    guards: List[str] = field(default_factory=list)
-    actions: List[str] = field(default_factory=list)
+    guards: list[str] = field(default_factory=list)
+    actions: list[str] = field(default_factory=list)
     is_internal: bool = False
     is_initial: bool = False
 
@@ -57,7 +55,7 @@ class DiagramTransition:
 @dataclass
 class DiagramGraph:
     name: str
-    states: List[DiagramState] = field(default_factory=list)
-    transitions: List[DiagramTransition] = field(default_factory=list)
-    compound_state_ids: Set[str] = field(default_factory=set)
-    bidirectional_compound_ids: Set[str] = field(default_factory=set)
+    states: list[DiagramState] = field(default_factory=list)
+    transitions: list[DiagramTransition] = field(default_factory=list)
+    compound_state_ids: set[str] = field(default_factory=set)
+    bidirectional_compound_ids: set[str] = field(default_factory=set)

statemachine/contrib/diagram/renderers/dot.py

@@ -1,10 +1,6 @@
 from dataclasses import dataclass
 from dataclasses import field
 from typing import Any
-from typing import Dict
-from typing import List
-from typing import Optional
-from typing import Set
 
 import pydot
 
@@ -31,9 +27,9 @@ class DotRendererConfig:
     state_active_penwidth: int = 2
     state_active_fillcolor: str = "turquoise"
     transition_font_size: str = "10"
-    graph_attrs: Dict[str, str] = field(default_factory=dict)
-    node_attrs: Dict[str, str] = field(default_factory=dict)
-    edge_attrs: Dict[str, str] = field(default_factory=dict)
+    graph_attrs: dict[str, str] = field(default_factory=dict)
+    node_attrs: dict[str, str] = field(default_factory=dict)
+    edge_attrs: dict[str, str] = field(default_factory=dict)
 
 
 class DotRenderer:
@@ -45,10 +41,10 @@ class DotRenderer:
     - Refined graph/node/edge defaults
     """
 
-    def __init__(self, config: Optional[DotRendererConfig] = None):
+    def __init__(self, config: DotRendererConfig | None = None):
         self.config = config or DotRendererConfig()
-        self._compound_ids: Set[str] = set()
-        self._compound_bidir_ids: Set[str] = set()
+        self._compound_ids: set[str] = set()
+        self._compound_bidir_ids: set[str] = set()
 
     def render(self, graph: DiagramGraph) -> pydot.Dot:
         """Render a DiagramGraph to a pydot.Dot object."""
@@ -120,10 +116,10 @@ class DotRenderer:
 
     def _render_states(
         self,
-        states: List[DiagramState],
-        transitions: List[DiagramTransition],
+        states: list[DiagramState],
+        transitions: list[DiagramTransition],
         parent_graph: "pydot.Dot | pydot.Subgraph",
-        extra_nodes: Optional[List[pydot.Node]] = None,
+        extra_nodes: list[pydot.Node] | None = None,
     ) -> None:
         """Render states and transitions into the parent graph."""
         initial_state = next((s for s in states if s.is_initial), None)
@@ -177,7 +173,7 @@ class DotRenderer:
 
     @staticmethod
     def _place_extra_nodes(
-        extra_nodes: Optional[List[pydot.Node]],
+        extra_nodes: list[pydot.Node] | None,
         atomic_subgraph: pydot.Subgraph,
         parent_graph: "pydot.Dot | pydot.Subgraph",
         has_atomic: bool,
@@ -211,7 +207,7 @@ class DotRenderer:
         initial_node = self._create_initial_node(initial_node_id)
         added_to_atomic = False
 
-        extra: Dict[str, Any] = {}
+        extra: dict[str, Any] = {}
         if initial_state.children:
             extra["lhead"] = f"cluster_{initial_state.id}"
 
@@ -308,7 +304,7 @@ class DotRenderer:
     def _build_html_table_label(
         self,
         state: DiagramState,
-        actions: List[DiagramAction],
+        actions: list[DiagramAction],
     ) -> str:
         """Build an HTML TABLE label with UML compartments (name | actions).
 
@@ -357,7 +353,7 @@ class DotRenderer:
             height=0.3,
         )
 
-    def _create_compound_anchor_nodes(self, state: DiagramState) -> List[pydot.Node]:
+    def _create_compound_anchor_nodes(self, state: DiagramState) -> list[pydot.Node]:
         """Create invisible anchor nodes for edge routing inside a compound cluster.
 
         These nodes are injected into the children's atomic_subgraph so they
@@ -433,7 +429,7 @@ class DotRenderer:
     def _add_transitions_for_state(
         self,
         state: DiagramState,
-        all_transitions: List[DiagramTransition],
+        all_transitions: list[DiagramTransition],
         graph: "pydot.Dot | pydot.Subgraph",
     ) -> None:
         """Add edges for all non-internal transitions originating from this state."""
@@ -446,11 +442,9 @@ class DotRenderer:
             for edge in self._create_edges(transition):
                 graph.add_edge(edge)
 
-    def _create_edges(self, transition: DiagramTransition) -> List[pydot.Edge]:
+    def _create_edges(self, transition: DiagramTransition) -> list[pydot.Edge]:
         """Create pydot.Edge objects for a transition."""
-        target_ids: List[Optional[str]] = (
-            list(transition.targets) if transition.targets else [None]
-        )
+        target_ids: list[str | None] = list(transition.targets) if transition.targets else [None]
 
         cond = ", ".join(transition.guards)
         cond_html = f"<br/>[{_escape_html(cond)}]" if cond else ""
@@ -463,7 +457,7 @@ class DotRenderer:
     def _create_single_edge(
         self,
         transition: DiagramTransition,
-        target_id: Optional[str],
+        target_id: str | None,
         index: int,
         cond_html: str,
     ) -> pydot.Edge:
@@ -483,10 +477,10 @@ class DotRenderer:
     def _resolve_edge_endpoints(
         self,
         transition: DiagramTransition,
-        target_id: Optional[str],
-    ) -> "tuple[str, str, Dict[str, Any]]":
+        target_id: str | None,
+    ) -> "tuple[str, str, dict[str, Any]]":
         """Resolve source/destination node IDs and cluster attributes for an edge."""
-        extra: Dict[str, Any] = {}
+        extra: dict[str, Any] = {}
         source_is_compound = transition.source in self._compound_ids
         target_is_compound = target_id is not None and target_id in self._compound_ids