Sha256: 7109faaed984f357d4e3d8ed1c821fdb2e9c8b47cb5f7dfab7f5278cca96f9a6

Contents?: true

Size: 941 Bytes

Versions: 12

Compression:

Stored size: 941 Bytes

Contents

# frozen_string_literal: true

# Read a file and return its contents.
Puppet::Functions.create_function(:'file::read', Puppet::Functions::InternalFunction) do
  # @param filename Absolute path or Puppet file path.
  # @return The file's contents.
  # @example Read a file from disk
  #   file::read('/tmp/i_dumped_this_here')
  # @example Read a file from the modulepath
  #   file::read('example/files/VERSION')
  dispatch :read do
    scope_param
    required_param 'String', :filename
    return_type 'String'
  end

  def read(scope, filename)
    Puppet.lookup(:bolt_executor) {}&.report_function_call(self.class.name)
    found = Puppet::Parser::Files.find_file(filename, scope.compiler.environment)
    unless found && Puppet::FileSystem.exist?(found)
      raise Puppet::ParseErrorWithIssue.from_issue_and_stack(
        Puppet::Pops::Issues::NO_SUCH_FILE_OR_DIRECTORY, file: filename
      )
    end

    File.read(found)
  end
end

Version data entries

12 entries across 12 versions & 1 rubygems

Version Path
bolt-2.9.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.8.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.7.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.6.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.5.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.4.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.3.1 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.3.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.2.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.1.0 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.0.1 bolt-modules/file/lib/puppet/functions/file/read.rb
bolt-2.0.0 bolt-modules/file/lib/puppet/functions/file/read.rb