hide-from-traceback 1.0

Omit utility functions from tracebacks.

hide_from_traceback

A simple library for preventing utility functions from appearing in tracebacks. Requires CPython 3.9+. Bundles set_exc_info to avoid reliance on _testcapi, which is not included in all Python distributions and is needed for Python 3.9 and 3.10.

Compatibility with other Python implementations should be easy to add for Python 3.11+ since it should mostly consist of skipping building the C extension for those versions.

Installation

pip install hide_from_traceback

Usage

from hide_from_traceback import hide_from_traceback

@hide_from_traceback
def assert_something_complex(value: object) -> None:
    if not something_about_object(value):
        raise Exception("Failed ")

def test_foo():
    data = { ... }
    assert_something_complex(data)

Disabling

Set the environment variable NO_HIDE_FROM_TRACEBACK to disable this module's functionality completely, making @hide_from_traceback a no-op or disable the traceback-editing functionality at runtime:

from hide_from_traceback import set_hide_from_traceback_enabled

set_hide_from_traceback_enabled(False)