WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

pstats.Stats.stats — rohe Profiling-Statistiken

pstats.Stats.stats ist ein Wörterbuch mit Profiling-Daten, dessen Schlüssel aus Dateiname, Zeilennummer und Funktionsname bestehen. Es ermöglicht, Aufrufzahlen, Eigenzeit, kumulative Zeit und Informationen zu aufrufenden Funktionen direkt auszulesen, statt einen Textbericht zu analysieren.

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

Syntax

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

pstats.Stats.stats ist ein Instanzattribut, keine Methode. Jeder Schlüssel hat die Form (filename, line_number, function_name), jeder Wert die Form (cc, nc, tt, ct, callers). Auch der vollständige Schlüssel identifiziert eine Funktion nicht eindeutig: Zwei verschiedene lambda-Funktionen, die in derselben Quellcodezeile definiert sind, haben denselben Dateinamen, dieselbe Zeilennummer und denselben Funktionsnamen (<lambda>) und damit denselben Schlüssel.

cc zählt primitive Aufrufe, also ohne durch Rekursion ausgelöste Aufrufe; nc zählt alle Aufrufe. tt ist die Eigenzeit der Funktion ohne Unteraufrufe, während ct die kumulative Zeit einschließlich Unteraufrufen in Sekunden angibt. Addiere nicht die ct-Werte aller Funktionen, um die Gesamtzeit des Programms zu erhalten: Diese Zeitintervalle überschneiden sich.

callers ordnet Schlüsseln aufrufender Funktionen profilerabhängige Daten zu. Bei cProfile lautet jeder Wert für die jeweilige Aufrufbeziehung (nc, cc, tt, ct) — die Reihenfolge der Zähler ist gegenüber dem äußeren Tupel umgekehrt. Bei profile ist jeder Wert eine Aufrufzahl. Durch Rekursion kann eine Funktion ihr eigener Aufrufer sein.

Betrachte dieses Wörterbuch als niedrigstufige Implementierungsdarstellung von CPython 3.14, nicht als Garantie für ein portables Format. Vermeide manuelle Änderungen: Das Objekt verwaltet auch Summen und Caches. strip_dirs() ändert Schlüssel und kann Einträge zusammenführen; sort_stats() legt die Reihenfolge des Berichts fest, nicht die Wörterbuchreihenfolge. Das Beispiel zeigt deterministische Zähler statt variabler Zeiten. Dieser Eintrag basiert auf Repository-Code; die Produktionslaufzeit wurde nicht bestätigt.

Beispiele

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

Ergebnis

primitive=1, total=4
recursive_caller=True

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