Crashtest

0.4.1 · active · verified Sat Mar 28

Crashtest is a Python library designed to simplify the handling and inspection of exceptions, providing tools to manage Python errors with ease. It is currently at version 0.4.1 and has a moderate release cadence, with recent updates focused on stability and type hinting.

Warnings

breaking Crashtest versions 0.4.0 and newer require Python 3.7 or higher. Users on Python 3.6 or older will encounter compatibility issues when upgrading.
Fix: Upgrade your Python environment to 3.7 or newer, or pin `crashtest` to a version older than 0.4.0 (e.g., `<0.4.0`).
gotcha Version 0.4.0 introduced stricter type hinting. A 'too narrow type' in the `Inspector` class was fixed in 0.4.1, suggesting that `0.4.0` might have introduced new type-related errors if existing code passed unexpected types.
Fix: Update to `crashtest` 0.4.1 or later to benefit from the corrected type definitions and avoid potential type-related runtime errors.
gotcha Prior to version 0.4.0, `crashtest` could encounter decoding errors when opening files due to the lack of explicit 'utf-8' encoding.
Fix: Upgrade to `crashtest` 0.4.0 or later to ensure proper handling of file encodings.
gotcha In versions prior to 0.3.1, there was an error when attempting to retrieve the line of a frame if it had no context.
Fix: Upgrade to `crashtest` 0.3.1 or later to fix issues with context-less frame line retrieval.

Install

pip install crashtest Install stable version

Imports

Inspector
```
from crashtest import Inspector
```
ErrorHandler
```
from crashtest import ErrorHandler
```

Quickstart

Demonstrates how to use the `Inspector` class to extract detailed information from a caught exception, including its type, message, and the full stack trace with code context.

import sys
from crashtest import Inspector

def might_fail():
    a = 1
    b = 0
    return a / b

try:
    might_fail()
except Exception as e:
    inspector = Inspector(e)
    print(f"Exception type: {inspector.type}")
    print(f"Exception message: {inspector.message}")
    print("Stack Trace:")
    for frame in inspector.frames:
        print(f"  File: {frame.file}, Line: {frame.lineno}, Function: {frame.name}")
        print(f"    Code: {frame.line.strip() if frame.line else 'N/A'}")

view raw JSON →