You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+5-131Lines changed: 5 additions & 131 deletions
Original file line number
Diff line number
Diff line change
@@ -47,137 +47,11 @@ This includes:
47
47
48
48
If you just want to see it work, check out the [pet store sample](http://petstore.swagger.io/).
49
49
50
-
## Additional Libraries
51
-
52
-
### Swagger-Group Projects
53
-
54
-
These are the projects that were created by the same people who authored the Swagger Specification:
55
-
-[swagger-tools](https://github.com/apigee-127/swagger-tools) - A Node.js and browser module that provides tooling for validation and more around Swagger
56
-
-[swagger-core](https://github.com/swagger-api/swagger-core) - A Swagger implementation for Java/Scala. Has integration with JAX-RS (Jersey, Resteasy, CXF...), Servlets and Play Framework.
57
-
-[swagger-js](https://github.com/swagger-api/swagger-js) - A Swagger implementation for JavaScript.
58
-
-[swagger-node-express](https://github.com/swagger-api/swagger-node-express) - A Swagger module for node.js with express module.
59
-
-[swagger-ui](https://github.com/swagger-api/swagger-ui) - A dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
60
-
-[swagger-codegen](https://github.com/swagger-api/swagger-codegen) - A template-driven engine to generate client code in different languages by parsing your Swagger documentation.
61
-
-[swagger-editor](https://github.com/swagger-api/swagger-editor) - Swagger Editor lets you edit API specifications in YAML inside your browser and to preview documentations in real time. Valid Swagger JSON descriptions can then be generated and used with the full Swagger tooling (code generation, documentation, etc).
62
-
63
-
64
-
### Community-Driven Language Integrations
65
-
These are third party tools generated by the Swagger community. Note that not all are compatible with Swagger V2.0.
66
-
67
-
#### Clojure
68
-
-[octohipster](https://github.com/myfreeweb/octohipster) - A hypermedia REST HTTP API library for Clojure.
69
-
-[ring-swagger](https://github.com/metosin/ring-swagger) - Swagger implementation for Clojure/Ring using Prismatic Schema for data models
70
-
-[compojure-api](https://github.com/metosin/compojure-api) - Swagger for Compojure
71
-
-[fnhouse-swagger](https://github.com/metosin/fnhouse-swagger) - Swagger for fnhouse
72
-
-[pedestal-swagger](https://github.com/frankiesardo/pedestal-swagger) - Swagger for pedestal
73
-
-[swagger1st](https://github.com/sarnowski/swagger1st) - A Clojure/Ring handler that does parsing, validation and routing based on swagger definitions.
74
-
75
-
### ColdFusion / CFML
76
-
-[swagger-docs-cfml](https://github.com/webonix/swagger-docs-cfml) - create swagger docs from CFML (Railo) ReST components.
77
-
78
-
#### Eiffel
79
-
-[swagger](https://github.com/EiffelWebFramework/swagger) - Swagger protocol implementation in Eiffel.
80
-
81
-
#### Go
82
-
-[go-restful](https://github.com/emicklei/go-restful) - library to build REST based Web Services using Google Go.
83
-
-[Sashay](https://bitbucket.org/seanerussell/sashay) - a Go code generator for REST services that expose a Swagger specification.
84
-
-[beego](https://github.com/astaxie/beego) - A framework support support auto generate swagger spec from comments
85
-
-[Swagger spec generator](https://github.com/yvasiyarov/swagger) - A swagger spec auto generator. Doesn't depends on any framework
86
-
87
-
#### Groovy
88
-
-[restapidoc](https://github.com/siemens/restapidoc) - A simple RESTful API documentation plugin for the Grails web application framework.
89
-
-[swaggydoc](http://grails.org/plugin/swaggydoc) - Swagger Documentation for Grails Controllers. [[Source]](https://github.com/rahulsom/swaggydoc)
90
-
91
-
#### Java
92
-
-[springfox](https://springfox.github.io/springfox) - Integrates with Spring MVC with support for Swagger 1.2 and Swagger 2.0 spec.
93
-
-[swagger4spring-web](https://github.com/wkennedy/swagger4spring-web) - Integration with Spring MVC.
94
-
-[swagger-maven-plugin](http://kongchen.github.io/swagger-maven-plugin/) - Support Swagger Spec 2.0, integrate with JAX-RS & Spring MVC project, and easily generate `swagger.json` & a static document during build phase.
95
-
-[swagger-codegen-maven-plugin](https://github.com/garethjevans/swagger-codegen-maven-plugin) - A maven build plugin which allows the codegen project to be triggered for generating clients, etc. during the build process.
96
-
-[swagger-jaxrs-doclet](https://github.com/ryankennedy/swagger-jaxrs-doclet) - A JavaDoc Doclet that can be used to generate a Swagger resource listing suitable for feeding to swagger-ui.
97
-
-[swaggerj4](https://github.com/SmartBear/swagger4j) - A parsing library to turn swagger specifications into POJOs.
98
-
-[dropwizard-swagger](https://github.com/federecio/dropwizard-swagger) - A dropwizard bundle that wraps Swagger-Core.
99
-
-[swaggerapi](https://github.com/ROAMSYS/swaggerapi) - Creates a Swagger resource listing suitable for feeding to swagger-ui by annotating your classes and methods and handles API calls to those methods
100
-
-[swagger-validator](https://github.com/kenshoo/swagger-validator) - Validates that definitions in a swagger.yaml match the actual Java code.
101
-
-[swagger2markup](https://github.com/RobWin/swagger2markup) - Swagger2Markup converts a Swagger JSON or YAML file into AsciiDoc or Markdown documents which can be combined with hand-written documentation. The AsciiDoc documents can be converted into HTML5, PDF and EPUB. The Swagger2MarkupConverter supports the Swagger 1.2 and 2.0 specification.
102
-
-[swagger2markup-gradle-plugin](https://github.com/RobWin/swagger2markup-gradle-plugin) - A Swagger2Markup Gradle Plugin which converts a Swagger JSON or YAML file into AsciiDoc or Markdown documents which can be combined with hand-written documentation. The AsciiDoc documents can be converted into HTML5, PDF and EPUB.
103
-
-[assertj-swagger](https://github.com/RobWin/assertj-swagger) - assertj-swagger is a library which compares a design-first Swagger YAML with an implementation-first Swagger JSON output (e.g. from springfox). assertj-swagger allows to validate that the implementation in compliance with the design specification.
104
-
105
-
#### JavaScript
106
-
-[swagger-ajax-client](https://github.com/signalfx/swagger-ajax-client) - Swagger client to communicate with a Swagger server using XHR requests from browsers. Includes client-side validation of requests against the given Swagger spec.
107
-
-[swagger-angular-client](https://github.com/signalfx/swagger-angular-client) - Angular service Swagger client to communicate with a Swagger server using the Angular-specific services (such as $http). Includes client-side validation of requests against the given Swagger spec.
108
-
-[swagger-client-generator](https://github.com/signalfx/swagger-client-generator) - Client library generator which can be used to create framework or platform-specific Swagger clients given a transport method (e.g. [swagger-angular-client](https://github.com/signalfx/swagger-angular-client) or [swagger-node-client](https://github.com/signalfx/swagger-node-client)).
109
-
-[swagger-validate](https://github.com/signalfx/swagger-validate) - Validation utility to validate Swagger models or requests against a given spec, useful for writing Swagger client libraries.
110
-
-[Swagger Parser](https://github.com/BigstickCarpet/swagger-parser#swagger-parser) - Parses, validates, and dereferences JSON/YAML Swagger specs in Node and browsers
111
-
112
-
#### .Net
113
-
-[ServiceStack](https://github.com/ServiceStack/ServiceStack) - a high-performance .NET web services platform that simplifies the development of high-performance REST (JSON, XML, JSV, HTML, MsgPack, ProtoBuf, CSV) and WCF SOAP Web Services. Has support for [Swagger integration](https://github.com/ServiceStack/ServiceStack/wiki/Swagger-API).
114
-
-[fubumvc-swagger](https://github.com/KevM/fubumvc-swagger) - This project helps your [FubuMVC](https://github.com/DarthFubuMVC/fubumvc) web application generate API documentation via Swagger.
115
-
-[Swashbuckle](https://github.com/domaindrivendev/Swashbuckle) - Adds some Swagger to your WebApi.
116
-
-[Swagger.Net](https://github.com/Swagger-Net/Swagger.Net) - Library to document the ASP.NET Web API using the Swagger specification.
117
-
-[dotswaggen](https://github.com/skrusty/dotswaggen) - .Net application that generates code (or anything else, e.g. markdown) from a swagger specification file.
118
-
-[AutoRest](https://github.com/Azure/AutoRest) - The AutoRest tool generates client libraries for accessing RESTful web services from a Swagger specification.
119
-
120
-
#### Node.js
121
-
-[Swagger Framework](https://github.com/silas/swagger-framework) - a module for creating Swagger-based apis using the standard HTTP request listener interface (including Express). It supports request normalization/validation, pluggable consumes/produces, spec validation, and more.
122
-
-[swagger-jack](https://github.com/worldline/swagger-jack) - Express middleware to automatically create route and validate inputs from a swagger descriptor (for NodeJS).
123
-
-[hapi-swagger](https://github.com/glennjones/hapi-swagger) - A Swagger interface for HAPI.
124
-
-[hapi-swaggered](https://github.com/z0mt3c/hapi-swaggered) - A hapi.js plugin to generate swagger v2.0 compliant specifications based on hapi routes and joi schemas.
125
-
-[Swagger Validation](https://github.com/wonderlic/swagger-validation) - A library to validate a request that integrates with swagger-node-express.
126
-
-[swagger-node-client](https://github.com/signalfx/swagger-node-client) - Node client to communicate with Swagger servers. Includes detailed client-side validation against the API spec.
127
-
-[swaggerize-express](https://github.com/krakenjs/swaggerize-express) - Design-driven RESTful apis with swagger and express from [@PayPalDev](https://twitter.com/PayPalDev).
128
-
-[swaggerize-hapi](https://github.com/krakenjs/swaggerize-hapi) - Design-driven RESTful apis with swagger and hapi from [@PayPalDev](https://twitter.com/PayPalDev).
129
-
-[generator-swaggerize](https://github.com/krakenjs/generator-swaggerize) - Yeoman generator for krakenjs/swaggerize tools from [@PayPalDev](https://twitter.com/PayPalDev).
130
-
-[a127](http://a127.io) - a127 is toolkit for modeling & building rich, enterprise-class APIs in Node.js on your laptop. The focal point of a127 is the Swagger 2.0 specification for defining and describing an API model. From the Swagger model you can generate clients, servers and interactive documentation for your API. From [@apigee](https://github.com/apigee)
131
-
-[ratify](https://github.com/mac-/ratify) - A [Hapi](http://hapijs.com/) plugin that automatically creates Swagger documentation AND validates request/response parameters using the [JSON Schema](http://json-schema.org/) spec.
132
-
-[swagger-tools](https://github.com/apigee-127/swagger-tools) - Various Swagger tools for JavaScript including an API/CLI (conversion, validation, ...) and [Connect](https://github.com/senchalabs/connect) middleware for routing, validation, security and swagger-ui.
133
-
-[swagger-express](https://github.com/fliptoo/swagger-express) - A simple and clean solution to integrate swagger with express straight away from jsdoc or a yaml file.
134
-
-[Swagger Parser](https://github.com/BigstickCarpet/swagger-parser#swagger-parser) - Parses, validates, and dereferences JSON/YAML Swagger specs in Node and browsers
135
-
-[Swagger Express Middleware](https://github.com/BigstickCarpet/swagger-express-middleware/#swagger-express-middleware) - Swagger middleware and mocks for Express.js
136
-
-[swagger-mongodb](https://github.com/kaizhu256/node-swagger-mongodb) - lightweight swagger-ui crud-api backed by mongodb
137
-
138
-
#### Perl
139
-
-[Raisin](https://github.com/khrt/Raisin) - A framework with a built-in Swagger support.
140
-
141
-
#### PHP
142
-
-[Swagger-PHP](https://packagist.org/packages/zircote/swagger-php) - a library implementing the swagger.io specification to describe web services, operations/actions and models enabling a uniform means of producing, consuming, and visualizing RESTful web services.
143
-
-[NelmioApiDocBundle](https://github.com/nelmio/NelmioApiDocBundle) - A Symfony Bundle.
144
-
-[Restler](https://github.com/Luracast/Restler) - PHP framework, swagger support in 3.0.
145
-
-[swagger-assert](https://github.com/gong023/swagger-assert) - enable to assert keys in swagger document and API response
146
-
-[SwaggerAssertions](https://github.com/Maks3w/SwaggerAssertions) - Swagger 2 test assertions for validate your API requests and responses
147
-
-[Swaggervel](https://packagist.org/packages/jlapp/swaggervel) - a package for Laravel that uses Swagger-PHP and swagger-ui to auto-generate docs for your project.
148
-
149
-
#### Python
150
-
-[django-rest-swagger](https://github.com/marcgibbons/django-rest-swagger) - Swagger Documentation Generator for Django REST Framework
151
-
-[django-tastypie-swagger](https://github.com/concentricsky/django-tastypie-swagger) - An adapter to use Swagger with django-tastypie.
152
-
-[flask-restful-swagger](https://github.com/rantav/flask-restful-swagger) - A Swagger spec extractor for flask-restful.
153
-
-[pyramid-swagger](https://github.com/striglia/pyramid_swagger) - Convenient tools for using Swagger to define and validate your interfaces in a Pyramid webapp.
154
-
-[flask-restplus](https://github.com/noirbizarre/flask-restplus) - Helpers, syntaxic sugar and Swagger documentation for Flask-Restful
155
-
-[pyswagger](https://github.com/AntXlab/pyswagger) - A type-safe, dynamic, spec-compliant Swagger client.
156
-
-[flex](https://github.com/pipermerriam/flex) - Swagger 2.0 schema validation, and tooling for validating arbitrary request/response objects.
157
-
-[flask-swagger](https://github.com/gangverk/flask-swagger) - A Swagger 2.0 extractor for Flask via YAML in docstrings
158
-
-[bravado](https://github.com/Yelp/bravado) - Swagger 2.0 client with support for both synchronous and asynchronous http.
159
-
-[bravado-core](https://github.com/Yelp/bravado-core) - Library for Swagger 2.0 schema ingestion, validation, request/response validation, etc.
160
-
-[swagger-spec-validator](https://github.com/Yelp/swagger_spec_validator) - Library for validating Swagger 1.2 and 2.0 schemas.
161
-
162
-
#### Ruby
163
-
-[grape-swagger](https://github.com/tim-vandecasteele/grape-swagger) - Add Swagger compliant documentation to your grape API.
164
-
-[swagger-docs](https://github.com/richhollis/swagger-docs) - Generates Swagger files for Rails APIs with a simple DSL.
165
-
-[swagger-blocks](https://github.com/fotinakis/swagger-blocks) - Define and serve live-updating Swagger JSON for Ruby apps.
166
-
-[source2swagger](https://github.com/solso/source2swagger) - Builds a swagger compliant JSON specification from annotations on the comments of your source code.
167
-
-[swagger_engine](https://github.com/batdevis/swagger_engine) - include [Swagger-ui](https://github.com/swagger-api/swagger-ui) as mountable rails engine.
168
-
169
-
#### Scala
170
-
-[Scalatra](http://www.scalatra.org/) - see the [Swagger Guide](http://www.scalatra.org/2.2/guides/swagger.html)
171
-
-[spray-swagger](https://github.com/gettyimages/spray-swagger) - Spray-Swagger brings Swagger support for Spray Apis.
172
-
-[Api-doc](https://github.com/sun-opsys/api-doc) - Creates swagger docs from easily readable ascii text placed in the code. Depends on [playframework](http://www.playframework.com), but may also be used in other frameworks.
173
-
174
-
### Community-Driven Tools
175
-
These are third party tools generated by the Swagger community:
176
-
177
-
-[gform-admin](https://github.com/stemey/gform-admin) - An alternative UI client for Swagger.
178
-
-[swagger-cli-client](https://github.com/signalfx/swagger-cli-client) - Command-line interface generator to communicate with Swagger servers.
179
-
-[swagger.ed](http://chefarchitect.github.io/swagger.ed/) - A Chrome extenstion that will change the way you look at APIs.
180
-
-[Swagger2Postman](https://github.com/josephpconley/swagger2postman) - Creates a [Postman](http://www.getpostman.com) collection from live Swagger documentation
50
+
## Tools and Libraries
51
+
52
+
Looking to see how you can create your own Swagger definition, present it or otherwise use it? Check out our [list of tools](http://swagger.io/open-source-integrations/) over at [http://swagger.io](http://swagger.io/open-source-integrations/).
53
+
54
+
(Yes, there used to be a really long list here, we just moved it to the main website)
0 commit comments