chore: prepare release 2.6.0

- Bump version to 2.6.0 in pyproject.toml and __init__.py
- Add release notes (docs/releases/2.6.0.md)
- Add data migrations section to Django integration docs
- Update translations (extract, merge, translate 3 new messages)
- Add babel to dev dependencies

Author: fgmacedo

docs/integrations.md

@@ -69,3 +69,22 @@ class Campaign(models.Model, MachineMixin):
 ```{seealso}
 Learn more about using the [](mixins.md#machinemixin).
 ```
+
+### Data migrations
+
+Django's `apps.get_model()` returns **historical model** classes that are dynamically created
+and don't carry user-defined class attributes like `state_machine_name`. Since version 2.6.0,
+`MachineMixin` detects these historical models and gracefully skips state machine
+initialization, so data migrations that use `apps.get_model()` work without errors.
+
+```{note}
+The state machine instance will **not** be available on historical model objects.
+If your data migration needs to interact with the state machine, set the attributes
+manually on the historical model class:
+
+    def backfill_data(apps, schema_editor):
+        MyModel = apps.get_model("myapp", "MyModel")
+        MyModel.state_machine_name = "myapp.statemachines.MyStateMachine"
+        for obj in MyModel.objects.all():
+            obj.statemachine  # now available
+```

docs/releases/2.6.0.md

@@ -0,0 +1,128 @@
+# StateMachine 2.6.0
+
+*February 2026*
+
+## What's new in 2.6.0
+
+This release adds the {ref}`StateMachine.enabled_events` method, Python 3.14 support,
+a significant performance improvement for callback dispatch, and several bugfixes
+for async condition expressions, type checker compatibility, and Django integration.
+
+### Python compatibility in 2.6.0
+
+StateMachine 2.6.0 supports Python 3.7, 3.8, 3.9, 3.10, 3.11, 3.12, 3.13, and 3.14.
+
+### Checking enabled events
+
+A new {ref}`StateMachine.enabled_events` method lets you query which events have their
+`cond`/`unless` guards currently satisfied, going beyond {ref}`StateMachine.allowed_events`
+which only checks reachability from the current state.
+
+This is particularly useful for **UI scenarios** where you want to enable or disable buttons
+based on whether an event's conditions are met at runtime.
+
+```{testsetup}
+
+>>> from statemachine import StateMachine, State
+
+```
+
+```py
+>>> class ApprovalMachine(StateMachine):
+...     pending = State(initial=True)
+...     approved = State(final=True)
+...     rejected = State(final=True)
+...
+...     approve = pending.to(approved, cond="is_manager")
+...     reject = pending.to(rejected)
+...
+...     is_manager = False
+
+>>> sm = ApprovalMachine()
+
+>>> [e.id for e in sm.allowed_events]
+['approve', 'reject']
+
+>>> [e.id for e in sm.enabled_events()]
+['reject']
+
+>>> sm.is_manager = True
+
+>>> [e.id for e in sm.enabled_events()]
+['approve', 'reject']
+
+```
+
+Since conditions may depend on runtime arguments, any `*args`/`**kwargs` passed to
+`enabled_events()` are forwarded to the condition callbacks:
+
+```py
+>>> class TaskMachine(StateMachine):
+...     idle = State(initial=True)
+...     running = State(final=True)
+...
+...     start = idle.to(running, cond="has_enough_resources")
+...
+...     def has_enough_resources(self, cpu=0):
+...         return cpu >= 4
+
+>>> sm = TaskMachine()
+
+>>> sm.enabled_events()
+[]
+
+>>> [e.id for e in sm.enabled_events(cpu=8)]
+['start']
+
+```
+
+```{seealso}
+See {ref}`Checking enabled events` in the Guards documentation for more details.
+```
+
+### Performance: cached signature binding
+
+Callback dispatch is now significantly faster thanks to cached signature binding in
+`SignatureAdapter`. The first call to a callback computes the argument binding and
+caches a fast-path template; subsequent calls with the same argument shape skip the
+full binding logic.
+
+This results in approximately **60% faster** `bind_expected()` calls and
+around **30% end-to-end improvement** on hot transition paths.
+
+See [#548](https://github.com/fgmacedo/python-statemachine/issues/548) for benchmarks.
+
+
+## Bugfixes in 2.6.0
+
+- Fixes [#531](https://github.com/fgmacedo/python-statemachine/issues/531) domain model
+  with falsy `__bool__` was being replaced by the default `Model()`.
+- Fixes [#535](https://github.com/fgmacedo/python-statemachine/issues/535) async predicates
+  in condition expressions (`not`, `and`, `or`) were not being awaited, causing guards to
+  silently return incorrect results.
+- Fixes [#548](https://github.com/fgmacedo/python-statemachine/issues/548)
+  `VAR_POSITIONAL` and kwargs precedence bugs in the signature binding cache introduced
+  by the performance optimization.
+- Fixes [#511](https://github.com/fgmacedo/python-statemachine/issues/511) Pyright/Pylance
+  false positive "Argument missing for parameter f" when calling events. Static analyzers
+  could not follow the metaclass transformation from `TransitionList` to `Event`.
+- Fixes [#551](https://github.com/fgmacedo/python-statemachine/issues/551) `MachineMixin`
+  now gracefully skips state machine initialization for Django historical models in data
+  migrations, instead of raising `ValueError`.
+- Fixes [#526](https://github.com/fgmacedo/python-statemachine/issues/526) sanitize project
+  path on Windows for documentation builds.
+
+
+## Misc in 2.6.0
+
+- Added Python 3.14 support [#552](https://github.com/fgmacedo/python-statemachine/pull/552).
+- Upgraded dev dependencies: ruff to 0.15.0, mypy to 1.14.1
+  [#552](https://github.com/fgmacedo/python-statemachine/pull/552).
+- Clarified conditional transition evaluation order in documentation
+  [#546](https://github.com/fgmacedo/python-statemachine/pull/546).
+- Added pydot DPI resolution settings to diagram documentation
+  [#514](https://github.com/fgmacedo/python-statemachine/pull/514).
+- Fixed miscellaneous typos in documentation
+  [#522](https://github.com/fgmacedo/python-statemachine/pull/522).
+- Removed Python 3.7 from CI build matrix
+  [ef351d5](https://github.com/fgmacedo/python-statemachine/commit/ef351d5).

docs/releases/index.md

@@ -15,6 +15,7 @@ Below are release notes through StateMachine and its patch releases.
 ```{toctree}
 :maxdepth: 2
 
+2.6.0
 2.5.0
 2.4.0
 2.3.6

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-statemachine"
-version = "2.5.0"
+version = "2.6.0"
 description = "Python Finite State Machines made easy."
 authors = [{ name = "Fernando Macedo", email = "[email protected]" }]
 maintainers = [{ name = "Fernando Macedo", email = "[email protected]" }]
@@ -55,6 +55,7 @@ dev = [
     "furo >=2024.5.6; python_version >'3.8'",
     "sphinx-copybutton >=0.5.2; python_version >'3.8'",
     "pdbr>=0.8.9; python_version >'3.8'",
+    "babel >=2.16.0; python_version >='3.8'",
 ]
 
 [build-system]

statemachine/__init__.py

@@ -4,6 +4,6 @@
 
 __author__ = """Fernando Macedo"""
 __email__ = "[email protected]"
-__version__ = "2.5.0"
+__version__ = "2.6.0"
 
 __all__ = ["StateMachine", "State", "Event"]

statemachine/locale/en/LC_MESSAGES/statemachine.po

@@ -1,24 +1,35 @@
-# This file is distributed under the same license as the PROJECT project.
+# This file is distributed under the same license as the  project.
 # Fernando Macedo <[email protected]>, 2024.
 #
 msgid ""
 msgstr ""
-"Project-Id-Version: 2.4.0\n"
+"Project-Id-Version:  2.4.0\n"
 "Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2023-03-04 16:10-0300\n"
+"POT-Creation-Date: 2026-02-13 18:28-0300\n"
 "PO-Revision-Date: 2024-06-07 17:41-0300\n"
 "Last-Translator: Fernando Macedo <[email protected]>\n"
+"Language: en\n"
+"Language-Team: en <[email protected]>\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.12.1\n"
+"Generated-By: Babel 2.16.0\n"
 
-#: statemachine/callbacks.py:165
+#: statemachine/callbacks.py:349 statemachine/callbacks.py:354
+msgid "Did not found name '{}' from model or statemachine"
+msgstr ""
+
+#: statemachine/dispatcher.py:126
 msgid "Failed to parse boolean expression '{}'"
 msgstr ""
 
-#: statemachine/callbacks.py:407 statemachine/callbacks.py:412
-msgid "Did not found name '{}' from model or statemachine"
+#: statemachine/event.py:90
+msgid "Cannot add callback '{}' to an event with no transitions."
+msgstr ""
+
+#: statemachine/event.py:123
+msgid "Event {} cannot be called without a SM instance"
 msgstr ""
 
 #: statemachine/exceptions.py:24
@@ -29,64 +40,68 @@ msgstr ""
 msgid "Can't {} when in {}."
 msgstr ""
 
-#: statemachine/factory.py:74
+#: statemachine/factory.py:73
 msgid "There are no states."
 msgstr ""
 
-#: statemachine/factory.py:77
+#: statemachine/factory.py:76
 msgid "There are no events."
 msgstr ""
 
-#: statemachine/factory.py:89
+#: statemachine/factory.py:88
 msgid ""
 "There should be one and only one initial state. You currently have these:"
 " {!r}"
 msgstr ""
 
-#: statemachine/factory.py:102
+#: statemachine/factory.py:101
 msgid "Cannot declare transitions from final state. Invalid state(s): {}"
 msgstr ""
 
-#: statemachine/factory.py:110
+#: statemachine/factory.py:109
 msgid ""
 "All non-final states should have at least one outgoing transition. These "
 "states have no outgoing transition: {!r}"
 msgstr ""
 
-#: statemachine/factory.py:124
+#: statemachine/factory.py:123
 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 ""
 
-#: statemachine/factory.py:148
+#: statemachine/factory.py:147
 msgid ""
 "There are unreachable states. The statemachine graph should have a single"
 " component. Disconnected states: {}"
 msgstr ""
 
-#: statemachine/factory.py:257
+#: statemachine/factory.py:253
 msgid "An event in the '{}' has no id."
 msgstr ""
 
-#: statemachine/mixins.py:26
+#: statemachine/mixins.py:28
 msgid "{!r} is not a valid state machine name."
 msgstr ""
 
-#: statemachine/state.py:155
+#: statemachine/state.py:194
 msgid "State overriding is not allowed. Trying to add '{}' to {}"
 msgstr ""
 
-#: statemachine/statemachine.py:94
+#: statemachine/statemachine.py:89
 msgid "There are no states or transitions."
 msgstr ""
 
-#: statemachine/statemachine.py:285
+#: statemachine/statemachine.py:277
 msgid ""
 "There's no current state set. In async code, did you activate the initial"
 " state? (e.g., `await sm.activate_initial_state()`)"
 msgstr ""
 
-#: statemachine/engines/async_.py:22
+#: statemachine/transition_mixin.py:15
+msgid "{} only supports the decorator syntax to register callbacks."
+msgstr ""
+
+#: statemachine/engines/async_.py:18
 msgid "Only RTC is supported on async engine"
 msgstr ""