class Transitions::StateTransition
Attributes
from[R]
guard[R]
on_transition[R]
to[R]
Public Class Methods
new(opts)
click to toggle source
TODO: `from` and `to` should be private as well
# File lib/transitions/state_transition.rb, line 7 def initialize(opts) @from = opts[:from] @to = opts[:to] @guard = opts[:guard] @on_transition = opts[:on_transition] @options = opts end
Public Instance Methods
==(other)
click to toggle source
# File lib/transitions/state_transition.rb, line 63 def ==(other) @from == other.from && @to == other.to end
executable?(obj, *args)
click to toggle source
@param obj [Any] - the subject @param args [Array<Symbol>] - any arguments passed into the transition method
E.g. something like car.drive!(:fast, :now) with `car` being the subject and `drive` the transition method would result in `args` looking like this: [:fast, :now]
@return [Bool]
# File lib/transitions/state_transition.rb, line 26 def executable?(obj, *args) [@guard].flatten.all? { |g| perform_guard(obj, g, *args) } end
execute(obj, *args)
click to toggle source
@param obj [Any] - the subject @param args [Array<Symbol>] - any arguments passed into the transition method
E.g. something like car.drive!(:fast, :now) with `car` being the subject and `drive` the transition method would result in `args` looking like this: [:fast, :now]
@return [void]
rubocop:disable Metrics/MethodLength
# File lib/transitions/state_transition.rb, line 43 def execute(obj, *args) case @on_transition when Symbol, String obj.send(@on_transition, *args) when Proc @on_transition.call(obj, *args) when Array @on_transition.each do |callback| # Yes, we're passing always the same parameters for each callback in here. # We should probably drop args altogether in case we get an array. obj.send(callback, *args) end else # TODO: We probably should check for this in the constructor and not that late. fail ArgumentError, "You can only pass a Symbol, a String, a Proc or an Array to 'on_transition'"\ " - got #{@on_transition.class}." unless @on_transition.nil? end end
from?(value)
click to toggle source
# File lib/transitions/state_transition.rb, line 67 def from?(value) @from == value end
Private Instance Methods
perform_guard(obj, guard, *args)
click to toggle source
# File lib/transitions/state_transition.rb, line 73 def perform_guard(obj, guard, *args) if guard.respond_to?(:call) guard.call(obj, *args) elsif guard.is_a?(Symbol) || guard.is_a?(String) obj.send(guard, *args) else true end end