apache-airflow-providers-common-compat 1.5.1__py3-none-any.whl → 1.6.0b1__py3-none-any.whl

airflow/providers/common/compat/__init__.py

@@ -29,7 +29,7 @@ from airflow import __version__ as airflow_version
 
 __all__ = ["__version__"]
 
-__version__ = "1.5.1"
+__version__ = "1.6.0b1"
 
 if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
     "2.9.0"

airflow/providers/common/compat/assets/__init__.py

@@ -25,12 +25,12 @@ from airflow.providers.common.compat.version_compat import (
 )
 
 if TYPE_CHECKING:
-    from airflow.api_fastapi.auth.managers.models.resource_details import AssetDetails
+    from airflow.api_fastapi.auth.managers.models.resource_details import AssetAliasDetails, AssetDetails
     from airflow.models.asset import expand_alias_to_assets
     from airflow.sdk.definitions.asset import Asset, AssetAlias, AssetAll, AssetAny
 else:
     if AIRFLOW_V_3_0_PLUS:
-        from airflow.api_fastapi.auth.managers.models.resource_details import AssetDetails
+        from airflow.api_fastapi.auth.managers.models.resource_details import AssetAliasDetails, AssetDetails
         from airflow.models.asset import expand_alias_to_assets
         from airflow.sdk.definitions.asset import Asset, AssetAlias, AssetAll, AssetAny
     else:
@@ -52,6 +52,7 @@ else:
 __all__ = [
     "Asset",
     "AssetAlias",
+    "AssetAliasDetails",
     "AssetAll",
     "AssetAny",
     "AssetDetails",

airflow/providers/common/compat/check.py

@@ -0,0 +1,99 @@
+# 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 functools
+import importlib
+from importlib import metadata
+
+from packaging.version import Version
+
+from airflow.exceptions import AirflowOptionalProviderFeatureException
+
+
+def require_provider_version(provider_name: str, provider_min_version: str):
+    """
+    Enforce minimum version requirement for a specific provider.
+
+    Some providers, do not explicitly require other provider packages but may offer optional features
+    that depend on it. These features are generally available starting from a specific version of such
+    provider. This decorator helps ensure compatibility, preventing import errors and providing clear
+    logs about version requirements.
+
+    Args:
+        provider_name: Name of the provider e.g., apache-airflow-providers-openlineage
+        provider_min_version: Optional minimum version requirement e.g., 1.0.1
+
+    Raises:
+        ValueError: If neither `provider_name` nor `provider_min_version` is provided.
+        ValueError: If full provider name (e.g., apache-airflow-providers-openlineage) is not provided.
+        TypeError: If the decorator is used without parentheses (e.g., `@require_provider_version`).
+    """
+    err_msg = (
+        "`require_provider_version` decorator must be used with two arguments: "
+        "'provider_name' and 'provider_min_version', "
+        'e.g., @require_provider_version(provider_name="apache-airflow-providers-openlineage", '
+        'provider_min_version="1.0.0")'
+    )
+    # Detect if decorator is mistakenly used without arguments
+    if callable(provider_name) and not provider_min_version:
+        raise TypeError(err_msg)
+
+    # Ensure both arguments are provided and not empty
+    if not provider_name or not provider_min_version:
+        raise ValueError(err_msg)
+
+    # Ensure full provider name is passed
+    if not provider_name.startswith("apache-airflow-providers-"):
+        raise ValueError(
+            f"Full `provider_name` must be provided starting with 'apache-airflow-providers-', "
+            f"got `{provider_name}`."
+        )
+
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            try:
+                provider_version: str = metadata.version(provider_name)
+            except metadata.PackageNotFoundError:
+                try:
+                    # Try dynamically importing the provider module based on the provider name
+                    import_provider_name = provider_name.replace("apache-airflow-providers-", "").replace(
+                        "-", "."
+                    )
+                    provider_module = importlib.import_module(f"airflow.providers.{import_provider_name}")
+
+                    provider_version = getattr(provider_module, "__version__")
+
+                except (ImportError, AttributeError, ModuleNotFoundError):
+                    raise AirflowOptionalProviderFeatureException(
+                        f"Provider `{provider_name}` not found or has no version, "
+                        f"skipping function `{func.__name__}` execution"
+                    )
+
+            if provider_version and Version(provider_version) < Version(provider_min_version):
+                raise AirflowOptionalProviderFeatureException(
+                    f"Provider's `{provider_name}` version `{provider_version}` is lower than required "
+                    f"`{provider_min_version}`, skipping function `{func.__name__}` execution"
+                )
+
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator

airflow/providers/common/compat/get_provider_info.py

@@ -27,8 +27,8 @@ def get_provider_info():
         "name": "Common Compat",
         "description": "``Common Compatibility Provider - providing compatibility code for previous Airflow versions.``\n",
         "state": "ready",
-        "source-date-epoch": 1741508595,
-        "versions": ["1.5.1", "1.5.0", "1.3.0", "1.2.2", "1.2.1", "1.2.0", "1.1.0", "1.0.0"],
+        "source-date-epoch": 1742480214,
+        "versions": ["1.6.0b1", "1.5.1", "1.5.0", "1.3.0", "1.2.2", "1.2.1", "1.2.0", "1.1.0", "1.0.0"],
         "integrations": [
             {
                 "integration-name": "Common Compat",

airflow/providers/common/compat/openlineage/check.py

@@ -0,0 +1,104 @@
+# 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 functools
+import logging
+from importlib import metadata
+
+from packaging.version import Version
+
+from airflow.exceptions import AirflowOptionalProviderFeatureException
+
+log = logging.getLogger(__name__)
+
+
+def require_openlineage_version(
+    provider_min_version: str | None = None, client_min_version: str | None = None
+):
+    """
+    Enforce minimum version requirements for OpenLineage provider or client.
+
+    Some providers, such as Snowflake and DBT Cloud, do not require an OpenLineage provider but may
+    offer optional features that depend on it. These features are generally available starting
+    from a specific version of the OpenLineage provider or client. This decorator helps ensure compatibility,
+    preventing import errors and providing clear logs about version requirements.
+
+    Args:
+        provider_min_version: Optional minimum version requirement for apache-airflow-providers-openlineage
+        client_min_version: Optional minimum version requirement for openlineage-python
+
+    Raises:
+        ValueError: If neither `provider_min_version` nor `client_min_version` is provided.
+        TypeError: If the decorator is used without parentheses (e.g., `@require_openlineage_version`).
+    """
+    err_msg = (
+        "`require_openlineage_version` decorator must be used with at least one argument: "
+        "'provider_min_version' or 'client_min_version', "
+        'e.g., @require_openlineage_version(provider_min_version="1.0.0")'
+    )
+    # Detect if decorator is mistakenly used without arguments
+    if callable(provider_min_version) and client_min_version is None:
+        raise TypeError(err_msg)
+
+    # Ensure at least one argument is provided
+    if provider_min_version is None and client_min_version is None:
+        raise ValueError(err_msg)
+
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            if provider_min_version:
+                try:
+                    provider_version: str = metadata.version("apache-airflow-providers-openlineage")
+                except metadata.PackageNotFoundError:
+                    try:
+                        from airflow.providers.openlineage import __version__ as provider_version
+                    except (ImportError, AttributeError, ModuleNotFoundError):
+                        raise AirflowOptionalProviderFeatureException(
+                            "OpenLineage provider not found or has no version, "
+                            f"skipping function `{func.__name__}` execution"
+                        )
+
+                if provider_version and Version(provider_version) < Version(provider_min_version):
+                    raise AirflowOptionalProviderFeatureException(
+                        f"OpenLineage provider version `{provider_version}` "
+                        f"is lower than required `{provider_min_version}`, "
+                        f"skipping function `{func.__name__}` execution"
+                    )
+
+            if client_min_version:
+                try:
+                    client_version: str = metadata.version("openlineage-python")
+                except metadata.PackageNotFoundError:
+                    raise AirflowOptionalProviderFeatureException(
+                        f"OpenLineage client not found, skipping function `{func.__name__}` execution"
+                    )
+
+                if client_version and Version(client_version) < Version(client_min_version):
+                    raise AirflowOptionalProviderFeatureException(
+                        f"OpenLineage client version `{client_version}` "
+                        f"is lower than required `{client_min_version}`, "
+                        f"skipping function `{func.__name__}` execution"
+                    )
+
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator

airflow/providers/common/compat/security/permissions.py

@@ -19,12 +19,22 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from airflow.security.permissions import RESOURCE_ASSET
+    from airflow.security.permissions import (
+        RESOURCE_ASSET,
+        RESOURCE_ASSET_ALIAS,
+        RESOURCE_BACKFILL,
+        RESOURCE_DAG_VERSION,
+    )
 else:
     try:
-        from airflow.security.permissions import RESOURCE_ASSET
+        from airflow.security.permissions import (
+            RESOURCE_ASSET,
+            RESOURCE_ASSET_ALIAS,
+            RESOURCE_BACKFILL,
+            RESOURCE_DAG_VERSION,
+        )
     except ImportError:
         from airflow.security.permissions import RESOURCE_DATASET as RESOURCE_ASSET
 
 
-__all__ = ["RESOURCE_ASSET"]
+__all__ = ["RESOURCE_ASSET", "RESOURCE_ASSET_ALIAS", "RESOURCE_BACKFILL", "RESOURCE_DAG_VERSION"]

{apache_airflow_providers_common_compat-1.5.1.dist-info → apache_airflow_providers_common_compat-1.6.0b1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apache-airflow-providers-common-compat
-Version: 1.5.1
+Version: 1.6.0b1
 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>
@@ -24,11 +24,11 @@ Requires-Dist: apache-airflow>=2.9.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.5.1/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.5.1
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.6.0b1/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.6.0b1
+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
-Project-URL: Twitter, https://x.com/ApacheAirflow
 Project-URL: YouTube, https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/
 Provides-Extra: openlineage
 Provides-Extra: standard
@@ -58,7 +58,7 @@ Provides-Extra: standard
 
 Package ``apache-airflow-providers-common-compat``
 
-Release: ``1.5.1``
+Release: ``1.6.0b1``
 
 
 ``Common Compatibility Provider - providing compatibility code for previous Airflow versions.``
@@ -71,7 +71,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.5.1/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.6.0b1/>`_.
 
 Installation
 ------------
@@ -112,5 +112,5 @@ Dependent package
 ==============================================================================================================  ===============
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.5.1/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-common-compat/1.6.0b1/changelog.html>`_.
 

{apache_airflow_providers_common_compat-1.5.1.dist-info → apache_airflow_providers_common_compat-1.6.0b1.dist-info}/RECORD

@@ -1,24 +1,26 @@
 airflow/providers/common/compat/LICENSE,sha256=gXPVwptPlW1TJ4HSuG5OMPg-a3h43OGMkZRR1rpwfJA,10850
-airflow/providers/common/compat/__init__.py,sha256=9pojwjD9RNKmRIpvk52S9ODVrjNcEQmCu6Yo5zOYI6U,1500
-airflow/providers/common/compat/get_provider_info.py,sha256=p01aEJ5_Q64paemTfOTuMpCgbJeMYDzp6sfecI2D5h0,1984
+airflow/providers/common/compat/__init__.py,sha256=sysV2TNsvQETL5H5doqH9-9iUlzC9OvfBX9eqwRw29g,1502
+airflow/providers/common/compat/check.py,sha256=d6at8iFn_c2jbnmvswoMYz1DFUrAbQTVKMCA5PYAOrQ,4347
+airflow/providers/common/compat/get_provider_info.py,sha256=4DGFXh_Yb0imhgcsXvNq3E6FnmFI3lmlxSsroH49OUU,1995
 airflow/providers/common/compat/version_compat.py,sha256=aHg90_DtgoSnQvILFICexMyNlHlALBdaeWqkX3dFDug,1605
-airflow/providers/common/compat/assets/__init__.py,sha256=LvASyTEFy2ev0deaM7wJrxC6quKfHYaub69UTzzY8GE,2139
+airflow/providers/common/compat/assets/__init__.py,sha256=73zbqrAVBepkL83xpjRjzLQF7LzI-uA-3pBu5n7-g80,2202
 airflow/providers/common/compat/lineage/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
 airflow/providers/common/compat/lineage/entities.py,sha256=otob45spY8YSa5fMx3XXg-JWNZttS8g4WrkvYte2HFY,2651
 airflow/providers/common/compat/lineage/hook.py,sha256=0ujOAFXc3U0zqAJfKVgSRAHCa6lKwlNd7yMacUyNdD8,3977
 airflow/providers/common/compat/openlineage/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
+airflow/providers/common/compat/openlineage/check.py,sha256=jcrz1xgqsUd9TCF564U_JGvU8Vyrss7qpiMaQz_ZIqA,4672
 airflow/providers/common/compat/openlineage/facet.py,sha256=_3YHsRP39vx6FPePFQCLjNHP9kzisNH5v97o-PWzwLk,6529
 airflow/providers/common/compat/openlineage/utils/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
 airflow/providers/common/compat/openlineage/utils/spark.py,sha256=zyvuWFLye_6xDmC4PDQ9NKi0muH-QtqfsqRIHNjxzRQ,5983
 airflow/providers/common/compat/openlineage/utils/sql.py,sha256=bQdfjBgkHNt0cFKdA2BM7myapb_WVM_F2RkVoPZVfoU,3286
 airflow/providers/common/compat/openlineage/utils/utils.py,sha256=KB_1emJIEeYxPG7YscYHmIEDIx9VNmUPtDFz81UuhQk,1617
 airflow/providers/common/compat/security/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
-airflow/providers/common/compat/security/permissions.py,sha256=krHlEyXJHFOan1lhiRIuEUpEdS2qhOkwkJyvjWEk2l0,1151
+airflow/providers/common/compat/security/permissions.py,sha256=lkmW7IyE56sK0xPdc2dg7EeuS_EJBVfERoSD_Ct7lf0,1448
 airflow/providers/common/compat/standard/__init__.py,sha256=9hdXHABrVpkbpjZgUft39kOFL2xSGeG4GEua0Hmelus,785
 airflow/providers/common/compat/standard/operators.py,sha256=1jsiu8Cc6S2Xhhfo2Rh5PqJCnQ1CBH_UW5q7s3Y0Mpc,1712
 airflow/providers/common/compat/standard/triggers.py,sha256=XBi9KE-cAY_TlIyKVqr1-EU7xZNqgCVTugXZObV3gaQ,1177
 airflow/providers/common/compat/standard/utils.py,sha256=SvTXThqYRKVfmRRpq-D5eNcxQjY9TESrTyl3n670QM8,1289
-apache_airflow_providers_common_compat-1.5.1.dist-info/entry_points.txt,sha256=OdOClAuY8E82VvA-Zo6narFujtXdGihHKZH2HfmlPIo,109
-apache_airflow_providers_common_compat-1.5.1.dist-info/WHEEL,sha256=_2ozNFCLWc93bK4WKHCO-eDUENDlo-dgc9cU3qokYO4,82
-apache_airflow_providers_common_compat-1.5.1.dist-info/METADATA,sha256=1muRXsNxAATmGYr2jHFdryzV0aiO01RHMch0ELNLB9Y,5287
-apache_airflow_providers_common_compat-1.5.1.dist-info/RECORD,,
+apache_airflow_providers_common_compat-1.6.0b1.dist-info/entry_points.txt,sha256=OdOClAuY8E82VvA-Zo6narFujtXdGihHKZH2HfmlPIo,109
+apache_airflow_providers_common_compat-1.6.0b1.dist-info/WHEEL,sha256=_2ozNFCLWc93bK4WKHCO-eDUENDlo-dgc9cU3qokYO4,82
+apache_airflow_providers_common_compat-1.6.0b1.dist-info/METADATA,sha256=F5-kvFY2qiIEY4AxB6dq_V_1YAKRFvgZXNfA29MaouA,5303
+apache_airflow_providers_common_compat-1.6.0b1.dist-info/RECORD,,