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

statemachine/locale/pt_BR/LC_MESSAGES/statemachine.po

@@ -5,7 +5,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  3.1.1\n"
 "Report-Msgid-Bugs-To: fgmacedo@gmail.com\n"
-"POT-Creation-Date: 2026-06-16 23:00-0300\n"
+"POT-Creation-Date: 2026-10-13 21:26-0300\n"
 "PO-Revision-Date: 2024-06-07 17:41-0300\n"
 "Last-Translator: Fernando Macedo <fgmacedo@gmail.com>\n"
 "Language: pt_BR\n"
@@ -16,7 +16,7 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.18.0\n"
 
-#: statemachine/callbacks.py:398 statemachine/callbacks.py:403
+#: statemachine/callbacks.py:409 statemachine/callbacks.py:414
 #, python-brace-format
 msgid "Did not found name '{}' from model or statemachine"
 msgstr "Nome '{}' não encontrado no modelo ou na máquina de estados"
@@ -29,12 +29,24 @@ msgstr ""
 "Nenhum estado atual definido. Em código assíncrono, você ativou o estado "
 "inicial? (ex.: `await sm.activate_initial_state()`)"
 
-#: statemachine/dispatcher.py:123
+#: statemachine/dispatcher.py:127
 #, python-brace-format
 msgid "Failed to parse boolean expression '{}'"
 msgstr "Falha ao interpretar a expressão booleana '{}'"
 
-#: statemachine/event.py:94
+#: statemachine/event.py:56
+#, python-brace-format
+msgid ""
+"Event {id!r} cannot be both delayed and internal: the internal queue runs"
+" within the current macrostep, which takes no time. Drop 'internal' to "
+"deliver it later on the external queue, or drop 'delay' to run it now."
+msgstr ""
+"O evento {id!r} não pode ser atrasado e interno ao mesmo tempo: a fila "
+"interna roda dentro do macrostep atual, que não leva tempo. Remova "
+"'internal' para entregá-lo depois pela fila externa, ou remova 'delay' "
+"para executá-lo agora."
+
+#: statemachine/event.py:108
 #, python-brace-format
 msgid ""
 "Event() received a non-string 'id' ({cls_name}). To combine multiple "
@@ -43,12 +55,12 @@ msgstr ""
 "Event() recebeu um 'id' que não é uma string ({cls_name}). Para combinar "
 "múltiplas transições em um único evento, use o operador |: t1 | t2."
 
-#: statemachine/event.py:130
+#: statemachine/event.py:147
 #, python-brace-format
 msgid "Cannot add callback '{}' to an event with no transitions."
 msgstr "Não é possível adicionar callback '{}' a um evento sem transições."
 
-#: statemachine/event.py:163
+#: statemachine/event.py:182
 #, python-brace-format
 msgid "Event {} cannot be called without a SM instance"
 msgstr "O evento {} não pode ser chamado sem uma instância de SM"
@@ -63,7 +75,7 @@ msgstr "{!r} não é um valor de estado válido."
 msgid "Can't {} when in {}."
 msgstr "Não é possível {} quando em {}."
 
-#: statemachine/factory.py:77
+#: statemachine/factory.py:91
 #, python-brace-format
 msgid ""
 "There should be one and only one initial state. Your currently have "
@@ -72,7 +84,36 @@ msgstr ""
 "Deve haver um e apenas um estado inicial. Atualmente, você possui estes: "
 "{0}"
 
-#: statemachine/factory.py:194
+#: statemachine/factory.py:249
+#, python-brace-format
+msgid "is declared in both the '{}' and the '{}' state bodies"
+msgstr "está declarado nos corpos dos estados '{}' e '{}'"
+
+#: statemachine/factory.py:253
+#, python-brace-format
+msgid "in the '{}' state body clashes with the event '{}'"
+msgstr "no corpo do estado '{}' conflita com o evento '{}'"
+
+#: statemachine/factory.py:257
+#, python-brace-format
+msgid "is declared in both the '{}' state body and the '{}' class body"
+msgstr "está declarado no corpo do estado '{}' e no corpo da classe '{}'"
+
+#: statemachine/factory.py:261
+#, python-brace-format
+msgid "in the '{}' state body clashes with the '{}' attribute of '{}'"
+msgstr "no corpo do estado '{}' conflita com o atributo '{}' de '{}'"
+
+#: statemachine/factory.py:267
+#, python-brace-format
+msgid ""
+"Callback '{}' {}. Nested state bodies share the class namespace. Rename "
+"one of them."
+msgstr ""
+"Callback '{}' {}. Corpos de estados aninhados compartilham o namespace da"
+" classe. Renomeie um deles."
+
+#: statemachine/factory.py:291
 #, python-brace-format
 msgid ""
 "There should be one and only one initial state. You currently have these:"
@@ -81,14 +122,14 @@ msgstr ""
 "Deve haver um e apenas um estado inicial. Atualmente, você possui estes: "
 "{!r}"
 
-#: statemachine/factory.py:209
+#: statemachine/factory.py:306
 #, python-brace-format
 msgid "Cannot declare transitions from final state. Invalid state(s): {}"
 msgstr ""
 "Não é possível declarar transições a partir de um estado final. Estado(s)"
 " inválido(s): {}"
 
-#: statemachine/factory.py:221
+#: statemachine/factory.py:318
 #, python-brace-format
 msgid ""
 "All non-final states should have at least one outgoing transition. These "
@@ -97,7 +138,7 @@ msgstr ""
 "Todos os estados não finais devem ter pelo menos uma transição de saída. "
 "Estes estados não possuem transição de saída: {!r}"
 
-#: statemachine/factory.py:235
+#: statemachine/factory.py:332
 #, python-brace-format
 msgid ""
 "All non-final states should have at least one path to a final state. "
@@ -107,7 +148,7 @@ msgstr ""
 "estado final. Estes estados não possuem caminho para um estado final: "
 "{!r}"
 
-#: statemachine/factory.py:248
+#: statemachine/factory.py:345
 #, python-brace-format
 msgid ""
 "There are unreachable states. The statemachine graph should have a single"
@@ -116,7 +157,7 @@ msgstr ""
 "Há estados inacessíveis. O grafo da máquina de estados deve ter um único "
 "componente. Estados desconectados: {}"
 
-#: statemachine/factory.py:285
+#: statemachine/factory.py:382
 #, python-brace-format
 msgid ""
 "Invalid entry in 'listeners': {!r}. Expected a class, callable, or "
@@ -125,7 +166,7 @@ msgstr ""
 "Entrada inválida em 'listeners': {!r}. Esperado uma classe, callable ou "
 "instância de listener."
 
-#: statemachine/factory.py:384
+#: statemachine/factory.py:481
 #, python-brace-format
 msgid "An event in the '{}' has no id."
 msgstr "Um evento em '{}' não possui id."
@@ -135,15 +176,15 @@ msgstr "Um evento em '{}' não possui id."
 msgid "{!r} is not a valid state machine name."
 msgstr "{!r} não é um nome de máquina de estados válido."
 
-#: statemachine/state.py:249
+#: statemachine/state.py:273
 msgid "'donedata' can only be specified on final states."
 msgstr "'donedata' só pode ser especificado em estados finais."
 
-#: statemachine/statemachine.py:167
+#: statemachine/statemachine.py:168
 msgid "There are no states or transitions."
 msgstr "Não há estados ou transições."
 
-#: statemachine/statemachine.py:237
+#: statemachine/statemachine.py:242
 #, python-brace-format
 msgid "State overriding is not allowed. Trying to add '{}' to {}"
 msgstr "Sobrescrever estados não é permitido. Tentando adicionar '{}' a {}"
@@ -162,6 +203,14 @@ msgstr ""
 msgid "{} only supports the decorator syntax to register callbacks."
 msgstr "{} suporta apenas a sintaxe de decorator para registrar callbacks."
 
+#: statemachine/engines/async_.py:50
+msgid ""
+"The task running the processing loop was cancelled while it processed "
+"this event."
+msgstr ""
+"A tarefa que executava o loop de processamento foi cancelada enquanto "
+"processava este evento."
+
 #~ msgid "There are no states."
 #~ msgstr "Não há estados."
 

statemachine/locale/zh_CN/LC_MESSAGES/statemachine.po

@@ -5,7 +5,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  3.1.1\n"
 "Report-Msgid-Bugs-To: fgmacedo@gmail.com\n"
-"POT-Creation-Date: 2026-06-16 23:00-0300\n"
+"POT-Creation-Date: 2026-10-13 21:26-0300\n"
 "PO-Revision-Date: 2024-06-07 17:41-0300\n"
 "Last-Translator: Fernando Macedo <fgmacedo@gmail.com>\n"
 "Language: zh_CN\n"
@@ -16,7 +16,7 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.18.0\n"
 
-#: statemachine/callbacks.py:398 statemachine/callbacks.py:403
+#: statemachine/callbacks.py:409 statemachine/callbacks.py:414
 #, python-brace-format
 msgid "Did not found name '{}' from model or statemachine"
 msgstr "在模型或状态机中未找到名称 '{}'"
@@ -27,24 +27,34 @@ msgid ""
 " state? (e.g., `await sm.activate_initial_state()`)"
 msgstr "没有设置当前状态。在异步代码中，您是否激活了初始状态？（例如，`await sm.activate_initial_state()`）"
 
-#: statemachine/dispatcher.py:123
+#: statemachine/dispatcher.py:127
 #, python-brace-format
 msgid "Failed to parse boolean expression '{}'"
 msgstr "无法解析布尔表达式 '{}'"
 
-#: statemachine/event.py:94
+#: statemachine/event.py:56
+#, python-brace-format
+msgid ""
+"Event {id!r} cannot be both delayed and internal: the internal queue runs"
+" within the current macrostep, which takes no time. Drop 'internal' to "
+"deliver it later on the external queue, or drop 'delay' to run it now."
+msgstr ""
+"事件 {id!r} 不能同时是延迟的和内部的：内部队列在当前宏步骤内运行，不占用时间。去掉 'internal' 以便稍后通过外部队列投递，或去掉"
+" 'delay' 以立即执行。"
+
+#: statemachine/event.py:108
 #, python-brace-format
 msgid ""
 "Event() received a non-string 'id' ({cls_name}). To combine multiple "
 "transitions under one event, use the | operator: t1 | t2."
 msgstr "Event() 接收到的 'id' 不是字符串 ({cls_name})。要将多个转换组合在同一个事件下，请使用 | 运算符：t1 | t2。"
 
-#: statemachine/event.py:130
+#: statemachine/event.py:147
 #, python-brace-format
 msgid "Cannot add callback '{}' to an event with no transitions."
 msgstr "无法将回调 '{}' 添加到没有转换的事件。"
 
-#: statemachine/event.py:163
+#: statemachine/event.py:182
 #, python-brace-format
 msgid "Event {} cannot be called without a SM instance"
 msgstr "事件 {} 不能在没有 SM 实例的情况下调用"
@@ -59,54 +69,81 @@ msgstr "{!r} 不是有效的状态值。"
 msgid "Can't {} when in {}."
 msgstr "在 {} 时无法 {}。"
 
-#: statemachine/factory.py:77
+#: statemachine/factory.py:91
 #, python-brace-format
 msgid ""
 "There should be one and only one initial state. Your currently have "
 "these: {0}"
 msgstr "应有且仅有一个初始状态。当前您有这些：{0}"
 
-#: statemachine/factory.py:194
+#: statemachine/factory.py:249
+#, python-brace-format
+msgid "is declared in both the '{}' and the '{}' state bodies"
+msgstr "同时声明在 '{}' 和 '{}' 状态体中"
+
+#: statemachine/factory.py:253
+#, python-brace-format
+msgid "in the '{}' state body clashes with the event '{}'"
+msgstr "在 '{}' 状态体中与事件 '{}' 冲突"
+
+#: statemachine/factory.py:257
+#, python-brace-format
+msgid "is declared in both the '{}' state body and the '{}' class body"
+msgstr "同时声明在 '{}' 状态体和 '{}' 类体中"
+
+#: statemachine/factory.py:261
+#, python-brace-format
+msgid "in the '{}' state body clashes with the '{}' attribute of '{}'"
+msgstr "在 '{0}' 状态体中与 '{2}' 的属性 '{1}' 冲突"
+
+#: statemachine/factory.py:267
+#, python-brace-format
+msgid ""
+"Callback '{}' {}. Nested state bodies share the class namespace. Rename "
+"one of them."
+msgstr "回调 '{}' {}。嵌套状态体共享类的命名空间。请重命名其中一个。"
+
+#: statemachine/factory.py:291
 #, python-brace-format
 msgid ""
 "There should be one and only one initial state. You currently have these:"
 " {!r}"
 msgstr "应有且仅有一个初始状态。当前您有这些：{!r}"
 
-#: statemachine/factory.py:209
+#: statemachine/factory.py:306
 #, python-brace-format
 msgid "Cannot declare transitions from final state. Invalid state(s): {}"
 msgstr "无法从终止状态声明转换。无效状态：{}"
 
-#: statemachine/factory.py:221
+#: statemachine/factory.py:318
 #, python-brace-format
 msgid ""
 "All non-final states should have at least one outgoing transition. These "
 "states have no outgoing transition: {!r}"
 msgstr "所有非终止状态都应至少有一个外部转换。这些状态没有外部转换：{!r}"
 
-#: statemachine/factory.py:235
+#: statemachine/factory.py:332
 #, python-brace-format
 msgid ""
 "All non-final states should have at least one path to a final state. "
 "These states have no path to a final state: {!r}"
 msgstr "所有非终止状态应至少有一个到终止状态的路径。这些状态没有到终止状态的路径：{!r}"
 
-#: statemachine/factory.py:248
+#: statemachine/factory.py:345
 #, python-brace-format
 msgid ""
 "There are unreachable states. The statemachine graph should have a single"
 " component. Disconnected states: {}"
 msgstr "存在不可到达的状态。状态机图应具有单个组件。断开的状态：{}"
 
-#: statemachine/factory.py:285
+#: statemachine/factory.py:382
 #, python-brace-format
 msgid ""
 "Invalid entry in 'listeners': {!r}. Expected a class, callable, or "
 "listener instance."
 msgstr "'listeners' 中的条目无效：{!r}。期望为类、可调用对象或监听器实例。"
 
-#: statemachine/factory.py:384
+#: statemachine/factory.py:481
 #, python-brace-format
 msgid "An event in the '{}' has no id."
 msgstr "'{}' 中的事件没有 ID。"
@@ -116,15 +153,15 @@ msgstr "'{}' 中的事件没有 ID。"
 msgid "{!r} is not a valid state machine name."
 msgstr "{!r} 不是有效的状态机名称。"
 
-#: statemachine/state.py:249
+#: statemachine/state.py:273
 msgid "'donedata' can only be specified on final states."
 msgstr "'donedata' 只能在终止状态上指定。"
 
-#: statemachine/statemachine.py:167
+#: statemachine/statemachine.py:168
 msgid "There are no states or transitions."
 msgstr "没有状态或转换。"
 
-#: statemachine/statemachine.py:237
+#: statemachine/statemachine.py:242
 #, python-brace-format
 msgid "State overriding is not allowed. Trying to add '{}' to {}"
 msgstr "不允许覆盖状态。尝试将 '{}' 添加到 {}"
@@ -141,6 +178,12 @@ msgstr "从源 {source!r} 的内部转换无效，目标 {target!r} 应为自身
 msgid "{} only supports the decorator syntax to register callbacks."
 msgstr "{} 仅支持使用装饰器语法注册回调。"
 
+#: statemachine/engines/async_.py:50
+msgid ""
+"The task running the processing loop was cancelled while it processed "
+"this event."
+msgstr "运行处理循环的任务在处理此事件时被取消。"
+
 #~ msgid "There are no states."
 #~ msgstr "没有状态。"
 

statemachine/orderedset.py

@@ -62,10 +62,14 @@ class OrderedSet(MutableSet[T]):
     >>> s[2]
     3
 
-    >>> eval(repr(OrderedSet(['a', 'b', 'c'])))
-    OrderedSet(['a', 'b', 'c'])
+    >>> s[-1]
+    3
 
+    >>> s[-3]
+    1
 
+    >>> eval(repr(OrderedSet(['a', 'b', 'c'])))
+    OrderedSet(['a', 'b', 'c'])
 
     """
 
@@ -84,10 +88,15 @@ class OrderedSet(MutableSet[T]):
         self._d.pop(x, None)
 
     def __getitem__(self, index) -> T:
+        original_index = index
+        if index < 0:
+            index += len(self)
+        if index < 0:
+            raise IndexError(f"index {original_index} out of range")
         try:
             return next(itertools.islice(self._d, index, index + 1))
         except StopIteration as e:
-            raise IndexError(f"index {index} out of range") from e
+            raise IndexError(f"index {original_index} out of range") from e
 
     def __contains__(self, x: object) -> bool:
         return self._d.__contains__(x)

statemachine/registry.py

@@ -1,5 +1,10 @@
+from typing import TYPE_CHECKING
+
 from .utils import qualname
 
+if TYPE_CHECKING:
+    from .statemachine import StateMachine
+
 try:
     from django.utils.module_loading import autodiscover_modules
 except ImportError:  # pragma: no cover
@@ -8,7 +13,7 @@ except ImportError:  # pragma: no cover
         pass
 
 
-_REGISTRY = {}
+_REGISTRY: "dict[str, type[StateMachine]]" = {}
 _initialized = False