Logging

A python logging style log library.

A simple example:

  {-# LANGUAGE OverloadedStrings #-}
  {-# LANGUAGE TemplateHaskell   #-}

  module Main ( main ) where

  import           Logging             (run)
  import           Logging.Config.Json (getManager)
  import           Logging.TH          (debug, error, fatal, info, logv, warn)
  import           Prelude             hiding (error)

  main :: IO ()
  main = getManager "{}" >>= flip run app

  myLogger = "MyLogger.Main"

  app :: IO ()
  app = do
    $(debug) myLogger "this is a test message"
    $(info) myLogger "this is a test message"
    $(warn) myLogger "this is a test message"
    $(error) myLogger "this is a test message"
    $(fatal) myLogger "this is a test message"
    $(logv) myLogger "LEVEL 100" "this is a test message"

See Logging.Config.Json and Logging.Config.Yaml to lean more about decoding Manager from json or yaml

Documentation

module Logging.Types

module Logging.TH

run :: Manager -> IO a -> IO a

Run a logging environment.

You should always write you application inside a logging environment.

1. rename "main" function to "originMain" (or whatever you call it)
2. write "main" as below

main :: IO ()
main = run manager originMain
...

stderrHandler :: StreamHandler

Deprecated: Will be removed

A StreamHandler bound to stderr

stdoutHandler :: StreamHandler

Deprecated: Will be removed

A StreamHandler bound to stdout

defaultRoot :: Sink

Deprecated: Will be removed

Default root sink which is used by Logging.Config.Json and Logging.Config.Yaml when root sink is omitted.