Module:core.crashhandler

sys.excepthook for IPython itself, leaves a detailed report on disk.

Authors:

  • Fernando Perez

  • Brian E. Granger

1 Class

classIPython.core.crashhandler.CrashHandler(app:Application,contact_name:str|None=None,contact_email:str|None=None,bug_tracker:str|None=None,show_crash_traceback:bool=True,call_pdb:bool=False)

Bases:object

Customizable crash handlers for IPython applications.

Instances of this class provide a__call__() method which can beused as asys.excepthook. The__call__() signature is:

def__call__(self,etype,evalue,etb)
__init__(app:Application,contact_name:str|None=None,contact_email:str|None=None,bug_tracker:str|None=None,show_crash_traceback:bool=True,call_pdb:bool=False)

Create a new crash handler

Parameters:

  • app (Application) – A runningApplication instance, which will be queried atcrash time for internal information.

  • contact_name (str) – A string with the name of the person to contact.

  • contact_email (str) – A string with the email address of the contact.

  • bug_tracker (str) – A string with the URL for your project’s bug tracker.

  • show_crash_traceback (bool) – If false, don’t print the crash traceback on stderr, only generatethe on-disk report

  • call_pdb – Whether to call pdb on crash

Theseinstancescontainsomenon-argumentattributeswhichallowfor
furthercustomizationofthecrashhandler'sbehavior.Pleaseseethe
sourceforfurtherdetails.
make_report(traceback:str)→str

Return a string containing a crash report.

1 Function

IPython.core.crashhandler.crash_handler_lite(etype:type[BaseException],evalue:BaseException,tb:TracebackType)→None

a light excepthook, adding a small message to the usual traceback