RicoSuter/NSwag

one liner to host the client generation as a service

Open

#313 opened on Sep 28, 2016

View on GitHub
 (4 comments) (2 reactions) (0 assignees)C# (6,291 stars) (1,189 forks)batch import
help wantedproject: NSwag.CodeGenerationtype: enhancement

Description

not sure if this is in the plan (haven't really look into how this tool works) but from the front page, we need to write our own code to generate the client one controller at a time. just wondering if this tool can work like swagger, with minimum config, the consumer can point to a url e.g /client to download a client of the negotiate type, c#, ts, etc.

just a thoguht.

Contributor guide

Tech stack
csharptypescript
Domain
backendapi
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
4
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
3-5 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
unclear
Prerequisites
NSwag client generation basicsASP.NET Core middlewareHTTP service design
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
20
Research direction
Investigate how NSwag currently generates clients and where to add a hosting endpoint. Look at the OWIN or ASP.NET Core infrastructure in the codebase to serve generated clients. Consider adding a controller or middleware that exposes a download URL for client code.