CKTIS / Python
cProfile.Profile
Un objet Profile collecte des statistiques d’appels et runcall renvoie le résultat normal de la fonction.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
cProfile.Profile()
profiler.runcall(func, /, *args, **kwargs)Un objet Profile collecte des statistiques d’appels et runcall renvoie le résultat normal de la fonction.
create_stats() arrête la mesure et enregistre les statistiques en mémoire. print_stats() affiche un rapport textuel, tandis que dump_stats(path) écrit les données pour une lecture ultérieure par pstats.Stats. square(4) donne 16 et le profil compte un appel à square. En cas de récursion, pstats.Stats distingue le nombre total d’appels des appels primitifs qui ne résultent pas de la récursion. enable() et disable() ou un bloc with délimitent la collecte.
Les durées varient avec la charge.
import cProfile,pstats
def visit(n):
return visit(n-1)+1 if n else 1
p=cProfile.Profile()
assert p.runcall(visit,2)==3
stats=pstats.Stats(p).stats
counts=[v[:2] for k,v in stats.items() if k[2]=='visit']
assert counts==[(1,3)]
import contextlib,io,tempfile,os
p.enable()
visit(1)
p.create_stats()
visit(4)
assert [v[1] for k,v in p.stats.items() if k[2]=='visit']==[5]
with contextlib.redirect_stdout(io.StringIO()) as out: p.print_stats()
assert 'visit' in out.getvalue()
with tempfile.TemporaryDirectory() as d:
path=os.path.join(d,'prof')
p.dump_stats(path)
assert [v[1] for k,v in pstats.Stats(path).stats.items() if k[2]=='visit']==[5]
cProfile.Profile.enable · cProfile.Profile.disable
enable() démarre la collecte des événements du profil et disable() l’arrête. Un bloc finally termine la mesure même après une exception. Parmi trois appels à work, seul celui du milieu est mesuré.
import cProfile
def work(): return 5
p=cProfile.Profile()
work()
p.enable()
try: work()
finally: p.disable()
work()
counts=[r.callcount for r in p.getstats() if r.code is work.__code__]
assert counts==[1]
Exemples
import cProfile
def square(n): return n * n
p = cProfile.Profile()
print(p.runcall(square, 4))
print([e.callcount for e in p.getstats() if getattr(e.code, "co_name", None) == "square"])
Résultat
16 [1]
Les durées varient avec la charge.