module StateMachine::EvalHelpers
Provides a set of helper methods for evaluating methods within the context of an object.
Public Instance Methods
evaluate_method(object, method, *args, &block)
click to toggle source
Evaluates one of several different types of methods within the context of the given object. Methods can be one of the following types:
-
Symbol
-
Method / Proc
-
String
Examples¶ ↑
Below are examples of the various ways that a method can be evaluated on an object:
class Person def initialize(name) @name = name end def name @name end end class PersonCallback def self.run(person) person.name end end person = Person.new('John Smith') evaluate_method(person, :name) # => "John Smith" evaluate_method(person, PersonCallback.method(:run)) # => "John Smith" evaluate_method(person, Proc.new {|person| person.name}) # => "John Smith" evaluate_method(person, lambda {|person| person.name}) # => "John Smith" evaluate_method(person, '@name') # => "John Smith"
Additional arguments¶ ↑
Additional arguments can be passed to the methods being evaluated. If the method defines additional arguments other than the object context, then all arguments are required.
For example,
person = Person.new('John Smith') evaluate_method(person, lambda {|person| person.name}, 21) # => "John Smith" evaluate_method(person, lambda {|person, age| "#{person.name} is #{age}"}, 21) # => "John Smith is 21" evaluate_method(person, lambda {|person, age| "#{person.name} is #{age}"}, 21, 'male') # => ArgumentError: wrong number of arguments (3 for 2)
# File lib/state_machine/eval_helpers.rb 53 def evaluate_method(object, method, *args, &block) 54 case method 55 when Symbol 56 object.method(method).arity == 0 ? object.send(method, &block) : object.send(method, *args, &block) 57 when Proc, Method 58 args.unshift(object) 59 arity = method.arity 60 61 # Procs don't support blocks in < Ruby 1.9, so it's tacked on as an 62 # argument for consistency across versions of Ruby 63 if block_given? && Proc === method && arity != 0 64 if [1, 2].include?(arity) 65 # Force the block to be either the only argument or the 2nd one 66 # after the object (may mean additional arguments get discarded) 67 args = args[0, arity - 1] + [block] 68 else 69 # Tack the block to the end of the args 70 args << block 71 end 72 else 73 # These method types are only called with 0, 1, or n arguments 74 args = args[0, arity] if [0, 1].include?(arity) 75 end 76 77 method.call(*args, &block) 78 when String 79 eval(method, object.instance_eval {binding}, &block) 80 else 81 raise ArgumentError, 'Methods must be a symbol denoting the method to call, a block to be invoked, or a string to be evaluated' 82 end 83 end