OpenApiGenerator.Cli
0.9.11
See the version list below for details.
dotnet tool install --global OpenApiGenerator.Cli --version 0.9.11
dotnet new tool-manifest # if you are setting up this repo dotnet tool install --local OpenApiGenerator.Cli --version 0.9.11
#tool dotnet:?package=OpenApiGenerator.Cli&version=0.9.11
nuke :add-package OpenApiGenerator.Cli --version 0.9.11
OpenApiGenerator
Allows you to partially (for example, only models) or completely generate a native (without dependencies) C# client sdk according to the OpenAPI specification.
Inspired by NSwag ❤️.
🔥Features🔥
- Uses Incremental Source Generators for efficient generation and caching.
- Detects your TargetFramework and generates optimal code for it (including net6.0/net7.0/net8.0 improvements)
- Supports .Net Framework/.Net Standard
- Does not contain dependencies for modern versions of dotnet
- Only System.Text.Json dependency for .Net Framework/.Net Standard
- Any generated methods provide the ability to pass a CancellationToken
- Allows partial generation (models only) or end points filtering
- Available under MIT license for general users and most organizations
- Uses https://github.com/microsoft/OpenAPI.NET for parsing OpenAPI specification
- Supports nullable enable/trimming/native AOT compilation
- Tested on GitHub 220k lines OpenAPI specification
- Supports OneOf/AnyOf/AllOf/Not schemas
- Supports Enums for System.Text.Json
🚀Quick start🚀
- Install the package
dotnet add package OpenApiGenerator
- Add the following optional settings to your csproj file to customize generation. You can check all settings here:
<ItemGroup Label="OpenApiGenerator">
<AdditionalFiles Include="$(MSBuildThisFileDirectory)../../../docs/openapi.yaml" />
</ItemGroup>
<PropertyGroup Label="OpenApiGenerator">
<OpenApiGenerator_Namespace>Ollama</OpenApiGenerator_Namespace>
<OpenApiGenerator_ClassName>OllamaApi</OpenApiGenerator_ClassName>
<OpenApiGenerator_GenerateSdk>false</OpenApiGenerator_GenerateSdk>
<OpenApiGenerator_GenerateModels>true</OpenApiGenerator_GenerateModels>
<OpenApiGenerator_GenerateMethods>true</OpenApiGenerator_GenerateMethods>
<OpenApiGenerator_GenerateConstructors>true</OpenApiGenerator_GenerateConstructors>
<OpenApiGenerator_IncludeOperationIds>getPet;deletePet</OpenApiGenerator_IncludeOperationIds>
<OpenApiGenerator_ExcludeOperationIds>getPet;deletePet</OpenApiGenerator_ExcludeOperationIds>
<OpenApiGenerator_IncludeModels>Pet;Model</OpenApiGenerator_IncludeModels>
<OpenApiGenerator_ExcludeModels>Pet;Model</OpenApiGenerator_ExcludeModels>
</PropertyGroup>
- It's all! Now you can build your project and use the generated code. You also can use IDE to see the generated code in any moment, this is a example for Rider:
CLI
You can use the CLI to generate the code.
dotnet tool install --global openapigenerator.cli --prerelease
oag --help
oag generate openapi.yaml
It will generate the code in the "openapi" subdirectory.
Trimming support
Since there are two source generators involved, we will have to create a second project so that the generator for the JsonSerializerContext will “see” our models
- Create new project for your models. And disable methods/constructors generation:
<PropertyGroup Label="OpenApiGenerator">
<OpenApiGenerator_GenerateSdk>false</OpenApiGenerator_GenerateSdk>
<OpenApiGenerator_GenerateModels>true</OpenApiGenerator_GenerateModels>
<OpenApiGenerator_GenerateJsonSerializerContextTypes>true</OpenApiGenerator_GenerateJsonSerializerContextTypes>
</PropertyGroup>
- Reference this project in your main project.
- Add
SourceGenerationContext.cs
file to your main project with the following content:
using System.Text.Json.Serialization;
namespace Namespace;
[JsonSourceGenerationOptions(DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull)]
[JsonSerializable(typeof(OpenApiGeneratorTrimmableSupport))]
internal sealed partial class SourceGenerationContext : JsonSerializerContext;
- Add the following settings to your main csproj file:
<PropertyGroup Label="OpenApiGenerator">
<OpenApiGenerator_GenerateSdk>false</OpenApiGenerator_GenerateSdk>
<OpenApiGenerator_GenerateMethods>true</OpenApiGenerator_GenerateMethods>
<OpenApiGenerator_GenerateConstructors>true</OpenApiGenerator_GenerateConstructors>
<OpenApiGenerator_JsonSerializerContext>Namespace.SourceGenerationContext</OpenApiGenerator_JsonSerializerContext>
</PropertyGroup>
- Add these settings to your new and main csproj file to enable trimming(or use Directory.Build.props file):
<PropertyGroup Label="Trimmable" Condition="$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net6.0'))">
<IsAotCompatible>true</IsAotCompatible>
<EnableTrimAnalyzer>true</EnableTrimAnalyzer>
<IsTrimmable>true</IsTrimmable>
<SuppressTrimAnalysisWarnings>false</SuppressTrimAnalysisWarnings>
<TrimmerSingleWarn>false</TrimmerSingleWarn>
</PropertyGroup>
- It's all! Now you can build your project and use the generated code with full trimming/nativeAOT support.
📚Examples of use in real SDKs📚
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
This package has no dependencies.
Version | Downloads | Last updated |
---|---|---|
0.11.9 | 18 | 6/30/2024 |
0.11.8 | 18 | 6/30/2024 |
0.11.7 | 19 | 6/30/2024 |
0.11.6 | 43 | 6/29/2024 |
0.11.4 | 33 | 6/27/2024 |
0.11.3 | 39 | 6/27/2024 |
0.11.1 | 65 | 6/20/2024 |
0.11.0 | 73 | 6/16/2024 |
0.10.8 | 74 | 6/15/2024 |
0.10.7 | 75 | 6/15/2024 |
0.10.6 | 68 | 6/15/2024 |
0.10.4 | 69 | 6/13/2024 |
0.10.2 | 65 | 6/13/2024 |
0.10.1 | 62 | 6/13/2024 |
0.10.0 | 68 | 6/13/2024 |
0.9.12 | 70 | 6/6/2024 |
0.9.11 | 63 | 6/6/2024 |
0.9.10 | 69 | 6/5/2024 |
0.9.9 | 65 | 6/5/2024 |
0.9.8 | 69 | 6/4/2024 |
0.9.7 | 86 | 6/1/2024 |
0.9.5 | 73 | 5/31/2024 |
0.9.4 | 77 | 5/31/2024 |
0.9.3 | 75 | 5/31/2024 |
0.9.1 | 77 | 5/30/2024 |
0.9.0 | 71 | 5/30/2024 |
0.8.8 | 72 | 5/28/2024 |
0.8.6 | 71 | 5/27/2024 |
0.8.5 | 71 | 5/27/2024 |
0.8.4 | 76 | 5/27/2024 |
0.8.3 | 77 | 5/27/2024 |
0.8.1 | 89 | 5/25/2024 |
0.8.0 | 82 | 5/25/2024 |
0.7.2 | 81 | 5/23/2024 |
0.7.1 | 77 | 5/22/2024 |
0.7.0 | 83 | 5/22/2024 |
0.6.9 | 76 | 5/22/2024 |
0.6.8 | 75 | 5/21/2024 |
0.6.7 | 79 | 5/21/2024 |
0.6.6 | 77 | 5/19/2024 |
0.6.5 | 73 | 5/19/2024 |
0.6.4 | 68 | 5/19/2024 |
0.6.3 | 72 | 5/19/2024 |
0.6.2 | 72 | 5/19/2024 |
0.6.1 | 72 | 5/19/2024 |
0.6.0 | 71 | 5/19/2024 |
0.5.0 | 79 | 5/19/2024 |
0.4.0 | 80 | 5/19/2024 |
0.3.2 | 70 | 5/13/2024 |
0.3.1 | 65 | 5/13/2024 |
0.3.0 | 60 | 5/13/2024 |
0.2.0 | 66 | 5/11/2024 |
⭐ Last 10 features:
- feat: Added JsonSerializerContextConverters generation. 2024-06-05
- feat: Released 0.9.9. 2024-06-05
- feat: Added ability to pass JsonSerializerOptions. 2024-06-05
- feat: Added AnyOf/OneOf Object property. 2024-06-04
- feat: Added Enum support for System.Text.Json. 2024-05-30
- feat: Added AnyOf/OneOf/AllOf generation. 2024-05-29
- feat: Released 0.8.5. 2024-05-27
- feat: Sanitize Property Names (#16) 2024-05-27
- feat: Added OneOf support for System.Text.Json. 2024-05-26
- feat: Added AnyOf and tests. 2024-05-26
🐞 Last 10 bug fixes:
- fix: Fixed JsonSerializerContextConverters generation. 2024-06-06
- fix: Fixed bug with nullable enums. 2024-06-05
- fix: EnumExtension.ToEnum now will return null instead ArgumentOutOfRangeException. 2024-06-05
- fix: Fixed bug with missing settings inside AnyOf JsonConverter. 2024-06-04
- fix: Fixed missing xml docs for AnyOf types. 2024-06-04
- fix: Added some missing AnyOf/OneOf models from parameters. 2024-06-04
- fix: Fixed issue with 'content' parameter name. 2024-06-04
- fix: Fixed bug with AnyOf/OneOf in parameters. 2024-06-01
- fix: Fixed keywords in parameter names. 2024-06-01
- fix: Fixed JsonSerializerContext array types. 2024-05-31