Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri