sam

Sam

Sam is the finite state machine engine.

You can define state diagram by adding Transitions and add transition hooks.

Usage

Add to project using go get

go get git.ooo.ua/pub/sam

Examples

• Without hooks

package main

import (
	"fmt"
	"git.ooo.ua/pub/sam"
)

const (
	WStateDisabled    sam.State = "Disabled"
	WStateEnabled     sam.State = "Enabled"
	WStateInitialized sam.State = "Initialized"
	WStateRun         sam.State = "Run"
	WStateStopped     sam.State = "Stopped"
	WStateFailed      sam.State = "Failed"
)

// newWorkerSM returns filled state machine of worker lifecycle
//
// (*) -> [Disabled] -> [Enabled] -> [Initialized] -> [Run] <-> [Stopped]
//          ↑ ↑____________|  |          |  |  ↑         |
//          |_________________|__________|  |  |------|  ↓
//                            |-------------|-----> [Failed]
func main() {
	var err error
	workerSM := sam.NewStateMachine()
	workerSM.AddTransitions(WStateDisabled, WStateEnabled).
		AddTransitions(WStateEnabled, WStateInitialized, WStateFailed, WStateDisabled).
		AddTransitions(WStateInitialized, WStateRun, WStateFailed, WStateDisabled).
		AddTransitions(WStateRun, WStateStopped, WStateFailed).
		AddTransitions(WStateStopped, WStateRun).
		AddTransitions(WStateFailed, WStateInitialized, WStateDisabled)
	worker, err := workerSM.Finalize(WStateDisabled)
	if err != nil || worker == nil {
		fmt.Println("init failed: ", err)
	}
	clone := worker.Clone()

	err = clone.GoTo(WStateEnabled)
	if err != nil {
		fmt.Println("error: ", err)
	}
}