ExtraFormatter

ExtraFormatter#

Module: exa.common.logger.logger

class ExtraFormatter(*args, extra_info_getter=None, **kwargs)#

Bases: Formatter

Helper formatter class to pass in arbitrary extra information to log messages.

Initialize the formatter with specified format strings.

Initialize the formatter either with the specified format string, or a default as described above. Allow for specialized date formatting with the optional datefmt argument. If datefmt is omitted, you get an ISO8601-like (or RFC 3339-like) format.

Use a style parameter of ‘%’, ‘{’ or ‘$’ to specify that you want to use one of %-formatting, str.format() ({}) formatting or string.Template formatting in your format string.

Changed in version 3.2: Added the style parameter.

Attributes

Methods

format

Format the specified record as text.

Parameters:

extra_info_getter (Callable[[], str] | None)

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.

Inheritance

Inheritance diagram of exa.common.logger.logger.ExtraFormatter