standard_circuit 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c26b42239426b6e97f01c017a4dead949a827d1f4d3e0cd991493c5292d127a
-  data.tar.gz: 2689f5e66f85ea012dd3d84f2a17fdf9700fa7938c862ba35a2f5d4f651f4951
+  metadata.gz: 195e01d912e93d7bf158cafd091aab7ab27571994e9d4c2953d0a39b76c92d71
+  data.tar.gz: 880f2b881ada6a92660c8c26c1c2b49abf2ea283411606a7131c9cf1af8bd75f
 SHA512:
-  metadata.gz: fa4ac99fa63f03cd2790084476189a8d0ecc6d3d993b4ceaf5c1aa7d5a06a2fe2b5dcb64f8a5165b230c7a700ae30e2a7385c68301e7e0c7937f64f5216da6a0
-  data.tar.gz: 0addb3ca191eeb7cf62fe15a297c8997b62e716ca5bf48f9eea1ffbd5493ad429edf994df0b91bf62c89a035e15062ec3b0445460a4304c7a4569a40194ea31c
+  metadata.gz: 4706259801d563a2b60183691ad7c4ae935face858318e358d4e3bd5459c4b2eee097da52c8cb4748c7726883455f96a1416a23cde8b0123d172207d2f64b373
+  data.tar.gz: 05f1578d83f4bdbc34d310350570322bf4cd357d24d50e07874bed2e34019d33bb3cf0f396e49cf9a598797700aef34d3182b98c730d4a25e737f3f083ad6e80

data/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-10-22
+
+### Fixed
+
+- **Zero-argument fallback lambdas no longer crash when the circuit opens.**
+  A fallback is called with the error (or `nil` when forced open), so a
+  `fallback: -> { ... }` raised `ArgumentError` at exactly the moment the
+  circuit opened, the case the fallback exists for. Such lambdas are now called
+  without the argument. Fallbacks that take the error, and procs, are
+  unchanged. Zero-arity `Method` fallbacks are accepted the same way.
+
+### Changed
+
+- **Requires Rails 8.1** (`railties`, `actionmailer`, `actionpack` `>= 8.1`,
+  was `>= 8.0`). Every consumer app runs 8.1; 8.0 was never exercised in CI.
+
 ## [0.5.0] - 2026-09-24
 
 **Breaking.** Removes everything 0.4 deprecated. Behaviour of everything that remains is unchanged, including 0.4.2's `mailer_retry` (exhaustion reports, then re-raises so the job dead-letters).

data/README.md

@@ -54,8 +54,17 @@ end
 StandardCircuit.run(:stripe) do
   Stripe::PaymentIntent.create(amount:, currency:)
 end
+
+# with a fallback, returned instead of raising while the circuit is open
+StandardCircuit.run(:analytics, fallback: -> { nil }) do
+  Analytics.track(event)
+end
 ```
 
+A fallback may take the error (`->(error) { ... }`: the error the block raised,
+or `nil` once the circuit is open, since the block then never runs) or take
+nothing (`-> { ... }`, or a zero-arity `method(...)`); all are called correctly.
+
 ## Error taxonomies
 
 `tracked_errors` decide what counts toward tripping a circuit; `skipped_errors` are re-raised without counting (and win over `tracked_errors` when a class matches both). `StandardCircuit::ErrorTaxonomies::<Adapter>.tracked` combines `NetworkErrors.defaults` with the adapter's server-side errors for `Stripe`, `Smtp`, `Aws`, `Faraday`, and `Postmark`; `StandardCircuit::AdapterErrors::<Adapter>.caller_errors` lists the adapter's caller-side (4xx-style) errors.

data/lib/standard_circuit/runner.rb

@@ -12,6 +12,7 @@ module StandardCircuit
     end
 
     def run(name, fallback: nil, &block)
+      fallback = accept_error_argument(fallback)
       forced = @forced_states[name.to_sym]
       return run_forced_open(name, fallback) if forced == :open
       return yield if forced == :closed
@@ -73,6 +74,20 @@ module StandardCircuit
 
     private
 
+    # A fallback is called with one argument: the error, or nil when the
+    # circuit is forced open. A zero-argument lambda (`-> { ... }`, the
+    # natural way to write "return this instead") raises ArgumentError on that
+    # call, so the fallback would crash at exactly the moment the circuit
+    # opens. Accept it, and a zero-arity Method (`fallback: method(:degraded)`),
+    # by calling it without the argument. Procs, and callables that take the
+    # error, are passed through unchanged.
+    def accept_error_argument(fallback)
+      strict = fallback.is_a?(Method) || (fallback.is_a?(Proc) && fallback.lambda?)
+      return fallback unless strict && fallback.arity.zero?
+
+      ->(_error) { fallback.call }
+    end
+
     def execute(name, fallback, &block)
       started_at = monotonic_now
       light = light_for(name)

data/lib/standard_circuit/version.rb

@@ -1,3 +1,3 @@
 module StandardCircuit
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: standard_circuit
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Jaryl Sim
@@ -57,42 +57,42 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
 - !ruby/object:Gem::Dependency
   name: actionmailer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
 - !ruby/object:Gem::Dependency
   name: brakeman
   requirement: !ruby/object:Gem::Requirement
@@ -201,7 +201,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Circuit breaker primitives for Rails apps, built on stoplight.
 test_files: []