[Copilot]

This PR adds a comprehensive benchmarking project BlitzCache.Benchmarks to measure and compare BlitzCache's performance against other popular caching solutions (MemoryCache, LazyCache) under concurrent scenarios.

What's Added

New BlitzCache.Benchmarks Project

• Console application targeting .NET 8.0
• Integrated with BenchmarkDotNet for professional performance measurement
• Added to the solution file with proper project references

Comprehensive Benchmark Suite

The benchmarks focus on BlitzCache's core strength - preventing the thundering herd problem:

1. Concurrent Same Key Benchmark - Tests 100 concurrent threads accessing the same cache key:

   // BlitzCache: Single execution, all threads wait for result ⚡
   // MemoryCache: Multiple executions due to race conditions 💸
   // LazyCache: Similar to BlitzCache but different performance characteristics

2. Concurrent Different Keys Benchmark - Baseline performance with 50 threads accessing different keys

3. Cache Expiration Benchmark - Performance evaluation during cache refresh cycles

Documentation & Usage

• Updated main README with benchmark section and usage instructions
• Comprehensive benchmark project README with customization guide
• Validation script for easy testing and verification

Key Technical Features

• Memory diagnostics enabled to track allocation patterns
• Proper resource disposal for all caching libraries
• Configurable parameters for different test scenarios
• Release mode optimization for accurate measurements
• Simple functionality tests to verify all libraries work correctly

Performance Insights

The benchmarks demonstrate BlitzCache's unique value proposition in high-concurrency scenarios where multiple threads simultaneously request expensive operations. This provides measurable evidence of BlitzCache's effectiveness in preventing duplicate work and reducing system load.

Run the benchmarks with:

cd BlitzCache.Benchmarks
dotnet run -c Release

Fixes #9.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

@chanido 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[Copilot]

Copilot wasn't able to review any files in this pull request.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}