CKTIS / Python
Odczytywanie nazwy zadania za pomocą `asyncio.Task.get_name()`
`get_name()` zwraca bieżącą nazwę zadania `asyncio` jako napis. W raporcie użyj nazwy jako etykiety, a stan anulowania ustal osobno za pomocą `cancelled()`.
Wersja: Python 3.12
Składnia
task.get_name() # returns strtask.get_name() to synchroniczna metoda instancji asyncio.Task, dostępna od Pythona 3.8. Nie przyjmuje argumentów i zwraca bieżącą nazwę jako str. Nie używaj await do odczytania nazwy: można ją odczytać zarówno przed zakończeniem zadania, jak i po nim.
Nadaj nazwę przez asyncio.create_task(coro, name=...) albo zmień ją przez task.set_name(value), które konwertuje wartość na napis. Jeśli nie nadasz nazwy jawnie, standardowa implementacja Task wygeneruje ją przy tworzeniu zadania. Traktuj nazwę jako etykietę diagnostyczną, a nie unikatowy identyfikator ani informację o stanie zadania.
task.cancel() zgłasza żądanie anulowania, lecz go nie gwarantuje: korutyna może przechwycić i stłumić asyncio.CancelledError. Na potrzeby raportu poczekaj na zakończenie zadania za pomocą await task, obsłuż oczekiwany asyncio.CancelledError i sprawdź task.cancelled(). Korutyna powinna zwykle zwalniać zasoby w finally i nie tłumić anulowania.
Przykłady
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())Wynik
report-worker: cancelled=True
Zdarzenie `started` pozwala poczekać na uruchomienie korutyny bez opóźnienia czasowego. Drugie zdarzenie nie zostaje ustawione, więc zadanie czeka na anulowanie. Raport łączy jawną nazwę ze stanem potwierdzonym po `await task`.
Powiązane lekcje
- Python · Lekcja 30 · Zaawansowany · Wersja: 5
Źródła
- 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)