Portability | portable |
---|---|
Maintainer | cabal-devel@haskell.org |
Safe Haskell | Safe-Infered |
This is the entry point into testing a built package. It performs the
"./setup test
" action. It runs test suites designated in the package
description and reports on the results.
- test :: PackageDescription -> LocalBuildInfo -> TestFlags -> IO ()
- runTests :: [Test] -> IO ()
- writeSimpleTestStub :: TestSuite -> FilePath -> IO ()
- stubFilePath :: TestSuite -> FilePath
- stubName :: TestSuite -> FilePath
- data PackageLog = PackageLog {
- package :: PackageId
- compiler :: CompilerId
- platform :: Platform
- testSuites :: [TestSuiteLog]
- data TestSuiteLog = TestSuiteLog {}
- data Case = Case {
- caseName :: String
- caseOptions :: Options
- caseResult :: Result
- suitePassed :: TestSuiteLog -> Bool
- suiteFailed :: TestSuiteLog -> Bool
- suiteError :: TestSuiteLog -> Bool
Documentation
:: PackageDescription | information from the .cabal file |
-> LocalBuildInfo | information from the configure step |
-> TestFlags | flags sent to test |
-> IO () |
Perform the "./setup test
" action.
runTests :: [Test] -> IO ()Source
The test runner used in library TestSuite stub executables. Runs a list
of Test
s. An executable calling this function is meant to be invoked as
the child of a Cabal process during ./setup test
. A TestSuiteLog
,
provided by Cabal, is read from the standard input; it supplies the name of
the test suite and the location of the machine-readable test suite log file.
Human-readable log information is written to the standard output for capture
by the calling Cabal process.
:: TestSuite | library |
-> FilePath | path to directory where stub source should be located |
-> IO () |
Write the source file for a library TestSuite
stub executable.
stubFilePath :: TestSuite -> FilePathSource
The filename of the source file for the stub executable associated with a
library TestSuite
.
stubName :: TestSuite -> FilePathSource
The name of the stub executable associated with a library TestSuite
.
data PackageLog Source
Logs all test results for a package, broken down first by test suite and then by test case.
PackageLog | |
|
data TestSuiteLog Source
Logs test suite results, itemized by test case.
Case | |
|
suitePassed :: TestSuiteLog -> BoolSource
From a TestSuiteLog
, determine if the test suite passed.
suiteFailed :: TestSuiteLog -> BoolSource
From a TestSuiteLog
, determine if the test suite failed.
suiteError :: TestSuiteLog -> BoolSource
From a TestSuiteLog
, determine if the test suite encountered errors.