Skip to content

Java application to merge multiple swagger specs into one

License

Notifications You must be signed in to change notification settings

ai-traders/swagger-composer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

67995fb · Feb 13, 2019

History

11 Commits
Nov 22, 2016
Nov 22, 2016
Nov 22, 2016
Nov 21, 2016
Nov 21, 2016
Nov 22, 2016
Nov 22, 2016
Nov 22, 2016
Feb 13, 2019
Nov 22, 2016
Nov 21, 2016

Repository files navigation

Swagger composer

This tool lets you to merge a few swagger spec files into one.

Why? Because swagger 2.0 spec does not support sufficient modularity.

Usage

The input swagger specs must follow a convention:

  • There is exactly one master swagger.json into which others are merged.
  • Any number of partials, whose elements are to be merged.

Merge specification

  • All input files are valid swagger files alone, except for master which may have no paths.
  • Only paths, definitions, parameters and responses are copied from partials.
  • If element is defined only in one partial, it is copied as is.
  • If element exists in more than one partial, then:
    • if master already contains the element, masters version is used
    • if all definitions are equal, they are copied to output
    • if any definition is not equal to other, merge fails
  • basePath is pre-appended to all paths in partials before merging
  • basePath is not allowed in master file

About

Java application to merge multiple swagger specs into one

Resources

License

Stars

Watchers

Forks

Packages

No packages published