WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen