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

CKTIS / Python

Arrêter le profilage avec `cProfile.Profile.disable()`

Appelez `disable()` sur la même instance de `cProfile.Profile` pour arrêter la collecte avant l’analyse sans perdre les statistiques déjà recueillies.

Version : Python 3.12

Syntaxe

profiler.disable()

En Python 3.12, cProfile.Profile.disable est une méthode d’instance qui s’appelle sans argument : profiler.disable(). Elle arrête la collecte de données de ce profileur sans effacer les données recueillies ni afficher de rapport. Les méthodes enable() et disable() sont disponibles dans cProfile, pas dans le module profile.

Préparez les données d’entrée avant d’activer le profileur. Appelez profiler.enable() juste avant run_profiled(), puis placez profiler.disable() dans un bloc finally. Ainsi, la collecte s’arrête même si run_profiled() lève une exception. Le bloc finally n’intercepte pas cette exception.

Une fois la collecte arrêtée, passez la même instance à pstats.Stats(profiler). L’analyse elle-même reste ainsi en dehors de l’intervalle mesuré, tandis que les données issues de l’appel à run_profiled() restent disponibles.

Exemples

import cProfile
import pstats


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


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


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

La sortie indique quels noms de fonctions figurent dans les statistiques, pas la durée des appels. Le profilage est actif pendant l’appel à `run_profiled()` ; les deux appels à `outside_scope()` se déroulent en dehors de cet intervalle.

Leçons associées

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

Sources