Skip to main content

Unix cron implementation by Python

Project description

Cron Validator

Build Status Coverage Status

Features

  • Validate unix cron expression
  • Match unit cron expression with specific datetime
  • Generate match datetime between two datetime
  • Schedule tasks

Install

pip install cron-validator

Run Tests

1. Install test requirements

pip install -r requirements/test.txt

2. Run tests (with coverage if wished)

pytest --cov=. test/

Sample

1. Validate unix cron expression

from cron_validator import CronValidator

assert CronValidator.parse('* * * * *') is not None # valid
assert CronValidator.parse('*/3 * * * *') is not None # valid
assert CronValidator.parse('*/61 * * * *') is None # invalid

2. Match unit cron expression with specific datetime

from cron_validator import CronValidator
from cron_validator.util import str_to_datetime

dt_str = '2019-04-23 1:00'
dt = str_to_datetime(dt_str)

assert CronValidator.match_datetime("* * * * *", dt)
assert CronValidator.match_datetime("* * * 4 *", dt)
assert CronValidator.match_datetime("* * * 5 *", dt) is False
assert CronValidator.match_datetime("* * * 1-5 *", dt)
assert CronValidator.match_datetime("* * * 1-3 *", dt) is False
assert CronValidator.match_datetime("* * * 1/5 *", dt) is False
assert CronValidator.match_datetime("* * * * *", dt)
assert CronValidator.match_datetime("0 * * * *", dt)
assert CronValidator.match_datetime("0-30 * * * *", dt)
assert CronValidator.match_datetime("0/30 * * * *", dt)

3. Generate match datetime between two datetime

from cron_validator import CronValidator
from cron_validator.util import str_to_datetime


from_str = '2019-04-22 00:00'
to_str = '2019-04-23 23:59'

for dt in CronValidator.get_execution_time("0 0 * * *",
from_dt=str_to_datetime(from_str), to_dt=str_to_datetime(to_str)):
    print(dt)

# Output:
# 2019-04-22 00:00:00+00:00
# 2019-04-23 00:00:00+00:00

4. Use scheduler for repetitive task

from cron_validator import CronScheduler

cron_string = "*/1 * * * *"
scheduler = CronScheduler(cron_string)

while True:
    if scheduler.time_for_execution():
        # Get's called every full minute (excluding first iteration)
        print("Now is the next scheduled time.")

5. Use extended cron rules based on AWS EventBridge rules (from v1.0.6)

The cron validator supports partially extended rules based on the Amazon EvenBridge rule set. More info.

Currently we support:

  • 'L' for day of the month and day of the week
  • 'W' for day of the week.
from cron_validator import CronValidator
from cron_validator.util import str_to_datetime
from cron_validator.regexes import Version

dt_str = '2023-04-28 1:00'
dt = str_to_datetime(dt_str)

assert CronValidator.match_datetime("* * * * 30W", dt, version=Version.EB)
assert CronValidator.match_datetime("* * * * 5L", dt, version=Version.EB)

dt_str = "2022-02-28 1:00"
dt = str_to_datetime(dt_str)
assert CronValidator.match_datetime("* * L * *", dt, version=Version.EB)

License

This project is licensed under the MIT License - see the LICENSE.txt file for details

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

cron-validator-1.0.8.tar.gz (9.7 kB view details)

Uploaded Source

Built Distribution

cron_validator-1.0.8-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

Details for the file cron-validator-1.0.8.tar.gz.

File metadata

  • Download URL: cron-validator-1.0.8.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.13

File hashes

Hashes for cron-validator-1.0.8.tar.gz
Algorithm Hash digest
SHA256 dd485257adb6f590b3e9433f641440c801d307015259c1ee3eb6e21c964c8026
MD5 e3621046c81cf611f49d3137915a6b7e
BLAKE2b-256 3155d3d8e7acad9dc3f54133df0972c79d38f2c6fc4be41f281a396c3afe4411

See more details on using hashes here.

File details

Details for the file cron_validator-1.0.8-py3-none-any.whl.

File metadata

  • Download URL: cron_validator-1.0.8-py3-none-any.whl
  • Upload date:
  • Size: 7.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.13

File hashes

Hashes for cron_validator-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 6477fcc3d60bfbd1ec00a708f0b8b5136c1fef8140c10effea1f45b79d778653
MD5 95233c86dfef07119bee113bf499686a
BLAKE2b-256 490cd6bf9d572fb2ce3404fe37b794cf10dd44566368f7084c71b6028d3818ff

See more details on using hashes here.

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