This is an automated email from the ASF dual-hosted git repository.
kaxilnaik 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 103976cf1b1 Mention key changes in event accessors (#49491)
103976cf1b1 is described below
commit 103976cf1b1cef522205845a67a6cc25d6227476
Author: Tzu-ping Chung <[email protected]>
AuthorDate: Mon Apr 21 14:42:40 2025 +0800
Mention key changes in event accessors (#49491)
---
RELEASE_NOTES.rst | 19 ++++++++++++++++---
reproducible_build.yaml | 4 ++--
2 files changed, 18 insertions(+), 5 deletions(-)
diff --git a/RELEASE_NOTES.rst b/RELEASE_NOTES.rst
index 4a638f3198c..d93a0f5718a 100644
--- a/RELEASE_NOTES.rst
+++ b/RELEASE_NOTES.rst
@@ -311,10 +311,23 @@ Several core components have been moved to more intuitive
or stable locations:
These changes simplify imports and reflect broader efforts to stabilize
utility interfaces across the Airflow codebase.
-Asset Event URIs in ``inlet_events``
-""""""""""""""""""""""""""""""""""""
+Improved ``inlet_events``, ``outlet_events``, and ``triggering_asset_events``
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+Asset event accessors in the task context are improved to better support asset
use cases, including new features introduced in AIP-74.
+
+Events of an asset or asset alias are now accessed directly by a concrete
object to avoid ambiguity. Using a ``str`` to access events is
+no longer supported. Use an ``Asset`` or ``AssetAlias`` object, or
``Asset.ref`` to refer to an entity explicitly instead, such as::
+
+ outlet_events[Asset.ref(name="myasset")] # Get events for asset named
"myasset".
+ outlet_events[AssetAlias(name="myalias")] # Get events for asset alias
named "myalias".
+
+Alternatively, two helpers ``for_asset`` and ``for_asset_alias`` are added as
shortcuts::
+
+ outlet_events.for_asset(name="myasset") # Get events for asset named
"myasset".
+ outlet_events.for_asset_alias(name="myalias") # Get events for asset
alias named "myalias".
-The internal representation of asset event triggers now includes an explicit
``uri`` field, simplifying traceability and
+The internal representation of asset event triggers now also includes an
explicit ``uri`` field, simplifying traceability and
aligning with the broader asset-aware execution model introduced in Airflow
3.0. DAG authors interacting directly with
``inlet_events`` may need to update logic that assumes the previous structure.
diff --git a/reproducible_build.yaml b/reproducible_build.yaml
index 86b2aff64f8..a803e46d2a7 100644
--- a/reproducible_build.yaml
+++ b/reproducible_build.yaml
@@ -1,2 +1,2 @@
-release-notes-hash: 16a2f989fbd9f4e10ab0327b047d3cba
-source-date-epoch: 1745160956
+release-notes-hash: 7a4d74c2b9ccbedb3832360ad7d8ce99
+source-date-epoch: 1745216675
