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

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.

Sources