Explorar el Código

Updates branch links

Ask Solem hace 11 años
padre
commit
0a1bd3c0b1
Se han modificado 3 ficheros con 91 adiciones y 92 borrados
  1. 1 0
      docs/contributing.rst
  2. 7 8
      docs/tutorials/daemonizing.rst
  3. 83 84
      docs/whatsnew-3.1.rst

+ 1 - 0
docs/contributing.rst

@@ -234,6 +234,7 @@ Branches
 Current active version branches:
 
 * master (http://github.com/celery/celery/tree/master)
+* 3.1 (http://github.com/celery/celery/tree/3.1)
 * 3.0 (http://github.com/celery/celery/tree/3.0)
 
 You can see the state of any branch by looking at the Changelog:

+ 7 - 8
docs/tutorials/daemonizing.rst

@@ -23,7 +23,7 @@ This directory contains generic bash init scripts for the
 these should run on Linux, FreeBSD, OpenBSD, and other Unix-like platforms.
 
 .. _`extra/generic-init.d/`:
-    http://github.com/celery/celery/tree/3.0/extra/generic-init.d/
+    http://github.com/celery/celery/tree/3.1/extra/generic-init.d/
 
 .. _generic-initd-celeryd:
 
@@ -91,7 +91,6 @@ This is an example configuration for a Python project.
     # and owned by the userid/group configured.
     CELERY_CREATE_DIRS=1
 
-
 .. _generic-initd-celeryd-django-example:
 
 Example Django configuration
@@ -291,7 +290,7 @@ This is an example configuration for a Python project:
     # Absolute or relative path to the 'celery' command:
     CELERY_BIN="/usr/local/bin/celery"
     #CELERY_BIN="/virtualenvs/def/bin/celery"
-    
+
     # How to call manage.py
     CELERYD_MULTI="multi"
 
@@ -319,7 +318,7 @@ This is an example configuration for those using `django-celery`:
 
     # Absolute path to "manage.py"
     CELERY_BIN="/opt/Myproject/manage.py"
-    
+
     # How to call manage.py
     CELERYD_MULTI="celery multi"
 
@@ -330,7 +329,7 @@ This is an example configuration for those using `django-celery`:
     CELERYD_LOG_FILE="/var/log/celery/%N.log"
     CELERYD_PID_FILE="/var/run/celery/%N.pid"
 
-To add an environment variable such as DJANGO_SETTINGS_MODULE use the 
+To add an environment variable such as DJANGO_SETTINGS_MODULE use the
 Environment in celery.service.
 
 .. _generic-initd-troubleshooting:
@@ -375,7 +374,7 @@ you should :ref:`report it <reporting-bugs>`).
 * `extra/supervisord/`_
 
 .. _`extra/supervisord/`:
-    http://github.com/celery/celery/tree/3.0/extra/supervisord/
+    http://github.com/celery/celery/tree/3.1/extra/supervisord/
 .. _`supervisord`: http://supervisord.org/
 
 .. _daemon-launchd:
@@ -386,7 +385,7 @@ launchd (OS X)
 * `extra/mac/`_
 
 .. _`extra/mac/`:
-    http://github.com/celery/celery/tree/3.0/extra/mac/
+    http://github.com/celery/celery/tree/3.1/extra/mac/
 
 
 .. _daemon-windows:
@@ -402,4 +401,4 @@ CentOS
 ======
 In CentOS we can take advantage of built-in service helpers, such as the
 pid-based status checker function in ``/etc/init.d/functions``.
-See the sample script in http://github.com/celery/celery/tree/3.0/extra/centos/.
+See the sample script in http://github.com/celery/celery/tree/3.1/extra/centos/.

+ 83 - 84
docs/whatsnew-3.1.rst

@@ -67,8 +67,8 @@ Celery now requires Python 2.6 or later.
 We now have a dual codebase that runs on both Python 2 and 3 without
 using the ``2to3`` porting tool.
 
-Last version to use Pickle.
----------------------------
+Last version to enable Pickle by default.
+-----------------------------------------
 
 Starting from Celery 3.2 the default serializer will be json.
 
@@ -85,8 +85,8 @@ and make sure you have properly secured your broker from unwanted access
 
 The worker will show a deprecation warning if you don't define this setting.
 
-Old command-line programs removals and deprecations
----------------------------------------------------
+Old command-line programs removed and deprecated.
+-------------------------------------------------
 
 The goal is that everyone should move the new :program:`celery` umbrella
 command, so with this version we deprecate the old command names,
@@ -125,7 +125,7 @@ the :envvar:`DJANGO_SETTINGS_MODULE` environment variable is set.
 The distribution ships with a new example project using Django
 in :file:`examples/django`:
 
-http://github.com/celery/celery/tree/master/examples/django
+http://github.com/celery/celery/tree/3.1/examples/django
 
 Some features still require the :mod:`django-celery` library:
 
@@ -763,8 +763,71 @@ In Other News
 - Eventlet/gevent/solo/threads pools now properly handles BaseException errors
   raised by tasks.
 
-- Multi: Now properly handles both ``-f`` and ``--logfile`` options
-  (Issue #1541).
+- Worker: No longer forks on :sig:`HUP`
+
+    This means that the worker will reuse the same pid, which makes it
+    easier for process supervisors.
+
+    Contributed by Jameel Al-Aziz.
+
+- Optimization: Improved performance of ``ResultSet.join_native()``.
+
+    Contributed by Stas Rudakou.
+
+- The :signal:`task_revoked` signal now accepts new ``request`` argument
+  (Issue #1555).
+
+    The revoked signal is dispatched after the task request is removed from
+    the stack, so it must instead use the :class:`~celery.worker.job.Request`
+    object to get information about the task.
+
+- Worker: New :option:`-X` command line argument to exclude queues
+  (Issue #1399).
+
+    The :option:`-X` argument is the inverse of the :option:`-Q` argument
+    and accepts a list of queues to exclude (not consume from):
+
+    .. code-block:: bash
+
+        # Consume from all queues in CELERY_QUEUES, but not the 'foo' queue.
+        $ celery worker -A proj -l info -X foo
+
+- Adds :envvar:`C_FAKEFORK` envvar for simple init script/multi debugging
+
+    This means that you can now do:
+
+    .. code-block:: bash
+
+            $ C_FAKEFORK=1 celery multi start 10
+
+    or:
+
+    .. code-block:: bash
+
+        $ C_FAKEFORK=1 /etc/init.d/celeryd start
+
+    to avoid the daemonization step to see errors that are not visible
+    due to missing stdout/stderr.
+
+    A ``dryrun`` command has been added to the generic init script that
+    enables this option.
+
+- New public API to push and pop from the current task stack:
+
+    :func:`celery.app.push_current_task` and
+    :func:`celery.app.pop_current_task``.
+
+- ``RetryTaskError`` has been renamed to :exc:`~celery.exceptions.Retry`.
+
+    The old name is still available for backwards compatibility.
+
+- New semi-predicate exception :exc:`~celery.exceptions.Reject`
+
+    This exception can be raised to reject/requeue the task message,
+    see :ref:`task-semipred-reject` for examples.
+
+- :ref:`Semipredicates <task-semipredicates>` documented: (Retry/Ignore/Reject).
+
 
 .. _v310-experimental:
 
@@ -812,60 +875,16 @@ Scheduled Removals
                 }
             }
 
-- Worker: No longer forks on :sig:`HUP`
-
-    This means that the worker will reuse the same pid, which makes it
-    easier for process supervisors.
-
-    Contributed by Jameel Al-Aziz.
-
-- The ``CELERY_AMQP_TASK_RESULT_EXPIRES`` setting is no longer supported.
-
-    Use :setting:`CELERY_TASK_RESULT_EXPIRES` instead.
-
-- Functions that establishes broker connections no longer
+- Functions that creates a broker connections no longer
   supports the ``connect_timeout`` argument.
 
     This can now only be set using the :setting:`BROKER_CONNECTION_TIMEOUT`
-    setting.  This is because the functions no longer create connections
-    directly, and instead get them from the connection pool.
-
-- The ``Celery.with_default_connection`` method has been removed in favor
-  of ``with app.connection_or_acquire``.
-
-- The :signal:`task_revoked` signal now accepts new ``request`` argument
-  (Issue #1555).
-
-    The revoked signal is dispatched after the task request is removed from
-    the stack, so it must instead use the :class:`~celery.worker.job.Request`
-    object to get information about the task.
-
-- Worker: New :option:`-X` command line argument to exclude queues
-  (Issue #1399).
-
-    The :option:`-X` argument is the inverse of the :option:`-Q` argument
-    and accepts a list of queues to exclude (not consume from):
-
-    .. code-block:: bash
-
-        # Consume from all queues in CELERY_QUEUES, but not the 'foo' queue.
-        $ celery worker -A proj -l info -X foo
-
-- New public API to push and pop from the current task stack:
-
-    :func:`celery.app.push_current_task` and
-    :func:`celery.app.pop_current_task``.
-
-- ``RetryTaskError`` has been renamed to :exc:`~celery.exceptions.Retry`.
-
-    The old name is still available for backwards compatibility.
-
-- New semipredicate exception :exc:`~celery.exceptions.Reject`
+    setting.  This is because functions no longer create connections
+    directly, but instead get them from the connection pool.
 
-    This exception can be raised to reject/requeue the task message,
-    see :ref:`task-semipred-reject` for examples.
+- The ``CELERY_AMQP_TASK_RESULT_EXPIRES`` setting is no longer supported.
 
-- Semipredicates documented: :ref:`task-semipredicates` (Retry/Ignore/Reject).
+    Use :setting:`CELERY_TASK_RESULT_EXPIRES` instead.
 
 .. _v310-deprecations:
 
@@ -874,11 +893,6 @@ Deprecations
 
 See the :ref:`deprecation-timeline`.
 
-- XXX
-
-    YYY
-
-
 .. _v310-fixes:
 
 Fixes
@@ -897,10 +911,6 @@ Fixes
 
     Fix contributed by Daniel M. Taub.
 
-- Optimization: Improved performance of ``ResultSet.join_native()``.
-
-    Contributed by Stas Rudakou.
-
 - ``celery control pool_`` commands did not coerce string arguments to int.
 
 - Redis/Cache chords: Callback result is now set to failure if the group
@@ -909,25 +919,8 @@ Fixes
 - Worker: Now makes sure that the shutdown process is not initiated multiple
   times.
 
-- Adds :envvar:`C_FAKEFORK` envvar for simple init script/multi debugging
-
-    This means that you can now do:
-
-    .. code-block:: bash
-
-            $ C_FAKEFORK=1 celery multi start 10
-
-    or:
-
-    .. code-block:: bash
-
-        $ C_FAKEFORK=1 /etc/init.d/celeryd start
-
-    to avoid the daemonization step to see errors that are not visible
-    due to missing stdout/stderr.
-
-    A ``dryrun`` command has been added to the generic init script that
-    enables this option.
+- Multi: Now properly handles both ``-f`` and ``--logfile`` options
+  (Issue #1541).
 
 .. _v310-internal:
 
@@ -936,6 +929,9 @@ Internal changes
 
 - Module ``celery.task.trace`` has been renamed to :mod:`celery.app.trace`.
 
+- Module ``celery.concurrency.processes`` has been renamed to
+  :mod:`celery.concurrency.prefork`.
+
 - Classes that no longer fall back to using the default app:
 
     - Result backends (:class:`celery.backends.base.BaseBackend`)
@@ -956,3 +952,6 @@ Internal changes
 
     This removes a lot of duplicate functionality.
 
+- The ``Celery.with_default_connection`` method has been removed in favor
+  of ``with app.connection_or_acquire``.
+