RetryIt 1.0.0

dotnet add package RetryIt --version 1.0.0
                    
NuGet\Install-Package RetryIt -Version 1.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="RetryIt" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="RetryIt" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="RetryIt" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add RetryIt --version 1.0.0
                    
#r "nuget: RetryIt, 1.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package RetryIt@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=RetryIt&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=RetryIt&version=1.0.0
                    
Install as a Cake Tool

RetryIt

A lightweight, dependency-free retry helper for .NET applications.

RetryIt makes it easy to retry async operations with support for exponential backoff, exception filtering, cancellation tokens, and retry callbacks — all in a minimal API.


✨ Features

  • ✅ Async retry support
  • ✅ Return value support (Task<T>)
  • ✅ Exponential backoff
  • ✅ Exception filtering
  • ✅ Retry callback (logging hook)
  • ✅ CancellationToken support
  • ✅ Zero dependencies
  • ✅ Production-ready

📦 Installation

Install via NuGet:

dotnet add package RetryIt

Or via Package Manager:

Install-Package RetryIt

🚀 Quick Start

Basic Usage

using RetryIt;

await Retry.ExecuteAsync(async () =>
{
    await CallApiAsync();
});

🔁 Retry With Options

await Retry.ExecuteAsync(
    action: async () => await CallApiAsync(),
    retries: 3,
    delayMilliseconds: 500,
    useExponentialBackoff: true
);

🎯 Retry With Return Value

var result = await Retry.ExecuteAsync(async () =>
{
    return await GetDataAsync();
});

🛡 Retry Specific Exceptions Only

await Retry.ExecuteAsync(
    action: async () => await CallApiAsync(),
    retries: 5,
    shouldRetry: ex => ex is HttpRequestException
);

📊 Logging Retries

await Retry.ExecuteAsync(
    action: async () => await CallApiAsync(),
    retries: 3,
    onRetry: (attempt, exception) =>
    {
        Console.WriteLine($"Retry {attempt}: {exception.Message}");
    }
);

🧵 Cancellation Support

var cts = new CancellationTokenSource();

await Retry.ExecuteAsync(
    action: async () => await CallApiAsync(),
    cancellationToken: cts.Token
);

⚙ Default Behavior

Option Default
Retries 3
Delay 500 ms
Exponential Backoff Disabled
Exception Filter Retry all exceptions

🧠 When To Use RetryIt

RetryIt is ideal for:

  • HTTP calls
  • Database connections
  • External APIs
  • Transient network failures
  • Background services
  • Cloud-based operations

🎯 Why RetryIt?

Unlike large resilience libraries, RetryIt focuses on:

  • Simplicity
  • Small footprint
  • No external dependencies
  • Clean, intuitive API

If you need a minimal retry solution without heavy frameworks, RetryIt is for you.


📄 License

MIT License


Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net9.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 60 2/11/2026