Module: NestedExceptions

Defined in:
lib/nested_exceptions.rb,
lib/nested_exceptions/define.rb,
lib/nested_exceptions/version.rb

Overview

Just include this module in your custom exception class

Constant Summary collapse

GLOBAL = 
true
VERSION = 
"1.0.0"

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#cause ⇒ Object (readonly)

Returns the value of attribute cause.



6
7
8
 
# File 'lib/nested_exceptions.rb', line 6

def cause
  @cause
end

Class Method Details

.const_missing(name) ⇒ Object 



4
5
6
7
8
9
10
 
# File 'lib/nested_exceptions/version.rb', line 4

def self.const_missing(name)
  if name == 'GLOBAL' or name == :GLOBAL
    NestedExceptions.const_set(name, false)
  else
    super
  end
end

.define_standard_exception_classes_in(target_module) ⇒ Object

Define a set of standard exception classes as recommended in exceptionalruby.com/

I actually recommend that you just define these manually, but this may be a handy shortcut in smaller projects.



8
9
10
11
12
13
14
15
16
17
18
19
20
21
 
# File 'lib/nested_exceptions/define.rb', line 8

def define_standard_exception_classes_in(target_module)
  definitions = %{
    class Error < StandardError; include NestedExceptions; end
      class UserError < Error; end
      class LogicError < Error; end
        class ClientError < LogicError; end
        class InternalError < LogicError; end
      class TransientError < Error; end
  }
  target_module.module_eval definitions
  [:Error, :UserError, :LogicError, :ClientError, :InternalError, :TransientError].map do |name|
    target_module.const_get name
  end
end

Instance Method Details

#backtrace ⇒ Object 



14
15
16
17
 
# File 'lib/nested_exceptions.rb', line 14

def backtrace
  return @processed_backtrace if defined? @processed_backtrace and @processed_backtrace
  @processed_backtrace = process_backtrace(super)
end

#initialize(message = nil, cause = nil) ⇒ Object 



8
9
10
11
 
# File 'lib/nested_exceptions.rb', line 8

def initialize(message = nil, cause = nil)
  @cause = cause || $!
  super(message)
end

#root_cause ⇒ Object 



24
25
26
27
28
29
30
31
32
 
# File 'lib/nested_exceptions.rb', line 24

def root_cause
  rc = e = self
  while e
    rc = e
    break unless e.respond_to? :cause
    e = e.cause
  end
  rc
end

#set_backtrace(bt) ⇒ Object 



19
20
21
 
# File 'lib/nested_exceptions.rb', line 19

def set_backtrace(bt)
  super process_backtrace(bt)
end