caching library

Contains classes and abstractions for caching data in memory and distributed systems.

This library provides a comprehensive caching solution inspired by Microsoft.Extensions.Caching, offering both in-memory and distributed caching capabilities with features like:

• Multiple expiration strategies (absolute, sliding, change token-based)
• Priority-based eviction policies
• Size-based capacity management
• Post-eviction callbacks
• Statistics tracking
• Type-safe generic APIs

Memory Caching

Use IMemoryCache for fast, in-memory caching of objects:

final cache = MemoryCache(MemoryCacheOptions());

// Simple set/get
cache.set('key', 'value');
final value = cache.get<String>('key');

// With expiration
cache.set('key', 'value', MemoryCacheEntryOptions()
  ..absoluteExpirationRelativeToNow = Duration(minutes: 5));

// Get or create pattern
final data = await cache.getOrCreateAsync<String>('key', (entry) async {
  entry.slidingExpiration = Duration(minutes: 15);
  return await fetchDataFromApi();
});

Distributed Caching

Use IDistributedCache for distributed caching across multiple servers:

final cache = MemoryDistributedCache(MemoryDistributedCacheOptions());

// Store bytes
await cache.set('key', utf8.encode('value'));

// Store strings
await cache.setString('key', 'value', DistributedCacheEntryOptions()
  ..slidingExpiration = Duration(hours: 1));

// Retrieve data
final value = await cache.getString('key');