file-location-0.2.0: common functions that show file location information

FileLocation

Description

see Debug.FileLocation module for more definitions

Synopsis

Documentation

err :: String -> Q ExpSource

like Prelude.error, but gives the file location

 $(err "OH NO!)
 main:Main main.hs:4:10 OH NO!

undef :: Q ExpSource

like Prelude.undefined, but gives the file location use trace to output the location. this way we still use undefined instead of calling error

 $(undef)
 main:Main main.hs:4:10 undefined
 err: Prelude.undefined

debug :: Show a => a -> aSource

A version of Debug.Trace.trace that just prints a value. This should be included in Debug.Trace

debugM :: (Monad m, Show a) => a -> m aSource

monadic debug - like debug, but works as a standalone line in a monad TODO: TH version with error loaction info

debugMsg :: Show a => String -> a -> aSource

A version of Debug.Trace.trace that just prints a value and a message. This should be included in Debug.Trace

dbg :: Q ExpSource

TH version of Debug.Trace.trace that just prints a value.

dbgMsg :: String -> Q ExpSource

TH version of Debug.Trace.trace that prints a value and a message prefix).

trc :: String -> Q ExpSource

A TH version of Debug.Trace.trace that prints location information

ltrace :: Show a => String -> a -> aSource

labelled trace - like strace, with a label prepended

ltraceM :: (Monad m, Show a) => String -> a -> m aSource

monadic debug - like debug, but works as a standalone line in a monad TODO: TH version with error loaction info

strace :: Show a => a -> aSource

trace (print on stdout at runtime) a showable expression like debug, but does not print DEBUG: