Contents

# encoding: utf-8

module FiniteMachine
  # A class responsible for defining event methods on state machine
  #
  # Used to add event definitions from {TransitionBuilder} to
  # the {StateMachine} to obtain convenience helpers.
  #
  # @api private
  class EventDefinition
    include Threadable

    # The current state machine
    attr_threadsafe :machine

    # Initialize an EventDefinition
    #
    # @param [StateMachine] machine
    #
    # @api private
    def initialize(machine)
      self.machine = machine
    end

    # Define transition event names as state machine events
    #
    # @param [Symbol] event_name
    #   the event name for which definition is created
    #
    # @return [nil]
    #
    # @api public
    def apply(event_name, silent = false)
      define_event_transition(event_name, silent)
      define_event_bang(event_name, silent)
    end

    private

    # Define transition event
    #
    # @param [Symbol] event_name
    #   the event name
    #
    # @param [Boolean] silent
    #   if true don't trigger callbacks, otherwise do
    #
    # @return [nil]
    #
    # @api private
    def define_event_transition(event_name, silent)
      machine.send(:define_singleton_method, event_name) do |*data, &block|
        if silent
          machine.transition(event_name, *data, &block)
        else
          machine.trigger(event_name, *data, &block)
        end
      end
    end

    # Define event that skips validations and callbacks
    #
    # @param [Symbol] event_name
    #   the event name
    #
    # @param [Boolean] silent
    #   if true don't trigger callbacks, otherwise do
    #
    # @return [nil]
    #
    # @api private
    def define_event_bang(event_name, silent)
      machine.send(:define_singleton_method, "#{event_name}!") do |*data, &block|
        if silent
          machine.transition!(event_name, *data, &block)
        else
          machine.trigger!(event_name, *data, &block)
        end
      end
    end
  end # EventBuilder
end # FiniteMachine

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
finite_machine-0.11.3	lib/finite_machine/event_definition.rb
finite_machine-0.11.2	lib/finite_machine/event_definition.rb
finite_machine-0.11.1	lib/finite_machine/event_definition.rb
finite_machine-0.11.0	lib/finite_machine/event_definition.rb