KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

asyncio.TaskGroup

Groepeert taken die met group.create_task zijn gemaakt binnen één bereik.

Versie: Python 3.14; repository image, production runtime not attested

Syntax

async with asyncio.TaskGroup() as group:
    task = group.create_task(coro)

Groepeert taken die met group.create_task zijn gemaakt binnen één bereik.

De groep kan normaal eindigen met een geannuleerd kind. De result() daarvan geeft dan CancelledError. Bij verlaten worden alle kinderen afgewacht en bij succes zijn de resultaten beschikbaar. De eerste gewone fout annuleert zustertaken, na opruimen volgen de fouten in ExceptionGroup of BaseExceptionGroup. Alleen annulering van een kind activeert dit niet.

KeyboardInterrupt en SystemExit worden afzonderlijk doorgegeven.

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())

Voorbeelden

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())

Resultaat

11

KeyboardInterrupt en SystemExit worden afzonderlijk doorgegeven.

Bronnen