Skip to content
This repository

Old Celery integration project for Django

Octocat-spinner-32 djcelery Bumps version to 3.1.10 and updates Changelog March 31, 2014
Octocat-spinner-32 docs Adds djcelery.db to API reference February 13, 2014
Octocat-spinner-32 extra remove examples directory and extra/supervisord November 11, 2013
Octocat-spinner-32 locale generated mo file for spanish translation May 12, 2012
Octocat-spinner-32 requirements Bumps version to 3.1.10 and updates Changelog March 31, 2014
Octocat-spinner-32 tests fix(tests): fix deprecated imports for Django <1.6 March 12, 2014
Octocat-spinner-32 .gitignore Fixed timezone support in Django 1.4 by conditionally converting time… January 11, 2012
Octocat-spinner-32 AUTHORS Adds Michael van Tellingen to AUTHORS March 31, 2014
Octocat-spinner-32 Changelog Bumps version to 3.1.10 and updates Changelog March 31, 2014
Octocat-spinner-32 FAQ Canonical repo moved to github.com/celery/django-celery June 06, 2012
Octocat-spinner-32 INSTALL Added standard distribution files and a first draft for a README May 20, 2010
Octocat-spinner-32 LICENSE Copyright is now GoPivotal, Inc. June 11, 2013
Octocat-spinner-32 MANIFEST.in remove examples directory and extra/supervisord November 11, 2013
Octocat-spinner-32 README Added standard distribution files and a first draft for a README May 20, 2010
Octocat-spinner-32 README.rst Bumps version to 3.1.10 and updates Changelog March 31, 2014
Octocat-spinner-32 THANKS Added standard distribution files and a first draft for a README May 20, 2010
Octocat-spinner-32 TODO Canonical repo moved to github.com/celery/django-celery June 06, 2012
Octocat-spinner-32 pavement.py Merge branch '3.0' September 03, 2013
Octocat-spinner-32 setup.cfg Bumps version to 3.1.10 and updates Changelog March 31, 2014
Octocat-spinner-32 setup.py Bumps version to 3.1.10 and updates Changelog March 31, 2014
Octocat-spinner-32 tox.ini fix(tests): add Django 1.2 and 1.3 to tox.ini March 12, 2014
README.rst

django-celery - Celery Integration for Django

http://cloud.github.com/downloads/celery/celery/celery_128.png
Version: 3.1.10
Web: http://celeryproject.org/
Download: http://pypi.python.org/pypi/django-celery/
Source: http://github.com/celery/django-celery/
Keywords: celery, task queue, job queue, asynchronous, rabbitmq, amqp, redis, python, django, webhooks, queue, distributed

--

Warning

THIS PROJECT IS NO LONGER REQUIRED

Please follow the new tutorial at:

http://docs.celeryproject.org/en/latest/django/first-steps-with-django.html

django-celery provides Celery integration for Django; Using the Django ORM and cache backend for storing results, autodiscovery of task modules for applications listed in INSTALLED_APPS, and more.

Using django-celery

To enable django-celery for your project you need to add djcelery to INSTALLED_APPS:

INSTALLED_APPS += ("djcelery", )

then add the following lines to your settings.py:

import djcelery
djcelery.setup_loader()

Everything works the same as described in the Celery User Manual, except you need to invoke the programs through manage.py:

Program Replace with
celery python manage.py celery
celery worker python manage.py celery worker
celery beat python manage.py celery beat
celery ... python manage.py celery ...

The other main difference is that configuration values are stored in your Django projects' settings.py module rather than in celeryconfig.py.

If you're trying celery for the first time you should start by reading Getting started with django-celery

Special note for mod_wsgi users

If you're using mod_wsgi to deploy your Django application you need to include the following in your .wsgi module:

import djcelery
djcelery.setup_loader()

Documentation

The Celery User Manual contains user guides, tutorials and an API reference. Also the django-celery documentation, contains information about the Django integration.

Installation

You can install django-celery either via the Python Package Index (PyPI) or from source.

To install using pip,:

$ pip install django-celery

To install using easy_install,:

$ easy_install django-celery

You will then want to create the necessary tables. If you are using south for schema migrations, you'll want to:

$ python manage.py migrate djcelery

For those who are not using south, a normal syncdb will work:

$ python manage.py syncdb

Downloading and installing from source

Download the latest version of django-celery from http://pypi.python.org/pypi/django-celery/

You can install it by doing the following,:

$ tar xvfz django-celery-0.0.0.tar.gz
$ cd django-celery-0.0.0
# python setup.py install # as root

Using the development version

You can clone the git repository by doing the following:

$ git clone git://github.com/celery/django-celery.git

Getting Help

Mailing list

For discussions about the usage, development, and future of celery, please join the celery-users mailing list.

IRC

Come chat with us on IRC. The #celery channel is located at the Freenode network.

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to our issue tracker at http://github.com/celery/django-celery/issues/

Wiki

http://wiki.github.com/celery/celery/

Contributing

Development of django-celery happens at Github: http://github.com/celery/django-celery

You are highly encouraged to participate in the development. If you don't like Github (for some reason) you're welcome to send regular patches.

License

This software is licensed under the New BSD License. See the LICENSE file in the top distribution directory for the full license text.

Something went wrong with that request. Please try again.