File: with.rb

package info (click to toggle)
puppet-agent 8.10.0-6
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 27,404 kB
  • sloc: ruby: 286,820; sh: 492; xml: 116; makefile: 88; cs: 68
file content (30 lines) | stat: -rw-r--r-- 937 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# frozen_string_literal: true

Puppet::Parser::Functions.newfunction(
  :with,
  :type => :rvalue,
  :arity => -1,
  :doc => <<~DOC
    Call a [lambda](https://puppet.com/docs/puppet/latest/lang_lambdas.html)
    with the given arguments and return the result. Since a lambda's scope is
    local 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.

    **Example**: Using `with`

    ~~~ puppet
    # Concatenate three strings into a single string formatted as a list.
    $fruit = with("apples", "oranges", "bananas") |$x, $y, $z| {
      "${x}, ${y}, and ${z}"
    }
    $check_var = $x
    # $fruit contains "apples, oranges, and bananas"
    # $check_var is undefined, as the value of $x is local to the lambda.
    ~~~

    - Since 4.0.0
  DOC
) do |_args|
  Puppet::Parser::Functions::Error.is4x('with')
end