No description or website provided.
Switch branches/tags
Clone or download

README.rst

Celery Result Backends using the Django ORM/Cache framework.

Build status coverage BSD License django-celery-results can be installed via wheel Supported Python versions. Support Python implementations.

Version:1.0.4
Web:http://django-celery-results.readthedocs.io/
Download:http://pypi.python.org/pypi/django-celery-results
Source:http://github.com/celery/django-celery-results
Keywords:django, celery, database, results

About

This extension enables you to store Celery task results using the Django ORM.

It defines a single model (django_celery_results.models.TaskResult) used to store task results, and you can query this database table like any other Django model.

Installing

The installation instructions for this extension is available from the Celery documentation:

http://docs.celeryproject.org/en/latest/django/first-steps-with-django.html#django-celery-results-using-the-django-orm-cache-as-a-result-backend

Installation

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

To install using pip,:

$ pip install -U django-celery-results

Downloading and installing from source

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

You can install it by doing the following,:

$ tar xvfz django-celery-results-0.0.0.tar.gz
$ cd django-celery-results-0.0.0
$ python setup.py build
# python setup.py install

The last command must be executed as a privileged user if you are not currently using a virtualenv.

Using the development version

With pip

You can install the latest snapshot of django-celery-results using the following pip command:

$ pip install https://github.com/celery/django-celery-results/zipball/master#egg=django-celery-results

Issues with mysql

If you want to run django-celery-results with MySQL, you might run into some issues.

One such issue is when you try to run python manage.py migrate django_celery_results, you might get the following error:

django.db.utils.OperationalError: (1071, 'Specified key was too long; max key length is 767 bytes')

To get around this issue, you can set:

DJANGO_CELERY_RESULTS_TASK_ID_MAX_LENGTH=191

(or any other value if any other db other than MySQL is causing similar issues.)

max_length of 191 seems to work for MySQL.