finiteautomata 1.0

A more intuitive way to create finite automata diagrams.

finiteautomata

A more intuitive way to create finite automata diagrams.

Features

• Define start, accept, and intermediate states.
• Add transitions (including self-loops), can also chain multiple transitions.
• Render state diagrams (using Graphviz under the hood).

Installation

pip install finiteautomata

To use the finiteautomata package in your code:

from finiteautomata import FiniteAutomata

# Create instance of FiniteAutomata
fsm = FiniteAutomata()

Syntax Documentation

• state(state: str)
  Adds a state to the automata.
  Usage:

  fsm.state('q0')
  

• start(state: str)
  Sets the starting state of the automata. If the state does not already exist, it will be created.
  Usage:

  fsm.start('q0')
  

• accept(state: str)
  Marks a state as an accepting state. Accept states are displayed with a double circle in the diagram.
  Usage:

  fsm.accept('q1')
  

• transition(from_state: str, symbol: str, to_state: str)
  Adds a transition from one state to another, where the symbol denotes the input triggering the transition.
  Self-loops are supported by setting from_state equal to to_state.
  Usage:

  fsm.transition('q0', 'a', 'q1')  # Transition from q0 to q1 on input 'a'
  fsm.transition('q1', 'b', 'q1')  # Self-loop on q1 for input 'b'
  

• draw(filename: str = 'fsm', format: str = 'png', view: bool = False)
  Renders the finite automata as a diagram using Graphviz.

  • filename: Base name for the output file (without extension).
  • format: File format (e.g., 'png', 'pdf').
  • view: If set to True, the diagram is automatically opened after rendering.

  Usage:

  fsm.draw('my_automata', view=True)
  

  The method groups transitions with the same source and destination, listing multiple symbols where applicable.