axn 0.1.0.pre.alpha.2.3 → 0.1.0.pre.alpha.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac3f240b093cdf14fef16b5eb6993dbb8f6d49ba58c837245128a0efb3558f11
-  data.tar.gz: 40b631f49349b51811ebb0bbc60cbc7962a3f7d633bab1134b7b234b4f681123
+  metadata.gz: e3313bd117a57aae98551088df5895b6db302830101dda0e2fb95f057f97000f
+  data.tar.gz: 9517e1d297998af62a2fc2107d3a002a71d5b767dda250b6ebec4d29958902a6
 SHA512:
-  metadata.gz: c8ac8be69e70d72d04b0c5be89e4ec198223c4a1771a15d254b82b0a204543c627a80321b3de95d69fa97a244fc56c9c39ca59262600c6b991c363603e0a7beb
-  data.tar.gz: 4eba5152626d0417ff3be725da9512034276d4b034898f8ad331890499196c1851a1d3dcd1cde880955c42f425090ab6c5fe30cac1496835013c7bd6cda52cdb
+  metadata.gz: e3b80de43c96e2362562dc35d88fd28d7c7b97a0dba2e73168031063fa8bed3d64ae3c46dd4f751af6ea051c17fc4592e6c246f505f9e319e5dd6e87caabfc67
+  data.tar.gz: c451f8b99639f94bb38d982ab4913b5e126ee099ed97f31cf2ad70903efbc5acb69bc715e634d39e56aad0720d8bd4007a24794255ea9519307f268b4f312061

data/CHANGELOG.md

@@ -3,6 +3,9 @@
 ## UNRELEASED
 * N/A
 
+## 0.1.0-alpha.2.4
+* [FEAT] Adds per-Axn `on_exception` handlers
+
 ## 0.1.0-alpha.2.3
 * `expects` / `exposes`: Add `type: :uuid` special case validation
 * [BUGFIX] Allow `hoist_errors` to pass the result through on success (allow access to subactions' exposures)

data/docs/reference/class.md

@@ -63,7 +63,7 @@ messages success: "All good!", error: ->(e) { "Bad news: #{e.message}" }
 
 While `.messages` sets the _default_ error/success messages and is more commonly used, there are times when you want specific error messages for specific failure cases.
 
-`error_for` and `rescues` both register a matcher (exception class, exception class name (string), or callable) and a message to use if the matcher succeeds.  They act exactly the same, except if a matcher registered with `rescues` succeeds, the exception _will not_ trigger the configured global error handler.
+`error_for` and `rescues` both register a matcher (exception class, exception class name (string), or callable) and a message to use if the matcher succeeds.  They act exactly the same, except if a matcher registered with `rescues` succeeds, the exception _will not_ trigger the configured exception handlers (global or specific to this class).
 
 ```ruby
 messages error: "bad"
@@ -75,3 +75,37 @@ rescues ActiveRecord::InvalidRecord => "Invalid params provided"
 error_for ArgumentError, ->(e) { "Argument error: #{e.message}"
 error_for -> { name == "bad" }, -> { "was given bad name: #{name}" }
 ```
+
+## `on_exception`
+
+Much like the [globally-configured on_exception hook](/reference/configuration#on-exception), you can also specify exception handlers for a _specific_ Axn class:
+
+```ruby
+class Foo
+  include Action
+
+  on_exception do |exception| # [!code focus:3]
+    # e.g. trigger a slack error
+  end
+end
+```
+
+Note that by default the `on_exception` block will be applied to _any_ `StandardError` that is raised, but you can specify a matcher using the same logic as for [`error_for` and `rescues`](#error-for-and-rescues):
+
+```ruby
+class Foo
+  include Action
+
+  on_exception NoMethodError do |exception| # [!code focus]
+    # e.g. trigger a slack error
+  end
+
+  on_exception ->(e) { e.is_a?(ZeroDivisionError) } do # [!code focus]
+    # e.g. trigger a slack error
+  end
+end
+```
+
+If multiple `on_exception` handlers are provided, ALL that match the raised exception will be triggered in the order provided.
+
+The _global_ handler will be triggered _after_ all class-specific handlers.

data/docs/reference/configuration.md

@@ -39,6 +39,7 @@ A couple notes:
 
   * `context` will contain the arguments passed to the `action`, _but_ any marked as sensitive (e.g. `expects :foo, sensitive: true`) will be filtered out in the logs.
   * If your handler raises, the failure will _also_ be swallowed and logged
+  * This handler is global across _all_ Axns.  You can also specify per-Action handlers via [the class-level declaration](/reference/class#on-exception).
 
 
 ## `top_level_around_hook`

data/lib/action/core/swallow_exceptions.rb

@@ -3,8 +3,10 @@
 module Action
   module SwallowExceptions
     CustomErrorInterceptor = Data.define(:matcher, :message, :should_report_error)
+    CustomErrorHandler = Data.define(:matcher, :block)
+
     class CustomErrorInterceptor
-      def matches?(exception:, action:)
+      def self.matches?(matcher:, exception:, action:)
         if matcher.respond_to?(:call)
           if matcher.arity == 1
             !!action.instance_exec(exception, &matcher)
@@ -24,12 +26,17 @@ module Action
         action.warn("Ignoring #{e.class.name} raised while determining matcher: #{e.message}")
         false
       end
+
+      def matches?(exception:, action:)
+        self.class.matches?(matcher:, exception:, action:)
+      end
     end
 
     def self.included(base)
       base.class_eval do
         class_attribute :_success_msg, :_error_msg
         class_attribute :_custom_error_interceptors, default: []
+        class_attribute :_exception_handlers, default: []
 
         include InstanceMethods
         extend ClassMethods
@@ -62,6 +69,10 @@ module Action
           interceptor = self.class._error_interceptor_for(exception: e, action: self)
           return if interceptor&.should_report_error == false
 
+          # Call any handlers registered on *this specific action* class
+          _on_exception(e)
+
+          # Call any global handlers
           Action.config.on_exception(e,
                                      action: self,
                                      context: respond_to?(:context_for_logging) ? context_for_logging : @context.to_h)
@@ -103,6 +114,12 @@ module Action
         _register_error_interceptor(matcher, message, should_report_error: false, **match_and_messages)
       end
 
+      def on_exception(matcher = StandardError, &block)
+        raise ArgumentError, "on_exception must be called with a block" unless block_given?
+
+        self._exception_handlers += [CustomErrorHandler.new(matcher:, block:)]
+      end
+
       def default_error = new.internal_context.default_error
 
       # Private helpers
@@ -144,6 +161,18 @@ module Action
       end
 
       delegate :default_error, to: :internal_context
+
+      def _on_exception(exception)
+        handlers = self.class._exception_handlers.select do |this|
+          CustomErrorInterceptor.matches?(matcher: this.matcher, exception:, action: self)
+        end
+
+        handlers.each do |handler|
+          instance_exec(exception, &handler.block)
+        rescue StandardError => e
+          warn("Ignoring #{e.class.name} in on_exception hook: #{e.message}")
+        end
+      end
     end
   end
 end

data/lib/axn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Axn
-  VERSION = "0.1.0-alpha.2.3"
+  VERSION = "0.1.0-alpha.2.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: axn
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.alpha.2.3
+  version: 0.1.0.pre.alpha.2.4
 platform: ruby
 authors:
 - Kali Donovan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-22 00:00:00.000000000 Z
+date: 2025-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel