Puppet Function: loadjson

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

Overview

loadjson()Any

Load a JSON file containing an array, string, or hash, and return the data in the corresponding native data type. The second parameter is the default value. It will be returned if the file was not found or could not be parsed.

For example:

$myhash = loadjson('/etc/puppet/data/myhash.json')
$myhash = loadjson('no-file.json', {'default' => 'val

Returns:

  • (Any)


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
31
# File 'modules/stdlib/lib/puppet/parser/functions/loadjson.rb', line 5

newfunction(:loadjson, :type => :rvalue, :arity => -2, :doc => <<-'DOC') do |args|
  Load a JSON file containing an array, string, or hash, and return the data
  in the corresponding native data type.
  The second parameter is the default value. It will be returned if the file
  was not found or could not be parsed.

  For example:

      $myhash = loadjson('/etc/puppet/data/myhash.json')
      $myhash = loadjson('no-file.json', {'default' => 'value'})
DOC

  raise ArgumentError, 'Wrong number of arguments. 1 or 2 arguments should be provided.' unless args.length >= 1

  if File.exists?(args[0]) # rubocop:disable Lint/DeprecatedClassMethods : Changing to .exist? breaks the code
    begin
      content = File.read(args[0])
      PSON.load(content) || args[1]
    rescue StandardError => e
      raise e unless args[1]
      args[1]
    end
  else
    warning("Can't load '#{args[0]}' File does not exist!")
    args[1]
  end
end