Denormalize YAML / JSON - All references resolved

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.43k stars 6.48k forks source link

Denormalize YAML / JSON - All references resolved #848

Open chatelao opened 6 years ago

chatelao commented 6 years ago

Description

A generator to resolve all reference into a new JSON/YAML to simplify 1:1 comparision after refactoring.

openapi-generator version

Suggest a fix/enhancement

Allow any OpenAPI specification to be denormalized (and maybe normalized too)
Adding version comparison / diff to the tooling

jmini commented 6 years ago

Allow any OpenAPI specification to be denormalized (and maybe normalized too)

Maybe we could add this as option to the existing yaml generator we have.

Adding version comparison / diff to the tooling

Not sure what you mean by this.

An other approach to perform diff on OpenAPI spec might be to use OpenAPI-diff.

When you say normalized/denormalized, you mean inline schema vs referenced schema in components/schemas section?

chatelao commented 6 years ago

Thanks for all the great hints. Yes inlining everything to compare after a refactoring.