python-states 1.0.0

A package for abstracting state machine logic

Python States

Initially created for HackPSU Spring 2026

Available on PyPi

State Machines are great. Programming them isn't. python_states solves this issue by abstracting away all of the boilerplate emulation and transition handling. As a result, implementing a state machine is as simple as defining a state transition matrix and providing a starting state.

Usage

Python States is packaged and available on PyPi;

pip install python-states

Development Instructions

1. Clone the repository:

git clone [e-mail]:tedtasman/python_states.git

2. Install dependencies with uv:

uv sync

3. Run the project:

uv run python main.py

Future work

1. Concurrent execution, which would add support for NFAs and other non-deterministic state machines
2. Documentation...