Personal tools

DocTest

From HaskellWiki

(Difference between revisions)
Jump to: navigation, search
m (fixed terminology)
m (added section "State of DocTest")
Line 36: Line 36:
 
(e.g. ghci) prints to <hask>stdout</hask> and <hask>stderror</hask> when
 
(e.g. ghci) prints to <hask>stdout</hask> and <hask>stderror</hask> when
 
evaluating that expression.
 
evaluating that expression.
  +
  +
==State of DocTest==
  +
DocTest is in a early stage. Patches are welcome!
   
 
==DocTest on Hackage==
 
==DocTest on Hackage==

Revision as of 12:07, 22 March 2009

Contents

1 What is DocTest

DocTest is a small program, that checks examples in Haskell source code comments. It is modeled after doctest for Python.

2 Tutorial

Bellow is a small Haskell module. The module contains source code comments. Those comments are examples from an interactive Haskell session and demonstrate how the module is used.

module Fib where
 
-- Examples:
--
-- > fib 10
-- 55
 
-- > fib 5
-- 5
 
fib 0 = 0
fib 1 = 1
fib n = fib (n - 1) + fib (n - 2)

With DocTest you may checks if the implementation satisfies the given examples, by typing (on your Unix shell):

$ doctest Fib.hs


Lines starting with
-- >
denote expressions.

All comment lines following an expression denote the result of that expression. Result is defined by what an REPL

(e.g. ghci) prints to
stdout
and
stderror
when

evaluating that expression.

3 State of DocTest

DocTest is in a early stage. Patches are welcome!

4 DocTest on Hackage

http://hackage.haskell.org/cgi-bin/hackage-scripts/package/DocTest

5 Branches

http://code.haskell.org/~sih/code/DocTest.git/