use dual mode testing

dj-nitehawk · dj-nitehawk · commit 6c5fb3611608 · 2026-03-03T13:22:21.000+05:30
diff --git a/FastEndpoints.TemplatePack.csproj b/FastEndpoints.TemplatePack.csproj
@@ -2,7 +2,7 @@
 
     <PropertyGroup>
 
-        <Version>1.10.2</Version>
+        <Version>1.11.0-beta.1</Version>
 
         <PackageType>Template</PackageType>
         <PackageId>FastEndpoints.TemplatePack</PackageId>
diff --git a/changelog.md b/changelog.md
@@ -1 +1,2 @@
-- upgrade FastEndpoints to latest `v8.0.1`
+- use dual mode testing for aot project
+- upgrade FastEndpoints to latest
diff --git a/templates/aot/.gitignore b/templates/aot/.gitignore
@@ -350,3 +350,5 @@ MigrationBackup/
 .ionide/
 
 .idea/.idea.Ctma/.idea/workspace.xml
+
+dotnet-tools.json
diff --git a/templates/aot/Source/Generated/FastEndpoints/.fastendpoints-generator-cache b/templates/aot/Source/Generated/FastEndpoints/.fastendpoints-generator-cache
@@ -1 +1 @@
-F8CBB731230F0CFEBBF1D8D68AED70BE0370931E02FC3002C05A132F22E440B4
+54E47863031D3155CCC5026F19E52A93229661D49D199F0E3A6F1CD7CCBE15F8
diff --git a/templates/aot/Source/Generated/FastEndpoints/SerializerContexts.g.cs b/templates/aot/Source/Generated/FastEndpoints/SerializerContexts.g.cs
@@ -1,6 +1,6 @@
 ﻿// <auto-generated />
 // Generated by FastEndpoints.Generator.Cli
-// Generated at: 2026-02-16 17:36:24
+// Generated at: 2026-03-03 11:47:07
 
 #pragma warning disable
 #nullable enable
diff --git a/templates/aot/Source/MyApp.csproj b/templates/aot/Source/MyApp.csproj
@@ -18,11 +18,11 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="FastEndpoints" Version="8.0.1"/>
-        <PackageReference Include="FastEndpoints.Generator" Version="8.0.1" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive"/>
-        <PackageReference Include="FastEndpoints.Security" Version="8.0.1"/>
-        <PackageReference Include="FastEndpoints.Swagger" Version="8.0.1"/>
-        <PackageReference Include="Scalar.AspNetCore" Version="2.12.30"/>
+        <PackageReference Include="FastEndpoints" Version="8.1.0-beta.9"/>
+        <PackageReference Include="FastEndpoints.Generator" Version="8.1.0-beta.9" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive"/>
+        <PackageReference Include="FastEndpoints.Security" Version="8.1.0-beta.9"/>
+        <PackageReference Include="FastEndpoints.Swagger" Version="8.1.0-beta.9"/>
+        <PackageReference Include="Scalar.AspNetCore" Version="2.12.52"/>
     </ItemGroup>
 
     <ItemGroup>
diff --git a/templates/aot/Source/Program.cs b/templates/aot/Source/Program.cs
@@ -19,6 +19,8 @@
 
 await app.ExportSwaggerDocsAndExitAsync("v1");
 
+app.MapGet("/healthy", () => Results.Ok()).ExcludeFromDescription();
+
 app.UseOpenApi(c => c.Path = "/openapi/{documentName}.json");
 app.MapScalarApiReference(o => o.AddDocument("v1"));
 
diff --git a/templates/aot/Source/dotnet-tools.json b/templates/aot/Source/dotnet-tools.json
diff --git a/templates/aot/Tests/App.cs b/templates/aot/Tests/App.cs
@@ -1,28 +1,50 @@
-﻿using Microsoft.AspNetCore.Hosting;
+﻿using System.Text.Json;
+using Microsoft.AspNetCore.Hosting;
 
 namespace Tests.SayHello;
 
 public class App : AppFixture<Program>
 {
     protected override ValueTask SetupAsync()
     {
-        // place one-time setup for the fixture here
+        // place one-time setup for the fixture here.
+
         return ValueTask.CompletedTask;
     }
 
     protected override void ConfigureApp(IWebHostBuilder a)
     {
-        // do host builder configuration here
+        // do host builder configuration here.
+        // only called when running under WAF mode.
     }
 
     protected override void ConfigureServices(IServiceCollection s)
     {
-        // do test service registration here
+        // do test service registration here.
+        // only called when running under WAF mode.
+    }
+
+    protected override ValueTask ConfigureAotTargetAsync(AotTargetOptions o)
+    {
+        // settings for building and running a native aot black-box instance.
+        // all settings are optional. customization only needed if auto management fails.
+
+        o.BuildTimeoutMinutes = 1;
+        o.HealthEndpointPath = "/healthy";
+        o.ReadyTimeoutSeconds = 5;
+        o.EnvironmentVariables["ASPNETCORE_ENVIRONMENT"] = "Testing";
+
+        // make routeless test helpers use the same serializer settings as the app
+
+        new Config().Serializer.Options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
+
+        return ValueTask.CompletedTask;
     }
 
     protected override ValueTask TearDownAsync()
     {
         // do cleanups here
+
         return ValueTask.CompletedTask;
     }
 }
diff --git a/templates/aot/Tests/SayHello/Tests.cs b/templates/aot/Tests/SayHello/Tests.cs
@@ -22,14 +22,16 @@ public async Task Invalid_User_Input()
     [Fact, Priority(2)]
     public async Task Valid_User_Input()
     {
-        var (rsp, res) = await App.Client.POSTAsync<Endpoint, Request, Response>(
-                             new()
-                             {
-                                 FirstName = "Mike",
-                                 LastName = "Kelso"
-                             });
+        var (rsp, res, err) = await App.Client.POSTAsync<Endpoint, Request, Response>(
+                                  new()
+                                  {
+                                      FirstName = "Mike",
+                                      LastName = "Kelso"
+                                  });
+
+        if (!rsp.IsSuccessStatusCode)
+            Assert.Fail(err);
 
-        rsp.StatusCode.ShouldBe(HttpStatusCode.OK);
         res.Message.ShouldBe("Hello Mike Kelso...");
     }
 }
diff --git a/templates/aot/Tests/Tests.csproj b/templates/aot/Tests/Tests.csproj
@@ -7,9 +7,15 @@
         <OutputType>Exe</OutputType>
     </PropertyGroup>
 
+    <!-- do 'dotnet test -p:NativeAotTestMode=true' from the commandline to run the tests in native aot black-box testing mode -->
+    <!-- or change 'true' to '' below to make your ide test runner do aot black-box testing -->
+    <ItemGroup Condition="'$(NativeAotTestMode)' == 'true'">
+        <RuntimeHostConfigurationOption Include="NativeAotTestMode" Value="true"/>
+    </ItemGroup>
+
     <ItemGroup>
-        <PackageReference Include="FastEndpoints.Testing" Version="8.0.1"/>
-        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1"/>
+        <PackageReference Include="FastEndpoints.Testing" Version="8.1.0-beta.9"/>
+        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.3.0"/>
         <PackageReference Include="Shouldly" Version="4.3.0"/>
         <PackageReference Include="xunit.v3" Version="3.2.2"/>
         <PackageReference Include="xunit.runner.visualstudio" Version="3.1.5" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive"/>

Original file line number	Diff line number	Diff line change
`@@ -1 +1,2 @@`
`1`		-- upgrade FastEndpoints to latest `v8.0.1`
	`1`	`+- use dual mode testing for aot project`
	`2`	`+- upgrade FastEndpoints to latest`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-F8CBB731230F0CFEBBF1D8D68AED70BE0370931E02FC3002C05A132F22E440B4`
	`1`	`+54E47863031D3155CCC5026F19E52A93229661D49D199F0E3A6F1CD7CCBE15F8`
Original file line number	Diff line number	Diff line change
`@@ -1,28 +1,50 @@`
`1`		`-using Microsoft.AspNetCore.Hosting;`
	`1`	`+using System.Text.Json;`
	`2`	`+using Microsoft.AspNetCore.Hosting;`
`2`	`3`
`3`	`4`	`namespace Tests.SayHello;`
`4`	`5`
`5`	`6`	`public class App : AppFixture<Program>`
`6`	`7`	`{`
`7`	`8`	`protected override ValueTask SetupAsync()`
`8`	`9`	`{`
`9`		`- // place one-time setup for the fixture here`
	`10`	`+ // place one-time setup for the fixture here.`
	`11`	`+`
`10`	`12`	`return ValueTask.CompletedTask;`
`11`	`13`	`}`
`12`	`14`
`13`	`15`	`protected override void ConfigureApp(IWebHostBuilder a)`
`14`	`16`	`{`
`15`		`- // do host builder configuration here`
	`17`	`+ // do host builder configuration here.`
	`18`	`+ // only called when running under WAF mode.`
`16`	`19`	`}`
`17`	`20`
`18`	`21`	`protected override void ConfigureServices(IServiceCollection s)`
`19`	`22`	`{`
`20`		`- // do test service registration here`
	`23`	`+ // do test service registration here.`
	`24`	`+ // only called when running under WAF mode.`
	`25`	`+ }`
	`26`	`+`
	`27`	`+ protected override ValueTask ConfigureAotTargetAsync(AotTargetOptions o)`
	`28`	`+ {`
	`29`	`+ // settings for building and running a native aot black-box instance.`
	`30`	`+ // all settings are optional. customization only needed if auto management fails.`
	`31`	`+`
	`32`	`+ o.BuildTimeoutMinutes = 1;`
	`33`	`+ o.HealthEndpointPath = "/healthy";`
	`34`	`+ o.ReadyTimeoutSeconds = 5;`
	`35`	`+ o.EnvironmentVariables["ASPNETCORE_ENVIRONMENT"] = "Testing";`
	`36`	`+`
	`37`	`+ // make routeless test helpers use the same serializer settings as the app`
	`38`	`+`
	`39`	`+ new Config().Serializer.Options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;`
	`40`	`+`
	`41`	`+ return ValueTask.CompletedTask;`
`21`	`42`	`}`
`22`	`43`
`23`	`44`	`protected override ValueTask TearDownAsync()`
`24`	`45`	`{`
`25`	`46`	`// do cleanups here`
	`47`	`+`
`26`	`48`	`return ValueTask.CompletedTask;`
`27`	`49`	`}`
`28`	`50`	`}`