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

CKTIS / Python

pstats — analyser les résultats du profilage

Le module pstats analyse les données de cProfile ou de profile : il trie les statistiques des fonctions et produit des rapports qui aident à repérer les parties coûteuses d’un programme.

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

Syntaxe

import pstats
stats = pstats.Stats(profile_or_filename)
stats.sort_stats(pstats.SortKey.CUMULATIVE).print_stats(10)

pstats analyse les résultats du profilage au lieu de mesurer lui-même l’exécution du programme. pstats.Stats accepte un objet profileur ou le nom d’un fichier contenant ses données.

pstats.Stats lit les données de profilage enregistrées à l’aide de marshal, dont l’utilisation n’est pas sûre avec des données non fiables ou non authentifiées. Ne chargez pas de fichiers de profilage provenant de sources non fiables ni de fichiers dont l’authenticité n’a pas été vérifiée.

sort_stats(pstats.SortKey.TIME) trie selon le temps propre d’une fonction, sans inclure les fonctions appelées ; pstats.SortKey.CUMULATIVE inclut leur temps. print_stats(10) affiche les dix premières entrées.

get_stats_profile() permet un accès programmatique. L’exemple lit le nombre d’appels de work, sans recourir à des mesures de durée variables.

Ne supposez pas que les fichiers de profilage sont compatibles entre les versions de Python, les profileurs ou les systèmes d’exploitation. strip_dirs() supprime irréversiblement les chemins de l’objet et peut fusionner des entrées impossibles à distinguer.

Exemples

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)

Résultat

45
1

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