Asp.Versioning & RateLimiter support added

andrey-serdyuk · andrey-serdyuk · commit 6674213f1e3b · 2025-11-08T16:19:46.000+02:00
diff --git a/Shared.slnx b/Shared.slnx
@@ -1,6 +1,7 @@
 <Solution>
   <Folder Name="/.solution_items/">
     <File Path="Directory.Build.props" />
+    <File Path="README.md" />
   </Folder>
   <Folder Name="/.solution_items/.nuget/">
     <File Path=".nuget/delist.ps1" />
@@ -36,7 +37,9 @@
     <Project Path="TaskHub.Shared.Bootstraper/TaskHub.Shared.Bootstraper.csproj" Id="7babb715-b9be-447f-90b4-b1b3451df9bf" />
     <Project Path="TaskHub.Shared.ConfigurationTools/TaskHub.Shared.ConfigurationTools.csproj" Id="0f21840b-73df-465d-a20e-45983df6e24e" />
     <Project Path="TaskHub.Shared.OpenTelemetry/TaskHub.Shared.OpenTelemetry.csproj" Id="b991f047-11eb-4303-9662-bc4ef0fe058f" />
+    <Project Path="TaskHub.Shared.RateLimiter/TaskHub.Shared.RateLimiter.csproj" Id="6e4d4c7b-0df0-460e-8653-8123bc540fc6" />
     <Project Path="TaskHub.Shared.Redis/TaskHub.Shared.Redis.csproj" Id="5fc5938a-a4d2-4fee-99cc-5d9cf54e0645" />
     <Project Path="TaskHub.Shared.Swagger/TaskHub.Shared.Swagger.csproj" Id="b945e948-fe0b-4724-8f55-cbd0be83e924" />
+    <Project Path="TaskHub.Shared.Versioning/TaskHub.Shared.Versioning.csproj" Id="f205e5d7-23fb-43ea-9007-9e9d9b9042c0" />
   </Folder>
 </Solution>
diff --git a/TaskHub.Shared.Bootstraper/FullHostBuilder.cs b/TaskHub.Shared.Bootstraper/FullHostBuilder.cs
@@ -8,7 +8,6 @@
 using TaskHub.Shared.Commands.Bus;
 using TaskHub.Shared.Infrastructure.EfCore.Bootstrap;
 using TaskHub.Shared.OpenTelemetry;
-using TaskHub.Shared.Redis;
 
 namespace TaskHub.Shared.Bootstraper;
 
diff --git a/TaskHub.Shared.Bootstraper/Settings/AddVersioning.cs b/TaskHub.Shared.Bootstraper/Settings/AddVersioning.cs
@@ -0,0 +1,19 @@
+﻿using Microsoft.AspNetCore.Builder;
+using System.Text;
+using TaskHub.Shared.ConfigurationTools;
+using TaskHub.Shared.Versioning;
+
+namespace TaskHub.Shared.Bootstraper.Settings;
+
+public static class AddVersioning
+{
+    public static void AddAppVersioning(this WebApplicationBuilder builder) => builder.Services.AddAppVersioning(options =>
+    {
+        var section = builder.Configuration.GetSection("Versioning");
+        options.IsEnabled = section.GetBool("IsEnabled");
+        options.AppVersion = section.GetString("AppVersion");
+        options.Format = section.GetString("NameFormat");
+        options.InUrl = section.GetBool("InUrl");
+        options.ReportVersions = section.GetBool("ReportVersions");
+    });
+}
diff --git a/TaskHub.Shared.Bootstraper/TaskHub.Shared.Bootstraper.csproj b/TaskHub.Shared.Bootstraper/TaskHub.Shared.Bootstraper.csproj
@@ -14,5 +14,6 @@
 		<ProjectReference Include="..\TaskHub.Shared.Redis\TaskHub.Shared.Redis.csproj" />
 		<ProjectReference Include="..\TaskHub.Shared.Response\TaskHub.Shared.Response.csproj" />
 		<ProjectReference Include="..\TaskHub.Shared.Swagger\TaskHub.Shared.Swagger.csproj" />
+		<ProjectReference Include="..\TaskHub.Shared.Versioning\TaskHub.Shared.Versioning.csproj" />
 	</ItemGroup>
 </Project>
diff --git a/TaskHub.Shared.Commands.Abstractions/Behavior/IPostBehavior.cs b/TaskHub.Shared.Commands.Abstractions/Behavior/IPostBehavior.cs
@@ -3,7 +3,7 @@
 
 namespace TaskHub.Shared.Commands.Abstractions.Behavior;
 
- public interface IPostBehavior<in TCommand, in TResult>
+public interface IPostBehavior<in TCommand, in TResult>
     where TCommand : ICommand
     where TResult : Result
 {
diff --git a/TaskHub.Shared.OpenTelemetry/TaskHub.Shared.OpenTelemetry.csproj b/TaskHub.Shared.OpenTelemetry/TaskHub.Shared.OpenTelemetry.csproj
@@ -10,4 +10,7 @@
 		<PackageReference Include="OpenTelemetry.Instrumentation.Http" Version="1.13.0" />
 		<PackageReference Include="OpenTelemetry.Instrumentation.Runtime" Version="1.13.0" />
 	</ItemGroup>
+	<ItemGroup>
+	  <ProjectReference Include="..\TaskHub.Shared.ConfigurationTools\TaskHub.Shared.ConfigurationTools.csproj" />
+	</ItemGroup>
 </Project>
diff --git a/TaskHub.Shared.RateLimiter/FixedLimiterOptions.cs b/TaskHub.Shared.RateLimiter/FixedLimiterOptions.cs
@@ -0,0 +1,21 @@
+﻿using System.Threading.RateLimiting;
+
+namespace TaskHub.Shared.RateLimiter;
+
+public class FixedLimiterOptions
+{
+    public bool IsEnabled { get; set; } = false;
+    public bool AutoReplenishment { get; set; } = false;
+    public string PartitionKey { get; set; } = string.Empty;
+    public int PermitLimit { get; set; } = 0;
+    public int QueueLimit { get; set; } = 0;
+    public int Window { get; set; } = 0;
+    public int ProcessingOrder { get; set; } = 0;
+
+    public QueueProcessingOrder QueueProcessingOrder => ProcessingOrder switch
+    {
+        0 => QueueProcessingOrder.OldestFirst,
+        1 => QueueProcessingOrder.NewestFirst,
+        _ => QueueProcessingOrder.OldestFirst
+    };
+}
diff --git a/TaskHub.Shared.RateLimiter/RateLimiterBootstrap.cs b/TaskHub.Shared.RateLimiter/RateLimiterBootstrap.cs
@@ -0,0 +1,26 @@
+﻿using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.Extensions.DependencyInjection;
+using System.Threading.RateLimiting;
+
+namespace TaskHub.Shared.RateLimiter;
+
+public static class RateLimiterBootstrap
+{
+    public static void AddFixedRateLimiter(this IServiceCollection services, Action<FixedLimiterOptions> action)
+    {
+        var options = new FixedLimiterOptions();
+        action(options);
+        if (options.IsEnabled) services.AddRateLimiter(o =>
+            o.GlobalLimiter = PartitionedRateLimiter.Create<HttpContext, string>(httpContext => RateLimitPartition.GetFixedWindowLimiter(
+                    partitionKey: options.PartitionKey, factory: partition => new FixedWindowRateLimiterOptions
+                    {
+                        AutoReplenishment = options.AutoReplenishment,
+                        PermitLimit = options.PermitLimit,
+                        QueueLimit = options.QueueLimit,
+                        QueueProcessingOrder = options.QueueProcessingOrder,
+                        Window = TimeSpan.FromMinutes(options.Window)
+                    })
+            ));
+    }
+}
diff --git a/TaskHub.Shared.RateLimiter/TaskHub.Shared.RateLimiter.csproj b/TaskHub.Shared.RateLimiter/TaskHub.Shared.RateLimiter.csproj
@@ -0,0 +1,8 @@
+﻿<Project Sdk="Microsoft.NET.Sdk">
+	<ItemGroup>
+		<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.3.0" />
+		<PackageReference Include="Microsoft.AspNetCore.RateLimiting" Version="7.0.0-rc.2.22476.2" />
+		<PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.10" />
+		<PackageReference Include="System.Threading.RateLimiting" Version="9.0.10" />
+	</ItemGroup>
+</Project>
diff --git a/TaskHub.Shared.Redis/TaskHub.Shared.Redis.csproj b/TaskHub.Shared.Redis/TaskHub.Shared.Redis.csproj
@@ -1,7 +1,9 @@
 ﻿<Project Sdk="Microsoft.NET.Sdk">
 	<ItemGroup>
 		<PackageReference Include="Microsoft.Extensions.Caching.StackExchangeRedis" Version="9.0.10" />
-		<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.10" />
 		<PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.10" />
 	</ItemGroup>
+	<ItemGroup>
+	  <ProjectReference Include="..\TaskHub.Shared.ConfigurationTools\TaskHub.Shared.ConfigurationTools.csproj" />
+	</ItemGroup>
 </Project>
diff --git a/TaskHub.Shared.Versioning/TaskHub.Shared.Versioning.csproj b/TaskHub.Shared.Versioning/TaskHub.Shared.Versioning.csproj
@@ -0,0 +1,8 @@
+﻿<Project Sdk="Microsoft.NET.Sdk">
+  <ItemGroup>
+    <PackageReference Include="Asp.Versioning.Abstractions" Version="8.1.0" />
+    <PackageReference Include="Asp.Versioning.Mvc" Version="8.1.0" />
+    <PackageReference Include="Asp.Versioning.Mvc.ApiExplorer" Version="8.1.0" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.10" />
+  </ItemGroup>
+</Project>
diff --git a/TaskHub.Shared.Versioning/VersioningBootstrap.cs b/TaskHub.Shared.Versioning/VersioningBootstrap.cs
@@ -0,0 +1,23 @@
+﻿using Microsoft.Extensions.DependencyInjection;
+
+namespace TaskHub.Shared.Versioning;
+
+public static class VersioningBootstrap
+{
+    public static void AddAppVersioning(this IServiceCollection services, Action<VersioningOptions> action)
+    {
+        var options = new VersioningOptions();
+        action(options);
+
+        if (options.IsEnabled) services.AddApiVersioning(o =>
+        {
+            o.DefaultApiVersion = options.ApiVersion;
+            o.AssumeDefaultVersionWhenUnspecified = true;
+            o.ReportApiVersions = options.ReportVersions;
+        }).AddApiExplorer(o =>
+        {
+            o.GroupNameFormat = options.Format;
+            o.SubstituteApiVersionInUrl = options.InUrl;
+        });
+    }
+}
diff --git a/TaskHub.Shared.Versioning/VersioningOptions.cs b/TaskHub.Shared.Versioning/VersioningOptions.cs
@@ -0,0 +1,21 @@
+﻿using Asp.Versioning;
+
+namespace TaskHub.Shared.Versioning;
+
+public class VersioningOptions
+{
+    public bool IsEnabled { get; set; } = true;
+    public string AppVersion { get; set; } = string.Empty;
+    public string Format { get; set; } = string.Empty;
+    public bool InUrl { get; set; } = false;
+    public bool ReportVersions { get; set; } = false;
+
+    public ApiVersion ApiVersion
+    {
+        get
+        {
+            var version = AppVersion.Split('.');
+            return new ApiVersion(int.Parse(version[0]), int.Parse(version[1]));
+        }
+    }
+}

Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`
`4`	`4`	`namespace TaskHub.Shared.Commands.Abstractions.Behavior;`
`5`	`5`
`6`		`- public interface IPostBehavior<in TCommand, in TResult>`
	`6`	`+public interface IPostBehavior<in TCommand, in TResult>`
`7`	`7`	`where TCommand : ICommand`
`8`	`8`	`where TResult : Result`
`9`	`9`	`{`