mozcrash

2.2.1 verified Fri May 01 auth: no python

Library for printing stack traces from minidumps left behind by crashed processes. Version 2.2.1, updated irregularly as part of Mozilla's automation tooling.

pip install mozcrash

Common errors

error No module named mozcrash ↓

cause Library not installed or installed in wrong environment.

fix

Run 'pip install mozcrash' in the correct Python environment.

error AttributeError: module 'mozcrash' has no attribute 'check_for_crashes' ↓

cause Old import style using 'import mozcrash' then calling mozcrash.check_for_crashes works in 2.x but may fail if you accidentally shadow the name.

fix

Use 'from mozcrash import check_for_crashes' directly.

Warnings

gotcha symbols_path must point to a directory containing symbol files (e.g., .sym files). If missing, stack traces will be incomplete. ↓

fix Ensure you have downloaded breakpad symbols for your build.

gotcha dump_directory must be an absolute path; relative paths may cause failures. ↓

fix Use os.path.abspath() to convert relative paths.

Imports

check_for_crashes

wrong

import mozcrash; mozcrash.check_for_crashes(...)

correct

from mozcrash import check_for_crashes

Old style still works but not recommended

Quickstart

Check for minidumps in a directory and print stack traces.

from mozcrash import check_for_crashes

result = check_for_crashes(
    dump_directory="/path/to/minidumps",
    symbols_path="/path/to/symbols",
    test_name="my_test"
)
print(result)