[release/6.0] Add support for minimal APIs in ApiDescription.Server

src/Tools/Extensions.ApiDescription.Server/src/Microsoft.Extensions.ApiDescription.Server.csproj

@@ -3,7 +3,7 @@
 
  <PropertyGroup>
  <!-- Included primarily to ensure dotnet-getdocument and GetDocument.Insider can be referenced. -->
- <TargetFrameworks>netcoreapp2.1;$(DefaultNetFxTargetFramework)</TargetFrameworks>
+ <TargetFrameworks>netcoreapp2.1;$(DefaultNetCoreTargetFramework);$(DefaultNetFxTargetFramework)</TargetFrameworks>
 
  <Description>MSBuild tasks and targets for build-time Swagger and OpenApi document generation</Description>
  <DisableImplicitFrameworkReferences>true</DisableImplicitFrameworkReferences>
@@ -19,12 +19,16 @@
  because publish output matches what was built.
  -->
  <Reference Include="dotnet-getdocument"
- Targets="Publish"
- ReferenceOutputAssembly="false"
- SkipGetTargetFrameworkProperties="true"
- UndefineProperties="TargetFramework;TargetFrameworks;RuntimeIdentifier;PublishDir" />
- <Reference Include="GetDocument.Insider" ReferenceOutputAssembly="false">
- <Targets Condition=" '$(TargetFramework)' == 'netcoreapp2.1' ">Publish</Targets>
+ Condition=" '$(TargetFramework)' != '$(DefaultNetFxTargetFramework)' "
+ Targets="Publish"
+ Private="false"
+ ReferenceOutputAssembly="false"
+ SkipGetTargetFrameworkProperties="true" />
+ <Reference Include="GetDocument.Insider"
+ Private="false"
+ ReferenceOutputAssembly="false"
+ SkipGetTargetFrameworkProperties="true">
+ <Targets Condition=" '$(TargetFramework)' != '$(DefaultNetFxTargetFramework)' ">Publish</Targets>
  </Reference>
  </ItemGroup>
 

src/Tools/Extensions.ApiDescription.Server/src/Microsoft.Extensions.ApiDescription.Server.nuspec

@@ -12,5 +12,6 @@
  <file src="$artifactsBinDir$\GetDocument.Insider\$configuration$\net461\*.*" target="tools\net461" />
  <file src="$artifactsBinDir$\GetDocument.Insider\x86\$configuration$\net461\*.*" target="tools\net461-x86" />
  <file src="$artifactsBinDir$\GetDocument.Insider\$configuration$\netcoreapp2.1\publish\*.*" target="tools\netcoreapp2.1" />
+ <file src="$artifactsBinDir$\GetDocument.Insider\$configuration$\net6.0\publish\*.*" target="tools\net6.0" />
  </files>
 </package>

src/Tools/GetDocumentInsider/src/Commands/GetDocumentCommand.cs

@@ -5,7 +5,7 @@
 using System.IO;
 using System.Linq;
 using System.Reflection;
-#if NETCOREAPP2_1
+#if NETCOREAPP
 using System.Runtime.Loader;
 #endif
 using Microsoft.Extensions.CommandLineUtils;
@@ -69,7 +69,7 @@ protected override int Execute()
  }
  }
 
-#if NETCOREAPP2_1
+#if NETCOREAPP
  AssemblyLoadContext.Default.Resolving += (loadContext, assemblyName) =>
  {
  var name = assemblyName.Name;

src/Tools/GetDocumentInsider/src/Commands/GetDocumentCommandWorker.cs

@@ -2,13 +2,20 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System;
+using System.Collections;
 using System.Collections.Generic;
 using System.IO;
 using System.Reflection;
 using System.Text;
+using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Hosting;
 using Microsoft.Extensions.Tools.Internal;
+#if NET6_0_OR_GREATER
+using Microsoft.AspNetCore.Hosting.Server;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.AspNetCore.Http.Features;
+#endif
 
 namespace Microsoft.Extensions.ApiDescription.Tool.Commands
 {
@@ -53,6 +60,88 @@ public int Process()
  return 3;
  }
 
+ #if NET6_0_OR_GREATER
+ // Register no-op implementations of IServer and IHostLifetime
+ // to prevent the application server from actually launching after build.
+ void ConfigureHostBuilder(object hostBuilder)
+ {
+ ((IHostBuilder)hostBuilder).ConfigureServices((context, services) =>
+ {
+ services.AddSingleton<IServer, NoopServer>();
+ services.AddSingleton<IHostLifetime, NoopHostLifetime>();
+ });
+ }
+
+ // Register a TCS to be invoked when the entrypoint (aka Program.Main)
+ // has finished running. For minimal APIs, this means that all app.X
+ // calls about the host has been built have been executed.
+ var waitForStartTcs = new TaskCompletionSource<object>(TaskCreationOptions.RunContinuationsAsynchronously);
+ void OnEntryPointExit(Exception exception)
+ {
+ // If the entry point exited, we'll try to complete the wait
+ if (exception != null)
+ {
+ waitForStartTcs.TrySetException(exception);
+ }
+ else
+ {
+ waitForStartTcs.TrySetResult(null);
+ }
+ }
+
+ // Resolve the host factory, ensuring that we don't stop the
+ // application after the host has been built.
+ var factory = HostFactoryResolver.ResolveHostFactory(assembly,
+ stopApplication: false,
+ configureHostBuilder: ConfigureHostBuilder,
+ entrypointCompleted: OnEntryPointExit);
+
+ if (factory == null)
+ {
+ _reporter.WriteError(Resources.FormatMethodsNotFound(
+ HostFactoryResolver.BuildWebHost,
+ HostFactoryResolver.CreateHostBuilder,
+ HostFactoryResolver.CreateWebHostBuilder,
+ entryPointType));
+
+ return 8;
+ }
+
+ try
+ {
+ // Retrieve the service provider from the target host.
+ var services = ((IHost)factory(new[] { $"--{HostDefaults.ApplicationKey}={assemblyName}" })).Services;
+ if (services == null)
+ {
+ _reporter.WriteError(Resources.FormatServiceProviderNotFound(
+ typeof(IServiceProvider),
+ HostFactoryResolver.BuildWebHost,
+ HostFactoryResolver.CreateHostBuilder,
+ HostFactoryResolver.CreateWebHostBuilder,
+ entryPointType));
+
+ return 9;
+ }
+
+ // Wait for the application to start to ensure that all configurations
+ // on the WebApplicationBuilder have been processed.
+ var applicationLifetime = services.GetRequiredService<IHostApplicationLifetime>();
+ using (var registration = applicationLifetime.ApplicationStarted.Register(() => waitForStartTcs.TrySetResult(null)))
+ {
+ waitForStartTcs.Task.Wait();
+ var success = GetDocuments(services);
+ if (!success)
+ {
+ return 10;
+ }
+ }
+ }
+ catch (Exception ex)
+ {
+ _reporter.WriteError(ex.ToString());
+ return 11;
+ }
+ #else
  try
  {
  var serviceFactory = HostFactoryResolver.ResolveServiceProviderFactory(assembly);
@@ -91,6 +180,7 @@ public int Process()
  _reporter.WriteError(ex.ToString());
  return 7;
  }
+ #endif
 
  return 0;
  }
@@ -303,5 +393,22 @@ private object InvokeMethod(MethodInfo method, object instance, object[] argumen
 
  return result;
  }
+
+ #if NET6_0_OR_GREATER
+ private sealed class NoopHostLifetime : IHostLifetime
+ {
+ public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+ public Task WaitForStartAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+ }
+
+ private sealed class NoopServer : IServer
+ {
+ public IFeatureCollection Features { get; } = new FeatureCollection();
+ public void Dispose() { }
+ public Task StartAsync<TContext>(IHttpApplication<TContext> application, CancellationToken cancellationToken) => Task.CompletedTask;
+ public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+
+ }
+ #endif
  }
 }

src/Tools/GetDocumentInsider/src/GetDocument.Insider.csproj

@@ -5,14 +5,19 @@
  <IsPackable>false</IsPackable>
  <OutputType>Exe</OutputType>
  <RootNamespace>Microsoft.Extensions.ApiDescription.Tool</RootNamespace>
- <TargetFrameworks>netcoreapp2.1;$(DefaultNetFxTargetFramework)</TargetFrameworks>
+ <TargetFrameworks>netcoreapp2.1;$(DefaultNetCoreTargetFramework);$(DefaultNetFxTargetFramework)</TargetFrameworks>
  <IsShippingPackage>false</IsShippingPackage>
  </PropertyGroup>
 
  <ItemGroup Condition="'$(TargetFramework)' == '$(DefaultNetFxTargetFramework)'">
  <Reference Include="Microsoft.CSharp" />
  </ItemGroup>
 
+ <ItemGroup Condition="'$(TargetFramework)' == '$(DefaultNetCoreTargetFramework)'">
+ <Reference Include="Microsoft.AspNetCore.Hosting.Server.Abstractions" />
+ <Reference Include="Microsoft.Extensions.Hosting.Abstractions" />
+ </ItemGroup>
+
  <ItemGroup>
  <PackageReference Include="System.Diagnostics.DiagnosticSource" Version="4.6.0">
  <AllowExplicitReference>true</AllowExplicitReference>

src/Tools/dotnet-getdocument/src/Commands/InvokeCommand.cs

@@ -79,9 +79,16 @@ protected override int Execute()
  projectName,
  targetFramework.Version));
  }
+ else if (targetFramework.Version >= new Version(6, 0))
+ {
+ toolsDirectory = Path.Combine(thisPath, $"net{targetFramework.Version}");
+ }
+ else
+ {
+ toolsDirectory = Path.Combine(thisPath, "netcoreapp2.1");
+ }
 
  executable = DotNetMuxer.MuxerPathOrDefault();
- toolsDirectory = Path.Combine(thisPath, "netcoreapp2.1");
 
  args.Add("exec");
  args.Add("--depsFile");

src/Tools/dotnet-getdocument/src/dotnet-getdocument.csproj

@@ -5,7 +5,7 @@
  <IsPackable>false</IsPackable>
  <OutputType>Exe</OutputType>
  <RootNamespace>Microsoft.Extensions.ApiDescription.Tool</RootNamespace>
- <TargetFramework>netcoreapp2.1</TargetFramework>
+ <TargetFrameworks>netcoreapp2.1;$(DefaultNetCoreTargetFramework)</TargetFrameworks>
  <UseAppHost>false</UseAppHost>
  <IsShippingPackage>false</IsShippingPackage>
  </PropertyGroup>