Puppet Function: parseyaml

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

Overview

parseyaml()Any

This function accepts YAML as a string and converts it into the correct Puppet structure.

The optional second argument can be used to pass a default value that will be returned if the parsing of YAML string have failed.

Returns:

  • (Any)


5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# File 'modules/stdlib/lib/puppet/parser/functions/parseyaml.rb', line 5

newfunction(:parseyaml, :type => :rvalue, :doc => <<-DOC
  This function accepts YAML as a string and converts it into the correct
  Puppet structure.

  The optional second argument can be used to pass a default value that will
  be returned if the parsing of YAML string have failed.
DOC
           ) do |arguments|
  raise ArgumentError, 'Wrong number of arguments. 1 or 2 arguments should be provided.' unless arguments.length >= 1
  require 'yaml'

  begin
    YAML.load(arguments[0]) || arguments[1] # rubocop:disable Security/YAMLLoad : using YAML.safe_load causes the code to break
    # in ruby 1.9.3 Psych::SyntaxError is a RuntimeException
    # this still needs to catch that and work also on rubies that
    # do not have Psych available.
  rescue StandardError, Psych::SyntaxError => e # rubocop:disable Lint/ShadowedException : See above
    raise e unless arguments[1]
    arguments[1]
  end
end