Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

pstats.Stats.stats — surowe statystyki profilowania

pstats.Stats.stats to słownik danych profilowania, którego klucze składają się z nazwy pliku, numeru wiersza i nazwy funkcji. Pozwala odczytać liczniki wywołań, czas własny, czas skumulowany i dane o funkcjach wywołujących bez analizowania tekstowego raportu.

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

Składnia

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

pstats.Stats.stats jest atrybutem instancji, nie metodą. Klucz ma postać (filename, line_number, function_name), a wartość to (cc, nc, tt, ct, callers). Nawet pełny klucz nie identyfikuje funkcji jednoznacznie: dwie różne funkcje lambda zdefiniowane w tym samym wierszu kodu źródłowego mają tę samą nazwę pliku, ten sam numer wiersza i tę samą nazwę funkcji (<lambda>), więc mają ten sam klucz.

cc oznacza liczbę wywołań pierwotnych, bez wywołań indukowanych rekurencją; nc obejmuje wszystkie wywołania. tt to czas własny funkcji, bez podwywołań, a ct to czas skumulowany wraz z podwywołaniami, w sekundach. Nie sumuj ct wszystkich funkcji jako czasu całego programu: te przedziały nakładają się.

callers mapuje klucze funkcji wywołujących na dane zależne od profilera. Dla cProfile wartością jest (nc, cc, tt, ct) dla danej relacji wywołania — kolejność liczników jest odwrotna niż w krotce zewnętrznej. Dla profile wartością jest liczba wywołań. Rekurencja może sprawić, że funkcja będzie swoim własnym wywołującym.

Traktuj ten słownik jako niskopoziomową reprezentację implementacji CPython 3.14, a nie gwarancję przenośnego formatu. Unikaj ręcznej modyfikacji: obiekt utrzymuje też sumy i pamięci podręczne. strip_dirs() zmienia klucze i może scalać wpisy; sort_stats() ustala kolejność raportu, nie kolejność słownika. Przykład pokazuje deterministyczne liczniki zamiast zmiennych czasów. Podstawą jest kod repozytorium; nie potwierdzono środowiska produkcyjnego.

Przykłady

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}")

Wynik

primitive=1, total=4
recursive_caller=True

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła