Document optional 'task'/'asyncgen' fields in call_exception_handler

[ShaneHarvey]

This change documents the optional "task" field in call_exception_handler. For example I noticed this context while working on Motor:

>>>context{'message': 'Task was destroyed but it is pending!', 'task': <Taskpendingname='Task-2'coro=<TestAsyncIOCursor.test_cancelled_error_fetch_next_aggregate() runningat/Users/shane/git/motor/test/asyncio_tests/test_asyncio_cursor.py:261>wait_for=<Futurefinishedresult={'$clusterTime':{'clusterTime': Timestamp(1596567456, 202), 'signature':{'hash': b'\x00\x00\x0...0\x00\x00\x00', 'keyId': 0}}, 'count': 7, 'ok': 1.0, 'operationTime': Timestamp(1596567456, 202)} createdat/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/asyncio/base_events.py:418>createdat/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/asyncio/tasks.py:470>, 'source_traceback': [<FrameSummaryfilesetup.py, line128in<module>>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/setuptools/__init__.py, line145insetup>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/distutils/core.py, line148insetup>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/distutils/dist.py, line966inrun_commands>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/distutils/dist.py, line985inrun_command>, <FrameSummaryfilesetup.py, line120inrun>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/unittest/runner.py, line176inrun>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/unittest/suite.py, line84in__call__>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/unittest/suite.py, line122inrun>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/unittest/case.py, line736in__call__>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/unittest/case.py, line676inrun>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/unittest/case.py, line633in_callTestMethod>, <FrameSummaryfile/Users/shane/git/motor/test/asyncio_tests/__init__.py, line48in__call__>, <FrameSummaryfile/Users/shane/git/motor/test/test_environment.py, line283inwrap>, <FrameSummaryfile/Users/shane/git/motor/test/asyncio_tests/__init__.py, line214inwrapped>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/asyncio/base_events.py, line595inrun_until_complete>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/asyncio/base_events.py, line563inrun_forever>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/asyncio/base_events.py, line1836in_run_once>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/asyncio/events.py, line81in_run>, <FrameSummaryfile/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/asyncio/tasks.py, line470inwait_for>]}

Most PRs will require an issue number. Trivial changes, like fixing a typo, do not need an issue.

This change seems trivial enough to not need an issue. Let me know if you disagree and I'll create one.

[rougeth]

Hey @ShaneHarvey, thank you for your PR. There's another key missing at the docs, would you mind adding it as well?

cpython/Lib/asyncio/base_events.py

Lines 1740 to 1755 in 374d998

	defcall_exception_handler(self, context):
	"""Call the current event loop's exception handler.
	The context argument is a dict containing the following keys:
	- 'message': Error message;
	- 'exception' (optional): Exception object;
	- 'future' (optional): Future instance;
	- 'task' (optional): Task instance;
	- 'handle' (optional): Handle instance;
	- 'protocol' (optional): Protocol instance;
	- 'transport' (optional): Transport instance;
	- 'socket' (optional): Socket instance;
	- 'asyncgen' (optional): Asynchronous generator that caused
	the exception.

[ShaneHarvey]

@rougeth thanks for the the quick review. Updated to include the asyncgen field as well.

[bedevere-bot]

@asvetlov: Please replace # with GH- in the commit message next time. Thanks!

[asvetlov]

Thanks!

[graingert]

this needs a backport to python3.6

[ShaneHarvey]

@graingert 3.6 is EOL so it will not be backported: https://devguide.python.org/devcycle/#end-of-life-branches

[graingert]

@graingert 3.6 is EOL so it will not be backported: https://devguide.python.org/devcycle/#end-of-life-branches

Ah sorry I mean 3.6-3.9 are missing this change - so it should be backported to 3.9

[ShaneHarvey]

Oh that's a good point. I think a CPython maintainer just needs to add the "needs backport to 3.7/8/9" labels. Either that or one of us can create the backport PR manually.

[AlexWaygood]

Oh that's a good point. I think a CPython maintainer just needs to add the "needs backport to 3.7/8/9" labels. Either that or one of us can create the backport PR manually.

3.7 & 3.8 are only accepting security-related patches. But 3.9 is still accepting bugfixes and docs patches :)

[miss-islington]

Thanks @ShaneHarvey for the PR, and @asvetlov for merging it 🌮🎉.. I'm working now to backport this PR to: 3.9.
🐍🍒⛏🤖

[bedevere-bot]

GH-30727 is a backport of this pull request to the 3.9 branch.