3rdparty/modules/stdlib/lib/puppet/parser/functions/uriescape.rb

   1 require 'uri'
   2 #
   3 #  uriescape.rb
   4 #  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.
   5 #
   6 module Puppet::Parser::Functions
   7   newfunction(:uriescape, :type => :rvalue, :doc => <<-DOC
   8     @summary
   9       Urlencodes a string or array of strings.
  10       Requires either a single string or an array as an input.
  11
  12     @return [String]
  13       a string that contains the converted value
  14
  15     DOC
  16              ) do |arguments|
  17
  18     raise(Puppet::ParseError, "uriescape(): Wrong number of arguments given (#{arguments.size} for 1)") if arguments.empty?
  19
  20     value = arguments[0]
  21
  22     unless value.is_a?(Array) || value.is_a?(String)
  23       raise(Puppet::ParseError, 'uriescape(): Requires either array or string to work with')
  24     end
  25
  26     result = if value.is_a?(Array)
  27                # Numbers in Puppet are often string-encoded which is troublesome ...
  28                value.map { |i| i.is_a?(String) ? URI.escape(i) : i }
  29              else
  30                URI.escape(value)
  31              end
  32
  33     return result
  34   end
  35 end
  36
  37 # vim: set ts=2 sw=2 et :