1.0.6 • Published 6 years ago

swagger-vue-generator v1.0.6

Weekly downloads
1,537
License
MIT
Repository
github
Last release
6 years ago

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

ArgumentAliasDescriptionNotes
-h--helpShow this help message and exit.optional
-v--versionShow this help message and exit.optional
-f--flag-swaggerSet swagger version (2.0 or openapi). 2.0 only supportedoptional. Default value is 2.0
-s--sourceSource swagger file destination.required
-m--moduleNameSwagger generator module name.required
-c--classNameSwagger generator class name.optional. Default value is API
-d--destinationDestination 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

ArgumentAliasDescriptionNotes
-h--helpShow this help message and exit.optional
-v--versionShow this help message and exit.optional
-s--sourceSource swagger file destination.required
-f--flag-swaggerSet swagger version (2.0 or openapi). 2.0 only supportedoptional. Default value is 2.0
-m--moduleNameSwagger generator module name.required
-c--classNameSwagger generator class name.optional. Default value is API
-t--templateTemplate dir.optional. Default value is ./node_modules/swagger-vue-generator/src/2.0/templates/markdown
-d--destinationDestination for output generate client.required
--model-pathDestination for models.optional
--doc-pathDestination 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