changelog-3.0.rst 48 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605
  1. .. _changelog-3.0:
  2. ===============================
  3. Change history for Celery 3.0
  4. ===============================
  5. .. contents::
  6. :local:
  7. If you're looking for versions prior to 3.0.x you should go to :ref:`history`.
  8. .. _version-3.0.24:
  9. 3.0.24
  10. ======
  11. :release-date: 2013-10-11 04:40 p.m. BST
  12. :release-by: Ask Solem
  13. - Now depends on :ref:`Kombu 2.5.15 <kombu:version-2.5.15>`.
  14. - Now depends on :pypi:`billiard` version 2.7.3.34.
  15. - AMQP Result backend: No longer caches queue declarations.
  16. The queues created by the AMQP result backend are always unique,
  17. so caching the declarations caused a slow memory leak.
  18. - Worker: Fixed crash when hostname contained Unicode characters.
  19. Contributed by Daodao.
  20. - The worker would no longer start if the `-P solo` pool was selected
  21. (Issue #1548).
  22. - Redis/Cache result backends wouldn't complete chords
  23. if any of the tasks were retried (Issue #1401).
  24. - Task decorator is no longer lazy if app is finalized.
  25. - AsyncResult: Fixed bug with ``copy(AsyncResult)`` when no
  26. ``current_app`` available.
  27. - ResultSet: Now properly propagates app when passed string id's.
  28. - Loader now ignores :envvar:`CELERY_CONFIG_MODULE` if value is empty string.
  29. - Fixed race condition in Proxy object where it tried to
  30. delete an attribute twice, resulting in :exc:`AttributeError`.
  31. - Task methods now works with the :setting:`CELERY_ALWAYS_EAGER` setting
  32. (Issue #1478).
  33. - :class:`~kombu.common.Broadcast` queues were accidentally declared
  34. when publishing tasks (Issue #1540).
  35. - New :envvar:`C_FAKEFORK` environment variable can be used to
  36. debug the init-scripts.
  37. Setting this will skip the daemonization step so that errors
  38. printed to stderr after standard outs are closed can be seen:
  39. .. code-block:: console
  40. $ C_FAKEFORK /etc/init.d/celeryd start
  41. This works with the `celery multi` command in general.
  42. - ``get_pickleable_etype`` didn't always return a value (Issue #1556).
  43. - Fixed bug where ``app.GroupResult.restore`` would fall back to the default
  44. app.
  45. - Fixed rare bug where built-in tasks would use the current_app.
  46. - :func:`~celery.platforms.maybe_fileno` now handles :exc:`ValueError`.
  47. .. _version-3.0.23:
  48. 3.0.23
  49. ======
  50. :release-date: 2013-09-02 01:00 p.m. BST
  51. :release-by: Ask Solem
  52. - Now depends on :ref:`Kombu 2.5.14 <kombu:version-2.5.14>`.
  53. - ``send_task`` didn't honor ``link`` and ``link_error`` arguments.
  54. This had the side effect of chains not calling unregistered tasks,
  55. silently discarding them.
  56. Fix contributed by Taylor Nelson.
  57. - :mod:`celery.state`: Optimized precedence lookup.
  58. Contributed by Matt Robenolt.
  59. - POSIX: Daemonization didn't redirect ``sys.stdin`` to ``/dev/null``.
  60. Fix contributed by Alexander Smirnov.
  61. - Canvas: group bug caused fallback to default app when ``.apply_async`` used
  62. (Issue #1516)
  63. - Canvas: generator arguments wasn't always pickleable.
  64. .. _version-3.0.22:
  65. 3.0.22
  66. ======
  67. :release-date: 2013-08-16 04:30 p.m. BST
  68. :release-by: Ask Solem
  69. - Now depends on :ref:`Kombu 2.5.13 <kombu:version-2.5.13>`.
  70. - Now depends on :pypi:`billiard` 2.7.3.32
  71. - Fixed bug with monthly and yearly Crontabs (Issue #1465).
  72. Fix contributed by Guillaume Gauvrit.
  73. - Fixed memory leak caused by time limits (Issue #1129, Issue #1427)
  74. - Worker will now sleep if being restarted more than 5 times
  75. in one second to avoid spamming with ``worker-online`` events.
  76. - Includes documentation fixes
  77. Contributed by: Ken Fromm, Andreas Savvides, Alex Kiriukha,
  78. Michael Fladischer.
  79. .. _version-3.0.21:
  80. 3.0.21
  81. ======
  82. :release-date: 2013-07-05 04:30 p.m. BST
  83. :release-by: Ask Solem
  84. - Now depends on :pypi:`billiard` 2.7.3.31.
  85. This version fixed a bug when running without the billiard C extension.
  86. - 3.0.20 broke eventlet/gevent support (worker not starting).
  87. - Fixed memory leak problem when MongoDB result backend was used with the
  88. gevent pool.
  89. Fix contributed by Ross Lawley.
  90. .. _version-3.0.20:
  91. 3.0.20
  92. ======
  93. :release-date: 2013-06-28 04:00 p.m. BST
  94. :release-by: Ask Solem
  95. - Contains workaround for deadlock problems.
  96. A better solution will be part of Celery 3.1.
  97. - Now depends on :ref:`Kombu 2.5.12 <kombu:version-2.5.12>`.
  98. - Now depends on :pypi:`billiard` 2.7.3.30.
  99. - :option:`--loader <celery --loader>` argument no longer supported
  100. importing loaders from the current directory.
  101. - [Worker] Fixed memory leak when restarting after connection lost
  102. (Issue #1325).
  103. - [Worker] Fixed UnicodeDecodeError at start-up (Issue #1373).
  104. Fix contributed by Jessica Tallon.
  105. - [Worker] Now properly rewrites unpickleable exceptions again.
  106. - Fixed possible race condition when evicting items from the revoked task set.
  107. - [generic-init.d] Fixed compatibility with Ubuntu's minimal Dash
  108. shell (Issue #1387).
  109. Fix contributed by :github_user:`monkut`.
  110. - ``Task.apply``/``ALWAYS_EAGER`` now also executes callbacks and errbacks
  111. (Issue #1336).
  112. - [Worker] The :signal:`worker-shutdown` signal was no longer being dispatched
  113. (Issue #1339)j
  114. - [Python 3] Fixed problem with threading.Event.
  115. Fix contributed by Xavier Ordoquy.
  116. - [Python 3] Now handles ``io.UnsupportedOperation`` that may be raised
  117. by ``file.fileno()`` in Python 3.
  118. - [Python 3] Fixed problem with ``qualname``.
  119. - [events.State] Now ignores unknown event-groups.
  120. - [MongoDB backend] No longer uses deprecated ``safe`` parameter.
  121. Fix contributed by :github_user:`rfkrocktk`.
  122. - The eventlet pool now imports on Windows.
  123. - [Canvas] Fixed regression where immutable chord members may receive
  124. arguments (Issue #1340).
  125. Fix contributed by Peter Brook.
  126. - [Canvas] chain now accepts generator argument again (Issue #1319).
  127. - ``celery.migrate`` command now consumes from all queues if no queues
  128. specified.
  129. Fix contributed by John Watson.
  130. .. _version-3.0.19:
  131. 3.0.19
  132. ======
  133. :release-date: 2013-04-17 04:30:00 p.m. BST
  134. :release-by: Ask Solem
  135. - Now depends on :pypi:`billiard` 2.7.3.28
  136. - A Python 3 related fix managed to disable the deadlock fix
  137. announced in 3.0.18.
  138. Tests have been added to make sure this doesn't happen again.
  139. - Task retry policy: Default max_retries is now 3.
  140. This ensures clients won't be hanging while the broker is down.
  141. .. note::
  142. You can set a longer retry for the worker by
  143. using the :signal:`celeryd_after_setup` signal:
  144. .. code-block:: python
  145. from celery.signals import celeryd_after_setup
  146. @celeryd_after_setup.connect
  147. def configure_worker(instance, conf, **kwargs):
  148. conf.CELERY_TASK_PUBLISH_RETRY_POLICY = {
  149. 'max_retries': 100,
  150. 'interval_start': 0,
  151. 'interval_max': 1,
  152. 'interval_step': 0.2,
  153. }
  154. - Worker: Will now properly display message body in error messages
  155. even if the body is a buffer instance.
  156. - 3.0.18 broke the MongoDB result backend (Issue #1303).
  157. .. _version-3.0.18:
  158. 3.0.18
  159. ======
  160. :release-date: 2013-04-12 05:00:00 p.m. BST
  161. :release-by: Ask Solem
  162. - Now depends on :pypi:`kombu` 2.5.10.
  163. See the :ref:`kombu changelog <kombu:version-2.5.10>`.
  164. - Now depends on :pypi:`billiard` 2.7.3.27.
  165. - Can now specify a white-list of accepted serializers using
  166. the new :setting:`CELERY_ACCEPT_CONTENT` setting.
  167. This means that you can force the worker to discard messages
  168. serialized with pickle and other untrusted serializers.
  169. For example to only allow JSON serialized messages use::
  170. CELERY_ACCEPT_CONTENT = ['json']
  171. you can also specify MIME types in the white-list::
  172. CELERY_ACCEPT_CONTENT = ['application/json']
  173. - Fixed deadlock in multiprocessing's pool caused by the
  174. semaphore not being released when terminated by signal.
  175. - Processes Pool: It's now possible to debug pool processes using GDB.
  176. - ``celery report`` now censors possibly secret settings, like passwords
  177. and secret tokens.
  178. You should still check the output before pasting anything
  179. on the internet.
  180. - Connection URLs now ignore multiple '+' tokens.
  181. - Worker/``statedb``: Now uses pickle protocol 2 (Python 2.5+)
  182. - Fixed Python 3 compatibility issues.
  183. - Worker: A warning is now given if a worker is started with the
  184. same node name as an existing worker.
  185. - Worker: Fixed a deadlock that could occur while revoking tasks (Issue #1297).
  186. - Worker: The :sig:`HUP` handler now closes all open file descriptors
  187. before restarting to ensure file descriptors doesn't leak (Issue #1270).
  188. - Worker: Optimized storing/loading the revoked tasks list (Issue #1289).
  189. After this change the :option:`celery worker --statedb` file will
  190. take up more disk space, but loading from and storing the revoked
  191. tasks will be considerably faster (what before took 5 minutes will
  192. now take less than a second).
  193. - Celery will now suggest alternatives if there's a typo in the
  194. broker transport name (e.g., ``ampq`` -> ``amqp``).
  195. - Worker: The auto-reloader would cause a crash if a monitored file
  196. was unlinked.
  197. Fix contributed by Agris Ameriks.
  198. - Fixed AsyncResult pickling error.
  199. Fix contributed by Thomas Minor.
  200. - Fixed handling of Unicode in logging output when using log colors
  201. (Issue #427).
  202. - :class:`~celery.app.utils.ConfigurationView` is now a ``MutableMapping``.
  203. Contributed by Aaron Harnly.
  204. - Fixed memory leak in LRU cache implementation.
  205. Fix contributed by Romuald Brunet.
  206. - ``celery.contrib.rdb``: Now works when sockets are in non-blocking mode.
  207. Fix contributed by Theo Spears.
  208. - The `inspect reserved` remote control command included active (started) tasks
  209. with the reserved tasks (Issue #1030).
  210. - The :signal:`task_failure` signal received a modified traceback object
  211. meant for pickling purposes, this has been fixed so that it now
  212. receives the real traceback instead.
  213. - The ``@task`` decorator silently ignored positional arguments,
  214. it now raises the expected :exc:`TypeError` instead (Issue #1125).
  215. - The worker will now properly handle messages with invalid
  216. ETA/expires fields (Issue #1232).
  217. - The ``pool_restart`` remote control command now reports
  218. an error if the :setting:`CELERYD_POOL_RESTARTS` setting isn't set.
  219. - :meth:`@add_defaults`` can now be used with non-dict objects.
  220. - Fixed compatibility problems in the Proxy class (Issue #1087).
  221. The class attributes ``__module__``, ``__name__`` and ``__doc__``
  222. are now meaningful string objects.
  223. Thanks to Marius Gedminas.
  224. - MongoDB Backend: The :setting:`MONGODB_BACKEND_SETTINGS` setting
  225. now accepts a ``option`` key that lets you forward arbitrary kwargs
  226. to the underlying ``pymongo.Connection`` object (Issue #1015).
  227. - Beat: The daily backend cleanup task is no longer enabled
  228. for result backends that support automatic result expiration (Issue #1031).
  229. - Canvas list operations now takes application instance from the first
  230. task in the list, instead of depending on the ``current_app`` (Issue #1249).
  231. - Worker: Message decoding error log message now includes traceback
  232. information.
  233. - Worker: The start-up banner now includes system platform.
  234. - ``celery inspect|status|control`` now gives an error if used
  235. with a SQL based broker transport.
  236. .. _version-3.0.17:
  237. 3.0.17
  238. ======
  239. :release-date: 2013-03-22 04:00:00 p.m. UTC
  240. :release-by: Ask Solem
  241. - Now depends on kombu 2.5.8
  242. - Now depends on billiard 2.7.3.23
  243. - RabbitMQ/Redis: thread-less and lock-free rate-limit implementation.
  244. This means that rate limits pose minimal overhead when used with
  245. RabbitMQ/Redis or future transports using the event-loop,
  246. and that the rate-limit implementation is now thread-less and lock-free.
  247. The thread-based transports will still use the old implementation for
  248. now, but the plan is to use the timer also for other
  249. broker transports in Celery 3.1.
  250. - Rate limits now works with eventlet/gevent if using RabbitMQ/Redis as the
  251. broker.
  252. - A regression caused ``task.retry`` to ignore additional keyword arguments.
  253. Extra keyword arguments are now used as execution options again.
  254. Fix contributed by Simon Engledew.
  255. - Windows: Fixed problem with the worker trying to pickle the Django settings
  256. module at worker start-up.
  257. - generic-init.d: No longer double quotes ``$CELERYD_CHDIR`` (Issue #1235).
  258. - generic-init.d: Removes bash-specific syntax.
  259. Fix contributed by Pär Wieslander.
  260. - Cassandra Result Backend: Now handles the
  261. :exc:`~pycassa.AllServersUnavailable` error (Issue #1010).
  262. Fix contributed by Jared Biel.
  263. - Result: Now properly forwards apps to GroupResults when deserializing
  264. (Issue #1249).
  265. Fix contributed by Charles-Axel Dein.
  266. - ``GroupResult.revoke`` now supports the ``terminate`` and ``signal``
  267. keyword arguments.
  268. - Worker: Multiprocessing pool workers now import task modules/configuration
  269. before setting up the logging system so that logging signals can be
  270. connected before they're dispatched.
  271. - chord: The ``AsyncResult`` instance returned now has its ``parent``
  272. attribute set to the header ``GroupResult``.
  273. This is consistent with how ``chain`` works.
  274. .. _version-3.0.16:
  275. 3.0.16
  276. ======
  277. :release-date: 2013-03-07 04:00:00 p.m. UTC
  278. :release-by: Ask Solem
  279. - Happy International Women's Day!
  280. We have a long way to go, so this is a chance for you to get involved in one
  281. of the organizations working for making our communities more
  282. diverse.
  283. - PyLadies — http://pyladies.com
  284. - Girls Who Code — http://www.girlswhocode.com
  285. - Women Who Code — http://www.meetup.com/Women-Who-Code-SF/
  286. - Now depends on :pypi:`kombu` version 2.5.7
  287. - Now depends on :pypi:`billiard` version 2.7.3.22
  288. - AMQP heartbeats are now disabled by default.
  289. Some users experiences issues with heartbeats enabled,
  290. and it's not strictly necessary to use them.
  291. If you're experiencing problems detecting connection failures,
  292. you can re-enable heartbeats by configuring the :setting:`BROKER_HEARTBEAT`
  293. setting.
  294. - Worker: Now propagates connection errors occurring in multiprocessing
  295. callbacks, so that the connection can be reset (Issue #1226).
  296. - Worker: Now propagates connection errors occurring in timer callbacks,
  297. so that the connection can be reset.
  298. - The modules in :setting:`CELERY_IMPORTS` and :setting:`CELERY_INCLUDE`
  299. are now imported in the original order (Issue #1161).
  300. The modules in :setting:`CELERY_IMPORTS` will be imported first,
  301. then continued by :setting:`CELERY_INCLUDE`.
  302. Thanks to Joey Wilhelm.
  303. - New bash completion for ``celery`` available in the git repository:
  304. https://github.com/celery/celery/tree/3.0/extra/bash-completion
  305. You can source this file or put it in ``bash_completion.d`` to
  306. get auto-completion for the ``celery`` command-line utility.
  307. - The node name of a worker can now include unicode characters (Issue #1186).
  308. - The repr of a ``crontab`` object now displays correctly (Issue #972).
  309. - ``events.State`` no longer modifies the original event dictionary.
  310. - No longer uses ``Logger.warn`` deprecated in Python 3.
  311. - Cache Backend: Now works with chords again (Issue #1094).
  312. - Chord unlock now handles errors occurring while calling the callback.
  313. - Generic worker init.d script: Status check is now performed by
  314. querying the pid of the instance instead of sending messages.
  315. Contributed by Milen Pavlov.
  316. - Improved init-scripts for CentOS.
  317. - Updated to support Celery 3.x conventions.
  318. - Now uses CentOS built-in ``status`` and ``killproc``
  319. - Support for multi-node / multi-pid worker services.
  320. - Standard color-coded CentOS service-init output.
  321. - A test suite.
  322. Contributed by Milen Pavlov.
  323. - ``ResultSet.join`` now always works with empty result set (Issue #1219).
  324. - A ``group`` consisting of a single task is now supported (Issue #1219).
  325. - Now supports the ``pycallgraph`` program (Issue #1051).
  326. - Fixed Jython compatibility problems.
  327. - Django tutorial: Now mentions that the example app must be added to
  328. ``INSTALLED_APPS`` (Issue #1192).
  329. .. _version-3.0.15:
  330. 3.0.15
  331. ======
  332. :release-date: 2013-02-11 04:30:00 p.m. UTC
  333. :release-by: Ask Solem
  334. - Now depends on billiard 2.7.3.21 which fixed a syntax error crash.
  335. - Fixed bug with :setting:`CELERY_SEND_TASK_SENT_EVENT`.
  336. .. _version-3.0.14:
  337. 3.0.14
  338. ======
  339. :release-date: 2013-02-08 05:00:00 p.m. UTC
  340. :release-by: Ask Solem
  341. - Now depends on Kombu 2.5.6
  342. - Now depends on billiard 2.7.3.20
  343. - ``execv`` is now disabled by default.
  344. It was causing too many problems for users, you can still enable
  345. it using the `CELERYD_FORCE_EXECV` setting.
  346. execv was only enabled when transports other than AMQP/Redis was used,
  347. and it's there to prevent deadlocks caused by mutexes not being released
  348. before the process forks. Unfortunately it also changes the environment
  349. introducing many corner case bugs that're hard to fix without adding
  350. horrible hacks. Deadlock issues are reported far less often than the
  351. bugs that execv are causing, so we now disable it by default.
  352. Work is in motion to create non-blocking versions of these transports
  353. so that execv isn't necessary (which is the situation with the amqp
  354. and redis broker transports)
  355. - Chord exception behavior defined (Issue #1172).
  356. From Celery 3.1 the chord callback will change state to FAILURE
  357. when a task part of a chord raises an exception.
  358. It was never documented what happens in this case,
  359. and the actual behavior was very unsatisfactory, indeed
  360. it will just forward the exception value to the chord callback.
  361. For backward compatibility reasons we don't change to the new
  362. behavior in a bugfix release, even if the current behavior was
  363. never documented. Instead you can enable the
  364. :setting:`CELERY_CHORD_PROPAGATES` setting to get the new behavior
  365. that'll be default from Celery 3.1.
  366. See more at :ref:`chord-errors`.
  367. - worker: Fixes bug with ignored and retried tasks.
  368. The ``on_chord_part_return`` and ``Task.after_return`` callbacks,
  369. nor the ``task_postrun`` signal should be called when the task was
  370. retried/ignored.
  371. Fix contributed by Vlad.
  372. - ``GroupResult.join_native`` now respects the ``propagate`` argument.
  373. - ``subtask.id`` added as an alias to ``subtask['options'].id``
  374. .. code-block:: pycon
  375. >>> s = add.s(2, 2)
  376. >>> s.id = 'my-id'
  377. >>> s['options']
  378. {'task_id': 'my-id'}
  379. >>> s.id
  380. 'my-id'
  381. - worker: Fixed error `Could not start worker processes` occurring
  382. when restarting after connection failure (Issue #1118).
  383. - Adds new signal :signal:`task-retried` (Issue #1169).
  384. - `celery events --dumper` now handles connection loss.
  385. - Will now retry sending the task-sent event in case of connection failure.
  386. - amqp backend: Now uses ``Message.requeue`` instead of republishing
  387. the message after poll.
  388. - New :setting:`BROKER_HEARTBEAT_CHECKRATE` setting introduced to modify the
  389. rate at which broker connection heartbeats are monitored.
  390. The default value was also changed from 3.0 to 2.0.
  391. - :class:`celery.events.state.State` is now pickleable.
  392. Fix contributed by Mher Movsisyan.
  393. - :class:`celery.utils.functional.LRUCache` is now pickleable.
  394. Fix contributed by Mher Movsisyan.
  395. - The stats broadcast command now includes the workers pid.
  396. Contributed by Mher Movsisyan.
  397. - New ``conf`` remote control command to get a workers current configuration.
  398. Contributed by Mher Movsisyan.
  399. - Adds the ability to modify the chord unlock task's countdown
  400. argument (Issue #1146).
  401. Contributed by Jun Sakai
  402. - beat: The scheduler now uses the `now()`` method of the schedule,
  403. so that schedules can provide a custom way to get the current date and time.
  404. Contributed by Raphaël Slinckx
  405. - Fixed pickling of configuration modules on Windows or when execv is used
  406. (Issue #1126).
  407. - Multiprocessing logger is now configured with loglevel ``ERROR``
  408. by default.
  409. Since 3.0 the multiprocessing loggers were disabled by default
  410. (only configured when the :envvar:`MP_LOG` environment variable was set).
  411. .. _version-3.0.13:
  412. 3.0.13
  413. ======
  414. :release-date: 2013-01-07 04:00:00 p.m. UTC
  415. :release-by: Ask Solem
  416. - Now depends on Kombu 2.5
  417. - :pypi:`amqp` has replaced :pypi:`amqplib` as the default transport,
  418. gaining support for AMQP 0.9, and the RabbitMQ extensions,
  419. including Consumer Cancel Notifications and heartbeats.
  420. - support for multiple connection URLs for failover.
  421. - Read more in the :ref:`Kombu 2.5 changelog <kombu:version-2.5.0>`.
  422. - Now depends on billiard 2.7.3.19
  423. - Fixed a deadlock issue that could occur when the producer pool
  424. inherited the connection pool instance of the parent process.
  425. - The :option:`--loader <celery --loader>` option now works again (Issue #1066).
  426. - :program:`celery` umbrella command: All sub-commands now supports
  427. the :option:`--workdir <celery --workdir>` option (Issue #1063).
  428. - Groups included in chains now give GroupResults (Issue #1057)
  429. Previously it would incorrectly add a regular result instead of a group
  430. result, but now this works:
  431. .. code-block:: pycon
  432. >>> # [4 + 4, 4 + 8, 16 + 8]
  433. >>> res = (add.s(2, 2) | group(add.s(4), add.s(8), add.s(16)))()
  434. >>> res
  435. <GroupResult: a0acf905-c704-499e-b03a-8d445e6398f7 [
  436. 4346501c-cb99-4ad8-8577-12256c7a22b1,
  437. b12ead10-a622-4d44-86e9-3193a778f345,
  438. 26c7a420-11f3-4b33-8fac-66cd3b62abfd]>
  439. - Chains can now chain other chains and use partial arguments (Issue #1057).
  440. Example:
  441. .. code-block:: pycon
  442. >>> c1 = (add.s(2) | add.s(4))
  443. >>> c2 = (add.s(8) | add.s(16))
  444. >>> c3 = (c1 | c2)
  445. >>> # 8 + 2 + 4 + 8 + 16
  446. >>> assert c3(8).get() == 38
  447. - Subtasks can now be used with unregistered tasks.
  448. You can specify subtasks even if you just have the name::
  449. >>> s = subtask(task_name, args=(), kwargs=())
  450. >>> s.delay()
  451. - The :program:`celery shell` command now always adds the current
  452. directory to the module path.
  453. - The worker will now properly handle the :exc:`pytz.AmbiguousTimeError`
  454. exception raised when an ETA/countdown is prepared while being in DST
  455. transition (Issue #1061).
  456. - force_execv: Now makes sure that task symbols in the original
  457. task modules will always use the correct app instance (Issue #1072).
  458. - AMQP Backend: Now republishes result messages that have been polled
  459. (using ``result.ready()`` and friends, ``result.get()`` won't do this
  460. in this version).
  461. - Crontab schedule values can now "wrap around"
  462. This means that values like ``11-1`` translates to ``[11, 12, 1]``.
  463. Contributed by Loren Abrams.
  464. - ``multi stopwait`` command now shows the pid of processes.
  465. Contributed by Loren Abrams.
  466. - Handling of ETA/countdown fixed when the :setting:`CELERY_ENABLE_UTC`
  467. setting is disabled (Issue #1065).
  468. - A number of unneeded properties were included in messages,
  469. caused by accidentally passing ``Queue.as_dict`` as message properties.
  470. - Rate limit values can now be float
  471. This also extends the string format so that values like ``"0.5/s"`` works.
  472. Contributed by Christoph Krybus
  473. - Fixed a typo in the broadcast routing documentation (Issue #1026).
  474. - Rewrote confusing section about idempotence in the task user guide.
  475. - Fixed typo in the daemonization tutorial (Issue #1055).
  476. - Fixed several typos in the documentation.
  477. Contributed by Marius Gedminas.
  478. - Batches: Now works when using the eventlet pool.
  479. Fix contributed by Thomas Grainger.
  480. - Batches: Added example sending results to ``celery.contrib.batches``.
  481. Contributed by Thomas Grainger.
  482. - MongoDB backend: Connection ``max_pool_size`` can now be set in
  483. :setting:`CELERY_MONGODB_BACKEND_SETTINGS`.
  484. Contributed by Craig Younkins.
  485. - Fixed problem when using earlier versions of :pypi:`pytz`.
  486. Fix contributed by Vlad.
  487. - Docs updated to include the default value for the
  488. :setting:`CELERY_TASK_RESULT_EXPIRES` setting.
  489. - Improvements to the :pypi:`django-celery` tutorial.
  490. Contributed by Locker537.
  491. - The ``add_consumer`` control command didn't properly persist
  492. the addition of new queues so that they survived connection failure
  493. (Issue #1079).
  494. 3.0.12
  495. ======
  496. :release-date: 2012-11-06 02:00 p.m. UTC
  497. :release-by: Ask Solem
  498. - Now depends on kombu 2.4.8
  499. - [Redis] New and improved fair queue cycle algorithm (Kevin McCarthy).
  500. - [Redis] Now uses a Redis-based mutex when restoring messages.
  501. - [Redis] Number of messages that can be restored in one interval is no
  502. longer limited (but can be set using the
  503. ``unacked_restore_limit``
  504. :setting:`transport option <BROKER_TRANSPORT_OPTIONS>`).
  505. - Heartbeat value can be specified in broker URLs (Mher Movsisyan).
  506. - Fixed problem with msgpack on Python 3 (Jasper Bryant-Greene).
  507. - Now depends on billiard 2.7.3.18
  508. - Celery can now be used with static analysis tools like PyDev/PyCharm/pylint
  509. etc.
  510. - Development documentation has moved to Read The Docs.
  511. The new URL is: http://docs.celeryproject.org/en/master
  512. - New :setting:`CELERY_QUEUE_HA_POLICY` setting used to set the default
  513. HA policy for queues when using RabbitMQ.
  514. - New method ``Task.subtask_from_request`` returns a subtask using the current
  515. request.
  516. - Results get_many method didn't respect timeout argument.
  517. Fix contributed by Remigiusz Modrzejewski
  518. - generic_init.d scripts now support setting :envvar:`CELERY_CREATE_DIRS` to
  519. always create log and pid directories (Issue #1045).
  520. This can be set in your :file:`/etc/default/celeryd`.
  521. - Fixed strange kombu import problem on Python 3.2 (Issue #1034).
  522. - Worker: ETA scheduler now uses millisecond precision (Issue #1040).
  523. - The :option:`--config <celery --config>` argument to programs is
  524. now supported by all loaders.
  525. - The :setting:`CASSANDRA_OPTIONS` setting has now been documented.
  526. Contributed by Jared Biel.
  527. - Task methods (:mod:`celery.contrib.methods`) cannot be used with the old
  528. task base class, the task decorator in that module now inherits from the new.
  529. - An optimization was too eager and caused some logging messages to never emit.
  530. - ``celery.contrib.batches`` now works again.
  531. - Fixed missing white-space in ``bdist_rpm`` requirements (Issue #1046).
  532. - Event state's ``tasks_by_name`` applied limit before filtering by name.
  533. Fix contributed by Alexander A. Sosnovskiy.
  534. .. _version-3.0.11:
  535. 3.0.11
  536. ======
  537. :release-date: 2012-09-26 04:00 p.m. UTC
  538. :release-by: Ask Solem
  539. - [security:low] generic-init.d scripts changed permissions of /var/log & /var/run
  540. In the daemonization tutorial the recommended directories were as follows:
  541. .. code-block:: bash
  542. CELERYD_LOG_FILE="/var/log/celery/%n.log"
  543. CELERYD_PID_FILE="/var/run/celery/%n.pid"
  544. But in the scripts themselves the default files were ``/var/log/celery%n.log``
  545. and ``/var/run/celery%n.pid``, so if the user didn't change the location
  546. by configuration, the directories ``/var/log`` and ``/var/run`` would be
  547. created - and worse have their permissions and owners changed.
  548. This change means that:
  549. - Default pid file is ``/var/run/celery/%n.pid``
  550. - Default log file is ``/var/log/celery/%n.log``
  551. - The directories are only created and have their permissions
  552. changed if *no custom locations are set*.
  553. Users can force paths to be created by calling the ``create-paths``
  554. sub-command:
  555. .. code-block:: console
  556. $ sudo /etc/init.d/celeryd create-paths
  557. .. admonition:: Upgrading Celery won't update init-scripts
  558. To update the init-scripts you have to re-download
  559. the files from source control and update them manually.
  560. You can find the init-scripts for version 3.0.x at:
  561. https://github.com/celery/celery/tree/3.0/extra/generic-init.d
  562. - Now depends on billiard 2.7.3.17
  563. - Fixes request stack protection when app is initialized more than
  564. once (Issue #1003).
  565. - ETA tasks now properly works when system timezone isn't same
  566. as the configured timezone (Issue #1004).
  567. - Terminating a task now works if the task has been sent to the
  568. pool but not yet acknowledged by a pool process (Issue #1007).
  569. Fix contributed by Alexey Zatelepin
  570. - Terminating a task now properly updates the state of the task to revoked,
  571. and sends a ``task-revoked`` event.
  572. - Generic worker init-script now waits for workers to shutdown by default.
  573. - Multi: No longer parses --app option (Issue #1008).
  574. - Multi: ``stop_verify`` command renamed to ``stopwait``.
  575. - Daemonization: Now delays trying to create pidfile/logfile until after
  576. the working directory has been changed into.
  577. - :program:`celery worker` and :program:`celery beat` commands now respects
  578. the :option:`--no-color <celery --no-color>` option (Issue #999).
  579. - Fixed typos in eventlet examples (Issue #1000)
  580. Fix contributed by Bryan Bishop.
  581. Congratulations on opening bug #1000!
  582. - Tasks that raise :exc:`~celery.exceptions.Ignore` are now acknowledged.
  583. - Beat: Now shows the name of the entry in ``sending due task`` logs.
  584. .. _version-3.0.10:
  585. 3.0.10
  586. ======
  587. :release-date: 2012-09-20 05:30 p.m. BST
  588. :release-by: Ask Solem
  589. - Now depends on kombu 2.4.7
  590. - Now depends on billiard 2.7.3.14
  591. - Fixes crash at start-up when using Django and pre-1.4 projects
  592. (``setup_environ``).
  593. - Hard time limits now sends the KILL signal shortly after TERM,
  594. to terminate processes that have signal handlers blocked by C extensions.
  595. - Billiard now installs even if the C extension cannot be built.
  596. It's still recommended to build the C extension if you're using
  597. a transport other than RabbitMQ/Redis (or use forced execv for some
  598. other reason).
  599. - Pool now sets a ``current_process().index`` attribute that can be used to create
  600. as many log files as there are processes in the pool.
  601. - Canvas: chord/group/chain no longer modifies the state when called
  602. Previously calling a chord/group/chain would modify the ids of subtasks
  603. so that:
  604. .. code-block:: pycon
  605. >>> c = chord([add.s(2, 2), add.s(4, 4)], xsum.s())
  606. >>> c()
  607. >>> c() <-- call again
  608. at the second time the ids for the tasks would be the same as in the
  609. previous invocation. This is now fixed, so that calling a subtask
  610. won't mutate any options.
  611. - Canvas: Chaining a chord to another task now works (Issue #965).
  612. - Worker: Fixed a bug where the request stack could be corrupted if
  613. relative imports are used.
  614. Problem usually manifested itself as an exception while trying to
  615. send a failed task result (``NoneType does not have id attribute``).
  616. Fix contributed by Sam Cooke.
  617. - Tasks can now raise :exc:`~celery.exceptions.Ignore` to skip updating states
  618. or events after return.
  619. Example:
  620. .. code-block:: python
  621. from celery.exceptions import Ignore
  622. @task
  623. def custom_revokes():
  624. if redis.sismember('tasks.revoked', custom_revokes.request.id):
  625. raise Ignore()
  626. - The worker now makes sure the request/task stacks aren't modified
  627. by the initial ``Task.__call__``.
  628. This would previously be a problem if a custom task class defined
  629. ``__call__`` and also called ``super()``.
  630. - Because of problems the fast local optimization has been disabled,
  631. and can only be enabled by setting the :envvar:`USE_FAST_LOCALS` attribute.
  632. - Worker: Now sets a default socket timeout of 5 seconds at shutdown
  633. so that broken socket reads don't hinder proper shutdown (Issue #975).
  634. - More fixes related to late eventlet/gevent patching.
  635. - Documentation for settings out of sync with reality:
  636. - :setting:`CELERY_TASK_PUBLISH_RETRY`
  637. Documented as disabled by default, but it was enabled by default
  638. since 2.5 as stated by the 2.5 changelog.
  639. - :setting:`CELERY_TASK_PUBLISH_RETRY_POLICY`
  640. The default max_retries had been set to 100, but documented as being
  641. 3, and the interval_max was set to 1 but documented as 0.2.
  642. The default setting are now set to 3 and 0.2 as it was originally
  643. documented.
  644. Fix contributed by Matt Long.
  645. - Worker: Log messages when connection established and lost have been improved.
  646. - The repr of a Crontab schedule value of '0' should be '*' (Issue #972).
  647. - Revoked tasks are now removed from reserved/active state in the worker
  648. (Issue #969)
  649. Fix contributed by Alexey Zatelepin.
  650. - gevent: Now supports hard time limits using ``gevent.Timeout``.
  651. - Documentation: Links to init-scripts now point to the 3.0 branch instead
  652. of the development branch (master).
  653. - Documentation: Fixed typo in signals user guide (Issue #986).
  654. ``instance.app.queues`` -> ``instance.app.amqp.queues``.
  655. - Eventlet/gevent: The worker didn't properly set the custom app
  656. for new greenlets.
  657. - Eventlet/gevent: Fixed a bug where the worker could not recover
  658. from connection loss (Issue #959).
  659. Also, because of a suspected bug in gevent the
  660. :setting:`BROKER_CONNECTION_TIMEOUT` setting has been disabled
  661. when using gevent
  662. 3.0.9
  663. =====
  664. :release-date: 2012-08-31 06:00 p.m. BST
  665. :release-by: Ask Solem
  666. - Important note for users of Django and the database scheduler!
  667. Recently a timezone issue has been fixed for periodic tasks,
  668. but erroneous timezones could have already been stored in the
  669. database, so for the fix to work you need to reset
  670. the ``last_run_at`` fields.
  671. You can do this by executing the following command:
  672. .. code-block:: console
  673. $ python manage.py shell
  674. >>> from djcelery.models import PeriodicTask
  675. >>> PeriodicTask.objects.update(last_run_at=None)
  676. You also have to do this if you change the timezone or
  677. :setting:`CELERY_ENABLE_UTC` setting.
  678. - Note about the :setting:`CELERY_ENABLE_UTC` setting.
  679. If you previously disabled this just to force periodic tasks to work with
  680. your timezone, then you're now *encouraged to re-enable it*.
  681. - Now depends on Kombu 2.4.5 which fixes PyPy + Jython installation.
  682. - Fixed bug with timezones when :setting:`CELERY_ENABLE_UTC` is disabled
  683. (Issue #952).
  684. - Fixed a typo in the ``celerybeat`` upgrade mechanism (Issue #951).
  685. - Make sure the `exc_info` argument to logging is resolved (Issue #899).
  686. - Fixed problem with Python 3.2 and thread join timeout overflow (Issue #796).
  687. - A test case was occasionally broken for Python 2.5.
  688. - Unit test suite now passes for PyPy 1.9.
  689. - App instances now supports the :keyword:`with` statement.
  690. This calls the new :meth:`@close` method at exit, which
  691. cleans up after the app like closing pool connections.
  692. Note that this is only necessary when dynamically creating apps,
  693. for example "temporary" apps.
  694. - Support for piping a subtask to a chain.
  695. For example:
  696. .. code-block:: python
  697. pipe = sometask.s() | othertask.s()
  698. new_pipe = mytask.s() | pipe
  699. Contributed by Steve Morin.
  700. - Fixed problem with group results on non-pickle serializers.
  701. Fix contributed by Steeve Morin.
  702. .. _version-3.0.8:
  703. 3.0.8
  704. =====
  705. :release-date: 2012-08-29 05:00 p.m. BST
  706. :release-by: Ask Solem
  707. - Now depends on Kombu 2.4.4
  708. - Fixed problem with :pypi:`amqplib` and receiving larger message payloads
  709. (Issue #922).
  710. The problem would manifest itself as either the worker hanging,
  711. or occasionally a ``Framing error`` exception appearing.
  712. Users of the new ``pyamqp://`` transport must upgrade to
  713. :pypi:`amqp` 0.9.3.
  714. - Beat: Fixed another timezone bug with interval and Crontab schedules
  715. (Issue #943).
  716. - Beat: The schedule file is now automatically cleared if the timezone
  717. is changed.
  718. The schedule is also cleared when you upgrade to 3.0.8 from an earlier
  719. version, this to register the initial timezone info.
  720. - Events: The :event:`worker-heartbeat` event now include processed and active
  721. count fields.
  722. Contributed by Mher Movsisyan.
  723. - Fixed error with error email and new task classes (Issue #931).
  724. - ``BaseTask.__call__`` is no longer optimized away if it has been monkey
  725. patched.
  726. - Fixed shutdown issue when using gevent (Issue #911 & Issue #936).
  727. Fix contributed by Thomas Meson.
  728. .. _version-3.0.7:
  729. 3.0.7
  730. =====
  731. :release-date: 2012-08-24 05:00 p.m. BST
  732. :release-by: Ask Solem
  733. - Fixes several problems with periodic tasks and timezones (Issue #937).
  734. - Now depends on kombu 2.4.2
  735. - Redis: Fixes a race condition crash
  736. - Fixes an infinite loop that could happen when retrying establishing
  737. the broker connection.
  738. - Daemons now redirect standard file descriptors to :file:`/dev/null`
  739. Though by default the standard outs are also redirected
  740. to the logger instead, but you can disable this by changing
  741. the :setting:`CELERY_REDIRECT_STDOUTS` setting.
  742. - Fixes possible problems when eventlet/gevent is patched too late.
  743. - ``LoggingProxy`` no longer defines ``fileno()`` (Issue #928).
  744. - Results are now ignored for the chord unlock task.
  745. Fix contributed by Steeve Morin.
  746. - Cassandra backend now works if result expiry is disabled.
  747. Fix contributed by Steeve Morin.
  748. - The traceback object is now passed to signal handlers instead
  749. of the string representation.
  750. Fix contributed by Adam DePue.
  751. - Celery command: Extensions are now sorted by name.
  752. - A regression caused the :event:`task-failed` event to be sent
  753. with the exception object instead of its string representation.
  754. - The worker daemon would try to create the pid file before daemonizing
  755. to catch errors, but this file wasn't immediately released (Issue #923).
  756. - Fixes Jython compatibility.
  757. - ``billiard.forking_enable`` was called by all pools not just the
  758. processes pool, which would result in a useless warning if the billiard
  759. C extensions weren't installed.
  760. .. _version-3.0.6:
  761. 3.0.6
  762. =====
  763. :release-date: 2012-08-17 11:00 p.mp.m. Ask Solem
  764. - Now depends on kombu 2.4.0
  765. - Now depends on billiard 2.7.3.12
  766. - Redis: Celery now tries to restore messages whenever there are no messages
  767. in the queue.
  768. - Crontab schedules now properly respects :setting:`CELERY_TIMEZONE` setting.
  769. It's important to note that Crontab schedules uses UTC time by default
  770. unless this setting is set.
  771. Issue #904 and :pypi:`django-celery` #150.
  772. - ``billiard.enable_forking`` is now only set by the processes pool.
  773. - The transport is now properly shown by :program:`celery report`
  774. (Issue #913).
  775. - The `--app` argument now works if the last part is a module name
  776. (Issue #921).
  777. - Fixed problem with unpickleable exceptions (billiard #12).
  778. - Adds ``task_name`` attribute to ``EagerResult`` which is always
  779. :const:`None` (Issue #907).
  780. - Old Task class in :mod:`celery.task` no longer accepts magic kwargs by
  781. default (Issue #918).
  782. A regression long ago disabled magic kwargs for these, and since
  783. no one has complained about it we don't have any incentive to fix it now.
  784. - The ``inspect reserved`` control command didn't work properly.
  785. - Should now play better with tools for static analysis by explicitly
  786. specifying dynamically created attributes in the :mod:`celery` and
  787. :mod:`celery.task` modules.
  788. - Terminating a task now results in
  789. :exc:`~celery.exceptions.RevokedTaskError` instead of a ``WorkerLostError``.
  790. - ``AsyncResult.revoke`` now accepts ``terminate`` and ``signal`` arguments.
  791. - The :event:`task-revoked` event now includes new fields: ``terminated``,
  792. ``signum``, and ``expired``.
  793. - The argument to :class:`~celery.exceptions.TaskRevokedError` is now one
  794. of the reasons ``revoked``, ``expired`` or ``terminated``.
  795. - Old Task class does no longer use :class:`classmethod` for ``push_request``
  796. and ``pop_request`` (Issue #912).
  797. - ``GroupResult`` now supports the ``children`` attribute (Issue #916).
  798. - ``AsyncResult.collect`` now respects the ``intermediate`` argument
  799. (Issue #917).
  800. - Fixes example task in documentation (Issue #902).
  801. - Eventlet fixed so that the environment is patched as soon as possible.
  802. - eventlet: Now warns if Celery related modules that depends on threads
  803. are imported before eventlet is patched.
  804. - Improved event and camera examples in the monitoring guide.
  805. - Disables celery command setuptools entry-points if the command can't be
  806. loaded.
  807. - Fixed broken ``dump_request`` example in the tasks guide.
  808. .. _version-3.0.5:
  809. 3.0.5
  810. =====
  811. :release-date: 2012-08-01 04:00 p.m. BST
  812. :release-by: Ask Solem
  813. - Now depends on kombu 2.3.1 + billiard 2.7.3.11
  814. - Fixed a bug with the -B option (``cannot pickle thread.lock objects``)
  815. (Issue #894 + Issue #892, + :pypi:`django-celery` #154).
  816. - The :control:`restart_pool` control command now requires the
  817. :setting:`CELERYD_POOL_RESTARTS` setting to be enabled
  818. This change was necessary as the multiprocessing event that the restart
  819. command depends on is responsible for creating many semaphores/file
  820. descriptors, resulting in problems in some environments.
  821. - ``chain.apply`` now passes args to the first task (Issue #889).
  822. - Documented previously secret options to the :pypi:`django-celery` monitor
  823. in the monitoring user guide (Issue #396).
  824. - Old changelog are now organized in separate documents for each series,
  825. see :ref:`history`.
  826. .. _version-3.0.4:
  827. 3.0.4
  828. =====
  829. :release-date: 2012-07-26 07:00 p.m. BST
  830. :release-by: Ask Solem
  831. - Now depends on Kombu 2.3
  832. - New experimental standalone Celery monitor: Flower
  833. See :ref:`monitoring-flower` to read more about it!
  834. Contributed by Mher Movsisyan.
  835. - Now supports AMQP heartbeats if using the new ``pyamqp://`` transport.
  836. - The :pypi:`amqp` transport requires the :pypi:`amqp` library to be installed:
  837. .. code-block:: console
  838. $ pip install amqp
  839. - Then you need to set the transport URL prefix to ``pyamqp://``.
  840. - The default heartbeat value is 10 seconds, but this can be changed using
  841. the :setting:`BROKER_HEARTBEAT` setting::
  842. BROKER_HEARTBEAT = 5.0
  843. - If the broker heartbeat is set to 10 seconds, the heartbeats will be
  844. monitored every 5 seconds (double the heartbeat rate).
  845. See the :ref:`Kombu 2.3 changelog <kombu:version-2.3.0>` for more information.
  846. - Now supports RabbitMQ Consumer Cancel Notifications, using the ``pyamqp://``
  847. transport.
  848. This is essential when running RabbitMQ in a cluster.
  849. See the :ref:`Kombu 2.3 changelog <kombu:version-2.3.0>` for more information.
  850. - Delivery info is no longer passed directly through.
  851. It was discovered that the SQS transport adds objects that can't
  852. be pickled to the delivery info mapping, so we had to go back
  853. to using the white-list again.
  854. Fixing this bug also means that the SQS transport is now working again.
  855. - The semaphore wasn't properly released when a task was revoked (Issue #877).
  856. This could lead to tasks being swallowed and not released until a worker
  857. restart.
  858. Thanks to Hynek Schlawack for debugging the issue.
  859. - Retrying a task now also forwards any linked tasks.
  860. This means that if a task is part of a chain (or linked in some other
  861. way) and that even if the task is retried, then the next task in the chain
  862. will be executed when the retry succeeds.
  863. - Chords: Now supports setting the interval and other keyword arguments
  864. to the chord unlock task.
  865. - The interval can now be set as part of the chord subtasks kwargs::
  866. chord(header)(body, interval=10.0)
  867. - In addition the chord unlock task now honors the Task.default_retry_delay
  868. option, used when none is specified, which also means that the default
  869. interval can also be changed using annotations:
  870. .. code-block:: python
  871. CELERY_ANNOTATIONS = {
  872. 'celery.chord_unlock': {
  873. 'default_retry_delay': 10.0,
  874. }
  875. }
  876. - New :meth:`@add_defaults` method can add new default configuration
  877. dictionaries to the applications configuration.
  878. For example::
  879. config = {'FOO': 10}
  880. app.add_defaults(config)
  881. is the same as ``app.conf.update(config)`` except that data won't be
  882. copied, and that it won't be pickled when the worker spawns child
  883. processes.
  884. In addition the method accepts a callable::
  885. def initialize_config():
  886. # insert heavy stuff that can't be done at import time here.
  887. app.add_defaults(initialize_config)
  888. which means the same as the above except that it won't happen
  889. until the Celery configuration is actually used.
  890. As an example, Celery can lazily use the configuration of a Flask app::
  891. flask_app = Flask()
  892. app = Celery()
  893. app.add_defaults(lambda: flask_app.config)
  894. - Revoked tasks weren't marked as revoked in the result backend (Issue #871).
  895. Fix contributed by Hynek Schlawack.
  896. - Event-loop now properly handles the case when the :manpage:`epoll` poller
  897. object has been closed (Issue #882).
  898. - Fixed syntax error in ``funtests/test_leak.py``
  899. Fix contributed by Catalin Iacob.
  900. - group/chunks: Now accepts empty task list (Issue #873).
  901. - New method names:
  902. - ``Celery.default_connection()`` ➠ :meth:`~@connection_or_acquire`.
  903. - ``Celery.default_producer()`` ➠ :meth:`~@producer_or_acquire`.
  904. The old names still work for backward compatibility.
  905. .. _version-3.0.3:
  906. 3.0.3
  907. =====
  908. :release-date: 2012-07-20 09:17 p.m. BST
  909. :release-by: Ask Solem
  910. - :pypi:`amqplib` passes the channel object as part of the delivery_info
  911. and it's not pickleable, so we now remove it.
  912. .. _version-3.0.2:
  913. 3.0.2
  914. =====
  915. :release-date: 2012-07-20 04:00 p.m. BST
  916. :release-by: Ask Solem
  917. - A bug caused the following task options to not take defaults from the
  918. configuration (Issue #867 + Issue #858)
  919. The following settings were affected:
  920. - :setting:`CELERY_IGNORE_RESULT`
  921. - :setting:`CELERYD_SEND_TASK_ERROR_EMAILS`
  922. - :setting:`CELERY_TRACK_STARTED`
  923. - :setting:`CElERY_STORE_ERRORS_EVEN_IF_IGNORED`
  924. Fix contributed by John Watson.
  925. - Task Request: ``delivery_info`` is now passed through as-is (Issue #807).
  926. - The ETA argument now supports datetime's with a timezone set (Issue #855).
  927. - The worker's banner displayed the autoscale settings in the wrong order
  928. (Issue #859).
  929. - Extension commands are now loaded after concurrency is set up
  930. so that they don't interfere with things like eventlet patching.
  931. - Fixed bug in the threaded pool (Issue #863)
  932. - The task failure handler mixed up the fields in :func:`sys.exc_info`.
  933. Fix contributed by Rinat Shigapov.
  934. - Fixed typos and wording in the docs.
  935. Fix contributed by Paul McMillan
  936. - New setting: :setting:`CELERY_WORKER_DIRECT`
  937. If enabled each worker will consume from their own dedicated queue
  938. which can be used to route tasks to specific workers.
  939. - Fixed several edge case bugs in the add consumer remote control command.
  940. - :mod:`~celery.contrib.migrate`: Can now filter and move tasks to specific
  941. workers if :setting:`CELERY_WORKER_DIRECT` is enabled.
  942. Among other improvements, the following functions have been added:
  943. * ``move_direct(filterfun, **opts)``
  944. * ``move_direct_by_id(task_id, worker_hostname, **opts)``
  945. * ``move_direct_by_idmap({task_id: worker_hostname, ...}, **opts)``
  946. * ``move_direct_by_taskmap({task_name: worker_hostname, ...}, **opts)``
  947. - :meth:`~celery.Celery.default_connection` now accepts a pool argument that
  948. if set to false causes a new connection to be created instead of acquiring
  949. one from the pool.
  950. - New signal: :signal:`celeryd_after_setup`.
  951. - Default loader now keeps lowercase attributes from the configuration module.
  952. .. _version-3.0.1:
  953. 3.0.1
  954. =====
  955. :release-date: 2012-07-10 06:00 p.m. BST
  956. :release-by: Ask Solem
  957. - Now depends on kombu 2.2.5
  958. - inspect now supports limit argument::
  959. myapp.control.inspect(limit=1).ping()
  960. - Beat: now works with timezone aware datetime's.
  961. - Task classes inheriting ``from celery import Task``
  962. mistakenly enabled ``accept_magic_kwargs``.
  963. - Fixed bug in ``inspect scheduled`` (Issue #829).
  964. - Beat: Now resets the schedule to upgrade to UTC.
  965. - The :program:`celery worker` command now works with eventlet/gevent.
  966. Previously it wouldn't patch the environment early enough.
  967. - The :program:`celery` command now supports extension commands
  968. using setuptools entry-points.
  969. Libraries can add additional commands to the :program:`celery`
  970. command by adding an entry-point like::
  971. setup(
  972. entry_points=[
  973. 'celery.commands': [
  974. 'foo = my.module:Command',
  975. ],
  976. ],
  977. ...)
  978. The command must then support the interface of
  979. :class:`celery.bin.base.Command`.
  980. - contrib.migrate: New utilities to move tasks from one queue to another.
  981. - :func:`~celery.contrib.migrate.move_tasks`
  982. - :func:`~celery.contrib.migrate.move_task_by_id`
  983. - The :event:`task-sent` event now contains ``exchange`` and ``routing_key``
  984. fields.
  985. - Fixes bug with installing on Python 3.
  986. Fix contributed by Jed Smith.
  987. .. _version-3.0.0:
  988. 3.0.0 (Chiastic Slide)
  989. ======================
  990. :release-date: 2012-07-07 01:30 p.m. BST
  991. :release-by: Ask Solem
  992. See :ref:`whatsnew-3.0`.