openapi-merge

A very basic tool for combining openapi JSON specifications together. The components/schemas records in each spec are prefixed with the title of the spec to make them unique, then the specs are deep merged, left to right. It doesn't attempt to de-duplicate models across schemas and schemas may be left as orphans if the paths that reference them are overwritten during the merge. If you want to see example input files and their merged output, look at the JSON specs in test/.

This tool can be run with a js runtime (e.g. Bun) or as a standalone CLI tool.

Install bun and dependencies:

Install from https://bun.com/ or use devenv.nix.

bun install

Run with Bun

bun src/cli.ts test/exampleSpecA.json test/exampleSpecB.json test/exampleSpecC.json --title="custom_title" > output.json

Run with CLI tool

Build the CLI tool:

bun build --compile --outfile=openapi-merge-cli ./src/cli.ts

Run the CLI tool:

./openapi-merge-cli test/exampleSpecA.json test/exampleSpecB.json test/exampleSpecC.json --title="custom_title" > output.json