This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new f84fd659a33 Add newsfragment describing the relocation of the serde
library (#59632)
f84fd659a33 is described below
commit f84fd659a33c9045e6dae83af3f53e7e682cd720
Author: Amogh Desai <[email protected]>
AuthorDate: Sat Dec 20 02:57:16 2025 +0530
Add newsfragment describing the relocation of the serde library (#59632)
* Add newsfragment describing the relocation of the serde library
* adding timeline
---
airflow-core/newsfragments/58992.significant.rst | 43 ++++++++++++++++++++++++
1 file changed, 43 insertions(+)
diff --git a/airflow-core/newsfragments/58992.significant.rst
b/airflow-core/newsfragments/58992.significant.rst
new file mode 100644
index 00000000000..22eb8fe6d8a
--- /dev/null
+++ b/airflow-core/newsfragments/58992.significant.rst
@@ -0,0 +1,43 @@
+Move serialization/deserialization (serde) logic into Task SDK
+
+Airflow now sources serde logic from ``airflow.sdk.serde`` instead of
+``airflow.serialization.serde``. Serializer modules have moved from
``airflow.serialization.serializers.*``
+to ``airflow.sdk.serde.serializers.*``. The old import paths still work but
emit ``DeprecatedImportWarning``
+to guide migration. The backward compatibility layer will be removed in
Airflow 4.
+
+**What changed:**
+
+- Serialization/deserialization code moved from ``airflow-core`` to
``task-sdk`` package
+- Serializer modules moved from ``airflow.serialization.serializers.*`` to
``airflow.sdk.serde.serializers.*``
+- New serializers should be added to ``airflow.sdk.serde.serializers.*``
namespace
+
+**Code interface changes:**
+
+- Import serializers from ``airflow.sdk.serde.serializers.*`` instead of
``airflow.serialization.serializers.*``
+- Import serialization functions from ``airflow.sdk.serde`` instead of
``airflow.serialization.serde``
+
+**Backward compatibility:**
+
+- Existing serializers importing from ``airflow.serialization.serializers.*``
continue to work with deprecation warnings
+- All existing serializers (builtin, datetime, pandas, numpy, etc.) are
available at the new location
+
+**Migration:**
+
+- **For existing custom serializers**: Update imports to use
``airflow.sdk.serde.serializers.*``
+- **For new serializers**: Add them to ``airflow.sdk.serde.serializers.*``
namespace (e.g., create
``task-sdk/src/airflow/sdk/serde/serializers/your_serializer.py``)
+
+* Types of change
+
+ * [ ] Dag changes
+ * [ ] Config changes
+ * [ ] API changes
+ * [ ] CLI changes
+ * [x] Behaviour changes
+ * [ ] Plugin changes
+ * [ ] Dependency changes
+ * [x] Code interface changes
+
+* Migration rules needed
+
+ * Import serializers from ``airflow.sdk.serde.serializers.*`` instead of
``airflow.serialization.serializers.*``
+ * Add new custom serializers to ``airflow.sdk.serde.serializers.*`` namespace
