{-# 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 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