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

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.

Sources