Package: django-zcelery
===============================================django-celery - Celery Integration for Django===============================================.. image:: http://cloud.github.com/downloads/celery/celery/celery_128.png:Version: 3.2.0a1: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 ONLY REQUIRED IF YOU WANT TO USE DJANGO RESULT BACKENDAND ADMIN INTEGRATION**Please follow the new tutorial at:http://docs.celeryproject.org/en/latest/django/first-steps-with-django.htmldjango-celery provides Celery integration for Django; Using the Django ORMand cache backend for storing results, autodiscovery of task modulesfor 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 djcelerydjcelery.setup_loader()Everything works the same as described in the `Celery User Manual`_, except youneed 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 inyour 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 toinclude the following in your ``.wsgi`` module::import djcelerydjcelery.setup_loader()Documentation=============The `Celery User Manual`_ contains user guides, tutorials and an APIreference. Also the `django-celery documentation`_, contains informationabout the Django integration... _`Celery User Manual`: http://docs.celeryproject.org/.. _`Getting started with django-celery`:http://docs.celeryproject.org/en/latest/django/first-steps-with-django.htmlInstallation=============You can install ``django-celery`` either via the Python Package Index (PyPI)or from source.To install using ``pip``,::$ pip install django-celeryTo install using ``easy_install``,::$ easy_install django-celeryYou will then want to create the necessary tables. If you generatingschema migrations, you'll want to run::$ python manage.py migrate djceleryDownloading and installing from source--------------------------------------Download the latest version of ``django-celery`` fromhttp://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 rootUsing the development version------------------------------You can clone the git repository by doing the following::$ git clone git://github.com/celery/django-celery.gitGetting Help============Mailing list------------For discussions about the usage, development, and future of celery,please join the `celery-users`_ mailing list... _`celery-users`: http://groups.google.com/group/celery-users/IRC---Come chat with us on IRC. The **#celery** channel is located at the `Freenode`_network... _`Freenode`: http://freenode.netBug tracker===========If you have any suggestions, bug reports or annoyances please report themto 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-celeryYou are highly encouraged to participate in the development.If you don't like Github (for some reason) you're welcometo 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... # vim: syntax=rst expandtab tabstop=4 shiftwidth=4 shiftround