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

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

Overview

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


31
32
33
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 31

def self.convert(o, scope, undef_value)
  @instance.convert(o, scope, undef_value)
end

.instanceRuntime3Converter

Returns the singleton instance of this class.

Returns:


37
38
39
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 37

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


20
21
22
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 20

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.


132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 132

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


59
60
61
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 59

def convert(o, scope, undef_value)
  @convert_visitor.visit_this_2(self, o, scope, undef_value)
end

#convert_Array(o, scope, undef_value) ⇒ Object


91
92
93
94
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 91

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:


73
74
75
76
77
78
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 73

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


96
97
98
99
100
101
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 96

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:


67
68
69
70
71
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 67

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:


103
104
105
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 103

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


63
64
65
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 63

def convert_NilClass(o, scope, undef_value)
  @inner ? nil : undef_value
end

#convert_Object(o, scope, undef_value) ⇒ Object


87
88
89
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 87

def convert_Object(o, scope, undef_value)
  o
end

#convert_PAnyType(o, scope, undef_value) ⇒ Object


112
113
114
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 112

def convert_PAnyType(o, scope, undef_value)
  o
end

#convert_PCatalogEntryType(o, scope, undef_value) ⇒ Object


116
117
118
119
120
121
122
123
124
125
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 116

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


80
81
82
83
84
85
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 80

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


107
108
109
110
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 107

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


48
49
50
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 48

def map_args(args, scope, undef_value)
  args.map {|a| convert(a, scope, undef_value) }
end