Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Palavra-chave async

Uma definição async def sem yield cria uma função de corrotina cuja chamada devolve uma corrotina sem executar o corpo.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

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

Uma definição async def sem yield cria uma função de corrotina cuja chamada devolve uma corrotina sem executar o corpo.

Com yield cria uma função geradora assíncrona e só a chamada devolve o gerador assíncrono. Num módulo normal usam-se async for e async with no corpo de uma async def para iterar ou entrar e sair de um contexto de forma assíncrona.

A sintaxe por si só não inicia tarefas em paralelo.

Exemplos

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)

Resultado

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

A sintaxe por si só não inicia tarefas em paralelo.

Fontes