Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 str

task.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