Skip to main content

Job scheduling for humans.

Project description

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” (Google cache) and the clockwork Ruby module.


  • A simple to use API for scheduling jobs.

  • Very lightweight and no external dependencies.

  • Excellent test coverage.

  • Tested on Python 2.7 and 3.4


$ pip install schedule
import schedule
import time

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


while True:


In lieu of a full documentation (coming soon) check out this set of frequently asked questions for solutions to some common questions.


Daniel Bader –

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


0.3.0 (2014-06-14)

  • Added support for scheduling jobs on specific weekdays. Example: schedule.every() or schedule.every()"13:15").do(job) (Thanks @abultman.)

  • Run tests against Python 2.7 and 3.4. Python 3.3 should continue to work but we’re not actively testing it on CI anymore.

0.2.1 (2013-11-20)

  • Fixed history (no code changes).

0.2.0 (2013-11-09)

  • This release introduces two new features in a backwards compatible way:

  • Allow jobs to cancel repeated execution: Jobs can be cancelled by calling schedule.cancel_job() or by returning schedule.CancelJob from the job function. (Thanks to @cfrco and @matrixise.)

  • Updated at_time() to allow running jobs at a particular time every hour. Example: every()':15').do(job) will run job 15 minutes after every full hour. (Thanks @mattss.)

  • Refactored unit tests to mock datetime in a cleaner way. (Thanks @matts.)

0.1.11 (2013-07-30)

  • Fixed an issue with next_run() throwing a ValueError exception when the job queue is empty. Thanks to @dpagano for pointing this out and thanks to @mrhwick for quickly providing a fix.

0.1.10 (2013-06-07)

  • Fixed issue with at_time jobs not running on the same day the job is created (Thanks to @mattss)

0.1.9 (2013-05-27)

  • Added schedule.next_run()

  • Added schedule.idle_seconds()

  • Args passed into do() are forwarded to the job function at call time

  • Increased test coverage to 100%

0.1.8 (2013-05-21)

  • Changed default delay_seconds for schedule.run_all() to 0 (from 60)

  • Increased test coverage

0.1.7 (2013-05-20)

  • API change: renamed schedule.run_all_jobs() to schedule.run_all()

  • API change: renamed schedule.run_pending_jobs() to schedule.run_pending()

  • API change: renamed schedule.clear_all_jobs() to schedule.clear()

  • Added

0.1.6 (2013-05-20)

  • Fix packaging

  • README fixes

0.1.4 (2013-05-20)

  • API change: renamed schedule.tick() to schedule.run_pending_jobs()

  • Updated README and packaging

0.1.0 (2013-05-19)

  • Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

schedule-0.3.0.tar.gz (8.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page