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.