CKTIS / Python
asyncio.TaskGroup
Agrupa as tarefas criadas com group.create_task num âmbito.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
async with asyncio.TaskGroup() as group:
task = group.create_task(coro)Agrupa as tarefas criadas com group.create_task num âmbito.
O grupo pode sair normalmente com um filho cancelado. O seu result() gera então CancelledError. A saída espera por todos os filhos e em caso de sucesso os resultados estão prontos. A primeira falha normal cancela as tarefas irmãs e após a limpeza as falhas são reunidas em ExceptionGroup ou BaseExceptionGroup. O cancelamento isolado de um filho não ativa a regra.
KeyboardInterrupt e SystemExit são propagadas separadamente.
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())
Exemplos
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())
Resultado
11
KeyboardInterrupt e SystemExit são propagadas separadamente.