The servant-swagger package

[Tags:bsd3, library, test]

Please see README.md


[Skip to Readme]

Properties

Versions 0.0.0.0, 0.0.0.1, 0.1, 0.1.1, 0.1.2, 1.0, 1.0.1, 1.0.2, 1.0.3, 1.1, 1.1.1, 1.1.2, 1.1.2.1, 1.1.3, 1.1.3.1
Change log CHANGELOG.md
Dependencies aeson (>=0.11.2.0 && <1.3), base (>=4.7.0.0 && <4.11), bytestring (>=0.10.4.0 && <0.11), hspec, http-media (>=0.6.3 && <0.8), insert-ordered-containers (>=0.1.0.0 && <0.3), lens (>=4.7.0.1 && <4.16), QuickCheck, servant (>=0.5 && <0.12), swagger2 (==2.1.*), text (>=1.2.0.6 && <1.3), unordered-containers (>=0.2.5.1 && <0.3) [details]
License BSD3
Copyright (c) 2015-2016, Servant contributors
Author David Johnson, Nickolay Kudasov
Maintainer nickolay.kudasov@gmail.com
Category Web
Home page https://github.com/haskell-servant/servant-swagger
Bug tracker https://github.com/haskell-servant/servant-swagger/issues
Source repository head: git clone https://github.com/haskell-servant/servant-swagger.git
Uploaded Fri Jul 14 22:10:09 UTC 2017 by phadej
Distributions Arch:1.1.3.1, LTSHaskell:1.1.3.1, NixOS:1.1.3.1, Stackage:1.1.3.1, Tumbleweed:1.1.2
Downloads 2078 total (1108 in the last 30 days)
Votes
3 []
Status Docs available [build log]
Last success reported on 2017-07-14 [all 1 reports]
Hackage Matrix CI

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Readme for servant-swagger

Readme for servant-swagger-1.1.3.1

servant-swagger

Build Status Hackage Stackage LTS Stackage Nightly

Swagger 2.0 conforming json for servant APIs.

servant-swagger robot

Motivation

Swaggerâ„¢ is a project used to describe and document RESTful APIs. Unlike Servant it is language-agnostic and thus is quite popular among developers in different languages. It also exists for a longer time and has more tools to work with.

This package provides means to generate Swagger specification for a Servant API and also to partially test whether API conforms with its specification.

Generated Swagger specification then can be used for many things such as

Usage

Please refer to haddock documentation.

Some examples can be found in example/ directory.

Try it out

All generated swagger specifications can be interactively viewed on Swagger Editor.

Ready-to-use specification can be served as JSON and interactive API documentation can be displayed using Swagger UI.

Many Swagger tools, including server and client code generation for many languages, can be found on Swagger's Tools and Integrations page.

Contributing

We are happy to receive bug reports, fixes, documentation enhancements, and other improvements.

Please report bugs via the github issue tracker.