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 MemoryCache for fast, in-memory caching of objects:

final cache = MemoryCacheImpl(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 DistributedCache 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');

Classes

CacheEntry

Represents an entry in the MemoryCache.

DistributedCache

Represents a distributed cache of serialized values.

DistributedCacheEntryOptions

Provides options for configuring distributed cache entries.

MemoryCache

Represents a local in-memory cache whose values are not serialized.

MemoryCacheEntryOptions

Provides options for configuring memory cache entries.

MemoryCacheImpl