CKTIS / Python
Čtení názvu úlohy pomocí `asyncio.Task.get_name()`
`get_name()` vrací aktuální název úlohy asyncio jako řetězec. V hlášení jej použij jako popisek a skutečné zrušení úlohy ověř zvlášť pomocí `cancelled()`.
Verze: Python 3.12
Syntaxe
task.get_name() # returns strtask.get_name() je synchronní instanční metoda asyncio.Task, dostupná od Pythonu 3.8. Nepřijímá argumenty a vrací aktuální název jako str. Nepoužívá se s await: název lze přečíst před dokončením úlohy i po něm.
Název nastav při vytváření pomocí asyncio.create_task(coro, name=...) nebo ho změň metodou task.set_name(value), která hodnotu převede na řetězec. Pokud název výslovně nezadáš, standardní implementace Task jej vygeneruje při vytvoření úlohy. Používej jej jako diagnostický popisek, ne jako jedinečný identifikátor ani ukazatel stavu.
task.cancel() požádá o zrušení, ale nezaručuje je: korutina může výjimku asyncio.CancelledError zachytit a potlačit. Pro hlášení výsledku počkej na dokončení pomocí await task, ošetři očekávanou výjimku asyncio.CancelledError a zkontroluj task.cancelled(). Korutina by běžně měla uvolnit prostředky v finally a nechat zrušení šířit dál.
Příklady
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())Výsledek
report-worker: cancelled=True
Událost `started` umožňuje volajícímu počkat na spuštění korutiny bez pevné prodlevy. Druhá událost se nikdy nenastaví, takže úloha čeká až do zrušení. Hlášení spojuje výslovně zadaný název se stavem potvrzeným po `await task`.
Související lekce
- Python · Lekce 30 · Pokročilá · Verze: 5
Zdroje
- 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)