Swagger vue documentation & api front generator

Install

npm install --save-dev swagger-vue-generator

Generate api:

Use script node_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 it

Example 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