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.