CKTIS / Python
asyncio.Future
Liga a conclusão por função de retorno a await através de um objeto criado pelo ciclo.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
future = asyncio.get_running_loop().create_future()Liga a conclusão por função de retorno a await através de um objeto criado pelo ciclo.
Um Future guarda um resultado, exceção ou cancelamento e vários await observam o mesmo desfecho. result() antes da conclusão e novo set_result depois geram InvalidStateError.
O exemplo obtém 7 e rejeita a segunda tentativa de definir 9.
import asyncio
async def main():
f = asyncio.get_running_loop().create_future()
try:
f.result()
except asyncio.InvalidStateError:
pass
else:
raise AssertionError
f.set_result(5)
assert await f == 5 and await f == 5
g = asyncio.get_running_loop().create_future()
g.cancel()
assert g.done() and g.cancelled()
asyncio.run(main())
Exemplos
import asyncio
async def main():
future = asyncio.get_running_loop().create_future()
print(isinstance(future, asyncio.Future), future.done())
future.set_result(7)
print(await future)
try:
future.set_result(9)
except asyncio.InvalidStateError as error:
print(type(error).__name__)
asyncio.run(main())
Resultado
True False 7 InvalidStateError
O exemplo obtém 7 e rejeita a segunda tentativa de definir 9.