Django-celery

======
:release-date: 2012-09-21 10:29 A.M BST

- Now depends on Celery 3.0.10

- Fixed timezone issues when using the Database periodic task scheduler.

- Admin: Periodic task form now adds tasks imported using ``CELERY_IMPORTS``,
and ``CELERY_INCLUDE``.

- Memory leak warning is now only output once.

- Periodic task form in Admin no longer lists the celery built-in tasks.

.. _version-3.0.9:

=====
:release-date: 2012-08-31 06:00 P.M BST

Important note:

Celery 3.0.9 fixes an issue with periodic tasks and timezones.

If you are using the database periodic task scheduler
then you have to reset the `last_run_at` fields
to ensure that no invalid timezones are stored:

.. code-block:: bash

$ python manage.py shell
>>> from djcelery.models import PeriodicTask
>>> PeriodicTask.objects.update(last_run_at=None)

- Now depends on Celery 3.0.9

See the Celery changelog for more information:

http://docs.celeryproject.org/en/latest/changelog.html

- Don't close fds for database connections without a fileno.

- Fixes Oracle compatibility issue for closing an already
closed connection.

Fix contributed by Dan LaMotte.

- New test suite runner that stores results in the database:
:class:`djcelery.contrib.test_runner.CeleryTestSuiteRunnerStoringResult`.

Contributed by Kirill Panshin.

.. _version-3.0.6:

=====
:release-date: 2012-08-17 11:00 P.M BST

- Now depends on celery 3.0.6

- Naive datetime's received by Celery are now assumed to be UTC.

- The example demoproject no longer used ``djcelery.setup_loader``.

- Fixed south migration warning (Issue 149).

Fix contributed by Roman Imankulov.

- No longer uses deprecated urls module.

Fix contributed by Simon Charette.

- Databases are no longer closed after fork, instead we close
the underlying file descriptors, so parent process can continue
to use the connection (Issue 161).

Fix contributed by Alex Stapleton.

.. _version-3.0.4:

=====
:release-date: 2012-07-26 07:00 P.M BST
:by: Ask Solem

- Now depends on celery 3.0.4

- ``CELERY_ENABLE_UTC`` is now disabled for Django versions
before 1.4 (Issue 158).

- celerycam: No longer overwrites name, args, kwargs and eta if the
received event is missing (Issue 148 + Issue 155).

Fix contributed by Kirill Panshin.

- Fixed problem with migrations when running the tests.

Fix contributed by Roger Barnes.

- New utilities:

- :func:`djcelery.common.respect_language`

Context manager for the with statement that changes the language used.
For example::

from celery import task
from djcelery.common import respect_language

task
def my_task(language=None):
with respect_language(language):
...

- :func:`djcelery.common.respects_language`

Decorator version of the above that adds a ``language`` keyword
argument to any function that it decorates::

task
respects_language
def my_task():
pass

my_task.delay(language=translation.get_language())

Contributed by ramusus

.. _version-3.0.1:

=====
:release-date: 2012-07-10 06:00 P.M BST
:by: Ask Solem

Important Notes
---------------

The 3.0 changelog forgot to mention that two of the database
tables has been altered, so you must either use South to migrate
the tables or alter the tables manually::

ALTER TABLE celery_taskmeta
ADD meta TEXT NULL DEFAULT "";

ALTER TABLE djcelery_crontabschedule
ADD day_of_month VARCHAR(64) NOT NULL DEFAULT "*";

ALTER TABLE djcelery_crontabschedule
ADD month_of_year VARCHAR(64) NOT NULL DEFAULT "*";

Fixes
-----

- Now depends on Celery 3.0.1

- Fixes problems with South migrations (Issue 149)

Fix contributed by Roman Imankulov.

- Task monitor must store task eta in UTC (Issue 139).

Fix contributed by Mike Ivanov.

.. _version-3.0.0:

=====
:release-date: 2012-07-07 01:00 P.M BST
:by: Ask Solem

.. _v300-important:

Important Notes
---------------

- Now depends on Celery 3.0

It is important that you read the What's New document for the 3.0 series:
http://docs.celeryproject.org/en/latest/whatsnew-3.0.html

- No longer depends on :mod:`django-picklefield`

And as such the result backend will no longer deepcopy return
values or exceptions.

- Celery 3.0 is the last release to require django-celery

Starting with Celery 3.1 the django-celery package will no longer be
required and Celery will support Django out of the box.

The django-celery package may still exist for some time to provide
additional utilities like the django-admin monitor.

- django-celery 3.0 is the last series to support Python 2.5.

Celery will no longer support Python 2.5 starting with version 3.1.

- New :program:`manage.py celery` umbrella command replaces older commands.

All commands except for :program:`manage.py celeryevcam` can
now be started using the new umbrella command::

$ manage.py celery worker -l info <<< NEW
$ manage.py celeryd -l info <-- OLD

$ manage.py celery status <<< NEW
$ manage.py celeryctl status <-- OLD

$ manage.py celery beat -l info <<< NEW
$ manage.py celerybeat -l info <-- OLD

$ manage.py celery multi start ... <<< NEW
$ manage.py celeryd_multi start ... <-- OLD

$ manage.py celery amqp queue.delete celery <<< NEW
$ manage.py camqadm queue.delete celery <-- OLD

See ``manage.py celery help`` for a complete list of supported commands.

The old commands will still work, but you are encouraged to start
using the new umbrella command.

- The distribution :file:`contrib/` directory is now renamed to
:file:`extra/`.

- The django-celery source code repository has moved

The new location is at http://github.com/celery/django-celery

.. _v260-news:

News
----

- New Spanish translation.

Contributed by Diego Andres Sanabria Martin.

.. _v300-fixes:

Fixes
-----

- Fixes an UTC bug when ``CELERY_ENABLE_UTC`` was enabled (Issue 131).

- Database Periodic Task Scheduler: Disabling a periodic task now also
resets its last_run_at field. So that the schedule will restart from
scratch if re-enabled (Issue 370).

- Database Periodic Task Scheduler: Now retries the sync operation
if database errors occur.

.. _version-2.5.5: