CKTIS / Python
pstats.Stats.stats — sirove statistike profiliranja
pstats.Stats.stats je rječnik podataka profiliranja čiji se ključevi sastoje od naziva datoteke, broja retka i naziva funkcije. Omogućuje izravno čitanje broja poziva, vlastitog vremena, kumulativnog vremena i informacija o funkcijama koje pozivaju, bez analiziranja tekstualnog izvješća.
Verzija: 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 atribut je instance, a ne metoda. Svaki ključ ima oblik (filename, line_number, function_name), a svaka vrijednost (cc, nc, tt, ct, callers). Ni potpuni ključ ne identificira funkciju jednoznačno: dvije različite funkcije lambda definirane u istom retku izvornog koda imaju isti naziv datoteke, isti broj retka i isti naziv funkcije (<lambda>), pa imaju isti ključ.
cc broji primitivne pozive, ne uključujući pozive izazvane rekurzijom; nc broji sve pozive. tt je vlastito vrijeme funkcije bez podpoziva, dok je ct kumulativno vrijeme s uključenim podpozivima, izraženo u sekundama. Nemoj zbrajati vrijednosti ct svih funkcija da bi dobio ukupno vrijeme programa: ti se intervali preklapaju.
callers povezuje ključeve funkcija koje pozivaju s podacima ovisnima o profileru. Uz cProfile, svaka je vrijednost (nc, cc, tt, ct) za odgovarajući odnos poziva — redoslijed brojača obrnut je u odnosu na vanjsku n-torku. Uz profile, svaka je vrijednost broj poziva. Zbog rekurzije funkcija može pozivati samu sebe.
Ovaj rječnik smatraj niskorazinskim prikazom implementacije CPythona 3.14, a ne jamstvom prenosivog formata. Izbjegavaj ručne izmjene: objekt održava i zbrojeve i predmemorije. strip_dirs() mijenja ključeve i može spojiti unose; sort_stats() određuje redoslijed izvješća, a ne redoslijed rječnika. Primjer prikazuje determinističke brojače umjesto promjenjivih vremena. Ovaj se zapis temelji na kodu repozitorija; produkcijsko okruženje nije potvrđeno.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.