jimme/swagger-ide repository overview

⁠Swagger-IDE

⁠How to replace newly built swagger ui

1. replace swagger-ui directory with newly build swagger-ui/dists directory
2. git checkout index.html

Swagger mock is now using stoplight's prism as follows:

prism run --cors -d --mock -p 8000 -s /var/www/html/swagger/backend/specs/swagger.yaml -c $PRISM_CFG_FILE 

PRISM_CFG_FILE: /var/www/html/prism.cfg The file is used to hot reload swagger file after swagger.yaml is changed. The file contents:

{"updatedAt": "0"}

Each time swagger.yaml is rewritten, the file will be updated accordingly

⁠Original README

The Swagger-UI and Swagger-Mock-API always use the current YAML of the Swagger-Editor. Also the Swagger-Editor saves the current YAML locally. So everything is persistence and stays up to date.

git clone https://github.com/cato1011/swagger-ide.git
cd swagger-ide
docker build -t swagger-ide .
docker run -d -i -p 8080:80 -p 8000:8000 swagger-ide

After that you can reach the Swagger-Editor and UI under:

The Swagger-Mock-Api is available under

⁠About Swagger

For further information about Swagger-Editor and -UI visit: http://swagger.io/⁠

⁠About Swagger-Mock-API

For further information about the Mock-API and defining custom types in the Swagger-Editor, have a look at:

https://www.npmjs.com/package/swagger-mock-api#specifying-custom-chance-options⁠

The chance types and options depend on http://chancejs.com/⁠