This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: loop.call_exception_handler documentation is lacking
Type: enhancement Stage:
Components: asyncio, Documentation Versions:
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: asvetlov, docs@python, sorrel, yselivanov
Priority: normal Keywords:

Created on 2020-11-13 14:54 by sorrel, last changed 2022-04-11 14:59 by admin.

Messages (3)
msg380895 - (view) Author: Ash Holland (sorrel) Date: 2020-11-13 14:54
The call_exception_handler documentation lists seven permissible context keys, but the docstring lists nine, and there are two keys referred to in the default_exception_handler implementation that aren't listed in either.

The docstring (but not the documentation) mentions "task" ("Task instance") and "asyncgen" ("Asynchronous generator that caused the exception."), though at least "asyncgen" doesn't appear to be used in any exception handler in stdlib as far as I can tell. No documentation mentions "source_traceback" or "handle_traceback", but they're used by the default exception handler and are also provided by e.g. aiohttp: https://github.com/aio-libs/aiohttp/blob/a8d9ec3f1667463e80545b1cacc7833d1ff305e9/aiohttp/client_reqrep.py#L750
msg381887 - (view) Author: Andrew Svetlov (asvetlov) * (Python committer) Date: 2020-11-26 08:59
Pull Request is welcome!
msg381991 - (view) Author: Andrew Svetlov (asvetlov) * (Python committer) Date: 2020-11-28 10:56
Partially addressed by https://github.com/python/cpython/pull/21735
History
Date User Action Args
2022-04-11 14:59:38adminsetgithub: 86513
2020-11-28 10:56:22asvetlovsetmessages: + msg381991
2020-11-26 08:59:13asvetlovsetmessages: + msg381887
2020-11-13 14:54:33sorrelcreate