CKTIS / Python
timeit.timeit
timeit mede a duração total de number execuções de uma instrução ou de uma função sem argumentos.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
timeit.timeit(stmt='pass', setup='pass', timer=timeit.default_timer, number=1000000, globals=None)timeit mede a duração total de number execuções de uma instrução ou de uma função sem argumentos.
Na API, number vale 1_000_000 por omissão, enquanto python -m timeit sem -n escolhe automaticamente o número de repetições. setup pode ativar o GC com gc.enable(). Se a medição desativou o GC anteriormente ativo, volta a ativá-lo mesmo que a instrução lance uma exceção. O relógio predefinido perf_counter dá segundos. Para number positivo, dividir por number dá a média por execução. setup fica fora da medição. Por omissão, a recolha de ciclos é temporariamente desativada.
O exemplo acrescenta quatro elementos e verifica que o tempo é não negativo.
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()
Exemplos
import timeit
calls = []
elapsed = timeit.timeit(lambda: calls.append(1), number=4)
print(len(calls), elapsed >= 0)
Resultado
4 True
O exemplo acrescenta quatro elementos e verifica que o tempo é não negativo.