66ce50993f
* Unbias generation of requests:
...so that each endpoint is picked with the same frequency.
Also, include a test for unbiased generation that measures mean and variance of results.
|
||
|---|---|---|
| doc | ||
| src/Servant | ||
| test | ||
| .gitignore | ||
| .travis.yml | ||
| CHANGELOG.yaml | ||
| LICENSE | ||
| README.md | ||
| servant-quickcheck.cabal | ||
| Setup.hs | ||
| stack-lts-6.yaml | ||
| stack-lts-7.yaml | ||
| stack.yaml | ||
servant-quickcheck
servant-quickcheck provides tools to test properties across entire APIs.
Rather than writing the same tests for each endpoint, with servant-quickcheck
you can simply specify properties every endpoint must meet once and for all.
For example:
followsBestPractices :: Spec
followsBestPractices = describe "my API" $ do
it "follows best practices" $ do
withServantServer myAPI myServer $ \burl ->
serverSatisfies api burl stdArgs
( not500
<%> onlyJsonObjects
<%> getsHaveCacheControlHeader
<%> headsHaveCacheControlHeader
<%> mempty)
Additionally, servant-quickcheck provides a serversEqual function that
generates arbitrary requests (that conform to the description of an API) and
tests that two servers respond identically to them. This can be useful when
refactoring or rewriting an API that should not change.