thepipe.logger

The logging facility.

Module Contents

thepipe.logger.DEFAULT_LOG_COLORS

thepipe.logger.LOGGERS

thepipe.logger.DEPRECATION = 45

thepipe.logger.ONCE = 46

thepipe.logger.DATEFMT = %Y-%m-%d %H:%M:%S

thepipe.logger.deprecation(self, message, *args, **kwargs)

Show a deprecation warning.

thepipe.logger.deprecation

thepipe.logger.once(self, message, *args, identifier=None, **kwargs)

Show a message only once, determined by position in source or identifer.

This will not work in IPython or Jupyter notebooks if no identifier is specified, since then the determined position in source contains the execution number of the input (cell), which changes every time. Set a unique identifier, otherwise the message will be printed every time.

thepipe.logger.once

thepipe.logger.esc(*x)

Create escaped code from format code

thepipe.logger.ESCAPE_CODES

thepipe.logger.COLORS = ['black', 'red', 'green', 'yellow', 'blue', 'purple', 'cyan', 'white']

thepipe.logger.PREFIXES = [['3', ''], ['01;3', 'bold_'], ['02;3', 'thin_'], ['3', 'fg_'], ['01;3', 'fg_bold_'], ['02;3', 'fg_thin_'], ['4', 'bg_'], ['10', 'bg_bold_']]

thepipe.logger.parse_colors(sequence)

Return escape codes from a color sequence.

class thepipe.logger.ColoredRecord(record)

Wraps a LogRecord, adding named escape codes to the internal dict. The internal dict is used when formatting the message (by the PercentStyle, StrFormatStyle, and StringTemplateStyle classes).

class thepipe.logger.ColouredFormatter(fmt, datefmt=None, style='%', log_colors=None, reset=True, secondary_log_colors=None)

Bases: logging.Formatter

A formatter that allows colors to be placed in the format string. Intended to help in creating more readable logging output.

Based on https://github.com/borntyping/python-colorlog

format(self, record)

Format a message from a record object.

thepipe.logger.get_logger(name, filename=None, datefmt=DATEFMT)

Helper function to get a logger.

If a filename is specified, it will also log to that file.

thepipe.logger.available_loggers()

Return a list of avialable logger names

thepipe.logger.set_level(name, level)

Set the log level for given logger

thepipe.logger.get_printer(name, color=None, ansi_code=None, force_color=False)

Return a function which prints a message with a coloured name prefix

thepipe.logger.escape_codes(log_colors, level_name)

Return escape codes from a log_colors dict.

thepipe.logger.hash_coloured(text)

Return a ANSI coloured text based on its hash

thepipe.logger.hash_coloured_escapes(text)

Return the ANSI hash colour prefix and suffix for a given text