Contents

Puppet::Parser::Functions::newfunction(:template, :type => :rvalue, :arity => -2, :doc =>
  "Loads an ERB template from a module, evaluates it, and returns the resulting
  value as a string.

  The argument to this function should be a `<MODULE NAME>/<TEMPLATE FILE>`
  reference, which will load `<TEMPLATE FILE>` from a module's `templates`
  directory. (For example, the reference `apache/vhost.conf.erb` will load the
  file `<MODULES DIRECTORY>/apache/templates/vhost.conf.erb`.)

  This function can also accept:

  * An absolute path, which can load a template file from anywhere on disk.
  * Multiple arguments, which will evaluate all of the specified templates and
  return their outputs concatenated into a single string.") do |vals|
    if Puppet[:tasks]
      raise Puppet::ParseErrorWithIssue.from_issue_and_stack(
        Puppet::Pops::Issues::FEATURE_NOT_SUPPORTED_WHEN_SCRIPTING,
        {:feature => 'ERB template'})
    end
    vals.collect do |file|
      # Use a wrapper, so the template can't get access to the full
      # Scope object.
      debug "Retrieving template #{file}"

      wrapper = Puppet::Parser::TemplateWrapper.new(self)
      wrapper.file = file
      begin
        wrapper.result
      rescue => detail
        info = detail.backtrace.first.split(':')
        message = []
        message << _("Failed to parse template %{file}:") % { file: file }
        message << _("  Filepath: %{file_path}") % { file_path: info[0] }
        message << _("  Line: %{line}") % { line: info[1] }
        message << _("  Detail: %{detail}") % { detail: detail }
        raise Puppet::ParseError, message.join("\n") + "\n"
      end
    end.join("")
end

Version data entries

458 entries across 458 versions & 2 rubygems

Version	Path
puppet-7.34.0	lib/puppet/parser/functions/template.rb
puppet-7.34.0-x86-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.34.0-x64-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.34.0-universal-darwin	lib/puppet/parser/functions/template.rb
puppet-7.33.0	lib/puppet/parser/functions/template.rb
puppet-7.33.0-x86-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.33.0-x64-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.33.0-universal-darwin	lib/puppet/parser/functions/template.rb
puppet-7.32.1	lib/puppet/parser/functions/template.rb
puppet-7.32.1-x86-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.32.1-x64-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.32.1-universal-darwin	lib/puppet/parser/functions/template.rb
puppet-7.31.0	lib/puppet/parser/functions/template.rb
puppet-7.31.0-x86-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.31.0-x64-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.31.0-universal-darwin	lib/puppet/parser/functions/template.rb
puppet-7.30.0	lib/puppet/parser/functions/template.rb
puppet-7.30.0-x86-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.30.0-x64-mingw32	lib/puppet/parser/functions/template.rb
puppet-7.30.0-universal-darwin	lib/puppet/parser/functions/template.rb