ColoredBaseFormatter

ColoredBaseFormatter

class DIRAC.FrameworkSystem.private.standardLogging.Formatter.ColoredBaseFormatter.ColoredBaseFormatter(fmt=None, datefmt=None)

Bases: BaseFormatter

ColoredBaseFormatter is used to format log record to create a string representing a log message. It is based on the BaseFormatter object which is based on the of the standard logging library.

This custom formatter is useful for format messages to correspond with the gLogger format. It adds color on all messages which come from StdoutBackend and StderrBackend and color them according to their levels.

COLOR_MAP = {'black': 0, 'blue': 4, 'cyan': 6, 'green': 2, 'magenta': 5, 'red': 1, 'white': 7, 'yellow': 3}
LEVEL_MAP = {'ALWAYS': ('black', 'white', False), 'DEBUG': (None, 'blue', False), 'ERROR': (None, 'red', False), 'FATAL': ('red', 'black', False), 'INFO': (None, 'green', False), 'NOTICE': (None, 'magenta', False), 'VERBOSE': (None, 'cyan', False), 'WARN': (None, 'yellow', False)}
__init__(fmt=None, datefmt=None)

Initialize the formatter without using parameters. They are then modified in format()

Parameters:
  • fmt (str) – log format: “%(asctime)s UTC %(name)s %(levelname)s: %(message)”

  • datefmt (str) – date format: “%Y-%m-%d %H:%M:%S”

converter()
localtime([seconds]) -> (tm_year,tm_mon,tm_mday,tm_hour,tm_min,

tm_sec,tm_wday,tm_yday,tm_isdst)

Convert seconds since the Epoch to a time tuple expressing local time. When ‘seconds’ is not passed in, convert the current time instead.

default_msec_format = '%s,%03d'
default_time_format = '%Y-%m-%d %H:%M:%S'
format(record)

Overriding. format is the main method of the Formatter object because it is the method which transforms a log record into a string with colors. According to the level, the method get colors from LEVEL_MAP to add them to the message.

Parameters:

record – the log record containing all the information about the log message: name, level, threadid…

formatException(ei)

Format and return the specified exception information as a string.

This default implementation just uses traceback.print_exception()

formatMessage(record)
formatStack(stack_info)

This method is provided as an extension point for specialized formatting of stack information.

The input data is a string as returned from a call to traceback.print_stack(), but with the last trailing newline removed.

The base implementation just returns the value passed in.

formatTime(record, datefmt=None)

logging.Formatter.formatTime() with microsecond precision by default

usesTime()

Check if the format uses the creation time of the record.