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

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



28
29
30
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 28

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

.instance ⇒ Runtime3Converter

Returns the singleton instance of this class.

Returns:



34
35
36
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 34

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



17
18
19
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 17

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.



113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 113

def catalog_type_to_split_type_title(catalog_type)
  split_type = catalog_type.is_a?(Puppet::Pops::Types::PType) ? catalog_type.type : catalog_type
  case split_type
    when Puppet::Pops::Types::PHostClassType
      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
      raise ArgumentError, "Cannot split the type #{catalog_type.class}, it represents neither a PHostClassType, nor a PResourceType."
  end
end

#convert(o, scope, undef_value) ⇒ Object

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

Parameters:

Returns:

  • (Object) —

    The converted value



56
57
58
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 56

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

#convert_Array(o, scope, undef_value) ⇒ Object 



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

def convert_Array(o, scope, undef_value)
  ic = @inner_converter
  o.map {|x| ic.convert(x, scope, undef_value) }
end

#convert_Hash(o, scope, undef_value) ⇒ Object 



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

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_Iterator(o, scope, undef_value) ⇒ Object

Raises:



85
86
87
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 85

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 



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

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

#convert_Object(o, scope, undef_value) ⇒ Object 



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

def convert_Object(o, scope, undef_value)
  o
end

#convert_PAnyType(o, scope, undef_value) ⇒ Object 



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

def convert_PAnyType(o, scope, undef_value)
  o
end

#convert_PCatalogEntryType(o, scope, undef_value) ⇒ Object 



97
98
99
100
101
102
103
104
105
106
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 97

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 



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

def convert_String(o, scope, undef_value)
  # although wasteful, needed because user code may mutate these strings in Resources
  o.frozen? ? o.dup : o
end

#convert_Symbol(o, scope, undef_value) ⇒ Object 



89
90
91
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 89

def convert_Symbol(o, scope, undef_value)
  o == :undef && !@inner ? undef_value : o
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



45
46
47
 
# File 'lib/puppet/pops/evaluator/runtime3_converter.rb', line 45

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