LiteRetry 0.0.3

LiteRetry.Core

LiteRetry.Core is a lightweight, fluent and flexible retry utility for .NET.
It helps developers add retry logic to any asynchronous or synchronous operation with minimal setup and maximum control.

✨ Features

• ✅ Simple and fluent API
• 🔁 Automatic retries with configurable limits
• ⏱️ Support for fixed or exponential backoff
• 🎯 Conditional retry filtering
• 📣 Hook for onRetry callback
• ❌ Cancellation support via CancellationToken
• 📦 RetryResult<T> with metadata (attempts, elapsed time)
• 🧠 RetryContext for diagnostics
• ❗ Custom RetryFailedException

📦 Installation

You can install via NuGet:

dotnet add package LiteRetry

Or via the NuGet Package Manager:

Install-Package LiteRetry

🚀 Quick Example

using LiteRetry.Core.Retry.Fluent;

var result = await RetryBuilder<string>
    .Create()
    .WithRetries(3)
    .WithDelay(500)
    .WithBackoff()
    .Filter(ex => ex is TimeoutException)
    .OnRetry(ctx => 
    {
        Console.WriteLine($"Retry {ctx.Attempt} after {ctx.Delay.TotalMilliseconds}ms");
        return Task.CompletedTask;
    })
    .RunAsync(async () => 
    {
        // Your operation
        return await GetDataFromRemote();
    });

Console.WriteLine($"Result: {result.Value} in {result.Attempts} attempts");

🔧 Basic Usage

If you prefer a static API:

var result = await RetryExecutor.ExecuteAsync(
    action: async () => await SomeOperation(),
    options: new RetryOptions
    {
        Retries = 3,
        DelayMilliseconds = 500,
        Backoff = true,
        ShouldRetry = ex => ex is HttpRequestException
    }
);

🧱 API Components

• RetryExecutor – Static retry logic handler
• RetryBuilder<T> – Fluent builder for retry configuration
• RetryContext – Info about the retry state per attempt
• RetryResult<T> – Final result including metadata
• RetryFailedException – Exception thrown after final failure

📄 License

This project is licensed under the MIT License.

🙌 Author

Created by Javier Angosto Barjollo