The latest documentation is always here: https://github.com/sol/doctest-haskell#readme
1 What is DocTest
DocTest is available from Hackage. Install it, by typing:
$ cabal install doctest
Below is a small Haskell module. The module contains a Haddock comment with some examples of interaction. The examples demonstrate how the module is supposed to be used.
module Fib where -- | Compute Fibonacci numbers -- -- Examples: -- -- >>> fib 10 -- 55 -- -- >>> fib 5 -- 5 fib :: Int -> Int fib 0 = 0 fib 1 = 1 fib n = fib (n - 1) + fib (n - 2)
With DocTest you may check whether the implementation satisfies the given examples, by typing:
$ doctest Fib.hs
You may produce Haddock documentation for that module with:
$ haddock -h Fib.hs -o doc/
DocTest is still experimental. You can find a reference to the public source repository at Hackage.
Patches are gladly welcome!