oaimerge loads an openapi yaml specification (eventually from multiple files), applies a variable interpolation and merges everything into a single openapi json. Additional checks or linting rules are not applied.
For example, if you want to use external descriptions (e.g. because you have used xtractdoc), there is currently no support from the OpenAPI specification. See also the following related tickets:
See also RFC3986. In contrast to the official OAI spec, $ref is allowed anywhere, only limited by the yaml grammar.
go install github.com/worldiety/oaimerge/cmd/oaimerge@latest
oaimerge -oai=openapi.yaml > mergedoai.json- supports only local relative yaml files. There is no generic URI or URL support
- string interpolation works only for inline strings of the form
$ref{filename#/wdy.de-my/jsonptr}