CKTIS / Python
asyncio.Task
Representa uma corrotina executada cooperativamente pelo ciclo.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
task = asyncio.create_task(coro)Representa uma corrotina executada cooperativamente pelo ciclo.
name identifica a tarefa, context escolhe o contexto e eager_start permite iniciar de imediato. O resultado vem da corrotina. As operações externas set_result e set_exception de Future não são permitidas. Quando se suspende em await outras tarefas podem avançar. Aguardar a tarefa devolve o valor ou propaga a exceção. result() antes da conclusão gera InvalidStateError e cancel() pede o cancelamento.
O sinal permite à tarefa do exemplo devolver 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() devolve o nome da tarefa, aqui reader. cancel(msg) pede a injeção de CancelledError na volta seguinte do ciclo. A corrotina pode capturá-lo. Após a conclusão, cancel() devolve 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())
Exemplos
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())
Resultado
True InvalidStateError True
O sinal permite à tarefa do exemplo devolver True.