Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

256-colour log messages

Project description

Intro

themelog is a module which sets the colour of Python terminal logging messages according to severity, using a choice of 8- and 256-colour themes. By default a colour set using 256-colour codes is used based on the base16 theme.

Example

A piece of code using the library:

import logging
from themelog import init_log
logger = logging.getLogger()
init_log()
logger.info('Imported themelog library')
logger.info('Created logger')
logger.info('Initialised logging system')
logger.debug('This is a debug message')
logger.info('This is a info message')
logger.warning('This is a warning message')
logger.error('This is a error message')
logger.critical('This is a critical message')

Usage

Call init_log() function to enable themelog with the following optional parameters:

theme
(str) Name of the theme to load.
light
(bool) Attempt to load a version of the theme suitable for terminals with a light background colour.
level
(str) Set to ‘DEBUG’, ‘INFO’, ‘WARN’, ‘ERROR’ or ‘CRITICAL’ to specify minumim message level that will be logged.
logfile
(str) Write output to a single log file instead of console.
rotating_logfile
(str) Write output to daily rotating log files.
rotating_logfile_count
(int) Specify number of days to retain daily log files (default: 90).
stdout
(bool) Write terminal log to stdout instead of stderr.
tz
(str) Force the timezone to use for messages. Set to False for UTC.
datefmt
(str) Date format.
debug_log
(bool) Print trace messages showing how the logging is initialised.
show_themes
(bool) Print a list of available themes.

Themes

Themes can be selected either via a parameter to the init_log call or by setting the environment variable THEMELOG_THEME.

To see a list of available themes either look in the themes directory, or set “list_themes” to True when calling init_log(), or set the environment variable THEMELOG_THEMES before running the application.

Piped output

Colours are disabled if standard output is not a terminal.

Environment variables

You can set the following environment variables before startup to configure the process:

THEMELOG_THEME
Select the name of the theme to use.
THEMELOG_DEBUG
Show additional debug messages on startup. Debug messages are written to standard output using normal print statements because they are generated before the logging system is initialised.
THEMELOG_SHOW_THEMES
List all available themes.

Requirements

themelog uses the fabulous library to generate escape codes.

Compatibility

This code has been tested under Linux and using Python 2.7 only.

Thanks

The base16 theme was designed by Chris Kempson https://github.com/chriskempson/base16.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for themelog, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size themelog-0.1.0.tar.gz (6.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page