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

CKTIS / Python

Mot-clé async

Une définition async def sans yield crée une fonction coroutine dont l’appel renvoie une coroutine sans exécuter le corps.

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

Syntaxe

async def read(source, manager):
    async with manager:
        async for item in source:
            ...

Une définition async def sans yield crée une fonction coroutine dont l’appel renvoie une coroutine sans exécuter le corps.

Avec yield elle crée une fonction génératrice asynchrone, et seul son appel renvoie le générateur asynchrone. Dans un module ordinaire async for et async with se placent dans le corps d’une async def pour itérer ou entrer dans un contexte et en sortir de manière asynchrone.

La syntaxe seule ne lance pas de tâches parallèles.

Exemples

import asyncio
from contextlib import nullcontext
async def rows():
    yield 2
    yield 5
async def collect(trace):
    trace.append("started")
    async with nullcontext("ok") as label:
        assert label == "ok"
        return [v async for v in rows()]
trace = []
job = collect(trace)
print(trace)
print(asyncio.run(job), trace)
import inspect
assert inspect.isasyncgenfunction(rows) and inspect.isasyncgen(rows())
for source in ("async for x in y:\n    pass", "async with m:\n    pass"):
    try:
        compile(source, "<module>", "exec")
    except SyntaxError:
        continue
    raise AssertionError(source)

Résultat

[]
[2, 5] ['started']

La syntaxe seule ne lance pas de tâches parallèles.

Sources