servant/servant-swagger
Matthieu Coudron 73c87bc2bc
bumped cabal-version field (#1498)
* bumped cabal-version field

Cabal supports two types of licenses, native and SPDX, which can be seen here hackage.haskell.org/package/Cabal-3.6.2.0/docs/Distribution-Types-PackageDescription.html#v:licenseRaw

Several packages use BSD-3-Clause as a license, in conjonction with cabal-version: >=1.10 which cabal parses as Right (UnknownLicense "BSD-3").
If I change teh cabal-version to cabal-version: 2.2 , cabal correctly identifdies the license License (ELicense (ELicenseId BSD_3_Clause)).

* changed license from cabal to spdx format

aka BSD3 -> BSD-3-Clause: next cabal may deprecate the old format
2022-01-04 22:06:23 +01:00
..
example bumped cabal-version field (#1498) 2022-01-04 22:06:23 +01:00
src/Servant moving servant-swagger into the main servant repo 2021-11-18 11:56:38 +01:00
test moving servant-swagger into the main servant repo 2021-11-18 11:56:38 +01:00
CHANGELOG.md moving servant-swagger into the main servant repo 2021-11-18 11:56:38 +01:00
LICENSE moving servant-swagger into the main servant repo 2021-11-18 11:56:38 +01:00
README.md changing servant-swagger info 2021-11-18 11:56:38 +01:00
servant-swagger.cabal bumped cabal-version field (#1498) 2022-01-04 22:06:23 +01:00
Setup.hs moving servant-swagger into the main servant repo 2021-11-18 11:56:38 +01:00

servant-swagger

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.