CKTIS / Python
pstats.Stats.stats — необработени статистики от профилиране
pstats.Stats.stats е речник с данни от профилиране, чиито ключове се състоят от име на файл, номер на ред и име на функция. Той позволява директно да се прочетат броят извиквания, вътрешното време, кумулативното време и информацията за извикващите функции, без да се анализира текстов отчет.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]pstats.Stats.stats е атрибут на екземпляр, а не метод. Всеки ключ е във формат (filename, line_number, function_name), а всяка стойност — (cc, nc, tt, ct, callers). Дори пълният ключ не идентифицира функцията еднозначно: две различни lambda функции, дефинирани на един и същ ред в изходния код, имат едно и също име на файл, един и същ номер на ред и едно и също име на функция (<lambda>), затова ключът им е един и същ.
cc брои примитивните извиквания, без извикванията, породени от рекурсия; nc брои всички извиквания. tt е вътрешното време на функцията без подизвиквания, а ct е кумулативното време с включени подизвиквания, в секунди. Не сумирайте стойностите ct на всички функции, за да получите общото време на програмата: тези интервали се припокриват.
callers свързва ключовете на извикващите функции с данни, зависещи от профайлера. При cProfile всяка стойност е (nc, cc, tt, ct) за съответната връзка на извикване — редът на броячите е обратен на този във външния кортеж. При profile всяка стойност е брой извиквания. Рекурсията може да направи функцията свой собствен извикващ.
Разглеждайте този речник като нискониво представяне на имплементацията на CPython 3.14, а не като гаранция за преносим формат. Избягвайте ръчни промени: обектът поддържа и суми, и кешове. strip_dirs() променя ключовете и може да слее записи; sort_stats() задава реда на отчета, а не на речника. Примерът показва детерминистични броячи вместо променливи времена. Този запис се основава на кода в хранилището; производствената среда не е удостоверена.
Примери
import cProfile
import pstats
def countdown(n):
if n:
countdown(n - 1)
profiler = cProfile.Profile()
profiler.runcall(countdown, 3)
stats = pstats.Stats(profiler)
key = (countdown.__code__.co_filename,
countdown.__code__.co_firstlineno,
countdown.__code__.co_name)
cc, nc, tt, ct, callers = stats.stats[key]
assert (cc, nc) == (1, 4)
assert key in callers
print(f"primitive={cc}, total={nc}")
print(f"recursive_caller={key in callers}")Резултат
primitive=1, total=4 recursive_caller=True
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.