New submission from Ash Holland <[email protected]>:
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
----------
assignee: docs@python
components: Documentation, asyncio
messages: 380895
nosy: asvetlov, docs@python, sorrel, yselivanov
priority: normal
severity: normal
status: open
title: loop.call_exception_handler documentation is lacking
type: enhancement
_______________________________________
Python tracker <[email protected]>
<https://bugs.python.org/issue42347>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com