> **Источник:** https://python-all.ru/3.5/library/timeit.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # 27.5. [`timeit`](https://python-all.ru/3.5/library/timeit.html#module-timeit) – измерение времени выполнения небольших фрагментов кода **Исходный код:** [Lib/timeit.py](https://python-all.ru/src/3.5/Lib/timeit.py) --- Этот модуль предоставляет простой способ измерения времени выполнения небольших фрагментов кода Python. Он имеет как [интерфейс командной строки](https://python-all.ru/3.5/library/timeit.html#timeit-command-line-interface), так и [вызываемый объект](https://python-all.ru/3.5/library/timeit.html#python-interface). Модуль избегает множества распространённых ловушек при измерении времени выполнения. См. также введение Тима Питерса к главе «Алгоритмы» в *Python Cookbook*, опубликованной O’Reilly. ## 27.5.1. Основные примеры Следующий пример показывает, как можно использовать [интерфейс командной строки](https://python-all.ru/3.5/library/timeit.html#timeit-command-line-interface) для сравнения трёх различных выражений: ```sh $ python3 -m timeit '"-".join(str(n) for n in range(100))' 10000 loops, best of 3: 30.2 usec per loop $ python3 -m timeit '"-".join([str(n) for n in range(100)])' 10000 loops, best of 3: 27.5 usec per loop $ python3 -m timeit '"-".join(map(str, range(100)))' 10000 loops, best of 3: 23.2 usec per loop ``` Этого можно добиться из [интерфейса Python](https://python-all.ru/3.5/library/timeit.html#python-interface) с помощью: ```python >>> import timeit >>> timeit.timeit('"-".join(str(n) for n in range(100))', number=10000) 0.3018611848820001 >>> timeit.timeit('"-".join([str(n) for n in range(100)])', number=10000) 0.2727368790656328 >>> timeit.timeit('"-".join(map(str, range(100)))', number=10000) 0.23702679807320237 ``` Однако обратите внимание, что [`timeit`](https://python-all.ru/3.5/library/timeit.html#module-timeit) будет автоматически определять количество повторений только при использовании интерфейса командной строки. В разделе [Примеры](https://python-all.ru/3.5/library/timeit.html#timeit-examples) вы можете найти более сложные примеры. ## 27.5.2. Интерфейс Python Модуль определяет три вспомогательные функции и один открытый класс: #### `timeit.timeit(stmt='pass', setup='pass', timer=, number=1000000, globals=None)` Создаёт экземпляр [`Timer`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer) с заданными оператором, кодом *setup* и функцией *timer* и запускает его метод [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit) с *number* выполнениями. Необязательный аргумент *globals* задаёт пространство имён, в котором будет выполняться код. Изменено в версии 3.5: Был добавлен необязательный параметр *globals*. #### `timeit.repeat(stmt='pass', setup='pass', timer=, repeat=3, number=1000000, globals=None)` Создаёт экземпляр [`Timer`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer) с заданными оператором, кодом *setup* и функцией *timer* и запускает его метод [`repeat()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.repeat) с заданным количеством *repeat* и *number* выполнениями. Необязательный аргумент *globals* задаёт пространство имён, в котором будет выполняться код. Изменено в версии 3.5: Был добавлен необязательный параметр *globals*. #### `timeit.default_timer()` Таймер по умолчанию – [`time.perf_counter()`](https://python-all.ru/3.5/library/time.html#time.perf_counter). Изменено в версии 3.3: [`time.perf_counter()`](https://python-all.ru/3.5/library/time.html#time.perf_counter) теперь является таймером по умолчанию. #### `class timeit.Timer(stmt='pass', setup='pass', timer=, globals=None)` Класс для измерения скорости выполнения небольших фрагментов кода. Конструктор принимает измеряемый оператор, дополнительный оператор для настройки и функцию таймера. Оба оператора по умолчанию равны `'pass'`; функция таймера зависит от платформы (см. строку документации модуля). *stmt* и *setup* также могут содержать несколько операторов, разделённых `;` или переводами строк, при условии, что они не содержат многострочных строковых литералов. По умолчанию оператор выполняется в пространстве имён timeit; это поведение можно контролировать, передав пространство имён в *globals*. Чтобы измерить время выполнения первого оператора, используйте метод [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit). Метод [`repeat()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.repeat) – это удобный способ вызвать [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit) несколько раз и вернуть список результатов. Время выполнения *setup* исключается из общего времени выполнения. Параметры *stmt* и *setup* также могут принимать вызываемые объекты без аргументов. При этом вызовы к ним встраиваются в функцию таймера, которая затем выполняется [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit). Обратите внимание, что в этом случае накладные расходы на измерение немного больше из-за дополнительных вызовов функций. Изменено в версии 3.5: Был добавлен необязательный параметр *globals*. #### `timeit(number=1000000)` Измеряет время выполнения основного оператора *number* раз. Сначала выполняется оператор setup один раз, затем возвращается время, затраченное на выполнение основного оператора указанное количество раз, измеряемое в секундах в виде числа с плавающей запятой. Аргумент number – количество повторений цикла, по умолчанию миллион. Основной оператор, оператор setup и используемая функция таймера передаются конструктору. > **Примечание** > > По умолчанию [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit) временно отключает [сборку мусора](https://python-all.ru/3.5/glossary.html#term-garbage-collection) во время замера. Преимущество такого подхода в том, что независимые замеры становятся более сопоставимыми. Недостаток в том, что сборка мусора может быть важной составляющей производительности измеряемой функции. Если это так, сборку мусора можно снова включить, указав её первой инструкцией в строке *setup*. Например: > > ```python > timeit.Timer('for i in range(10): oct(i)', 'gc.enable()').timeit() > ``` #### `repeat(repeat=3, number=1000000)` Вызов [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit) несколько раз. Это удобная функция, которая многократно вызывает [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit), возвращая список результатов. Первый аргумент указывает, сколько раз вызывать [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit). Второй аргумент задаёт аргумент *number* для [`timeit()`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer.timeit). > **Примечание** > > Может возникнуть соблазн вычислить среднее и стандартное отклонение из результирующего вектора и сообщить о них. Однако это не очень полезно. В типичном случае наименьшее значение даёт нижнюю границу того, насколько быстро ваша машина может выполнить данный фрагмент кода; более высокие значения в результирующем векторе обычно вызваны не изменчивостью скорости Python, а другими процессами, влияющими на точность измерения времени. Поэтому [`min()`](https://python-all.ru/3.5/library/functions.html#min) результата – вероятно, единственное число, которое должно интересовать. После этого следует посмотреть на весь вектор и применить здравый смысл, а не статистику. #### `print_exc(file=None)` Вспомогательная функция для вывода трассировки из кода, время выполнения которого измеряется. Типичное использование: ```python t = Timer(...) # за пределами try/except try: t.timeit(...) # или t.repeat(...) except Exception: t.print_exc() ``` Преимущество перед стандартной трассировкой в том, что будут отображаться строки исходного кода в скомпилированном шаблоне. Необязательный аргумент *file* указывает, куда направляется трассировка; по умолчанию используется [`sys.stderr`](https://python-all.ru/3.5/library/sys.html#sys.stderr). ## 27.5.3. Интерфейс командной строки При вызове как программы из командной строки используется следующая форма: ```python python -m timeit [-n N] [-r N] [-u U] [-s S] [-t] [-c] [-h] [statement ...] ``` Где поддерживаются следующие параметры: #### `-n N, --number=N` сколько раз выполнять 'statement' #### `-r N, --repeat=N` сколько раз повторять таймер (по умолчанию 3) #### `-s S, --setup=S` инструкция, выполняемая один раз в начале (по умолчанию `pass`) #### `-p, --process` измерять процессорное время, а не настенное время, используя [`time.process_time()`](https://python-all.ru/3.5/library/time.html#time.process_time) вместо [`time.perf_counter()`](https://python-all.ru/3.5/library/time.html#time.perf_counter), которое используется по умолчанию Новое в версии 3.3. #### `-t, --time` использовать [`time.time()`](https://python-all.ru/3.5/library/time.html#time.time) (устарело) #### `-u, --unit=U` > указать единицу времени для вывода таймера; можно выбрать usec, msec или sec Новое в версии 3.5. #### `-c, --clock` использовать [`time.clock()`](https://python-all.ru/3.5/library/time.html#time.clock) (устарело) #### `-v, --verbose` выводить необработанные результаты замера; для большей точности (больше знаков) повторите параметр #### `-h, --help` вывести краткое сообщение об использовании и выйти Многострочная инструкция может быть задана указанием каждой строки как отдельного аргумента statement; строки с отступами возможны путём заключения аргумента в кавычки и использования начальных пробелов. Несколько параметров [`-s`](https://python-all.ru/3.5/library/timeit.html#cmdoption-timeit-s) обрабатываются аналогично. Если [`-n`](https://python-all.ru/3.5/library/timeit.html#cmdoption-timeit-n) не указано, подходящее количество циклов вычисляется путём перебора последовательных степеней 10, пока общее время не достигнет хотя бы 0,2 секунды. На результаты измерений [`default_timer()`](https://python-all.ru/3.5/library/timeit.html#timeit.default_timer) могут влиять другие программы, работающие на том же компьютере, поэтому при необходимости точных замеров лучше всего повторить замер несколько раз и использовать наилучшее время. Опция [`-r`](https://python-all.ru/3.5/library/timeit.html#cmdoption-timeit-r) хорошо подходит для этого; по умолчанию 3 повторений, вероятно, достаточно в большинстве случаев. Для измерения времени ЦП можно использовать [`time.process_time()`](https://python-all.ru/3.5/library/time.html#time.process_time). > **Примечание** > > Существует некоторая базовая накладная нагрузка, связанная с выполнением инструкции pass. Приведённый здесь код не пытается её скрыть, но о ней следует знать. Базовую накладную нагрузку можно измерить, вызвав программу без аргументов, и она может отличаться в разных версиях Python. ## 27.5.4. Примеры Можно указать инструкцию настройки, которая выполняется только один раз в начале: ```sh $ python -m timeit -s 'text = "sample string"; char = "g"' 'char in text' 10000000 loops, best of 3: 0.0877 usec per loop $ python -m timeit -s 'text = "sample string"; char = "g"' 'text.find(char)' 1000000 loops, best of 3: 0.342 usec per loop ``` ```python >>> import timeit >>> timeit.timeit('char in text', setup='text = "sample string"; char = "g"') 0.41440500499993504 >>> timeit.timeit('text.find(char)', setup='text = "sample string"; char = "g"') 1.7246671520006203 ``` То же самое можно сделать с помощью класса [`Timer`](https://python-all.ru/3.5/library/timeit.html#timeit.Timer) и его методов: ```python >>> import timeit >>> t = timeit.Timer('char in text', setup='text = "sample string"; char = "g"') >>> t.timeit() 0.3955516149999312 >>> t.repeat() [0.40193588800002544, 0.3960157959998014, 0.39594301399984033] ``` Следующие примеры показывают, как замерять время выполнения выражений, состоящих из нескольких строк. Здесь мы сравниваем затраты на использование [`hasattr()`](https://python-all.ru/3.5/library/functions.html#hasattr) против [`try`](https://python-all.ru/3.5/reference/compound_stmts.html#try)/[`except`](https://python-all.ru/3.5/reference/compound_stmts.html#except) для проверки отсутствующих и существующих атрибутов объектов: ```sh $ python -m timeit 'try:' ' str.__bool__' 'except AttributeError:' ' pass' 100000 loops, best of 3: 15.7 usec per loop $ python -m timeit 'if hasattr(str, "__bool__"): pass' 100000 loops, best of 3: 4.26 usec per loop $ python -m timeit 'try:' ' int.__bool__' 'except AttributeError:' ' pass' 1000000 loops, best of 3: 1.43 usec per loop $ python -m timeit 'if hasattr(int, "__bool__"): pass' 100000 loops, best of 3: 2.23 usec per loop ``` ```python >>> import timeit >>> # атрибут отсутствует >>> s = """\ ... try: ... str.__bool__ ... except AttributeError: ... pass ... """ >>> timeit.timeit(stmt=s, number=100000) 0.9138244460009446 >>> s = "if hasattr(str, '__bool__'): pass" >>> timeit.timeit(stmt=s, number=100000) 0.5829014980008651 >>> >>> # атрибут присутствует >>> s = """\ ... try: ... int.__bool__ ... except AttributeError: ... pass ... """ >>> timeit.timeit(stmt=s, number=100000) 0.04215312199994514 >>> s = "if hasattr(int, '__bool__'): pass" >>> timeit.timeit(stmt=s, number=100000) 0.08588060699912603 ``` Чтобы предоставить модулю [`timeit`](https://python-all.ru/3.5/library/timeit.html#module-timeit) доступ к определяемым вами функциям, можно передать параметр *setup*, содержащий инструкцию import: ```python def test(): """Глупая тестовая функция""" L = [i for i in range(100)] if __name__ == '__main__': import timeit print(timeit.timeit("test()", setup="from __main__ import test")) ``` Другой вариант – передать [`globals()`](https://python-all.ru/3.5/library/functions.html#globals) параметру *globals*, что приведёт к выполнению кода в текущем глобальном пространстве имён. Это может быть удобнее, чем указывать импорты по отдельности: ```python def f(x): return x**2 def g(x): return x**4 def h(x): return x**8 import timeit print(timeit.timeit('[func(42) for func in (f,g,h)]', globals=globals())) ```