Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

Zrušenie úlohy asyncio a získanie jej názvu

Požiadajte o zrušenie, počkajte na skončenie úlohy a vypíšte jej názov aj to, či bola skutočne zrušená.

Verzia: Python 3.12

Syntax

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

V Pythone 3.12 metóda asyncio.Task.cancel požiada o zrušenie úlohy. task.cancel() vráti True, ak zadá požiadavku, alebo False, ak sa úloha už skončila. True nepotvrdzuje zrušenie: na rozdiel od asyncio.Future.cancel() pri nedokončenom objekte Future toto volanie neprepne objekt okamžite do zrušeného stavu. Voliteľný parameter msg pribudol v Pythone 3.9; od verzie 3.11 sa správa odovzdáva kódu, ktorý čaká na zrušenú úlohu.

Pri najbližšej príležitosti slučka udalostí vyvolá v korutine výnimku asyncio.CancelledError. Upratovanie vykonajte v bloku finally. Ak výnimku zachytíte v úlohe, po uprataní ju spravidla znova vyvolajte. Dedí z BaseException, takže ju except Exception nezachytí. Potlačenie výnimky môže úlohe umožniť pokračovať a narušiť fungovanie asyncio.TaskGroup alebo asyncio.timeout().

Po zadaní požiadavky počkajte pomocou await task na skončenie úlohy. Ak sa úloha skončila zrušením, await vyvolá asyncio.CancelledError a task.cancelled() vráti True. Samotná požiadavka nestačí na to, aby task.cancelled() vrátilo True.

Do výpisu získajte názov úlohy cez task.get_name(), ktoré ho vráti ako str. Názov môžete zadať pomocou asyncio.create_task(..., name=...); bez výslovne zadaného názvu štandardná implementácia Task vygeneruje predvolený názov. get_name() je k dispozícii od Pythonu 3.8.

Príklady

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

Výsledok

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

Udalosť `started` zaručuje, že úloha vstúpila do bloku `try` pred zadaním požiadavky na zrušenie. Názov `worker` sa vypíše až po vykonaní bloku `finally`.

Súvisiace lekcie

  • Python · Lekcia 30 · Pokročilá · Verzia: 5

Zdroje