https://github.com/ctyar/nswag.yarp

A package to simplify using NSwag behind YARP.
https://github.com/ctyar/nswag.yarp

Last synced: 20 days ago
JSON representation

A package to simplify using NSwag behind YARP.

• Host: GitHub
• URL: https://github.com/ctyar/nswag.yarp
• Owner: ctyar
• License: mit
• Created: 2024-03-23T19:18:11.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2024-12-12T10:57:38.000Z (about 1 month ago)
• Last Synced: 2024-12-12T11:38:21.410Z (about 1 month ago)
• Language: C#
• Homepage:
• Size: 43 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# NSwag Yarp

[![Build Status](https://ctyar.visualstudio.com/NSwag.Yarp/_apis/build/status%2Fctyar.NSwag.Yarp?branchName=main)](https://ctyar.visualstudio.com/NSwag.Yarp/_build/latest?definitionId=10&branchName=main)

[![Ctyar.NSwag.Yarp](https://img.shields.io/nuget/v/Ctyar.NSwag.Yarp.svg)](https://www.nuget.org/packages/Ctyar.NSwag.Yarp/)

A package to simplify using NSwag behind YARP.

## Usage

1. Add a route for each of your APIs like this:

    ```json

   "route1": {

     "ClusterId": "cluster1",

     "Match": {

       "Path": "/api1/{**catch-all}"

     },

     "Transforms": [

       {

         "PathRemovePrefix": "/api1"

       }

     ]

   }

    ```

    With this configuration, calling `/api1` of your YARP will redirect to your RESTful API.

2. Add `AddYarp()` with the same prefix in your RESTful API:

    ```csharp

    app.UseOpenApi(config =>

    {

        config.AddYarp("/api1");

    });

    app.UseSwaggerUi(config =>

    {

        config.AddYarp("/api1");

    });

    ```

You can check the [samples](/src/samples) directory for a complete working example.

## Build

[Install](https://get.dot.net) the [required](global.json) .NET SDK.

Run:

```

$ dotnet build

```