Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

pstats.Stats — analiza wyników profilowania

pstats.Stats analizuje dane z profilera: sortuje statystyki funkcji i tworzy raporty. Nie mierzy wykonania samodzielnie; przyjmuje zapisany profil lub obiekt profilera.

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

Składnia

pstats.Stats(*filenames, stream=sys.stdout)
pstats.Stats(profile, stream=sys.stdout)

pstats.Stats przyjmuje nazwy plików profilu albo obiekt cProfile.Profile lub profile.Profile. Parametr stream wskazuje miejsce zapisu raportu; domyślnie jest nim sys.stdout.

sort_stats(pstats.SortKey.CUMULATIVE) porządkuje malejąco według czasu obejmującego wywołane funkcje. pstats.SortKey.TIME uwzględnia wyłącznie czas wewnątrz samej funkcji. print_stats(10) wypisuje pierwszych dziesięć pozycji.

strip_dirs() trwale usuwa ścieżki katalogów i może scalać nierozróżnialne wpisy; sortuj po tej operacji. Zgodność plików profilu między wersjami Pythona, profilerami i systemami operacyjnymi nie jest gwarantowana.

Przykłady

import cProfile
import io
import pstats


def work():
    return sum(range(10))


profiler = cProfile.Profile()
result = profiler.runcall(work)
report = io.StringIO()
stats = pstats.Stats(profiler, stream=report)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats()

print(result)
print("work" in report.getvalue())

Wynik

45
True

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

Źródła