RicoSuter/NSwag

Features

• OpenAPI Toolchains - Provides an integrated tool suite for generating OpenAPI specifications and synthesizing client and server code for .NET.
• API Client Generators - Provides tools to automatically generate type-safe client code from OpenAPI specifications to ensure consistent data structures.
• Server Stub Generation - Creates boilerplate server-side code and routing logic from API specifications to enable contract-first development.
• API Code Generators - Automatically produces server stubs and controller classes from API interface definitions.
• API-First Development Toolsets - Offers a comprehensive toolset for defining API contracts and generating the corresponding server and client boilerplate.
• OpenAPI Specification Generators - Generates structured OpenAPI documentation from .NET controllers to define data contracts for external consumers.
• Template-Based Code Generators - Uses predefined patterns to transform API specifications into typed client libraries and server controller stubs.
• OpenAPI Specification Extraction - Analyzes .NET assembly types and controller attributes at runtime to automatically extract and produce OpenAPI specifications.
• Schema-to-Type Mappers - Automates the creation of typed data models by converting JSON schema definitions into native language classes.
• Type-Safe Client Generators - Produces type-safe client libraries and data transfer objects from an OpenAPI specification.
• API Documentation Hosting - Hosts interactive OpenAPI documentation and specifications to provide a browsable map of available service endpoints.
• OpenAPI to TypeScript Converters - Transforms OpenAPI specifications into type-safe TypeScript client libraries and interfaces for frontend integration.
• OpenAPI CLI Management Tools - Offers a command-line interface to export OpenAPI documents based on configuration files for automated workflows.
• OpenAPI Specification Parsers - Parses OpenAPI JSON and YAML definitions from URLs or strings into structured internal representations.
• Toolchain Execution Engines - Executes complex specification and code generation sequences through a command-line interface or package manager.
• Build Pipeline Integrations - Provides command-line tools that can be integrated into build pipelines to keep clients and specs synchronized.
• Middleware-Based Request Pipelines - Provides a modular pipeline to intercept and modify outgoing HTTP requests and incoming responses for logging and error handling.
• HTTP Authentication Schemes - Defines authentication requirements for API operations using standard schemes like OAuth2, API Keys, and JWT Bearer tokens.
• Configuration Workflows - Implements an architectural pattern where generation tasks are defined and executed via structured JSON configuration files.
• Generator Configuration Tools - Provides a visual GUI for managing and customizing the settings of the code generation engine.
• Schema-to-Code Generators - Generates typed source code implementations from declarative JSON schema definitions to automate data model creation.
• API Documentation - Provides interactive interfaces for exploring and testing backend service endpoints through hosted OpenAPI documentation.
• API Endpoint Metadata - Allows attachment of structural and descriptive metadata to routes via attributes for API documentation.
• OpenAPI Response Definitions - Generates JSON schemas for data objects and specifies response types to document the API data contract.
• Configuration-Driven Generators - Automates the generation process using predefined instructions stored in JSON configuration documents.
• OpenAPI Specification Generators - Automatically derives OpenAPI specifications from .NET assembly types and controller metadata.
• Core .NET Libraries - Toolchain for OpenAPI generation and client code creation.

Star history