Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes