Api versioning improvements

Author: futurum-dev

README.md

@@ -30,7 +30,7 @@ public partial class GreetingWebApiEndpoint
 - [x] [Easy setup](#easy-setup)
 - [x] Full support and built on top of [minimal apis](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/minimal-apis?view=aspnetcore-7.0)
 - [x] Full support for OpenApi
-- [x] Api Versioning baked-in
+- [x] Full support for Api Versioning
 - [x] Full support for [TypedResults](https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.http.typedresults?view=aspnetcore-7.0)
 - [x] Support for configuring
   - [x] [Futurum.WebApiEndpoint.Micro](#configuring-futurumwebapiendpointmicro)
@@ -266,10 +266,11 @@ The class must:
 
 #### Example
 ```csharp
-[WebApiVersionEndpointVersion(WebApiEndpointVersions.V3_0.Major, WebApiEndpointVersions.V3_0.Minor)]
-public class WebApiVersionEndpoint3_0 : IWebApiVersionEndpoint
+[WebApiVersionEndpointVersion(WebApiEndpointVersions.V3_0.Number)]
+[WebApiVersionEndpointVersion(WebApiEndpointVersions.V1_20_Beta.Text)]
+public class WebApiVersionEndpoint3_0a : IWebApiVersionEndpoint
 {
-    public IEndpointRouteBuilder Configure(IEndpointRouteBuilder builder, WebApiEndpointConfiguration configuration)
+    public RouteGroupBuilder Configure(IEndpointRouteBuilder builder, WebApiEndpointConfiguration configuration)
     {
         return builder.MapGroup("test-api").RequireAuthorization(Authorization.Permission.Admin);
     }

sample/Futurum.WebApiEndpoint.Micro.Sample.Addition/AdditionWebApiEndpoint.cs

@@ -3,6 +3,7 @@
 namespace Futurum.WebApiEndpoint.Micro.Sample.Addition;
 
 [WebApiEndpoint("addition")]
+[WebApiEndpointVersion(2.0d)]
 public partial class AdditionWebApiEndpoint
 {
     protected override void Build(IEndpointRouteBuilder builder)

sample/Futurum.WebApiEndpoint.Micro.Sample/GlobalWebApiEndpoint.cs

@@ -1,5 +1,3 @@
-using Futurum.WebApiEndpoint.Micro.Sample.Security;
-
 namespace Futurum.WebApiEndpoint.Micro.Sample;
 
 public class GlobalWebApiEndpoint : IGlobalWebApiEndpoint

sample/Futurum.WebApiEndpoint.Micro.Sample/OpenApi/OpenApiVersionV0WebApiEndpoint.cs

@@ -3,7 +3,7 @@
 namespace Futurum.WebApiEndpoint.Micro.Sample.OpenApi;
 
 [WebApiEndpoint("openapi")]
-[WebApiEndpointVersion(WebApiEndpointVersions.V0_1.Major, WebApiEndpointVersions.V0_1.Minor)]
+[WebApiEndpointVersion(WebApiEndpointVersions.V0_1.Number)]
 public partial class OpenApiVersionV0WebApiEndpoint
 {
     protected override void Build(IEndpointRouteBuilder builder)

sample/Futurum.WebApiEndpoint.Micro.Sample/OpenApi/OpenApiVersionV1WebApiEndpoint.cs

@@ -3,8 +3,10 @@
 namespace Futurum.WebApiEndpoint.Micro.Sample.OpenApi;
 
 [WebApiEndpoint("openapi")]
-[WebApiEndpointVersion(WebApiEndpointVersions.V1_0.Major, WebApiEndpointVersions.V1_0.Minor)]
-[WebApiEndpointVersion(WebApiEndpointVersions.V3_0.Major, WebApiEndpointVersions.V3_0.Minor)]
+[WebApiEndpointVersion(WebApiEndpointVersions.V1_0.Number)]
+[WebApiEndpointVersion(WebApiEndpointVersions.V3_0.Number)]
+[WebApiEndpointVersion(WebApiEndpointVersions.V4_0_Alpha.Number, WebApiEndpointVersions.V4_0_Alpha.Status)]
+[WebApiEndpointVersion(WebApiEndpointVersions.V1_20_Beta.Text)]
 public partial class OpenApiVersionV1WebApiEndpoint
 {
     protected override void Build(IEndpointRouteBuilder builder)

sample/Futurum.WebApiEndpoint.Micro.Sample/OpenApi/OpenApiVersionV2WebApiEndpoint.cs

@@ -3,7 +3,7 @@
 namespace Futurum.WebApiEndpoint.Micro.Sample.OpenApi;
 
 [WebApiEndpoint("openapi")]
-[WebApiEndpointVersion(WebApiEndpointVersions.V2_0.Major, WebApiEndpointVersions.V2_0.Minor)]
+[WebApiEndpointVersion(WebApiEndpointVersions.V2_0.Number)]
 public partial class OpenApiVersionV2WebApiEndpoint
 {
     protected override void Build(IEndpointRouteBuilder builder)

sample/Futurum.WebApiEndpoint.Micro.Sample/RateLimiting.cs

@@ -1,4 +1,3 @@
-using System.Net;
 using System.Threading.RateLimiting;
 
 using Microsoft.AspNetCore.RateLimiting;

sample/Futurum.WebApiEndpoint.Micro.Sample/WebApiEndpointVersions.cs

@@ -1,32 +1,43 @@
+using Futurum.WebApiEndpoint.Micro.Generator;
+
 namespace Futurum.WebApiEndpoint.Micro.Sample;
 
 public static class WebApiEndpointVersions
 {
     public static class V0_1
     {
-        public const int Major = 0;
-        public const int Minor = 1;
-        public static readonly WebApiEndpointVersion Version = new(Major, Minor);
+        public const double Number = 0.1d;
+        public static readonly WebApiEndpointVersion Version = new(new WebApiEndpointApiVersion.WebApiEndpointNumberApiVersion(Number));
     }
 
     public static class V1_0
     {
-        public const int Major = 1;
-        public const int Minor = 0;
-        public static readonly WebApiEndpointVersion Version = new(Major, Minor);
+        public const double Number = 1.0d;
+        public static readonly WebApiEndpointVersion Version = new(new WebApiEndpointApiVersion.WebApiEndpointNumberApiVersion(Number));
     }
 
     public static class V2_0
     {
-        public const int Major = 2;
-        public const int Minor = 0;
-        public static readonly WebApiEndpointVersion Version = new(Major, Minor);
+        public const double Number = 2.0d;
+        public static readonly WebApiEndpointVersion Version = new(new WebApiEndpointApiVersion.WebApiEndpointNumberApiVersion(Number));
     }
 
     public static class V3_0
     {
-        public const int Major = 3;
-        public const int Minor = 0;
-        public static readonly WebApiEndpointVersion Version = new(Major, Minor);
+        public const double Number = 3.0d;
+        public static readonly WebApiEndpointVersion Version = new(new WebApiEndpointApiVersion.WebApiEndpointNumberApiVersion(Number));
+    }
+
+    public static class V4_0_Alpha
+    {
+        public const double Number = 4.0d;
+        public const string Status = "alpha";
+        public static readonly WebApiEndpointVersion Version = new(new WebApiEndpointApiVersion.WebApiEndpointNumberApiVersion(Number, Status));
+    }
+
+    public static class V1_20_Beta
+    {
+        public const string Text = "1.20-beta";
+        public static readonly WebApiEndpointVersion Version = new(new WebApiEndpointApiVersion.WebApiEndpointStringApiVersion(Text));
     }
 }

sample/Futurum.WebApiEndpoint.Micro.Sample/WebApiVersionEndpoint3_0.cs

@@ -2,7 +2,8 @@
 
 namespace Futurum.WebApiEndpoint.Micro.Sample;
 
-[WebApiVersionEndpointVersion(WebApiEndpointVersions.V3_0.Major, WebApiEndpointVersions.V3_0.Minor)]
+[WebApiVersionEndpointVersion(WebApiEndpointVersions.V3_0.Number)]
+[WebApiVersionEndpointVersion(WebApiEndpointVersions.V1_20_Beta.Text)]
 public class WebApiVersionEndpoint3_0a : IWebApiVersionEndpoint
 {
     public RouteGroupBuilder Configure(IEndpointRouteBuilder builder, WebApiEndpointConfiguration configuration)

src/Futurum.WebApiEndpoint.Micro.Generator/DiagnosticDescriptors.cs

@@ -34,7 +34,7 @@ public static class DiagnosticDescriptors
     public static readonly DiagnosticDescriptor WebApiVersionEndpointMultipleInstances = new(
         "FWAEM0004",
         "Multiple instances found of WebApiVersionEndpoint for the same version",
-        $"WebApiVersionEndpoint class '{{0}}' with version '{{1}}.{{2}}' is one of many instances.\n" +
+        $"WebApiVersionEndpoint class '{{0}}' with version '{{1}}' is one of many instances.\n" +
         $"There can only be one instance of WebApiVersionEndpoint.",
         "Futurum.WebApiEndpoint.Micro.Generator",
         DiagnosticSeverity.Error,