Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources