Sha256: 2f7a2c02f65ec1415f6b3c9a545e8e2914b72248a8faa03c986812cb1d95732e

Contents?: true

Size: 1.07 KB

Versions: 164

Compression:

Stored size: 1.07 KB

Contents

# Unwraps a Sensitive value and returns the wrapped object.
#
# ~~~puppet
# $plaintext = 'hunter2'
# $pw = Sensitive.new($plaintext)
# notice("Wrapped object is $pw") #=> Prints "Wrapped object is Sensitive [value redacted]"
# $unwrapped = $pw.unwrap
# notice("Unwrapped object is $unwrapped") #=> Prints "Unwrapped object is hunter2"
# ~~~
#
# You can optionally pass a block to unwrap in order to limit the scope where the
# unwrapped value is visible.
#
# ~~~puppet
# $pw = Sensitive.new('hunter2')
# notice("Wrapped object is $pw") #=> Prints "Wrapped object is Sensitive [value redacted]"
# $pw.unwrap |$unwrapped| {
#   $conf = inline_template("password: ${unwrapped}\n")
#   Sensitive.new($conf)
# } #=> Returns a new Sensitive object containing an interpolated config file
# # $unwrapped is now out of scope
# ~~~
#
# @since 4.0.0
#
Puppet::Functions.create_function(:unwrap) do
  dispatch :unwrap do
    param 'Sensitive', :arg
    optional_block_param
  end

  def unwrap(arg)
    unwrapped = arg.unwrap
    if block_given?
      yield(unwrapped)
    else
      unwrapped
    end
  end
end

Version data entries

164 entries across 164 versions & 3 rubygems

Version Path
puppet-retrospec-1.8.0 vendor/pup410/lib/puppet/functions/unwrap.rb
puppet-retrospec-1.7.0 vendor/pup410/lib/puppet/functions/unwrap.rb
puppet-5.3.7 lib/puppet/functions/unwrap.rb
puppet-5.3.7-x86-mingw32 lib/puppet/functions/unwrap.rb
puppet-5.3.7-x64-mingw32 lib/puppet/functions/unwrap.rb
puppet-5.3.7-universal-darwin lib/puppet/functions/unwrap.rb
puppet-4.10.12 lib/puppet/functions/unwrap.rb
puppet-4.10.12-x86-mingw32 lib/puppet/functions/unwrap.rb
puppet-4.10.12-x64-mingw32 lib/puppet/functions/unwrap.rb
puppet-4.10.12-universal-darwin lib/puppet/functions/unwrap.rb
puppet-4.10.11 lib/puppet/functions/unwrap.rb
puppet-4.10.11-x86-mingw32 lib/puppet/functions/unwrap.rb
puppet-4.10.11-x64-mingw32 lib/puppet/functions/unwrap.rb
puppet-4.10.11-universal-darwin lib/puppet/functions/unwrap.rb
puppet-5.3.6 lib/puppet/functions/unwrap.rb
puppet-5.3.6-x86-mingw32 lib/puppet/functions/unwrap.rb
puppet-5.3.6-x64-mingw32 lib/puppet/functions/unwrap.rb
puppet-5.3.6-universal-darwin lib/puppet/functions/unwrap.rb
bolt-0.17.1 vendored/puppet/lib/puppet/functions/unwrap.rb
bolt-0.17.0 vendored/puppet/lib/puppet/functions/unwrap.rb