{"repo":"martincostello/openapi-extensions","free":true,"listed":false,"github":"https://github.com/martincostello/openapi-extensions","clone":"git clone https://github.com/martincostello/openapi-extensions.git","description":"Extensions for Microsoft.AspNetCore.OpenApi","language":"C#","stars":104,"topics":["aspnetcore","dotnet","openapi"],"license":"Apache-2.0","category":"api-integrations-sdks","readme_excerpt":"OpenAPI Extensions for ASP.NET Core [![NuGet][package-badge-version]][package-download] [![NuGet Downloads][package-badge-downloads]][package-download] [![Build status][build-badge]][build-status] [![codecov][coverage-badge]][coverage-report] [![OpenSSF Scorecard][scorecard-badge]][scorecard-report] Introduction A NuGet package of extensions for the [Microsoft.AspNetCore.OpenApi][aspnetcore-openapi] package. Features include: - Adding examples to OpenAPI operations and schemas. - Customizing descriptions for: - OpenAPI operation parameters and responses; - OpenAPI schemas and their properties. - Adding application URLs to the OpenAPI document. - Adding OpenAPI schema documentation from XML comments. - Adding an HTTP endpoint to get OpenAPI documents as YAML. The library is also designed to be compatible with support for [native AoT][aspnetcore-native-aot] in ASP.NET Core 9. There is also [a sample application using the library][sample-app]. An overview of the library and how it works can be found on YouTube in this talk from .NET Conf 2024: [📺 Extending ASP.NET Core OpenAPI ][dotnet-conf] Installation To install the library from [NuGet][package-download] using the .NET SDK run the following command: Usage Below is an example code snippet showing how to use the features of the library: Building and Testing Compiling the application yourself requires Git and the [.NET SDK][dotnet-sdk] to be installed. To build and test the application locally from a terminal/command-line, run ","default_branch":null,"files":null,"tree":[],"storefront":"/r/martincostello","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/martincostello/openapi-extensions/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}