CKTIS / Python
asyncio.TaskGroup
Regroupe les tâches créées par group.create_task dans une portée.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
async with asyncio.TaskGroup() as group:
task = group.create_task(coro)Regroupe les tâches créées par group.create_task dans une portée.
Le groupe peut quitter normalement le bloc malgré un enfant annulé. Son result() lève alors CancelledError. La sortie attend tous les enfants et leurs résultats sont disponibles en cas de succès. Une première erreur ordinaire annule les autres enfants, puis les erreurs remontent dans ExceptionGroup ou BaseExceptionGroup après nettoyage. L’annulation seule d’un enfant ne déclenche pas cette règle.
KeyboardInterrupt et SystemExit sont propagées séparément.
import asyncio
async def main():
async def fail():
raise ValueError("group")
try:
async with asyncio.TaskGroup() as tg:
sibling = tg.create_task(asyncio.Event().wait())
tg.create_task(fail())
except* ValueError as errors:
assert len(errors.exceptions) == 1
assert sibling.cancelled()
asyncio.run(main())
import asyncio
async def main():
async with asyncio.TaskGroup() as group:
child = group.create_task(asyncio.Event().wait())
child.cancel()
assert child.cancelled()
try:
child.result()
except asyncio.CancelledError:
pass
else:
raise AssertionError
asyncio.run(main())
Exemples
import asyncio
async def main():
async with asyncio.TaskGroup() as group:
first = group.create_task(asyncio.sleep(0, result=3))
second = group.create_task(asyncio.sleep(0, result=8))
print(first.result() + second.result())
asyncio.run(main())
Résultat
11
KeyboardInterrupt et SystemExit sont propagées séparément.