Initial analysis of Aspire Single-File AppHost template implementation

Copilot · mitchdenny · mitchdenny · commit fe2cddd54e78 · 2025-09-17T08:37:38.000+10:00
Co-authored-by: mitchdenny &lt;513398+mitchdenny@users.noreply.github.com&gt;
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.cs.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.cs.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.de.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.de.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.en.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.en.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.es.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.es.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.fr.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.fr.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.it.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.it.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.ja.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.ja.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.ko.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.ko.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.pl.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.pl.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.pt-BR.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.pt-BR.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.ru.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.ru.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.tr.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.tr.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.zh-Hans.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.zh-Hans.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.zh-Hant.json b/src/Aspire.ProjectTemplates/templates/aspire-apphost-singlefile/.template.config/localize/templatestrings.zh-Hant.json
@@ -0,0 +1,12 @@
+{
+  "author": "Microsoft",
+  "name": "Aspire Single-File App Host",
+  "description": "A minimal Aspire AppHost for single-file scenarios (Aspire 9.5+, .NET 10+).",
+  "symbols/Framework/choices/net10.0/description": "Target net10.0",
+  "symbols/AspireVersionCli/description": "Aspire version",
+  "symbols/AspireVersionCli/choices/9.5/displayName": "9.5",
+  "symbols/AspireVersionCli/choices/9.5/description": "Aspire 9.5",
+  "symbols/skipRestore/description": "If specified, skips the automatic restore after creation.",
+  "postActions/restore/description": "Restore NuGet packages required by this project.",
+  "postActions/restore/manualInstructions/default/text": "Run 'dotnet restore'"
+}
diff --git a/tests/Aspire.Cli.Tests/Commands/SingleFileAppHostTemplateTests.cs b/tests/Aspire.Cli.Tests/Commands/SingleFileAppHostTemplateTests.cs
@@ -0,0 +1,69 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Xunit;
+
+namespace Aspire.Cli.Tests.Commands;
+
+public class SingleFileAppHostTemplateTests
+{
+    [Fact]
+    public void GetTemplates_WhenSingleFileAppHostFeatureDisabled_DoesNotIncludeSingleFileTemplate()
+    {
+        // Arrange
+        var factory = new Aspire.Cli.Templating.DotNetTemplateFactory(
+            interactionService: null!,
+            runner: null!,
+            certificateService: null!,
+            packagingService: null!,
+            prompter: null!,
+            executionContext: null!,
+            features: new TestFeatures(singleFileAppHostEnabled: false));
+
+        // Act
+        var templates = factory.GetTemplates().ToList();
+
+        // Assert
+        Assert.DoesNotContain(templates, t => t.Name == "aspire-apphost-singlefile");
+    }
+
+    [Fact]
+    public void GetTemplates_WhenSingleFileAppHostFeatureEnabled_IncludesSingleFileTemplate()
+    {
+        // Arrange
+        var factory = new Aspire.Cli.Templating.DotNetTemplateFactory(
+            interactionService: null!,
+            runner: null!,
+            certificateService: null!,
+            packagingService: null!,
+            prompter: null!,
+            executionContext: null!,
+            features: new TestFeatures(singleFileAppHostEnabled: true));
+
+        // Act
+        var templates = factory.GetTemplates().ToList();
+
+        // Assert
+        Assert.Contains(templates, t => t.Name == "aspire-apphost-singlefile");
+    }
+
+    private sealed class TestFeatures : Aspire.Cli.Configuration.IFeatures
+    {
+        private readonly bool _singleFileAppHostEnabled;
+
+        public TestFeatures(bool singleFileAppHostEnabled)
+        {
+            _singleFileAppHostEnabled = singleFileAppHostEnabled;
+        }
+
+        public bool IsFeatureEnabled(string featureFlag, bool defaultValue)
+        {
+            if (featureFlag == Aspire.Cli.KnownFeatures.SingleFileAppHostEnabled)
+            {
+                return _singleFileAppHostEnabled;
+            }
+            
+            return defaultValue;
+        }
+    }
+}
diff --git a/tests/Aspire.Cli.Tests/Utils/CliTestHelper.cs b/tests/Aspire.Cli.Tests/Utils/CliTestHelper.cs
@@ -295,7 +295,8 @@ public IProjectLocator CreateDefaultProjectLocatorFactory(IServiceProvider servi
         var packagingService = serviceProvider.GetRequiredService<IPackagingService>();
         var prompter = serviceProvider.GetRequiredService<INewCommandPrompter>();
         var executionContext = serviceProvider.GetRequiredService<CliExecutionContext>();
-        var factory = new DotNetTemplateFactory(interactionService, runner, certificateService, packagingService, prompter, executionContext);
+        var features = serviceProvider.GetRequiredService<IFeatures>();
+        var factory = new DotNetTemplateFactory(interactionService, runner, certificateService, packagingService, prompter, executionContext, features);
         return new TemplateProvider([factory]);
     };
 
