Test.Framework.Providers.DocTest

Wrapper for running DocTests with Test.Framework

First we get the doctests wrapped in Test using docTest. The first argument to docTest should be the root modules i.e., the modules that are not imported by other modules.

>>> doctests <- docTest ["tests/Test.hs"] ["-itests"]

After getting the doctests we can execute the doctests using the defaultMain or defaultMainWithOpts functions.

>>> :m + Data.Monoid
>>> defaultMainWithOpts [doctests] noColors
DocTest:
  Test:
    print "abc": [Failed]
expression `print "abc"'
expected: ["\"fail\""]
 but got: ["\"abc\""]
    print bar: [OK]

         Test Cases  Total      
 Passed  1           1          
 Failed  1           1          
 Total   2           2          
*** Exception: ExitFailure 1

The *** Exception: ExitFailure 1 is caused by defaultMainWithOptions trying to exit after finishing with tests.

Documentation

docTest

Arguments

:: [FilePath]

Paths to root modules

-> [String]

Options passed to ghci

-> IO Test

Note that docTest can be called only once per process execution

You only need to give paths to modules that are not imported from any other module