Importing celery.task.trace now emits DeprecationWarning

celery/task/trace.py

@@ -3,5 +3,10 @@ from __future__ import absolute_import
 
 import sys
 
+from celery.utils import warn_deprecated
+
+warn_deprecated('celery.task.trace', removal='3.2',
+                alternative='Please use celery.app.trace instead.')
+
 from celery.app import trace
 sys.modules[__name__] = trace

docs/internals/deprecation.rst

@@ -7,6 +7,21 @@
 .. contents::
     :local:
 
+.. _deprecations-v3.2:
+
+Removals for version 3.2
+========================
+
+- Module ``celery.task.trace`` has been renamed to ``celery.app.trace``
+  as the ``celery.task`` package is being phased out.  The compat module
+  will be removed in version 3.2 so please change any import from::
+
+    from celery.task.trace import ...
+
+  to::
+
+    from celery.app.trace import ...
+
 .. _deprecations-v4.0:
 
 Removals for version 4.0