exopy.app.errors.plugin module

Plugin centralizing the application error handling.

class exopy.app.errors.plugin.ErrorsPlugin

Bases: enaml.workbench.plugin.Plugin

Plugin in charge of collecting of the errors.

It will always log the errors, and will notify the user according to their type.

errors

Errors for which a custom handler is registered.

start()

Collect extensions.

stop()

Stop the extension collector and clear the list of handlers.

signal(kind, **kwargs)

Signal an error occured in the system.

Parameters

• kind (unicode or None) – Kind of error which occurred. If a specific handler is found, it is used, otherwise the generic handling method is used.

• **kwargs – Arguments to pass to the error handler.

report(kind=None)

Show a widget summarizing all the errors.

Parameters

kind (unicode, optional) – If specified only the error related to the specified kind will be reported.

enter_error_gathering()

In gathering mode, error handling is differed till exiting the mode.

exit_error_gathering()

Upon leaving gathering mode, errors are handled.

If error handling should lead to a window display, all widgets are collected and displayed in a single window. As the gathering mode can be requested many times, the errors are only handled when this method has been called as many times as its counterpart.

install_excepthook()

Setup a global sys.excepthook for a nicer user experience.

The error message suggest to the user to restart the app. In the future adding an automatic bug report system here would make sense.