skip to navigation
skip to content

Not Logged In

colorlog 1.1

Log formatting with colors!

Latest Version: 2.0.0

colorlog.ColoredFormatter is a formatter for use with pythons logging module.

It allows colors to be placed in the format string, which is mostly useful when paired with a StreamHandler that is outputting to a terminal. This is accomplished by added a set of terminal color codes to the record before it is used to format the string.

Usage

ColoredFormatter requires at minumum a format string, and takes two options - reset (implictly add a reset code at the end of message strings, defaults to true) and color_levels (a mapping of record level names to color names, defaults to colorlog.DEFAULT_COLOR_LEVELS).

from colorlog import ColoredFormatter

formatstring = "%(bg_level)s%(levelname)-8s%(reset)s %(blue)%(message)s"

levels = {
        'DEBUG':    'cyan',
        'INFO':     'green',
        'WARNING':  'yellow',
        'ERROR':    'red',
        'CRITICAL': 'red',
}

formatter = ColoredFormatter(formatstring, reset=True, color_levels=levels)

The formatter can then be used in a normal logging setup.

Codes

The following values are made availible for use in the format string:

  • fg_{colorname}, bg_{colorname}: Foreground and background colors. The colors names are black, red, green, yellow, blue, purple, cyan and white.
  • bold: Bold output.
  • reset: Clear all formatting (both foreground and background colors).
  • fg_level, bg_level: Return the color associated with the records level (from color_levels).

Compatibility

colorlog` should work with both Python 2 and 3. At a minimum, it's been tested on Python 2.7 and 3.2.

Licence

colorlog is distributed under the MIT Licence.

 
File Type Py Version Uploaded on Size
colorlog-1.1.tar.gz (md5) Source 2012-10-11 3KB
  • Downloads (All Versions):
  • 403 downloads in the last day
  • 2302 downloads in the last week
  • 7984 downloads in the last month