Class: Puppet::Pops::Visitor Private
Overview
This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.
configured to handle a given visiting object.
Constant Summary collapse
- NO_ARGS =
This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.
EMPTY_ARRAY
Instance Attribute Summary collapse
- #cache ⇒ Object readonly private
- #max_args ⇒ Object readonly private
- #message ⇒ Object readonly private
- #min_args ⇒ Object readonly private
- #receiver ⇒ Object readonly private
Instance Method Summary collapse
-
#initialize(receiver, message, min_args = 0, max_args = nil) ⇒ Visitor
constructor
private
A new instance of Visitor.
-
#visit(thing, *args) ⇒ Object
private
Visit the configured receiver.
-
#visit_this(receiver, thing, args) ⇒ Object
private
Visit an explicit receiver.
-
#visit_this_0(receiver, thing) ⇒ Object
private
Visit an explicit receiver with 0 args (This is ~30% faster than calling the general method).
-
#visit_this_1(receiver, thing, arg) ⇒ Object
private
Visit an explicit receiver with 1 args (This is ~30% faster than calling the general method).
-
#visit_this_2(receiver, thing, arg1, arg2) ⇒ Object
private
Visit an explicit receiver with 2 args (This is ~30% faster than calling the general method).
-
#visit_this_3(receiver, thing, arg1, arg2, arg3) ⇒ Object
private
Visit an explicit receiver with 3 args (This is ~30% faster than calling the general method).
-
#visit_this_class(receiver, clazz, args) ⇒ Object
private
Visit an explicit receiver.
Constructor Details
#initialize(receiver, message, min_args = 0, max_args = nil) ⇒ Visitor
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns a new instance of Visitor.
16 17 18 19 20 21 22 23 24 25 |
# File 'lib/puppet/pops/visitor.rb', line 16 def initialize(receiver, , min_args=0, max_args=nil) raise ArgumentError.new("min_args must be >= 0") if min_args < 0 raise ArgumentError.new("max_args must be >= min_args or nil") if max_args && max_args < min_args @receiver = receiver @message = @min_args = min_args @max_args = max_args @cache = Hash.new end |
Instance Attribute Details
#cache ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
15 16 17 |
# File 'lib/puppet/pops/visitor.rb', line 15 def cache @cache end |
#max_args ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
15 16 17 |
# File 'lib/puppet/pops/visitor.rb', line 15 def max_args @max_args end |
#message ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
15 16 17 |
# File 'lib/puppet/pops/visitor.rb', line 15 def @message end |
#min_args ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
15 16 17 |
# File 'lib/puppet/pops/visitor.rb', line 15 def min_args @min_args end |
#receiver ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
15 16 17 |
# File 'lib/puppet/pops/visitor.rb', line 15 def receiver @receiver end |
Instance Method Details
#visit(thing, *args) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Visit the configured receiver
28 29 30 |
# File 'lib/puppet/pops/visitor.rb', line 28 def visit(thing, *args) visit_this(@receiver, thing, args) end |
#visit_this(receiver, thing, args) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Visit an explicit receiver
35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 |
# File 'lib/puppet/pops/visitor.rb', line 35 def visit_this(receiver, thing, args) raise "Visitor Error: Too few arguments passed. min = #{@min_args}" unless args.length >= @min_args if @max_args raise "Visitor Error: Too many arguments passed. max = #{@max_args}" unless args.length <= @max_args end method_name = @cache[thing.class] if method_name return receiver.send(method_name, thing, *args) else thing.class.ancestors().each do |ancestor| name = ancestor.name next if name.nil? method_name = :"#{@message}_#{name.split(DOUBLE_COLON).last}" next unless receiver.respond_to?(method_name, true) @cache[thing.class] = method_name return receiver.send(method_name, thing, *args) end end raise "Visitor Error: the configured receiver (#{receiver.class}) can't handle instance of: #{thing.class}" end |
#visit_this_0(receiver, thing) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Visit an explicit receiver with 0 args (This is ~30% faster than calling the general method)
81 82 83 84 85 86 87 |
# File 'lib/puppet/pops/visitor.rb', line 81 def visit_this_0(receiver, thing) method_name = @cache[thing.class] if method_name return receiver.send(method_name, thing) end visit_this(receiver, thing, NO_ARGS) end |
#visit_this_1(receiver, thing, arg) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Visit an explicit receiver with 1 args (This is ~30% faster than calling the general method)
92 93 94 95 96 97 98 |
# File 'lib/puppet/pops/visitor.rb', line 92 def visit_this_1(receiver, thing, arg) method_name = @cache[thing.class] if method_name return receiver.send(method_name, thing, arg) end visit_this(receiver, thing, [arg]) end |
#visit_this_2(receiver, thing, arg1, arg2) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Visit an explicit receiver with 2 args (This is ~30% faster than calling the general method)
103 104 105 106 107 108 109 |
# File 'lib/puppet/pops/visitor.rb', line 103 def visit_this_2(receiver, thing, arg1, arg2) method_name = @cache[thing.class] if method_name return receiver.send(method_name, thing, arg1, arg2) end visit_this(receiver, thing, [arg1, arg2]) end |
#visit_this_3(receiver, thing, arg1, arg2, arg3) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Visit an explicit receiver with 3 args (This is ~30% faster than calling the general method)
114 115 116 117 118 119 120 |
# File 'lib/puppet/pops/visitor.rb', line 114 def visit_this_3(receiver, thing, arg1, arg2, arg3) method_name = @cache[thing.class] if method_name return receiver.send(method_name, thing, arg1, arg2, arg3) end visit_this(receiver, thing, [arg1, arg2, arg3]) end |
#visit_this_class(receiver, clazz, args) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Visit an explicit receiver
57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 |
# File 'lib/puppet/pops/visitor.rb', line 57 def visit_this_class(receiver, clazz, args) raise "Visitor Error: Too few arguments passed. min = #{@min_args}" unless args.length >= @min_args if @max_args raise "Visitor Error: Too many arguments passed. max = #{@max_args}" unless args.length <= @max_args end method_name = @cache[clazz] if method_name return receiver.send(method_name, clazz, *args) else clazz.ancestors().each do |ancestor| name = ancestor.name next if name.nil? method_name = :"#{@message}_#{name.split(DOUBLE_COLON).last}" next unless receiver.respond_to?(method_name, true) @cache[clazz] = method_name return receiver.send(method_name, clazz, *args) end end raise "Visitor Error: the configured receiver (#{receiver.class}) can't handle instance of: #{clazz}" end |