4 # TODO(Krzysztof Wilczynski): We probably need to approach numeric values differently ...
5 module Puppet::Parser::Functions
6 newfunction(:range, :type => :rvalue, :doc => <<-DOC
7 When given range in the form of (start, stop) it will extrapolate a range as
14 Will return: [0,1,2,3,4,5,6,7,8,9]
18 Will return: [0,1,2,3,4,5,6,7,8,9] (Zero padded strings are converted to
19 integers automatically)
23 Will return: ["a","b","c"]
25 range("host01", "host10")
26 Will return: ["host01", "host02", ..., "host09", "host10"]
27 NB Be explicit in including trailing zeros. Otherwise the underlying ruby function will fail.
29 Passing a third argument will cause the generated range to step by that
34 Will return: [0,2,4,6,8]
36 The Puppet Language support Integer and Float ranges by using the type system. Those are suitable for
37 iterating a given number of times. Also see the step() function in Puppet for skipping values.
39 Integer[0, 9].each |$x| { notice($x) } # notices 0, 1, 2, ... 9
43 raise(Puppet::ParseError, 'range(): Wrong number of arguments given (0 for 1)') if arguments.empty?
48 step = arguments[2].nil? ? 1 : arguments[2].to_i.abs
50 type = '..' # Use the simplest type of Range available in Ruby
52 else # arguments.size == 1
55 m = value.match(%r{^(\w+)(\.\.\.?|\-)(\w+)$})
62 elsif value =~ %r{^.+$}
63 raise(Puppet::ParseError, "range(): Unable to compute range from the value: #{value}")
65 raise(Puppet::ParseError, "range(): Unknown range format: #{value}")
69 # If we were given an integer, ensure we work with one
70 if start.to_s =~ %r{^\d+$}
79 when %r{^(..|-)$} then (start..stop)
80 when '...' then (start...stop) # Exclusive of last element
83 result = range.step(step).to_a
89 # vim: set ts=2 sw=2 et :