CKTIS / Python
asyncio.TaskGroup
Združi opravila, ustvarjena z group.create_task, v eno območje.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
async with asyncio.TaskGroup() as group:
task = group.create_task(coro)Združi opravila, ustvarjena z group.create_task, v eno območje.
Skupina lahko izstopi normalno tudi s preklicanim otrokom. Njegov result() takrat sproži CancelledError. Ob izhodu počaka na vse otroke in po uspehu so rezultati pripravljeni. Prva običajna napaka prekliče sorojence, po čiščenju se napake prenesejo v ExceptionGroup ali BaseExceptionGroup. Sam preklic otroka tega pravila ne sproži.
KeyboardInterrupt in SystemExit se preneseta posebej.
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())
Primeri
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())
Rezultat
11
KeyboardInterrupt in SystemExit se preneseta posebej.