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