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.