CKTIS / Python
asyncio.TaskGroup
Agrupa las tareas creadas con group.create_task en un ámbito.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
async with asyncio.TaskGroup() as group:
task = group.create_task(coro)Agrupa las tareas creadas con group.create_task en un ámbito.
El grupo puede salir normalmente con un hijo cancelado. Su result() produce entonces CancelledError. La salida espera a todos los hijos y tras el éxito sus resultados están listos. El primer fallo ordinario cancela los hermanos y tras la limpieza los fallos se reúnen en ExceptionGroup o BaseExceptionGroup. La mera cancelación de un hijo no activa la regla.
KeyboardInterrupt y SystemExit se propagan por separado.
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())
Ejemplos
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 y SystemExit se propagan por separado.