observers 0.9.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbb9116b5b3a86d777d4aca13b5c4c04214340596e1df83adebada4dd871bc43
-  data.tar.gz: 560fbbb9480ac2968036b8024e9362c12ea68994c77a587abc2432505ceeda7f
+  metadata.gz: 1baa5ca1c0866fe6e708bc669db53424411099c44a7747cbe441f3e50191b3b8
+  data.tar.gz: 361100827e869fa95814d94ae4789637bb7b794d3e55063414adc647683e47e9
 SHA512:
-  metadata.gz: 403fe656fda85237d897b4e82b84e9b770f352807ac5ef05a37f4c1d58784af7f43e5f22d6ab5999bdebeea831350757125f184870de45ad78330efc6fe07ace
-  data.tar.gz: '06680f408eaf15377c441fd995a7a3b05b3a41bcf6b8e3e3aa87dd06a6e65227f43a50b01c03193845d26d306e368b2ecfaec814af0cb8f4ba9a34386641af83'
+  metadata.gz: 319423e0cd9b9cc4b2c68dd5887eef9c0cae72102957d79bddb86e13f18dcc369fdb5b5d361d88c5b27fb1503c80883c2c3692a50fb847c01b3caa206a622a07
+  data.tar.gz: afcfe235cc45aad95d657d3da28c118d116d767cda8f24790c7c99467cfc660493c18896eb0b0dcda893a0117b45b0e74b80ec290439a79e16821e54b0183811

data/lib/models/observer.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative 'observer_error'
+
 module Observers
   class Observer
     attr_reader :object, :action
@@ -20,15 +22,10 @@ module Observers
       else
         @object.send(action)
       end
-    rescue ArgumentError => e
-      type = @object.instance_of?(Class) ? @object : @object.class
-      method_type = @object.instance_of?(Class) ? '.' : '#'
-
-      raise ArgumentError, "#{type}##{action} has an 'event:' keyword argument but no event arg was sent" if event.nil?
-
-      # Events trigger events, so the error bubbles up to become the error message for the next rescue's error message:
-      # "RequestEvent sent to Rain::Router#route_request -> StatusEvent sent to Error404Node.render -> unknown keyword: :props"
-      raise ArgumentError, "#{event.class} sent to #{type}#{method_type}#{action} -> #{e.message}"
+    rescue StandardError => e
+      # Events trigger events, so this error bubbles up to become the error for the next rescue:
+      # "RequestEvent -> Rain::Router#route_request -> StatusEvent -> Error404Node.render -> unknown keyword: :props"
+      raise ObserverError.new(e.message, object:, event:, action:, previous_error: e)
     end
   end
 end

data/lib/models/observer_error.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Observers
+  # Map the events and actions along the way when showing an exception.
+  # Any exceptions in this class itself will fail silently as they will error out into itself.
+  class ObserverError < StandardError
+    def initialize(message, object:, event:, action:, previous_error:)
+      super(message)
+
+      @event = event
+      @object = object
+      @action = action
+      @previous_error = previous_error
+    end
+
+    def link
+      class_type = @object.instance_of?(Class) ? @object : @object.class
+      method_type = @object.instance_of?(Class) ? '.' : '#'
+      "#{@event.class} -> #{class_type}#{method_type}#{@action}"
+    end
+
+    def to_s
+      chain = [link]
+      first_error = first_error(@previous_error, chain:)
+      error_location = first_error.backtrace.first
+
+      "#{chain.join(' -> ')} -> #{first_error.message}\n#{error_location}"
+    end
+
+    private
+
+    def first_error(error, chain:)
+      chain << error.link if error.respond_to?(:link)
+
+      return error unless error.respond_to?(:previous_error)
+
+      first_error(error.previous_error, chain:)
+    end
+  end
+end

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Observers
-  VERSION = '0.9.0'
+  VERSION = '1.0.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: observers
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 1.0.0
 platform: ruby
 authors:
 - maedi
@@ -19,6 +19,7 @@ files:
 - lib/keys.rb
 - lib/models/key.rb
 - lib/models/observer.rb
+- lib/models/observer_error.rb
 - lib/observers.rb
 - lib/version.rb
 homepage: https://github.com/raindeer-rb/observers