resilient-rs 0.4.4

A Rust utility library for fault tolerance, including retry strategies, backoff mechanisms, failure handling and much more. 💖 Loved the work? Subscribe to my YouTube channel or consider giving this repository a ⭐ to show your support!

Feature Overview

Notes:

• Supported Contexts: All features are available for both synchronous and asynchronous operations.

Runtime Compatibility

This library is designed to be compatible with multiple Rust async runtimes. The resilient_rs::asynchronous mod works seamlessly with:

• Tokio - Using Tokio's async I/O and runtime
• async-std - Using async-std's lightweight async runtime
• futures - Using the core futures crate with blocking execution

📦 How to Use resilient-rs

Here’s a quick example of how to use the resilient-rs crate in your Rust project.

1️⃣ Add resilient-rs to Your Cargo.toml

Add the following line to your Cargo.toml file:

[dependencies]
resilient-rs = "0.4.4" # Replace with the latest version

OR

cargo add resilient-rs

Synchronous

use std::time::Duration;
use resilient_rs::config::RetryConfig;
use resilient_rs::synchronous::retry;

fn main() {
  let retry_config = RetryConfig::default();
  let result: Result<i32, &str> = retry(|| {
    Err("Temporary failure")
  }, &retry_config);
  assert!(result.is_err());
}

Asynchronous

use tokio::time::Duration;
use reqwest::Client;
use resilient_rs::asynchronous::retry;
use resilient_rs::config::RetryConfig;

async fn fetch_url() -> Result<String, reqwest::Error> {
  let client = Client::new();
  let response = client.get("https://example.com")
          .send()
          .await?;

  if response.status().is_success() {
    response.text().await
  } else {
    Err(reqwest::Error::new(reqwest::StatusCode::from_u16(response.status().as_u16()).unwrap(), "Request failed"))
  }
}

#[tokio::main]
async fn main() {
  let retry_config = RetryConfig::default();

  let result = retry(fetch_url, &retry_config).await;
  match result {
    Ok(output) => println!("Operation succeeded: {}", output),
    Err(err) => println!("Operation failed: {}", err),
  }
}

🚀 Contributing Guidelines

We welcome your contributions! Here's how to get started:

🐛 Issues & 🌟 Features

• Find an issue or planned feature you'd like to work on.
• Comment on the issue (or create one for planned features) and tag me (@semicolon-10) for assignment.
  💡 Tip: Ensure it's not already assigned!
• Once assigned, start working. 🎉

🔧 Submitting Work

1. 🍴 Fork the repo and create a new branch.
2. 🛠️ Make changes and test thoroughly.
3. ✅ Ensure git actions pass before tagging me for review.
4. 📤 Submit a PR with a clear description and link the issue.

🤝 Code of Conduct

• Be respectful and collaborative. 🤗
• Follow coding standards and guidelines. ✅