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

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.

Sources