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.