A utility to trim Python traceback information.
Project description
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, exception=None, strict=False)
Set the rule for trimming traceback (will set sys.excepthook
).
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 returnsbool
(returningTrue
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
-
exception (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
andexception
in a strict mode (settingTrue
usesis
to check;False
usesissubclass
to check)
clear_trim_rule()
Clear the rule for trimming traceback (restore the excepthook).
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
Built Distribution
Hashes for tbtrim-0.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4d8505a998b414d299edf978edae42c850d873dffe11cee11ea34688b5782561 |
|
MD5 | e45c459c80147f1562aceab113e032ea |
|
BLAKE2b-256 | 53848ee38647b6fe54a10787067b5b0b5a0510f5511da2b723a394aa756cfb25 |