Cabal-2.4.0.1: A framework for packaging Haskell software

CopyrightIan Lynagh 2007
LicenseBSD3
Maintainercabal-devel@haskell.org
Portabilityportable
Safe HaskellNone
LanguageHaskell2010

Distribution.Verbosity

Contents

Description

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.

Synopsis

Verbosity

data Verbosity Source #

Instances
Bounded Verbosity # 
Instance details

Defined in Distribution.Verbosity

Methods

minBound :: Verbosity Source #

maxBound :: Verbosity Source #

Enum Verbosity # 
Instance details

Defined in Distribution.Verbosity

Methods

succ :: Verbosity -> Verbosity Source #

pred :: Verbosity -> Verbosity Source #

toEnum :: Int -> Verbosity Source #

fromEnum :: Verbosity -> Int Source #

enumFrom :: Verbosity -> [Verbosity] Source #

enumFromThen :: Verbosity -> Verbosity -> [Verbosity] Source #

enumFromTo :: Verbosity -> Verbosity -> [Verbosity] Source #

enumFromThenTo :: Verbosity -> Verbosity -> Verbosity -> [Verbosity] Source #

Eq Verbosity # 
Instance details

Defined in Distribution.Verbosity

Methods

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

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

Ord Verbosity # 
Instance details

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 # 
Instance details

Defined in Distribution.Verbosity

Methods

readsPrec :: Int -> ReadS Verbosity Source #

readList :: ReadS [Verbosity] Source #

readPrec :: ReadPrec Verbosity Source #

readListPrec :: ReadPrec [Verbosity] Source #

Show Verbosity # 
Instance details

Defined in Distribution.Verbosity

Methods

showsPrec :: Int -> Verbosity -> ShowS Source #

show :: Verbosity -> String Source #

showList :: [Verbosity] -> ShowS Source #

Generic Verbosity # 
Instance details

Defined in Distribution.Verbosity

Associated Types

type Rep Verbosity :: Type -> Type Source #

Methods

from :: Verbosity -> Rep Verbosity x Source #

to :: Rep Verbosity x -> Verbosity Source #

Binary Verbosity # 
Instance details

Defined in Distribution.Verbosity

Methods

put :: Verbosity -> Put Source #

get :: Get Verbosity Source #

putList :: [Verbosity] -> Put Source #

type Rep Verbosity # 
Instance details

Defined in Distribution.Verbosity

type Rep Verbosity

silent :: Verbosity Source #

normal :: Verbosity Source #

verbose :: Verbosity Source #

deafening :: Verbosity Source #

moreVerbose :: Verbosity -> Verbosity Source #

lessVerbose :: Verbosity -> Verbosity Source #

isVerboseQuiet :: Verbosity -> Bool Source #

Test if we had called lessVerbose on the verbosity

intToVerbosity :: Int -> Maybe Verbosity Source #

flagToVerbosity :: ReadE Verbosity Source #

showForCabal :: Verbosity -> String Source #

showForGHC :: Verbosity -> String Source #

verboseNoFlags :: Verbosity -> Verbosity Source #

Turn off all flags

verboseHasFlags :: Verbosity -> Bool Source #

modifyVerbosity :: (Verbosity -> Verbosity) -> Verbosity -> Verbosity Source #

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: Cabal-2.0.1.0

Call stacks

verboseCallSite :: Verbosity -> Verbosity Source #

Turn on verbose call-site printing when we log.

verboseCallStack :: Verbosity -> Verbosity Source #

Turn on verbose call-stack printing when we log.

isVerboseCallSite :: Verbosity -> Bool Source #

Test if we should output call sites when we log.

isVerboseCallStack :: Verbosity -> Bool Source #

Test if we should output call stacks when we log.

Output markets

verboseMarkOutput :: Verbosity -> Verbosity Source #

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

isVerboseMarkOutput :: Verbosity -> Bool Source #

Test if we should output markets.

verboseUnmarkOutput :: Verbosity -> Verbosity Source #

Turn off marking; useful for suppressing nondeterministic output.

line-wrapping

verboseNoWrap :: Verbosity -> Verbosity Source #

Disable line-wrapping for log messages.

isVerboseNoWrap :: Verbosity -> Bool Source #

Test if line-wrapping is disabled for log messages.

timestamps

verboseTimestamp :: Verbosity -> Verbosity Source #

Turn on timestamps for log messages.

isVerboseTimestamp :: Verbosity -> Bool Source #

Test if if we should output timestamps when we log.

verboseNoTimestamp :: Verbosity -> Verbosity Source #

Turn off timestamps for log messages.