[New-bugs-announce] [issue39671] Mention in docs that asyncio.FIRST_COMPLETED does not guarantee the completion of no more than one task

[Tom Pohl]

New submission from Tom Pohl <thomas.pohl at gmail.com>:

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.

----------
assignee: docs at python
components: Documentation
messages: 362181
nosy: docs at python, tom.pohl
priority: normal
severity: normal
status: open
title: Mention in docs that asyncio.FIRST_COMPLETED does not guarantee the completion of no more than one task
type: enhancement
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue39671>
_______________________________________