OpenAPITools / openapi-generator

OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
https://openapi-generator.tech
Apache License 2.0
21.15k stars 6.41k forks source link

[REQ] Expose "fullyResolve" & "flatten" of the "swagger-parser" to CLI #11831

Open chatelao opened 2 years ago

chatelao commented 2 years ago

Is your feature request related to a problem? Please describe.

Describe the solution you'd like

The Swagger-Parser has three nice options:

  1. setResolveFully
  2. flatten
  3. resolveCombinators

Exposing this transformations as possible "preprocessing" parameters should be cheap "IMHO" :-).

Describe alternatives you've considered

Additional context

zontarian commented 1 year ago

I'd like very much to resolve every $ref inside the definition, since I have a client (I mean the human being) who cannot "follow" the references and needs something easier to read and document.