Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

pstats — analiza wyników profilowania

Moduł pstats analizuje dane z cProfile lub profile: porządkuje statystyki funkcji i generuje raporty pomagające znaleźć kosztowne fragmenty programu.

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

Składnia

import pstats
stats = pstats.Stats(profile_or_filename)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats(10)

pstats analizuje wyniki profilowania, zamiast samodzielnie mierzyć wykonanie programu. pstats.Stats przyjmuje obiekt profilera albo nazwę pliku z jego danymi.

pstats.Stats odczytuje zapisane dane profilowania za pomocą modułu marshal, którego nie można bezpiecznie używać do wczytywania niezaufanych lub nieuwierzytelnionych danych. Nie wczytuj plików profilowania z niezaufanych źródeł ani plików, których autentyczności nie potwierdzono.

sort_stats(pstats.SortKey.TIME) porządkuje według czasu własnego funkcji, bez wywołanych funkcji; pstats.SortKey.CUMULATIVE uwzględnia ich czas. print_stats(10) wypisuje pierwszych dziesięć pozycji.

get_stats_profile() udostępnia dane programowo. Przykład odczytuje liczbę wywołań work, pomijając zmienne czasy pomiaru.

Nie zakładaj zgodności plików profilowania między wersjami Pythona, profilerami ani systemami operacyjnymi. strip_dirs() usuwa ścieżki nieodwracalnie z obiektu i może scalić nierozróżnialne wpisy.

Przykłady

import cProfile
import pstats


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


profiler = cProfile.Profile()
result = profiler.runcall(work)
stats = pstats.Stats(profiler)
functions = stats.get_stats_profile().func_profiles

print(result)
print(functions["work"].ncalls)

Wynik

45
1

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

Źródła