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

CKTIS / Python

asyncio.create_task

Agenda uma corrotina no ciclo ativo e devolve uma tarefa.

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

Sintaxe

asyncio.create_task(coro, *, name=None, context=None, eager_start=None, **kwargs)

Agenda uma corrotina no ciclo ativo e devolve uma tarefa.

Em 3.14 os **kwargs adicionais seguem para loop.create_task. Sem eager_start a fábrica de tarefas do ciclo determina o modo de início. Por predefinição copia o contexto de quem chama. Guarde uma referência forte e use await para obter o resultado ou a exceção. Em 3.14 eager_start=True permite iniciar logo até à primeira suspensão. Sem ciclo ativo gera RuntimeError.

O exemplo devolve 8 e done() dá True.

import asyncio
async def main():
    steps = []
    async def tick():
        steps.append("start")
        await asyncio.sleep(0)
        return 8
    t = asyncio.create_task(tick(), name="tick", eager_start=True)
    assert steps == ["start"] and t.get_name() == "tick"
    assert await t == 8 and t.done()
asyncio.run(main())
import asyncio
async def main():
    loop = asyncio.get_running_loop()
    received = []
    def factory(loop, coro, **opts):
        received.append(opts.pop("marker", None))
        return asyncio.Task(coro, loop=loop, **opts)
    loop.set_task_factory(factory)
    try:
        assert await asyncio.create_task(asyncio.sleep(0, result=3), marker=7) == 3
    finally:
        loop.set_task_factory(None)
    assert received == [7]
asyncio.run(main())

Exemplos

import asyncio

async def main():
    task = asyncio.create_task(asyncio.sleep(0, result=8))
    print(await task)
    print(task.done())

asyncio.run(main())

Resultado

8
True

O exemplo devolve 8 e done() dá True.

Fontes