Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

Branje imena opravila z `asyncio.Task.get_name()`

`get_name()` vrne trenutno ime opravila asyncio kot niz. V poročilu ga uporabi kot oznako, s `cancelled()` pa ločeno preveri, ali je bilo opravilo res preklicano.

Različica: Python 3.12

Sintaksa

task.get_name()  # returns str

task.get_name() je sinhrona metoda primerka asyncio.Task, ki je na voljo od Pythona 3.8. Ne sprejme argumentov in vrne trenutno ime kot str. Klic ne potrebuje await: ime lahko prebereš pred koncem opravila ali po njem.

Ime dodeli z asyncio.create_task(coro, name=...) ali ga spremeni z task.set_name(value), ki vrednost pretvori v niz. Če imena ne določiš izrecno, ga standardna implementacija Task ustvari ob nastanku opravila. Uporabljaj ga kot diagnostično oznako, ne kot enolični identifikator ali podatek o stanju.

task.cancel() zahteva preklic, vendar ga ne zagotovi: korutina lahko prestreže in zatre izjemo asyncio.CancelledError. Za poročilo počakaj na konec opravila z await task, obravnavaj pričakovano izjemo asyncio.CancelledError in preveri task.cancelled(). Korutina naj praviloma sprosti vire v finally in pusti, da se preklic širi naprej.

Primeri

import asyncio


async def worker(started):
    started.set()
    await asyncio.Event().wait()


async def main():
    started = asyncio.Event()
    task = asyncio.create_task(worker(started), name="report-worker")
    await started.wait()
    task.cancel()

    try:
        await task
    except asyncio.CancelledError:
        print(f"{task.get_name()}: cancelled={task.cancelled()}")


if __name__ == "__main__":
    asyncio.run(main())

Rezultat

report-worker: cancelled=True

Dogodek `started` klicatelju omogoča, da brez vnaprej določenega zamika počaka na začetek korutine. Drugi dogodek ni nikoli nastavljen, zato opravilo čaka do preklica. Poročilo združi izrecno določeno ime s stanjem, potrjenim po `await task`.

Povezane lekcije

  • Python · Lekcija 30 · Napredna · Različica: 5

Viri