Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

asyncio.create_task

Planifie une coroutine sur la boucle active et renvoie une tâche.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

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

Planifie une coroutine sur la boucle active et renvoie une tâche.

En 3.14 les **kwargs supplémentaires sont transmis à loop.create_task. Sans eager_start, la fabrique de tâches de la boucle détermine le mode de démarrage. Par défaut le contexte de l’appelant est copié. Conserver une référence forte et attendre avec await pour récupérer résultat ou exception. En 3.14 eager_start=True permet de commencer immédiatement jusqu’à la première suspension. Sans boucle active, RuntimeError est levée.

L’exemple renvoie 8 et done() vaut 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())

Exemples

import asyncio

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

asyncio.run(main())

Résultat

8
True

L’exemple renvoie 8 et done() vaut True.

Sources