EonaCat.SmartCache 1.0.0

EonaCat.SmartCache

EonaCat.SmartCache is a caching library for .NET applications. It provides easy-to-use, high-performance caching with support for priorities, sliding expiration, dependencies, tags, and both synchronous and asynchronous operations.

Features

• Method and object caching with configurable duration
• Async caching support
• Sliding expiration (reset cache expiration on access)
• Cache priority levels: Low, Normal, High
• Dependency-based invalidation (invalidate related cache entries automatically)
• Tag-based invalidation (remove entries by tag)
• Cache hit/miss statistics
• Events for cache add and remove (OnCacheAdd, OnCacheRemove)
• LRU-based eviction to manage memory usage

Installation

Install via NuGet:

Install-Package EonaCat.SmartCache

Or via .NET CLI:

dotnet add package EonaCat.SmartCache

Usage

Basic Synchronous Caching

var count = CacheManager.GetOrAdd("UserCount", () => GetUserCountFromDb(), 120);
Console.WriteLine(count);

Asynchronous Caching

var remoteData = await CacheManager.GetOrAddAsync("RemoteData", () => FetchRemoteDataAsync(), 30);
Console.WriteLine(remoteData);

Sliding Expiration & Priorities

var result = CacheManager.GetOrAdd(
    "ExpensiveResult",
    () => ComputeExpensive(),
    durationSeconds: 60,
    priority: CachePriority.High,
    slidingExpiration: TimeSpan.FromSeconds(30));

Dependency and Tag-Based Invalidation

// Cache with dependency and tag
var value = CacheManager.GetOrAdd(
    "Key1",
    () => ComputeValue(),
    60,
    dependencies: new[] { "Key2" },
    tags: new[] { "GroupA" });

// Remove by tag
CacheManager.RemoveByTag("GroupA");

Subscribe to Events

CacheManager.OnCacheAdd += (key, value) => Console.WriteLine($"Added: {key}");
CacheManager.OnCacheRemove += key => Console.WriteLine($"Removed: {key}");

Print Cache Statistics

CacheManager.PrintStats();

Attribute-Based Method Caching

public class DataService
{
    [Cached(Duration = 120)]
    public int GetUserCount() => 42;

    [Cached(30)]
    public async Task<string> GetRemoteDataAsync() => await Task.FromResult("RemoteResult");
}

using EonaCat.SmartCache;
using EonaCat.SmartCache.Attributes;

public class DataService
{
    [Cached(Duration = 120)]
    public int GetUserCount() => 42;

    [Cached(30)]
    public async Task<string> GetRemoteDataAsync()
    {
        await Task.Delay(100);
        return "RemoteResult";
    }
}

public class Program
{
    public static async Task Main()
    {
        var svc = new DataService();

        CacheManager.OnCacheAdd += (key, value) => Console.WriteLine($"Cache Added: {key}");
        CacheManager.OnCacheRemove += key => Console.WriteLine($"Cache Removed: {key}");

        var count = CacheManager.GetOrAdd("UserCount", () => svc.GetUserCount(), 120);
        Console.WriteLine(count);

        var count2 = CacheManager.GetOrAdd("UserCount", () => svc.GetUserCount(), 120);
        Console.WriteLine(count2);

        var remote = await CacheManager.GetOrAddAsync("RemoteData", () => svc.GetRemoteDataAsync(), 30);
        Console.WriteLine(remote);

        CacheManager.PrintStats();
    }
}