chore: benchmark tests

Author: null-d3v

.devcontainer/docker-compose.yml

@@ -1,9 +1,8 @@
-version: "3.8"
 services:
     devcontainer:
         image: mcr.microsoft.com/devcontainers/dotnet:8.0-bookworm
         volumes:
           - ..:/workspace:cached
         command: sleep infinity
     redis:
-        image: redis
+        image: redis

.editorconfig

@@ -4,6 +4,8 @@
 
 `L1L2RedisCache` is heavily inspired by development insights provided over the past several years by [StackOverflow](https://stackoverflow.com/). It attempts to simplify those concepts into a highly accessible `IDistributedCache` implementation that is more performant.
 
+I expect to gracefully decomission this project when [`StackExchange.Redis`](https://github.com/StackExchange/StackExchange.Redis) has [client-side caching](https://redis.io/docs/latest/develop/use/client-side-caching/) support.
+
 ## Configuration
 
 It is intended that L1L12RedisCache be used as an `IDistributedCache` implementation.

README.md

@@ -0,0 +1,49 @@
+using BenchmarkDotNet.Attributes;
+using Microsoft.Extensions.Caching.Distributed;
+using Microsoft.Extensions.Caching.Memory;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace L1L2RedisCache.Tests.System;
+
+public abstract class BenchmarkBase
+{
+    [Params(100)]
+    public int Iterations { get; set; }
+    
+    protected DistributedCacheEntryOptions DistributedCacheEntryOptions { get; set; } =
+        new DistributedCacheEntryOptions
+        {
+            AbsoluteExpirationRelativeToNow =
+                TimeSpan.FromHours(1),
+        };
+    protected IMemoryCache? L1Cache { get; set; }
+    protected IDistributedCache? L1L2Cache { get; set; }
+    protected IDistributedCache? L2Cache { get; set; }
+
+    [GlobalSetup]
+    public void GlobalSetup()
+    {
+        var configuration = new ConfigurationBuilder()
+            .AddJsonFile("appsettings.json")
+            .AddEnvironmentVariables()
+            .Build();
+
+        var services = new ServiceCollection();
+        services.AddSingleton(configuration);
+        services.AddL1L2RedisCache(options =>
+        {
+            configuration.Bind("L1L2RedisCache", options);
+        });
+        var serviceProvider = services
+            .BuildServiceProvider();
+
+        L1Cache = serviceProvider
+            .GetRequiredService<IMemoryCache>();
+        L1L2Cache = serviceProvider
+            .GetRequiredService<IDistributedCache>();
+        L2Cache = serviceProvider
+            .GetRequiredService<Func<IDistributedCache>>()
+            .Invoke();
+    }
+}

tests/System/Benchmark/BenchmarkBase.cs

@@ -0,0 +1,87 @@
+using BenchmarkDotNet.Attributes;
+using Microsoft.Extensions.Caching.Distributed;
+using Microsoft.Extensions.Caching.Memory;
+
+namespace L1L2RedisCache.Tests.System;
+
+public class GetBenchmark : BenchmarkBase
+{
+    public new void GlobalSetup()
+    {
+        base.GlobalSetup();
+
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L1L2Cache!.SetString(
+                $"Get:{iteration}",
+                "Value",
+                DistributedCacheEntryOptions);
+            L1L2Cache!.SetString(
+                $"GetPropagation:{iteration}",
+                "Value",
+                DistributedCacheEntryOptions);
+        }
+    }
+
+    [IterationSetup]
+    public void IterationSetup()
+    {
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L1Cache!.Remove(
+                $"GetPropagation:{iteration}");
+        }
+    }
+
+    [Benchmark]
+    public void L1Get()
+    {
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L1Cache!.Get<string>(
+                $"Get:{iteration}");
+        }
+    }
+
+    [Benchmark]
+    public void L1L2Get()
+    {
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L1L2Cache!.GetString(
+                $"Get:{iteration}");
+        }
+    }
+
+    [Benchmark]
+    public void L1L2GetPropagation()
+    {
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L1L2Cache!.GetString(
+                $"GetPropagation:{iteration}");
+        }
+    }
+
+    [Benchmark]
+    public void L2Get()
+    {
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L2Cache!.GetString(
+                $"Get:{iteration}");
+        }
+    }
+}

tests/System/Benchmark/GetBenchmark.cs

@@ -0,0 +1,36 @@
+using BenchmarkDotNet.Attributes;
+using Microsoft.Extensions.Caching.Distributed;
+
+namespace L1L2RedisCache.Tests.System;
+
+[SimpleJob]
+public class SetBenchmark : BenchmarkBase
+{
+    [Benchmark]
+    public void L1L2Set()
+    {
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L1L2Cache!.SetString(
+                $"Set:{iteration}",
+                "Value",
+                DistributedCacheEntryOptions);
+        }
+    }
+
+    [Benchmark]
+    public void L2Set()
+    {
+        for (var iteration = 1;
+            iteration <= Iterations;
+            iteration++)
+        {
+            L2Cache!.SetString(
+                $"Set:{iteration}",
+                "Value",
+                DistributedCacheEntryOptions);
+        }
+    }
+}

tests/System/Benchmark/SetBenchmark.cs

@@ -14,14 +14,15 @@
     <ProjectReference Include="..\..\src\L1L2RedisCache.csproj" />
   </ItemGroup>
   <ItemGroup>
+    <PackageReference Include="BenchmarkDotNet" Version="0.14.*" />
     <PackageReference Include="coverlet.collector" Version="6.0.*" />
     <PackageReference Include="Microsoft.Extensions.Configuration" Version="8.0.*" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="8.0.*" />
     <PackageReference Include="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="8.0.*" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="8.0.*" />
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.*" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.*" />
-    <PackageReference Include="MSTest.TestAdapter" Version="3.2.*" />
-    <PackageReference Include="MSTest.TestFramework" Version="3.2.*" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.*" />
+    <PackageReference Include="MSTest.TestAdapter" Version="3.5.*" />
+    <PackageReference Include="MSTest.TestFramework" Version="3.5.*" />
   </ItemGroup>
 </Project>