puppet 7.24.0-x64-mingw32 → 8.1.0-x64-mingw32

data/lib/puppet/feature/bolt.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add(:bolt, :libs => ['bolt'])

data/lib/puppet/feature/cfpropertylist.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add(:cfpropertylist, :libs => ['cfpropertylist'])

data/lib/puppet/feature/eventlog.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 if Puppet::Util::Platform.windows?

data/lib/puppet/feature/hiera_eyaml.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add(:hiera_eyaml, :libs => ['hiera/backend/eyaml/parser/parser'])

data/lib/puppet/feature/hocon.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add(:hocon, :libs => ['hocon'])

data/lib/puppet/feature/libuser.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 require_relative '../../puppet/util/libuser'
 

data/lib/puppet/feature/msgpack.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add(:msgpack, :libs => ["msgpack"])

data/lib/puppet/feature/pe_license.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 #Is the pe license library installed providing the ability to read licenses.

data/lib/puppet/feature/pson.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+require_relative '../../puppet/util/feature'
+
+# PSON is deprecated, use JSON instead
+Puppet.features.add(:pson, :libs => ['puppet/external/pson'])

data/lib/puppet/feature/selinux.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add(:selinux, :libs => ["selinux"])

data/lib/puppet/feature/ssh.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add(:ssh, :libs => %{net/ssh})

data/lib/puppet/feature/telnet.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 Puppet.features.add :telnet do

data/lib/puppet/feature/zlib.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/feature'
 
 # We want this to load if possible, but it's not automatically

data/lib/puppet/ffi/posix/constants.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/ffi/posix'
 
 module Puppet::FFI::POSIX

data/lib/puppet/ffi/posix/functions.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/ffi/posix'
 
 module Puppet::FFI::POSIX

data/lib/puppet/ffi/posix.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'ffi'
 
 module Puppet

data/lib/puppet/ffi/windows/api_types.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/ffi/windows'
 require_relative '../../../puppet/util/windows/string'
 
@@ -20,7 +21,7 @@ module Puppet::FFI::Windows
 
     class ::FFI::Pointer
       NULL_HANDLE = 0
-      WCHAR_NULL = "\0\0".force_encoding('UTF-16LE').freeze
+      WCHAR_NULL = String.new("\0\0").force_encoding('UTF-16LE').freeze
 
       def self.from_string_to_wide_string(str, &block)
         str = Puppet::Util::Windows::String.wide_string(str)

data/lib/puppet/ffi/windows/constants.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/ffi/windows'
 
 module Puppet::FFI::Windows

data/lib/puppet/ffi/windows/functions.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/ffi/windows'
 
 module Puppet::FFI::Windows

data/lib/puppet/ffi/windows/structs.rb

@@ -1,4 +1,5 @@
 # coding: utf-8
+# frozen_string_literal: true
 require_relative '../../../puppet/ffi/windows'
 
 module Puppet::FFI::Windows

data/lib/puppet/ffi/windows.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'ffi'
 
 module Puppet

data/lib/puppet/file_bucket/dipper.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'pathname'
 require_relative '../../puppet/file_bucket'
 require_relative '../../puppet/file_bucket/file'

data/lib/puppet/file_bucket/file.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_bucket'
 require_relative '../../puppet/indirector'
 require_relative '../../puppet/util/checksums'

data/lib/puppet/file_bucket.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # stub
 module Puppet::FileBucket
   class BucketError < RuntimeError; end

data/lib/puppet/file_serving/base.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_serving'
 require_relative '../../puppet/util'
 

data/lib/puppet/file_serving/configuration/parser.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/file_serving/configuration'
 require_relative '../../../puppet/util/watched_file'
 

data/lib/puppet/file_serving/configuration.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet'
 require_relative '../../puppet/file_serving'
 require_relative '../../puppet/file_serving/mount'

data/lib/puppet/file_serving/content.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/indirector'
 require_relative '../../puppet/file_serving'
 require_relative '../../puppet/file_serving/base'

data/lib/puppet/file_serving/fileset.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'find'
 require_relative '../../puppet/file_serving'
 require_relative '../../puppet/file_serving/metadata'

data/lib/puppet/file_serving/http_metadata.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_serving/metadata'
 
 # Simplified metadata representation, suitable for the information

data/lib/puppet/file_serving/metadata.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet'
 require_relative '../../puppet/indirector'
 require_relative '../../puppet/file_serving'

data/lib/puppet/file_serving/mount/file.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/file_serving/mount'
 
 class Puppet::FileServing::Mount::File < Puppet::FileServing::Mount
   def self.localmap
     @localmap ||= {
-      "h" => Puppet.runtime[:facter].value("hostname"),
+      "h" => Puppet.runtime[:facter].value('networking.hostname'),
       "H" => [
-               Puppet.runtime[:facter].value("hostname"),
-               Puppet.runtime[:facter].value("domain")
+               Puppet.runtime[:facter].value('networking.hostname'),
+               Puppet.runtime[:facter].value('networking.domain')
              ].join("."),
-      "d" => Puppet.runtime[:facter].value("domain")
+      "d" => Puppet.runtime[:facter].value('networking.domain')
     }
   end
 

data/lib/puppet/file_serving/mount/locales.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/file_serving/mount'
 
 # Find files in the modules' locales directories.

data/lib/puppet/file_serving/mount/modules.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/file_serving/mount'
 
 # This is the modules-specific mount: it knows how to search through

data/lib/puppet/file_serving/mount/pluginfacts.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/file_serving/mount'
 
 # Find files in the modules' pluginfacts directories.

data/lib/puppet/file_serving/mount/plugins.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/file_serving/mount'
 
 # Find files in the modules' plugins directories.

data/lib/puppet/file_serving/mount/scripts.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'puppet/file_serving/mount'
 
 class Puppet::FileServing::Mount::Scripts < Puppet::FileServing::Mount

data/lib/puppet/file_serving/mount/tasks.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../../puppet/file_serving/mount'
 
 class Puppet::FileServing::Mount::Tasks < Puppet::FileServing::Mount

data/lib/puppet/file_serving/mount.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/logging'
 require_relative '../../puppet/file_serving'
 require_relative '../../puppet/file_serving/metadata'

data/lib/puppet/file_serving/terminus_helper.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_serving'
 require_relative '../../puppet/file_serving/fileset'
 

data/lib/puppet/file_serving/terminus_selector.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_serving'
 
 # This module is used to pick the appropriate terminus

data/lib/puppet/file_serving.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Just a stub class.
 class Puppet::FileServing # :nodoc:
 end

data/lib/puppet/file_system/file_impl.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Abstract implementation of the Puppet::FileSystem
 #
 class Puppet::FileSystem::FileImpl

data/lib/puppet/file_system/jruby.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_system/posix'
 
 class Puppet::FileSystem::JRuby < Puppet::FileSystem::Posix

data/lib/puppet/file_system/memory_file.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # An in-memory file abstraction. Commonly used with Puppet::FileSystem::File#overlay
 # @api private
 class Puppet::FileSystem::MemoryFile

data/lib/puppet/file_system/memory_impl.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 class Puppet::FileSystem::MemoryImpl
   def initialize(*files)
     @files = files + all_children_of(files)

data/lib/puppet/file_system/path_pattern.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'pathname'
 require_relative '../../puppet/error'
 
@@ -5,7 +6,7 @@ module Puppet::FileSystem
   class PathPattern
     class InvalidPattern < Puppet::Error; end
 
-    DOTDOT = '..'.freeze
+    DOTDOT = '..'
     ABSOLUTE_UNIX = /^\//
     ABSOLUTE_WINDOWS = /^[a-z]:/i
     CURRENT_DRIVE_RELATIVE_WINDOWS = /^\\/

data/lib/puppet/file_system/posix.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 class Puppet::FileSystem::Posix < Puppet::FileSystem::FileImpl
   def binread(path)
     path.binread
@@ -12,8 +13,8 @@ class Puppet::FileSystem::Posix < Puppet::FileSystem::FileImpl
   def compare_stream(path, stream)
     open(path, 0, 'rb') do |this|
       bsize = stream_blksize(this, stream)
-      sa = "".force_encoding('ASCII-8BIT')
-      sb = "".force_encoding('ASCII-8BIT')
+      sa = String.new.force_encoding('ASCII-8BIT')
+      sb = String.new.force_encoding('ASCII-8BIT')
       loop do
         this.read(bsize, sa)
         stream.read(bsize, sb)

data/lib/puppet/file_system/uniquefile.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_system'
 require 'delegate'
 require 'tmpdir'
@@ -150,7 +151,7 @@ class Puppet::FileSystem::Uniquefile < DelegateClass(File)
 
   def tmpdir
     tmp = '.'
-    for dir in [ Puppet::Util.get_env('TMPDIR'), Puppet::Util.get_env('TMP'), Puppet::Util.get_env('TEMP'), @@systmpdir, '/tmp']
+    for dir in [ ENV['TMPDIR'], ENV['TMP'], ENV['TEMP'], @@systmpdir, '/tmp']
       stat = File.stat(dir) if dir
       if stat && stat.directory? && stat.writable?
         tmp = dir

data/lib/puppet/file_system/windows.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/file_system/posix'
 require_relative '../../puppet/util/windows'
 

data/lib/puppet/file_system.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Puppet::FileSystem
   require_relative '../puppet/util'
   require_relative 'file_system/path_pattern'

data/lib/puppet/forge/cache.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'uri'
 
 require_relative '../../puppet/forge'

data/lib/puppet/forge/errors.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/util/json'
 require_relative '../../puppet/error'
 require_relative '../../puppet/forge'

data/lib/puppet/forge/repository.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../../puppet/ssl/openssl_loader'
 require 'digest/sha1'
 require 'uri'

data/lib/puppet/forge.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require_relative '../puppet/vendor'
 Puppet::Vendor.load_vendored
 
@@ -15,7 +16,7 @@ class Puppet::Forge < SemanticPuppet::Dependency::Source
 
   include Puppet::Forge::Errors
 
-  USER_AGENT = "PMT/1.1.1 (v3; Net::HTTP)".freeze
+  USER_AGENT = "PMT/1.1.1 (v3; Net::HTTP)"
 
   # From https://forgeapi.puppet.com/#!/release/getReleases
   MODULE_RELEASE_EXCLUSIONS=%w[readme changelog license uri module tags supported file_size downloads created_at updated_at deleted_at].join(',').freeze

data/lib/puppet/functions/abs.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Returns the absolute value of a Numeric value, for example -34.56 becomes
 # 34.56. Takes a single `Integer` or `Float` value as an argument.
 #

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: