Distribution.Verbosity

A Verbosity type with associated utilities.

There are 4 standard verbosity levels from silent, normal, verbose up to deafening. This is used for deciding what logging messages to print.

Verbosity also is equipped with some internal settings which can be used to control at a fine granularity the verbosity of specific settings (e.g., so that you can trace only particular things you are interested in.) It's important to note that the instances for Verbosity assume that this does not exist.

Verbosity

data Verbosity

Instances

Bounded Verbosity

Defined in Distribution.Verbosity

Methods

minBound :: Verbosity

maxBound :: Verbosity

Enum Verbosity

Defined in Distribution.Verbosity

Methods

succ :: Verbosity -> Verbosity

pred :: Verbosity -> Verbosity

toEnum :: Int -> Verbosity

fromEnum :: Verbosity -> Int

enumFrom :: Verbosity -> [Verbosity]

enumFromThen :: Verbosity -> Verbosity -> [Verbosity]

enumFromTo :: Verbosity -> Verbosity -> [Verbosity]

enumFromThenTo :: Verbosity -> Verbosity -> Verbosity -> [Verbosity]

Eq Verbosity

Defined in Distribution.Verbosity

Methods

(==) :: Verbosity -> Verbosity -> Bool

(/=) :: Verbosity -> Verbosity -> Bool

Ord Verbosity

Defined in Distribution.Verbosity

Methods

compare :: Verbosity -> Verbosity -> Ordering

(<) :: Verbosity -> Verbosity -> Bool

(<=) :: Verbosity -> Verbosity -> Bool

(>) :: Verbosity -> Verbosity -> Bool

(>=) :: Verbosity -> Verbosity -> Bool

max :: Verbosity -> Verbosity -> Verbosity

min :: Verbosity -> Verbosity -> Verbosity

Read Verbosity

Defined in Distribution.Verbosity

Methods

readsPrec :: Int -> ReadS Verbosity

readList :: ReadS [Verbosity]

readPrec :: ReadPrec Verbosity

readListPrec :: ReadPrec [Verbosity]

Show Verbosity

Defined in Distribution.Verbosity

Methods

showsPrec :: Int -> Verbosity -> ShowS

show :: Verbosity -> String

showList :: [Verbosity] -> ShowS

Generic Verbosity

Defined in Distribution.Verbosity

Associated Types

type Rep Verbosity :: Type -> Type

Methods

from :: Verbosity -> Rep Verbosity x

to :: Rep Verbosity x -> Verbosity

Binary Verbosity

Defined in Distribution.Verbosity

Methods

put :: Verbosity -> Put

get :: Get Verbosity

putList :: [Verbosity] -> Put

Structured Verbosity

Defined in Distribution.Verbosity

Methods

structure :: Proxy Verbosity -> Structure

structureHash' :: Tagged Verbosity MD5

Pretty Verbosity

Defined in Distribution.Verbosity

Methods

pretty :: Verbosity -> Doc

prettyVersioned :: CabalSpecVersion -> Verbosity -> Doc

Parsec Verbosity

Parser verbosity

>>> explicitEitherParsec parsecVerbosity "normal"
Right (Verbosity {vLevel = Normal, vFlags = fromList [], vQuiet = False})

>>> explicitEitherParsec parsecVerbosity "normal+nowrap  "
Right (Verbosity {vLevel = Normal, vFlags = fromList [VNoWrap], vQuiet = False})

>>> explicitEitherParsec parsecVerbosity "normal+nowrap +markoutput"
Right (Verbosity {vLevel = Normal, vFlags = fromList [VNoWrap,VMarkOutput], vQuiet = False})

>>> explicitEitherParsec parsecVerbosity "normal +nowrap +markoutput"
Right (Verbosity {vLevel = Normal, vFlags = fromList [VNoWrap,VMarkOutput], vQuiet = False})

>>> explicitEitherParsec parsecVerbosity "normal+nowrap+markoutput"
Right (Verbosity {vLevel = Normal, vFlags = fromList [VNoWrap,VMarkOutput], vQuiet = False})

>>> explicitEitherParsec parsecVerbosity "deafening+nowrap+stdout+stderr+callsite+callstack"
Right (Verbosity {vLevel = Deafening, vFlags = fromList [VCallStack,VCallSite,VNoWrap,VStderr], vQuiet = False})

Note: this parser will eat trailing spaces.

Defined in Distribution.Verbosity

Methods

parsec :: CabalParsing m => m Verbosity

type Rep Verbosity

Defined in Distribution.Verbosity

type Rep Verbosity = D1 ('MetaData "Verbosity" "Distribution.Verbosity" "Cabal-3.6.3.0-I4Ii3Qpj1svLmdsaKaNlun" 'False) (C1 ('MetaCons "Verbosity" 'PrefixI 'True) (S1 ('MetaSel ('Just "vLevel") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 VerbosityLevel) :*: (S1 ('MetaSel ('Just "vFlags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Set VerbosityFlag)) :*: S1 ('MetaSel ('Just "vQuiet") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Bool))))

silent :: Verbosity

normal :: Verbosity

verbose :: Verbosity

deafening :: Verbosity

moreVerbose :: Verbosity -> Verbosity

lessVerbose :: Verbosity -> Verbosity

isVerboseQuiet :: Verbosity -> Bool

Test if we had called lessVerbose on the verbosity

intToVerbosity :: Int -> Maybe Verbosity

flagToVerbosity :: ReadE Verbosity

showForCabal :: Verbosity -> String

showForGHC :: Verbosity -> String

verboseNoFlags :: Verbosity -> Verbosity

Turn off all flags

verboseHasFlags :: Verbosity -> Bool

modifyVerbosity :: (Verbosity -> Verbosity) -> Verbosity -> Verbosity

Combinator for transforming verbosity level while retaining the original hidden state.

For instance, the following property holds

isVerboseNoWrap (modifyVerbosity (max verbose) v) == isVerboseNoWrap v

Note: you can use modifyVerbosity (const v1) v0 to overwrite v1's flags with v0's flags.

Since: 2.0.1.0

Call stacks

verboseCallSite :: Verbosity -> Verbosity

Turn on verbose call-site printing when we log.

verboseCallStack :: Verbosity -> Verbosity

Turn on verbose call-stack printing when we log.

isVerboseCallSite :: Verbosity -> Bool

Test if we should output call sites when we log.

isVerboseCallStack :: Verbosity -> Bool

Test if we should output call stacks when we log.

Output markets

verboseMarkOutput :: Verbosity -> Verbosity

Turn on -----BEGIN CABAL OUTPUT----- markers for output from Cabal (as opposed to GHC, or system dependent).

isVerboseMarkOutput :: Verbosity -> Bool

Test if we should output markets.

verboseUnmarkOutput :: Verbosity -> Verbosity

Turn off marking; useful for suppressing nondeterministic output.

line-wrapping

verboseNoWrap :: Verbosity -> Verbosity

Disable line-wrapping for log messages.

isVerboseNoWrap :: Verbosity -> Bool

Test if line-wrapping is disabled for log messages.

timestamps

verboseTimestamp :: Verbosity -> Verbosity

Turn on timestamps for log messages.

isVerboseTimestamp :: Verbosity -> Bool

Test if we should output timestamps when we log.

verboseNoTimestamp :: Verbosity -> Verbosity

Turn off timestamps for log messages.

Stderr

verboseStderr :: Verbosity -> Verbosity

Turn on timestamps for log messages.

Since: 3.4.0.0

isVerboseStderr :: Verbosity -> Bool

Test if we should output to stderr when we log.

Since: 3.4.0.0

verboseNoStderr :: Verbosity -> Verbosity

Turn off timestamps for log messages.

Since: 3.4.0.0