KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

pstats — profileresultaten analyseren

De module pstats analyseert gegevens uit cProfile of profile: de module sorteert functiestatistieken en maakt rapporten waarmee je de kostbare onderdelen van een programma kunt vinden.

Versie: 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 analyseert profileresultaten en meet niet zelf de uitvoering van het programma. pstats.Stats accepteert een profilerobject of de naam van een bestand met de gegevens ervan.

pstats.Stats leest opgeslagen profilergegevens met marshal, dat niet veilig is voor invoer die niet wordt vertrouwd of waarvan de authenticiteit niet is vastgesteld. Laad geen profilerbestanden uit onbetrouwbare bronnen en ook geen bestanden waarvan de echtheid niet is gecontroleerd.

sort_stats(pstats.SortKey.TIME) sorteert op de eigen tijd van een functie, exclusief aangeroepen functies; pstats.SortKey.CUMULATIVE telt hun tijd mee. print_stats(10) drukt de eerste tien items af.

get_stats_profile() biedt programmatische toegang. Het voorbeeld leest het aantal aanroepen van work uit en vermijdt variabele tijdmetingen.

Ga er niet van uit dat profilerbestanden compatibel zijn tussen Python-versies, profilers of besturingssystemen. strip_dirs() verwijdert paden onomkeerbaar uit het object en kan niet te onderscheiden items samenvoegen.

Voorbeelden

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)

Resultaat

45
1

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.

Bronnen