LinKit.Resilience
1.0.0
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package LinKit.Resilience --version 1.0.0
NuGet\Install-Package LinKit.Resilience -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="LinKit.Resilience" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="LinKit.Resilience" Version="1.0.0" />
<PackageReference Include="LinKit.Resilience" />
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 LinKit.Resilience --version 1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: LinKit.Resilience, 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 LinKit.Resilience@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=LinKit.Resilience&version=1.0.0
#tool nuget:?package=LinKit.Resilience&version=1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
LinKit.Resilience
LinKit.Resilience delivers high-performance, Zero-Allocation, and Native AOT compatible resilience primitives (Circuit Breaker, Retry, Timeout) for LinKit.
🚀 Key Features
- Zero Reflection & Native AOT Ready: No reflection overhead, dynamic code generation, or heavy external dependencies.
- Circuit Breaker Pattern: State-machine based circuit breaker (
Closed,Open,HalfOpen) with automatic recovery probing and failure thresholds. - Concurrent & Thread-Safe: Lock-optimized concurrent state tracking via
CircuitBreakerRegistry. - Seamless CQRS Integration: Designed to pair with LinKit Pipeline Behaviors for transparent fault tolerance.
📦 Installation
dotnet add package LinKit.Resilience
🛠️ Usage Guide
1. Register Resilience Services in Program.cs
using LinKit.Resilience;
var builder = WebApplication.CreateBuilder(args);
// Register resilience primitives
builder.Services.AddLinKitResilience();
2. Guard Critical Code with Circuit Breaker
using LinKit.Resilience;
public class PaymentGatewayService : IPaymentGateway
{
private const string BreakerKey = "PaymentGateway";
public async Task<bool> ChargeAsync(decimal amount, CancellationToken ct)
{
var breaker = CircuitBreakerRegistry.GetOrCreate(BreakerKey);
// Check if circuit breaker allows execution (trip after 5 failures, cool off for 30s)
if (!breaker.CanExecute(durationSeconds: 30))
{
throw new InvalidOperationException("Payment Gateway circuit is OPEN. Please try again later.");
}
try
{
var success = await CallPaymentApiAsync(amount, ct);
breaker.OnSuccess();
return success;
}
catch (Exception)
{
breaker.OnFailure(threshold: 5);
throw;
}
}
}
📄 License
Licensed under the MIT License.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. 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 is compatible. 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.
-
net10.0
- LinKit.Core (>= 2.4.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
-
net8.0
- LinKit.Core (>= 2.4.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
-
net9.0
- LinKit.Core (>= 2.4.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.