WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen