pymor.core.logger

This module contains pyMOR’s logging facilities.

pyMOR’s logging facilities are based on the logging module of the Python standard library. To obtain a new logger object use getLogger. Logging can be configured via the set_log_format and set_log_levels methods.

Module Contents

pymor.core.logger.BLOCK

pymor.core.logger.BLOCK_TIME

pymor.core.logger.BLOCK_TIMINGS = True

pymor.core.logger.BOLD_SEQ = 

pymor.core.logger.COLORS

pymor.core.logger.COLOR_SEQ = [1;%dm

pymor.core.logger.CSSCOLORS

pymor.core.logger.INDENT = 0

pymor.core.logger.INDENT_BLOCKS = True

pymor.core.logger.INFO2

pymor.core.logger.INFO3

pymor.core.logger.LAST_TIMESTAMP_LENGTH = 0

pymor.core.logger.MAX_HIERARCHY_LEVEL = 1

pymor.core.logger.RESET_SEQ = 

pymor.core.logger.dummy_logger

pymor.core.logger.start_time

class pymor.core.logger.ColoredFormatter

Bases: logging.Formatter

A logging.Formatter that colors loglevel keyword output.

Coloring can be disabled by setting the PYMOR_COLORS_DISABLE environment variable to 1.

Methods

format	Format the specified record as text.
format_html

format(record)

Format the specified record as text.

The record’s attribute dictionary is used as the operand to a string formatting operation which yields the returned string. Before formatting the dictionary, a couple of preparatory steps are carried out. The message attribute of the record is computed using LogRecord.getMessage(). If the formatting string uses the time (as determined by a call to usesTime(), formatTime() is called to format the event time. If there is exception information, it is formatted using formatException() and appended to the message.

format_html(record)

class pymor.core.logger.DummyLogger

Methods

block
getChild
getEffectiveLevel
info2
info3
isEnabledFor
nop

critical

debug

error

exception

info

log

propagate = False

warn

warning

block(msg, *args, **kwargs)

getChild()

getEffectiveLevel()

info2(msg, *args, **kwargs)

info3(msg, *args, **kwargs)

isEnabledFor(lvl)

nop(*args, **kwargs)

class pymor.core.logger.LogIndenter(logger, doit)

pymor.core.logger.default_handler(filename=None)

pymor.core.logger.getLogger(module, level=None, filename=None)

Get the logger of the respective module for pyMOR’s logging facility.

In addition to the logging methods inherited from Logger all returned loggers get a block, info2, info3 method for the respective new levels. Plus all warnings methods get a XXX_once method that caches the msg and only emits the log entry the first time (per logger instance, not globally).

Parameters

module

Name of the module.

level

If set, logger.setLevel(level) is called (see setLevel).

filename

If not empty, path of an existing file where everything logged will be written to.

pymor.core.logger.log_levels(level_mapping)

Change levels for given loggers on entry and reset to before state on exit.

Parameters

level_mapping

a dict of logger name -> level name

pymor.core.logger.set_log_format(max_hierarchy_level=1, indent_blocks=True, block_timings=False)

Set log levels for pyMOR’s logging facility.

Parameters

max_hierarchy_level

The number of components of the loggers name which are printed. (The first component is always stripped, the last component always preserved.)

indent_blocks

If True, indent log messages inside a code block started with with logger.block(...).

block_timings

If True, measure the duration of a code block started with with logger.block(...).

pymor.core.logger.set_log_levels(levels=None)

Set log levels for pyMOR’s logging facility.

Parameters

levels

Dict of log levels. Keys are names of loggers (see logging.getLogger), values are the log levels to set for the loggers of the given names (see setLevel).