pkg
arnelirobles/Caromv1.1.0
.NET Std2.0
Carom: Physics-based, zero-dependency resilience library for .NET. Enforces decorrelated jitter by default to prevent Thundering Herd issues. Includes retry with exponential backoff and timeout support. Lean, fast, and safe.
Get Started
$ dotnet add package CaromReadme
Carom 🎱
A lean, fast, and safe resilience library for .NET
Carom is a zero-dependency resilience library that enforces best practices by default. Named after the billiards shot where the ball bounces before reaching its target, Carom helps your code gracefully handle failures.
🎯 Why Carom?
- Zero Dependencies (core packages)
- Minimal Allocations (<100 bytes on hot path)
- Safe by Default (mandatory decorrelated jitter)
- Tiny Footprint (13KB core, 20KB extensions)
- Fully Composable (all patterns work together)
📦 Packages
| Package | Version | Size | Purpose |
|---|---|---|---|
| Carom | v1.3.0 | 13KB | Core retry + timeout |
| Carom.Extensions | v1.4.0 | 20KB | Circuit Breaker, Fallback, Bulkhead, Rate Limiting |
| Carom.Http | v1.0.0 | 11KB | HTTP integration |
| Carom.AspNetCore | v1.0.0 | 10KB | ASP.NET Core health checks |
| Carom.EntityFramework | v1.0.0 | 10KB | EF Core retry |
| Carom.Telemetry.OpenTelemetry | v1.0.0 | 9KB | OpenTelemetry metrics |
🚀 Quick Start
Installation
dotnet add package Carom
dotnet add package Carom.Extensions
Basic Usage
using Carom;
// Simple retry with exponential backoff
var result = await Carom.ShotAsync(() => api.CallAsync(), retries: 3);
// With timeout
var bounce = Bounce.Times(5).WithTimeout(TimeSpan.FromSeconds(30));
var data = await Carom.ShotAsync(() => apiClient.FetchAsync(), bounce);