Stenn.AspNetCore.Versioning.MSBuild.Swashbuckle 6.0.0

MSBuild target to run Swashbuckle cli for generate open api specification

This package contains MSBuild target SwaggerGen_GenerateOpenApi to run Swashbuckle cli for generate open api specification during building ASP.Net Core project

Prerequisites

• Swashbuckle Gen must be configured for ASP.NET Core project
• Swashbuckle cli must be installed as a tool for dotnet cli

Configuration

• Add ApiVersions.props file to project's root folder with next content

<Project>

    <PropertyGroup>

        <RunSwaggerGen>True</RunSwaggerGen>

        <SwaggerGenOutputDirectory>open-api</SwaggerGenOutputDirectory>

        <SwaggerGenOutputDirectoryRecreate>True</SwaggerGenOutputDirectoryRecreate>

        <SwaggerGenJsonOutput>True</SwaggerGenJsonOutput>

        <SwaggerGenYamlOutput>False</SwaggerGenYamlOutput>

        <SwaggerGenFileNamePrefix>$(MSBuildProjectName).openapi.</SwaggerGenFileNamePrefix>
    </PropertyGroup>
    
    <ItemGroup>

        <Folder Include="$(SwaggerGenOutputDirectory)"/>
    </ItemGroup>
    
    <ItemGroup>

        <ApiVersion Include="v1" Major="1" Minor="0" Depricated="false" IsDefault="true" />
    </ItemGroup>
    
</Project>

I failed to found a way how to copy file during nuget package installation. If you know a way, please share it with me

• Add ApiVersion for every api version in ASP.NET core project

  For Swashbuckle cli only Include is metter in ApiVersion item. Other item's metadata value for versioning source generator

##Result

After building the project you will find open api specs file(s) in $(ProjectDirectory)$(SwaggerGenOutputDirectory) destination