Lots of OpenAPI specifications are exploded out across lots of different files. This is great for maintainability,
but not so great for portability.
Many OpenAPI tools do not support exploded / multi-file OpenAPI specifications.
Loading and locating references can be tricky, particularly when they are spread across local or remote file systems,
so lots of tools just give up on trying to locate references and just ask for a single monolithic file.
Local references (references inside the root document) are not bundled, They stay in place.
Bundle an OpenAPI specification
Circular References will be ignored when bundling.
bundle supports the following flags
|Disable color and style console output (useful for CI/CD)
stdin instead of reading OpenAPI spec from a file
stdout instead of writing report to a file
|Base filepath or URL to external references
Read more here: Source link