Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori