diff options
| author | Victor Stinner <vstinner@redhat.com> | 2019-05-27 22:39:52 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-05-27 22:39:52 (GMT) |
| commit | cd590a7cede156a4244e7cac61e4504e5344d842 (patch) | |
| tree | 371aa076f7be6e942e904ebfa6aa6e7dbb2f0678 /Doc/library/sys.rst | |
| parent | 23b4b697e5b6cc897696f9c0288c187d2d24bff2 (diff) | |
| download | cpython-cd590a7cede156a4244e7cac61e4504e5344d842.zip cpython-cd590a7cede156a4244e7cac61e4504e5344d842.tar.gz cpython-cd590a7cede156a4244e7cac61e4504e5344d842.tar.bz2 | |
bpo-1230540: Add threading.excepthook() (GH-13515)
Add a new threading.excepthook() function which handles uncaught
Thread.run() exception. It can be overridden to control how uncaught
exceptions are handled.
threading.ExceptHookArgs is not documented on purpose: it should not
be used directly.
* threading.excepthook() and threading.ExceptHookArgs.
* Add _PyErr_Display(): similar to PyErr_Display(), but accept a
'file' parameter.
* Add _thread._excepthook(): C implementation of the exception hook
calling _PyErr_Display().
* Add _thread._ExceptHookArgs: structseq type.
* Add threading._invoke_excepthook_wrapper() which handles the gory
details to ensure that everything remains alive during Python
shutdown.
* Add unit tests.
Diffstat (limited to 'Doc/library/sys.rst')
| -rw-r--r-- | Doc/library/sys.rst | 6 |
1 files changed, 5 insertions, 1 deletions
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 51a208e..74aa271 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -298,7 +298,11 @@ always available. before the program exits. The handling of such top-level exceptions can be customized by assigning another three-argument function to ``sys.excepthook``. - See also :func:`unraisablehook` which handles unraisable exceptions. + .. seealso:: + + The :func:`sys.unraisablehook` function handles unraisable exceptions + and the :func:`threading.excepthook` function handles exception raised + by :func:`threading.Thread.run`. .. data:: __breakpointhook__ |