Skip to content

Commit 8ee011e

Browse files
committed
docs: add performance and thread safety entries to 3.1.0 release notes
1 parent 1aa8a1b commit 8ee011e

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

docs/releases/3.1.0.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,22 @@ See {ref}`diagram:Sphinx directive` for full documentation.
3333
[#589](https://github.com/fgmacedo/python-statemachine/pull/589).
3434

3535

36+
### Performance: 5x–7x faster event processing
37+
38+
The engine's hot paths have been systematically profiled and optimized, resulting in
39+
**4.7x–7.7x faster event throughput** and **1.9x–2.6x faster setup** across all
40+
machine types. All optimizations are internal — no public API changes.
41+
See [#592](https://github.com/fgmacedo/python-statemachine/pull/592) for details.
42+
43+
44+
### Thread safety documentation
45+
46+
The sync engine is thread-safe: multiple threads can send events to the same state
47+
machine instance concurrently. This is now documented in the
48+
{ref}`processing model <thread-safety>` and verified by stress tests.
49+
[#592](https://github.com/fgmacedo/python-statemachine/pull/592).
50+
51+
3652
### Bugfixes in 3.1.0
3753

3854
- Fixes silent misuse of `Event()` with multiple positional arguments. Passing more than one

0 commit comments

Comments
 (0)