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

CKTIS / Python

Délimiter le profilage avec cProfile.Profile.enable()

Démarrez la collecte juste avant `run_profiled()`, arrêtez-la dans `finally`, puis examinez les résultats pour exclure la préparation et l’analyse du profil.

Version : Python 3.12

Syntaxe

import cProfile

profiler = cProfile.Profile()
profiler.enable()
try:
    run_profiled()
finally:
    profiler.disable()

Dans Python 3.12, cProfile.Profile.enable est une méthode d’instance. La création d’un objet avec cProfile.Profile() ne lance pas la collecte : c’est l’appel à profiler.enable() qui la démarre. profiler.disable() l’arrête sans effacer les données déjà collectées. Ces deux méthodes ne sont pas disponibles sur profile.Profile du module profile.

Appelez enable() juste avant run_profiled() et placez disable() dans le bloc finally. La collecte s’arrête même si l’appel profilé lève une exception ; finally n’intercepte pas lui-même cette exception. Terminez la préparation avant d’activer le profileur et lisez les résultats avec pstats.Stats(profiler) après l’avoir désactivé.

Le profil présente le nombre d’appels et les durées d’exécution. Le profilage ajoute un surcoût : n’utilisez pas ces durées comme résultats d’un test de performance.

Exemples

import cProfile
import pstats


def outside_scope():
    return 0


def run_profiled():
    return sum(range(10))


profiler = cProfile.Profile()
outside_scope()
profiler.enable()
try:
    run_profiled()
finally:
    profiler.disable()
outside_scope()

functions = pstats.Stats(profiler).get_stats_profile().func_profiles
print('run_profiled:', 'run_profiled' in functions)
print('outside_scope:', 'outside_scope' in functions)

Résultat

run_profiled: True
outside_scope: False

Le résultat attendu est `True` pour `run_profiled` et `False` pour `outside_scope`. L’exemple appelle `outside_scope()` avant l’activation du profileur et après sa désactivation. Il vérifie la présence des noms de fonction sans comparer les durées.

Leçons associées

  • Python · Leçon 15 · Avancé · Version : 5

Sources