hedgehog-servant: Hedgehog property testing for Servant APIs

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

An adapter for using Hedgehog to create requests against Servant APIs.


[Skip to Readme]

Properties

Versions 0.0.0.1, 0.0.1.1, 0.0.1.1
Change log CHANGELOG.md
Dependencies base (>=4.9 && <5), bytestring (>=0.10 && <0.11), case-insensitive (>=1.2 && <1.3), hedgehog (>=0.6 && <1.1), http-client (>=0.5.14 && <0.7), http-media (>=0.8 && <0.9), http-types (>=0.12 && <0.13), servant (>=0.16 && <0.19), servant-client (>=0.16 && <0.19), servant-server (>=0.16 && <0.19), string-conversions (>=0.4 && <0.5), text (>=1.2 && <1.3) [details]
License BSD-3-Clause
Copyright Felix Mulder
Author Felix Mulder
Maintainer felix.mulder@gmail.com
Category testing
Bug tracker https://github.com/felixmulder/hedgehog-servant
Source repo head: git clone git://github.com/felixmulder/hedgehog-servant.git
Uploaded by felixmulder at 2021-04-25T08:40:57Z

Modules

[Index] [Quick Jump]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


Readme for hedgehog-servant-0.0.1.1

[back to package description]

Hedgehog Servant

Hedgehog servant will eat all your servant bugs.

Basic Usage

Define your servant API endpoints and automatically derive request generators for them!

This is accomplished using the genRequest and the heterogeneous list, called GList, that contains all the generators needed for your API.

So, what do we actually need to do?

  1. Define our API (below SimplestApi).
  2. Define generators for each element that gets captured in the request.
  3. Call the function genRequest with a proxy for the API (Proxy @SimplestApi) and all generators needed in a generator list (GList)!

In code this looks like:

-- POST /cats
type SimplestApi =
  "my" :> "cats" :> ReqBody '[JSON] Cat :> Post '[JSON] ()

-- Generate a request to the Cat API from a base URL
catRequestGen :: BaseUrl -> Gen Request
catRequestGen baseUrl =
  genRequest (Proxy @SimplestApi) (genCat :*: GNil) <&>
    \makeReq -> makeReq baseUrl

We construct generator lists with element1 :*: element2 :*: ... elementN :*: GNil, where GNil denotes the end of the generator list. The genRequest function will derive a request from the generators in the list. This includes request bodies, headers and query parameters.

Note: since the generator list may contain many generators for a specific type, the first one will be chosen. This means that for types that may collide (e.g. common types like String,Integer etc), you should define newtype wrappers.