1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
//! This library provides extensible asynchronous retry behaviours //! for use with the popular [`futures`](https://crates.io/crates/futures) crate //! and the ecosystem of [`tokio`](https://tokio.rs/) libraries. //! //! # Installation //! //! Add this to your `Cargo.toml`: //! //! ```toml //! [dependencies] //! tokio-retry = "0.1" //! ``` //! //! # Examples //! //! ```rust //! extern crate tokio_core; //! extern crate tokio_retry; //! //! use tokio_core::reactor::Core; //! use tokio_retry::Retry; //! use tokio_retry::strategy::{ExponentialBackoff, jitter}; //! //! fn action() -> Result<u64, ()> { //! // do some real-world stuff here... //! Ok(42) //! } //! //! fn main() { //! let mut core = Core::new().unwrap(); //! //! let retry_strategy = ExponentialBackoff::from_millis(10) //! .map(jitter) //! .take(3); //! //! let retry_future = Retry::spawn(core.handle(), retry_strategy, action); //! let retry_result = core.run(retry_future); //! //! assert_eq!(retry_result, Ok(42)); //! } //! ``` extern crate futures; extern crate rand; extern crate tokio_core; extern crate tokio_service; mod action; mod future; pub mod middleware; /// Assorted retry strategies including fixed interval and exponential back-off. pub mod strategy; pub use action::Action; pub use future::{Error, Retry}; pub use middleware::Middleware;