openvox 9.0.0.pre.alpha2 → 9.0.0.pre.beta2

data/lib/puppet/functions/hiera_include.rb

@@ -31,7 +31,7 @@ require 'hiera/puppet_function'
 #
 # 1. A string key that Hiera searches for in the hierarchy. **Required**.
 # 2. An optional default value to return if Hiera doesn't find anything matching the key.
-#     * If this argument isn't provided and this function results in a lookup failure, Puppet
+#     * If this argument isn't provided and this function results in a lookup failure, OpenVox
 #     fails with a compilation error.
 # 3. The optional name of an arbitrary
 # [hierarchy level](https://puppet.com/docs/hiera/latest/hierarchy.html) to insert at the
@@ -64,11 +64,11 @@ require 'hiera/puppet_function'
 # # In site.pp, outside of any node definitions and below any top-scope variables:
 # hiera_include('classes', undef)
 #
-# # Puppet assigns the apache and apache::mod::php classes to the web01.example.com node.
+# # OpenVox assigns the apache and apache::mod::php classes to the web01.example.com node.
 # ```
 #
 # You can optionally generate the default value with a
-# [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html) that
+# [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html) that
 # takes one parameter.
 #
 # @example Using `hiera_include` with a lambda
@@ -79,15 +79,15 @@ require 'hiera/puppet_function'
 # # In site.pp, outside of any node definitions and below any top-scope variables:
 # hiera_include('classes') | $key | {"Key \'${key}\' not found" }
 #
-# # Puppet assigns the apache and apache::mod::php classes to the web01.example.com node.
+# # OpenVox assigns the apache and apache::mod::php classes to the web01.example.com node.
 # # If hiera_include couldn't match its key, it would return the lambda result,
 # # "Key 'classes' not found".
 # ```
 #
 # See
-# [the 'Using the lookup function' documentation](https://puppet.com/docs/puppet/latest/hiera_automatic.html) for how to perform lookup of data.
+# [the 'Using the lookup function' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html) for how to perform lookup of data.
 # Also see
-# [the 'Using the deprecated hiera functions' documentation](https://puppet.com/docs/puppet/latest/hiera_automatic.html)
+# [the 'Using the deprecated hiera functions' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html)
 # for more information about the Hiera 3 functions.
 #
 # @since 4.0.0

data/lib/puppet/functions/hocon_data.rb

@@ -1,7 +1,7 @@
 # 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
+# See [the configuration guide documentation](https://docs.openvoxproject.org/openvox/latest/hiera_config_yaml_5.html#configuring-a-hierarchy-level-built-in-backends) for
 # how to use this function.
 #
 # Note that this function is not supported without a hocon library being present.

data/lib/puppet/functions/include.rb

@@ -6,7 +6,7 @@
 #
 # The `include` function can be used multiple times on the same class and will
 # only declare a given class once. If a class declared with `include` has any
-# parameters, Puppet will automatically look up values for them in Hiera, using
+# parameters, OpenVox will automatically look up values for them in Hiera, using
 # `<class name>::<parameter name>` as the lookup key.
 #
 # Contrast this behavior with resource-like class declarations

data/lib/puppet/functions/index.rb

@@ -2,7 +2,7 @@
 
 # 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)
+# When called with a  [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
 # the lambda is called repeatedly using each value in a data structure until the lambda returns a "truthy" value which
 # makes the function return the index or key, or if the end of the iteration is reached, undef is returned.
 #
@@ -85,8 +85,8 @@
 # notice $data.index('workstations') # notices undef (not matching case)
 # ```
 #
-# For an general examples that demonstrates iteration, see the Puppet
-# [iteration](https://puppet.com/docs/puppet/latest/lang_iteration.html)
+# For an general examples that demonstrates iteration, see the OpenVox
+# [iteration](https://docs.openvoxproject.org/openvox/latest/lang_iteration.html)
 # documentation.
 #
 # @since 6.3.0

data/lib/puppet/functions/inline_epp.rb

@@ -7,12 +7,12 @@
 #
 # The first argument to this function should be a string containing an EPP
 # template. In most cases, the last argument is optional; if used, it should be a
-# [hash](https://puppet.com/docs/puppet/latest/lang_data_hash.html) that contains parameters to
+# [hash](https://docs.openvoxproject.org/openvox/latest/lang_data_hash.html) that contains parameters to
 # pass to the template.
 #
-# - See the [template](https://puppet.com/docs/puppet/latest/lang_template.html)
+# - See the [template](https://docs.openvoxproject.org/openvox/latest/lang_template.html)
 # documentation for general template usage information.
-# - See the [EPP syntax](https://puppet.com/docs/puppet/latest/lang_template_epp.html)
+# - See the [EPP syntax](https://docs.openvoxproject.org/openvox/latest/lang_template_epp.html)
 # documentation for examples of EPP.
 #
 # For example, to evaluate an inline EPP template and pass it the `docroot` and
@@ -21,16 +21,16 @@
 # `inline_epp('docroot: <%= $docroot %> Virtual docroot: <%= $virtual_docroot %>',
 # { 'docroot' => '/var/www/html', 'virtual_docroot' => '/var/www/example' })`
 #
-# Puppet produces a syntax error if you pass more parameters than are declared in
+# OpenVox produces a syntax error if you pass more parameters than are declared in
 # the template's parameter tag. When passing parameters to a template that
 # contains a parameter tag, use the same names as the tag's declared parameters.
 #
 # Parameters are required only if they are declared in the called template's
-# parameter tag without default values. Puppet produces an error if the
+# parameter tag without default values. OpenVox produces an error if the
 # `inline_epp` function fails to pass any required parameter.
 #
 # An inline EPP template should be written as a single-quoted string or
-# [heredoc](https://puppet.com/docs/puppet/latest/lang_data_string.html#heredocs).
+# [heredoc](https://docs.openvoxproject.org/openvox/latest/lang_data_string.html#heredocs).
 # A double-quoted string is subject to expression interpolation before the string
 # is parsed as an EPP template.
 #

data/lib/puppet/functions/json_data.rb

@@ -1,7 +1,7 @@
 # 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
+# See [the configuration guide documentation](https://docs.openvoxproject.org/openvox/latest/hiera_config_yaml_5.html#configuring-a-hierarchy-level-built-in-backends) for
 # how to use this function.
 #
 # @since 4.8.0

data/lib/puppet/functions/lest.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Calls a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
+# Calls a [lambda](https://docs.openvoxproject.org/openvox/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
 # given argument.

data/lib/puppet/functions/lookup.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-# Uses the Puppet lookup system to retrieve a value for a given key. By default,
+# Uses the OpenVox 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
 # gracefully, and more.
 #
-# When looking up a key, Puppet will search up to three tiers of data, in the
+# When looking up a key, OpenVox will search up to three tiers of data, in the
 # following order:
 #
 # 1. Hiera.
@@ -27,22 +27,22 @@
 # The arguments accepted by `lookup` are as follows:
 #
 # 1. `<NAME>` (string or array) --- The name of the key to look up.
-#     * This can also be an array of keys. If Puppet doesn't find anything for the
+#     * This can also be an array of keys. If OpenVox doesn't find anything for the
 #     first key, it will try again with the subsequent ones, only resorting to a
 #     default value if none of them succeed.
 # 2. `<VALUE TYPE>` (data type) --- A
-# [data type](https://puppet.com/docs/puppet/latest/lang_data_type.html)
+# [data type](https://docs.openvoxproject.org/openvox/latest/lang_data_type.html)
 # that must match the retrieved value; if not, the lookup (and catalog
 # compilation) will fail. Defaults to `Data` (accepts any normal value).
 # 3. `<MERGE BEHAVIOR>` (string or hash; see **"Merge Behaviors"** below) ---
 # Whether (and how) to combine multiple values. If present, this overrides any
-# merge behavior specified in the data sources. Defaults to no value; Puppet will
+# merge behavior specified in the data sources. Defaults to no value; OpenVox will
 # use merge behavior from the data sources if present, and will otherwise do a
 # first-found lookup.
 # 4. `<DEFAULT VALUE>` (any normal value) --- If present, `lookup` returns this
 # when it can't find a normal value. Default values are never merged with found
 # values. Like a normal value, the default must match the value type. Defaults to
-# no value; if Puppet can't find a normal value, the lookup (and compilation) will
+# no value; if OpenVox can't find a normal value, the lookup (and compilation) will
 # fail.
 # 5. `<OPTIONS HASH>` (hash) --- Alternate way to set the arguments above, plus
 # some less-common extra options. If you pass an options hash, you can't combine
@@ -54,24 +54,24 @@
 #     * `'merge'` --- Same as `<MERGE BEHAVIOR>` (argument 3).
 #     * `'default_value'` --- Same as `<DEFAULT VALUE>` (argument 4).
 #     * `'default_values_hash'` (hash) --- A hash of lookup keys and default
-#     values. If Puppet can't find a normal value, it will check this hash for the
+#     values. If OpenVox can't find a normal value, it will check this hash for the
 #     requested key before giving up. You can combine this with `default_value` or
 #     a lambda, which will be used if the key isn't present in this hash. Defaults
 #     to an empty hash.
-#     * `'override'` (hash) --- A hash of lookup keys and override values. Puppet
+#     * `'override'` (hash) --- A hash of lookup keys and override values. OpenVox
 #     will check for the requested key in the overrides hash _first;_ if found, it
 #     returns that value as the _final_ value, ignoring merge behavior. Defaults
 #     to an empty hash.
 #
 # Finally, `lookup` can take a lambda, which must accept a single parameter.
 # This is yet another way to set a default value for the lookup; if no results are
-# found, Puppet will pass the requested key to the lambda and use its result as
+# found, OpenVox will pass the requested key to the lambda and use its result as
 # the default value.
 #
 # #### Merge Behaviors
 #
-# Puppet lookup uses a hierarchy of data sources, and a given key might have
-# values in multiple sources. By default, Puppet returns the first value it finds,
+# OpenVox lookup uses a hierarchy of data sources, and a given key might have
+# values in multiple sources. By default, OpenVox returns the first value it finds,
 # but it can also continue searching and merge all the values together.
 #
 # > **Note:** Data sources can use the special `lookup_options` metadata key to
@@ -80,17 +80,17 @@
 #
 # The valid merge behaviors are:
 #
-# * `'first'` --- Returns the first value found, with no merging. Puppet lookup's
+# * `'first'` --- Returns the first value found, with no merging. OpenVox lookup's
 # default behavior.
 # * `'unique'` (called "array merge" in classic Hiera) --- Combines any number of
 # arrays and scalar values to return a merged, flattened array with all duplicate
 # values removed. The lookup will fail if any hash values are found.
 # * `'hash'` --- Combines the keys and values of any number of hashes to return a
-# merged hash. If the same key exists in multiple source hashes, Puppet will use
+# merged hash. If the same key exists in multiple source hashes, OpenVox will use
 # the value from the highest-priority data source; it won't recursively merge the
 # values.
 # * `'deep'` --- Combines the keys and values of any number of hashes to return a
-# merged hash. If the same key exists in multiple source hashes, Puppet will
+# merged hash. If the same key exists in multiple source hashes, OpenVox will
 # recursively merge hash or array values (with duplicate values removed from
 # arrays). For conflicting scalar values, the highest-priority value will win.
 # * `{'strategy' => 'first'}`, `{'strategy' => 'unique'}`,

data/lib/puppet/functions/map.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Applies a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
+# Applies a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
 # to every value in a data structure and returns an array containing the results.
 #
 # This function takes two mandatory arguments, in this order:
@@ -17,7 +17,7 @@
 #
 # `$transformed_data = map($data) |$parameter| { <PUPPET CODE BLOCK> }`
 #
-# When the first argument (`$data` in the above example) is an array, Puppet passes each
+# When the first argument (`$data` in the above example) is an array, OpenVox passes each
 # value in turn to the lambda.
 #
 # @example Using the `map` function with an array and a one-parameter lambda
@@ -29,7 +29,7 @@
 # # $transformed_data contains [10,20,30]
 # ```
 #
-# When the first argument is a hash, Puppet passes each key and value pair to the lambda
+# When the first argument is a hash, OpenVox passes each key and value pair to the lambda
 # as an array in the form `[key, value]`.
 #
 # @example Using the `map` function with a hash and a one-parameter lambda
@@ -41,7 +41,7 @@
 # # $transformed_data contains ['a','b','c']
 # ```
 #
-# When the first argument is an array and the lambda has two parameters, Puppet passes the
+# When the first argument is an array and the lambda has two parameters, OpenVox passes the
 # array's indexes (enumerated from 0) in the first parameter and its values in the second
 # parameter.
 #
@@ -54,7 +54,7 @@
 # # $transformed_data contains [0,1,2]
 # ```
 #
-# When the first argument is a hash, Puppet passes its keys to the first parameter and its
+# When the first argument is a hash, OpenVox passes its keys to the first parameter and its
 # values to the second parameter.
 #
 # @example Using the `map` function with a hash and a two-parameter lambda

data/lib/puppet/functions/reduce.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Applies a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
+# Applies a [lambda](https://docs.openvoxproject.org/openvox/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
 # lets you create a new value or data structure by combining values from the first
@@ -31,16 +31,16 @@
 #
 # `reduce($data, start) |$memo, $value| { ... }`
 #
-# When the first argument (`$data` in the above example) is an array, Puppet passes each
+# When the first argument (`$data` in the above example) is an array, OpenVox passes each
 # of the data structure's values in turn to the lambda's parameters. When the first
-# argument is a hash, Puppet converts each of the hash's values to an array in the form
+# argument is a hash, OpenVox converts each of the hash's values to an array in the form
 # `[key, value]`.
 #
-# If you pass a start memo value, Puppet executes the lambda with the provided memo value
-# and the data structure's first value. Otherwise, Puppet passes the structure's first two
+# If you pass a start memo value, OpenVox executes the lambda with the provided memo value
+# and the data structure's first value. Otherwise, OpenVox passes the structure's first two
 # values to the lambda.
 #
-# Puppet calls the lambda for each of the data structure's remaining values. For each
+# OpenVox calls the lambda for each of the data structure's remaining values. For each
 # call, it passes the result of the previous call as the first parameter (`$memo` in the
 # above examples) and the next value from the data structure as the second parameter
 # (`$value`).

data/lib/puppet/functions/regsubst.rb

@@ -19,11 +19,7 @@ Puppet::Functions.create_function(:regsubst) do
   #        - *I*         Ignore case in regexps
   #        - *M*         Multiline regexps
   #        - *G*         Global replacement; all occurrences of the regexp in each target string will be replaced.  Without this, only the first occurrence will be replaced.
-  # @param encoding [Enum['N','E','S','U']]
-  #      Deprecated and ignored parameter, included only for compatibility.
   # @return [Array[String], String] The result of the substitution. Result type is the same as for the target parameter.
-  # @deprecated
-  #   This method has the optional encoding parameter, which is ignored.
   # @example Get the third octet from the node's IP address:
   #   ```puppet
   #   $i3 = regsubst($ipaddress,'^(\\d+)\\.(\\d+)\\.(\\d+)\\.(\\d+)$','\\3')
@@ -33,7 +29,6 @@ Puppet::Functions.create_function(:regsubst) do
     param          'String',                              :pattern
     param          'Variant[String,Hash[String,String]]', :replacement
     optional_param 'Optional[Pattern[/^[GEIM]*$/]]',      :flags
-    optional_param "Enum['N','E','S','U']",               :encoding
   end
 
   # @param target [String, Array[String]]
@@ -65,14 +60,7 @@ Puppet::Functions.create_function(:regsubst) do
     optional_param 'Pattern[/^G?$/]',                     :flags
   end
 
-  def regsubst_string(target, pattern, replacement, flags = nil, encoding = nil)
-    if encoding
-      Puppet.warn_once(
-        'deprecations', 'regsubst_function_encoding',
-        _("The regsubst() function's encoding argument has been ignored since Ruby 1.9 and will be removed in a future release")
-      )
-    end
-
+  def regsubst_string(target, pattern, replacement, flags = nil)
     re_flags = 0
     operation = :sub
     unless flags.nil?

data/lib/puppet/functions/reverse_each.rb

@@ -1,7 +1,7 @@
 # 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
+# [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html) for each
 # element.
 #
 # This function takes one to two arguments:
@@ -34,22 +34,22 @@
 # $reverse_data = reverse_each($data)
 # ```
 #
-# When no second argument is present, Puppet returns an `Iterable` that represents the reverse
+# When no second argument is present, OpenVox returns an `Iterable` that represents the reverse
 # order of its first argument. This allows methods on `Iterable` to be chained.
 #
-# When a lambda is given as the second argument, Puppet iterates the first argument in reverse
+# When a lambda is given as the second argument, OpenVox iterates the first argument in reverse
 # order and passes each value in turn to the lambda, then returns `undef`.
 #
 # @example Using the `reverse_each` function with an array and a one-parameter lambda
 #
 # ```puppet
-# # Puppet will log a notice for each of the three items
+# # OpenVox will log a notice for each of the three items
 # # in $data in reverse order.
 # $data = [1,2,3]
 # $data.reverse_each |$item| { notice($item) }
 # ```
 #
-# When no second argument is present, Puppet returns a new `Iterable` which allows it to
+# When no second argument is present, OpenVox returns a new `Iterable` which allows it to
 # be directly chained into another function that takes an `Iterable` as an argument.
 #
 # @example Using the `reverse_each` function chained with a `map` function.

data/lib/puppet/functions/scanf.rb

@@ -2,7 +2,7 @@
 
 # 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.)
+# are similar but not identical to the formats used in OpenVox's `sprintf` function.)
 #
 # This function takes two mandatory arguments: the first is the string to convert, and the second is
 # the format string. The result of the scan is an array, with each successfully scanned and transformed value.

data/lib/puppet/functions/step.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Provides stepping with given interval over elements in an iterable and optionally runs a
-# [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html) for each
+# [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html) for each
 # element.
 #
 # This function takes two to three arguments:
@@ -35,9 +35,9 @@
 # $stepped_data = step($data, <n>)
 # ```
 #
-# When no block is given, Puppet returns an `Iterable` that yields the first element and every nth successor
+# When no block is given, OpenVox returns an `Iterable` that yields the first element and every nth successor
 # element, from its first argument. This allows functions on iterables to be chained.
-# When a block is given, Puppet iterates and calls the block with the first element and then with
+# When a block is given, OpenVox iterates and calls the block with the first element and then with
 # every nth successor element. It then returns `undef`.
 #
 # @example Using the `step` function with an array, a step factor, and a one-parameter block
@@ -48,10 +48,10 @@
 # $data.step(3) |$item| {
 #  notice($item)
 # }
-# # Puppet notices the values '1', '4', '7'.
+# # OpenVox notices the values '1', '4', '7'.
 # ```
 
-# When no block is given, Puppet returns a new `Iterable` which allows it to be directly chained into
+# When no block is given, OpenVox returns a new `Iterable` which allows it to be directly chained into
 # another function that takes an `Iterable` as an argument.
 #
 # @example Using the `step` function chained with a `map` function.

data/lib/puppet/functions/then.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Calls a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
+# Calls a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
 # with the given argument unless the argument is `undef`.
 # Returns `undef` if the argument is `undef`, and otherwise the result of giving the
 # argument to the lambda.

data/lib/puppet/functions/tree_each.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Runs a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
+# Runs a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
 # recursively and repeatedly using values from a data structure, then returns the unchanged data structure, or if
 # a lambda is not given, returns an `Iterator` for the tree.
 #
@@ -135,8 +135,8 @@
 # further as each filtered result appears as a `Tuple` with `[path, value]`.
 #
 #
-# For general examples that demonstrates iteration see the Puppet
-# [iteration](https://puppet.com/docs/puppet/latest/lang_iteration.html)
+# For general examples that demonstrates iteration see the OpenVox
+# [iteration](https://docs.openvoxproject.org/openvox/latest/lang_iteration.html)
 # documentation.
 #
 # @since 5.0.0

data/lib/puppet/functions/versioncmp.rb

@@ -25,7 +25,7 @@ require_relative '../../puppet/util/package'
 #         notice('2.6-1 is > than 2.4.5')
 #     }
 #
-# This function uses the same version comparison algorithm used by Puppet's
+# This function uses the same version comparison algorithm used by OpenVox's
 # `package` type.
 #
 Puppet::Functions.create_function(:versioncmp) do

data/lib/puppet/functions/with.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-# Calls a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
+# Calls a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
 # with the given arguments and returns the result.
 #
 # Since a lambda's scope is
-# [local](https://puppet.com/docs/puppet/latest/lang_lambdas.html#lambda-scope)
+# [local](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html#lambda-scope)
 # to the lambda, you can use the `with` function to create private blocks of code within a
 # class using variables whose values cannot be accessed outside of the lambda.
 #

data/lib/puppet/functions/yaml_data.rb

@@ -3,7 +3,7 @@
 require 'yaml'
 
 # The `yaml_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
+# See [the configuration guide documentation](https://docs.openvoxproject.org/openvox/latest/hiera_config_yaml_5.html#configuring-a-hierarchy-level-built-in-backends) for
 # how to use this function.
 #
 # @since 4.8.0

data/lib/puppet/generate/type.rb

@@ -45,11 +45,14 @@ module Puppet
         end
 
         # Determines if the output file is up-to-date with respect to the input file.
+        # Generated files are stamped with their input's mtime, so the output is
+        # up-to-date only on an exact match; an input with older timestamps (e.g.
+        # a module downgrade) also triggers regeneration.
         # @param [String, nil] The path to output to, or nil if determined by input
         # @return [Boolean] Returns true if the output is up-to-date or false if not.
         def up_to_date?(outputdir)
           f = effective_output_path(outputdir)
-          Puppet::FileSystem.exist?(f) && (Puppet::FileSystem.stat(@path) <=> Puppet::FileSystem.stat(f)) <= 0
+          Puppet::FileSystem.exist?(f) && (Puppet::FileSystem.stat(@path) <=> Puppet::FileSystem.stat(f)) == 0
         end
 
         # Gets the filename of the output file.
@@ -240,6 +243,7 @@ module Puppet
             Puppet::FileSystem.open(effective_output_path, nil, 'w:UTF-8') do |file|
               file.write(result)
             end
+            Puppet::FileSystem.touch(effective_output_path, mtime: Puppet::FileSystem.stat(input.path).mtime)
           rescue Exception => e
             @bad_input = true
             Puppet.log_exception(e, _("Failed to generate '%{effective_output_path}': %{message}") % { effective_output_path: effective_output_path, message: e.message })

data/lib/puppet/gettext/config.rb

@@ -79,7 +79,7 @@ module Puppet::GettextConfig
 
   # @api private
   # Resets the thread's configured text_domain to the default text domain.
-  # In Puppet Server, thread A may process a compile request that configures
+  # In OpenVox Server, thread A may process a compile request that configures
   # a domain, while thread B may invalidate that environment and delete the
   # domain. That leaves thread A with an invalid text_domain selected.
   # To avoid that, clear_text_domain after any processing that needs the
@@ -92,12 +92,12 @@ module Puppet::GettextConfig
 
   # @api private
   # Creates a default text domain containing the translations for
-  # Puppet as the start of chain. When semantic_puppet gets initialized,
+  # OpenVox as the start of chain. When semantic_puppet gets initialized,
   # its translations are added to this chain. This is used as a cache
   # so that all non-module translations only need to be loaded once as
   # we create and reset environment-specific text domains.
   #
-  # @return true if Puppet translations were successfully loaded, false
+  # @return true if OpenVox translations were successfully loaded, false
   # otherwise
   def self.create_default_text_domain
     return if @gettext_disabled || !gettext_loaded?
@@ -169,10 +169,10 @@ module Puppet::GettextConfig
   # @api private
   # Adds translations from the default text domain to the specified
   # text domain. Creates the default text domain if one does not exist
-  # (this will load Puppet's translations).
+  # (this will load OpenVox's translations).
   #
   # Since we are currently (Nov 2017) vendoring semantic_puppet, in normal
-  # flows these translations will be copied along with Puppet's.
+  # flows these translations will be copied along with OpenVox's.
   #
   # @param [Symbol] domain_name the name of the domain to add translations to
   def self.copy_default_translations(domain_name)

data/lib/puppet/gettext/module_translations.rb

@@ -26,7 +26,7 @@ module Puppet::ModuleTranslations
   # @api private
   # Loads translation files that have been pluginsync'd for modules
   # from the $vardir.
-  # @param [String] vardir the path to Puppet's vardir
+  # @param [String] vardir the path to OpenVox's vardir
   def self.load_from_vardir(vardir)
     locale = Puppet::GettextConfig.current_locale
     Dir.glob("#{vardir}/locales/#{locale}/*.po") do |f|

data/lib/puppet/graph/simple_graph.rb

@@ -2,7 +2,6 @@
 
 require_relative '../../puppet/external/dot'
 require_relative '../../puppet/relationship'
-require 'set'
 
 # A hopefully-faster graph class to replace the use of GRATR.
 class Puppet::Graph::SimpleGraph

data/lib/puppet/http/client.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # The HTTP client provides methods for making `GET`, `POST`, etc requests to
-# HTTP(S) servers. It also provides methods for resolving Puppetserver REST
+# HTTP(S) servers. It also provides methods for resolving OpenVox Server REST
 # service endpoints using SRV records and settings (such as `server_list`,
 # `server`, `ca_server`, etc). Once a service endpoint has been resolved, there
 # are methods for making REST requests (such as getting a node, sending facts,
@@ -10,9 +10,9 @@
 # The client uses persistent HTTP connections by default unless the `Connection:
 # close` header is specified and supports streaming response bodies.
 #
-# By default the client only trusts the Puppet CA for HTTPS connections. However,
-# if the `include_system_store` request option is set to true, then Puppet will
-# trust certificates in the puppet-agent CA bundle.
+# By default the client only trusts the OpenVox CA for HTTPS connections. However,
+# if the `include_system_store` request option is set to true, then OpenVox will
+# trust certificates in the openvox-agent CA bundle.
 #
 # @example To access the HTTP client:
 #   client = Puppet.runtime[:http]
@@ -20,7 +20,7 @@
 # @example To make an HTTP GET request:
 #   response = client.get(URI("http://www.example.com"))
 #
-# @example To make an HTTPS GET request, trusting the puppet CA and certs in Puppet's CA bundle:
+# @example To make an HTTPS GET request, trusting the OpenVox CA and certs in OpenVox's CA bundle:
 #   response = client.get(URI("https://www.example.com"), options: { include_system_store: true })
 #
 # @example To use a URL containing special characters, such as spaces:

data/lib/puppet/http/factory.rb

@@ -7,7 +7,7 @@ require_relative '../../puppet/http'
 # Factory for `Net::HTTP` objects.
 #
 # Encapsulates the logic for creating a `Net::HTTP` object based on the
-# specified {Site} and puppet settings.
+# specified {Site} and OpenVox settings.
 #
 # @api private
 class Puppet::HTTP::Factory

data/lib/puppet/http/resolver/server_list.rb

@@ -62,11 +62,11 @@ class Puppet::HTTP::Resolver::ServerList < Puppet::HTTP::Resolver
         return Puppet::HTTP::Service.create_service(@client, session, name, @resolved_url.host, @resolved_url.port)
       rescue Puppet::HTTP::ResponseError => detail
         if index < @server_list_setting.value.length - 1
-          Puppet.warning(_("Puppet server %{host}:%{port} is unavailable: %{code} %{reason}") %
+          Puppet.warning(_("OpenVox server %{host}:%{port} is unavailable: %{code} %{reason}") %
                               { host: service.url.host, port: service.url.port, code: detail.response.code, reason: detail.response.reason } +
                               ' ' + _("Trying with next server from server_list."))
         else
-          Puppet.log_exception(detail, _("Puppet server %{host}:%{port} is unavailable: %{code} %{reason}") %
+          Puppet.log_exception(detail, _("OpenVox server %{host}:%{port} is unavailable: %{code} %{reason}") %
                                { host: service.url.host, port: service.url.port, code: detail.response.code, reason: detail.response.reason })
         end
       rescue Puppet::HTTP::HTTPError => detail