CKTIS / Python
asyncio.TaskGroup
Raggruppa i task creati con group.create_task in un ambito.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
async with asyncio.TaskGroup() as group:
task = group.create_task(coro)Raggruppa i task creati con group.create_task in un ambito.
Il gruppo può uscire normalmente con un figlio annullato. Il suo result() solleva allora CancelledError. All’uscita attende tutti i figli e in caso di successo i risultati sono pronti. Il primo errore ordinario annulla gli altri figli, dopo la pulizia gli errori confluiscono in ExceptionGroup o BaseExceptionGroup. Il solo annullamento di un figlio non attiva la regola.
KeyboardInterrupt e SystemExit sono rilanciate separatamente.
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())
Esempi
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())
Risultato
11
KeyboardInterrupt e SystemExit sono rilanciate separatamente.