swagger-tools

The project provides various tools for integrating and interacting with Swagger. This project is in its infancy but what is within the repository should be fully tested and reusable. Please visit the issue tracker to see what issues we are aware of and what features/enhancements we are working on.

Project Badges

• Build status:
• Dependencies:
• Developer dependencies:
• Downloads:
• License:
• Version:

Supported Swagger Versions

• 1.2
• 2.0 (WIP)

Features

• Simple CLI for validating Swagger documents
• Schema validation: For the file(s) supported by the Swagger specification, ensure they pass structural validation based on the JSON Schema associated with that version of the specification (Browser and Node)
• Semantic validation: Validates Swagger files above and beyond the structure of the file (Browser and Node)
• Connect middleware for adding pertinent Swagger information to your requests (Node only)
• Connect middleware for wiring request handlers to requests based on Swagger documentation (Node only)
• Connect middleware for serving your Swagger documents and Swagger UI (Node only)
• Connect middleware for using Swagger resource documents for pre-route validation (Node only)
  • Validate the request Content-Type based on the operation's consumes value(s)
  • Validate the request parameter types
  • Validate the request parameter values

Installation

swagger-tools is distributed via NPM so installation is the usual: npm install swagger-tools --save. (If you plan on using the CLI, you would install using npm install swagger-tools -g.) You can also install swagger-tools using Bower for browser-based applications using bower install swagger-tools --save.

Documentation

swagger-tools is heavily documentedso head on over to the project documentation or jump straight to the Quick Start.

Contributing

This project uses Gulp for building so npm install -g gulp once you clone this project. Running gulp in the project root will lint check the source code and run the unit tests.