apache-airflow-providers-standard 1.7.0__tar.gz → 1.8.0__tar.gz

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apache-airflow-providers-standard
-Version: 1.7.0
+Version: 1.8.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>
@@ -22,8 +22,8 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: System :: Monitoring
 Requires-Dist: apache-airflow>=2.10.0
 Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
-Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-standard/1.7.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-standard/1.7.0
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.0/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.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
@@ -54,7 +54,7 @@ Project-URL: YouTube, https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/
 
 Package ``apache-airflow-providers-standard``
 
-Release: ``1.7.0``
+Release: ``1.8.0``
 
 
 Airflow Standard Provider
@@ -67,7 +67,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.7.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.0/>`_.
 
 Installation
 ------------
@@ -88,5 +88,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.7.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.0/changelog.html>`_.
 

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/README.rst

@@ -23,7 +23,7 @@
 
 Package ``apache-airflow-providers-standard``
 
-Release: ``1.7.0``
+Release: ``1.8.0``
 
 
 Airflow Standard Provider
@@ -36,7 +36,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.7.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.0/>`_.
 
 Installation
 ------------
@@ -57,4 +57,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.7.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.0/changelog.html>`_.

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/docs/changelog.rst

@@ -35,6 +35,37 @@
 Changelog
 ---------
 
+1.8.0
+.....
+
+
+Release Date: ``|PypiReleaseDate|``
+
+Features
+~~~~~~~~
+
+* ``feat(hitl): get rid off "Fallback to defaults" in HITL (#55536)``
+* ``feat(hitl): add fail_on_reject to ApprovalOperator (#55255)``
+
+Bug Fixes
+~~~~~~~~~
+
+* ``fix(hitl): make the user model in HITLDetail consistent with airflow user model (#55463)``
+* ``fix(hitl): Resolve Conflict 409 in API server when user actions at nearly timeout (#55243)``
+* ``fix(hitl): fix HITL timeout error handling (#55760)``
+
+Misc
+~~~~
+
+* ``refactor(hitl): rename response_at to responded_at (#55535)``
+* ``refactor(hitl): remove AirflowException from HITLTriggerEventError inheritance (#55763)``
+
+.. Below changes are excluded from the changelog. Move them to
+   appropriate section above if needed. Do not delete the lines(!):
+   * ``Remove SDK dependency from SerializedDAG (#55538)``
+   * ``Introduce e2e testing with testcontainers (#54072)``
+   * ``Switch all airflow logging to structlog (#52651)``
+
 1.7.0
 .....
 

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/docs/index.rst

@@ -66,7 +66,7 @@ apache-airflow-providers-standard package
 Airflow Standard Provider
 
 
-Release: 1.7.0
+Release: 1.8.0
 
 Provider package
 ----------------

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/provider.yaml

@@ -21,12 +21,13 @@ name: Standard
 description: |
     Airflow Standard Provider
 state: ready
-source-date-epoch: 1756877597
+source-date-epoch: 1757951068
 # 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.8.0
   - 1.7.0
   - 1.6.0
   - 1.5.0

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/pyproject.toml

@@ -25,7 +25,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "apache-airflow-providers-standard"
-version = "1.7.0"
+version = "1.8.0"
 description = "Provider package apache-airflow-providers-standard for Apache Airflow"
 readme = "README.rst"
 authors = [
@@ -95,8 +95,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-standard/1.7.0"
-"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-standard/1.7.0/changelog.html"
+"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.0"
+"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-standard/1.8.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.7.0 → apache_airflow_providers_standard-1.8.0}/src/airflow/providers/standard/__init__.py

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

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/src/airflow/providers/standard/example_dags/example_bash_decorator.py

@@ -105,6 +105,7 @@ def example_bash_decorator():
         from shlex import join
 
         files = _get_files_in_cwd()
+        files = files if files else ["."]
         cmd = join(["stat", *files])
 
         return cmd

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/src/airflow/providers/standard/example_dags/example_hitl_operator.py

@@ -140,6 +140,7 @@ with DAG(
         notifiers=[hitl_request_callback],
         on_success_callback=hitl_success_callback,
         on_failure_callback=hitl_failure_callback,
+        assigned_users=[{"id": "admin", "name": "admin"}],
     )
     # [END howto_hitl_approval_operator]
 

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/src/airflow/providers/standard/exceptions.py

@@ -57,9 +57,13 @@ class DuplicateStateError(AirflowExternalTaskSensorException):
     """Raised when duplicate states are provided across allowed, skipped and failed states."""
 
 
-class HITLTriggerEventError(AirflowException):
+class HITLTriggerEventError(Exception):
     """Raised when TriggerEvent contains error."""
 
 
 class HITLTimeoutError(HITLTriggerEventError):
     """Raised when HITLOperator timeouts."""
+
+
+class HITLRejectException(AirflowException):
+    """Raised when an ApprovalOperator receives a "Reject" response when fail_on_reject is set to True."""

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/src/airflow/providers/standard/operators/hitl.py

@@ -29,7 +29,7 @@ from typing import TYPE_CHECKING, Any
 from urllib.parse import ParseResult, urlencode, urlparse, urlunparse
 
 from airflow.configuration import conf
-from airflow.providers.standard.exceptions import HITLTimeoutError, HITLTriggerEventError
+from airflow.providers.standard.exceptions import HITLRejectException, HITLTimeoutError, HITLTriggerEventError
 from airflow.providers.standard.operators.branch import BranchMixIn
 from airflow.providers.standard.triggers.hitl import HITLTrigger, HITLTriggerEventSuccessPayload
 from airflow.providers.standard.utils.skipmixin import SkipMixin
@@ -41,6 +41,7 @@ from airflow.sdk.timezone import utcnow
 
 if TYPE_CHECKING:
     from airflow.sdk.definitions.context import Context
+    from airflow.sdk.execution_time.hitl import HITLUser
     from airflow.sdk.types import RuntimeTaskInstanceProtocol
 
 
@@ -70,7 +71,7 @@ class HITLOperator(BaseOperator):
         multiple: bool = False,
         params: ParamsDict | dict[str, Any] | None = None,
         notifiers: Sequence[BaseNotifier] | BaseNotifier | None = None,
-        respondents: str | list[str] | None = None,
+        assigned_users: HITLUser | list[HITLUser] | None = None,
         **kwargs,
     ) -> None:
         super().__init__(**kwargs)
@@ -86,7 +87,7 @@ class HITLOperator(BaseOperator):
         self.notifiers: Sequence[BaseNotifier] = (
             [notifiers] if isinstance(notifiers, BaseNotifier) else notifiers or []
         )
-        self.respondents = [respondents] if isinstance(respondents, str) else respondents
+        self.assigned_users = [assigned_users] if isinstance(assigned_users, dict) else assigned_users
 
         self.validate_options()
         self.validate_params()
@@ -138,7 +139,7 @@ class HITLOperator(BaseOperator):
             defaults=self.defaults,
             multiple=self.multiple,
             params=self.serialized_params,
-            respondents=self.respondents,
+            assigned_users=self.assigned_users,
         )
 
         if self.execution_timeout:
@@ -178,10 +179,12 @@ class HITLOperator(BaseOperator):
         return HITLTriggerEventSuccessPayload(
             chosen_options=chosen_options,
             params_input=params_input,
+            responded_at=event["responded_at"],
+            responded_by_user=event["responded_by_user"],
         )
 
     def process_trigger_event_error(self, event: dict[str, Any]) -> None:
-        if "error_type" == "timeout":
+        if event["error_type"] == "timeout":
             raise HITLTimeoutError(event)
 
         raise HITLTriggerEventError(event)
@@ -300,12 +303,42 @@ class ApprovalOperator(HITLOperator, SkipMixin):
     APPROVE = "Approve"
     REJECT = "Reject"
 
-    def __init__(self, ignore_downstream_trigger_rules: bool = False, **kwargs) -> None:
+    def __init__(
+        self,
+        *,
+        ignore_downstream_trigger_rules: bool = False,
+        fail_on_reject: bool = False,
+        **kwargs,
+    ) -> None:
+        """
+        Human-in-the-loop Operator for simple approval workflows.
+
+        This operator presents the user with two fixed options: "Approve" and "Reject".
+
+        Behavior:
+        - "Approve": Downstream tasks execute as normal.
+        - "Reject":
+            - Downstream tasks are skipped according to the `ignore_downstream_trigger_rules` setting.
+            - If `fail_on_reject=True`, the task fails instead of only skipping downstream tasks.
+
+        Warning:
+            Using `fail_on_reject=True` is generally discouraged. A HITLOperator's role is to collect
+            human input, and receiving any response—including "Reject"—indicates the task succeeded.
+            Treating "Reject" as a task failure mixes human decision outcomes with Airflow task
+            success/failure states.
+            Only use this option if you explicitly intend for a "Reject" response to fail the task.
+
+        Args:
+            ignore_downstream_trigger_rules: If True, skips all downstream tasks regardless of trigger rules.
+            fail_on_reject: If True, the task fails when "Reject" is selected. Generally discouraged.
+                Read the warning carefully before using.
+        """
         for arg in self.FIXED_ARGS:
             if arg in kwargs:
                 raise ValueError(f"Passing {arg} to ApprovalOperator is not allowed.")
 
         self.ignore_downstream_trigger_rules = ignore_downstream_trigger_rules
+        self.fail_on_reject = fail_on_reject
 
         super().__init__(
             options=[self.APPROVE, self.REJECT],
@@ -321,6 +354,9 @@ class ApprovalOperator(HITLOperator, SkipMixin):
             self.log.info("Approved. Proceeding with downstream tasks...")
             return ret
 
+        if self.fail_on_reject and chosen_option == self.REJECT:
+            raise HITLRejectException('Receive "Reject"')
+
         if not self.downstream_task_ids:
             self.log.info("No downstream tasks; nothing to do.")
             return ret

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/src/airflow/providers/standard/triggers/hitl.py

@@ -25,12 +25,13 @@ if not AIRFLOW_V_3_1_PLUS:
 import asyncio
 from collections.abc import AsyncIterator
 from datetime import datetime
-from typing import Any, Literal, TypedDict
+from typing import TYPE_CHECKING, Any, Literal, TypedDict
 from uuid import UUID
 
 from asgiref.sync import sync_to_async
 
 from airflow.sdk.execution_time.hitl import (
+    HITLUser,
     get_hitl_detail_content_detail,
     update_hitl_detail_response,
 )
@@ -43,6 +44,8 @@ class HITLTriggerEventSuccessPayload(TypedDict, total=False):
 
     chosen_options: list[str]
     params_input: dict[str, Any]
+    responded_by_user: HITLUser | None
+    responded_at: datetime
     timedout: bool
 
 
@@ -98,6 +101,35 @@ class HITLTrigger(BaseTrigger):
         """Loop until the Human-in-the-loop response received or timeout reached."""
         while True:
             if self.timeout_datetime and self.timeout_datetime < utcnow():
+                # Fetch latest HITL detail before fallback
+                resp = await sync_to_async(get_hitl_detail_content_detail)(ti_id=self.ti_id)
+                # Response already received, yield success and exit
+                if resp.response_received and resp.chosen_options:
+                    if TYPE_CHECKING:
+                        assert resp.responded_by_user is not None
+                        assert resp.responded_at is not None
+
+                    self.log.info(
+                        "[HITL] responded_by=%s (id=%s) options=%s at %s (timeout fallback skipped)",
+                        resp.responded_by_user.name,
+                        resp.responded_by_user.id,
+                        resp.chosen_options,
+                        resp.responded_at,
+                    )
+                    yield TriggerEvent(
+                        HITLTriggerEventSuccessPayload(
+                            chosen_options=resp.chosen_options,
+                            params_input=resp.params_input or {},
+                            responded_at=resp.responded_at,
+                            responded_by_user=HITLUser(
+                                id=resp.responded_by_user.id,
+                                name=resp.responded_by_user.name,
+                            ),
+                            timedout=False,
+                        )
+                    )
+                    return
+
                 if self.defaults is None:
                     yield TriggerEvent(
                         HITLTriggerEventFailurePayload(
@@ -107,11 +139,13 @@ class HITLTrigger(BaseTrigger):
                     )
                     return
 
-                await sync_to_async(update_hitl_detail_response)(
+                resp = await sync_to_async(update_hitl_detail_response)(
                     ti_id=self.ti_id,
                     chosen_options=self.defaults,
                     params_input=self.params,
                 )
+                if TYPE_CHECKING:
+                    assert resp.responded_at is not None
                 self.log.info(
                     "[HITL] timeout reached before receiving response, fallback to default %s", self.defaults
                 )
@@ -119,6 +153,8 @@ class HITLTrigger(BaseTrigger):
                     HITLTriggerEventSuccessPayload(
                         chosen_options=self.defaults,
                         params_input=self.params,
+                        responded_by_user=None,
+                        responded_at=resp.responded_at,
                         timedout=True,
                     )
                 )
@@ -126,17 +162,25 @@ class HITLTrigger(BaseTrigger):
 
             resp = await sync_to_async(get_hitl_detail_content_detail)(ti_id=self.ti_id)
             if resp.response_received and resp.chosen_options:
+                if TYPE_CHECKING:
+                    assert resp.responded_by_user is not None
+                    assert resp.responded_at is not None
                 self.log.info(
                     "[HITL] responded_by=%s (id=%s) options=%s at %s",
-                    resp.responded_user_name,
-                    resp.responded_user_id,
+                    resp.responded_by_user.name,
+                    resp.responded_by_user.id,
                     resp.chosen_options,
-                    resp.response_at,
+                    resp.responded_at,
                 )
                 yield TriggerEvent(
                     HITLTriggerEventSuccessPayload(
                         chosen_options=resp.chosen_options,
                         params_input=resp.params_input or {},
+                        responded_at=resp.responded_at,
+                        responded_by_user=HITLUser(
+                            id=resp.responded_by_user.id,
+                            name=resp.responded_by_user.name,
+                        ),
                         timedout=False,
                     )
                 )

{apache_airflow_providers_standard-1.7.0 → apache_airflow_providers_standard-1.8.0}/tests/unit/standard/operators/test_datetime.py

@@ -28,11 +28,15 @@ from airflow.models.taskinstance import TaskInstance as TI
 from airflow.providers.standard.operators.datetime import BranchDateTimeOperator
 from airflow.providers.standard.operators.empty import EmptyOperator
 from airflow.timetables.base import DataInterval
-from airflow.utils import timezone
 from airflow.utils.session import create_session
 from airflow.utils.state import State
 
-from tests_common.test_utils.version_compat import AIRFLOW_V_3_0_1, AIRFLOW_V_3_0_PLUS
+from tests_common.test_utils.version_compat import AIRFLOW_V_3_0_1, AIRFLOW_V_3_0_PLUS, AIRFLOW_V_3_1_PLUS
+
+if AIRFLOW_V_3_1_PLUS:
+    from airflow.sdk import timezone
+else:
+    from airflow.utils import timezone  # type: ignore[attr-defined,no-redef]
 
 pytestmark = pytest.mark.db_test
 
@@ -113,7 +117,7 @@ class TestBranchDateTimeOperator:
                 follow_task_ids_if_false="branch_2",
                 target_upper=None,
                 target_lower=None,
-                dag=self.dag,
+                dag=self.dag_maker.dag,
             )
 
     @pytest.mark.parametrize(