### Navigation

- index
- modules |
- next |
- previous |
- home|
- search|
- documentation »
- The IPython API »

# 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

### Navigation

- index
- modules |
- next |
- previous |
- home|
- search|
- documentation »
- The IPython API »