More...

Crate retry provides utilities for retrying operations that can fail

retry

Crate retry provides utilities for retrying operations that can fail.

Documentation

retry has comprehensive documentation available on docs.rs.

Legal

retry is released under the MIT license. See LICENSE.

Issues

Collection of the latest Issues

IGI-111

async support

I just came across this library and I definitely would want to use it but I can't because it doesn't support futures.

I know there are a couple of implementations as PRs already but I'm opening this to push for a decision now that the async ecosystem is probably mature enough.

dtolnay

effort/easy

Delete Error::Internal

It appears that nothing in this crate ever constructs the Error::Internal variant.

https://github.com/jimmycuadra/retry/blob/faf13cae977c39b817feeb54d9b3787dfc9f72ab/src/lib.rs#L207-L208

It's not clear what its purpose is. If an "error in the internal logic" refers to the possibility of a bug in the logic of retry, the appropriate way to report that is via panic, not an error variant. Panics indicate bugs in the program; errors indicate expected runtime failure modes in a correct program.

mmstick

status/accepted

Find the latest versions by id

1.3.1 - Feb 02, 2022

Improvements:

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

Source Code(tar.gz)

Source Code(zip)

1.3.0 - Aug 14, 2021

New features:

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

Source Code(tar.gz)

Source Code(zip)

1.2.1 - Apr 24, 2021

Improvements:

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

Bug fixes:

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

Source Code(tar.gz)

Source Code(zip)

1.2.0 - Dec 09, 2020

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.

Source Code(tar.gz)

Source Code(zip)

1.1.0 - Aug 15, 2020

New features:

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

Source Code(tar.gz)

Source Code(zip)

1.0.0 - Jan 12, 2020

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>>.

Source Code(tar.gz)

Source Code(zip)

0.5.1 - Jun 10, 2019

Improvements:

The Fixed delay now implements From<Duration>.

Source Code(tar.gz)

Source Code(zip)

0.5.0 - May 25, 2019

Breaking changes:

The library has been significantly redesigned and now offers a simpler and more flexible interface. See the documentation for details.

New features:

A new OperationResult type allows for returning an error immediately, halting all retry behavior.
Range-based delays can now be constructed with exclusive or inclusive ranges.
A fibonacci delay is now provided.
A function is now provided to introduce random jitter into a sequence of delays.

Source Code(tar.gz)

Source Code(zip)

v0.4.0 - Apr 02, 2016

Breaking changes:

Functions that took u32 values as arguments now take u64 values instead.

New features:

A new convenience function, retry_exponentially, is similar to the retry function but uses an f64 wait value as the multiplier for exponential backoff.
New methods for the Retry builder type:
- timeout for setting the maximum amount of time before failure.
- wait_between for adding some random jitter to the amount of delay between each try.
- wait_exponentially for waiting exponentially longer with each try.

Improvements:

Uses of the deprecated std::thread::sleep_ms have been replaced with std::thread::sleep.

Source Code(tar.gz)

Source Code(zip)

v0.3.0 - Apr 14, 2015

Added: Retry type for incrementally building a retryable operation. Currently, this allows for retrying an operation infinitely. Soon it will allow for more customizations of behavior.

Source Code(tar.gz)

Source Code(zip)