Expose a way to get the list of documents on ISwaggerProvider

[sandorfr]

Currently, there is no way to retrieve the list of documents which means that you need to know it's name before hand.

It would be nice to add an Api to get the list of available documents string[] ISwaggerProvider.GetSwaggerDocumentNames()

Are you willing to accept a PR for that?

[sandorfr]

It would also allow most people to get rid of that kind of redundant code:

UseSwaggerUI(options =>
            {
                options.SwaggerEndpoint("/swagger/All-1.0/swagger.json", "API 1.0");
                options.SwaggerEndpoint("/swagger/Security-1.0/swagger.json", "Security API 1.0");
                options.SwaggerEndpoint("/swagger/All-1.1/swagger.json", "API 1.1");
                options.SwaggerEndpoint("/swagger/Security-1.1/swagger.json", "Security API 1.1");
            });

[sandorfr]

@domaindrivendev is that a contribution you would accept?

[Marusyk]

Hello @sandorfr,
You can create a simple extension method for that

public static class SwaggerUIOptionsExtensions
{
    public static void AddSwaggerUIEndpoints(this SwaggerUIOptions options, IDictionary<string, string> endpoints)
    {
        foreach (var endpoint in endpoints)
        {
            options.SwaggerEndpoint(endpoint.Key, endpoint.Value);
        }
    }
}

and use it in Startup like

app.UseSwagger().UseSwaggerUI(c =>
{
	c.AddSwaggerUIEndpoints(endpoints);
});

Where endpoints is key value pair of url and name

[sandorfr]

@Marusyk that's not only for that specific case but also to use in other libraries. The goal is to avoid hacking around and have the proper APIs to implement elegant solutions.