Python Glossary English

Python 3.14+Асинхронное программированиефункция

asyncio.format_call_graph()

граф вызовов

Возвращает асинхронный граф вызовов текущей задачи или переданного Future в виде читаемой строки — для логов и отладки.

Синтаксис

text = asyncio.format_call_graph(future=None, /, *, depth=1, limit=None)

Строка включает адреса объектов (id=0x…) и полные пути к файлам, поэтому в тестах её не сравнивают целиком. Каждая задача — строка «* Task(name=…)», под ней «+ Call stack» и «+ Awaited by». Это та же информация, что у capture_call_graph, только уже отформатированная; печатать сразу умеет print_call_graph. Вне задачи возвращает пустую строку. Появилась в 3.14.

Примеры

# Python 3.14+
import asyncio
async def child():
    text = asyncio.format_call_graph()
    print(text.splitlines()[0].startswith("* Task(name='child'"))  # → True
    print('+ Awaited by:' in text)  # → True
async def main():
    await asyncio.create_task(child(), name='child')
asyncio.run(main())

См. также

Открыть в полном глоссарииdocs.python.orgСообщить о неточности