CKTIS / Python
pstats.Stats.stats — statistiques brutes de profilage
pstats.Stats.stats est un dictionnaire de données de profilage dont les clés combinent le nom du fichier, le numéro de ligne et le nom de la fonction. Il permet de consulter directement les nombres d’appels, le temps interne, le temps cumulé et les informations sur les fonctions appelantes, sans analyser un rapport textuel.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
stats = pstats.Stats(profiler)
cc, nc, tt, ct, callers = stats.stats[(filename, line_number, function_name)]pstats.Stats.stats est un attribut d’instance, pas une méthode. Chaque clé a la forme (filename, line_number, function_name) et chaque valeur la forme (cc, nc, tt, ct, callers). Même la clé complète n’identifie pas une fonction de manière unique : deux fonctions lambda distinctes définies sur la même ligne de code source ont le même nom de fichier, le même numéro de ligne et le même nom de fonction (<lambda>), et partagent donc la même clé.
cc compte les appels primitifs, sans les appels induits par la récursion ; nc compte tous les appels. tt est le temps interne de la fonction, hors sous-appels, tandis que ct est le temps cumulé, sous-appels compris, en secondes. Ne faites pas la somme des ct de toutes les fonctions pour obtenir le temps total du programme : ces intervalles se chevauchent.
callers associe aux clés des fonctions appelantes des données qui dépendent du profileur. Avec cProfile, chaque valeur est (nc, cc, tt, ct) pour la relation d’appel concernée — l’ordre des compteurs est inversé par rapport au tuple externe. Avec profile, chaque valeur est un nombre d’appels. La récursion peut faire d’une fonction son propre appelant.
Considérez ce dictionnaire comme une représentation d’implémentation de bas niveau de CPython 3.14, et non comme une garantie de format portable. Évitez toute modification manuelle : l’objet maintient aussi des totaux et des caches. strip_dirs() modifie les clés et peut fusionner des entrées ; sort_stats() définit l’ordre du rapport, pas celui du dictionnaire. L’exemple montre des compteurs déterministes plutôt que des durées variables. Cette entrée s’appuie sur le code du dépôt ; l’environnement de production n’est pas attesté.
Exemples
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}")Résultat
primitive=1, total=4 recursive_caller=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.