/swagger-vue-doc-generator

Generate documentation for swagger-vue with templates (markdown or html)

Primary LanguageCSSMIT LicenseMIT

Scrutinizer Code Quality Code Coverage Build Status

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