CKTIS / Python
asyncio.Task
Vertegenwoordigt een coroutine die de lus coöperatief uitvoert.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
task = asyncio.create_task(coro)Vertegenwoordigt een coroutine die de lus coöperatief uitvoert.
name benoemt de taak, context kiest de uitvoeringscontext en eager_start laat direct beginnen. Het resultaat komt uit de coroutine. Extern set_result en set_exception aanroepen zoals bij Future is niet toegestaan. Wanneer de coroutine bij await wordt onderbroken kunnen andere taken draaien. Wachten op de taak geeft de waarde of geeft de uitzondering door. result() vóór voltooiing geeft InvalidStateError en cancel() verzoekt om annulering.
Het signaal laat de taak in het voorbeeld True geven.
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() geeft de taaknaam, hier reader. cancel(msg) vraagt om CancelledError tijdens de volgende luscyclus. De coroutine kan die opvangen. Na voltooiing geeft 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())
Voorbeelden
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())
Resultaat
True InvalidStateError True
Het signaal laat de taak in het voorbeeld True geven.