StateMachine.Transition (state_machine v0.1.6)

Transition module gathers together all of the actions that happen around transition from the old state to the new state in response to an event.

Link to this section Summary

Functions

Private function for running Transition callbacks.

Private function sets status to :done, unless it has failed before.

Checks if the transition is allowed in the current context. Returns boolean.

True if transition is a loop, i.e. doesn't change state.

Given populated context and Transition structure, sequentially runs all callbacks along with actual state update

Private function for updating state.

Link to this section Types

Link to this type

callback_pos()

Specs

callback_pos() :: :before | :after

Specs

t(model) :: %StateMachine.Transition{
  after: [StateMachine.Callback.t(model)],
  before: [StateMachine.Callback.t(model)],
  from: atom(),
  guards: [StateMachine.Guard.t(model)],
  to: atom()
}

Link to this section Functions

Link to this function

callback(ctx, pos)

Specs

Private function for running Transition callbacks.

Specs

finalize(StateMachine.Context.t(model)) :: StateMachine.Context.t(model)

Private function sets status to :done, unless it has failed before.

Link to this function

is_allowed?(ctx, transition)

Specs

is_allowed?(StateMachine.Context.t(model), t(model)) :: boolean()

Checks if the transition is allowed in the current context. Returns boolean.

Specs

loop?(t(any())) :: boolean()

True if transition is a loop, i.e. doesn't change state.

Specs

Given populated context and Transition structure, sequentially runs all callbacks along with actual state update:

  • before(event)
  • before(transition)
  • before_leave(state)
  • before_enter(state)
  • (state update)
  • after_leave(state)
  • after_enter(state)
  • after(transition)
  • after(event)

If any of the callbacks fails, all sequential ops are cancelled.

Link to this function

update_state(ctx)

Specs

update_state(StateMachine.Context.t(model)) :: StateMachine.Context.t(model)

Private function for updating state.