{"library":"pycrashreport","title":"PyCrashReport","description":"PyCrashReport is a pure Python 3 library designed for parsing and analyzing Apple's crash reports, distilling them into a clearer view by focusing on essential debugging data. It supports user-mode and kernel-mode crash reports, providing basic metadata for other types. The library is actively maintained, with frequent minor updates and a recent major version release (v2.0.0).","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install pycrashreport"],"cli":null},"imports":["from pycrashreport.crash_report import CrashReport"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom pycrashreport.crash_report import CrashReport\n\n# Simulate a crash report content (replace with actual file reading)\ncrash_report_content = \"\"\"\nIncident Identifier: 1234ABCD-ABCD-ABCD-ABCD-1234ABCDABCD\nCrashReporter Key: 0123456789abcdef0123456789abcdef01234567\nHardware Model: iPhone13,4\nProcess: MyApp [1234]\nPath: /private/var/containers/Bundle/Application/APP_UUID/MyApp.app/MyApp\nIdentifier: com.example.MyApp\nVersion: 1.0 (1)\nCode Type: ARM-64 (Native)\nParent Process: launchd [1]\nDate/Time: 2026-04-16 10:00:00.000 +0000\nOS Version: iOS 17.4 (21E236)\nReport Version: 104\n\nException Type: EXC_BAD_ACCESS (SIGSEGV)\nException Subtype: KERN_INVALID_ADDRESS at 0x0000000000000000\nTermination Reason: Namespace SIGNAL, Code 0xb\nTerminating Process: exc handler [1234]\n\nTriggered by Thread:  0\n\nThread 0 name:  Dispatch queue: com.apple.main-thread\nThread 0 Crashed:\n0   libsystem_kernel.dylib        0x180000000 0x180000000 + 0x21c4\n1   MyApp                         0x100000000 main + 0 (main.m:16)\n2   dyld                          0x102000000 start + 0\n\nBinary Images:\n0x100000000 - 0x100003fff MyApp arm64e  <UUID> /private/var/containers/Bundle/Application/APP_UUID/MyApp.app/MyApp\n0x180000000 - 0x18001ffff libsystem_kernel.dylib arm64e  <UUID> /usr/lib/system/libsystem_kernel.dylib\n0x102000000 - 0x102033fff dyld arm64e  <UUID> /usr/lib/dyld\n\"\"\"\n\ntry:\n    # It's common to pass the raw content or a file-like object\n    # For a real file, you would use: with open('path/to/report.ips', 'r') as f: report = CrashReport(f.read())\n    report = CrashReport(crash_report_content)\n\n    print(f\"Incident Identifier: {report.incident_identifier}\")\n    print(f\"Process Name: {report.process_name}\")\n    print(f\"Process ID: {report.process_id}\")\n    print(f\"OS Version: {report.os_version}\")\n    print(f\"Exception Type: {report.exception_type}\")\n    print(f\"Crashed Thread: {report.crashed_thread_id}\")\n\n    if report.crashed_thread and report.crashed_thread.frames:\n        print(\"\\nCrashed Thread Backtrace:\")\n        for frame in report.crashed_thread.frames:\n            print(f\"  {frame.image_name} {frame.address} {frame.symbol_name if frame.symbol_name else ''}\")\n\nexcept Exception as e:\n    print(f\"Error parsing crash report: {e}\")","lang":"python","description":"Instantiate the `CrashReport` object with the content of an Apple crash report (typically an .ips file) and access its parsed attributes like incident identifier, process name, OS version, and the crashed thread's backtrace.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"2.0.0","pypi_latest":"2.0.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":2.8,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"31.7M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":2.7,"import_time_s":null,"mem_mb":null,"disk_size":"32M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"35.0M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":2.8,"import_time_s":null,"mem_mb":null,"disk_size":"35M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"26.6M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":2.6,"import_time_s":null,"mem_mb":null,"disk_size":"27M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"26.4M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":2.8,"import_time_s":null,"mem_mb":null,"disk_size":"27M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"30.8M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pycrashreport","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":3.3,"import_time_s":null,"mem_mb":null,"disk_size":"31M"}]}}