Skip to main content

Django Celery Integration.

Project description

http://cloud.github.com/downloads/ask/celery/celery_favicon_128.png
Version:

2.2.1

Web:

http://celeryproject.org/

Download:

http://pypi.python.org/pypi/django-celery/

Source:

http://github.com/ask/django-celery/

Keywords:

celery, task queue, job queue, asynchronous, rabbitmq, amqp, redis, python, django, webhooks, queue, distributed

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.

Celery is a task queue/job queue based on distributed message passing. It is focused on real-time operation, but supports scheduling as well.

The execution units, called tasks, are executed concurrently on a single or more worker servers. Tasks can execute asynchronously (in the background) or synchronously (wait until ready).

Celery is already used in production to process millions of tasks a day.

Celery is written in Python, but the protocol can be implemented in any language. It can also operate with other languages using webhooks.

The recommended message broker is RabbitMQ, but support for Redis and databases (SQLAlchemy / Django) is also available.

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

celeryd

python manage.py celeryd

celerybeat

python manage.py celerybeat

camqadm

python manage.py camqadm

celeryev

python manage.py celeryev

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 os
os.environ["CELERY_LOADER"] = "django"

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

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 build
# 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/ask/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/ask/django-celery/issues/

Wiki

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

Contributing

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

You are highly encouraged to participate in the development of celery. 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.

Project details


Download files

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

Source Distributions

django-celery-2.2.1.zip (95.8 kB view details)

Uploaded Source

django-celery-2.2.1.tar.gz (57.4 kB view details)

Uploaded Source

django-celery-2.2.1.tar.bz2 (46.7 kB view details)

Uploaded Source

File details

Details for the file django-celery-2.2.1.zip.

File metadata

  • Download URL: django-celery-2.2.1.zip
  • Upload date:
  • Size: 95.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-celery-2.2.1.zip
Algorithm Hash digest
SHA256 27c5a0808e3eae620a58944330456265dd44976ef40dec84984d31ab55045294
MD5 1cbfb74a40e78041b9280e8b7e1dea7f
BLAKE2b-256 2301df430dd4b9332da04a7aac7113075bb2535ac58d56898729fedf0cbfbfa1

See more details on using hashes here.

File details

Details for the file django-celery-2.2.1.tar.gz.

File metadata

File hashes

Hashes for django-celery-2.2.1.tar.gz
Algorithm Hash digest
SHA256 781d97a0614bf3771d44a86f32fdc8f65c131a591e42ab9679d4897c4e58baa4
MD5 a898b49814ded7e8c99341edc175c2bb
BLAKE2b-256 cc5b02f3583f8b753b04421e2399c8d9d2051249cd4ba4120cdb739d843e61d0

See more details on using hashes here.

File details

Details for the file django-celery-2.2.1.tar.bz2.

File metadata

File hashes

Hashes for django-celery-2.2.1.tar.bz2
Algorithm Hash digest
SHA256 2b070b38168cff44fac72fbc1d181ff3077d0042ae8812f91868692c34ea8aa9
MD5 512e3e3300e9d84f6048ad5bf267a9dd
BLAKE2b-256 e4ce01d8a684d47776ecb7d182acec586a92bf1fb3d410ae264a5605888842c9

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