Add parameterless extension method for creating IApiVersionDescriptionProvider

commonsensesoftware · commonsensesoftware · commit 51033a9ba82a · 2024-03-26T09:52:57.000-07:00
diff --git a/src/AspNetCore/WebApi/src/Asp.Versioning.Http/ApiExplorer/IApiVersionDescriptionProviderFactoryExtensions.cs b/src/AspNetCore/WebApi/src/Asp.Versioning.Http/ApiExplorer/IApiVersionDescriptionProviderFactoryExtensions.cs
@@ -0,0 +1,34 @@
+﻿// Copyright (c) .NET Foundation and contributors. All rights reserved.
+
+namespace Asp.Versioning.ApiExplorer;
+
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Routing;
+using Microsoft.Extensions.Primitives;
+
+/// <summary>
+/// Provides extension methods for <see cref="IApiVersionDescriptionProviderFactory"/>.
+/// </summary>
+[CLSCompliant( false )]
+public static class IApiVersionDescriptionProviderFactoryExtensions
+{
+    /// <summary>
+    /// Creates and returns an API version description provider.
+    /// </summary>
+    /// <param name="factory">The extended <see cref="IApiVersionDescriptionProviderFactory"/>.</param>
+    /// <returns>A new <see cref="IApiVersionDescriptionProvider">API version description provider</see>.</returns>
+    public static IApiVersionDescriptionProvider Create( this IApiVersionDescriptionProviderFactory factory )
+    {
+        ArgumentNullException.ThrowIfNull( factory );
+        return factory.Create( new EmptyEndpointDataSource() );
+    }
+
+    private sealed class EmptyEndpointDataSource : EndpointDataSource
+    {
+        public override IReadOnlyList<Endpoint> Endpoints { get; } = [];
+
+        public override IChangeToken GetChangeToken() => new CancellationChangeToken( CancellationToken.None );
+
+        public override IReadOnlyList<Endpoint> GetGroupedEndpoints( RouteGroupContext context ) => Endpoints;
+    }
+}
