puppet 7.28.0-x64-mingw32 → 8.0.1-x64-mingw32

data/lib/puppet/functions/alert.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Logs a message on the server at level `alert`.
 Puppet::Functions.create_function(:alert, Puppet::Functions::InternalFunction) do
   # @param values The values to log.

data/lib/puppet/functions/all.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Runs a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
 # repeatedly using each value in a data structure until the lambda returns a non "truthy" value which
 # makes the function return `false`, or if the end of the iteration is reached, `true` is returned.

data/lib/puppet/functions/annotate.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Handles annotations on objects. The function can be used in four different ways.
 #
 # With two arguments, an `Annotation` type and an object, the function returns the annotation

data/lib/puppet/functions/any.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Runs a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
 # repeatedly using each value in a data structure until the lambda returns a "truthy" value which
 # makes the function return `true`, or if the end of the iteration is reached, false is returned.

data/lib/puppet/functions/assert_type.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the given value if it is of the given
 # [data type](https://puppet.com/docs/puppet/latest/lang_data.html), or
 # otherwise either raises an error or executes an optional two-parameter

data/lib/puppet/functions/binary_file.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Loads a binary file from a module or file system and returns its contents as a `Binary`.
 # The argument to this function should be a `<MODULE NAME>/<FILE>`
 # reference, which will load `<FILE>` from a module's `files`

data/lib/puppet/functions/break.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Breaks an innermost iteration as if it encountered an end of input.
 # This function does not return to the caller.
 #

data/lib/puppet/functions/call.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Calls an arbitrary Puppet function by name.
 #
 # This function takes one mandatory argument and one or more optional arguments:

data/lib/puppet/functions/camelcase.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Creates a Camel Case version of a String
 #
 # This function is compatible with the stdlib function with the same name.

data/lib/puppet/functions/capitalize.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Capitalizes the first character of a String, or the first character of every String in an Iterable value (such as an Array).
 #
 # This function is compatible with the stdlib function with the same name.

data/lib/puppet/functions/ceiling.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the smallest `Integer` greater or equal to the argument.
 # Takes a single numeric value as an argument.
 #

data/lib/puppet/functions/chomp.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns a new string with the record separator character(s) removed.
 # The record separator is the line ending characters `\r` and `\n`.
 #

data/lib/puppet/functions/chop.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns a new string with the last character removed.
 # If the string ends with `\r\n`, both characters are removed. Applying chop to an empty
 # string returns an empty string. If you wish to merely remove record

data/lib/puppet/functions/compare.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Compares two values and returns -1, 0 or 1 if first value is smaller, equal or larger than the second value.
 # The compare function accepts arguments of the data types `String`, `Numeric`, `Timespan`, `Timestamp`, and `Semver`,
 # such that:

data/lib/puppet/functions/contain.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Makes one or more classes be contained inside the current class.
 # If any of these classes are undeclared, they will be declared as if
 # there were declared with the `include` function.

data/lib/puppet/functions/convert_to.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # The `convert_to(value, type)` is a convenience function that does the same as `new(type, value)`.
 # The difference in the argument ordering allows it to be used in chained style for
 # improved readability "left to right".

data/lib/puppet/functions/crit.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Logs a message on the server at level `crit`.
 Puppet::Functions.create_function(:crit, Puppet::Functions::InternalFunction) do
   # @param values The values to log.

data/lib/puppet/functions/debug.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Logs a message on the server at level `debug`.
 Puppet::Functions.create_function(:debug, Puppet::Functions::InternalFunction) do
   # @param values The values to log.

data/lib/puppet/functions/defined.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Determines whether a given class or resource type is defined and returns a Boolean
 # value. You can also use `defined` to determine whether a specific resource is defined,
 # or whether a variable has a value (including `undef`, as opposed to the variable never

data/lib/puppet/functions/dig.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns a value for a sequence of given keys/indexes into a structure, such as
 # an array or hash.
 #

data/lib/puppet/functions/downcase.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Converts a String, Array or Hash (recursively) into lower case.
 #
 # This function is compatible with the stdlib function with the same name.

data/lib/puppet/functions/each.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Runs a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
 # repeatedly using each value in a data structure, then returns the values unchanged.
 #

data/lib/puppet/functions/emerg.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Logs a message on the server at level `emerg`.
 Puppet::Functions.create_function(:emerg, Puppet::Functions::InternalFunction) do
   # @param values The values to log.

data/lib/puppet/functions/empty.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns `true` if the given argument is an empty collection of values.
 #
 # This function can answer if one of the following is empty:

data/lib/puppet/functions/epp.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Evaluates an Embedded Puppet (EPP) template file and returns the rendered text
 # result as a String.
 #

data/lib/puppet/functions/err.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Logs a message on the server at level `err`.
 Puppet::Functions.create_function(:err, Puppet::Functions::InternalFunction) do
   # @param values The values to log.

data/lib/puppet/functions/eyaml_lookup_key.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # The `eyaml_lookup_key` is a hiera 5 `lookup_key` data provider function.
 # See [the configuration guide documentation](https://puppet.com/docs/puppet/latest/hiera_config_yaml_5.html#configuring-a-hierarchy-level-hiera-eyaml) for
 # how to use this function.

data/lib/puppet/functions/filter.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Applies a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
 # to every value in a data structure and returns an array or hash containing any elements
 # for which the lambda evaluates to a truthy value (not `false` or `undef`).

data/lib/puppet/functions/find_file.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Finds an existing file from a module and returns its path.
 #
 # This function accepts an argument that is a String as a `<MODULE NAME>/<FILE>`

data/lib/puppet/functions/find_template.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Finds an existing template from a module and returns its path.
 #
 # This function accepts an argument that is a String as a `<MODULE NAME>/<TEMPLATE>`

data/lib/puppet/functions/flatten.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns a flat Array produced from its possibly deeply nested given arguments.
 #
 # One or more arguments of any data type can be given to this function.

data/lib/puppet/functions/floor.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the largest `Integer` less or equal to the argument.
 # Takes a single numeric value as an argument.
 #

data/lib/puppet/functions/get.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Digs into a value with dot notation to get a value from within a structure.
 #
 # **To dig into a given value**, call the function with (at least) two arguments:

data/lib/puppet/functions/getvar.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Digs into a variable with dot notation to get a value from a structure.
 #
 # **To get the value from a variable** (that may or may not exist), call the function with

data/lib/puppet/functions/hiera.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'hiera/puppet_function'
 # Performs a standard priority lookup of the hierarchy and returns the most specific value
 # for a given key. The returned value can be any type of data.

data/lib/puppet/functions/hiera_array.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'hiera/puppet_function'
 
 # Finds all matches of a key throughout the hierarchy and returns them as a single flattened

data/lib/puppet/functions/hiera_hash.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'hiera/puppet_function'
 
 # Finds all matches of a key throughout the hierarchy and returns them in a merged hash.

data/lib/puppet/functions/hiera_include.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'hiera/puppet_function'
 
 # Assigns classes to a node using an

data/lib/puppet/functions/hocon_data.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # The `hocon_data` is a hiera 5 `data_hash` data provider function.
 # See [the configuration guide documentation](https://puppet.com/docs/puppet/latest/hiera_config_yaml_5.html#configuring-a-hierarchy-level-built-in-backends) for
 # how to use this function.

data/lib/puppet/functions/import.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # The import function raises an error when called to inform the user that import is no longer supported.
 #
 Puppet::Functions.create_function(:import) do

data/lib/puppet/functions/include.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Declares one or more classes, causing the resources in them to be
 # evaluated and added to the catalog. Accepts a class name, an array of class
 # names, or a comma-separated list of class names.

data/lib/puppet/functions/index.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the index (or key in a hash) to a first-found value in an `Iterable` value.
 #
 # When called with a  [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)

data/lib/puppet/functions/info.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Logs a message on the server at level `info`.
 Puppet::Functions.create_function(:info, Puppet::Functions::InternalFunction) do
   # @param values The values to log.

data/lib/puppet/functions/inline_epp.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Evaluates an Embedded Puppet (EPP) template string and returns the rendered
 # text result as a String.
 #

data/lib/puppet/functions/join.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Joins the values of an Array into a string with elements separated by a delimiter.
 #
 # Supports up to two arguments

data/lib/puppet/functions/json_data.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # The `json_data` is a hiera 5 `data_hash` data provider function.
 # See [the configuration guide documentation](https://puppet.com/docs/puppet/latest/hiera_config_yaml_5.html#configuring-a-hierarchy-level-built-in-backends) for
 # how to use this function.

data/lib/puppet/functions/keys.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the keys of a hash as an Array
 #
 # @example Using `keys`

data/lib/puppet/functions/length.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the length of an Array, Hash, String, or Binary value.
 #
 # The returned value is a positive integer indicating the number

data/lib/puppet/functions/lest.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Calls a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
 # without arguments if the value given to `lest` is `undef`.
 # Returns the result of calling the lambda if the argument is `undef`, otherwise the

data/lib/puppet/functions/lookup.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Uses the Puppet lookup system to retrieve a value for a given key. By default,
 # this returns the first value found (and fails compilation if no values are
 # available), but you can configure it to merge multiple values into one, fail

data/lib/puppet/functions/lstrip.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Strips leading spaces from a String
 #
 # This function is compatible with the stdlib function with the same name.

data/lib/puppet/functions/map.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Applies a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
 # to every value in a data structure and returns an array containing the results.
 #

data/lib/puppet/functions/match.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Matches a regular expression against a string and returns an array containing the match
 # and any matched capturing groups.
 #

data/lib/puppet/functions/max.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the highest value among a variable number of arguments.
 # Takes at least one argument.
 #
@@ -82,6 +83,18 @@ Puppet::Functions.create_function(:max) do
     repeated_param 'String', :values
   end
 
+  dispatch :on_semver do
+    repeated_param 'Semver', :values
+  end
+
+  dispatch :on_timespan do
+    repeated_param 'Timespan', :values
+  end
+
+  dispatch :on_timestamp do
+    repeated_param 'Timestamp', :values
+  end
+
   dispatch :on_single_numeric_array do
     param 'Array[Numeric]', :values
     optional_block_param 'Callable[2,2]', :block
@@ -92,6 +105,21 @@ Puppet::Functions.create_function(:max) do
     optional_block_param 'Callable[2,2]', :block
   end
 
+  dispatch :on_single_semver_array do
+    param 'Array[Semver]', :values
+    optional_block_param 'Callable[2,2]', :block
+  end
+
+  dispatch :on_single_timespan_array do
+    param 'Array[Timespan]', :values
+    optional_block_param 'Callable[2,2]', :block
+  end
+
+  dispatch :on_single_timestamp_array do
+    param 'Array[Timestamp]', :values
+    optional_block_param 'Callable[2,2]', :block
+  end
+
   dispatch :on_single_any_array do
     param 'Array', :values
     optional_block_param 'Callable[2,2]', :block
@@ -129,6 +157,21 @@ Puppet::Functions.create_function(:max) do
     end
   end
 
+  def on_semver(*args)
+    assert_arg_count(args)
+    args.max
+  end
+
+  def on_timespan(*args)
+    assert_arg_count(args)
+    args.max
+  end
+
+  def on_timestamp(*args)
+    assert_arg_count(args)
+    args.max
+  end
+
   def on_any_with_block(*args, &block)
     args.max {|x,y| block.call(x,y) }
   end
@@ -149,6 +192,30 @@ Puppet::Functions.create_function(:max) do
     end
   end
 
+  def on_single_semver_array(array, &block)
+    if block_given?
+      on_any_with_block(*array, &block)
+    else
+      on_semver(*array)
+    end
+  end
+
+  def on_single_timespan_array(array, &block)
+    if block_given?
+      on_any_with_block(*array, &block)
+    else
+      on_timespan(*array)
+    end
+  end
+
+  def on_single_timestamp_array(array, &block)
+    if block_given?
+      on_any_with_block(*array, &block)
+    else
+      on_timestamp(*array)
+    end
+  end
+
   def on_single_any_array(array, &block)
     if block_given?
       on_any_with_block(*array, &block)

data/lib/puppet/functions/min.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the lowest value among a variable number of arguments.
 # Takes at least one argument.
 #
@@ -81,11 +82,38 @@ Puppet::Functions.create_function(:min) do
     repeated_param 'String', :values
   end
 
+  dispatch :on_semver do
+    repeated_param 'Semver', :values
+  end
+
+  dispatch :on_timespan do
+    repeated_param 'Timespan', :values
+  end
+
+  dispatch :on_timestamp do
+    repeated_param 'Timestamp', :values
+  end
+
   dispatch :on_single_numeric_array do
     param 'Array[Numeric]', :values
     optional_block_param 'Callable[2,2]', :block
   end
 
+  dispatch :on_single_semver_array do
+    param 'Array[Semver]', :values
+    optional_block_param 'Callable[2,2]', :block
+  end
+
+  dispatch :on_single_timespan_array do
+    param 'Array[Timespan]', :values
+    optional_block_param 'Callable[2,2]', :block
+  end
+
+  dispatch :on_single_timestamp_array do
+    param 'Array[Timestamp]', :values
+    optional_block_param 'Callable[2,2]', :block
+  end
+
   dispatch :on_single_string_array do
     param 'Array[String]', :values
     optional_block_param 'Callable[2,2]', :block
@@ -128,6 +156,21 @@ Puppet::Functions.create_function(:min) do
     end
   end
 
+  def on_semver(*args)
+    assert_arg_count(args)
+    args.min
+  end
+
+  def on_timespan(*args)
+    assert_arg_count(args)
+    args.min
+  end
+
+  def on_timestamp(*args)
+    assert_arg_count(args)
+    args.min
+  end
+
   def on_any_with_block(*args, &block)
     args.min {|x,y| block.call(x,y) }
   end
@@ -148,6 +191,30 @@ Puppet::Functions.create_function(:min) do
     end
   end
 
+  def on_single_semver_array(array, &block)
+    if block_given?
+      on_any_with_block(*array, &block)
+    else
+      on_semver(*array)
+    end
+  end
+
+  def on_single_timespan_array(array, &block)
+    if block_given?
+      on_any_with_block(*array, &block)
+    else
+      on_timespan(*array)
+    end
+  end
+
+  def on_single_timestamp_array(array, &block)
+    if block_given?
+      on_any_with_block(*array, &block)
+    else
+      on_timestamp(*array)
+    end
+  end
+
   def on_single_any_array(array, &block)
     if block_given?
       on_any_with_block(*array, &block)

data/lib/puppet/functions/module_directory.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Finds an existing module and returns the path to its root directory.
 #
 # The argument to this function should be a module name String

data/lib/puppet/functions/new.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Creates a new instance/object of a given data type.
 #
 # This function makes it possible to create new instances of

data/lib/puppet/functions/next.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Makes iteration continue with the next value, optionally with a given value for this iteration.
 # If a value is not given it defaults to `undef`
 # 

data/lib/puppet/functions/notice.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Logs a message on the server at level `notice`.
 Puppet::Functions.create_function(:notice, Puppet::Functions::InternalFunction) do
   # @param values The values to log.

data/lib/puppet/functions/reduce.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Applies a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
 # to every value in a data structure from the first argument, carrying over the returned
 # value of each iteration, and returns the result of the lambda's final iteration. This

data/lib/puppet/functions/regsubst.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Performs regexp replacement on a string or array of strings.
 Puppet::Functions.create_function(:regsubst) do
   # @param target [String]

data/lib/puppet/functions/require.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Requires the specified classes.
 # Evaluate one or more classes, adding the required class as a dependency.
 #

data/lib/puppet/functions/return.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Makes iteration continue with the next value, optionally with a given value for this iteration.
 # If a value is not given it defaults to `undef`
 #

data/lib/puppet/functions/reverse_each.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Reverses the order of the elements of something that is iterable and optionally runs a
 # [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html) for each
 # element.

data/lib/puppet/functions/round.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns an `Integer` value rounded to the nearest value.
 # Takes a single `Numeric` value as an argument.
 #

data/lib/puppet/functions/rstrip.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Strips trailing spaces from a String
 #
 # This function is compatible with the stdlib function with the same name.

data/lib/puppet/functions/scanf.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Scans a string and returns an array of one or more converted values based on the given format string.
 # See the documentation of Ruby's String#scanf method for details about the supported formats (which
 # are similar but not identical to the formats used in Puppet's `sprintf` function.)

data/lib/puppet/functions/size.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # The same as length() - returns the size of an Array, Hash, String, or Binary value.
 #
 # @since 6.0.0 - also supporting Binary

data/lib/puppet/functions/slice.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Slices an array or hash into pieces of a given size.
 #
 # This function takes two mandatory arguments: the first should be an array or hash, and the second specifies

data/lib/puppet/functions/sort.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Sorts an Array numerically or lexicographically or the characters of a String lexicographically.
 # Please note: This function is based on Ruby String comparison 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.