Skip to main content

A crontab script wrapper written by python

Project description

Chinese Version

This project is inspired by cronic and includes some extra useful functions such as sending email error report through SMTP and store logs of crontab scripts.

Why pycronic?

Crontab has the ability to send mail notification when any output was generated executing your script, as we know. It will send a bunch of emails to you every day if you have a lof of scripts. What if we only want to get the mail when something goes wrong?

As a result, You may config your crontab like this:

# Redirect all standard output to /dev/null so we will get an email
# only if this script has some standard error output.
* * * * * some_work > /dev/null

# Or this to ignore all output for lazy people, but you will never
# be notified if your script fails.
* * * * * some_work > /dev/null 2>&1

Using pycronic make things simplier:

* * * * * &cronic some_work

All you need is to prepend cronic to your script execution command. cronic command will check the return code and the error output for you, if something wents wrong, you will get an email notification through crontab’s default mailing system or your customized STMP server.

MAIL TITLE: [Cronic@server1] Error occoured when running "backup"


Cronic Error Report

[2013-11-12 16:07:24.228788] Cronic detected failure or error output for the command:




Can not connect to database!


Starting backup...

And cronic will store all your scripts output to a directory (/tmp/pycronic by default).


Using pip:

# Install from pypi
sudo pip install pycronic
# Latest version from git
sudo pip install
# Or install from github
sudo pip install -e git+

Note: pycronic is now python3 compatible, you can install using pip3 install ...


After the installation, run “cronic” in your command line to verify:

$ cronic
Usage: cronic YOUR_COMMAND

$ cronic ls
Config file "/etc/pycronic.conf" does not exist!
Run "cronic init" to create a default one."

Then run “sudo cronic init” to create a default config file under /etc, the default config file should look like this:

# Log path for pycronic, pycronic will store all logs to this directory
log_path = /tmp/pycronic

# Send an error email or not, default to not send
send_alert_email = True

# Email Title
mail_title = [Cronic@%(host)s] Error occoured when running "%(command)s"

# Email receivers
# receivers =

# Email smtp server config
# username = username
# host =
# password = password
# from = Cronic <>
# port = 587

How to use

cronic will be silent if no error occured when running a script:

piglei@macbook-pro:etc$ cronic ls
piglei@macbook-pro:etc$ cat /tmp/pycronic/ls.log
[The script result will be stored in the log file]

But if an error has occured (cronic will check the standard error output), it will print an error message like this:

$ cronic ls asdf
Cronic Error Report

[2013-11-12 15:49:03.349575] Cronic detected failure or error output for the command:

ls asdf



ls: asdf: No such file or directory



If you have configured your crontab an email will send to your email address.

You can also modify config to send mail through SMTP instead of using crontab which is highly more recommended.

Rock crontab

Now config your crontab, using pycronic to wrap your scripts:

$ crontab -e
# If you have not config your pycronic.conf's smtp config, you can still
# use crontab to send error emails.

*/5 * * * *  $cronic YOUR SCRIPT


Project details

Download files

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

Files for pycronic, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size pycronic-0.0.5-py3-none-any.whl (12.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pycronic-0.0.5.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page