CKTIS / Python
timeit.timeit
timeit mesure la durée totale de number exécutions d’une instruction ou d’une fonction sans argument.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
timeit.timeit(stmt='pass', setup='pass', timer=timeit.default_timer, number=1000000, globals=None)timeit mesure la durée totale de number exécutions d’une instruction ou d’une fonction sans argument.
Dans l’API, number vaut 1_000_000 par défaut, alors que python -m timeit sans -n choisit automatiquement le nombre de répétitions. setup peut réactiver le ramasse-miettes par gc.enable(). Si la mesure l’a désactivé alors qu’il était actif, elle le réactive même si l’instruction lève une exception. L’horloge par défaut perf_counter donne des secondes. Pour number positif, diviser par number donne la moyenne par exécution. setup est exclu de la mesure. La collecte des cycles est temporairement désactivée par défaut.
L’exemple ajoute quatre éléments et vérifie que la durée est positive ou nulle.
import timeit,gc
ticks=iter([1.,3.])
steps=[]
elapsed=timeit.timeit(lambda: steps.append(gc.isenabled()), lambda: steps.append('setup'), timer=lambda:next(ticks),number=3)
assert elapsed==2. and steps==['setup',False,False,False]
old=gc.isenabled()
try:
gc.enable()
def fail():
assert not gc.isenabled()
raise ValueError('timed')
try: timeit.timeit(fail,number=1)
except ValueError: pass
else: raise AssertionError
assert gc.isenabled()
seen=[]
timeit.timeit(lambda:seen.append(gc.isenabled()), setup=gc.enable,number=1)
assert seen==[True]
finally:
if not old: gc.disable()
Exemples
import timeit
calls = []
elapsed = timeit.timeit(lambda: calls.append(1), number=4)
print(len(calls), elapsed >= 0)
Résultat
4 True
L’exemple ajoute quatre éléments et vérifie que la durée est positive ou nulle.