retry

Improvements:

• Various constructors are now annotated with #[must_use].
• Make simple functions available in const contexts.

Bug fixes:

• The jitter function modifies the input Duration atomically rather than to seconds and nanoseconds separately, resulting in less predictable jitter.

New features:

• New constructors, retry::delay::Range::{try_from_millis_exclusive, try_from_millis_inclusive}, offering non-panicking variants of the existing constructors.

Dependencies:

• Updated from rand 0.8 to 0.9.

Breaking changes:

• retry::Error is now a struct with public fields instead of an enum with a useless Internal variant. (See #38 and #42.)
• retry::delay::Exponential::from_millis now uses an exponential backoff factor of 2.0 instead of whatever the initial delay is. If you want the old behavior, use retry::delay::Exponential::from_millis_with_base_factor instead. (See #31.)

Improvements:

• The crate's documentation now uses Intra-rustdoc links for convenient navigation.

Fixes:

• Fixed a broken external link in the documentation.

Improvements:

• Bump the version of rand due to RUSTSEC-2021-0023. (#43)

New features:

• retry::OperationResult now has predicate methods to check for a specific variant:
  • is_ok
  • is_retry
  • is_err

Improvements:

• Removed async code that is not used. (#36)

Bug fixes:

• retry::Error now correctly displays the error it wraps when printed. (#35)

Improvements:

• The features of the crate involving randomness are now behind the "random" Cargo feature. This feature is enabled for backwards compatibility, but can now be turned off via Cargo.toml to avoid installing the rand crates if they're not needed.

New features:

• retry::delay::Exponential::from_millis_with_factor is added to support a configurable multiplication factor for exponential delays.

retry's API is now stable for the 1.0 series.

New features:

• Added a retry_with_index function that works like retry, but passes the number of the current try (as u64) as an argument to the supplied closure.

Improvements:

• retry::delay::{Exponential, Fibonacci} now implement From<std::time::Duration>.
• retry::delay::Range now implements From<std::ops::Range<std::time::Duration>> and From<std::ops::RangeInclusive<std::time::Duration>>.

Improvements:

• The Fixed delay now implements From<Duration>.