state_machine v0.1.4 StateMachine.Transition

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()
callback_pos() :: :before | :after

Link to this type

t(model)
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

Private function for running Transition callbacks.

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

Link to this function

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

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

Link to this function

loop?(arg1)
loop?(t(any())) :: 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:

  • 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)
update_state(StateMachine.Context.t(model)) :: StateMachine.Context.t(model)

Private function for updating state.