Awesome Open Source
Awesome Open Source


Build Status dependencies Status codecov Known Vulnerabilities Greenkeeper badge


This module provides NodeJS RESTfull APIs scaffolding based OpenAPI 3.x specs using oas-tools and express. It is compatible with servers generated with the swagger-tool suite to help in the transition from pre-existing servers based on 2.x specs.

We have a 2 min. tutorial:

oas-generator introduction (v2.0.6) - Click to Watch!

1. Install oas-generator

npm install oas-generator -g

2. Use oas-generator command

2.1. Help

$ oas-generator --help

Usage:  oas-generator <OAS v3 file in YAML or JSON>


    -n, --projectName <projectName>  Name for the generated folder
    -z, --generateZip                Indicate whether the generated folder must be deleted after compression
    -h, --help                       output usage information

2.2 Examples

Generate a NodeJS project: The following command wil create the code of a NodeJS application based on the OpenAPI Spec 3.x docker-engine.yaml and place its code in a folder by the name generatedServer.

$ oas-generator specs/docker-engine.yaml -n generatedServer

Once the folder is created locate into it. Install dependencies and run it by doing npm start:

$ cd generatedServer
$ npm start

Now your app is running on port 8080. You can try the url http://localhost:8080/v1.33/volumes

In the folder controllers there will be a set of js files with the templates for each method specified in the spec that should be completed to have a fully working API.

Happy coding!


Copyright 2018, ISA Group, University of Sevilla

For technical inquiry please contact to engineering team.

ISA Group

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Nodejs (55,313
Api (22,718
Cli (15,943
Express (11,599
Rest (4,150
Openapi3 (474
Scaffolding (430
Oas (67
Related Projects