👁 Image
Tharga.Cache 0.4.8

Tharga.Cache

👁 NuGet
👁 Nuget

A flexible .NET caching library with multiple cache strategies, configurable eviction policies, and stale-while-revalidate support — all with a clean DI-first API.

Features

• Four cache strategies — Eternal, Time-To-Live (TTL), Time-To-Idle (TTI), and Scoped
• Eviction policies — LRU, FIFO, or Random when size or count limits are reached
• Stale-while-revalidate — return cached data instantly while refreshing in the background
• Pluggable persistence — in-memory by default, with optional Redis, MongoDB, and file backends
• Fail-open — when a persist backend is unreachable, reads fall through to the source loader and writes are skipped, so a cache outage never faults the caller (CacheOptions.FailOpenOnBackendError, on by default)
• Composite keys — build cache keys from multiple parts with KeyBuilder
• Monitoring — inspect cache state, item counts, and fetch queue depth via ICacheMonitor
• Background cleanup — built-in WatchDog service removes stale entries automatically

Get Started

dotnet add package Tharga.Cache

// Register
builder.Services.AddCache();

// Use
public class MyService
{
 private readonly ITimeToLiveCache _cache;

 public MyService(ITimeToLiveCache cache) => _cache = cache;

 public Task<Product> GetProductAsync(int id) =>
 _cache.GetAsync<Product>($"product-{id}", () => LoadAsync(id), TimeSpan.FromMinutes(10));
}

Persistence Backends

Extend with optional packages to persist beyond memory:

Documentation

Full documentation, configuration options, and samples are available on the GitHub project page.

License

MIT