Class: Puppet::Pops::Evaluator::Runtime3Converter

Inherits:
Object
  • Object
show all
Defined in:
lib/puppet/pops/evaluator/runtime3_converter.rb

Overview

Runtime3Converter.map_args, or Runtime3Converter.instance should be used

Direct Known Subclasses

Runtime3FunctionArgumentConverter

Constant Summary collapse

MAX_INTEGER = 
Puppet::Pops::MAX_INTEGER
MIN_INTEGER = 
Puppet::Pops::MIN_INTEGER

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.convert(o, scope, undef_value) ⇒ Object

Converts 4x supported values to a 3x values. Same as calling Runtime3Converter.instance.convert(…)

Parameters:

Returns:

  • (Object) —

    The converted value

 33 34 35
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 33 def self.convert(o, scope, undef_value) @instance.convert(o, scope, undef_value) end

.instance ⇒ Runtime3Converter

Returns the singleton instance of this class.

Returns:

 39 40 41
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 39 def self.instance @instance end

.map_args(args, scope, undef_value) ⇒ Array

Converts 4x supported values to a 3x values. Same as calling Runtime3Converter.instance.map_args(…)

Parameters:

  • args (Array) —

    Array of values to convert

  • scope (Puppet::Parser::Scope) —

    The scope to use when converting

  • undef_value (Object) —

    The value that nil is converted to

Returns:

  • (Array) —

    The converted values

 22 23 24
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 22 def self.map_args(args, scope, undef_value) @instance.map_args(args, scope, undef_value) end

Instance Method Details

#catalog_type_to_split_type_title(catalog_type) ⇒ Object

Produces an array with [type, title] from a PCatalogEntryType This method is used to produce the arguments for creation of reference resource instances (used when 3x is operating on a resource). Ensures that resources are not absolute.

 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 137 def catalog_type_to_split_type_title(catalog_type) split_type = catalog_type.is_a?(Puppet::Pops::Types::PTypeType) ? catalog_type.type : catalog_type case split_type when Puppet::Pops::Types::PClassType class_name = split_type.class_name ['class', class_name.nil? ? nil : class_name.sub(/^::/, '')] when Puppet::Pops::Types::PResourceType type_name = split_type.type_name title = split_type.title if type_name =~ /^(::)?[Cc]lass$/ ['class', title.nil? ? nil : title.sub(/^::/, '')] else # Ensure that title is '' if nil  # Resources with absolute name always results in error because tagging does not support leading ::  [type_name.nil? ? nil : type_name.sub(/^::/, '').downcase, title.nil? ? '' : title] end else # TRANSLATORS 'PClassType' and 'PResourceType' are Puppet types and should not be translated  raise ArgumentError, _("Cannot split the type %{class_name}, it represents neither a PClassType, nor a PResourceType.") % { class_name: catalog_type.class } end end

#convert(o, scope, undef_value) ⇒ Object

Converts a 4x supported value to a 3x value.

Parameters:

Returns:

  • (Object) —

    The converted value

 61 62 63
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 61 def convert(o, scope, undef_value) @convert_visitor.visit_this_2(self, o, scope, undef_value) end

#convert_Array(o, scope, undef_value) ⇒ Object 

 95 96 97 98
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 95 def convert_Array(o, scope, undef_value) ic = @inner_converter o.map { |x| ic.convert(x, scope, undef_value) } end

#convert_BigDecimal(o, scope, undef_value) ⇒ Object

Raises:

 76 77 78 79 80 81 82
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 76 def convert_BigDecimal(o, scope, undef_value) # transform to same value float value if possible without any rounding error  f = o.to_f return f unless f != o raise Puppet::Error, "Use of a Ruby BigDecimal value outside Puppet Float range, got '#{o}'" end

#convert_Hash(o, scope, undef_value) ⇒ Object 

 100 101 102 103 104 105
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 100 def convert_Hash(o, scope, undef_value) result = {} ic = @inner_converter o.each { |k, v| result[ic.convert(k, scope, undef_value)] = ic.convert(v, scope, undef_value) } result end

#convert_Integer(o, scope, undef_value) ⇒ Object

Raises:

 69 70 71 72 73 74
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 69 def convert_Integer(o, scope, undef_value) return o unless o < MIN_INTEGER || o > MAX_INTEGER range_end = o > MAX_INTEGER ? 'max' : 'min' raise Puppet::Error, "Use of a Ruby Integer outside of Puppet Integer #{range_end} range, got '#{'0x%x' % o}'" end

#convert_Iterator(o, scope, undef_value) ⇒ Object

Raises:

 107 108 109
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 107 def convert_Iterator(o, scope, undef_value) raise Puppet::Error, _('Use of an Iterator is not supported here') end

#convert_NilClass(o, scope, undef_value) ⇒ Object 

 65 66 67
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 65 def convert_NilClass(o, scope, undef_value) @inner ? nil : undef_value end

#convert_Object(o, scope, undef_value) ⇒ Object 

 91 92 93
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 91 def convert_Object(o, scope, undef_value) o end

#convert_PAnyType(o, scope, undef_value) ⇒ Object 

 117 118 119
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 117 def convert_PAnyType(o, scope, undef_value) o end

#convert_PCatalogEntryType(o, scope, undef_value) ⇒ Object 

 121 122 123 124 125 126 127 128 129 130
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 121 def convert_PCatalogEntryType(o, scope, undef_value) # Since 4x does not support dynamic scoping, all names are absolute and can be  # used as is (with some check/transformation/mangling between absolute/relative form  # due to Puppet::Resource's idiosyncratic behavior where some references must be  # absolute and others cannot be.  # Thus there is no need to call scope.resolve_type_and_titles to do dynamic lookup.  t, title = catalog_type_to_split_type_title(o) t = Runtime3ResourceSupport.find_resource_type(scope, t) unless t == 'class' || t == 'node' Puppet::Resource.new(t, title) end

#convert_String(o, scope, undef_value) ⇒ Object 

 84 85 86 87 88 89
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 84 def convert_String(o, scope, undef_value) # Although wasteful, a dup is needed because user code may mutate these strings when applying  # Resources. This does not happen when in server mode since it only uses Resources that are  # in puppet core and those are all safe.  o.frozen? && !Puppet.run_mode.server? ? o.dup : o end

#convert_Symbol(o, scope, undef_value) ⇒ Object 

 111 112 113 114 115
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 111 def convert_Symbol(o, scope, undef_value) return o unless o == :undef !@inner ? undef_value : nil end

#map_args(args, scope, undef_value) ⇒ Array

Converts 4x supported values to a 3x values.

Parameters:

  • args (Array) —

    Array of values to convert

  • scope (Puppet::Parser::Scope) —

    The scope to use when converting

  • undef_value (Object) —

    The value that nil is converted to

Returns:

  • (Array) —

    The converted values

 50 51 52
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 50 def map_args(args, scope, undef_value) args.map { |a| convert(a, scope, undef_value) } end