amoghrajesh commented on code in PR #58356:
URL: https://github.com/apache/airflow/pull/58356#discussion_r2536481520
##########
airflow-core/docs/installation/upgrading_to_airflow3.rst:
##########
@@ -179,6 +179,15 @@ code import Airflow components correctly in Airflow 3. The
older paths are depre
* - ``airflow.io.*``
- ``airflow.sdk.io.*``
+**XCom Module Changes**
+
+The ``airflow.utils.xcom`` module has been removed and its constants moved to
more appropriate locations:
+
+- ``XCOM_RETURN_KEY`` constant has been moved from ``airflow.utils.xcom`` to
``airflow.models.xcom``
+- Access the constant as ``XCom.XCOM_RETURN_KEY`` or import from
``airflow.models.xcom``
+- In Task SDK, use ``BaseXCom.XCOM_RETURN_KEY`` or ``XCom.XCOM_RETURN_KEY``
+- The old ``airflow.utils.xcom`` module has been removed, but backward
compatibility is maintained through deprecation shims
Review Comment:
Why this change? People who will use the custom xcom backend and we mention
that here:
https://airflow.apache.org/docs/apache-airflow/stable/core-concepts/xcoms.html,
so they will have access to the XCOM_RETURN_KEY anyway, no need to have any
changes to this doc.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
