Releases | Ecosyste.ms: Ruby

retry_if, on_retry, and on_give_up are now validated to be callable (respond to #call) or falsy. A non-callable truthy value raises ArgumentError at configuration time instead of a later NoMethodError on a retry path. (#140)

Add RBS type signatures for the public API (Retriable.configure, config, retriable, with_override, with_context, and Retriable::Config) and validate them in CI with rbs validate. (#142)
Enforce a minimum test coverage floor and add a bundler-audit dependency audit job to CI. (#143)
Remove an unused CC_TEST_REPORTER_ID from the CI workflow. (#141)

- Ruby
Published by kamui 17 days ago

A per-call or with_context tries: now clears an inherited intervals: from global config or a context, matching the documented precedence. Previously Retriable.retriable(tries: 1) was silently ignored when intervals was configured, running intervals.size + 1 times. Passing both intervals: and tries: in the same call still lets intervals: win.

- Ruby
Published by kamui 17 days ago

Major release with breaking changes. Please read carefully before upgrading.

Removed timeout: from Retriable.retriable, Retriable.configure, and Retriable.with_override. Prefer library-native timeout settings, or wrap the retried block in Timeout.timeout(...) directly if you still need that behavior.
Minimum Ruby version is now 3.2. Ruby 2.x, 3.0, and 3.1 users should stay on the 3.8.x line (~> 3.8).

Added on_give_up, a callback that runs when Retriable stops retrying after a rescued retriable exception.
Added support for passing a Set of Exception classes as the on: option.

Switched Retriable.retriable, Retriable.with_context, and the Kernel extension methods to Ruby 3.1+ anonymous block forwarding.

See the README migration section for replacement patterns and examples.

- Ruby
Published by kamui 20 days ago

3.8.0

Deprecated the timeout: option ahead of its removal in Retriable 4.0. Non-nil timeout values supplied through Retriable.configure, Retriable.retriable(...), or Retriable.with_override(...) now emit a deprecation warning while keeping the existing runtime behavior unchanged. On Ruby 2.7+ the warning is emitted via Kernel.warn(..., category: :deprecated), so callers can silence it through the standard Ruby controls (Warning[:deprecated] = false, ruby -W:no-deprecated, or a custom Warning.warn). To keep the notice from drowning busy applications, it is emitted at most once per process; suppression via Warning[:deprecated] leaves the warner armed for the next call that re-enables the category. Prefer library-native timeout settings, or wrap the retried block in Timeout.timeout(...) directly if you still need that behavior. See the README migration guidance for details.

- Ruby
Published by kamui 20 days ago

Feature: Opt-in unbounded retries via tries: Float::INFINITY. Requires a finite max_elapsed_time as a safety bound and is incompatible with custom intervals:. Both invalid configurations raise ArgumentError from Config#validate!.

- Ruby
Published by kamui 20 days ago

Fix: Validate the on: option before retrying. Previously, passing a non-Exception value such as Object, Kernel, or a plain Module (which appear in every Exception's ancestor chain) would silently retry process-critical exceptions like SystemExit and Interrupt. The on: option now requires an Exception subclass, an array of them, or a hash whose keys are such classes and whose values are nil, a Regexp, or an array of Regexps. Invalid shapes raise ArgumentError before the block runs.
Fix: Validate with_override(contexts:) shape before applying overrides. contexts may be nil or a hash, and each per-context override must be a hash.
Docs: Document that on_retry: false disables a callback set in Retriable.configure for a single call.

- Ruby
Published by kamui 20 days ago