In order for this to work, I create a cron.py module for all of my INSTALLED_APPS. This module must contain a run method. Other than that, it can work just like any other python module (using django's internals as necessary).
For example, if you had an app called utils (possibly located at mysite/utils/), and if you just wanted to delete all sessions with old expire_dates, your cron.py (which you would put in mysite/utils/cron.py) might look something like this:
from datetime import datetime
from django.contrib.sessions.models import Session
Now, the meat of this solution checks for the cron.py module in all of the apps in mysite.settings.INSTALLED_APPS, and invokes its run() method. I've also named this module cron.py, but this gets stored in Django's project directory (e.g. mysite)... the same directory where your settings.py is located.
Project-wide Cron Job... A Command-line Django Script.
This script gets scheduled and run by cron (or whatever).
It then calls the `run` method of each app's cron module,
if it exists (should be `appname/cron.py`)
This script should be invoked after setting the
DJANGO_SETTINGS_MODULE environment variable.
You chould do this in a BASH script as follows:
from django.conf import settings
__import__ helper function to import modules inside packages
e.g.: where name is something like 'package.module.mod_i_want',
would return mod_i_want
mod = __import__(name)
components = name.split('.')
for comp in components[1:]:
mod = getattr(mod, comp)
for app in settings.INSTALLED_APPS:
if not app.startswith('django'):
output_info = '%s.cron'%app
## Dynamically import a module called 'cron'
## from each INSTALLED_APP (if it exists)
cron_mod = my_import(app+'.cron')
output_info += '... FOUND'
## 3. Execute the cron's run method (if it exists)
if hasattr(cron_mod, 'run'):
#print '---> calling run()'
# ignore packages that don't have a cron module
output_info += '... SKIPPED'
if __name__ == "__main__":
The final piece of this puzzle lies in the BASH script used to invoke the above python module. It makes sure the appropriate environment variables are set and then it invokes the above module. I also store this in my django project directory (as cron.sh), and I use cron to schedule it to run.
# This is a Django, Project-specific Cron script.
# Separate Projects would need a copy of this script
# with appropriate Settings export statments.
Using cron, you'd schudule this to run every morning at 6am by editing your crontab and adding the following:
#m h dom mon dow command
0 6 * * * /path/to/django/project/directory/cron.sh
That's it. This has been working for me, but there is at least one major pitfall: All of your app's cron tasks get run at the same time. This works well if your apps need to do something once a day (which has been my requirement), but this probably won't work well if you have some apps that need to run tasks at differing times.
There are also other solutions to this (none of which I've tried). There's a snippet at http://www.djangosnippets.org/snippets/1126/ which looks interesting. Then there's the django-cron app which seems to be fairly flexible in how it works, and it doesn't require cron (so this is a plus if you cant set a crontab or if you're on Windows!)
Thanks in advance for any feedback... suggestions are always welcome! comments powered by Disqus