summaryrefslogtreecommitdiffstats
path: root/lib/puppet/parser/ast/leaf.rb
blob: 6ef346123bd4b41eade7d96536f6a71cad84e8ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
class Puppet::Parser::AST
    # The base class for all of the leaves of the parse trees.  These
    # basically just have types and values.  Both of these parameters
    # are simple values, not AST objects.
    class Leaf < AST
        attr_accessor :value, :type

        # Return our value.
        def evaluate(scope)
            return @value
        end

        # evaluate ourselves, and match
        def evaluate_match(value, scope)
            obj = self.safeevaluate(scope)

            obj   = obj.downcase   if obj.respond_to?(:downcase)
            value = value.downcase if value.respond_to?(:downcase)

            # "" == undef for case/selector/if
            obj == value or (obj == "" and value == :undef)
        end

        def match(value)
            @value == value
        end

        def to_s
            return @value.to_s unless @value.nil?
        end
    end

    # The boolean class.  True or false.  Converts the string it receives
    # to a Ruby boolean.
    class Boolean < AST::Leaf

        # Use the parent method, but then convert to a real boolean.
        def initialize(hash)
            super

            unless @value == true or @value == false
                raise Puppet::DevError,
                    "'#{@value}' is not a boolean"
            end
            @value
        end

        def to_s
            @value ? "true" : "false"
        end
    end

    # The base string class.
    class String < AST::Leaf
        def evaluate(scope)
            @value
        end

        def to_s
            "\"#{@value}\""
        end
    end

    # An uninterpreted string.
    class FlatString < AST::Leaf
        def evaluate(scope)
            return @value
        end

        def to_s
            "\"#{@value}\""
        end
    end

    class Concat < AST::Leaf
        def evaluate(scope)
            @value.collect { |x| x.evaluate(scope) }.join
        end

        def to_s
            "concat(#{@value.join(',')})"
        end
    end

    # The 'default' option on case statements and selectors.
    class Default < AST::Leaf; end

    # Capitalized words; used mostly for type-defaults, but also
    # get returned by the lexer any other time an unquoted capitalized
    # word is found.
    class Type < AST::Leaf; end

    # Lower-case words.
    class Name < AST::Leaf; end

    # double-colon separated class names
    class ClassName < AST::Leaf; end

    # undef values; equiv to nil
    class Undef < AST::Leaf; end

    # Host names, either fully qualified or just the short name, or even a regex
    class HostName < AST::Leaf
        def initialize(hash)
            super

            # Note that this is an AST::Regex, not a Regexp
            @value = @value.to_s.downcase unless @value.is_a?(Regex)
            if @value =~ /[^-\w.]/
                raise Puppet::DevError,
                    "'#{@value}' is not a valid hostname"
            end
        end

        # implementing eql? and hash so that when an HostName is stored
        # in a hash it has the same hashing properties as the underlying value
        def eql?(value)
            value = value.value if value.is_a?(HostName)
            return @value.eql?(value)
        end

        def hash
            return @value.hash
        end

        def to_s
            @value.to_s
        end
    end

    # A simple variable.  This object is only used during interpolation;
    # the VarDef class is used for assignment.
    class Variable < Name
        # Looks up the value of the object in the scope tree (does
        # not include syntactical constructs, like '$' and '{}').
        def evaluate(scope)
            parsewrap do
                if (var = scope.lookupvar(@value, false)) == :undefined
                    var = :undef
                end
                var
            end
        end

        def to_s
            "\$#{value}"
        end
    end

    class HashOrArrayAccess < AST::Leaf
        attr_accessor :variable, :key

        def evaluate_container(scope)
            container = variable.respond_to?(:evaluate) ? variable.safeevaluate(scope) : variable
            (container.is_a?(Hash) or container.is_a?(Array)) ? container : scope.lookupvar(container)
        end

        def evaluate_key(scope)
            key.respond_to?(:evaluate) ? key.safeevaluate(scope) : key
        end

        def evaluate(scope)
            object = evaluate_container(scope)

            unless object.is_a?(Hash) or object.is_a?(Array)
                raise Puppet::ParseError, "#{variable} is not an hash or array when accessing it with #{accesskey}"
            end

            return object[evaluate_key(scope)]
        end

        # Assign value to this hashkey or array index
        def assign(scope, value)
            object = evaluate_container(scope)
            accesskey = evaluate_key(scope)

            if object.is_a?(Hash) and object.include?(accesskey)
                raise Puppet::ParseError, "Assigning to the hash '#{variable}' with an existing key '#{accesskey}' is forbidden"
            end

            # assign to hash or array
            object[accesskey] = value
        end

        def to_s
            "\$#{variable.to_s}[#{key.to_s}]"
        end
    end

    class Regex < AST::Leaf
        def initialize(hash)
            super
            @value = Regexp.new(@value) unless @value.is_a?(Regexp)
        end

        # we're returning self here to wrap the regexp and to be used in places
        # where a string would have been used, without modifying any client code.
        # For instance, in many places we have the following code snippet:
        #  val = @val.safeevaluate(@scope)
        #  if val.match(otherval)
        #      ...
        #  end
        # this way, we don't have to modify this test specifically for handling
        # regexes.
        def evaluate(scope)
            return self
        end

        def evaluate_match(value, scope, options = {})
            value = value.is_a?(String) ? value : value.to_s

            if matched = @value.match(value)
                scope.ephemeral_from(matched, options[:file], options[:line])
            end
            matched
        end

        def match(value)
            @value.match(value)
        end

        def to_s
            return "/#{@value.source}/"
        end
    end
end