pysys.utils.logutils module

class pysys.utils.logutils.BaseLogFormatter(propertiesDict)

Bases: logging.Formatter

Base class for formatting log messages.

This implementation delegates everything to logging.Formatter using the messagefmt and datefmt properties. Subclasses may be implemented to provide required customizations, and can be registered by specifying classname in the formatter node of the project configuration file.

ARG_INDEX = 'log_arg_index'

CATEGORY = 'log_category'

__init__(propertiesDict)

Create an instance of the formatter class.

The class is constructed with a dictionary of properties, which are configured by providing <property name=”…” value=”…”/> elements or attributes on the formatter node of the project configuration file. Entries in the properties should be specific to the class, and removed when passing the properties to the super class, which will throw an exception if any unexpected options are present

Parameters:propertiesDict – dictionary of formatter-specific options

classmethod tag(category, arg_index=None)

Return dictionary to tag a string to format with color encodings.

Parameters:

• category – The category, as defined in ColorLogFormatter.COLOR_CATEGORIES
• arg_index – The index of argument in the string expansion to color. This can be either a single integer value representing the index, or a list of integers representing a set of indexes

Returns:

A dictionary that can then be used in calls to the logger

class pysys.utils.logutils.ColorLogFormatter(propertiesDict)

Bases: pysys.utils.logutils.BaseLogFormatter

Formatter supporting colored output to a console.

This implementation supports color coding of messages based on the category of the message, and the index of the string in the format encoding. This implementation is the default for console output, with the color coding enabled either by the color option on the formatter set to true.

The PYSYS_COLOR environment variable can be set to true or false, overriding any setting specified in the project configuration.

The colors used for each category defined by this class can be overridden by specifying “color:XXX” options, e.g. <formatter><property name=”color:dumped core” value=”YELLOW”/></formatter>

Variables:

• COLOR_CATEGORIES (dictionary) – the color map for the defined logging categories
• COLOR_ESCAPE_CODES (dictionary) – the escape codes for each of the support colors

COLOR_CATEGORIES = {'debug': 'BLUE', 'details': 'CYAN', 'end': 'END', 'error': 'RED', 'failed': 'RED', 'filecontents': 'BLUE', 'outcomereason': 'CYAN', 'passed': 'GREEN', 'performance': 'CYAN', 'progress': 'CYAN', 'skipped': 'YELLOW', 'timed out': 'MAGENTA', 'traceback': 'RED', 'warn': 'MAGENTA'}

COLOR_ESCAPE_CODES = {'BLACK': '\x1b[30m', 'BLUE': '\x1b[94m', 'CYAN': '\x1b[96m', 'END': '\x1b[0m', 'GREEN': '\x1b[92m', 'MAGENTA': '\x1b[95m', 'RED': '\x1b[91m', 'WHITE': '\x1b[97m', 'YELLOW': '\x1b[93m'}

__init__(propertiesDict)

Create an instance of the formatter class.

colorCategoryToEscapeSequence(category)

Return the escape sequence to be used for the specified category of logging output.

Parameters:category – The category of the log message Returns:The escape sequence

format(record)

Format a log record for logging, returning the new value.

Parameters:record – The message to be formatted Returns:The formatted message ready for logging

formatArg(category, arg)

Format a single argument within a record, based on its category.

Parameters:

• category – The logging category
• arg – The argument within the record.

formatException(exc_info)

Format an exception for logging, returning the new value.

Parameters:exc_info – The exception info Returns:The formatted message ready for logging

initColoringLibrary()

Initialize any python library required for ensuring ANSI escape sequences can be processed.

The default implementation does nothing on Unix but on Windows attempts to load the “Colorama” library if is is present (unless the environment variable PYSYS_DISABLE_COLORAMA=true is set).