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, 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 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
- 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
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.3.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1e4997e0eb16de974e933d6f8dff9cacea84dd245a9d063aacba2aaa445c856f |
|
MD5 | 5d884c0e591198bcf7d1d6d4dd3142ca |
|
BLAKE2b-256 | 4f61b8a66676de182f5266a75df16edc0a6eed58ec2ea9a0544bcfdbf6ae6241 |