statomata 0.1.0

a strictly typed, flexible library for building and running state machines in Python

Statomata

Statomata is a strictly typed, flexible library for building and running finite state machines (FSMs) and automata in Python. It provides core automata implementations out of the box and lets you define custom states and state management logic.

Features

• 🧠 State Interface & Context: Follow the state machine pattern with clear, isolated state definitions.
• ⚡ Built-in Automata: Unary, async unary, unary iterable, and async iterable automata.
• 🏗 Custom Automata Support: Build your own automata with custom state management logic.
• ✅ Strict Typing: Designed for type safety and clarity with full type hints.

Installation

pip install statomata

Quick Start

Define your states:

from statomata.abc import State, Context


class OpenState(State[str, str]):
    def handle(self, income: str, context: Context[State[str, str]]) -> str:
        if income == "close":
            context.set_state(ClosedState())
            return "Closed"

        return "Still open"


class ClosedState(State[str, str]):
    def handle(self, income: str, context: Context[State[str, str]]) -> str:
        if income == "open":
            context.set_state(OpenState())
            return "Opened"

        return "Still closed"

Run the state machine with a built-in automaton:

from statomata.sdk import create_unary_sm

sm = create_unary_sm(OpenState())

print(sm.run("close"))  # Output: Closed
print(sm.run("open"))  # Output: Opened