servant-swagger: Generate a Swagger/OpenAPI/OAS 2.0 specification for your servant API.
Swagger is a project used to describe and document RESTful APIs. The core of the project is the OpenAPI Specification (OAS). This library implements v2.0 of the spec. Unlike Servant it is language-agnostic and thus is quite popular among developers in different languages. It has also existed for a longer time and has more helpful tooling.
This package provides means to generate a Swagger/OAS specification for a Servant API and also to partially test whether an API conforms with its specification.
Generated Swagger specification then can be used for many things such as
displaying interactive documentation using Swagger UI;
generating clients and servers in many languages using Swagger Codegen;
and many others.
[Skip to Readme]
Downloads
- servant-swagger-1.2.1.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
- AlpMestanogullari, DavidJohnson, GaelDeest, NickolayKudasov, phadej, MatthiasFischmann, maksbotan, hecate, arianvp, janus
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 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, 1.1.4, 1.1.5, 1.1.6, 1.1.7, 1.1.7.1, 1.1.8, 1.1.9, 1.1.10, 1.1.11, 1.2, 1.2.1 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | aeson (>=1.4.2.0 && <3), aeson-pretty (>=0.8.7 && <0.9), base (>=4.14 && <5), base-compat (>=0.10.5 && <0.15), bytestring (>=0.10.8.1 && <0.13), hspec, http-media (>=0.7.1.3 && <0.9), insert-ordered-containers (>=0.2.1.0 && <0.3), lens (>=4.17 && <6), QuickCheck, servant (>=0.20.2 && <0.21), singleton-bool (>=0.1.4 && <0.2), swagger2 (>=2.3.0.1 && <3), text (>=1.2.3.0 && <2.2), unordered-containers (>=0.2.9.0 && <0.3) [details] |
| Tested with | ghc ==8.10.7, ghc ==9.0.2, ghc ==9.2.8, ghc ==9.4.8, ghc ==9.6.4, ghc ==9.8.2 |
| License | BSD-3-Clause |
| Copyright | (c) 2015-2018, Servant contributors |
| Author | Servant Contributors |
| Maintainer | haskell-servant-maintainers@googlegroups.com |
| Category | Web, Servant, Swagger |
| Home page | https://github.com/haskell-servant/servant/tree/master/servant-swagger#readme |
| Bug tracker | https://github.com/haskell-servant/servant/issues |
| Source repo | head: git clone https://github.com/haskell-servant/servant.git |
| Uploaded | by janus at 2024-08-30T02:36:22Z |
| Distributions | Arch:1.2, LTSHaskell:1.2.1, NixOS:1.2, Stackage:1.2.1 |
| Reverse Dependencies | 23 direct, 15 indirect [details] |
| Downloads | 30860 total (167 in the last 30 days) |
| Rating | 2.5 (votes: 6) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2024-08-30 [all 1 reports] |
Readme for servant-swagger-1.2.1
[back to package description]servant-swagger
Swagger 2.0 conforming json for servant APIs.
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
- displaying interactive documentation using Swagger UI;
- generating clients and servers in many languages using Swagger Codegen;
- and many others.
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.