apache-airflow-providers-standard 1.4.1rc2__tar.gz → 1.5.0__tar.gz

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: apache-airflow-providers-standard
-Version: 1.4.1rc2
+Version: 1.5.0
 Summary: Provider package apache-airflow-providers-standard for Apache Airflow
 Keywords: airflow-provider,standard,airflow,integration
 Author-email: Apache Software Foundation <dev@airflow.apache.org>
 Maintainer-email: Apache Software Foundation <dev@airflow.apache.org>
-Requires-Python: ~=3.10
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -18,11 +18,12 @@ 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.0rc1
+Requires-Dist: apache-airflow>=2.10.0
 Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
-Project-URL: Changelog, https://airflow.staged.apache.org/docs/apache-airflow-providers-standard/1.4.1/changelog.html
-Project-URL: Documentation, https://airflow.staged.apache.org/docs/apache-airflow-providers-standard/1.4.1
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0
 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
@@ -53,8 +54,9 @@ Project-URL: YouTube, https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/
 
 Package ``apache-airflow-providers-standard``
 
-Release: ``1.4.1``
+Release: ``1.5.0``
 
+Release Date: ``|PypiReleaseDate|``
 
 Airflow Standard Provider
 
@@ -66,7 +68,7 @@ This is a provider package for ``standard`` provider. All classes for this provi
 are in ``airflow.providers.standard`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.4.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0/>`_.
 
 Installation
 ------------
@@ -75,7 +77,7 @@ You can install this package on top of an existing Airflow 2 installation (see `
 for the minimum Airflow version supported) via
 ``pip install apache-airflow-providers-standard``
 
-The package supports the following python versions: 3.10,3.11,3.12
+The package supports the following python versions: 3.10,3.11,3.12,3.13
 
 Requirements
 ------------
@@ -87,5 +89,5 @@ PIP package         Version required
 ==================  ==================
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.4.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0/changelog.html>`_.
 

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/README.rst

@@ -23,8 +23,9 @@
 
 Package ``apache-airflow-providers-standard``
 
-Release: ``1.4.1``
+Release: ``1.5.0``
 
+Release Date: ``|PypiReleaseDate|``
 
 Airflow Standard Provider
 
@@ -36,7 +37,7 @@ This is a provider package for ``standard`` provider. All classes for this provi
 are in ``airflow.providers.standard`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.4.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0/>`_.
 
 Installation
 ------------
@@ -45,7 +46,7 @@ You can install this package on top of an existing Airflow 2 installation (see `
 for the minimum Airflow version supported) via
 ``pip install apache-airflow-providers-standard``
 
-The package supports the following python versions: 3.10,3.11,3.12
+The package supports the following python versions: 3.10,3.11,3.12,3.13
 
 Requirements
 ------------
@@ -57,4 +58,4 @@ PIP package         Version required
 ==================  ==================
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.4.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0/changelog.html>`_.

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/docs/changelog.rst

@@ -35,6 +35,57 @@
 Changelog
 ---------
 
+1.5.0
+.....
+
+Features
+~~~~~~~~
+
+* ``Add venv pycache clean up for the PythonVirtualenvOperator (#53390)``
+* ``Add Human-in-the-loop logic to core Airflow and implement 'HITLOperator', 'ApprovalOperator', 'HITLEntryOperator' in standard provider (#52868)``
+
+Bug Fixes
+~~~~~~~~~
+
+* ``Fix key error in _handle_execution_date_fn for ExternalTaskSensor (#53728)``
+* ``fix: Type mismatch for DateInterval in latest only operator (#53541)``
+* ``fix(hitl): Fix HITLEntryOperator "options" and "defaults" handling (#53184)``
+* ``fix(hitl): handle hitl details when task instance is retried (#53824)``
+
+Misc
+~~~~
+
+* ``Fix unreachable code mypy warnings in standard provider (#53431)``
+* ``Align main branch after standard provider 1.4.1 release (#53511)``
+* ``Add Python 3.13 support for Airflow. (#46891)``
+* ``Cleanup mypy ignore in standard provider where possible (#53308)``
+* ``Remove type ignore across codebase after mypy upgrade (#53243)``
+* ``Remove direct scheduler BaseOperator refs (#52234)``
+* ``Remove upper-binding for "python-requires" (#52980)``
+* ``Temporarily switch to use >=,< pattern instead of '~=' (#52967)``
+* ``Move 'BaseHook' imports to version_compat for standard provider (#52766)``
+* ``Deprecate and move 'airflow.utils.task_group' to SDK (#53450)``
+* ``Deprecate decorators from Core (#53629)``
+* ``Replace usages of XCOM_RETURN_KEY in providers to not be from utils (#53170)``
+* ``Remove 'set_current_context' from 'airflow.models.taskinstance' (#53036)``
+* ``Replace direct BaseOperator import with version_compat import (#53847)``
+* ``Fix typo in serialized_params (#53848)``
+
+Doc-only
+~~~~~~~~
+
+* ``docs: Correct TaskFlow capitalization in documentation (#51794)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+   * ``Set up process for sharing code between different components (#53149)``
+   * ``Replace 'mock.patch("utcnow")' with time_machine. (#53642)``
+   * ``Add run_on_latest_version support for backfill and clear operations (#52177)``
+   * ``docs(hitl): add example dag for all HITLOperator (#53360)``
+   * ``Prepare release for Standard Provider 1.4.1``
+   * ``Make dag_version_id in TI non-nullable (#50825)``
+   * ``Fix example dag example_external_task_parent_deferrable.py imports (#52956)``
+
 1.4.1
 .....
 
@@ -322,7 +373,7 @@ Misc
 * ``AIP-72: Move non-user facing code to '_internal' (#45515)``
 * ``AIP-72: Add support for 'get_current_context' in Task SDK (#45486)``
 * ``Move Literal alias into TYPE_CHECKING block (#45345)``
-* ``AIP-72: Add Taskflow API support & template rendering in Task SDK (#45444)``
+* ``AIP-72: Add TaskFlow API support & template rendering in Task SDK (#45444)``
 * ``Remove tuple_in_condition helpers (#45201)``
 
 .. Below changes are excluded from the changelog. Move them to

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/docs/index.rst

@@ -66,7 +66,9 @@ apache-airflow-providers-standard package
 Airflow Standard Provider
 
 
-Release: 1.4.1
+Release: 1.5.0
+
+Release Date: ``|PypiReleaseDate|``
 
 Provider package
 ----------------

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/provider.yaml

@@ -21,12 +21,13 @@ name: Standard
 description: |
     Airflow Standard Provider
 state: ready
-source-date-epoch: 1751474457
+source-date-epoch: 1753692022
 # 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.5.0
   - 1.4.1
   - 1.4.0
   - 1.3.0
@@ -70,6 +71,7 @@ operators:
       - airflow.providers.standard.operators.latest_only
       - airflow.providers.standard.operators.smooth
       - airflow.providers.standard.operators.branch
+      - airflow.providers.standard.operators.hitl
 sensors:
   - integration-name: Standard
     python-modules:
@@ -94,6 +96,7 @@ triggers:
       - airflow.providers.standard.triggers.external_task
       - airflow.providers.standard.triggers.file
       - airflow.providers.standard.triggers.temporal
+      - airflow.providers.standard.triggers.hitl
 
 extra-links:
   - airflow.providers.standard.operators.trigger_dagrun.TriggerDagRunLink

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/pyproject.toml

@@ -25,7 +25,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "apache-airflow-providers-standard"
-version = "1.4.1rc2"
+version = "1.5.0"
 description = "Provider package apache-airflow-providers-standard for Apache Airflow"
 readme = "README.rst"
 authors = [
@@ -47,16 +47,17 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: System :: Monitoring",
 ]
-requires-python = "~=3.10"
+requires-python = ">=3.10"
 
 # The dependencies should be modified in place in the generated file.
 # Any change in the dependencies is preserved when the file is regenerated
 # Make sure to run ``breeze static-checks --type 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.0rc1",
+    "apache-airflow>=2.10.0",
 ]
 
 [dependency-groups]
@@ -94,8 +95,8 @@ apache-airflow-providers-common-sql = {workspace = true}
 apache-airflow-providers-standard = {workspace = true}
 
 [project.urls]
-"Documentation" = "https://airflow.staged.apache.org/docs/apache-airflow-providers-standard/1.4.1"
-"Changelog" = "https://airflow.staged.apache.org/docs/apache-airflow-providers-standard/1.4.1/changelog.html"
+"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0"
+"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-standard/1.5.0/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_standard-1.4.1rc2/tests/unit → apache_airflow_providers_standard-1.5.0/src/airflow}/__init__.py

@@ -14,4 +14,4 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-__path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

{apache_airflow_providers_standard-1.4.1rc2/src/airflow → apache_airflow_providers_standard-1.5.0/src/airflow/providers}/__init__.py

@@ -14,4 +14,4 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-__path__ = __import__("pkgutil").extend_path(__path__, __name__)  # type: ignore
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/__init__.py

@@ -29,7 +29,7 @@ from airflow import __version__ as airflow_version
 
 __all__ = ["__version__"]
 
-__version__ = "1.4.1"
+__version__ = "1.5.0"
 
 if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
     "2.10.0"

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/example_dags/example_external_task_parent_deferrable.py

@@ -56,9 +56,3 @@ with DAG(
     end = EmptyOperator(task_id="end")
 
     start >> [trigger_child_task, external_task_sensor] >> end
-
-    from tests_common.test_utils.watcher import watcher
-
-    # This test needs watcher in order to properly mark success/failure
-    # when "teardown" task with trigger rule is part of the DAG
-    list(dag.tasks) >> watcher()

apache_airflow_providers_standard-1.5.0/src/airflow/providers/standard/example_dags/example_hitl_operator.py

@@ -0,0 +1,81 @@
+# 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 datetime
+
+import pendulum
+
+from airflow.providers.standard.operators.hitl import (
+    ApprovalOperator,
+    HITLBranchOperator,
+    HITLEntryOperator,
+    HITLOperator,
+)
+from airflow.sdk import DAG, Param, task
+
+with DAG(
+    dag_id="example_hitl_operator",
+    start_date=pendulum.datetime(2021, 1, 1, tz="UTC"),
+    catchup=False,
+    tags=["example", "HITL"],
+):
+    wait_for_input = HITLEntryOperator(
+        task_id="wait_for_input",
+        subject="Please provide required information: ",
+        params={"information": Param("", type="string")},
+    )
+
+    wait_for_option = HITLOperator(
+        task_id="wait_for_option",
+        subject="Please choose one option to proceeded: ",
+        options=["option 1", "option 2", "option 3"],
+    )
+
+    valid_input_and_options = ApprovalOperator(
+        task_id="valid_input_and_options",
+        subject="Are the following input and options valid?",
+        body="""
+        Input: {{ task_instance.xcom_pull(task_ids='wait_for_input', key='return_value')["params_input"]["information"] }}
+        Option: {{ task_instance.xcom_pull(task_ids='wait_for_option', key='return_value')["chosen_options"] }}
+        """,
+        defaults="Reject",
+        execution_timeout=datetime.timedelta(minutes=1),
+    )
+
+    choose_a_branch_to_run = HITLBranchOperator(
+        task_id="choose_a_branch_to_run",
+        subject="You're now allowed to proceeded. Please choose one task to run: ",
+        options=["task_1", "task_2", "task_3"],
+    )
+
+    @task
+    def task_1(): ...
+
+    @task
+    def task_2(): ...
+
+    @task
+    def task_3(): ...
+
+    (
+        [wait_for_input, wait_for_option]
+        >> valid_input_and_options
+        >> choose_a_branch_to_run
+        >> [task_1(), task_2(), task_3()]
+    )

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/exceptions.py

@@ -55,3 +55,11 @@ class ExternalDagFailedError(AirflowExternalTaskSensorException):
 
 class DuplicateStateError(AirflowExternalTaskSensorException):
     """Raised when duplicate states are provided across allowed, skipped and failed states."""
+
+
+class HITLTriggerEventError(AirflowException):
+    """Raised when TriggerEvent contains error."""
+
+
+class HITLTimeoutError(HITLTriggerEventError):
+    """Raised when HILTOperator timeouts."""

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/get_provider_info.py

@@ -58,6 +58,7 @@ def get_provider_info():
                     "airflow.providers.standard.operators.latest_only",
                     "airflow.providers.standard.operators.smooth",
                     "airflow.providers.standard.operators.branch",
+                    "airflow.providers.standard.operators.hitl",
                 ],
             }
         ],
@@ -93,6 +94,7 @@ def get_provider_info():
                     "airflow.providers.standard.triggers.external_task",
                     "airflow.providers.standard.triggers.file",
                     "airflow.providers.standard.triggers.temporal",
+                    "airflow.providers.standard.triggers.hitl",
                 ],
             }
         ],

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/hooks/filesystem.py

@@ -20,10 +20,7 @@ from __future__ import annotations
 from pathlib import Path
 from typing import Any
 
-try:
-    from airflow.sdk import BaseHook
-except ImportError:
-    from airflow.hooks.base import BaseHook  # type: ignore[attr-defined,no-redef]
+from airflow.providers.standard.version_compat import BaseHook
 
 
 class FSHook(BaseHook):

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/hooks/package_index.py

@@ -23,10 +23,7 @@ import subprocess
 from typing import Any
 from urllib.parse import quote, urlparse
 
-try:
-    from airflow.sdk import BaseHook
-except ImportError:
-    from airflow.hooks.base import BaseHook  # type: ignore[attr-defined,no-redef]
+from airflow.providers.standard.version_compat import BaseHook
 
 
 class PackageIndexHook(BaseHook):

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/hooks/subprocess.py

@@ -24,10 +24,7 @@ from collections.abc import Iterator
 from subprocess import PIPE, STDOUT, Popen
 from tempfile import TemporaryDirectory, gettempdir
 
-try:
-    from airflow.sdk import BaseHook
-except ImportError:
-    from airflow.hooks.base import BaseHook  # type: ignore[attr-defined,no-redef]
+from airflow.providers.standard.version_compat import BaseHook
 
 SubprocessResult = namedtuple("SubprocessResult", ["exit_code", "output"])
 

{apache_airflow_providers_standard-1.4.1rc2 → apache_airflow_providers_standard-1.5.0}/src/airflow/providers/standard/operators/branch.py

@@ -27,7 +27,7 @@ from airflow.providers.standard.version_compat import AIRFLOW_V_3_0_PLUS, BaseOp
 if AIRFLOW_V_3_0_PLUS:
     from airflow.providers.standard.utils.skipmixin import SkipMixin
 else:
-    from airflow.models.skipmixin import SkipMixin  # type: ignore[no-redef]
+    from airflow.models.skipmixin import SkipMixin
 
 if TYPE_CHECKING:
     from airflow.sdk.definitions.context import Context
@@ -56,9 +56,7 @@ class BranchMixIn(SkipMixin):
         if TYPE_CHECKING:
             assert dag
 
-        if branches_to_execute is None:
-            return
-        elif isinstance(branches_to_execute, str) or not isinstance(branches_to_execute, Iterable):
+        if isinstance(branches_to_execute, str) or not isinstance(branches_to_execute, Iterable):
             branches_to_execute = [branches_to_execute]
 
         for branch in branches_to_execute: