Pragmatic.Caching

Source-generated caching for .NET 10 — typed keys, tag-based invalidation, category routing, and HybridCache integration.

The Problem

Caching in .NET means scattered magic strings, manual serialization, hardcoded TTLs, and ad-hoc invalidation:

var key = $"product:{id}";                                  // magic string — rename and it breaks
var cached = await cache.GetStringAsync(key, ct);
if (cached is not null) return JsonSerializer.Deserialize<ProductDto>(cached);
var dto = ProductDto.FromEntity(await repo.GetByIdAsync(id, ct));
await cache.SetStringAsync(key, JsonSerializer.Serialize(dto),
    new DistributedCacheEntryOptions { AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(5) }, ct);

Miss one key in the invalidation handler and you serve stale data; share a backend across subsystems and you get key collisions.

The Solution

Declare what to cache and when to invalidate; the generator produces the key construction, options, and invalidation at compile time.

[Cacheable(Duration = "5m", Tags = ["products", "product:{ProductId}"])]
public partial class GetProductById { public int ProductId { get; init; } /* ... */ }

// A mutation invalidates by tag — no key-pattern duplication
[Mutation(Mode = MutationMode.Update)]
[InvalidatesCache("products")]
public partial class UpdateProductMutation : Mutation<Product> { /* ... */ }

Typed keys (no magic strings), tag-based invalidation, category routing to isolate subsystems (permissions, rate limiting, output cache) on a shared backend, and HybridCache (in-memory + distributed) integration.

Installation

dotnet add package Pragmatic.Caching
dotnet add package Pragmatic.SourceGenerator   # generates keys + invalidation

Status

[Cacheable]/[InvalidatesCache], typed keys, tag invalidation, category routing, and HybridCache integration are functional within the 0.8 preview. See the roadmap.

| Concepts | Typed keys, tags, invalidation model, HybridCache | | Getting Started | Cache a query, invalidate on a mutation | | Categories | Category routing to isolate subsystems on a shared backend | | Common Mistakes | The most frequent caching pitfalls | | Troubleshooting | Problem/solution guide with diagnostics |

Requirements

• .NET 10.0+
• Pragmatic.SourceGenerator analyzer

License

Part of the Pragmatic.Design ecosystem — see Licensing. Pragmatic.Caching is MIT-licensed.