bolt 0.24.0 → 0.25.0

data/vendored/puppet/lib/puppet/parser/functions/scanf.rb

@@ -1,38 +0,0 @@
-require 'scanf'
-
-Puppet::Parser::Functions::newfunction(
-  :scanf,
-  :type => :rvalue,
-  :arity => 2,
-  :doc => <<-DOC
-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.)
-
-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.
-The scanning stops if a scan is unsuccessful, and the scanned result up to that point is returned. If there
-was no successful scan, the result is an empty array.
-
-```puppet
-"42".scanf("%i")
-```
-
-You can also optionally pass a lambda to scanf, to do additional validation or processing.
-
-```puppet
-"42".scanf("%i") |$x| {
-  unless $x[0] =~ Integer {
-    fail "Expected a well formed integer value, got '$x[0]'"
-  }
-  $x[0]
-}
-```
-
-- Since 4.0.0
-DOC
-) do |args|
-  data = args[0]
-  format = args[1]
-  data.scanf(format)
-end

data/vendored/puppet/lib/puppet/parser/functions/sha1.rb

@@ -1,5 +0,0 @@
-require 'digest/sha1'
-
-Puppet::Parser::Functions::newfunction(:sha1, :type => :rvalue, :arity => 1, :doc => "Returns a SHA1 hash value from a provided string.") do |args|
-      Digest::SHA1.hexdigest(args[0])
-end

data/vendored/puppet/lib/puppet/parser/functions/sha256.rb

@@ -1,5 +0,0 @@
-require 'digest/sha2'
-
-Puppet::Parser::Functions::newfunction(:sha256, :type => :rvalue, :arity => 1, :doc => "Returns a SHA256 hash value from a provided string.") do |args|
-  Digest::SHA256.hexdigest(args[0])
-end

data/vendored/puppet/lib/puppet/parser/functions/shellquote.rb

@@ -1,61 +0,0 @@
-# Copyright (C) 2009 Thomas Bellman
-#
-# Permission is hereby granted, free of charge, to any person obtaining
-# a copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish,
-# distribute, sublicense, and/or sell copies of the Software, and to
-# permit persons to whom the Software is furnished to do so, subject to
-# the following conditions:
-#
-# The above copyright notice and this permission notice shall be
-# included in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-# IN NO EVENT SHALL THOMAS BELLMAN BE LIABLE FOR ANY CLAIM, DAMAGES OR
-# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-# OTHER DEALINGS IN THE SOFTWARE.
-#
-# Except as contained in this notice, the name of Thomas Bellman shall
-# not be used in advertising or otherwise to promote the sale, use or
-# other dealings in this Software without prior written authorization
-# from Thomas Bellman.
-
-Puppet::Parser::Functions.newfunction(:shellquote, :type => :rvalue, :arity => -1, :doc => "\
-    Quote and concatenate arguments for use in Bourne shell.
-
-    Each argument is quoted separately, and then all are concatenated
-    with spaces.  If an argument is an array, the elements of that
-    array is interpolated within the rest of the arguments; this makes
-    it possible to have an array of arguments and pass that array to
-    shellquote instead of having to specify each argument
-    individually in the call.
-    ") \
-do |args|
-  safe = 'a-zA-Z0-9@%_+=:,./-'    # Safe unquoted
-  dangerous = '!"`$\\'            # Unsafe inside double quotes
-
-  result = []
-  args.flatten.each do |word|
-    if word.length != 0 and word.count(safe) == word.length
-      result << word
-    elsif word.count(dangerous) == 0
-      result << ('"' + word + '"')
-    elsif word.count("'") == 0
-      result << ("'" + word + "'")
-    else
-      r = '"'
-      word.each_byte do |c|
-        r += "\\" if dangerous.include?(c.chr)
-        r += c.chr
-      end
-      r += '"'
-      result << r
-    end
-  end
-
-  return result.join(" ")
-end

data/vendored/puppet/lib/puppet/parser/functions/slice.rb

@@ -1,39 +0,0 @@
-Puppet::Parser::Functions::newfunction(
-  :slice,
-  :type => :rvalue,
-  :arity => -3,
-  :doc => <<-DOC
-This function takes two mandatory arguments: the first should be an array or hash, and the second specifies
-the number of elements to include in each slice.
-
-When the first argument is a hash, each key value pair is counted as one. For example, a slice size of 2 will produce
-an array of two arrays with key, and value.
-
-    $a.slice(2) |$entry|          { notice "first ${$entry[0]}, second ${$entry[1]}" }
-    $a.slice(2) |$first, $second| { notice "first ${first}, second ${second}" }
-
-The function produces a concatenated result of the slices.
-
-    slice([1,2,3,4,5,6], 2) # produces [[1,2], [3,4], [5,6]]
-    slice(Integer[1,6], 2)  # produces [[1,2], [3,4], [5,6]]
-    slice(4,2)              # produces [[0,1], [2,3]]
-    slice('hello',2)        # produces [[h, e], [l, l], [o]]
-
-You can also optionally pass a lambda to slice.
-
-    $a.slice($n) |$x| { ... }
-    slice($a) |$x| { ... }
-
-The lambda should have either one parameter (receiving an array with the slice), or the same number
-of parameters as specified by the slice size (each parameter receiving its part of the slice).
-If there are fewer remaining elements than the slice size for the last slice, it will contain the remaining
-elements. If the lambda has multiple parameters, excess parameters are set to undef for an array, or
-to empty arrays for a hash.
-
-    $a.slice(2) |$first, $second| { ... }
-
-- Since 4.0.0
-DOC
-) do |args|
-  Puppet::Parser::Functions::Error.is4x('slice')
-end

data/vendored/puppet/lib/puppet/parser/functions/split.rb

@@ -1,28 +0,0 @@
-module Puppet::Parser::Functions
-
-  newfunction(
-  :split, :type => :rvalue,
-  :arity => 2,
-
-    :doc => "\
-Split a string variable into an array using the specified split regexp.
-
-*Example:*
-
-    $string     = 'v1.v2:v3.v4'
-    $array_var1 = split($string, ':')
-    $array_var2 = split($string, '[.]')
-    $array_var3 = split($string, Regexp['[.:]'])
-
-`$array_var1` now holds the result `['v1.v2', 'v3.v4']`,
-while `$array_var2` holds `['v1', 'v2:v3', 'v4']`, and
-`$array_var3` holds `['v1', 'v2', 'v3', 'v4']`.
-
-Note that in the second example, we split on a literal string that contains
-a regexp meta-character (.), which must be escaped.  A simple
-way to do that for a single character is to enclose it in square
-brackets; a backslash will also escape a single character.") do |args|
-
-    Error.is4x('split')
-  end
-end

data/vendored/puppet/lib/puppet/parser/functions/sprintf.rb

@@ -1,61 +0,0 @@
-# Copyright (C) 2009 Thomas Bellman
-#
-# Permission is hereby granted, free of charge, to any person obtaining
-# a copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish,
-# distribute, sublicense, and/or sell copies of the Software, and to
-# permit persons to whom the Software is furnished to do so, subject to
-# the following conditions:
-#
-# The above copyright notice and this permission notice shall be
-# included in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-# IN NO EVENT SHALL THOMAS BELLMAN BE LIABLE FOR ANY CLAIM, DAMAGES OR
-# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-# OTHER DEALINGS IN THE SOFTWARE.
-#
-# Except as contained in this notice, the name of Thomas Bellman shall
-# not be used in advertising or otherwise to promote the sale, use or
-# other dealings in this Software without prior written authorization
-# from Thomas Bellman.
-
-Puppet::Parser::Functions::newfunction(
-  :sprintf, :type => :rvalue,
-  :arity => -2,
-  :doc => "Perform printf-style formatting of text.
-
-  The first parameter is format string describing how the rest of the parameters should be formatted.
-  See the documentation for the [`Kernel::sprintf` function](https://ruby-doc.org/core/Kernel.html)
-  in Ruby for details.
-  
-  To use [named format](https://idiosyncratic-ruby.com/49-what-the-format.html) arguments, provide a
-  hash containing the target string values as the argument to be formatted. For example:
-
-  ```puppet
-  notice sprintf(\"%<x>s : %<y>d\", { 'x' => 'value is', 'y' => 42 })
-  ```
-
-  This statement produces a notice of `value is : 42`."
-
-) do |args|
-  fmt = args[0]
-  args = args[1..-1]
-  begin
-    return sprintf(fmt, *args)
-  rescue KeyError => e
-    if args.size == 1 && args[0].is_a?(Hash)
-      # map the single hash argument such that all top level string keys are symbols
-      # as that allows named arguments to be used in the format string.
-      #
-      result = {}
-      args[0].each_pair { |k,v| result[k.is_a?(String) ? k.to_sym : k] = v }
-      return sprintf(fmt, result)
-    end
-    raise e
-  end
-end

data/vendored/puppet/lib/puppet/parser/functions/step.rb

@@ -1,84 +0,0 @@
-Puppet::Parser::Functions::newfunction(
-  :step,
-  :type => :rvalue,
-  :arity => -1,
-  :doc => <<-DOC
-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
-element.
-
-This function takes two to three arguments:
-
-1. An 'Iterable' that the function will iterate over.
-2. An `Integer` step factor. This must be a positive integer.
-3. An optional lambda, which the function calls for each element in the interval. It must
-   request one parameter.
-
-**Example:** Using the `step` function
-
-```puppet
-$data.step(<n>) |$parameter| { <PUPPET CODE BLOCK> }
-```
-
-or
-
-```puppet
-$stepped_data = $data.step(<n>)
-```
-
-or
-```puppet
-step($data, <n>) |$parameter| { <PUPPET CODE BLOCK> }
-```
-
-or
-
-```puppet
-$stepped_data = step($data, <n>)
-```
-
-When no block is given, Puppet 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
-every nth successor element. It then returns `undef`.
-
-**Example:** Using the `step` function with an array, a step factor, and a one-parameter block
-
-```puppet
-# For the array $data, call a block with the first element and then with each 3rd successor element
-$data = [1,2,3,4,5,6,7,8]
-$data.step(3) |$item| {
- notice($item)
-}
-# Puppet notices the values '1', '4', '7'.
-```
-
-When no block is given, Puppet 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.
-
-```puppet
-# For the array $data, return an array, set to the first element and each 5th successor element, in reverse
-# order multiplied by 10
-$data = Integer[0,20]
-$transformed_data = $data.step(5).map |$item| { $item * 10 }
-$transformed_data contains [0,50,100,150,200]
-```
-
-**Example:** The same example using `step` function chained with a `map` in alternative syntax
-
-```puppet
-# For the array $data, return an array, set to the first and each 5th
-# successor, in reverse order, multiplied by 10
-$data = Integer[0,20]
-$transformed_data = map(step($data, 5)) |$item| { $item * 10 }
-$transformed_data contains [0,50,100,150,200]
-```
-
-* Since 4.4.0
-
-DOC
-) do |args|
-  Puppet::Parser::Functions::Error.is4x('step')
-end

data/vendored/puppet/lib/puppet/parser/functions/strftime.rb

@@ -1,185 +0,0 @@
-Puppet::Parser::Functions::newfunction(
-  :strftime,
-  :type => :rvalue,
-  :arity => -3,
-  :doc => <<DOC
-Formats timestamp or timespan according to the directives in the given format string. The directives begins with a percent (%) character.
-Any text not listed as a directive will be passed through to the output string.
-
-A third optional timezone argument can be provided. The first argument will then be formatted to represent a local time in that
-timezone. The timezone can be any timezone that is recognized when using the '%z' or '%Z' formats, or the word 'current', in which
-case the current timezone of the evaluating process will be used. The timezone argument is case insensitive.
-
-The default timezone, when no argument is provided, or when using the keyword `default`, is 'UTC'.
-
-The directive consists of a percent (%) character, zero or more flags, optional minimum field width and
-a conversion specifier as follows:
-```
-%[Flags][Width]Conversion
-```
-
-### Flags that controls padding
-
-| Flag  | Meaning
-| ----  | ---------------
-| -     | Don't pad numerical output
-| _     | Use spaces for padding
-| 0     | Use zeros for padding
-
-### `Timestamp` specific flags
-
-| Flag  | Meaning
-| ----  | ---------------
-| #     | Change case
-| ^     | Use uppercase
-| :     | Use colons for %z
-
-### Format directives applicable to `Timestamp` (names and padding can be altered using flags):
-
-**Date (Year, Month, Day):**
-
-| Format | Meaning |
-| ------ | ------- |
-| Y | Year with century, zero-padded to at least 4 digits |
-| C | year / 100 (rounded down such as 20 in 2009) |
-| y | year % 100 (00..99) |
-| m | Month of the year, zero-padded (01..12) |
-| B | The full month name ("January") |
-| b | The abbreviated month name ("Jan") |
-| h | Equivalent to %b |
-| d | Day of the month, zero-padded (01..31) |
-| e | Day of the month, blank-padded ( 1..31) |
-| j | Day of the year (001..366) |
-
-**Time (Hour, Minute, Second, Subsecond):**
-
-| Format | Meaning |
-| ------ | ------- |
-| H | Hour of the day, 24-hour clock, zero-padded (00..23) |
-| k | Hour of the day, 24-hour clock, blank-padded ( 0..23) |
-| I | Hour of the day, 12-hour clock, zero-padded (01..12) |
-| l | Hour of the day, 12-hour clock, blank-padded ( 1..12) |
-| P | Meridian indicator, lowercase ("am" or "pm") |
-| p | Meridian indicator, uppercase ("AM" or "PM") |
-| M | Minute of the hour (00..59) |
-| S | Second of the minute (00..60) |
-| L | Millisecond of the second (000..999). Digits under millisecond are truncated to not produce 1000 |
-| N | Fractional seconds digits, default is 9 digits (nanosecond). Digits under a specified width are truncated to avoid carry up |
-
-**Time (Hour, Minute, Second, Subsecond):**
-
-| Format | Meaning |
-| ------ | ------- |
-| z   | Time zone as hour and minute offset from UTC (e.g. +0900) |
-| :z  | hour and minute offset from UTC with a colon (e.g. +09:00) |
-| ::z | hour, minute and second offset from UTC (e.g. +09:00:00) |
-| Z   | Abbreviated time zone name or similar information.  (OS dependent) |
-
-**Weekday:**
-
-| Format | Meaning |
-| ------ | ------- |
-| A | The full weekday name ("Sunday") |
-| a | The abbreviated name ("Sun") |
-| u | Day of the week (Monday is 1, 1..7) |
-| w | Day of the week (Sunday is 0, 0..6) |
-
-**ISO 8601 week-based year and week number:**
-
-The first week of YYYY starts with a Monday and includes YYYY-01-04.
-The days in the year before the first week are in the last week of
-the previous year.
-
-| Format | Meaning |
-| ------ | ------- |
-| G | The week-based year |
-| g | The last 2 digits of the week-based year (00..99) |
-| V | Week number of the week-based year (01..53) |
-
-**Week number:**
-
-The first week of YYYY that starts with a Sunday or Monday (according to %U
-or %W). The days in the year before the first week are in week 0.
-
-| Format | Meaning |
-| ------ | ------- |
-| U | Week number of the year. The week starts with Sunday. (00..53) |
-| W | Week number of the year. The week starts with Monday. (00..53) |
-
-**Seconds since the Epoch:**
-
-| Format | Meaning |
-| s | Number of seconds since 1970-01-01 00:00:00 UTC. |
-
-**Literal string:**
-
-| Format | Meaning |
-| ------ | ------- |
-| n | Newline character (\n) |
-| t | Tab character (\t) |
-| % | Literal "%" character |
-
-**Combination:**
-
-| Format | Meaning |
-| ------ | ------- |
-| c | date and time (%a %b %e %T %Y) |
-| D | Date (%m/%d/%y) |
-| F | The ISO 8601 date format (%Y-%m-%d) |
-| v | VMS date (%e-%^b-%4Y) |
-| x | Same as %D |
-| X | Same as %T |
-| r | 12-hour time (%I:%M:%S %p) |
-| R | 24-hour time (%H:%M) |
-| T | 24-hour time (%H:%M:%S) |
-
-**Example**: Using `strftime` with a `Timestamp`:
-
-~~~ puppet
-$timestamp = Timestamp('2016-08-24T12:13:14')
-
-# Notice the timestamp using a format that notices the ISO 8601 date format
-notice($timestamp.strftime('%F')) # outputs '2016-08-24'
-
-# Notice the timestamp using a format that notices weekday, month, day, time (as UTC), and year
-notice($timestamp.strftime('%c')) # outputs 'Wed Aug 24 12:13:14 2016'
-
-# Notice the timestamp using a specific timezone
-notice($timestamp.strftime('%F %T %z', 'PST')) # outputs '2016-08-24 04:13:14 -0800'
-
-# Notice the timestamp using timezone that is current for the evaluating process
-notice($timestamp.strftime('%F %T', 'current')) # outputs the timestamp using the timezone for the current process
-~~~
-
-### Format directives applicable to `Timespan`:
-
-| Format | Meaning |
-| ------ | ------- |
-| D | Number of Days |
-| H | Hour of the day, 24-hour clock |
-| M | Minute of the hour (00..59) |
-| S | Second of the minute (00..59) |
-| L | Millisecond of the second (000..999). Digits under millisecond are truncated to not produce 1000. |
-| N | Fractional seconds digits, default is 9 digits (nanosecond). Digits under a specified length are truncated to avoid carry up |
-
-The format directive that represents the highest magnitude in the format will be allowed to overflow.
-I.e. if no "%D" is used but a "%H" is present, then the hours will be more than 23 in case the
-timespan reflects more than a day.
-
-**Example**: Using `strftime` with a Timespan and a format
-
-~~~ puppet
-$duration = Timespan({ hours => 3, minutes => 20, seconds => 30 })
-
-# Notice the duration using a format that outputs <hours>:<minutes>:<seconds>
-notice($duration.strftime('%H:%M:%S')) # outputs '03:20:30'
-
-# Notice the duration using a format that outputs <minutes>:<seconds>
-notice($duration.strftime('%M:%S')) # outputs '200:30'
-~~~
-
-- Since 4.8.0
-DOC
-) do |args|
-  Puppet::Parser::Functions::Error.is4x('strftime')
-end