tbtrim 0.3.0

A utility to trim Python traceback information.

tbtrim

tbtrim is a utility to trim Python traceback information. By assigning user-refined sys.excepthook, one can easily customize the behavior after an exception is raise and uncaught, and just before the interpreter prints out the given traceback and exception to sys.stderr.

In a more human-readable way, tbtrim is to let you handle the last words of a program when it exits because of an exception.

Installation

Simply run the following to install the current version from PyPI:

$ pip install tbtrim

Or install the latest version from the git repository:

git clone https://github.com/gousaiyang/tbtrim.git
cd tbtrim
pip install -e .
# and to update at any time
git pull

Usage

set_trim_rule(predicate, target=BaseException, exclude=None, strict=False)

Set the rule for trimming traceback (will set sys.excepthook and threading.excepthook if available).

You can determine whether to start to trim traceback items based on the filename.

Args:

• predicate (function): a function which takes one str parameter (the filename of a traceback item) and returns bool (returning True indicates that this traceback item and the following items should be trimmed)
• target (class_or_tuple): a tuple may be given as an exception to check against if to apply the rule for trimming its traceback
• exclude (class_or_tuple): a tuple may be given as an exception to check against if to NOT apply the rule for trimming its traceback
• strict (bool): indicate whether checking an exception against target and exception in a strict mode (setting True uses is to check; False uses issubclass to check)

clear_trim_rule()

Clear the rule for trimming traceback (restore the excepthook).