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

CKTIS / Python

timeit.Timer

Timer conserve l’instruction et sa préparation sous forme de textes ou de fonctions sans argument.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

timeit.Timer(stmt='pass', setup='pass', timer=timeit.default_timer, globals=None)

Timer conserve l’instruction et sa préparation sous forme de textes ou de fonctions sans argument.

autorange(callback) appelle callback(number, time_taken) après chaque essai, dernier compris. Le résultat est la dernière paire (number, time_taken), par exemple (2, 0.3) après (1, 0.1) et (2, 0.3). Le dictionnaire globals fournit les noms utilisés dans les textes. Dans l’exemple timeit(2) exécute setup une fois hors mesure et run deux fois. Même timeit(0) exécute setup.

autorange essaie 1, 2, 5, 10 itérations et ainsi de suite jusqu’à une durée d’au moins 0,2 seconde pour un essai.

import timeit
events=[]
timer=timeit.Timer("events.append('run')","events.append('setup')",globals={'events':events})
timer.timeit(0)
assert events==['setup']
timer.repeat(repeat=2,number=1)
assert events==['setup','setup','run','setup','run']
ticks=iter([0.,0.1,0.,0.3])
runs=[]
assert timeit.Timer(lambda:runs.append(1), timer=lambda:next(ticks)).autorange()==(2,0.3)
assert len(runs)==3
ticks=iter([0.,0.1,0.,0.3])
samples=[]
pair=timeit.Timer('pass',timer=lambda:next(ticks)).autorange(lambda n,t:samples.append((n,t)))
assert samples==[(1,0.1),(2,0.3)] and pair==samples[-1]

Exemples

import timeit
events = []
timer = timeit.Timer(lambda: events.append("run"), setup=lambda: events.append("setup"))
timer.timeit(number=2)
print(events)

Résultat

['setup', 'run', 'run']

autorange essaie 1, 2, 5, 10 itérations et ainsi de suite jusqu’à une durée d’au moins 0,2 seconde pour un essai.

Sources