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: Generator-based coroutines in Python 3.10, 3.9 docs
Type: behavior Stage: resolved
Components: Documentation Versions: Python 3.10, Python 3.9
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: asvetlov, docs@python, srittau, terry.reedy, yselivanov
Priority: normal Keywords: patch

Created on 2022-02-02 12:27 by srittau, last changed 2022-04-11 14:59 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 31132 merged terry.reedy, 2022-02-04 19:35
PR 31133 merged miss-islington, 2022-02-04 19:59
Messages (5)
msg412352 - (view) Author: Sebastian Rittau (srittau) * Date: 2022-02-02 12:27
Currently, the Python 3.10.2 documentation at https://docs.python.org/3/library/asyncio-task.html?highlight=coroutine#asyncio.coroutine says:

"Note: Support for generator-based coroutines is deprecated and is scheduled for removal in Python 3.10."

Python 3.10 still has support for those (although it emits a warning), so the note should be updated.
msg412524 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2022-02-04 18:48
Yuri or Andrew: either of you know the fix for "Support for generator-based coroutines is deprecated and is scheduled for removal in Python 3.10."?
msg412525 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2022-02-04 19:02
Looking at the doc answered the question.  Further down the 3.10 version, '3.10' was revised to '3.11', and indeed, the decorator and the entire section are gone.  There was no change in 3.9 doc, but should be.  I will submit a PR for 3.10 and try to remember to make an additional change in the 3.9 backport.

The doc for iscoroutine and ...function are gone because they have no use in new 3.11+ code.  The functions remain though, as they will still work, even though redundant.
msg412529 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2022-02-04 19:59
New changeset 5603db43ba7ba5568b7516d0e28730a2bc1e1f26 by Terry Jan Reedy in branch '3.10':
[3.10] bpo-46609: Update asyncio-task coroutine doc (GH-31132)
https://github.com/python/cpython/commit/5603db43ba7ba5568b7516d0e28730a2bc1e1f26
msg412535 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2022-02-04 20:46
New changeset 459e26f0987a12a19238baba422e13a8f7fcfca3 by Miss Islington (bot) in branch '3.9':
[3.9] bpo-46609: Update asyncio-task coroutine doc (GH-31132) 
https://github.com/python/cpython/commit/459e26f0987a12a19238baba422e13a8f7fcfca3
History
Date User Action Args
2022-04-11 14:59:55adminsetgithub: 90767
2022-02-04 20:47:27terry.reedysetstatus: open -> closed

nosy: - miss-islington
title: Generator-based coroutines in Python 3.10 docs -> Generator-based coroutines in Python 3.10, 3.9 docs
resolution: fixed
stage: patch review -> resolved
2022-02-04 20:46:16terry.reedysetmessages: + msg412535
2022-02-04 19:59:47terry.reedysetmessages: + msg412529
2022-02-04 19:59:44miss-islingtonsetnosy: + miss-islington
pull_requests: + pull_request29312
2022-02-04 19:35:44terry.reedysetkeywords: + patch
stage: needs patch -> patch review
pull_requests: + pull_request29311
2022-02-04 19:02:57terry.reedysettype: behavior
stage: needs patch
messages: + msg412525
versions: + Python 3.9
2022-02-04 18:48:42terry.reedysetnosy: + asvetlov, terry.reedy, yselivanov
messages: + msg412524
2022-02-02 12:27:05srittaucreate