Struct StateMachine 

pub struct StateMachine<Ctx, S: ?Sized> { /* private fields */ }

Queue-based state machine interpreter.

Processes a sequence of State objects, collecting key-value outputs into a JSON map. When every state has completed and the queue is empty, advance() returns Some(Value) containing the accumulated results.

Implementations

impl<Ctx, S: State<Ctx, S> + ?Sized> StateMachine<Ctx, S>

pub fn new(queue: VecDeque<Box<S>>) -> Self

pub fn start(&mut self, ctx: &Ctx) -> Option<Value>

Activate the first state in the queue.

Returns Some(Value) immediately if the queue is empty (nothing to do), or None if a state was activated and the machine is running.

pub fn advance(&mut self, action: Option<Action>, ctx: &Ctx) -> Option<Value>

Step the machine forward by dispatching an optional action to the current state. None action triggers a tick; Some(action) triggers handle_action.

Returns None while the machine is still running, or Some(Value) with the accumulated results when every state has completed.

pub fn current_state(&self) -> Option<&S>

pub fn current_state_mut(&mut self) -> Option<&mut S>

pub fn finish(&mut self) -> Value

Drain the machine and return accumulated results immediately.