Open API V3 Merger Application

A Kotlin app to merge open api v3 specification files

License	The Apache License, Version 2.0
GroupId	com.rameshkp
ArtifactId	openapi-merger-app
Last Version	1.0.4
Release Date	Apr 14, 2021
Type	pom.sha512
Description	Open API V3 Merger Application A Kotlin app to merge open api v3 specification files
Project URL	https://github.com/kpramesh2212/openapi-merger-plugin
Source Code Management	https://github.com/kpramesh2212/openapi-merger-plugin

Download openapi-merger-app

Filename	Size
openapi-merger-app-1.0.4.pom
openapi-merger-app-1.0.4-sources.jar	9 KB
openapi-merger-app-1.0.4-javadoc.jar	435 KB

Dependencies

runtime (8)

Group / Artifact	Type	Version
org.jetbrains.kotlin : kotlin-stdlib	jar	1.3.72
io.swagger.parser.v3 : swagger-parser	jar	2.0.23
org.slf4j : slf4j-api	jar	1.7.30
javax.validation : validation-api	jar	2.0.0.Final
org.hibernate.validator : hibernate-validator	jar	6.0.2.Final
org.hibernate.validator : hibernate-validator-annotation-processor	jar	6.0.2.Final
javax.el : javax.el-api	jar	3.0.0
org.glassfish.web : javax.el	jar	2.2.6

Project Modules

There are no modules declared in this project.

openapi-merger-plugin

A plugin to merge OpenAPI-3 specification files into a single file

what does the plugin do

Consider the following open api v3 schema files color.yaml and book.yaml

color.yaml

openapi: 3.0.1
info:
  title: OpenAPI definition
  version: v0
servers:
- url: http://localhost:8080
  description: Generated server url
paths:
  /api/color/{name}:
    get:
      tags:
      - color-controller
      operationId: getColor
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        "200":
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Color'
components:
  schemas:
    Color:
      type: object
      properties:
        name:
          type: string
        red:
          type: integer
          format: int32
        green:
          type: integer
          format: int32
        blue:
          type: integer
          format: int32

book.yaml

openapi: 3.0.1
info:
  title: OpenAPI definition
  version: v0
servers:
- url: http://localhost:8080
  description: Generated server url
paths:
  /api/book/{name}:
    get:
      tags:
      - book-controller
      operationId: getBook
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        "200":
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Book'
components:
  schemas:
    Book:
      type: object
      properties:
        name:
          type: string
        iban:
          type: string

Using the plugin user can merge these files into a single file

merged.yaml

openapi: 3.0.1
info:
  title: My title
  version: 1.0.0-SNAPSHOT
servers:
- url: http://localhost:8080
  description: Generated server url
paths:
  /api/book/{name}:
    get:
      tags:
      - book-controller
      operationId: getBook
      parameters:
      - name: name
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        "200":
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Book'
  /api/color/{name}:
    get:
      tags:
      - color-controller
      operationId: getColor
      parameters:
      - name: name
        in: path
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        "200":
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Color'
components:
  schemas:
    Book:
      type: object
      properties:
        name:
          type: string
        iban:
          type: string
    Color:
      type: object
      properties:
        name:
          type: string
        red:
          type: integer
          format: int32
        green:
          type: integer
          format: int32
        blue:
          type: integer
          format: int32

OpenAPI objects

Root Objects Open API v3 Specification

The plugin will merge the following Root OpenAPI objects and all its sub object from the input files

S.NO	Field Name
1	servers
2	paths
3	components
4	security
5	tags

The plugin will ignore following Root OpenAPI objects and all its sub object from the input files.

S.NO	Field Name
1	openapi
2	info
3	externalDocs

However the plugin allows the user to configure the above object as input properties that will be placed in the merged file.

Supported File formats

1. json
2. yaml

Plugin inputs

The plugin expects a directory as input which can contain any number of openapi specification files. Input directory can contain both yaml and json open api specification files, and the plugin can process them all.

Plugin outputs

The plugin can output the merged file either in json or yaml format, but not both.

Versions

Version
1.0.4 Apr 14, 2021
1.0.3 Feb 10, 2021
1.0.2 Dec 1, 2020