Puppet Function: ensure_packages

Defined in:
puppet/modules/stdlib/lib/puppet/parser/functions/ensure_packages.rb
Function type:
Ruby 3.x API

Overview

ensure_packages() ⇒ Any

Takes a list of packages and only installs them if they don't already exist. It optionally takes a hash as a second parameter that will be passed as the third argument to the ensure_resource() function.

Returns:

  • (Any) 


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
31
32
33
34
35
36
37
38
39
40
41
42
43
 
# File 'puppet/modules/stdlib/lib/puppet/parser/functions/ensure_packages.rb', line 6

newfunction(:ensure_packages, :type => :statement, :doc => <<-EOS
Takes a list of packages and only installs them if they don't already exist.
It optionally takes a hash as a second parameter that will be passed as the
third argument to the ensure_resource() function.
  EOS
) do |arguments|

  if arguments.size > 2 or arguments.size == 0
    raise(Puppet::ParseError, "ensure_packages(): Wrong number of arguments " +
      "given (#{arguments.size} for 1 or 2)")
  elsif arguments.size == 2 and !arguments[1].is_a?(Hash) 
    raise(Puppet::ParseError, 'ensure_packages(): Requires second argument to be a Hash')
  end

  if arguments[0].is_a?(Hash)
    if arguments[1]
      defaults = { 'ensure' => 'present' }.merge(arguments[1])
    else
      defaults = { 'ensure' => 'present' }
    end

    Puppet::Parser::Functions.function(:ensure_resources)
    function_ensure_resources(['package', arguments[0].dup, defaults ])
  else
    packages = Array(arguments[0])

    if arguments[1]
      defaults = { 'ensure' => 'present' }.merge(arguments[1])
    else
      defaults = { 'ensure' => 'present' }
    end

    Puppet::Parser::Functions.function(:ensure_resource)
    packages.each { |package_name|
      function_ensure_resource(['package', package_name, defaults ])
  }
  end
end