keyme / mortise

Mortise - A python state machine framework

Mortise is a synchronous state machine library for event based systems.

Features

• Synchronous state-machine event handling
• No external dependencies
• Composable / Reusable state support via pushdown automata
• State timeout and retry limit support
• Directed exception handling + state transitions on exception
• State machine visualization (requires graphviz)

Requirements

• Python >= 3.4
• GraphViz (Optional for state machine visualization)

Examples

See the examples folder.

Authors

Mortise was developed at Keyme by Jeff Ciesielski and Lianne Lairmore

mortise's Issues

Timeouts, retries don't work when a state returns True

Found this morning, I'd changed a state to return True rather than None, and all of a sudden timeouts in that state didn't work. I changed it back, and they do. @knitHacker looked into it just now and says that when we return True we run the on_leave method, which will reset both the timers and the retries. That seems unexpected to me.

@Jeff-Ciesielski

Mortise testing framework doesn't support state returning None

States can return None and rerun their on_state decorators. The mortise testing framework doesn't support this sort of a transition and seems to get hung if you do attempt to test this state transition.