view modules/stdlib/lib/puppet/parser/functions/get_module_path.rb @ 478:adf6fe9bbc17

Update Puppet modules to latest versions
author IBBoard <dev@ibboard.co.uk>
date Thu, 29 Aug 2024 18:47:29 +0100
parents d9352a684e62
children
line wrap: on
line source

# frozen_string_literal: true

#
# get_module_path.rb
#
module Puppet::Parser::Functions
  newfunction(:get_module_path, type: :rvalue, doc: <<-DOC
    @summary
      Returns the absolute path of the specified module for the current
      environment.

    @return
      Returns the absolute path of the specified module for the current
      environment.

    @example Example Usage:
      $module_path = get_module_path('stdlib')

    > *Note:*
      that since Puppet 5.4.0 the  built-in
      [`module_directory`](https://puppet.com/docs/puppet/latest/function.html#module_directory)
      function in Puppet does the same thing and will return the path to the first found module
      if given multiple values or an array.
  DOC
  ) do |args|
    raise(Puppet::ParseError, 'get_module_path(): Wrong number of arguments, expects one') unless args.size == 1

    module_path = Puppet::Module.find(args[0], compiler.environment.to_s)
    raise(Puppet::ParseError, "Could not find module #{args[0]} in environment #{compiler.environment}") unless module_path

    module_path.path
  end
end