Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

asyncio.TaskGroup

Zoskupuje úlohy vytvorené cez group.create_task do jedného rozsahu.

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

Syntax

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

Zoskupuje úlohy vytvorené cez group.create_task do jedného rozsahu.

Skupina môže odísť normálne aj so zrušeným potomkom. Jeho result() potom vyvolá CancelledError. Odchod čaká na všetkých potomkov a pri úspechu sú výsledky pripravené. Prvá bežná chyba zruší súrodencov, po uprataní sa chyby odovzdajú v ExceptionGroup alebo BaseExceptionGroup. Samotné zrušenie potomka túto zásadu neaktivuje.

KeyboardInterrupt a SystemExit sa odovzdávajú osobitne.

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

Príklady

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

Výsledok

11

KeyboardInterrupt a SystemExit sa odovzdávajú osobitne.

Zdroje