Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

pstats.Stats.stats — nezpracované statistiky profilování

pstats.Stats.stats je slovník profilovacích dat, jehož klíče tvoří název souboru, číslo řádku a název funkce. Umožňuje přímo číst počty volání, vlastní čas, kumulativní čas a informace o volajících funkcích, aniž by bylo nutné analyzovat textový výpis.

Verze: Python 3.14; repository image, production runtime not attested

Syntaxe

stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]

pstats.Stats.stats je atribut instance, nikoli metoda. Každý klíč má tvar (filename, line_number, function_name) a každá hodnota tvar (cc, nc, tt, ct, callers). Ani úplný klíč neidentifikuje funkci jednoznačně: dvě různé funkce lambda definované na stejném řádku zdrojového kódu mají stejný název souboru, stejné číslo řádku i stejný název funkce (<lambda>), a tedy i stejný klíč.

cc počítá primitivní volání, bez volání vyvolaných rekurzí; nc počítá všechna volání. tt je vlastní čas funkce bez podvolání, zatímco ct je kumulativní čas včetně podvolání v sekundách. Nesčítejte hodnoty ct všech funkcí, abyste získali celkový čas programu: tyto časové intervaly se překrývají.

callers přiřazuje klíčům volajících funkcí data závislá na profileru. U cProfile má každá hodnota pro daný vztah volání tvar (nc, cc, tt, ct) — pořadí počitadel je oproti vnější n-tici obrácené. U profile je každou hodnotou počet volání. Rekurze může způsobit, že funkce volá sama sebe.

Považujte tento slovník za nízkoúrovňovou implementační reprezentaci CPythonu 3.14, nikoli za záruku přenosného formátu. Vyhněte se ručním úpravám: objekt udržuje také součty a mezipaměti. strip_dirs() mění klíče a může slučovat položky; sort_stats() určuje pořadí výpisu, nikoli pořadí slovníku. Příklad ukazuje deterministické počty místo proměnlivých časů. Tento záznam vychází z kódu repozitáře; produkční prostředí není doloženo.

Pří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ýsledek

primitive=1, total=4
recursive_caller=True

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje