Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A utility to trim Python traceback information.

Project description

tbtrim

PyPI - Downloads PyPI - Version PyPI - Format PyPI - Python Version PyPI - Status License

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 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

  • 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 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).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tbtrim, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size tbtrim-0.2.1-py2.py3-none-any.whl (3.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size tbtrim-0.2.1.tar.gz (2.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page