


Swagger vue documentation & api front generator
Install
npm install --save-dev swagger-vue-generator
Generate api:
Use scriptnode_modules/swagger-vue-generator/bin/generate-api.js
Arguments description
| Argument | Alias | Description | Notes || -------- | ----- | ----------- | ----- | |
-h
| --help
| Show this help message and exit. | optional |
| -v
| --version
| Show this help message and exit. | optional |
| -f
| --flag-swagger
| Set swagger version (2.0
or openapi
). 2.0 only supported | optional. Default value is 2.0
|
| -s
| --source
| Source swagger file destination. | required |
| -m
| --moduleName
| Swagger generator module name. | required |
| -c
| --className
| Swagger generator class name. | optional. Default value is API |
| -d
| --destination
| Destination for output generate client. | required |Example usages
node ./node_modules/swagger-vue-generator/bin/generate-api.js -s /path/to/api-docs.json -d /path/to/api.js -m module-name
Generate README.MD for api
Arguments description
| Argument | Alias | Description | Notes || -------- | ----- | ----------- | ----- | |
-h
| --help
| Show this help message and exit. | optional |
| -v
| --version
| Show this help message and exit. | optional |
| -s
| --source
| Source swagger file destination. | required |
| -f
| --flag-swagger
| Set swagger version (2.0
or openapi
). 2.0 only supported | optional. Default value is 2.0
|
| -m
| --moduleName
| Swagger generator module name. | required |
| -c
| --className
| Swagger generator class name. | optional. Default value is API |
| -t
| --template
| Template dir. | optional. Default value is ./node_modules/swagger-vue-generator/src/2.0/templates/markdown
|
| -d
| --destination
| Destination for output generate client. | required |
| | --model-path
| Destination for models. | optional |
| | --doc-path
| Destination for methods. | optional |Custom templates
Change template path with option-t
or --template
.
Copy origin template from ./node_modules/swagger-vue-generator/src/2.0/templates/markdown
and change itExample usages
Generate doc
node ./node_modules/swagger-vue-generator/bin/generate-doc.js -s ../path/to/api-docs.json -d /path/to/destination -m module-name --model-path=models --doc-path=methods
Generate api
node ./node_modules/swagger-vue-generator/bin/generate-api.js -s ../path/to/api-docs.json -d /path/to/destination -m module-name
Run tests
- Install dev dependencies
npm install --dev
- Run test
npm run test