Home

Ways to use the toolchain

• Command Line
• NSwagStudio
• MSBuild
• Swagger and Swagger UI OWIN Middleware
• OWIN Middleware in Global.asax
• T4 templates

JSON Schema generator

The NSwag Swagger generator uses the JSON Schema generator from the NJsonSchema project.

• XML Documentation (NJsonSchema)
  • The NSwag.AspNetCore NuGet package automatically installs the required NuGet packages for reading XML Documentation.
• Enums (NJsonSchema)
• Inheritance (NJsonSchema): Add custom properties to the generated JSON objects (e.g. "x-documentation-link").
• Type Mappers (NJsonSchema): Type mappers allow you to generate a custom JSON Schema for a given .NET type.

Classes

Package: NSwag.Core

• SwaggerService

Package: NSwag.CodeGeneration

• Swagger Generators:

  • WebApiToSwaggerGenerator: ASP.NET Web API to Swagger

• Code Generators:

  • SwaggerToTypeScriptClientGenerator: TypeScript Client
  • SwaggerToCSharpClientGenerator: CSharp Client
  • SwaggerToCSharpControllerGenerator: CSharp WebAPI Controllers (contract first/schema first development)

Package: NSwag.AssemblyLoader

• Swagger Generators:
  • WebApiAssemblyToSwaggerGenerator: ASP.NET Web API to Swagger
  • AssemblyTypeToSwaggerGenerator: Types from .NET assemblies