Web/ForgeTrust.Runnable.Web.OpenApi/README.md

ForgeTrust.Runnable.Web.OpenApi

ForgeTrust.Runnable.Web.OpenApi

This package provides a modular integration for OpenAPI (Swagger) document generation in Runnable web applications.

Overview

The RunnableWebOpenApiModule simplifies the configuration of OpenAPI by:

  • Registering the necessary services via AddOpenApi.
  • Configuring the EndpointsApiExplorer.
  • Automatically mapping the OpenAPI documentation endpoints.
  • Providing default document and operation transformers to clean up and brand the generated documentation based on the StartupContext.

Usage

To enable OpenAPI support in your application, add the RunnableWebOpenApiModule as a dependency in your root module:

public class MyModule : IRunnableWebModule
{
    public void RegisterDependentModules(ModuleDependencyBuilder builder)
    {
        builder.AddModule<RunnableWebOpenApiModule>();
    }
    
    // ...
}

Features

  • Document Transformation: Automatically updates the API title and tags based on the application name defined in the StartupContext.
  • Automatic Endpoint Mapping: Calls endpoints.MapOpenApi() for you during the endpoint configuration phase.

📂 Back to Web List | 🏠 Back to Root