CKTIS / Python
cProfile.run
run profile les instructions dans l’espace de noms du module principal.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
cProfile.run(statement, filename=None, sort=-1)run profile les instructions dans l’espace de noms du module principal.
Dans CPython 3.14.9, run intercepte SystemExit de l’instruction et renvoie None. ValueError atteint l’appelant. Avec filename, pstats.Stats peut lire les données enregistrées dans les deux cas. Son dictionnaire sert à la fois de contexte global et local. Sans filename, la fonction affiche un rapport ordonné selon sort. Un chemin fourni enregistre les statistiques pour pstats.Stats. La fonction renvoie None.
L’exemple lit un seul appel à square dans le fichier temporaire.
import cProfile, pstats, tempfile, os, __main__
def probe(): return 5
__main__.__dict__['profile_probe']=probe
try:
with tempfile.TemporaryDirectory() as directory:
target=os.path.join(directory,'p.prof')
assert cProfile.run("profile_probe()", target) is None
assert [v[1] for k,v in pstats.Stats(target).stats.items() if k[2]=='probe']==[1]
finally: del __main__.__dict__['profile_probe']
with tempfile.TemporaryDirectory() as directory:
for exc in ('SystemExit','ValueError'):
path=os.path.join(directory,exc+'.prof')
try: result=cProfile.run("raise "+exc+"()",path)
except ValueError: assert exc=='ValueError'
else: assert exc=='SystemExit' and result is None
assert pstats.Stats(path).total_calls>0
Exemples
import cProfile
import pstats
from pathlib import Path
from tempfile import TemporaryDirectory
def square(n): return n * n
with TemporaryDirectory() as d:
p = str(Path(d) / "sample.prof")
cProfile.run("square(4)", p)
print(sum(stat[1] for key, stat in pstats.Stats(p).stats.items() if key[2] == "square"))
Résultat
1
L’exemple lit un seul appel à square dans le fichier temporaire.