Module: Ignorable Private

Includes:: Kernel

Defined in:: ignorable.rb,
ignorable.rbi

This module is part of a private API. This module may only be used in the Homebrew/brew repository. Third parties should avoid using this module if possible, as it may be removed or changed without warning.

Defined Under Namespace

Modules: ExceptionMixin

Constant Summary

Constants included from Kernel

Kernel::IGNORE_INTERRUPTS_MUTEX

Class Method Summary collapse

.hook_raise(&blk) ⇒ void private
.raise ⇒ Object private
This is a workaround to enable raise to be aliased.
.unhook_raise ⇒ void private

Methods included from Kernel

#ensure_executable!, #exec_browser, #exec_editor, #ignore_interrupts, #interactive_shell, #quiet_system, #redirect_stdout, #safe_system, #which, #which_editor, #with_env, #with_homebrew_path

Class Method Details

.hook_raise(&blk) ⇒ `void`

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

This method returns an undefined value.

Parameters:

blk (T.proc.void, nil)

# File 'ignorable.rb', line 24

def self.hook_raise(&blk)
  Object.class_eval do
    alias_method :original_raise, :raise

    # `define_method` keeps Sorbet happy inside this `class_eval` block.
    define_method(:raise) do |*args|
      callcc do |continuation|
        super(*args)
      # Handle all possible exceptions.
      rescue Exception => e # rubocop:disable Lint/RescueException
        unless e.is_a?(ScriptError)
          e.extend(ExceptionMixin)
          T.cast(e, ExceptionMixin).continuation = continuation
        end
        super(e)
      end
    end

    alias_method :fail, :raise
  end

  return unless block_given?

  yield
  unhook_raise
end

.raise ⇒ `Object`

This is a workaround to enable raise to be aliased

.unhook_raise ⇒ `void`