build: upgrade to .NET 10 and remove KestrelWebApplicationFactory (microcks#74)

* Initial plan

* build: upgrade to .NET 10 and update NuGet packages

- Update global.json SDK version from 9.0.111 to 10.0.201
- Update Directory.Packages.props: Microsoft.AspNetCore.OpenApi and
  Microsoft.AspNetCore.Mvc.Testing from 9.0.14 to 10.0.5
- Update Order.Service.csproj and Order.Service.Tests.csproj target
  frameworks from net9.0 to net10.0

Signed-off-by: microcks-bot <copilot@github.com>

Agent-Logs-Url: https://github.com/microcks/microcks-testcontainers-dotnet-demo/sessions/1ba00e8d-1c66-413b-9715-faddf600c2f1

Co-authored-by: SebastienDegodez <2349146+SebastienDegodez@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: SebastienDegodez <2349146+SebastienDegodez@users.noreply.github.com>

Author: Copilot

Directory.Packages.props

@@ -6,8 +6,8 @@
 
   <ItemGroup>
     <!-- AspNetCore & Web -->
-    <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="9.0.14" />
-    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="9.0.14" />
+    <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.5" />
 
     <!-- Testing Framework -->
     <PackageVersion Include="xunit.v3" Version="3.2.2" />

explain-integration-testing-patterns.md

@@ -42,7 +42,7 @@ public class MyTestClass : IClassFixture<OrderServiceWebApplicationFactory<Progr
 >
 > - With **ICollectionFixture** (shared collection), a single factory and set of containers are shared for all tests. You allocate ports only once, which simplifies configuration and avoids conflicts. This is why the shared collection pattern is recommended for most test suites.
 ```csharp
-public class OrderServiceWebApplicationFactory<TProgram> : KestrelWebApplicationFactory<TProgram>, IAsyncLifetime
+public class OrderServiceWebApplicationFactory<TProgram> : WebApplicationFactory<TProgram>, IAsyncLifetime
     where TProgram : class
 {
     public ushort ActualPort { get; private set; }
@@ -186,7 +186,7 @@ public class SharedTestCollection : ICollectionFixture<OrderServiceWebApplicatio
 
 #### Step 2: Enhanced WebApplicationFactory
 ```csharp
-public class OrderServiceWebApplicationFactory<TProgram> : KestrelWebApplicationFactory<TProgram>, IAsyncLifetime
+public class OrderServiceWebApplicationFactory<TProgram> : WebApplicationFactory<TProgram>, IAsyncLifetime
     where TProgram : class
 {
     private static readonly SemaphoreSlim InitializationSemaphore = new(1, 1);

global.json

@@ -1,6 +1,6 @@
 {
   "sdk": {
-    "version": "9.0.111",
+    "version": "10.0.201",
     "rollForward": "latestMinor"
   }
 }

src/Order.Service/Order.Service.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
   </PropertyGroup>
 

step4-write-rest-tests.md

@@ -22,7 +22,7 @@ Here's how it works:
 
 Example:
 ```csharp
-public class OrderServiceWebApplicationFactory<TProgram> : KestrelWebApplicationFactory<TProgram>, IAsyncLifetime
+public class OrderServiceWebApplicationFactory<TProgram> : WebApplicationFactory<TProgram>, IAsyncLifetime
     where TProgram : class
 {
     // ...existing code...
@@ -74,7 +74,7 @@ This setup means you do not need to manually start Kafka, Microcks, or any other
 
 Let's understand what this configuration class does:
 
-* `OrderServiceWebApplicationFactory` extends `KestrelWebApplicationFactory<TProgram>` to provide a custom test environment for our application. `KestrelWebApplicationFactory` is a solution to expose the application on the real host port. In the .NET 10 (under development), this class can be replaced by the `WebApplicationFactory<TProgram>` class.
+* `OrderServiceWebApplicationFactory` extends `WebApplicationFactory<TProgram>` to provide a custom test environment for our application. In .NET 10, `WebApplicationFactory` natively supports Kestrel via the `UseKestrel()` method, so no custom wrapper class is needed.
 * `InitializeAsync` method is called to set up the test environment before running tests. It allocates a free port, starts the Kafka container, and initializes the Microcks container ensemble with the required artifacts.
 In detail:
    * We allocate a free port and expose it for container communication, in .NET it's possible to assign a dynamic port to the kestrel server but when we use Microcks Contract Testing, it's necessary to call the `ExposeHostPortsAsync` method to expose the port for host communication.

tests/Order.Service.Tests/KestrelWebApplicationFactory.cs

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <IsPackable>false</IsPackable>
   </PropertyGroup>

tests/Order.Service.Tests/Order.Service.Tests.csproj

@@ -29,6 +29,7 @@
 using Microcks.Testcontainers.Connection;
 
 using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Mvc.Testing;
 using Microsoft.Extensions.Hosting;
 
 using Testcontainers.Kafka;
@@ -42,7 +43,7 @@ namespace Order.Service.Tests;
 /// This factory is designed to be used as a singleton across all test classes to optimize container startup time.
 /// Containers are started once and reused by all tests in the test assembly.
 /// </summary>
-public class OrderServiceWebApplicationFactory<TProgram> : KestrelWebApplicationFactory<TProgram>, IAsyncLifetime
+public class OrderServiceWebApplicationFactory<TProgram> : WebApplicationFactory<TProgram>, IAsyncLifetime
     where TProgram : class
 {
     private const string MicrocksImage = "quay.io/microcks/microcks-uber:1.13.0-native";