Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/appccelerate/statemachine
A .net library that lets you build state machines (hierarchical, async with fluent definition syntax and reporting capabilities).
https://github.com/appccelerate/statemachine
c-sharp dotnet state-machine
Last synced: about 1 month ago
JSON representation
A .net library that lets you build state machines (hierarchical, async with fluent definition syntax and reporting capabilities).
- Host: GitHub
- URL: https://github.com/appccelerate/statemachine
- Owner: appccelerate
- License: apache-2.0
- Created: 2014-01-03T07:06:05.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2020-01-08T07:36:31.000Z (almost 5 years ago)
- Last Synced: 2024-08-04T02:09:20.258Z (5 months ago)
- Topics: c-sharp, dotnet, state-machine
- Language: C#
- Homepage:
- Size: 1.39 MB
- Stars: 483
- Watchers: 23
- Forks: 128
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
I'm working on moving the documention from www.appccelerate.com (where it is not up-to-date :-( ) to here because it is less time consuming to update the documentation.
## Features
- use enums, ints, strings or your own class for states and events - resulting in single class state machines.
- transition, entry and exit actions.
- transition guards
- hierarchical states with history behavior to initialize state always to same state or last active state.
- supports async/await
- fluent definition syntax.
- passive state machine handles state transitions synchronously.
- active state machine handles state transitions asynchronously on the worker thread of the state machine.
- active state machine is thread-safe
- current state, queued events and history states can be persisted
- extension support to extend functionality of state machine.
- extensible thorough logging simplifies debugging.
- state machine reports as text, csv or yEd diagram. Or write your own report.
## StateMachine
Appccelerate contains four different state machines:
- Passive State Machine
- Active State Machine
- Async Passive State Machine
- Async Active State Machine
Both async and not-async variants implement an interface called `IStateMachine`. For better testability and flexibility, I suggest that you reference your state machine only by the interface and use dependency injection to get either of the implementations. You can use then a passive state machine as a replacement for an active one in your tests to simplify the tests because everything is run on the same thread.
### States and Events
A state machine is defined using States and Events. States and events have to be `IComparables` (`enum`, `int`, `string`, ...). If you have a well known set of states and events then I suggest you use enums which make the code much more readable. If you plan to build some flexibility into your state machine (e.g. add states, transitions in base classes) then you better use an "open" type like `string` or `integer`.
### Transitions
Transitions are state switches that are executed in response to an event that was fired onto the state machine. You can define per state and event which transition is taken and therefore which state to go to.
### Actions
You can define actions either on transitions or on entry or exit of a state. Transition actions are executed when the transition is taken as the response to an event. The entry and exit actions of a state are excuted when the state machine enters or exits the state due to a taken transition. In case of hierarchical states, multiple entry and exit actions can be executed.
### Guards
Guards give you the possibility to decide which transition is executed depending on a boolean criteria. When an event is fired onto the state machine, it takes all transitions defined in the current state for the fired event and executes the first transition with a guard returning true.
### Extensions
Extensions can be used to extend the functionality of the state machine. They provide for example a simple way to write loggers.
### Reports
Out of the box, Appccelerate provides a textual report, a csv report and a yEd diagram reporter. You can add your own reports by just implementing `IStateMachineReport`.
## Simple Sample State Machine
```c#
public class SimpleStateMachine
{
private enum States
{
On,
Off
}
private enum Events
{
TurnOn,
TurnOff
}
private readonly PassiveStateMachine machine;
public SimpleStateMachine()
{
var builder = new StateMachineDefinitionBuilder();
builder
.In(States.Off)
.On(Events.TurnOn)
.Goto(States.On)
.Execute(SayHello);
builder
.In(States.On)
.On(Events.TurnOff)
.Goto(States.Off)
.Execute(SayBye);
builder
.WithInitialState(States.Off);
machine = builder
.Build()
.CreatePassiveStateMachine();
machine.Start();
}
public void TurnOn()
{
machine
.Fire(
Events.TurnOn);
}
public void TurnOff()
{
machine
.Fire(
Events.TurnOff);
}
private void SayHello()
{
Console.WriteLine("hello");
}
private void SayBye()
{
Console.WriteLine("bye");
}
}
```
## More Documentation
- [Tutorial](documentation/tutorial.md)
- [Example](documentation/example.md)
- [Migrating to V5.x](documentation/migratingToV5.md)