The @iouring-engineering/openapi-merge repository

Welcome to the openapi-merge repository. This library is intended to be used for merging multiple OpenAPI 3.0 files together. The most common reason that developers want to do this is because they have multiple services that they wish to expose underneath a single API Gateway. Therefore, even though this merging logic is sufficiently generic to be used for most use cases, some of the feature decisions are tailored for that specific use case.

This is an extension of npm library openapi-merge, we forked existing library code from Github to add some additional features according to our micro services architecture.

• Main motive of building following features is to extend the usability of in microservices environment with more control. In the merging of Openspec files from different service unit happens at the tag level. Tags from the openspec files becomes a section head in the generated API doc. There is no option to exclude or include certain services based on the URI path under the same tag from different microservice unit. Below is an example
  • API-Gateway Login
    1. /user/login
    2. /user/get-access-token
    3. Login service
    4. /user/direct-login
    5. /user/change-password
    6. /user/logout
    7. /user/forgot-password
• If you want to disable /direct-login from Login microservice and use API Gateway Login in final openspecification file Below is the option,

1 "operationSelection": {
2                "excludePaths": [
3                    {
4                        "path": "/user/direct-login",
5                        "method": "post"
6                    }
7                ]
8            }

• Server config

  • If we have multiple specifications along with api gateway, earlier implementation takes only first specification's server config as final specification, but consider we have different gateway for merged specification, we may need different server config to include in final specification.

• Info title, description and version

  • As we have multiple specifications, we cannot add first specification's title and description into merged specification, so we had included those configs to meet out requirements in the merge config.

Have brief understanding from below docs :

• @iouring-engineering/openapi-merge

• @iouring-engineering/openapi-merge-cli

Screenshots

(An example of creating an openapi-merge.json configuration file for the CLI tool)

About this repository

This is a multi-package repository that contains:

• The @iouring-engineering/openapi-merge library:
• The @iouring-engineering/openapi-merge CLI tool:

Depending on your use-case, you may wish to use the CLI tool or the library in your project. Please see the readme file of the specific package for more details.

Developing on openapi-merge

This project is a multi-package repository and uses the bolt tool to manage these packages in one development experience.

After checking out this repository, you can run the following command to install the required dependencies:

1bolt install

You can then test running the CLI tool by running:

1yarn cli

If you wish to ensure that you can develop on the @iouring-engineering/openapi-merge library in parallel to the @iouring-engineering/openapi-merge-cli tool then you must run the Typescript build for @iouring-engineering/openapi-merge in watch mode. You can do this by:

1bolt w openapi-merge build -w

This will ensure that the Typescript is compiled into JavaScript so that it can be used by the @iouring-engineering/openapi-merge-cli tool.

For the other operations that you wish to perform, please see the package.json of the other packages in this repository.