swagger-tools

WebJar for swagger-tools

License	MIT
Categories	Swagger Program Interface REST Frameworks
GroupId	org.webjars.bower
ArtifactId	swagger-tools
Last Version	0.9.9
Release Date	Dec 5, 2015
Type	jar
Description	swagger-tools WebJar for swagger-tools
Project URL	http://webjars.org
Source Code Management	https://github.com/apigee-127/swagger-tools

Download swagger-tools

Filename	Size
swagger-tools-0.9.9.pom
swagger-tools-0.9.9.jar	153 KB
swagger-tools-0.9.9-sources.jar	22 bytes
swagger-tools-0.9.9-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.bower/swagger-tools/ -->
<dependency>
    <groupId>org.webjars.bower</groupId>
    <artifactId>swagger-tools</artifactId>
    <version>0.9.9</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.bower/swagger-tools/
implementation 'org.webjars.bower:swagger-tools:0.9.9'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.bower/swagger-tools/
implementation ("org.webjars.bower:swagger-tools:0.9.9")

Apache Buildr

'org.webjars.bower:swagger-tools:jar:0.9.9'

Apache Ivy

<dependency org="org.webjars.bower" name="swagger-tools" rev="0.9.9">
  <artifact name="swagger-tools" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.bower', module='swagger-tools', version='0.9.9')
)

Scala SBT

libraryDependencies += "org.webjars.bower" % "swagger-tools" % "0.9.9"

Leiningen

[org.webjars.bower/swagger-tools "0.9.9"]

Dependencies

compile (9)

Group / Artifact	Type	Version
org.webjars.bower : lodash-compat	jar	[3.10.0,3.11)
org.webjars.bower » visionmedia-debug	jar	[2.2.0,2.3)
org.webjars.bower » z-schema	jar	[3.15.4,3.16)
org.webjars.bower : json-refs	jar	[0.3.2,0.4)
org.webjars.bower » spark-md5	jar	[1.0.0,1.1)
org.webjars.bower » swagger-converter	jar	[0.1.7,0.2)
org.webjars.bower : async	jar	[1.3.0,1.4)
org.webjars.bower : js-yaml	jar	[3.3.1,3.4)
org.webjars.bower » traverse	jar	[0.6.7,0.7)

Project Modules

There are no modules declared in this project.

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. Otherwise, feel free to review the Release Notes to see what is new and improved.

Project Badges

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

Supported Swagger Versions

• 1.2
• 2.0

Features

• Simple CLI
  • Validate Swagger document(s)
  • Convert Swagger 1.2 documents to Swagger 2.0
• 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 up security handlers for requests based on Swagger documentation (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/response Content-Type based on the operation's consumes/produces value(s)
  • Validate the request parameter types
  • Validate the request parameter values
  • Validate the response values

Installation

Swagger Tools is available for both Node.js and the browser. Installation instructions for each environment are below.

Browser

Installation for browser applications can be done via Bower or by downloading a standalone binary.

Using Bower

bower install swagger-tools --save

Standalone Binaries

The standalone binaries come in two flavors:

• swagger-tools-standalone.js: 2,280kb, full source (including all dependencies) and source maps
• swagger-tools-standalone-min.js: 316kb, minified, compressed and no sourcemap

Node.js

Installation for Node.js applications can be done via NPM.

npm install swagger-tools --save

If you want to use the swagger-tools executable for validating Swagger documents, you can install swagger-tools globally using the following:

npm install -g swagger-tools

Documentation

swagger-tools is heavily documented so 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.

Apigee-127

Tools for building APIs using Node and OpenAPI

Versions

Version
0.9.9 Dec 5, 2015