ts-swagger-vue-generator
v1.1.2
Published
Generate api from spec & documentation for swagger-vue with templates (markdown or html)
Downloads
40
Maintainers
Readme
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 |
| -d
| --destination
| Destination for output generate client. | required |
| -u
| --url
| Fecth swagger file from URL. | [optional] |
| | --method-name-using-path
| Using path as the API method name. | [optional]. Default value is false
|
Example usages
node ./node_modules/swagger-vue-generator/bin/generate-api.js -s /path/to/api-docs.json -d /path/to/api.js --method-name-using-path true -u http://localhost:8081/v2/api-docs
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 |
| -u
| --url
| Fecth swagger file from URL. | [optional] |
| | --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
Author
Donii Sergii (sonrac)
- Ukraine
- [email protected]
- https://blog.sonrac.info
zhuzeyu
- China
- [email protected]