Changelog 8.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319
  1. .. _changelog:
  2. ================
  3. Change history
  4. ================
  5. This document contains change notes for bugfix releases in the 3.1.x series
  6. (Cipater), please see :ref:`whatsnew-3.1` for an overview of what's
  7. new in Celery 3.1.
  8. .. _version-3.1.6:
  9. 3.1.6
  10. =====
  11. - Now depends on :mod:`billiard` 3.3.0.10.
  12. - Now depends on :ref:`Kombu 3.0.7 <kombu:version-3.0.7>`.
  13. - Fixed problem where Mingle caused the worker to hang at startup
  14. (Issue #1686).
  15. - Beat: Would attempt to drop privileges twice (Issue #1708).
  16. - Windows: Fixed error with ``geteuid`` not being available (Issue #1676).
  17. - Tasks can now provide a list of expected error classes (Issue #1682).
  18. The list should only include errors that the task is expected to raise
  19. during normal operation::
  20. @task(throws=(KeyError, HttpNotFound))
  21. What happens when an exceptions is raised depends on the type of error:
  22. - Expected errors (included in ``Task.throws``)
  23. Will be logged using severity ``INFO``, and traceback is excluded.
  24. - Unexpected errors
  25. Will be logged using severity ``ERROR``, with traceback included.
  26. - Cache result backend now compatible with Python 3 (Issue #1697).
  27. - CentOS init script: Now compatible with sys-v style init symlinks.
  28. Fix contributed by Jonathan Jordan.
  29. - Events: Fixed problem when task name is not defined (Issue #1710).
  30. Fix contributed by Mher Movsisyan.
  31. - Task: Fixed unbound local errors (Issue #1684).
  32. Fix contributed by Markus Ullmann.
  33. - Canvas: Now unrolls groups with only one task (optimization) (Issue #1656).
  34. - Task: Fixed problem with eta and timezones.
  35. Fix contributed by Alexander Koval.
  36. - Django: Worker now performs model validation (Issue #1681).
  37. - Task decorator now emits less confusing errors when used with
  38. incorrect arguments (Issue #1692).
  39. - Task: New method ``Task.send_event`` can be used to send custom events
  40. to Flower and other monitors.
  41. - Fixed a compatibility issue with non-abstract task classes
  42. - Events from clients now uses new node name format (``gen<pid>@<hostname>``).
  43. - Fixed rare bug with Callable not being defined at interpreter shutdown
  44. (Issue #1678).
  45. Fix contributed by Nick Johnson.
  46. - Fixed Python 2.6 compatibility (Issue #1679).
  47. .. _version-3.1.5:
  48. 3.1.5
  49. =====
  50. :release-date: 2013-11-21 6:20 P.M UTC
  51. :release-by: Ask Solem
  52. - Now depends on :ref:`Kombu 3.0.6 <kombu:version-3.0.6>`.
  53. - Now depends on :mod:`billiard` 3.3.0.8
  54. - App: ``config_from_object`` is now lazy (Issue #1665).
  55. - App: ``autodiscover_tasks`` is now lazy.
  56. Django users should now wrap access to the settings object
  57. in a lambda::
  58. app.autodiscover_tasks(lambda: settings.INSTALLED_APPS)
  59. this ensures that the settings object is not prepared
  60. prematurely.
  61. - Fixed regression for ``--app`` argument experienced by
  62. some users (Issue #1653).
  63. - Worker: Now respects the ``--uid`` and ``--gid`` arguments
  64. even if ``--detach`` is not enabled.
  65. - Beat: Now respects the ``--uid`` and ``--gid`` arguments
  66. even if ``--detach`` is not enabled.
  67. - Python 3: Fixed unorderable error occuring with the worker ``-B``
  68. argument enabled.
  69. - ``celery.VERSION`` is now a named tuple.
  70. - ``maybe_signature(list)`` is now applied recursively (Issue #1645).
  71. - ``celery shell`` command: Fixed ``IPython.frontend`` deprecation warning.
  72. - The default app no longer includes the builtin fixups.
  73. This fixes a bug where ``celery multi`` would attempt
  74. to load the Django settings module before entering
  75. the target working directory.
  76. - The Django daemonization tutorial was changed.
  77. Users no longer have to explicitly export ``DJANGO_SETTINGS_MODULE``
  78. in :file:`/etc/default/celeryd` when the new project layout is used.
  79. - Redis result backend: expiry value can now be 0 (Issue #1661).
  80. - Censoring settings now accounts for non-string keys (Issue #1663).
  81. - App: New ``autofinalize`` option.
  82. Apps are automatically finalized when the task registry is accessed.
  83. You can now disable this behavior so that an exception is raised
  84. instead.
  85. Example:
  86. .. code-block:: python
  87. app = Celery(autofinalize=False)
  88. # raises RuntimeError
  89. tasks = app.tasks
  90. @app.task
  91. def add(x, y):
  92. return x + y
  93. # raises RuntimeError
  94. add.delay(2, 2)
  95. app.finalize()
  96. # no longer raises:
  97. tasks = app.tasks
  98. add.delay(2, 2)
  99. - The worker did not send monitoring events during shutdown.
  100. - Worker: Mingle and gossip is now automatically disabled when
  101. used with an unsupported transport (Issue #1664).
  102. - ``celery`` command: Preload options now supports
  103. the rare ``--opt value`` format (Issue #1668).
  104. - ``celery`` command: Accidentally removed options
  105. appearing before the subcommand, these are now moved to the end
  106. instead.
  107. - Worker now properly responds to ``inspect stats`` commands
  108. even if received before startup is complete (Issue #1659).
  109. - :signal:`task_postrun` is now sent within a finally block, to make
  110. sure the signal is always sent.
  111. - Beat: Fixed syntax error in string formatting.
  112. Contributed by nadad.
  113. - Fixed typos in the documentation.
  114. Fixes contributed by Loic Bistuer, sunfinite.
  115. - Nested chains now works properly when constructed using the
  116. ``chain`` type instead of the ``|`` operator (Issue #1656).
  117. .. _version-3.1.4:
  118. 3.1.4
  119. =====
  120. :release-date: 2013-11-15 11:40 P.M UTC
  121. :release-by: Ask Solem
  122. - Now depends on :ref:`Kombu 3.0.5 <kombu:version-3.0.5>`.
  123. - Now depends on :mod:`billiard` 3.3.0.7
  124. - Worker accidentally set a default socket timeout of 5 seconds.
  125. - Django: Fixup now sets the default app so that threads will use
  126. the same app instance (e.g. for manage.py runserver).
  127. - Worker: Fixed Unicode error crash at startup experienced by some users.
  128. - Calling ``.apply_async`` on an empty chain now works again (Issue #1650).
  129. - The ``celery multi show`` command now generates the same arguments
  130. as the start command does.
  131. - The ``--app`` argument could end up using a module object instead
  132. of an app instance (with a resulting crash).
  133. - Fixed a syntax error problem in the celerybeat init script.
  134. Fix contributed by Vsevolod.
  135. - Tests now passing on PyPy 2.1 and 2.2.
  136. .. _version-3.1.3:
  137. 3.1.3
  138. =====
  139. :release-date: 2013-11-13 12:55 A.M UTC
  140. :release-by: Ask Solem
  141. - Fixed compatibility problem with Python 2.7.0 - 2.7.5 (Issue #1637)
  142. ``unpack_from`` started supporting ``memoryview`` arguments
  143. in Python 2.7.6.
  144. - Worker: :option:`-B` argument accidentally closed files used
  145. for logging.
  146. - Task decorated tasks now keep their docstring (Issue #1636)
  147. .. _version-3.1.2:
  148. 3.1.2
  149. =====
  150. :release-date: 2013-11-12 08:00 P.M UTC
  151. :release-by: Ask Solem
  152. - Now depends on :mod:`billiard` 3.3.0.6
  153. - No longer needs the billiard C extension to be installed.
  154. - The worker silently ignored task errors.
  155. - Django: Fixed ``ImproperlyConfigured`` error raised
  156. when no database backend specified.
  157. Fix contributed by j0hnsmith
  158. - Prefork pool: Now using ``_multiprocessing.read`` with ``memoryview``
  159. if available.
  160. - ``close_open_fds`` now uses ``os.closerange`` if available.
  161. - ``get_fdmax`` now takes value from ``sysconfig`` if possible.
  162. .. _version-3.1.1:
  163. 3.1.1
  164. =====
  165. :release-date: 2013-11-11 06:30 P.M UTC
  166. :release-by: Ask Solem
  167. - Now depends on :mod:`billiard` 3.3.0.4.
  168. - Python 3: Fixed compatibility issues.
  169. - Windows: Accidentally showed warning that the billiard C extension
  170. was not installed (Issue #1630).
  171. - Django: Tutorial updated with a solution that sets a default
  172. :envvar:`DJANGO_SETTINGS_MODULE` so that it doesn't have to be typed
  173. in with the :program:`celery` command.
  174. Also fixed typos in the tutorial, and added the settings
  175. required to use the Django database backend.
  176. Thanks to Chris Ward, orarbel.
  177. - Django: Fixed a problem when using the Django settings in Django 1.6.
  178. - Django: Fixup should not be applied if the django loader is active.
  179. - Worker: Fixed attribute error for ``human_write_stats`` when using the
  180. compatibility prefork pool implementation.
  181. - Worker: Fixed compatibility with billiard without C extension.
  182. - Inspect.conf: Now supports a ``with_defaults`` argument.
  183. - Group.restore: The backend argument was not respected.
  184. .. _version-3.1.0:
  185. 3.1.0
  186. =======
  187. :release-date: 2013-11-09 11:00 P.M UTC
  188. :release-by: Ask Solem
  189. See :ref:`whatsnew-3.1`.