newlib

Крошечный планировщик с cron-выражениями и разбросом.

newlib заменяет системный crontab для работы, которая принадлежит вашему приложению. Он учитывает часовые пояса, добавляет разброс, чтобы сотня серверов не просыпалась одновременно, и аккуратно останавливается.

uv add newlib

Пример

from datetime import timedelta

from newlib import Scheduler

scheduler = Scheduler(
    timezone="Europe/Moscow",
    jitter=timedelta(seconds=30),
)

ok = scheduler.add("cleanup", "0 3 * * *")
print(ok)

scheduler.start()

Возможности

• Часовые пояса. У каждой задачи может быть свой часовой пояс, переходы на летнее время обрабатываются корректно.
• Без наложений. Если задача ещё выполняется, когда наступил следующий запуск, он пропускается, а не стартует второй раз.
• Тестируемость. Подставьте фальшивые часы и сдвигайте их, чтобы запускать задачи в тестах.
• Разброс. Запуски размазываются по окну, чтобы сотня экземпляров не била в базу в одну секунду.
• Мягкая остановка. Остановка планировщика ждёт выполняющиеся задачи до таймаута.

Документация