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

CKTIS / Python

asyncio.Task

Représente une coroutine pilotée de manière coopérative par la boucle.

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

Syntaxe

task = asyncio.create_task(coro)

Représente une coroutine pilotée de manière coopérative par la boucle.

name nomme la tâche, context choisit son contexte et eager_start autorise un démarrage immédiat. Le résultat vient de la coroutine. Les appels externes à set_result et set_exception de Future sont refusés. Quand elle se suspend sur await, d’autres tâches peuvent avancer. Attendre la tâche renvoie sa valeur ou propage son exception. result() avant la fin lève InvalidStateError et cancel() demande l’annulation.

Le signal permet à la tâche de l’exemple de renvoyer 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() renvoie le nom de la tâche, ici reader. cancel(msg) demande l’injection de CancelledError au prochain tour de boucle. La coroutine peut l’intercepter. Après la fin de la tâche, cancel() renvoie 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())

Exemples

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())

Résultat

True
InvalidStateError
True

Le signal permet à la tâche de l’exemple de renvoyer True.

Sources