CKTIS / Python
Прочитане на името на задача с `asyncio.Task.get_name()`
`get_name()` връща текущото име на задача в asyncio като низ. Използвай името като етикет в отчет, а с `cancelled()` провери отделно дали задачата действително е отменена.
Версия: Python 3.12
Синтаксис
task.get_name() # returns strtask.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
Източници
- Coroutines and Tasks — Task.get_name() (Python 3.12)
- Coroutines and Tasks — asyncio.create_task() (Python 3.12)
- Coroutines and Tasks — Task.set_name() (Python 3.12)
- Coroutines and Tasks — Task.cancel() (Python 3.12)
- Coroutines and Tasks — Task.cancelled() (Python 3.12)
- Coroutines and Tasks — Task Cancellation (Python 3.12)