CKTIS / Python
asyncio.Task
Repräsentiert eine kooperativ von der Ereignisschleife ausgeführte Koroutine.
Version: Python 3.14; repository image, production runtime not attested
Syntax
task = asyncio.create_task(coro)Repräsentiert eine kooperativ von der Ereignisschleife ausgeführte Koroutine.
name benennt den Task, context wählt den Ausführungskontext und eager_start erlaubt sofortigen Start. Das Ergebnis stammt aus der Koroutine. Externe Aufrufe von set_result und set_exception wie bei Future sind unzulässig. Während sie bei await aussetzt, können andere Tasks laufen. await des Tasks liefert den Wert oder gibt die Ausnahme weiter. result() vor Abschluss löst InvalidStateError aus, cancel() fordert Abbruch an.
Die Freigabe lässt den Task im Beispiel True liefern.
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() liefert den Aufgabennamen, hier reader. cancel(msg) fordert für den nächsten Schleifendurchlauf einen CancelledError an. Die Koroutine kann ihn abfangen. Nach Abschluss liefert 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())
Beispiele
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())
Ergebnis
True InvalidStateError True
Die Freigabe lässt den Task im Beispiel True liefern.