Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

pstats.Stats — analyser les résultats du profilage

pstats.Stats analyse les données du profileur en triant les statistiques des fonctions et en produisant des rapports. Il ne mesure pas lui-même l’exécution : il accepte un profil enregistré ou un objet profileur.

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

Syntaxe

pstats.Stats(*filenames, stream=sys.stdout)
pstats.Stats(profile, stream=sys.stdout)

pstats.Stats accepte des noms de fichiers de profil ou un objet cProfile.Profile ou profile.Profile. Le paramètre stream définit la destination du rapport ; sa valeur par défaut est sys.stdout.

sort_stats(pstats.SortKey.CUMULATIVE) trie par ordre décroissant selon le temps incluant les fonctions appelées. pstats.SortKey.TIME ne prend en compte que le temps passé dans la fonction elle-même. print_stats(10) affiche les dix premières entrées.

strip_dirs() supprime définitivement les chemins de répertoire et peut fusionner les entrées impossibles à distinguer ; effectuez le tri après cette opération. La compatibilité des fichiers de profil entre les versions de Python, les profileurs et les systèmes d’exploitation n’est pas garantie.

Exemples

import cProfile
import io
import pstats


def work():
    return sum(range(10))


profiler = cProfile.Profile()
result = profiler.runcall(work)
report = io.StringIO()
stats = pstats.Stats(profiler, stream=report)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats()

print(result)
print("work" in report.getvalue())

Résultat

45
True

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources