Add new package WireMock.Net.Extensions.Routing which provides minimal-API-style routing for WireMock.Net (#1344)

* Add new package WireMock.Net.Extensions.Routing

* Update documentation for WireMock.Net.Extensions.Routing

* Cleanup imports

* Add header to all source files inside WireMock.Net.Extensions.Routing

* Add header to all source files inside WireMock.Net.Extensions.Routing.Tests

* Revert unintended changes

* Remove redundant build configurations

* Remove incorrect links from documentation

* Update nuget package references

* Revert unintended changes

* Migrate to AwesomeAssertions

* Remove redundant project reference

* Adjust formatting

* Migrate to primary constructor

* Refactoring: rename delegate parameter

* Abstract over JSON converter

* Replace WireMock with WireMock.Net in comments

* Move local functions to the bottom of the methods

test/WireMock.Net.Extensions.Routing.Tests/Tests/WireMockRouterTests.cs

@@ -0,0 +1,100 @@
+// Copyright © WireMock.Net
+
+using System.Net.Http;
+using System.Net.Http.Json;
+using System.Threading.Tasks;
+using AwesomeAssertions;
+using WireMock.Net.Extensions.Routing.Extensions;
+using WireMock.Server;
+
+namespace WireMock.Net.Extensions.Routing.Tests.Tests;
+
+public sealed class WireMockRouterTests
+{
+    private const string DefaultUrlPattern = "/test";
+
+    private readonly WireMockServer _server = WireMockServer.Start();
+    private readonly WireMockRouter _sut;
+
+    public WireMockRouterTests()
+    {
+        _sut = new WireMockRouter(_server);
+    }
+
+    [Fact]
+    public async Task Map_ShouldReturnResultFromHandler_ForGetMethod()
+    {
+        const int handlerResult = 5;
+        _sut.Map(HttpMethod.Get.ToString(), DefaultUrlPattern, _ => handlerResult);
+        using var client = _server.CreateClient();
+
+        var result = await client.GetFromJsonAsync<int>(DefaultUrlPattern);
+
+        result.Should().Be(handlerResult);
+    }
+
+    [Fact]
+    public async Task Map_ShouldReturnResultFromAsyncHandler_ForGetMethod()
+    {
+        const int handlerResult = 5;
+        _sut.Map(HttpMethod.Get.ToString(), DefaultUrlPattern, _ => Task.FromResult(handlerResult));
+        using var client = _server.CreateClient();
+
+        var result = await client.GetFromJsonAsync<int>(DefaultUrlPattern);
+
+        result.Should().Be(handlerResult);
+    }
+
+    [Fact]
+    public async Task Map_ShouldReturnResultFromAsyncHandlerWithAwait_ForGetMethod()
+    {
+        const int handlerResult = 5;
+        _sut.Map(
+            HttpMethod.Get.ToString(),
+            DefaultUrlPattern,
+            async _ => await Task.FromResult(handlerResult));
+        using var client = _server.CreateClient();
+
+        var result = await client.GetFromJsonAsync<int>(DefaultUrlPattern);
+
+        result.Should().Be(handlerResult);
+    }
+
+    [Fact]
+    public async Task Map_ShouldReturnResultFromAsyncHandlerWithDelayAndAwait_ForGetMethod()
+    {
+        const int handlerResult = 5;
+
+        async Task<object?> HandleRequestAsync()
+        {
+            await Task.Delay(1);
+            return handlerResult;
+        }
+
+        _sut.Map(HttpMethod.Get.ToString(), DefaultUrlPattern, _ => HandleRequestAsync());
+        using var client = _server.CreateClient();
+
+        var result = await client.GetFromJsonAsync<int>(DefaultUrlPattern);
+
+        result.Should().Be(handlerResult);
+    }
+
+    [Fact]
+    public async Task MapGet_ShouldReturnResultFromAsyncHandlerWithDelayAwait()
+    {
+        const int handlerResult = 5;
+
+        async Task<object?> HandleRequestAsync()
+        {
+            await Task.Delay(1);
+            return handlerResult;
+        }
+
+        _sut.MapGet(DefaultUrlPattern, _ => HandleRequestAsync());
+        using var client = _server.CreateClient();
+
+        var result = await client.GetFromJsonAsync<int>(DefaultUrlPattern);
+
+        result.Should().Be(handlerResult);
+    }
+}