Module: core.crashhandler

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

Authors:

  • Fernando Perez
  • Brian E. Granger

1 Class

class IPython.core.crashhandler.CrashHandler(app, contact_name=None, contact_email=None, bug_tracker=None, show_crash_traceback=True, call_pdb=False)

Bases: object

Customizable crash handlers for IPython applications.

Instances of this class provide a __call__() method which can be used as a sys.excepthook. The __call__() signature is:

def __call__(self, etype, evalue, etb)
__init__(app, contact_name=None, contact_email=None, bug_tracker=None, show_crash_traceback=True, call_pdb=False)

Create a new crash handler

Parameters:
  • app (Application) – A running Application instance, which will be queried at crash 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 generate the on-disk report
  • instance attributes (Non-argument) –
  • instances contain some non-argument attributes which allow for (These) –
  • customization of the crash handler's behavior. Please see the (further) –
  • for further details. (source) –
__call__(etype, evalue, etb)

Handle an exception, call for compatible with sys.excepthook

make_report(traceback)

Return a string containing a crash report.

1 Function

IPython.core.crashhandler.crash_handler_lite(etype, evalue, tb)

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