chrono_machines 0.5.2-aarch64-linux → 0.8.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68b631929b511e3dbf0c4b56892fee0f06a61cc58725754e1bff530a1322f5c4
-  data.tar.gz: ee7cd1668c92bec178c0e055a51f9df65f104dd2ed1aa2ea929442ec85629f5a
+  metadata.gz: f7ca19a090aa72fe3328def5fb7606623759f52954f5008e4ce8057010553ccb
+  data.tar.gz: b3495731fe352c6a6f7b87e7c91180c820cb15ccdab6fb735d798d2f8e2b628c
 SHA512:
-  metadata.gz: fb0e387bbdab562206841981d10286118d8f7eedf81beaaf6aa8778de0d8b57d5d086e05addaf416655ec44da046d0e6810947d3a9c5b388c494c4e49f05b7a1
-  data.tar.gz: 5711529c48fc6be1510ac756051cb149b636cdda4fddd002d7d56168e869626188217c31cdac8967d8b200b01aa492f525779fdf3c159d61f0235a2d7d498cb5
+  metadata.gz: a82ecf502472e225de23f62bb9d71a6234bd9bed1be9167a2800e1ba04c6abf9027f7f6eda8d97fcabab44bb8f0e8bb15accd49aa132a0fa9b187c2dceb4c714
+  data.tar.gz: 412154adcbca21fe7e3c67be8fdac662438320e9505c4c8dd5fd3f4ee41407ed4aaeed30db2d6ceaaf41da54abb014fdb29e13b454df82f8008c57a2a23de418

data/CHANGELOG.md

@@ -1,5 +1,77 @@
 ## [Unreleased]
 
+## [0.8.0](https://github.com/seuros/chrono_machines/compare/chrono_machines/v0.5.0...chrono_machines/v0.8.0) (2026-09-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21))
+
+### Features
+
+* **core:** delay_from - server-hinted retry delays (HTTP Retry-After)  ([#25](https://github.com/seuros/chrono_machines/issues/25)) ([2dcf987](https://github.com/seuros/chrono_machines/commit/2dcf9871939b70c053144e9fc296914a3b6105e5))
+* **core:** re-export rand so BackoffStrategy is implementable downstream ([dc1cf49](https://github.com/seuros/chrono_machines/commit/dc1cf494df0124032bec6aee6e4f6a33e43abbfb))
+* fix release ([ad40d8f](https://github.com/seuros/chrono_machines/commit/ad40d8f5b6629e49ba2d5f0cb7f213a1cc1e30c7))
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21)) ([766f207](https://github.com/seuros/chrono_machines/commit/766f20799bcc0c36f7ca6a904fadff227549fee7))
+
+
+### Bug Fixes
+
+* ignore native_speedup.rb in Zeitwerk loader ([#19](https://github.com/seuros/chrono_machines/issues/19)) ([491cc2d](https://github.com/seuros/chrono_machines/commit/491cc2d3f88786cf6d0c6af68dba7d2511fa3f36))
+* package workspace Cargo manifest so source builds work ([#17](https://github.com/seuros/chrono_machines/issues/17)) ([ac0ddad](https://github.com/seuros/chrono_machines/commit/ac0ddad15d26528771825240a05ed8c84fb61520))
+* trigger release ([02184d5](https://github.com/seuros/chrono_machines/commit/02184d51f6831f53ae6142ea5092710d456363d5))
+
+## [0.5.0](https://github.com/seuros/chrono_machines/compare/chrono_machines/v0.5.0...chrono_machines/v0.5.0) (2026-09-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21))
+
+### Features
+
+* **core:** delay_from - server-hinted retry delays (HTTP Retry-After)  ([#25](https://github.com/seuros/chrono_machines/issues/25)) ([2dcf987](https://github.com/seuros/chrono_machines/commit/2dcf9871939b70c053144e9fc296914a3b6105e5))
+* **core:** re-export rand so BackoffStrategy is implementable downstream ([dc1cf49](https://github.com/seuros/chrono_machines/commit/dc1cf494df0124032bec6aee6e4f6a33e43abbfb))
+* fix release ([ad40d8f](https://github.com/seuros/chrono_machines/commit/ad40d8f5b6629e49ba2d5f0cb7f213a1cc1e30c7))
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21)) ([766f207](https://github.com/seuros/chrono_machines/commit/766f20799bcc0c36f7ca6a904fadff227549fee7))
+
+
+### Bug Fixes
+
+* ignore native_speedup.rb in Zeitwerk loader ([#19](https://github.com/seuros/chrono_machines/issues/19)) ([491cc2d](https://github.com/seuros/chrono_machines/commit/491cc2d3f88786cf6d0c6af68dba7d2511fa3f36))
+* package workspace Cargo manifest so source builds work ([#17](https://github.com/seuros/chrono_machines/issues/17)) ([ac0ddad](https://github.com/seuros/chrono_machines/commit/ac0ddad15d26528771825240a05ed8c84fb61520))
+
+## [0.5.0](https://github.com/seuros/chrono_machines/compare/chrono_machines/v0.5.0...chrono_machines/v0.5.0) (2026-08-23)
+
+
+### ⚠ BREAKING CHANGES
+
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21))
+
+### Features
+
+* **core:** re-export rand so BackoffStrategy is implementable downstream ([dc1cf49](https://github.com/seuros/chrono_machines/commit/dc1cf494df0124032bec6aee6e4f6a33e43abbfb))
+* fix release ([ad40d8f](https://github.com/seuros/chrono_machines/commit/ad40d8f5b6629e49ba2d5f0cb7f213a1cc1e30c7))
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21)) ([766f207](https://github.com/seuros/chrono_machines/commit/766f20799bcc0c36f7ca6a904fadff227549fee7))
+
+
+### Bug Fixes
+
+* ignore native_speedup.rb in Zeitwerk loader ([#19](https://github.com/seuros/chrono_machines/issues/19)) ([491cc2d](https://github.com/seuros/chrono_machines/commit/491cc2d3f88786cf6d0c6af68dba7d2511fa3f36))
+* package workspace Cargo manifest so source builds work ([#17](https://github.com/seuros/chrono_machines/issues/17)) ([ac0ddad](https://github.com/seuros/chrono_machines/commit/ac0ddad15d26528771825240a05ed8c84fb61520))
+
+## [0.5.0](https://github.com/seuros/chrono_machines/compare/chrono_machines/v0.5.2...chrono_machines/v0.5.0) (2026-08-23)
+
+
+### ⚠ BREAKING CHANGES
+
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21))
+
+### Features
+
+* fix release ([ad40d8f](https://github.com/seuros/chrono_machines/commit/ad40d8f5b6629e49ba2d5f0cb7f213a1cc1e30c7))
+* **native:** add async retry driver ([#21](https://github.com/seuros/chrono_machines/issues/21)) ([766f207](https://github.com/seuros/chrono_machines/commit/766f20799bcc0c36f7ca6a904fadff227549fee7))
+
 ## [0.5.2](https://github.com/seuros/chrono_machines/compare/chrono_machines/v0.5.1...chrono_machines/v0.5.2) (2026-08-07)
 
 

data/README.md

@@ -195,6 +195,32 @@ ChronoMachines.retry(
 end
 ```
 
+### Server-Hinted Delays (`delay_from`)
+
+When the server tells you when to come back - HTTP 429 with `Retry-After` - guessing with exponential backoff is rude. `delay_from` lets the exception dictate the next delay:
+
+```ruby
+ChronoMachines.retry(
+  max_attempts: 5,
+  max_delay: 30,
+  retryable_exceptions: [MyClient::RateLimitError],
+  delay_from: ->(exception:, attempt:) {
+    exception.respond_to?(:retry_after) ? exception.retry_after : nil
+  }
+) do
+  call_rate_limited_api
+end
+```
+
+The hook's return value controls the retry:
+
+- `nil` - no hint; fall back to the policy's backoff strategy
+- `Numeric` - sleep exactly that many seconds (no jitter: the server picked the time, honor it)
+- a `Numeric` **beyond `max_delay`** - halt: the server asked for more patience than this policy allows, so the original exception propagates and the caller decides (background job, `Retry-After` response header, ...)
+- `:halt` or `false` - stop retrying immediately, propagate the original exception
+
+Anything else raises `ArgumentError` - a broken hook fails loudly instead of silently mangling your retry cadence.
+
 ## The Science of Temporal Jitter
 
 ChronoMachines implements **full jitter** exponential backoff:

data/lib/chrono_machines/configuration.rb

@@ -18,6 +18,7 @@ module ChronoMachines
           max_delay: 10,   # seconds
           jitter_factor: 1.0, # 1.0 = full jitter (recommended), 0.0 = no jitter
           retryable_exceptions: [StandardError],
+          delay_from: nil, # Optional delay override from the exception (e.g. HTTP Retry-After)
           on_failure: nil, # Fallback block when all retries are exhausted
           on_retry: nil,   # Callback block when a retry occurs
           on_success: nil  # Callback block when operation succeeds

data/lib/chrono_machines/executor.rb

@@ -16,6 +16,7 @@ module ChronoMachines
       @max_delay = policy_options[:max_delay]
       @jitter_factor = policy_options[:jitter_factor]
       @retryable_exceptions = policy_options[:retryable_exceptions]
+      @delay_from = policy_options[:delay_from]
       @on_failure = policy_options[:on_failure]
       @on_retry = policy_options[:on_retry]
       @on_success = policy_options[:on_success]
@@ -47,7 +48,7 @@ module ChronoMachines
         end
 
         # Calculate delay
-        delay = calculate_delay(attempts)
+        delay = resolve_delay(e, attempts)
 
         # Call retry callback if defined
         @on_retry&.call(exception: e, attempt: attempts, next_delay: delay)
@@ -60,6 +61,29 @@ module ChronoMachines
 
     private
 
+    # delay_from(exception:, attempt:) overrides the backoff: nil -> backoff,
+    # Numeric -> verbatim (beyond max_delay: halt), :halt/false -> re-raise.
+    def resolve_delay(exception, attempts)
+      return calculate_delay(attempts) unless @delay_from
+
+      hint = @delay_from.call(exception: exception, attempt: attempts)
+      case hint
+      when nil
+        calculate_delay(attempts)
+      when Numeric
+        if @max_delay && hint > @max_delay
+          handle_final_failure(exception, attempts)
+          raise exception
+        end
+        hint
+      when :halt, false
+        handle_final_failure(exception, attempts)
+        raise exception
+      else
+        raise ArgumentError, "delay_from must return nil, a Numeric, :halt or false; got #{hint.inspect}"
+      end
+    end
+
     # Pure Ruby implementation of delay calculation (exponential backoff)
     def ruby_calculate_delay_exponential(attempts)
       base_exponential_delay = [@base_delay * (@multiplier**(attempts - 1)), @max_delay].min

data/lib/chrono_machines/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ChronoMachines
-  VERSION = '0.5.2'
+  VERSION = '0.8.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chrono_machines
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.8.0
 platform: aarch64-linux
 authors:
 - Abdelkader Boudih
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-07 00:00:00.000000000 Z
+date: 2026-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk