CKTIS / Python
asyncio.Task
Представлява корутина, изпълнявана кооперативно от цикъла.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
task = asyncio.create_task(coro)Представлява корутина, изпълнявана кооперативно от цикъла.
name дава име на задачата, context избира контекст, а eager_start позволява незабавно начало. Резултатът идва от корутината. Външните операции set_result и set_exception от Future не са разрешени. Когато спре при await, могат да работят други задачи. Изчакването на задачата връща стойност или предава изключение. result() преди края поражда InvalidStateError, а cancel() заявява отмяна.
Сигналът позволява на задачата в примера да върне 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() връща името на задачата, тук reader. cancel(msg) заявява вмъкване на CancelledError при следващия цикъл. Корутината може да го прихване. След края на задачата cancel() връща 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())
Примери
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())
Резултат
True InvalidStateError True
Сигналът позволява на задачата в примера да върне True.