Skip to main content

Kronos is a Django application that makes it easy to define and schedule tasks with cron.

Project description

.. image::

.. image::
.. image::
.. image::
.. image::


Define tasks

Kronos collects tasks from ``cron`` modules in your project root and each of your applications::

# app/

import kronos
import random

@kronos.register('0 0 * * *')
def complain():
complaints = [
"I forgot to migrate our applications's cron jobs to our new server! Darn!",
"I'm out of complaints! Damnit!"

print random.choice(complaints)

Kronos works with Django management commands, too::

# app/management/commands/

from import BaseCommand

import kronos

@kronos.register('0 0 * * *')
class Command(BaseCommand):
def handle(self, *args, **options):
print('Hello, world!')

If your management command accepts arguments, just pass them in the decorator::

# app/management/commands/

from import BaseCommand

import kronos

@kronos.register('0 0 * * *', args={'-l': 'nb'})
class Command(BaseCommand):

def add_arguments(self, parser):
'-l', '--language',

def handle(self, *args, **options):
if options['language'] == 'en':
print('Hello, world!')

if options['language'] == 'nb':
print('Hei, verden!')

Run tasks manually


$ python runtask complain
I forgot to migrate our applications's cron jobs to our new server! Darn!

Keep in mind that if the registered task is a django command you have to run it
in the normal way::

$ python task

List all registered tasks


$ python showtasks
* List of tasks registered in Kronos *
>> Kronos tasks
>> my_task_one
>> my_task_two
>> Django tasks
>> my_django_task

Register tasks with cron


$ python installtasks
Installed 1 task.

You can review the crontab with a ``crontab -l`` command::

$ crontab -l
0 0 * * * /usr/bin/python /path/to/ runtask complain --settings=myprpoject.settings $KRONOS_BREAD_CRUMB
0 0 * * * /usr/bin/python /path/to/ task --settings=myprpoject.settings $KRONOS_BREAD_CRUMB

Usually this line will work pretty well for you, but there can be some rare
cases when it requires modification. You can achieve it with a number of
settings variables used by kronos:

Python interpreter to build a crontab line (defaults to the interpreter you used to
invoke the management command).

Management command to build a crontab line (defaults to ```` in the current
working directory).

Extra path which will be added as a ``--pythonpath`` option to the management command.

Extra string added at the end of the command. For dirty thinks like ``> /dev/null 2>&1``

Extra string added at the beginning of the command. For dirty thinks like ``source /path/to/env &&``.
If you use the ``virtualenv``, you can add the environment path by ``echo "KRONOS_PREFIX = 'source `echo $VIRTUAL_ENV`/bin/activate && '" >> myprpoject/``

Define these variables in your ```` file if you wish to alter crontab lines.

The env variable ``$KRONOS_BREAD_CRUMB`` is defined to detect which tasks have to be deleted after
being installed.



$ pip install django-kronos

... and add ``kronos`` to ``INSTALLED_APPS``.


* Fork the repository.
* Do your thing.
* Open a pull request.
* Receive cake.

I love you

Johannes Gorset made this. You should `tweet me <>`_ if you can't get it
to work. In fact, you should tweet me anyway.


* Django 1.10 support.


* Fixed a bug that caused Kronos to crash if the settings module resided outside
of the project directory.
* Fixed a bug that caused Kronos to remove other crontabs upon uninstalling.


* Kronos is now even more compatible with Python 3.
* Kronos is no longer compatible with Python 2.6.
* Kronos is no longer compatible with Django 1.7.
* You may now prefix commands with ``KRONOS_PREFIX``.
* Fixed an issue where Kronos would not pick up on AppConfig apps.


* You may now pass arguments to Django management commands registered with Kronos.
* Kronos is now compatible with Python 3.
* Kronos will now log errors when it fails to load tasks.


* You may now register Django management commands.


* You may now list commands with ``python showtasks``.


* You may now postfix commands with ``KRONOS_POSTFIX``.


* You may now customize the interpreter, management path and python path for tasks with the ``KRONOS_PYTHON``,
``KRONOS_MANAGE`` and ``KRONOS_PYTHONPATH`` settings, respectively.


* Kronos now supports Django 1.4-style projects.
* Fixed a bug that caused installation to fail for users that didn't already have a crontab.


* Fixed a bug that caused unclosed single quotes in the crontab to raise a ValueError


* Fixed a bug that caused 'cron'-modules in the project root to be ignored.


* Kronos will now collect tasks from a 'cron' module in the project root.

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 django-kronos, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size django-kronos-1.0.tar.gz (10.8 kB) File type Source Python version None Upload date Hashes View

Supported by

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