🧬 Swagger Merger

A simple CLI tool to merge multiple Swagger (OpenAPI) YAML and JSON files into a single spec.

🚀 Features

• Merge two or more Swagger files into one
• Supports overwrite logic based on file order
• Ideal for modular API definitions

🛠️ Installation

Make sure you have Go installed, then run:

go install github.com/g3co/go-swagger-merger

Check twice if Go's binary is included in PATH:

A. Linux/MacOS

Find ~/.zshrc (MacOS) or ~/.bashrc (Linux) and add following:

export PATH="$HOME/go/bin:$PATH"

B. Windows

Although Go installer on Windows automatically adds itself to PATH, in case go install is unresolved, add following to Environment Variables (System):

C:\Program Files\Go\bin

📦 Usage

Merge two or more Swagger files into one:

go-swagger-merger -o /data/swagger.yaml /data/swagger1.yaml /data/swagger2.json

You can add as many input files as needed — supported formats include .yaml, .yml, and .json:

go-swagger-merger -o /data/swagger.json /data/swagger1.yaml /data/swagger2.yaml /data/swagger3.yaml

⚠️ Note: File order matters. Later files will overwrite conflicting fields from earlier ones.

🧪 Quick Test

Test assets are available in the repository to quickly try out the merger