chrono_machines 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 520c4b33c24d8122f82758ed724886bfdd7955b427a98de6432bfd2b85f8355e
-  data.tar.gz: 7f31ccc205a392a0f26f932cdebdd13efb56204137598d38e818768f6116da53
+  metadata.gz: e4195a7a57a7069769ba6b45dec7b2187ffd78be09e03d79c6b744881306423d
+  data.tar.gz: 17d103b281d335cd9b0d2d78590a57f9eb5f5e68eaf3910aa07b51ccfe1a7cb3
 SHA512:
-  metadata.gz: 51dbb600f208195e5c42f6cc8eec21069aa361f1c1056df5c960ea331a4335c1f18fb328fb27748d5535d9477fea99ae20f1a5961b1cd53ced563b336bc96542
-  data.tar.gz: 7a82f044a7fe6e185399021cb09e141a51e0370a468767df79058cf78567fda1ecc96dc0b916de6154d02b828a4b5b4ac803a5a0aa7e78078c147220383c0bfc
+  metadata.gz: 9d8638c3dbdfa33e746beecba8e3e5cfc92a75cce7c315a604d07a5e108188dcff339a03406c66e220a2dcaa8ec28115d9b3047179fdbe214e9ba95b1115f0ce
+  data.tar.gz: 167d0237c2ff6ea4e0958befc179f60b5a518b44ac86106a3409f5a0ae611809b1a43520a928d3a5026cd1389429aeab856f7d15522df3703259767d23100020

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.11.0](https://github.com/seuros/chrono_machines/compare/chrono_machines/v0.10.0...chrono_machines/v0.11.0) (2026-10-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **core:** RetryError::cause() returns &E and into_cause() returns E instead of Option.
+
+### Features
+
+* **core:** RetryError always carries its cause ([e5222a3](https://github.com/seuros/chrono_machines/commit/e5222a3c394974ba86605944f02d820345cbae8e))
+
 ## [0.10.0](https://github.com/seuros/chrono_machines/compare/chrono_machines/v0.9.2...chrono_machines/v0.10.0) (2026-10-11)
 
 

data/README.md

@@ -223,6 +223,8 @@ Anything else raises `ArgumentError` - a broken hook fails loudly instead of sil
 
 ### Scheduling retries without sleeping
 
+See the [Rails integration guide](docs/RAILS_INTEGRATION.md) for Active Job patterns, policy callbacks, and safe retries.
+
 `Executor#next_delay(attempt:, exception: nil)` returns seconds to wait, or `nil` to stop. `attempt: 1` means the initial call has failed; `max_attempts` includes that initial call. It uses the same backoff, jitter, exception rules, and `delay_from` hints as `call`, without executing work, sleeping, or running lifecycle callbacks. The caller owns the attempt count and scheduling. Without an exception, `delay_from` and exception filtering are skipped.
 
 For Active Job's `retry_on`, keep the attempt limit in sync with the policy:

data/ext/chrono_machines_native/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "chrono-machines"
-version = "0.8.1"
+version = "0.9.0"
 edition.workspace = true
 rust-version.workspace = true
 authors = ["Abdelkader Boudih <terminale@gmail.com>"]

data/ext/chrono_machines_native/core/src/retry.rs

@@ -51,13 +51,7 @@ fn finalize_failure<E>(
     cumulative_delay_ms: u64,
     error: E,
 ) -> RetryError<E> {
-    let retry_error = RetryError::new(
-        kind,
-        attempt,
-        max_attempts,
-        cumulative_delay_ms,
-        Some(error),
-    );
+    let retry_error = RetryError::new(kind, attempt, max_attempts, cumulative_delay_ms, error);
     if let Some(callback) = on_failure {
         callback(&retry_error);
     }
@@ -99,7 +93,7 @@ pub struct RetryError<E> {
     attempts: u8,
     max_attempts: u8,
     cumulative_delay_ms: u64,
-    cause: Option<E>,
+    cause: E,
 }
 
 impl<E> RetryError<E> {
@@ -108,7 +102,7 @@ impl<E> RetryError<E> {
         attempts: u8,
         max_attempts: u8,
         cumulative_delay_ms: u64,
-        cause: Option<E>,
+        cause: E,
     ) -> Self {
         Self {
             kind,
@@ -119,13 +113,13 @@ impl<E> RetryError<E> {
         }
     }
 
-    /// Retrieve the underlying cause when available.
-    pub const fn cause(&self) -> Option<&E> {
-        self.cause.as_ref()
+    /// The error from the final attempt.
+    pub const fn cause(&self) -> &E {
+        &self.cause
     }
 
-    /// Consume the error and return the underlying cause when available.
-    pub fn into_cause(self) -> Option<E> {
+    /// Consume the error and return the error from the final attempt.
+    pub fn into_cause(self) -> E {
         self.cause
     }
 
@@ -175,13 +169,11 @@ where
             }
         }
 
-        write!(f, " (cumulative delay {}ms)", self.cumulative_delay_ms)?;
-
-        if let Some(cause) = self.cause.as_ref() {
-            write!(f, ": {cause}")?;
-        }
-
-        Ok(())
+        write!(
+            f,
+            " (cumulative delay {}ms): {}",
+            self.cumulative_delay_ms, self.cause
+        )
     }
 }
 

data/lib/chrono_machines/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chrono_machines
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Abdelkader Boudih