XStateNet 1.0.1

XStateNet

.NET implementation of the finite state machine framework. Powerful and asynchronous framework to build and run finite state machines in .NET.

Main Features

1. Declarative state machine building and running in asynchronous mode, with awaiting or without (non blocking the main thread);
2. States can execute delegate with callback to generate multiple events and have various state switch transitions, as well as asynchronous actions to switch state on action done or error; Each service can execute also another state machine and move to another state on machine done or error;
3. Side effects for each state: actions on state enter, on state exit. Activities - long running awaitable and task with cleanup method that runs while machine is in the certain state but that action can't affect state machine.
4. Additional service types and modes for state: transient state, timeout service, final state;

Main Classes

State

The main state class, compose the class with chained methods to fill it with services, actions or activities.

• Services are methods that are executed and their goal is to change the state machine state;
• Actions are "fire and forget" methods that are running on state is entered and/or on state is exited. This is a good place to do some initialization and cleanup work.
• Activities are long running methods that can do any long running parallel work together with services but they can't affect state machine state.

StateMachine

The state machine class, that has a collection of states and initial state to start execution from.

Interpreter

The state machine interpreter or the state machine runner, the main goal of this class instance is to start state machine execution.

It can await until state machine is done, or subscribe for event in case the state machine is started in the background thread without using awaitable start method.

More information can be found on the project's GitHub repository.