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() -> strU 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