Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

asyncio.Task

Representa uma corrotina executada cooperativamente pelo ciclo.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

task = asyncio.create_task(coro)

Representa uma corrotina executada cooperativamente pelo ciclo.

name identifica a tarefa, context escolhe o contexto e eager_start permite iniciar de imediato. O resultado vem da corrotina. As operações externas set_result e set_exception de Future não são permitidas. Quando se suspende em await outras tarefas podem avançar. Aguardar a tarefa devolve o valor ou propaga a exceção. result() antes da conclusão gera InvalidStateError e cancel() pede o cancelamento.

O sinal permite à tarefa do exemplo 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() devolve o nome da tarefa, aqui reader. cancel(msg) pede a injeção de CancelledError na volta seguinte do ciclo. A corrotina pode capturá-lo. Após a conclusão, cancel() devolve 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())

Exemplos

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

O sinal permite à tarefa do exemplo devolver True.

Fontes