hspec-api-2.11.9: A Testing Framework for Haskell
Stabilitystable
Safe HaskellSafe-Inferred
LanguageHaskell2010

Test.Hspec.Api.Formatters.V3

Description

This module contains formatters that can be used with hspecWith:

import Test.Hspec
import Test.Hspec.Api.Formatters.V1

main :: IO ()
main = hspecWith (useFormatter ("my-formatter", formatter) defaultConfig) spec

formatter :: Formatter
formatter = ...

spec :: Spec
spec = ...
Synopsis

Register a formatter

registerFormatter :: (String, Formatter) -> Config -> Config Source #

Make a formatter available for use with --format.

useFormatter :: (String, Formatter) -> Config -> Config Source #

Make a formatter available for use with --format and use it by default.

Formatters

Implementing a custom Formatter

A formatter is a set of actions. Each action is evaluated when a certain situation is encountered during a test run.

Actions live in the FormatM monad. It provides access to the runner state and primitives for appending to the generated report.

type Path = ([String], String) Source #

A Path describes the location of a spec item within a spec tree.

It consists of a list of group descriptions and a requirement description.

Since: hspec-core-2.0.0

type Progress = (Int, Int) Source #

data Location Source #

Location is used to represent source locations.

data Item Source #

Instances

Instances details
Show Item 
Instance details

Defined in Test.Hspec.Core.Format

data Result Source #

Instances

Instances details
Show Result 
Instance details

Defined in Test.Hspec.Core.Format

data FormatM a Source #

Instances

Instances details
MonadIO FormatM 
Instance details

Defined in Test.Hspec.Core.Formatters.Internal

Methods

liftIO :: IO a -> FormatM a Source #

Applicative FormatM 
Instance details

Defined in Test.Hspec.Core.Formatters.Internal

Methods

pure :: a -> FormatM a Source #

(<*>) :: FormatM (a -> b) -> FormatM a -> FormatM b Source #

liftA2 :: (a -> b -> c) -> FormatM a -> FormatM b -> FormatM c Source #

(*>) :: FormatM a -> FormatM b -> FormatM b Source #

(<*) :: FormatM a -> FormatM b -> FormatM a Source #

Functor FormatM 
Instance details

Defined in Test.Hspec.Core.Formatters.Internal

Methods

fmap :: (a -> b) -> FormatM a -> FormatM b Source #

(<$) :: a -> FormatM b -> FormatM a Source #

Monad FormatM 
Instance details

Defined in Test.Hspec.Core.Formatters.Internal

Methods

(>>=) :: FormatM a -> (a -> FormatM b) -> FormatM b Source #

(>>) :: FormatM a -> FormatM b -> FormatM b Source #

return :: a -> FormatM a Source #

Accessing config values

getConfigValue :: (FormatConfig -> a) -> FormatM a Source #

Since: 2.11.5

Accessing the runner state

getSuccessCount :: FormatM Int Source #

Get the number of successful examples encountered so far.

getPendingCount :: FormatM Int Source #

Get the number of pending examples encountered so far.

getFailCount :: FormatM Int Source #

Get the number of failed examples encountered so far.

getTotalCount :: FormatM Int Source #

Get the total number of examples encountered so far.

getExpectedTotalCount :: FormatM Int Source #

Get the number of spec items that will have been encountered when this run completes (if it is not terminated early).

Since: hspec-core-2.9.0

getFailMessages :: FormatM [FailureRecord] Source #

Get the list of accumulated failure messages.

usedSeed :: FormatM Integer Source #

The random seed that is used for QuickCheck.

printTimes :: FormatM Bool Source #

Return True if the user requested time reporting for individual spec items, False otherwise.

newtype Seconds Source #

Constructors

Seconds Double 

getCPUTime :: FormatM (Maybe Seconds) Source #

Get the used CPU time since the test run has been started.

getRealTime :: FormatM Seconds Source #

Get the passed real time since the test run has been started.

Appending to the generated report

write :: String -> FormatM () Source #

Append some output to the report.

writeLine :: String -> FormatM () Source #

The same as write, but adds a newline character.

Dealing with colors

withInfoColor :: FormatM a -> FormatM a Source #

Set output color to cyan, run given action, and finally restore the default color.

withSuccessColor :: FormatM a -> FormatM a Source #

Set output color to green, run given action, and finally restore the default color.

withPendingColor :: FormatM a -> FormatM a Source #

Set output color to yellow, run given action, and finally restore the default color.

withFailColor :: FormatM a -> FormatM a Source #

Set output color to red, run given action, and finally restore the default color.

outputUnicode :: FormatM Bool Source #

Return True if the user requested unicode output, False otherwise.

Since: hspec-core-2.9.0

useDiff :: FormatM Bool Source #

Return True if the user requested colorized diffs, False otherwise.

diffContext :: FormatM (Maybe Int) Source #

Return the value of configDiffContext.

Since: hspec-core-2.10.6

externalDiffAction :: FormatM (Maybe (String -> String -> IO ())) Source #

An action for printing diffs.

The action takes expected and actual as arguments.

When this is a Just-value then it should be used instead of any built-in diff implementation. A Just-value also implies that useDiff returns True.

Since: hspec-core-2.10.6

prettyPrint :: FormatM Bool Source #

Return True if the user requested pretty diffs, False otherwise.

prettyPrintFunction :: FormatM (Maybe (String -> String -> (String, String))) Source #

Return a function for pretty-printing if the user requested pretty diffs, Nothing otherwise.

Since: hspec-core-2.10.0

extraChunk :: String -> FormatM () Source #

Output given chunk in red.

missingChunk :: String -> FormatM () Source #

Output given chunk in green.

expert mode

unlessExpert :: FormatM () -> FormatM () Source #

Do nothing on `--expert`, otherwise run the given action.

Since: hspec-core-2.11.2

Helpers

formatException :: SomeException -> String Source #

The function formatException converts an exception to a string.

This is different from show. The type of the exception is included, e.g.:

>>> formatException (toException DivideByZero)
"ArithException\ndivide by zero"

For IOExceptions the IOErrorType is included, as well.

Since: hspec-core-2.0.0

Re-exports

type SpecWith a = SpecM a () Source #

modifyConfig :: (Config -> Config) -> SpecWith a Source #

Since: hspec-core-2.10.0