sched.md

1> **Источник:** https://python-all.ru/2.7/library/sched.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 8.8. [`sched`](https://python-all.ru/2.7/library/sched.html#module-sched) – Планировщик событий89**Исходный код:** [Lib/sched.py](https://python-all.ru/src/2.7/Lib/sched.py)1011---1213Модуль [`sched`](https://python-all.ru/2.7/library/sched.html#module-sched) определяет класс, который реализует планировщик событий общего назначения:1415#### `class sched.scheduler(timefunc, delayfunc)`1617Класс [`scheduler`](https://python-all.ru/2.7/library/sched.html#sched.scheduler) определяет общий интерфейс для планирования событий. Ему нужны две функции для взаимодействия с «внешним миром»: *timefunc* должна быть вызываемой без аргументов и возвращать число («время» в любых единицах). Функция *delayfunc* должна быть вызываемой с одним аргументом, совместимым с выходными данными *timefunc*, и должна задерживать выполнение на это количество единиц времени. *delayfunc* также будет вызвана с аргументом `0` после выполнения каждого события, чтобы предоставить другим потокам возможность выполниться в многопоточных приложениях.1819Пример:2021```python22>>> import sched, time23>>> s = sched.scheduler(time.time, time.sleep)24>>> def print_time(): print "From print_time", time.time()25...26>>> def print_some_times():27...     print time.time()28...     s.enter(5, 1, print_time, ())29...     s.enter(10, 1, print_time, ())30...     s.run()31...     print time.time()32...33>>> print_some_times()34930343690.25735From print_time 930343695.27436From print_time 930343700.27337930343700.27638```3940В многопоточных средах класс [`scheduler`](https://python-all.ru/2.7/library/sched.html#sched.scheduler) имеет ограничения в отношении безопасности потоков: невозможно вставить новую задачу перед текущей ожидающей задачей в работающем планировщике, и основной поток блокируется до опустошения очереди событий. Вместо этого рекомендуется использовать класс [`threading.Timer`](https://python-all.ru/2.7/library/threading.html#threading.Timer).4142Пример:4344```python45>>> import time46>>> from threading import Timer47>>> def print_time():48...     print "From print_time", time.time()49...50>>> def print_some_times():51...     print time.time()52...     Timer(5, print_time, ()).start()53...     Timer(10, print_time, ()).start()54...     time.sleep(11)  # ожидание, пока выполняются события с задержкой по времени55...     print time.time()56...57>>> print_some_times()58930343690.25759From print_time 930343695.27460From print_time 930343700.27361930343701.30162```6364## 8.8.1. Объекты планировщика6566Экземпляры [`scheduler`](https://python-all.ru/2.7/library/sched.html#sched.scheduler) имеют следующие методы и атрибуты:6768#### `scheduler.enterabs(time, priority, action, argument)`6970Планирует новое событие. Аргумент *time* должен быть числового типа, совместимого с возвращаемым значением функции *timefunc*, переданной конструктору. События, запланированные на одно и то же *время*, будут выполняться в порядке их *приоритета*. Меньшее число означает более высокий приоритет.7172Выполнение события означает выполнение `action(*argument)`. *argument* должен быть последовательностью, содержащей параметры для *action*.7374Возвращаемое значение – это событие, которое может быть использовано для последующей отмены события (см. [`cancel()`](https://python-all.ru/2.7/library/sched.html#sched.scheduler.cancel)).7576#### `scheduler.enter(delay, priority, action, argument)`7778Планирует событие через *delay* единиц времени. За исключением относительного времени, остальные аргументы, эффект и возвращаемое значение такие же, как и для [`enterabs()`](https://python-all.ru/2.7/library/sched.html#sched.scheduler.enterabs).7980#### `scheduler.cancel(event)`8182Удаляет событие из очереди. Если *event* не является событием, находящимся в очереди, этот метод возбуждает исключение [`ValueError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.ValueError).8384#### `scheduler.empty()`8586Возвращает true, если очередь событий пуста.8788#### `scheduler.run()`8990Запускает все запланированные события. Эта функция будет ожидать (используя функцию `delayfunc()`, переданную конструктору) следующего события, затем выполнит его и так далее, пока не останется запланированных событий.9192Либо *action*, либо *delayfunc* могут возбуждать исключения. В любом случае планировщик сохранит согласованное состояние и пробросит исключение. Если исключение возбуждено *action*, событие не будет повторно предприниматься при последующих вызовах [`run()`](https://python-all.ru/2.7/library/sched.html#sched.scheduler.run).9394Если выполнение последовательности событий занимает больше времени, чем доступно до следующего события, планировщик просто отстанет от графика. Ни одно событие не будет отброшено; вызывающий код отвечает за отмену событий, которые больше не актуальны.9596#### `scheduler.queue`9798Атрибут только для чтения, возвращающий список предстоящих событий в порядке их выполнения. Каждое событие представлено как [именованный кортеж](https://python-all.ru/2.7/glossary.html#term-named-tuple) со следующими полями: time, priority, action, argument.99100Новое в версии 2.6.101