Add override config layer for forced retry behavior

[kamui]

Summary

Adds Retriable.override and Retriable.reset_override APIs that force retry settings over local call options using a simple hash-based interface.

Retriable.override(tries: 1, base_interval: 0)

Precedence

override > local options > configure defaults

Use case

Test short-circuiting: in test environments, tries: 1 must win even when production code passes explicit local options like Retriable.retriable(tries: 5). Previously, Retriable.configure could only set defaults that local options would override.

API

• Retriable.override(opts) — accepts a hash of config keys to force globally. Only the specified keys are overridden; non-specified keys still respect configure defaults and local options.
• Retriable.reset_override — clears the override.
• Contexts are supported: Retriable.override(contexts: { api: { tries: 1 } })
• Invalid keys raise ArgumentError, consistent with Retriable.retriable.

Example: Rails test setup

# config/initializers/retriable.rb
Retriable.configure do |c|
  c.tries = 3
  c.base_interval = 0.5
end

if Rails.env.test?
  Retriable.override(tries: 1, base_interval: 0, rand_factor: 0)
end

Implementation

The override is stored as a sparse hash delta and merged lazily at each retriable/with_context call using deep_merge. This means:

• Changes to Retriable.configure after override still take effect for non-overridden keys
• The override is not a snapshot — it is a transparent layer

Changes

• lib/retriable.rb — adds override, reset_override, deep_merge, and supporting merge helpers
• spec/retriable_spec.rb — 12 new tests covering override precedence, contexts, edge cases, and validation
• README.md — new Override section, updated Testing section with override examples
• CHANGELOG.md / lib/retriable/version.rb — version and changelog entries

Closes #108.