Skip to main content

Python error reporter that generates detailed HTML/TXT crash reports.

Project description

🛡️Crashprobe - makes errors simple, understandable, and beautiful, and generates HTML/TXT reports about them.

Python License

Examples:

Crashprobe HTML report example:

Crashprobe HTML report example

Crashprobe TXT report example:

Crashprobe TXT report example

A library that intercepts errors and creates beautiful, detailed HTML reports.

📦Installation

pip install crashprobe

🚀Quick Start

import crashprobe
crashprobe.start()
print(1/0) # ZeroDivisionError - watch the magic!

✨Crashprobe Features

  • No dependencies
  • Beautiful, easy-to-read dark theme in reports
  • System information
  • Very easy to use
  • Copy report button
  • Useful links with error information
  • Support for text reports (TXT)
  • Ability to disable auto-opening of the browser
  • Reports are saved in a separate folder for each file

📃Usage

Library import:

import crashprobe

Start the error catcher. If the program crashes with an error, the library will intercept it, generate an HTML report, automatically open it, and save it in the nameOfYourFile_crash_dir folder:

crashprobe.start()

The generated page is saved in the automatically created nameOfYourFile_crash_dir folder as a file named crash_Y-M-D_H-M-S. Read the details below 👇🏻

⚙️crashprobe.start() - Method Settings

The crashprobe.start() method contains 2 optional arguments: 'auto_open' and 'file_format'.

Auto_open is a method that controls whether the report file is automatically opened. It can take the values True or False.(by default auto_open = True) File_format is a method that controls the type of report file. It can take the values 'html' or 'txt' (case-insensitive).(by default file_format = 'html')

The HTML page includes a beautiful dark theme, emoji, as well as the error title, error text, exact date and time, path to the file containing the error, the line containing the error and its closest links, values ​​and types of local variables, system information and Python version, links to Google and the Python documentation for information about the error, and a copy report button.

The TXT file includes an error title, error text, exact date and time, path to the file containing the error, the line containing the error and its closest links, values and types of local variables, system information, and Python version, links to Google and the Python documentation for information about the error.

Example (All defaults):

import crashprobe
crashprobe.start()
def example(x, y):
    one = x
    two = y
    return x / y
print(example(1, "Hello"))

The library will create a folder named nameOfYourFile_crash_dir, save an HTML (if file_format = 'html') or TXT (if file_format = 'txt') report there, and automatically open it in the browser (if file_format = 'html') or display it in the console (if file_format = 'txt') if auto_open = True, and not open it if auto_open = False

Example (auto_open = False, file_format = 'txt'):

import crashprobe
crashprobe.start(auto_open = False, file_format = 'txt')
def example(x, y):
    one = x
    two = y
    return x / y
print(example(1, "Hello"))

❔Why is it convenient?

To get started, you only need to write two lines of code, and in the event of an error, you get a beautiful HTML report instead of a console message.

Without crashprobe:

Before crashprobe

With crashprobe:

With crashprobe

❔Whats new in 0.2.0?

  • Fixed minor bugs.
  • Added support for TXT reports.
  • Added the ability to disable auto-opening of the report file.
  • The report folder now contains the name of the file where the error occurred.

👦🏻 About the developer

My name is Andrey Egupov, I'm 11 years old. I've been programming for several years. I started in Scratch, now I write in Python, JavaScript, and I'm working with Arduino. I got tired of seeing red error messages and having to print variable values, so I decided to create a truly useful tool that would help me and others!

📄 License

MIT © 2026 Andrey Egupov (11-year-old-developer)

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

crashprobe-0.2.0-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file crashprobe-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: crashprobe-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for crashprobe-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 21fcce89a26d8edc9d4170c0ffe61f42eaf27b95fbe5ee3a118dcff9d1868303
MD5 5749757fd25f15ad054f28bbc0036a21
BLAKE2b-256 53072bb148845461c22d3fc8ea5554b6661ff44afa706c2b562dfd8fdac352ef

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page