Is this in a state (🤣) that I could try it out? I have several use-cases where the sub-state functionality would be useful and I'd be glad to give feedback if I run into issues.

Note, the user experience I had expected looked something like this:

class SubMachine(StateMachine):
 test = State(initial=True)
 test_complete = State(final=True)
 next = test.to(test_complete)
class TestSM(StateMachine):
 initial_state = State(initial=True)
 sub_machine_as_state = SubMachine()
 some_other_state = State(final=True)
 goto_sub_machine = initial_state.to(sub_machine_as_state)
 goto_finish = sub_machine_as_state.to(some_other_state)

And then something like

sm = TestSM()
sm.send('goto_sub_machine')
sm.send('next') # TestSM now has the submachine states as states it can traverse.
sm.send('goto_finish')

@comalice Thanks for your interest on this. I think the internals are usable, but the external API may still change as I've not yet finished documenting and exploring examples using the Python API.

There are many new *.scxml files that I've used to fine tune the internal behaviour for composite and parallel states, and the create_machine_class_from_definition is more stable and mature as a way to construct the statemachine from a dict-like definition similar to the way SCXML works. I'm planning to also add a YAML parser.

The only notable non implemented feature is the <invoke> and thus cross sending events between distinct statemachines.

Note, the user experience I had expected looked something like this:

class SubMachine(StateMachine):
 test = State(initial=True)
 test_complete = State(final=True)
 next = test.to(test_complete)
class TestSM(StateMachine):
 initial_state = State(initial=True)
 sub_machine_as_state = SubMachine()
 some_other_state = State(final=True)
 goto_sub_machine = initial_state.to(sub_machine_as_state)
 goto_finish = sub_machine_as_state.to(some_other_state)

I may try to implement this syntax, but I think that will be hard to get it right. The initial proposal that I'm implement is the one that is in the description, using the internal namespace of nested Parallel and Compose classes to build hierarchy.

Feel free to fork and test, please let me know if you expecience any issues.

Since this got into a huge PR and almost stable, I'm considering merging and finish the work with smaller PRs.

Quality Gate Failed Quality Gate failed

Failed conditions
4 Security Hotspots

See analysis details on SonarQube Cloud