modified CHANGELOG and README and uptate version

Author: simonemarano1993

AspNetCoreCacheKit/AspNetCoreCacheKit.csproj

@@ -7,7 +7,7 @@
 
 		<IsPackable>true</IsPackable>
 		<PackageId>AspNetCoreCacheKit</PackageId>
-		<Version>2.1.0</Version>
+		<Version>3.0.0</Version>
 		<Authors>Simone Marano</Authors>
 		<Description>Lightweight caching toolkit for ASP.NET Core with group-based keys, per-entry and per-group duration, configurable via appsettings.json and DI-ready design.</Description>
 		<PackageLicenseExpression>MIT</PackageLicenseExpression>

CHANGELOG.md

@@ -11,8 +11,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-## [2.1.0] - 2026-03-24
-
+## [3.0.0] - 2026-03-XX
+ 
+### Added
+- Unit test suite (`AspNetCoreCacheKit.Tests`) using xUnit 2.x and real `IMemoryCache`
+- Repository restructured to support multiple projects: main project moved to `AspNetCoreCacheKit/` subfolder, tests in `AspNetCoreCacheKit.Tests/`
+ 
+### Changed
+- `ICacheService.Set` is now generic: `void Set<T>(string groupKey, string key, T value, TimeSpan? duration = null)` — **breaking change**
+- `ICacheService.Set` overload without group is now generic: `void Set<T>(string key, T value, TimeSpan? duration = null)` — **breaking change**
+ 
+### Fixed
+- `Set` followed by `GetOrCreate<T>` / `GetOrCreateAsync<T>` now works correctly — previously `Set(object)` was type-incompatible with generic read methods causing cache misses
+ 
+### Breaking changes
+- `Set(string groupKey, string key, object value)` → `Set<T>(string groupKey, string key, T value)`: update all call sites to use the generic overload
+  ```csharp
+  // before
+  _cache.Set("users", "1", user);
+ 
+  // after — type is usually inferred automatically
+  _cache.Set("users", "1", user);
+  ```
+ 
 ---
 
 ## [2.0.0] - 2026-03-24
@@ -66,7 +87,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - MIT license
 
 ---
-[Unreleased]: https://github.com/simoneM93/AspNetCoreCacheKit/compare/v2.1.0...HEAD
-[2.1.0]: https://github.com/simoneM93/AspNetCoreCacheKit/compare/v2.0.0...v2.1.0
+[Unreleased]: https://github.com/simoneM93/AspNetCoreCacheKit/compare/v3.0.0...HEAD
+[3.0.0]: https://github.com/simoneM93/AspNetCoreCacheKit/compare/v2.0.0...v3.0.0
 [2.0.0]: https://github.com/simoneM93/AspNetCoreCacheKit/compare/v1.0.0...v2.0.0
 [1.0.0]: https://github.com/simoneM93/AspNetCoreCacheKit/releases/tag/v1.0.0

README.md

@@ -1,26 +1,27 @@
 # AspNetCoreCacheKit
 
 [![NuGet](https://img.shields.io/nuget/v/AspNetCoreCacheKit.svg)](https://www.nuget.org/packages/AspNetCoreCacheKit)
-[![Publish to NuGet](https://github.com/simoneM93/AspNetCoreCacheKit/actions/workflows/publish.yml/badge.svg)](https://github.com/simoneM93/AspNetCoreCacheKit/actions/workflows/publish.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?logo=github-sponsors)](https://github.com/sponsors/simoneM93)
 [![Changelog](https://img.shields.io/badge/Changelog-view-blue)](CHANGELOG.md)
 
-A lightweight caching library for ASP.NET Core featuring **group-based keys**, configurable expiration, and a DI-ready design that wraps `IMemoryCache` in a clean, testable abstraction.
+A lightweight caching library for ASP.NET Core featuring **group-based keys**, per-entry and per-group duration, configurable via `appsettings.json`, and a DI-ready design that wraps `IMemoryCache` in a clean, testable abstraction.
 
 > **Why AspNetCoreCacheKit?**
 > `IMemoryCache` is powerful but low-level. AspNetCoreCacheKit adds group-based key management,
-> `appsettings.json` configuration, and a consistent API that makes caching easy to use and easy to mock in tests.
+> per-group and per-entry expiration, `appsettings.json` configuration, and a consistent
+> type-safe API that makes caching easy to use and easy to mock in tests.
 
 ---
 
 ## ✨ Features
 
 - 🔑 **Group-based keys** — organise cache entries with prefixes like `"users:123"`
 - ⚡ **`GetOrCreate` and `GetOrCreateAsync`** — read-through pattern out of the box
+- ⏱️ **Per-group and per-entry duration** — fine-grained expiration control
 - 🗑️ **`Delete`** — remove a single entry by key or group + key
 - ✅ **Configuration validation** with DataAnnotations
-- 📐 **Nullable reference types** support
+- 📐 **Nullable reference types** and **generic type-safe `Set<T>`** support
 - 🎛️ **`appsettings.json`** configuration with sensible defaults
 - 🧪 **DI-ready** — register with one line, mock `ICacheService` in tests
 
@@ -90,12 +91,12 @@ public class UsersController : ControllerBase
     [HttpGet("{id}")]
     public async Task<IActionResult> GetUser(int id, CancellationToken ct)
     {
-        // With group key — full key will be "users:42"
+        // Uses GroupDurations["users"] = 30 min from appsettings
         var user = await _cache.GetOrCreateAsync(
             "users",
             id.ToString(),
             _ => GetUserFromDb(id),
-            ct);
+            ct: ct);
 
         return user is null ? NotFound() : Ok(user);
     }
@@ -148,15 +149,15 @@ var config = await _cache.GetOrCreateAsync("app:config", _ => LoadConfigAsync(),
 // Uses GroupDurations["countries"] = 1440 min from appsettings
 var countries = _cache.GetOrCreate("countries", () => LoadCountries());
 
-// Explicit override — ignores group and global config
+// Explicit override
 var result = _cache.GetOrCreate("countries", "IT", () => LoadItaly(), TimeSpan.FromHours(2));
 ```
 
 ### `Set` — explicit write
 
 ```csharp
-_cache.Set("users", "42", user);                                  // group duration or global
-_cache.Set("users", "42", user, TimeSpan.FromMinutes(10));        // explicit override
+_cache.Set("users", "42", user);                                   // group duration or global
+_cache.Set("users", "42", user, TimeSpan.FromMinutes(10));         // explicit override
 ```
 
 ### `Delete` — remove an entry
@@ -173,28 +174,29 @@ _cache.Delete("app:config");
 | Option | Type | Default | Description |
 |---|---|---|---|
 | `IsEnabled` | `bool` | `true` | Enables or disables caching entirely. When `false`, factories are always invoked. |
-| `DurationMinutes` | `int` | `60` | Global default cache duration in **minutes**. Used when no per-entry or per-group duration is set. |
+| `DurationMinutes` | `int` | `60` | Global default cache duration in **minutes**. |
 | `GroupDurations` | `Dictionary<string, int>` | `{}` | Per-group durations in **minutes**. Key = group name, Value = duration in minutes. |
 
 Setting `IsEnabled: false` is useful in development or testing environments where you want to bypass the cache without changing code.
 
 ---
 
 ## 🧪 Testing
- 
+
 `ICacheService` is a plain interface — mock it directly in unit tests:
- 
+
 ```csharp
 var cacheMock = new Mock<ICacheService>();
- 
+
 cacheMock
     .Setup(c => c.GetOrCreateAsync(
         "users", "1",
         It.IsAny<Func<ICacheEntry, Task<User>>>(),
+        It.IsAny<TimeSpan?>(),
         It.IsAny<CancellationToken>()))
     .ReturnsAsync(new User { Id = 1, Name = "Simone" });
 ```
- 
+
 ---
 
 ## ❤️ Support
@@ -207,4 +209,4 @@ If you find AspNetCoreCacheKit useful, consider sponsoring its development.
 
 ## 📄 License
 
-MIT — see [LICENSE](LICENSE) for details.
+MIT — see [LICENSE](LICENSE) for details.