classification
Title: Mention in docs that asyncio.FIRST_COMPLETED does not guarantee the completion of no more than one task
Type: enhancement Stage: patch review
Components: asyncio, Documentation Versions: Python 3.8
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: asvetlov, docs@python, erik.bray, tom.pohl, yselivanov
Priority: normal Keywords: patch

Created on 2020-02-18 09:33 by tom.pohl, last changed 2020-08-31 09:58 by erik.bray.

Pull Requests
URL Status Linked Edit
PR 21918 open erik.bray, 2020-08-31 09:58
Messages (1)
msg362181 - (view) Author: Tom Pohl (tom.pohl) Date: 2020-02-18 09:33
Currently, the documentation of asyncio.wait gives the impression that using FIRST_COMPLETED guarantees the completion of no more than one task. In reality, the number of completed task after asyncio.wait can be larger than one.

While this behavior (exactly one complete task if no error or cancellation occurred) would be ultimately desirable, a sentence describing the current behavior would be helpful for new users of asyncio.
History
Date User Action Args
2020-08-31 09:58:41erik.braysetkeywords: + patch
nosy: + erik.bray

pull_requests: + pull_request21125
stage: patch review
2020-02-18 09:39:16xtreaksetnosy: + asvetlov, yselivanov
components: + asyncio
2020-02-18 09:33:32tom.pohlcreate