Update stdlib
[mirror/dsa-puppet.git] / 3rdparty / modules / stdlib / lib / puppet / parser / functions / uriescape.rb
1 #
2 #  uriescape.rb
3 #  Please note: This function is an implementation of a Ruby class and as such may not be entirely UTF8 compatible. To ensure compatibility please use this function with Ruby 2.4.0 or greater - https://bugs.ruby-lang.org/issues/10085.
4 #
5 require 'uri'
6
7 module Puppet::Parser::Functions
8   newfunction(:uriescape, :type => :rvalue, :doc => <<-EOS
9     Urlencodes a string or array of strings.
10     Requires either a single string or an array as an input.
11     EOS
12   ) do |arguments|
13
14     raise(Puppet::ParseError, "uriescape(): Wrong number of arguments given (#{arguments.size} for 1)") if arguments.size < 1
15
16     value = arguments[0]
17
18     unless value.is_a?(Array) || value.is_a?(String)
19       raise(Puppet::ParseError, 'uriescape(): Requires either array or string to work with')
20     end
21
22     if value.is_a?(Array)
23       # Numbers in Puppet are often string-encoded which is troublesome ...
24       result = value.collect { |i| i.is_a?(String) ? URI.escape(i) : i }
25     else
26       result = URI.escape(value)
27     end
28
29     return result
30   end
31 end
32
33 # vim: set ts=2 sw=2 et :