schedule

https://api.travis-ci.org/dbader/schedule.svg?branch=master https://coveralls.io/repos/dbader/schedule/badge.svg?branch=master https://img.shields.io/pypi/v/schedule.svg

Python job scheduling for humans.

An in-process scheduler for periodic jobs that uses the builder pattern for configuration. Schedule lets you run Python functions (or any other callable) periodically at pre-determined intervals using a simple, human-friendly syntax.

Inspired by Adam Wiggins’ article “Rethinking Cron” and the clockwork Ruby module.

Features

  • A simple to use API for scheduling jobs.
  • Very lightweight and no external dependencies.
  • Excellent test coverage.
  • Tested on Python 2.7, 3.5, and 3.6

Usage

$ pip install schedule
import schedule
import time

def job():
    print("I'm working...")

schedule.every(10).minutes.do(job)
schedule.every().hour.do(job)
schedule.every().day.at("10:30").do(job)
schedule.every().monday.do(job)
schedule.every().wednesday.at("13:15").do(job)

while True:
    schedule.run_pending()
    time.sleep(1)

API Documentation

If you are looking for information on a specific function, class, or method, this part of the documentation is for you.

Issues

If you encounter any problems, please file an issue along with a detailed description. Please also check the Frequently Asked Questions and use the search feature in the issue tracker beforehand to avoid creating duplicates. Thank you 😃

About Schedule

Schedule was created by Daniel Bader - @dbader_org

Distributed under the MIT license. See LICENSE.txt for more information.

Thanks to all the wonderful folks who have contributed to schedule over the years: