IPython Documentation

Table Of Contents

Previous topic

Module: core.completerlib

Next topic

Module: core.debugger

This Page

Note

This documentation is for a development version of IPython. There may be significant differences from the latest stable release.

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

Non-argument instance attributes:

These instances contain some non-argument attributes which allow for

further customization of the crash handler’s behavior. Please see the

source for further details.

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