Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Python

Otkazivanje zadatka asyncio i dohvaćanje njegova naziva

Zatraži otkazivanje, pričekaj da zadatak završi pa ispiši njegov naziv i podatak o tome je li doista otkazan.

Verzija: Python 3.12

Sintaksa

task.cancel(msg=None) -> bool
task.cancelled() -> bool
task.get_name() -> str

U Pythonu 3.12 metoda asyncio.Task.cancel traži otkazivanje zadatka. task.cancel() vraća True ako pošalje zahtjev i False ako je zadatak već završio. True ne potvrđuje otkazivanje: za razliku od asyncio.Future.cancel() na objektu Future koji još nije dovršen, ovaj poziv ne prebacuje objekt odmah u stanje otkazanosti. Neobavezni parametar msg dodan je u Pythonu 3.9; od verzije 3.11 poruka se prosljeđuje kodu koji čeka otkazani zadatak.

Prvom prilikom petlja događaja podiže iznimku asyncio.CancelledError unutar korutine. Čišćenje obavi u bloku finally. Ako uhvatiš iznimku unutar zadatka, nakon čišćenja u pravilu je ponovno podigni. Nasljeđuje BaseException, pa je except Exception ne hvata. Potiskivanje iznimke može omogućiti nastavak zadatka i omesti rad asyncio.TaskGroup ili asyncio.timeout().

Nakon zahtjeva za otkazivanje upotrijebi await task da pričekaš kraj zadatka. Ako je zadatak završio otkazivanjem, await podiže asyncio.CancelledError, a task.cancelled() vraća True. Sam zahtjev nije dovoljan da task.cancelled() vrati True.

Za izvještaj dohvati naziv zadatka pozivom task.get_name(), koji ga vraća kao str. Naziv možeš zadati s asyncio.create_task(..., name=...); ako naziv nije izričito zadan, standardna implementacija klase Task stvara zadani naziv. get_name() je dostupan od Pythona 3.8.

Primjeri

import asyncio


async def worker(started, release):
    try:
        started.set()
        await release.wait()
    finally:
        print("cleanup")


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

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


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

Rezultat

requested=True, cancelled=False
cleanup
worker: cancelled=True

Događaj `started` osigurava da je zadatak ušao u blok `try` prije zahtjeva za otkazivanje. Izvještaj ispisuje naziv `worker` tek nakon izvršavanja bloka `finally`.

Povezane lekcije

  • Python · Lekcija 30 · Napredno · Verzija: 5

Izvori