Hlibz.OpenApi.AspNetCore
1.0.0-preview.1
This is a prerelease version of Hlibz.OpenApi.AspNetCore.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package Hlibz.OpenApi.AspNetCore --version 1.0.0-preview.1
NuGet\Install-Package Hlibz.OpenApi.AspNetCore -Version 1.0.0-preview.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Hlibz.OpenApi.AspNetCore" Version="1.0.0-preview.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Hlibz.OpenApi.AspNetCore" Version="1.0.0-preview.1" />
<PackageReference Include="Hlibz.OpenApi.AspNetCore" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Hlibz.OpenApi.AspNetCore --version 1.0.0-preview.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Hlibz.OpenApi.AspNetCore, 1.0.0-preview.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Hlibz.OpenApi.AspNetCore@1.0.0-preview.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Hlibz.OpenApi.AspNetCore&version=1.0.0-preview.1&prerelease
#tool nuget:?package=Hlibz.OpenApi.AspNetCore&version=1.0.0-preview.1&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
![]()
Hlibz.OpenApi.AspNetCore
Transformers for Microsoft.AspNetCore.OpenApi (AddOpenApi() / MapOpenApi()), for .NET 10
and 11.
dotnet add package Hlibz.OpenApi.AspNetCore
using Hlibz.OpenApi;
builder.Services.AddOpenApi("v1", options => options
.AddOpenApiRules() // custom validation attributes describe themselves (IOpenApiRule)
.AddStronglyTypedIds() // CountryId(Guid Value) → { "type": "string", "format": "uuid" }
.AddValidationProblems() // the 400 AddValidation() answers with, where it can
.AddBearerSecurity() // a lock on exactly the endpoints that require authorization
.AddDescriptionCleanup()); // "Gets or sets the name." → "The name."
Several documents, one per endpoint group (WithGroupName(...)), configured once:
IReadOnlyList<OpenApiDocumentDefinition> documents = builder.Services.AddOpenApiDocuments(
[new("locations", "Locations"), new("locations-admin", "LocationsAdmin", "Locations (Admin)")],
(services, name, configure) => services.AddOpenApi(name, configure),
options => options.AddBearerSecurity());
For XML <summary> comments, reference Microsoft.AspNetCore.OpenApi directly in the app and
turn on GenerateDocumentationFile: the comments come from a source generator in that package,
which doesn't flow through this one.
Related packages
- Hlibz.MinimalApi.Endpoints:
minimal API endpoints as classes, each class's
<summary>its operation description. The sample is built on it. - Hlibz.Results.AspNetCore: one error body for minimal APIs and controllers.
Full documentation and a sample: github.com/hlib-zinchenko/Hlibz.OpenApi.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. net11.0 is compatible. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- Microsoft.AspNetCore.OpenApi (>= 10.0.14)
-
net11.0
- Microsoft.AspNetCore.OpenApi (>= 11.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0 | 72 | 11/18/2026 |
| 1.0.0-preview.6 | 49 | 11/17/2026 |
| 1.0.0-preview.5 | 63 | 11/14/2026 |
| 1.0.0-preview.4 | 53 | 11/14/2026 |
| 1.0.0-preview.3 | 60 | 11/13/2026 |
| 1.0.0-preview.2 | 58 | 11/13/2026 |
| 1.0.0-preview.1 | 61 | 11/13/2026 |