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