XState for Python - work in progress!

from xstate import Machine

lights = Machine(
    {
        "id": "lights",
        "initial": "green",
        "states": {
            "green": {"on": {"TIMER": "yellow"},},
            "yellow": {"on": {"TIMER": "red"}},
            "red": {"on": {"TIMER": "green"}},
        },
    }
)

state = lights.initial_state # state.value is green

state = lights.transition(state, "TIMER") # state.value is yellow
state = lights.transition(state, "TIMER") # state.value is red
state = lights.transition(state, "TIMER") # state.value is green again

More advanced examples in the "examples" folder

You can set up your development environment in two different ways.

Prerequisites

• VS Code IDE and Remote Containers extension

Steps

1. Open the folder in a container. This will setup your environment with python (including python and pylance extensions), dependencies and download scxml tests.
2. Run poetry run pytest --cov to run the tests! 👩‍🔬 (or run the Run tests task via VS Code or using VS Code Test explorer where you can debug as well)

Prerequisites

• poetry for package and dependency management

Steps

1. Run poetry install to create a virtual environment
2. Make sure test files are present and up to date by running git submodule update --init
3. Run poetry run pytest --cov to run the tests! 👩‍🔬 (or run the Run tests task via VS Code or using VS Code Test explorer where you can debug as well)

SCXML tests are ran from the SCION Test Framework module.

• finite-state-machine
• Sismic for Python
• Miros
• Automat