apache-airflow-providers-common-compat 1.8.0__tar.gz → 1.10.1__tar.gz

apache_airflow_providers_common_compat-1.10.1/.pre-commit-config.yaml

@@ -0,0 +1,32 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+---
+default_stages: [pre-commit, pre-push]
+minimum_prek_version: '0.2.0'
+default_language_version:
+  python: python3
+  node: 22.19.0
+  golang: 1.24.0
+repos:
+  - repo: local
+    hooks:
+      - id: check-common-compat-sdk-imports-in-sync
+        name: Check common.compat sdk TYPE_CHECKING matches runtime maps
+        language: python
+        files: ^src/airflow/providers/common/compat/sdk\.py$
+        pass_filenames: false
+        entry: ../../../scripts/ci/prek/check_common_compat_lazy_imports.py

apache_airflow_providers_common_compat-1.10.1/NOTICE

@@ -0,0 +1,5 @@
+Apache Airflow
+Copyright 2016-2025 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (http://www.apache.org/).

{apache_airflow_providers_common_compat-1.8.0 → apache_airflow_providers_common_compat-1.10.1}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: apache-airflow-providers-common-compat
-Version: 1.8.0
+Version: 1.10.1
 Summary: Provider package apache-airflow-providers-common-compat for Apache Airflow
 Keywords: airflow-provider,common.compat,airflow,integration
 Author-email: Apache Software Foundation <dev@airflow.apache.org>
 Maintainer-email: Apache Software Foundation <dev@airflow.apache.org>
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
+License-Expression: Apache-2.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Environment :: Web Environment
@@ -14,18 +15,20 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
 Classifier: Framework :: Apache Airflow
 Classifier: Framework :: Apache Airflow :: Provider
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: System :: Monitoring
-Requires-Dist: apache-airflow>=2.10.0
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: apache-airflow>=2.11.0
+Requires-Dist: asgiref>=2.3.0
 Requires-Dist: apache-airflow-providers-openlineage ; extra == "openlineage"
 Requires-Dist: apache-airflow-providers-standard ; extra == "standard"
 Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
-Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1
 Project-URL: Mastodon, https://fosstodon.org/@airflow
 Project-URL: Slack Chat, https://s.apache.org/airflow-slack
 Project-URL: Source Code, https://github.com/apache/airflow
@@ -58,7 +61,7 @@ Provides-Extra: standard
 
 Package ``apache-airflow-providers-common-compat``
 
-Release: ``1.8.0``
+Release: ``1.10.1``
 
 
 Common Compatibility Provider - providing compatibility code for previous Airflow versions
@@ -71,7 +74,7 @@ This is a provider package for ``common.compat`` provider. All classes for this
 are in ``airflow.providers.common.compat`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1/>`_.
 
 Installation
 ------------
@@ -88,7 +91,8 @@ Requirements
 ==================  ==================
 PIP package         Version required
 ==================  ==================
-``apache-airflow``  ``>=2.10.0``
+``apache-airflow``  ``>=2.11.0``
+``asgiref``         ``>=2.3.0``
 ==================  ==================
 
 Cross provider package dependencies
@@ -121,5 +125,5 @@ Extra            Dependencies
 ===============  ========================================
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1/changelog.html>`_.
 

{apache_airflow_providers_common_compat-1.8.0 → apache_airflow_providers_common_compat-1.10.1}/README.rst

@@ -23,7 +23,7 @@
 
 Package ``apache-airflow-providers-common-compat``
 
-Release: ``1.8.0``
+Release: ``1.10.1``
 
 
 Common Compatibility Provider - providing compatibility code for previous Airflow versions
@@ -36,7 +36,7 @@ This is a provider package for ``common.compat`` provider. All classes for this
 are in ``airflow.providers.common.compat`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1/>`_.
 
 Installation
 ------------
@@ -53,7 +53,8 @@ Requirements
 ==================  ==================
 PIP package         Version required
 ==================  ==================
-``apache-airflow``  ``>=2.10.0``
+``apache-airflow``  ``>=2.11.0``
+``asgiref``         ``>=2.3.0``
 ==================  ==================
 
 Cross provider package dependencies
@@ -86,4 +87,4 @@ Extra            Dependencies
 ===============  ========================================
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1/changelog.html>`_.

{apache_airflow_providers_common_compat-1.8.0 → apache_airflow_providers_common_compat-1.10.1}/docs/changelog.rst

@@ -25,6 +25,62 @@
 Changelog
 ---------
 
+1.10.1
+......
+
+Misc
+~~~~
+
+* ``Add backcompat for exceptions in providers (#58727)``
+* ``Move the traces and metrics code under a common observability package (#56187)``
+* ``Bump minimum prek version to 0.2.0 (#58952)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+
+1.10.0
+......
+
+.. note::
+    This release of provider is only available for Airflow 2.11+ as explained in the
+    Apache Airflow providers support policy <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#minimum-supported-version-of-airflow-for-community-managed-providers>_.
+
+Features
+~~~~~~~~
+
+* ``Adjust compat HookLevelLineage for new add_extra method (#58057)``
+
+Misc
+~~~~
+
+* ``Move out some exceptions to TaskSDK (#54505)``
+* ``Bump minimum Airflow version in providers to Airflow 2.11.0 (#58612)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+   * ``Updates to release process of providers (#58316)``
+
+1.9.0
+.....
+
+Features
+~~~~~~~~
+
+* ``feat: backwards comp get async conn (#57143)``
+
+Misc
+~~~~
+
+* ``Convert all airflow distributions to be compliant with ASF requirements (#58138)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+   * ``Delete all unnecessary LICENSE Files (#58191)``
+   * ``Enable PT006 rule to 19 files in providers (cncf,common) (#57995)``
+   * ``Synchronize default versions in all split .pre-commit-config.yaml (#57851)``
+   * ``Fix mypy errors in 'common/compat' (#57759)``
+   * ``Extract prek hooks for Common.Compat provider (#57183)``
+
 1.8.0
 .....
 
@@ -246,8 +302,6 @@ Misc
    * ``Bumping common compat to 1.3.0 (#44728)``
    * ``Prevent __init__.py in providers from being modified (#44713)``
    * ``Fix accidental db tests in Task SDK (#44690)``
-
-.. Review and move the new changes to one of the sections above:
    * ``feat: automatically inject OL info into spark job in DataprocSubmitJobOperator (#44477)``
 
 1.2.2

{apache_airflow_providers_common_compat-1.8.0 → apache_airflow_providers_common_compat-1.10.1}/docs/index.rst

@@ -62,7 +62,7 @@ apache-airflow-providers-common-compat package
 Common Compatibility Provider - providing compatibility code for previous Airflow versions
 
 
-Release: 1.8.0
+Release: 1.10.1
 
 Provider package
 ----------------
@@ -80,12 +80,13 @@ For the minimum Airflow version supported, see ``Requirements`` below.
 Requirements
 ------------
 
-The minimum Apache Airflow version supported by this provider distribution is ``2.10.0``.
+The minimum Apache Airflow version supported by this provider distribution is ``2.11.0``.
 
 ==================  ==================
 PIP package         Version required
 ==================  ==================
-``apache-airflow``  ``>=2.10.0``
+``apache-airflow``  ``>=2.11.0``
+``asgiref``         ``>=2.3.0``
 ==================  ==================
 
 Cross provider package dependencies
@@ -113,5 +114,5 @@ Downloading official packages
 You can download officially released packages and verify their checksums and signatures from the
 `Official Apache Download site <https://downloads.apache.org/airflow/providers/>`_
 
-* `The apache-airflow-providers-common-compat 1.8.0 sdist package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.8.0.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.8.0.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.8.0.tar.gz.sha512>`__)
-* `The apache-airflow-providers-common-compat 1.8.0 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.8.0-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.8.0-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.8.0-py3-none-any.whl.sha512>`__)
+* `The apache-airflow-providers-common-compat 1.10.1 sdist package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.10.1.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.10.1.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.10.1.tar.gz.sha512>`__)
+* `The apache-airflow-providers-common-compat 1.10.1 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.10.1-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.10.1-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_common_compat-1.10.1-py3-none-any.whl.sha512>`__)

{apache_airflow_providers_common_compat-1.8.0 → apache_airflow_providers_common_compat-1.10.1}/provider.yaml

@@ -22,12 +22,15 @@ description: |
   Common Compatibility Provider - providing compatibility code for previous Airflow versions
 
 state: ready
-source-date-epoch: 1761112092
+source-date-epoch: 1765298888
 # Note that those versions are maintained by release manager - do not update them manually
 # with the exception of case where other provider in sources has >= new provider version.
 # In such case adding >= NEW_VERSION and bumping to NEW_VERSION in a provider have
 # to be done in the same PR
 versions:
+  - 1.10.1
+  - 1.10.0
+  - 1.9.0
   - 1.8.0
   - 1.7.4
   - 1.7.3

{apache_airflow_providers_common_compat-1.8.0 → apache_airflow_providers_common_compat-1.10.1}/pyproject.toml

@@ -25,9 +25,11 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "apache-airflow-providers-common-compat"
-version = "1.8.0"
+version = "1.10.1"
 description = "Provider package apache-airflow-providers-common-compat for Apache Airflow"
 readme = "README.rst"
+license = "Apache-2.0"
+license-files = ['LICENSE', 'NOTICE']
 authors = [
     {name="Apache Software Foundation", email="dev@airflow.apache.org"},
 ]
@@ -43,7 +45,6 @@ classifiers = [
     "Intended Audience :: System Administrators",
     "Framework :: Apache Airflow",
     "Framework :: Apache Airflow :: Provider",
-    "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -57,7 +58,8 @@ requires-python = ">=3.10"
 # Make sure to run ``prek update-providers-dependencies --all-files``
 # After you modify the dependencies, and rebuild your Breeze CI image with ``breeze ci-image build``
 dependencies = [
-    "apache-airflow>=2.10.0",
+    "apache-airflow>=2.11.0",
+    "asgiref>=2.3.0",
 ]
 
 # The optional dependencies should be modified in place in the generated file
@@ -105,8 +107,8 @@ apache-airflow-providers-common-sql = {workspace = true}
 apache-airflow-providers-standard = {workspace = true}
 
 [project.urls]
-"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0"
-"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.8.0/changelog.html"
+"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1"
+"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.10.1/changelog.html"
 "Bug Tracker" = "https://github.com/apache/airflow/issues"
 "Source Code" = "https://github.com/apache/airflow"
 "Slack Chat" = "https://s.apache.org/airflow-slack"

{apache_airflow_providers_common_compat-1.8.0 → apache_airflow_providers_common_compat-1.10.1}/src/airflow/providers/common/compat/__init__.py

@@ -29,11 +29,11 @@ from airflow import __version__ as airflow_version
 
 __all__ = ["__version__"]
 
-__version__ = "1.8.0"
+__version__ = "1.10.1"
 
 if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
-    "2.10.0"
+    "2.11.0"
 ):
     raise RuntimeError(
-        f"The package `apache-airflow-providers-common-compat:{__version__}` needs Apache Airflow 2.10.0+"
+        f"The package `apache-airflow-providers-common-compat:{__version__}` needs Apache Airflow 2.11.0+"
     )

apache_airflow_providers_common_compat-1.10.1/src/airflow/providers/common/compat/connection/__init__.py

@@ -0,0 +1,50 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING
+
+from airflow.providers.common.compat.sdk import BaseHook
+
+if TYPE_CHECKING:
+    from airflow.providers.common.compat.sdk import Connection
+
+
+log = logging.getLogger(__name__)
+
+
+async def get_async_connection(conn_id: str) -> Connection:
+    """
+    Get an asynchronous Airflow connection that is backwards compatible.
+
+    :param conn_id: The provided connection ID.
+    :returns: Connection
+    """
+    from asgiref.sync import sync_to_async
+
+    if hasattr(BaseHook, "aget_connection"):
+        log.debug("Get connection using `BaseHook.aget_connection().")
+        return await BaseHook.aget_connection(conn_id=conn_id)
+    log.debug("Get connection using `BaseHook.get_connection().")
+    return await sync_to_async(BaseHook.get_connection)(conn_id=conn_id)
+
+
+__all__ = [
+    "get_async_connection",
+]

apache_airflow_providers_common_compat-1.10.1/src/airflow/providers/common/compat/lineage/hook.py

@@ -0,0 +1,242 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from typing import Any
+
+    from airflow.lineage.hook import LineageContext
+
+
+def _lacks_asset_methods(collector):
+    """Return True if the collector is missing any asset-related methods or properties."""
+    if (  # lazy evaluation, early return
+        hasattr(collector, "add_input_asset")  # method
+        and hasattr(collector, "add_output_asset")  # method
+        and hasattr(collector, "create_asset")  # method
+        # If below we called hasattr(collector, "collected_assets") we'd call the property unnecessarily
+        and hasattr(type(collector), "collected_assets")  # property
+    ):
+        return False
+
+    return True
+
+
+def _lacks_add_extra_method(collector):
+    """Return True if the collector does not define an 'add_extra' method."""
+    # Method may be on class and attribute may be dynamically set on instance
+    if hasattr(collector, "add_extra") and hasattr(collector, "_extra"):
+        return False
+    return True
+
+
+def _add_extra_polyfill(collector):
+    """
+    Add support for `add_extra` method to collector that may be lacking it (e.g., Airflow versions < 3.2.).
+
+    This polyfill adds the `add_extra` method to a class, modifies `collected_assets` and `has_collected`
+    properties and sets `_extra` and `_extra_counts` attributes on instance if not already there.
+
+    This function should be called after renaming on collectors that have `collected_assets` method,
+    so f.e. for Airflow 2 it should happen after renaming from dataset to asset.
+    """
+    import hashlib
+    import json
+    from collections import defaultdict
+
+    import attr
+
+    from airflow.lineage.hook import HookLineage as _BaseHookLineage
+
+    # Add `extra` to HookLineage returned by `collected_assets` property
+    @attr.define
+    class ExtraLineageInfo:
+        """
+        Holds lineage information for arbitrary non-asset metadata.
+
+        This class represents additional lineage context captured during a hook execution that is not
+        associated with a specific asset. It includes the metadata payload itself, the count of
+        how many times it has been encountered, and the context in which it was encountered.
+        """
+
+        key: str
+        value: Any
+        count: int
+        context: LineageContext
+
+    @attr.define
+    class HookLineage(_BaseHookLineage):
+        # mypy is not happy, as base class is using other ExtraLineageInfo, but this code will never
+        # run on AF3.2, where this other one is used, so this is fine - we can ignore.
+        extra: list[ExtraLineageInfo] = attr.field(factory=list)  # type: ignore[assignment]
+
+    # Initialize extra tracking attributes on this collector instance
+    collector._extra = {}
+    collector._extra_counts = defaultdict(int)
+
+    # Overwrite the `collected_assets` property on a class
+    _original_collected_assets = collector.__class__.collected_assets
+
+    def _compat_collected_assets(self) -> HookLineage:
+        """Get the collected hook lineage information."""
+        # Defensive check since we patch the class property, but initialized _extra only on this instance.
+        if not hasattr(self, "_extra"):
+            self._extra = {}
+        if not hasattr(self, "_extra_counts"):
+            self._extra_counts = defaultdict(int)
+
+        # call the original `collected_assets` getter
+        lineage = _original_collected_assets.fget(self)
+        extra_list = [
+            ExtraLineageInfo(
+                key=key,
+                value=value,
+                count=self._extra_counts[count_key],
+                context=context,
+            )
+            for count_key, (key, value, context) in self._extra.items()
+        ]
+        return HookLineage(
+            inputs=lineage.inputs,
+            outputs=lineage.outputs,
+            extra=extra_list,
+        )
+
+    type(collector).collected_assets = property(_compat_collected_assets)
+
+    # Overwrite the `has_collected` property on a class
+    _original_has_collected = collector.__class__.has_collected
+
+    def _compat_has_collected(self) -> bool:
+        # Defensive check since we patch the class property, but initialized _extra only on this instance.
+        if not hasattr(self, "_extra"):
+            self._extra = {}
+        # call the original `has_collected` getter
+        has_collected = _original_has_collected.fget(self)
+        return bool(has_collected or self._extra)
+
+    type(collector).has_collected = property(_compat_has_collected)
+
+    # Add `add_extra` method on the class
+    def _compat_add_extra(self, context, key, value):
+        """Add extra information for older Airflow versions."""
+        _max_collected_extra = 200
+
+        if len(self._extra) >= _max_collected_extra:
+            if hasattr(self, "log"):
+                self.log.debug("Maximum number of extra exceeded. Skipping.")
+            return
+
+        if not key or not value:
+            if hasattr(self, "log"):
+                self.log.debug("Missing required parameter: both 'key' and 'value' must be provided.")
+            return
+
+        # Defensive check since we patch the class property, but initialized _extra only on this instance.
+        if not hasattr(self, "_extra"):
+            self._extra = {}
+        if not hasattr(self, "_extra_counts"):
+            self._extra_counts = defaultdict(int)
+
+        extra_str = json.dumps(value, sort_keys=True, default=str)
+        value_hash = hashlib.md5(extra_str.encode()).hexdigest()
+        entry_id = f"{key}_{value_hash}_{id(context)}"
+        if entry_id not in self._extra:
+            self._extra[entry_id] = (key, value, context)
+        self._extra_counts[entry_id] += 1
+
+        if len(self._extra) == _max_collected_extra:
+            if hasattr(self, "log"):
+                self.log.warning("Maximum number of extra exceeded. Skipping subsequent inputs.")
+
+    type(collector).add_extra = _compat_add_extra
+    return collector
+
+
+def _add_asset_naming_compatibility_layer(collector):
+    """
+    Handle AF 2.x compatibility for dataset -> asset terminology rename.
+
+    This is only called for AF 2.x where we need to provide asset-named methods
+    that wrap the underlying dataset methods.
+    """
+    from functools import wraps
+
+    from airflow.lineage.hook import DatasetLineageInfo, HookLineage
+
+    DatasetLineageInfo.asset = DatasetLineageInfo.dataset
+
+    def rename_asset_kwargs_to_dataset_kwargs(function):
+        @wraps(function)
+        def wrapper(*args, **kwargs):
+            if "asset_kwargs" in kwargs:
+                kwargs["dataset_kwargs"] = kwargs.pop("asset_kwargs")
+
+            if "asset_extra" in kwargs:
+                kwargs["dataset_extra"] = kwargs.pop("asset_extra")
+
+            return function(*args, **kwargs)
+
+        return wrapper
+
+    collector.create_asset = rename_asset_kwargs_to_dataset_kwargs(collector.create_dataset)
+    collector.add_input_asset = rename_asset_kwargs_to_dataset_kwargs(collector.add_input_dataset)
+    collector.add_output_asset = rename_asset_kwargs_to_dataset_kwargs(collector.add_output_dataset)
+
+    def _compat_collected_assets(self) -> HookLineage:
+        """Get the collected hook lineage information."""
+        lineage = self.collected_datasets
+        return HookLineage(
+            [
+                DatasetLineageInfo(dataset=item.dataset, count=item.count, context=item.context)
+                for item in lineage.inputs
+            ],
+            [
+                DatasetLineageInfo(dataset=item.dataset, count=item.count, context=item.context)
+                for item in lineage.outputs
+            ],
+        )
+
+    type(collector).collected_assets = property(_compat_collected_assets)
+    return collector
+
+
+def get_hook_lineage_collector():
+    """
+    Return a hook lineage collector with all required compatibility layers applied.
+
+    Compatibility is determined by inspecting the collector's available methods and
+    properties (duck typing), rather than relying on the Airflow version number.
+
+    Behavior by example:
+    Airflow 2: Collector is missing asset-based methods and `add_extra` - apply both layers.
+    Airflow 3.0–3.1: Collector has asset-based methods but lacks `add_extra` - apply single layer.
+    Airflow 3.2+: Collector has asset-based methods and `add_extra` support - no action required.
+    """
+    from airflow.lineage.hook import get_hook_lineage_collector as get_global_collector
+
+    global_collector = get_global_collector()
+
+    if _lacks_asset_methods(global_collector):
+        global_collector = _add_asset_naming_compatibility_layer(global_collector)
+
+    if _lacks_add_extra_method(global_collector):
+        global_collector = _add_extra_polyfill(global_collector)
+
+    return global_collector