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.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 860839d7296298a8823b3a0ac49a7f29424819d1481b5521329d339eac062bb9 |
|
MD5 | 08d6f042cfaf009e0131933061e796f8 |
|
BLAKE2b-256 | 4044a43122d939241a0c7eed4f26457888c66e7f788eda1077b2122e998ea004 |