Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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

sche is a fork of schedule – 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 3.6+

  • Timezone support.

Usage

$ pip install sche
import sche
import time

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

sche.every(10).minutes.do(job)
sche.every().hour.do(job)
sche.every().day.at("10:30").do(job)
sche.every(5).to(10).minutes.do(job)
sche.every().monday.do(job)
sche.every().wednesday.at("13:15").do(job)
sche.every().minute.at(":17").do(job)

# or use schedule expression
sche.when("every 10 minutes").do(job)
sche.when("every hour").do(job)
sche.when("every day at 10:30").do(job)
sche.when("every 5 to 10 minutes").do(job)
sche.when("every monday").do(job)
sche.when("every wednesday at 13:15").do(job)
sche.when("every minute at :17").do(job)

# or use decorator to register job(without arguments)
@sche.when("every 10 minutes")
def another_job():
    print("I'm working on another job...")

sche.clear()  # remove all jobs

# set job with timezone
sche.timezone("+0800").every().day.at("00:00").do(job)

sche.run_forever()  # blockingly

# OR
sche.run_forever_background()  # non-blockingly

Documentation

sche’s documentation lives at sche.readthedocs.io.

Please also check the FAQ there with common questions.

Meta

Daniel Bader - @dbader_org - mail@dbader.org

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

https://github.com/dbader/schedule

Download files

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

Source Distribution

sche-1.0a5.tar.gz (16.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sche-1.0a5-py2.py3-none-any.whl (11.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file sche-1.0a5.tar.gz.

File metadata

  • Download URL: sche-1.0a5.tar.gz
  • Upload date:
  • Size: 16.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for sche-1.0a5.tar.gz
Algorithm Hash digest
SHA256 30650a1267eb5a335bd3e3c22b71bd928ca449fb3d3a5ffb18de45ed9533f0d1
MD5 723ea504341fe07be1e4ba587881c792
BLAKE2b-256 dd2a7c32a4529a26f72326ce6620c62f75d3bc632257fe0bdf6d0cece4d25f5f

See more details on using hashes here.

File details

Details for the file sche-1.0a5-py2.py3-none-any.whl.

File metadata

  • Download URL: sche-1.0a5-py2.py3-none-any.whl
  • Upload date:
  • Size: 11.1 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for sche-1.0a5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4df4ceab21e3c851537997076b31eda1ed908f902b6b88b5ec2a3cab4a64901f
MD5 e32c11c895a8d5ce1ac0c37fd782d38d
BLAKE2b-256 8fbf72692cb7c4b5380566d1eaa7aaa6059ab245a110196a98bea59ee4840d50

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.0a5 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page