grunt-swagger-ts
This plugin generates typescript files from a swagger definition file. This plugin can generates your code in two ways.
- The first one is the official way from swagger-js-codegen. Unfortunately, it doesn't provide a grunt task to generate typescript code, only the javascript generator is available here grunt-swagger-js-codegen
- The second one is a custom generation because in the official one, when you want to use a server class declaration, their parser shadowes the type with a generic type. With this generation, you can get your Class Definition in a typescript file.
Getting Started
This plugin requires Grunt v0.4.5
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-swagger-ts --save-dev
The "grunt-ts-swagger" task
Overview
In your project's Gruntfile, add a section named swagger_tsGenerator
to the data object passed into grunt.initConfig()
.
Official Generator
grunt;
Options
options.api.swagger
Type : 'string'
Required field to specify swagger location. This location can be an URL or a filepath.
others options
The others options are the same as the js plugin
Custom Generator
grunt;
Options
options.api.swagger
Type : 'string'
Required field used to specify swagger location. This location can be an URL or a filepath.
options.api.filename
Type : 'string'
Required field used to specify the generated filename
options.api.namespace
Type : 'string'
Required field used to specify the namespace of the generated class.
options.dest
Type : 'string'
Required field to indicate the output directory.