{-# LANGUAGE CPP #-}
module Utils.Debug
( module Debug.Trace
, traceWith
, strace
, ltrace
, mtrace
, ptrace
, ppShow
, debugLevel
, dbg
, dbg0
, dbg1
, dbg2
, dbg3
, dbg4
, dbg5
, dbg6
, dbg7
, dbg8
, dbg9
, dbgAt
, dbgAtIO
-- , dbgAtM
-- , dbgtrace
-- , dbgshow
-- , dbgppshow
, dbgExit
, pdbg
)
where
import Debug.Trace (trace)
import Control.Monad (when)
import Data.List
import Safe (readDef)
import System.Environment (getArgs)
import System.Exit
import System.IO.Unsafe (unsafePerformIO)
import Text.Parsec (getPosition, getInput, sourceLine, sourceColumn)
import Text.Parsec.String (GenParser)
import Text.Printf
-- ppShow is good at prettyifying many type's default show format
#if __GLASGOW_HASKELL__ >= 704
-- a good version of it requires GHC 7.4+
import Text.Show.Pretty (ppShow)
#else
-- otherwise just use show
ppShow :: Show a => a -> String
ppShow = show
#endif
-- | Trace a value using some string-producing function.
traceWith :: (a -> String) -> a -> a
traceWith f e = trace (f e) e
-- | Trace a showable value by showing it.
strace :: Show a => a -> a
strace = traceWith show
-- | Labelled trace - like strace, with a label prepended.
ltrace :: Show a => String -> a -> a
ltrace l a = trace (l ++ ": " ++ show a) a
-- | Monadic trace - like strace, but works as a standalone line in a monad.
mtrace :: (Monad m, Show a) => a -> m a
mtrace a = strace a `seq` return a
-- | Parsec trace - show the current parsec position and next input,
-- and the provided label if it's non-null.
ptrace :: String -> GenParser Char st ()
ptrace msg = do
pos <- getPosition
next <- take peeklength `fmap` getInput
let (l,c) = (sourceLine pos, sourceColumn pos)
s = printf "at line %2d col %2d: %s" l c (show next) :: String
s' = printf ("%-"++show (peeklength+30)++"s") s ++ " " ++ msg
trace s' $ return ()
where
peeklength = 30
-- | Global debug level, which controls the verbosity of debug output
-- on the console. The default is 0 meaning no debug output. The
-- @--debug@ command line flag sets it to 1, or @--debug=N@ sets it to
-- a higher value (note: not @--debug N@ for some reason). This uses
-- unsafePerformIO and can be accessed from anywhere and before normal
-- command-line processing. After command-line processing, it is also
-- available as the @debug_@ field of 'Hledger.Cli.Options.CliOpts'.
debugLevel :: Int
debugLevel = case snd $ break (=="--debug") args of
"--debug":[] -> 1
"--debug":n:_ -> readDef 1 n
_ ->
case take 1 $ filter ("--debug" `isPrefixOf`) args of
['-':'-':'d':'e':'b':'u':'g':'=':v] -> readDef 1 v
_ -> 0
where
args = unsafePerformIO getArgs
-- | Print a message and a showable value to the console if the global
-- debug level is non-zero. Uses unsafePerformIO.
dbg :: Show a => String -> a -> a
dbg = dbg1
-- always prints
dbg0 :: Show a => String -> a -> a
dbg0 = dbgAt 0
dbg1 :: Show a => String -> a -> a
dbg1 = dbgAt 1
dbg2 :: Show a => String -> a -> a
dbg2 = dbgAt 2
dbg3 :: Show a => String -> a -> a
dbg3 = dbgAt 3
dbg4 :: Show a => String -> a -> a
dbg4 = dbgAt 4
dbg5 :: Show a => String -> a -> a
dbg5 = dbgAt 5
dbg6 :: Show a => String -> a -> a
dbg6 = dbgAt 6
dbg7 :: Show a => String -> a -> a
dbg7 = dbgAt 7
dbg8 :: Show a => String -> a -> a
dbg8 = dbgAt 8
dbg9 :: Show a => String -> a -> a
dbg9 = dbgAt 9
-- | Print a message and a showable value to the console if the global
-- debug level is at or above the specified level. Uses unsafePerformIO.
dbgAt :: Show a => Int -> String -> a -> a
dbgAt lvl = dbgppshow lvl
-- Could not deduce (a ~ ())
-- from the context (Show a)
-- bound by the type signature for
-- dbgM :: Show a => String -> a -> IO ()
-- at hledger/Hledger/Cli/Main.hs:200:13-42
-- ‘a’ is a rigid type variable bound by
-- the type signature for dbgM :: Show a => String -> a -> IO ()
-- at hledger/Hledger/Cli/Main.hs:200:13
-- Expected type: String -> a -> IO ()
-- Actual type: String -> a -> IO a
-- -- dbgAtM :: (Monad m, Show a) => Int -> String -> a -> m a
-- -- dbgAtM lvl lbl x = dbgAt lvl lbl x `seq` return x
-- -- XXX temporary:
-- dbgAtM :: Show a => Int -> String -> a -> IO ()
-- dbgAtM = dbgAtIO
dbgAtIO :: Show a => Int -> String -> a -> IO ()
dbgAtIO lvl lbl x = dbgAt lvl lbl x `seq` return ()
-- -- | print this string to the console before evaluating the expression,
-- -- if the global debug level is non-zero. Uses unsafePerformIO.
-- dbgtrace :: String -> a -> a
-- dbgtrace
-- | debugLevel > 0 = trace
-- | otherwise = flip const
-- -- | Print a showable value to the console, with a message, if the
-- -- debug level is at or above the specified level (uses
-- -- unsafePerformIO).
-- -- Values are displayed with show, all on one line, which is hard to read.
-- dbgshow :: Show a => Int -> String -> a -> a
-- dbgshow level
-- | debugLevel >= level = ltrace
-- | otherwise = flip const
-- | Print a showable value to the console, with a message, if the
-- debug level is at or above the specified level (uses
-- unsafePerformIO).
-- Values are displayed with ppShow, each field/constructor on its own line.
dbgppshow :: Show a => Int -> String -> a -> a
dbgppshow level
| debugLevel < level = flip const
| otherwise = \s a -> let p = ppShow a
ls = lines p
nlorspace | length ls > 1 = "\n"
| otherwise = " " ++ take (10 - length s) (repeat ' ')
ls' | length ls > 1 = map (" "++) ls
| otherwise = ls
in trace (s++":"++nlorspace++intercalate "\n" ls') a
-- -- | Print a showable value to the console, with a message, if the
-- -- debug level is at or above the specified level (uses
-- -- unsafePerformIO).
-- -- Values are displayed with pprint. Field names are not shown, but the
-- -- output is compact with smart line wrapping, long data elided,
-- -- and slow calculations timed out.
-- dbgpprint :: Data a => Int -> String -> a -> a
-- dbgpprint level msg a
-- | debugLevel >= level = unsafePerformIO $ do
-- pprint a >>= putStrLn . ((msg++": \n") ++) . show
-- return a
-- | otherwise = a
-- | Like dbg, then exit the program. Uses unsafePerformIO.
dbgExit :: Show a => String -> a -> a
dbgExit msg = const (unsafePerformIO exitFailure) . dbg msg
-- | Print a message and parsec debug info (parse position and next
-- input) to the console when the debug level is at or above
-- this level. Uses unsafePerformIO.
-- pdbgAt :: GenParser m => Float -> String -> m ()
pdbg level msg = when (level <= debugLevel) $ ptrace msg