Swagger codegen download for windows 10

Code generation for Swagger based API's. Supports NodeJS 4.x+.

Overview

A code generation module for simplifying the consumption of Swagger services. Allows generation of content based on groupings of custom attributes on paths and per-entity/definition.

The code is intended to be as pluggable as reasonably practical, and pull requests to support additional features are very, very welcome.

Gulp Task

This module is leveraged in the gulp-swagger-codegen module, but can be used independently for generating code at runtime.

Usage

The code generation can be invoked with:

Templating

Data Context

Each template is provided with a collection of objects to use when generating code. This collection varies based on the type of template being processed and there are some fields common across all types. This object is passed as a map to the template engine as the root-object.

Common Fields

The following fields are common for all template types:

• model: The complete parsed Swagger content (JSON/object structure)
• definitionMap: A name/definition map of all known definitions in Swaggerfile.
• options: The options object passed into the code-generation function.

Per-Definition Templates

Generated per entity/#definition in the Swaggerfile, fields are:

• definition: The current definition being processed.

Per-Path Templates

Fields are:

• groupKey: The value of the groupBy attribute that this file represents.
• members: The map of operations from the swaggerfile that link to this file.
• fileName: The physical file-name this perPath template will use.

Handlebars Template Helper Functions

Registering Your Own

You can register your own helper functions by adding a top-level configuration property called and assigning the functions as key-values. The key will be the exact block-helper name and the value must be the helper function itself.

arrayContains

Does the array contain an item?

compare

Perform a comparison operation.

Supported operands are ==, ===, !=, >, >=, <, <= and typeof

lowercase

Converts a block to lowercase.

lowerFirst

Makes the first character of a block lowercase, but leaves the rest of the block untouched.

property

Property name complication helper.

This is used primarily because handlebars does not natively seem to permit invalid characters in variable names. Some of the extended swaggerfile attributes are prefixed with x- and so to reason about them in templates, you'll need this.

uppercase

Converts a block to uppercase.

upperFirst

Makes the first character of a block uppercas, but leaves the rest of the block untouched.

withDef

Creates a child scope using the specified definition as the context:

This allows creation of cross-entity relations/nesting, and is shown being used in the included ES6 definition template.

Additional options

In addition to the , and options, you can pass through the following values. All of the below have default implementations that can be used:

• definitionMapper | (model) -> map
  • Compute a map/array of definition names to definitions. Allows you to selectively filter or substitute definitions during code generation.
• failureHandler | (err) -> action
  • Run a command when an error occurs. Processing of the entire code generation task is abandoned. Default implementation exits the process with an error code of -1 and writes the message/stack trace to stdout.
• templateEngine | (taskOptions) --> engine
  • Function to create an instance of the template engine. Recieves the entire task options as an input. There is a default .helpers property that contains the well-known helper functions.
• templateLoader | (templater) -> templateLoader
  • Function that generates types to handle template loading. Default implementation is a class that reads from disk. Returned object must have a .loadTemplate object that returns a template-function.
• textEncoding | (string)
  • Default text encoding when loading templates from files. Default is utf8

Custom Template Engines

To use a custom template engine besides handlebars:

• Create a function such as: function createTemplateEngine(opts) { return new MyTemplateEngine(); }

• Pass the template loader as: codegen({ ... task options ...,

Note that 'MyTemplateEngineType' instances must have a .loadTemplate(content) implementation, where content is the loaded text of the template file. The .loadTemplate operation must return a function such as:

Where contextData is the template-type specific context data, as described in the templating context data section. This model allows most pluggable template engines to be used in lieu of the default handlebars.

This code is MIT licensed and comes without any warranties. Please see the LICENSE file for specifics.