CKTIS / Python
pstats.Stats.stats — nespracované štatistiky profilovania
pstats.Stats.stats je slovník profilovacích údajov, ktorého kľúče tvorí názov súboru, číslo riadka a názov funkcie. Umožňuje priamo čítať počty volaní, vlastný čas, kumulatívny čas a informácie o volajúcich funkciách bez analýzy textového výpisu.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]pstats.Stats.stats je atribút inštancie, nie metóda. Každý kľúč má tvar (filename, line_number, function_name) a každá hodnota tvar (cc, nc, tt, ct, callers). Ani úplný kľúč neidentifikuje funkciu jednoznačne: dve rôzne funkcie lambda definované v tom istom riadku zdrojového kódu majú rovnaký názov súboru, rovnaké číslo riadka aj rovnaký názov funkcie (<lambda>), a teda aj rovnaký kľúč.
cc počíta primitívne volania bez volaní vyvolaných rekurziou; nc počíta všetky volania. tt je vlastný čas funkcie bez podvolaní, zatiaľ čo ct je kumulatívny čas vrátane podvolaní v sekundách. Nesčítavajte hodnoty ct všetkých funkcií, aby ste získali celkový čas programu: tieto časové intervaly sa prekrývajú.
callers priraďuje kľúčom volajúcich funkcií údaje závislé od profilera. Pri cProfile má každá hodnota pre daný vzťah volania tvar (nc, cc, tt, ct) — poradie počítadiel je oproti vonkajšej n-tici obrátené. Pri profile je každou hodnotou počet volaní. Rekurzia môže spôsobiť, že funkcia volá samu seba.
Považujte tento slovník za nízkoúrovňovú implementačnú reprezentáciu CPythonu 3.14, nie za záruku prenosného formátu. Vyhnite sa ručným úpravám: objekt udržiava aj súčty a vyrovnávacie pamäte. strip_dirs() mení kľúče a môže zlučovať položky; sort_stats() určuje poradie výpisu, nie poradie slovníka. Príklad ukazuje deterministické počty namiesto premenlivých časov. Tento záznam vychádza z kódu repozitára; produkčné prostredie nie je potvrdené.
Prí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ýsledok
primitive=1, total=4 recursive_caller=True
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.