База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

Отмяна на задача в asyncio и извличане на името ѝ

Поискай отмяна, изчакай задачата да приключи и отчети името ѝ и дали действително е отменена.

Версия: Python 3.12

Синтаксис

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

В Python 3.12 asyncio.Task.cancel подава заявка за отмяна на задача. task.cancel() връща True, ако подаде заявката, и False, ако задачата вече е приключила. True не потвърждава отмяната: за разлика от asyncio.Future.cancel() при неприключил обект Future, това извикване не променя незабавно състоянието на обекта на „отменен“. Незадължителният параметър msg е добавен в Python 3.9; от версия 3.11 съобщението се предава на кода, който изчаква отменената задача.

При първа възможност цикълът на събитията повдига asyncio.CancelledError в корутината. Освобождавай ресурсите в finally. Ако прихванеш изключението в самата задача, обикновено трябва да го повдигнеш отново след освобождаването на ресурсите. То наследява BaseException, затова except Exception не го прихваща. Потискането му може да позволи на задачата да продължи и да попречи на работата на asyncio.TaskGroup или asyncio.timeout().

След заявката за отмяна използвай await task, за да изчакаш задачата да приключи. Ако тя е приключила поради отмяна, await повдига asyncio.CancelledError, а task.cancelled() връща True. Самата заявка не е достатъчна, за да върне task.cancelled() стойност True.

За отчета използвай task.get_name(), за да получиш името на задачата като str. Можеш да го зададеш чрез asyncio.create_task(..., name=...); ако не е зададено изрично, стандартната реализация на Task генерира име по подразбиране. get_name() е наличен от Python 3.8.

Примери

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

Резултат

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

Събитието `started` гарантира, че задачата е влязла в блока `try` преди заявката за отмяна. Отчетът извежда името `worker` едва след изпълнението на `finally`.

Свързани уроци

  • Python · Урок 30 · Напреднало · Версия: 5

Източници