CKTIS / Python
asyncio.Task
Representa una corrutina ejecutada cooperativamente por el bucle.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
task = asyncio.create_task(coro)Representa una corrutina ejecutada cooperativamente por el bucle.
name identifica la tarea, context elige el contexto y eager_start permite iniciar de inmediato. El resultado procede de la corrutina. Las operaciones externas set_result y set_exception de Future no se admiten. Cuando se suspende en await pueden avanzar otras tareas. Esperar la tarea devuelve su valor o propaga su excepción. result() antes de terminar produce InvalidStateError y cancel() solicita la cancelación.
La señal permite a la tarea del ejemplo devolver True.
import asyncio
async def main():
async def fail():
raise LookupError("missing")
t = asyncio.create_task(fail())
try:
await t
except LookupError:
assert t.done() and isinstance(t.exception(), LookupError)
else:
raise AssertionError
asyncio.run(main())
import asyncio
async def main():
t = asyncio.create_task(asyncio.sleep(0, result=3), name="job")
for mutate in (lambda: t.set_result(4), lambda: t.set_exception(ValueError())):
try:
mutate()
except RuntimeError:
pass
else:
raise AssertionError
assert await t == 3 and t.get_name() == "job"
asyncio.run(main())
asyncio.Task.cancel · asyncio.Task.get_name
get_name() devuelve el nombre de la tarea, aquí reader. cancel(msg) solicita inyectar CancelledError en el siguiente ciclo del bucle. La corrutina puede capturarlo. Cuando la tarea termina, cancel() devuelve False.
import asyncio
async def main():
ready = asyncio.Event()
async def idle():
ready.set()
await asyncio.Event().wait()
task = asyncio.create_task(idle(), name="reader")
await ready.wait()
assert task.get_name() == "reader" and task.cancel("done")
try:
await task
except asyncio.CancelledError as exc:
assert exc.args == ("done",)
assert task.cancelled() and not task.cancel()
asyncio.run(main())
Ejemplos
import asyncio
async def main():
gate = asyncio.Event()
task = asyncio.create_task(gate.wait())
print(isinstance(task, asyncio.Task))
try:
task.result()
except asyncio.InvalidStateError as error:
print(type(error).__name__)
gate.set()
print(await task)
asyncio.run(main())
Resultado
True InvalidStateError True
La señal permite a la tarea del ejemplo devolver True.