CKTIS / Python
pstats.Stats.stats — neobdelani podatki profiliranja
pstats.Stats.stats je slovar podatkov profiliranja, katerega ključe sestavljajo ime datoteke, številka vrstice in ime funkcije. Omogoča neposredno branje števila klicev, lastnega časa, kumulativnega časa in informacij o kličočih funkcijah, ne da bi bilo treba analizirati besedilno poročilo.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]pstats.Stats.stats je atribut primerka, ne metoda. Vsak ključ ima obliko (filename, line_number, function_name), vsaka vrednost pa (cc, nc, tt, ct, callers). Niti celoten ključ ne določa funkcije enolično: dve različni funkciji lambda, definirani v isti vrstici izvorne kode, imata enako ime datoteke, številko vrstice in ime funkcije (<lambda>), zato imata isti ključ.
cc šteje primitivne klice, brez klicev, ki jih povzroči rekurzija; nc šteje vse klice. tt je lastni čas funkcije brez podklicev, ct pa kumulativni čas s podklici, izražen v sekundah. Vrednosti ct vseh funkcij ne seštevajte, da bi dobili skupni čas programa: ti časovni intervali se prekrivajo.
callers ključem kličočih funkcij priredi podatke, odvisne od profilerja. Pri cProfile je vsaka vrednost za ustrezno povezavo klica (nc, cc, tt, ct) — vrstni red števcev je glede na zunanjo terko obrnjen. Pri profile je vsaka vrednost število klicev. Zaradi rekurzije je lahko funkcija sama sebi kličoča funkcija.
Ta slovar obravnavajte kot nizkonivojsko predstavitev implementacije CPythona 3.14, ne kot zagotovilo prenosljivega formata. Izogibajte se ročnim spremembam: objekt vzdržuje tudi vsote in predpomnilnike. strip_dirs() spremeni ključe in lahko združi vnose; sort_stats() določi vrstni red poročila, ne vrstnega reda slovarja. Primer prikazuje deterministične števce namesto spremenljivih časov. Zapis temelji na kodi repozitorija; produkcijsko okolje ni potrjeno.
Primeri
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}")Rezultat
primitive=1, total=4 recursive_caller=True
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.