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

   1 #
   2 #  upcase.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 module Puppet::Parser::Functions
   6   newfunction(:upcase, :type => :rvalue, :doc => <<-DOC
   7     @summary
   8       Converts a string or an array of strings to uppercase.
   9
  10     @return
  11       converted string ot array of strings to uppercase
  12
  13     @example **Usage**
  14
  15       upcase("abcd")
  16       Will return ABCD
  17
  18     > *Note:* from Puppet 6.0.0, the compatible function with the same name in Puppet core
  19     will be used instead of this function.
  20   DOC
  21              ) do |arguments|
  22
  23     raise(Puppet::ParseError, "upcase(): Wrong number of arguments given (#{arguments.size} for 1)") if arguments.size != 1
  24
  25     value = arguments[0]
  26
  27     unless value.is_a?(Array) || value.is_a?(Hash) || value.respond_to?(:upcase)
  28       raise(Puppet::ParseError, 'upcase(): Requires an array, hash or object that responds to upcase in order to work')
  29     end
  30
  31     if value.is_a?(Array)
  32       # Numbers in Puppet are often string-encoded which is troublesome ...
  33       result = value.map { |i| function_upcase([i]) }
  34     elsif value.is_a?(Hash)
  35       result = {}
  36       value.each_pair do |k, v|
  37         result[function_upcase([k])] = function_upcase([v])
  38       end
  39     else
  40       result = value.upcase
  41     end
  42
  43     return result
  44   end
  45 end
  46
  47 # vim: set ts=2 sw=2 et :