CKTIS / Python
asyncio.TaskGroup
Seskupuje úlohy vytvořené přes group.create_task do jednoho rozsahu.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
async with asyncio.TaskGroup() as group:
task = group.create_task(coro)Seskupuje úlohy vytvořené přes group.create_task do jednoho rozsahu.
Skupina může odejít normálně i se zrušeným potomkem. Jeho result() pak vyvolá CancelledError. Odchod čeká na všechny potomky a při úspěchu jsou výsledky připravené. První běžná chyba zruší sourozence, po úklidu se chyby předají v ExceptionGroup nebo BaseExceptionGroup. Samotné zrušení potomka tuto zásadu neaktivuje.
KeyboardInterrupt a SystemExit se předávají zvlášť.
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())
Pří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ýsledek
11
KeyboardInterrupt a SystemExit se předávají zvlášť.