LiteRetry 0.0.4

LiteRetry

LiteRetry is a lightweight, fluent, and extensible retry utility for .NET.
It helps developers eliminate repetitive try/catch blocks and build resilient code with ease.

🚀 Installation

dotnet add package LiteRetry

✨ Features

• Configurable automatic retries
• Delay strategies: Fixed, Exponential, and Exponential with Jitter
• Exception filtering (by type or predicate)
• Retry hook (onRetryAsync) for logging, metrics, etc.
• CancellationToken support
• Fluent API via RetryBuilder
• Fully unit tested and reliable

🛠️ Basic Usage

var result = await RetryExecutor.ExecuteAsync<string>(
    operation: async ct =>
    {
        // Logic that might fail
        return await Task.FromResult("Hello World");
    }
);

⚙️ Advanced Usage

var result = await RetryExecutor.ExecuteAsync<string>(
    operation: async ct =>
    {
        // Simulated failure
        throw new HttpRequestException("503");
    },
    maxAttempts: 5,
    baseDelay: TimeSpan.FromMilliseconds(200),
    delayStrategy: DelayStrategy.ExponentialWithJitter,
    shouldRetry: ex => ex is HttpRequestException,
    onRetryAsync: ctx =>
    {
        Console.WriteLine($"Retry #{ctx.Attempt} after {ctx.Delay.TotalMilliseconds}ms");
        return Task.CompletedTask;
    }
);

🧪 Fluent API with RetryBuilder

await RetryBuilder.Configure()
    .WithMaxAttempts(5)
    .WithBaseDelay(TimeSpan.FromMilliseconds(300))
    .WithStrategy(DelayStrategy.Exponential)
    .WithFilterByType<HttpRequestException>()
    .OnRetryAsync(ctx =>
    {
        Console.WriteLine($"Retry {ctx.Attempt}: {ctx.Exception.Message}");
        return Task.CompletedTask;
    })
    .RunAsync(async ct =>
    {
        // Operation that may throw
        throw new HttpRequestException("Timeout");
    });

📦 Class Overview

• RetryExecutor → Static class with core retry logic
• RetryBuilder → Fluent API for easy configuration
• RetryContext → Info for each retry attempt
• RetryResult<T> → Contains result, success flag, attempts, timing
• RetryFailedException → Thrown after all retries fail
• DelayStrategy → Enum with all supported strategies

🧾 License

MIT — free for personal and commercial use.

🙌 Author

Created by Javier Angosto Barjollo