rootpy.logger: Logging

rootpy overrides the default logging class, inserting a check that there exists a default logging handler. If there is not, it adds one.

In additon, this can be used to intercept ROOT’s log messages and redirect them through python’s logging subsystem

Example use:

# Disable colored logging (not needed if writing into a file,
# this is automatic).
# Must be done before :py:mod:`rootpy` logs any messages.
import logging; logging.basicConfig(level=logging.DEBUG)

from rootpy import log; log = log["/myapp"]
log.debug("Hello") # Results in "DEBUG:myapp] Hello"

# Suppress all myapp debug and info messages
log.setLevel(log.WARNING)
log.debug("Hello") # No effect

mymod = log["mymod"]
mymod.warning("Hello") # Results in "WARNING:myapp.mymod] Hello"

# Suppress all rootpy debug and info messages
log["/rootpy"].setLevel(log.WARNING)

# Suppress messages coming from TCanvas like
# INFO:ROOT.TCanvas.Print] png file /path/to/file.png has been created
log["/ROOT.TCanvas.Print"].setLevel(log.WARNING)

# Suppress warning messages coming the ``TClass`` constructor:
log["/ROOT.TClass.TClass"].setLevel(log.ERROR)

# Precisely remove messages containing the text "no dictionary for class"
# (doesn't work when attached to parent logger)
import logging
class NoDictMessagesFilter(logging.Filter):
    def filter(self, record):
        return "no dictionary for class" not in record.msg
log["/ROOT.TClass.TClass"].addFilter(NoDictMessagesFilter())

# Turn ROOT errors into exceptions
from rootpy.logger.magic import DANGER
DANGER.enable = True

import ROOT
ROOT.Error("test", "Test fatal")
# Result:
# ERROR:ROOT.test] Test fatal
# Traceback (most recent call last):
#   File "test.py", line 36, in <module>
#     ROOT.Fatal("test", "Test fatal")
#   File "test.py", line 36, in <module>
#     ROOT.Fatal("test", "Test fatal")
#   File "rootpy/logger/roothandler.py", line 40, in python_logging_error_handler
#     raise ROOTError(level, location, msg)
# rootpy.ROOTError: level=6000, loc='test', msg='Test fatal'

# Primitive function tracing:
@log.trace()
def salut():
    return

@log.trace()
def hello(what):
    salut()
    return "42"

hello("world")
# Result:
#   DEBUG:myapp.trace.hello] > ('world',) {}
#   DEBUG:myapp.trace.salut]  > () {}
#   DEBUG:myapp.trace.salut]  < return None [0.00 sec]
#   DEBUG:myapp.trace.hello] < return 42 [0.00 sec]

Classes

logger.LogFilter(logger, message_regex)

Functions

logger.log_trace(logger[, level, …])

log a statement on function entry and exit