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 strtask.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
- Coroutines and Tasks — Task.get_name() (Python 3.12)
- Coroutines and Tasks — asyncio.create_task() (Python 3.12)
- Coroutines and Tasks — Task.set_name() (Python 3.12)
- Coroutines and Tasks — Task.cancel() (Python 3.12)
- Coroutines and Tasks — Task.cancelled() (Python 3.12)
- Coroutines and Tasks — Task Cancellation (Python 3.12)