CKTIS / Python
asyncio.Task
Reprezentuje korutynę prowadzoną współbieżnie przez pętlę zdarzeń.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
task = asyncio.create_task(coro)Reprezentuje korutynę prowadzoną współbieżnie przez pętlę zdarzeń.
name opisuje zadanie, context wybiera kontekst wykonania, a eager_start może zacząć je od razu. Wynik pochodzi z korutyny. Zewnętrzne set_result i set_exception znane z Future są niedozwolone. Gdy korutyna zawiesza się na await, mogą działać inne zadania. await zadania oddaje wynik lub propaguje wyjątek. result() przed zakończeniem zgłasza InvalidStateError, a cancel() żąda anulowania.
W przykładzie otwarcie bramki pozwala zadaniu zwrócić 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() zwraca nazwę zadania, tu reader. cancel(msg) prosi o wstrzyknięcie CancelledError przy następnym kroku pętli. Korutyna może przechwycić wyjątek. Po zakończeniu zadania cancel() zwraca 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())
Przykłady
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())
Wynik
True InvalidStateError True
W przykładzie otwarcie bramki pozwala zadaniu zwrócić True.