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

CKTIS / Python

Прочитане на името на задача с `asyncio.Task.get_name()`

`get_name()` връща текущото име на задача в asyncio като низ. Използвай името като етикет в отчет, а с `cancelled()` провери отделно дали задачата действително е отменена.

Версия: Python 3.12

Синтаксис

task.get_name()  # returns str

task.get_name() е синхронен метод на екземпляр на asyncio.Task, наличен от Python 3.8. Не приема аргументи и връща текущото име като str. Не е нужен await: името може да се прочете както преди, така и след приключването на задачата.

Задай име чрез asyncio.create_task(coro, name=...) или го промени с task.set_name(value), който преобразува стойността в низ. Ако не зададеш име изрично, стандартната реализация на Task генерира име при създаването на задачата. Използвай го като диагностичен етикет, а не като уникален идентификатор или показател за състояние.

task.cancel() заявява отмяна, но не я гарантира: корутината може да прихване и потисне asyncio.CancelledError. За да отчетеш резултата, изчакай задачата да приключи с await task, обработи очакваното изключение asyncio.CancelledError и провери task.cancelled(). Обикновено корутината трябва да освобождава ресурси във finally и да не потиска отмяната.

Примери

import asyncio


async def worker(started):
    started.set()
    await asyncio.Event().wait()


async def main():
    started = asyncio.Event()
    task = asyncio.create_task(worker(started), name="report-worker")
    await started.wait()
    task.cancel()

    try:
        await task
    except asyncio.CancelledError:
        print(f"{task.get_name()}: cancelled={task.cancelled()}")


if __name__ == "__main__":
    asyncio.run(main())

Резултат

report-worker: cancelled=True

Събитието `started` позволява на извикващия код да изчака стартирането на корутината без зададено закъснение. Второто събитие никога не се сигнализира, затова задачата остава в изчакване до отмяната. Отчетът съчетава изрично зададеното име със състоянието, потвърдено след `await task`.

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

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

Източници