Easy context prefixes for messages.
Project description
The primary facility here is Pfx, a context manager which maintains a per thread stack of context prefixes. Usage is like this:
from cs.pfx import Pfx ... def parser(filename): with Pfx("parse(%r)", filename): with open(filename) as f: for lineno, line in enumerate(f, 1): with Pfx("%d", lineno) as P: if line_is_invalid(line): raise ValueError("problem!") P.info("line = %r", line)
This produces log messages like:
datafile: 1: line = 'foo\n'
and exception messages like:
datafile: 17: problem!
which lets one put just the relevant complaint in exception and log messages and get useful calling context on the output. This does make for wordier logs and exceptions but used with a little discretion produces far more debugable results.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cs.pfx-20170903.1.tar.gz
(4.7 kB
view hashes)