Sha256: b1f2d56a066359aa3f0e916225cc7c5121013e30a4e814943fdcb9ab12131719

Contents?: true

Size: 1.74 KB

Versions: 50

Compression:

Stored size: 1.74 KB

Contents

# frozen_string_literal: true

# Catches errors in a given block and returns them. This will return the
# output of the block if no errors are raised. Accepts an optional list of
# error kinds to catch.
#
# > **Note:** Not available in apply block
Puppet::Functions.create_function(:catch_errors) do
  # @param error_types An array of error types to catch
  # @param block The block of steps to catch errors on
  # @return If an error is raised in the block then the error will be returned,
  #         otherwise the result will be returned
  # @example Catch errors for a block
  #   catch_errors() || {
  #     run_command("whoami", $targets)
  #     run_command("adduser ryan", $targets)
  #   }
  # @example Catch parse errors for a block of code
  #   catch_errors(['bolt/parse-error']) || {
  #    run_plan('canary', $targets)
  #    run_plan('other_plan)
  #    apply($targets) || {
  #      notify { "Hello": }
  #    }
  #   }
  dispatch :catch_errors do
    optional_param 'Array[String[1]]', :error_types
    block_param 'Callable[0, 0]', :block
    return_type 'Any'
  end

  def catch_errors(error_types = nil)
    unless Puppet[:tasks]
      raise Puppet::ParseErrorWithIssue
        .from_issue_and_stack(Bolt::PAL::Issues::PLAN_OPERATION_NOT_SUPPORTED_WHEN_COMPILING,
                              action: self.class.name)
    end

    executor = Puppet.lookup(:bolt_executor)
    # Send Analytics Report
    executor.report_function_call(self.class.name)

    begin
      yield
    rescue Puppet::PreformattedError => e
      if e.cause.is_a?(Bolt::Error)
        if error_types.nil? || error_types.include?(e.cause.to_h['kind'])
          e.cause.to_puppet_error
        else
          raise e
        end
      else
        raise e
      end
    end
  end
end

Version data entries

50 entries across 50 versions & 1 rubygems

Version Path
bolt-4.0.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.29.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.28.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.27.4 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.27.2 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.27.1 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.26.2 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.26.1 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.25.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.24.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.23.1 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.23.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.22.1 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.22.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.21.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.20.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.19.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.18.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.17.0 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb
bolt-3.16.1 bolt-modules/boltlib/lib/puppet/functions/catch_errors.rb