CKTIS / Python
pstats — Profilergebnisse analysieren
Das Modul pstats analysiert Daten aus cProfile oder profile: Es sortiert Funktionsstatistiken und erstellt Berichte, die dabei helfen, aufwendige Programmteile zu finden.
Version: Python 3.14; repository image, production runtime not attested
Syntax
import pstats
stats = pstats.Stats(profile_or_filename)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats(10)pstats analysiert Profilergebnisse, statt die Programmausführung selbst zu messen. pstats.Stats akzeptiert ein Profiler-Objekt oder den Namen einer Datei mit dessen Daten.
pstats.Stats liest gespeicherte Profildaten mit marshal. Für nicht vertrauenswürdige oder nicht authentifizierte Eingabedaten ist marshal nicht sicher. Lade keine Profiler-Dateien aus nicht vertrauenswürdigen Quellen oder Dateien, deren Echtheit nicht überprüft wurde.
sort_stats(pstats.SortKey.TIME) sortiert nach der Eigenzeit einer Funktion, ohne die aufgerufenen Funktionen; pstats.SortKey.CUMULATIVE berücksichtigt deren Zeit. print_stats(10) gibt die ersten zehn Einträge aus.
get_stats_profile() ermöglicht den programmatischen Zugriff. Das Beispiel liest die Anzahl der Aufrufe von work aus und vermeidet variable Zeitmessungen.
Gehe nicht davon aus, dass Profiler-Dateien zwischen Python-Versionen, Profilern oder Betriebssystemen kompatibel sind. strip_dirs() entfernt Pfade unwiderruflich aus dem Objekt und kann nicht unterscheidbare Einträge zusammenführen.
Beispiele
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)Ergebnis
45 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.