fast-logger-3.1.2: A fast logging system
Safe Haskell Safe-Inferred
Language Haskell2010

System.Log.FastLogger.LoggerSet

Synopsis

Creating a logger set

data LoggerSet Source #

A set of loggers. The number of loggers is the capabilities of GHC RTS. You can specify it with "+RTS -N<x>". A buffer is prepared for each capability.

newFileLoggerSet :: BufSize -> FilePath -> IO LoggerSet Source #

Creating a new LoggerSet using a file.

Uses numCapabilties many buffers, which will result in log output that is not ordered by time (see newFileLoggerSetN ).

newFileLoggerSetN :: BufSize -> Maybe Int -> FilePath -> IO LoggerSet Source #

Creating a new LoggerSet using a file, using only the given number of capabilites.

Giving mn = Just 1 scales less well on multi-core machines, but provides time-ordered output.

newStdoutLoggerSetN :: BufSize -> Maybe Int -> IO LoggerSet Source #

Creating a new LoggerSet using stdout, with the given number of buffers (see newFileLoggerSetN ).

newStderrLoggerSetN :: BufSize -> Maybe Int -> IO LoggerSet Source #

Creating a new LoggerSet using stderr, with the given number of buffers (see newFileLoggerSetN ).

newLoggerSet :: BufSize -> Maybe Int -> Maybe FilePath -> IO LoggerSet Source #

Deprecated: Use newFileLoggerSet etc instead

Creating a new LoggerSet . If Nothing is specified to the second argument, stdout is used. Please note that the minimum BufSize is 1.

Renewing and removing a logger set

renewLoggerSet :: LoggerSet -> IO () Source #

Renewing the internal file information in LoggerSet . This does nothing for stdout and stderr.

rmLoggerSet :: LoggerSet -> IO () Source #

Flushing the buffers, closing the internal file information and freeing the buffers.

Writing a log message

pushLogStr :: LoggerSet -> LogStr -> IO () Source #

Writing a log message to the corresponding buffer. If the buffer becomes full, the log messages in the buffer are written to its corresponding file, stdout, or stderr.

pushLogStrLn :: LoggerSet -> LogStr -> IO () Source #

Same as pushLogStr but also appends a newline.

Flushing buffered log messages

flushLogStr :: LoggerSet -> IO () Source #

Flushing log messages in buffers. This function must be called explicitly when the program is being terminated.

Note: Since version 2.1.6, this function does not need to be explicitly called, as every push includes an auto-debounced flush courtesy of the auto-update package. Since version 2.2.2, this function can be used to force flushing outside of the debounced flush calls.

Misc

replaceLoggerSet :: LoggerSet -> FilePath -> ( LoggerSet , Maybe FilePath ) Source #

Replacing the file path in LoggerSet and returning a new LoggerSet and the old file path.