dexc 0.3.0

Exception formatter

dexc

Dexc is a Python exception formatter. It supports Python 3.11 and later.

Features

• Context displayed in addition to the main line of each frame
• Truncated trace lines when there are too many
• Colorized stack trace obeying the the NO_COLOR environment variable
• Minimization of frames when they are not part of the user code
• Support for Exception groups
• Highlighting of re-raises i.e. when an exception is caught and re-raised with more than a simple raise, causing two stack traces to be concatenated without separation
• Handling of unraisable exceptions e.g. raised in a destructor
• Support for syntax errors
• Support for exception notes
• Support for warnings
• Collapse of repeated frames or groups of frames
• Disabling using the DEXC_DISABLE=1 environment variable

Caveats

Dexc should not be used in production code or to format untrusted exceptions. Because it relies on certain CPython-specific APIs, it may break on other runtimes or if your code displays exotic behavior, such as modifying sys.modules or updating source files while the program is running.

Furthermore, Dexc may produce incorrect output if your code or exception messages contain non-ASCII characters.

Installation

$ pip install dexc

Usage

import dexc
dexc.install()

# Or:

import dexc.autoinstall

Related work

Name	Local lookup	Notes
backtrace	no	One line per frame
better-exceptions	yes	Same layout as the default
colored-traceback	no	Adds color to the default traceback
friendly-traceback	no	Provides error explanations
frosch	yes
IPython ultratb	no	Same layout as the default
Pretty Traceback	no	One line per frame
pretty-errors	yes
ptb	no
Rich tracebacks	no	See also this article
rich-traceback	no
stackprinter	yes
TBVaccine	yes	Same layout as the default; includes .pth