CKTIS / Python
pstats.Stats.stats — ruwe profileringsstatistieken
pstats.Stats.stats is een woordenboek met profileringsgegevens waarvan de sleutels bestaan uit een bestandsnaam, een regelnummer en een functienaam. Je kunt er rechtstreeks oproepaantallen, interne tijd, cumulatieve tijd en informatie over aanroepende functies mee uitlezen, zonder een tekstrapport te analyseren.
Versie: 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 is een instantieattribuut, geen methode. Elke sleutel heeft de vorm (filename, line_number, function_name) en elke waarde de vorm (cc, nc, tt, ct, callers). Ook de volledige sleutel identificeert een functie niet uniek: twee verschillende lambda-functies die op dezelfde broncoderegel zijn gedefinieerd, hebben dezelfde bestandsnaam, hetzelfde regelnummer en dezelfde functienaam (<lambda>) en delen dus dezelfde sleutel.
cc telt primitieve aanroepen, zonder aanroepen die door recursie zijn veroorzaakt; nc telt alle aanroepen. tt is de interne tijd van de functie, zonder subaanroepen, terwijl ct de cumulatieve tijd inclusief subaanroepen in seconden is. Tel niet de ct-waarden van alle functies op om de totale programmatijd te bepalen: deze intervallen overlappen elkaar.
callers koppelt profilerafhankelijke gegevens aan sleutels van aanroepende functies. Bij cProfile is elke waarde (nc, cc, tt, ct) voor de betreffende aanroeprelatie — de volgorde van de tellers is omgekeerd ten opzichte van de buitenste tuple. Bij profile is elke waarde een oproepaantal. Door recursie kan een functie zichzelf aanroepen.
Beschouw dit woordenboek als een implementatieweergave op laag niveau van CPython 3.14, niet als garantie voor een draagbaar formaat. Pas het niet handmatig aan: het object houdt ook totalen en caches bij. strip_dirs() wijzigt sleutels en kan vermeldingen samenvoegen; sort_stats() bepaalt de volgorde van het rapport, niet die van het woordenboek. Het voorbeeld toont deterministische aantallen in plaats van variabele tijden. Dit item is gebaseerd op repositorycode; de productieomgeving is niet bevestigd.
Voorbeelden
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}")Resultaat
primitive=1, total=4 recursive_caller=True
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.