feat: Add probabilistic transitions with weighted random selection #538
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add support for weighted transitions that allow non-deterministic state transitions based on configurable probabilities. This is useful for game AI, simulations, and randomized workflows. Key features: - Add optional 'weight' parameter to Transition class - Add optional 'random_seed' parameter to StateMachine for deterministic testing - Implement weighted selection in both sync and async engines - Automatically display probability percentages in state diagrams - Full backward compatibility (no weights = original first-match behavior) - Zero/negative weights are ignored - Conditions (guards/validators) work seamlessly with weighted transitions - Complete pickling support Changes: - statemachine/transition.py: Add weight parameter and repr support - statemachine/statemachine.py: Add random_seed and Random instance - statemachine/engines/sync.py: Implement weighted selection logic - statemachine/engines/async_.py: Implement weighted selection logic - statemachine/contrib/diagram.py: Add probability labels to diagrams - README.md: Add probabilistic transitions to features list - docs/transitions.md: Add comprehensive documentation with examples - tests/test_probabilistic_transitions.py: 20 comprehensive tests - tests/examples/game_character_idle_machine.py: Working example All 348 existing tests pass + 20 new tests = 368 total passing tests
|
|
Closing to reopen from clean branch |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add support for weighted transitions that allow non-deterministic state transitions based on configurable probabilities. This is useful for game AI, simulations, and randomized workflows.
Key features:
Changes:
All 348 existing tests pass + 20 new tests = 368 total passing tests