CKTIS / Python
pstats.Stats.stats — nezpracované statistiky profilování
pstats.Stats.stats je slovník profilovacích dat, jehož klíče tvoří název souboru, číslo řádku a název funkce. Umožňuje přímo číst počty volání, vlastní čas, kumulativní čas a informace o volajících funkcích, aniž by bylo nutné analyzovat textový výpis.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]pstats.Stats.stats je atribut instance, nikoli metoda. Každý klíč má tvar (filename, line_number, function_name) a každá hodnota tvar (cc, nc, tt, ct, callers). Ani úplný klíč neidentifikuje funkci jednoznačně: dvě různé funkce lambda definované na stejném řádku zdrojového kódu mají stejný název souboru, stejné číslo řádku i stejný název funkce (<lambda>), a tedy i stejný klíč.
cc počítá primitivní volání, bez volání vyvolaných rekurzí; nc počítá všechna volání. tt je vlastní čas funkce bez podvolání, zatímco ct je kumulativní čas včetně podvolání v sekundách. Nesčítejte hodnoty ct všech funkcí, abyste získali celkový čas programu: tyto časové intervaly se překrývají.
callers přiřazuje klíčům volajících funkcí data závislá na profileru. U cProfile má každá hodnota pro daný vztah volání tvar (nc, cc, tt, ct) — pořadí počitadel je oproti vnější n-tici obrácené. U profile je každou hodnotou počet volání. Rekurze může způsobit, že funkce volá sama sebe.
Považujte tento slovník za nízkoúrovňovou implementační reprezentaci CPythonu 3.14, nikoli za záruku přenosného formátu. Vyhněte se ručním úpravám: objekt udržuje také součty a mezipaměti. strip_dirs() mění klíče a může slučovat položky; sort_stats() určuje pořadí výpisu, nikoli pořadí slovníku. Příklad ukazuje deterministické počty místo proměnlivých časů. Tento záznam vychází z kódu repozitáře; produkční prostředí není doloženo.
Příklady
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}")Výsledek
primitive=1, total=4 recursive_caller=True
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.