Repository: apache/airflow

Issue:
Add `JiraNotifier`
### Body

Similar to the [notifiers we already have](https://airflow.apache.org/docs/apache-airflow-providers/core-extensions/notifications.html) we want to add `JiraNotifier` to cut a Jira ticket.
This is very useful to be set with `on_failure_callback`.

You can view other PRs that added similar functionality: [ChimeNotifier](https://github.com/apache/airflow/pull/32222), [SmtpNotifier](https://github.com/apache/airflow/pull/31359)

### Committer

- [X] I acknowledge that I am a maintainer/committer of the Apache Airflow project.


Discussion:
Hi @eladkal, I'd like to look into this.
> Hi @eladkal, I'd like to look into this.

Assigned

Resolving patch:
diff --git a/airflow/providers/atlassian/jira/notifications/__init__.py b/airflow/providers/atlassian/jira/notifications/__init__.py
new file mode 100644
--- /dev/null
+++ b/airflow/providers/atlassian/jira/notifications/__init__.py
@@ -0,0 +1,16 @@
+# 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.
diff --git a/airflow/providers/atlassian/jira/notifications/jira.py b/airflow/providers/atlassian/jira/notifications/jira.py
new file mode 100644
--- /dev/null
+++ b/airflow/providers/atlassian/jira/notifications/jira.py
@@ -0,0 +1,84 @@
+# 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 functools import cached_property
+from typing import Any
+
+from airflow.exceptions import AirflowOptionalProviderFeatureException
+from airflow.providers.atlassian.jira.hooks.jira import JiraHook
+
+try:
+    from airflow.notifications.basenotifier import BaseNotifier
+except ImportError:
+    raise AirflowOptionalProviderFeatureException(
+        "Failed to import BaseNotifier. This feature is only available in Airflow versions >= 2.6.0"
+    )
+
+
+class JiraNotifier(BaseNotifier):
+    """
+    Jira notifier for creating Jira issues upon failures.
+
+    :param jira_conn_id: The HTTP connection ID for the Jira instance.
+    :param proxies: Proxies to make the Jira REST API call. Optional
+    :param description: The content for the body of the issue
+    :param summary: The title of the issue
+    :param project_id: The ID of the project under which the issue will be created
+    :param issue_type_id: The ID of the issue category
+    :param labels: The labels to be applied to the issue
+    """
+
+    template_fields = ("description", "summary", "project_id", "issue_type_id", "labels")
+
+    def __init__(
+        self,
+        *,
+        jira_conn_id: str = JiraHook.default_conn_name,
+        proxies: Any | None = None,
+        description: str,
+        summary: str,
+        project_id: int,
+        issue_type_id: int,
+        labels: list[str] | None = None,
+    ):
+        super().__init__()
+        self.jira_conn_id = jira_conn_id
+        self.proxies = proxies
+        self.description = description
+        self.summary = summary
+        self.project_id = project_id
+        self.issue_type_id = issue_type_id
+        self.labels = labels or []
+
+    @cached_property
+    def hook(self) -> JiraHook:
+        return JiraHook(jira_conn_id=self.jira_conn_id, proxies=self.proxies)
+
+    def notify(self, context) -> None:
+        fields = dict(
+            description=self.description,
+            summary=self.summary,
+            project=dict(id=self.project_id),
+            issuetype=dict(id=self.issue_type_id),
+            labels=self.labels,
+        )
+        self.hook.get_conn().create_issue(fields)
+
+
+send_jira_notification = JiraNotifier


Test patch:
diff --git a/tests/providers/atlassian/jira/notifications/__init__.py b/tests/providers/atlassian/jira/notifications/__init__.py
new file mode 100644
--- /dev/null
+++ b/tests/providers/atlassian/jira/notifications/__init__.py
@@ -0,0 +1,16 @@
+# 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.
diff --git a/tests/providers/atlassian/jira/notifications/test_jira.py b/tests/providers/atlassian/jira/notifications/test_jira.py
new file mode 100644
--- /dev/null
+++ b/tests/providers/atlassian/jira/notifications/test_jira.py
@@ -0,0 +1,94 @@
+# 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 unittest import mock
+
+import pytest
+
+from airflow.operators.empty import EmptyOperator
+from airflow.providers.atlassian.jira.hooks.jira import JiraHook
+from airflow.providers.atlassian.jira.notifications.jira import JiraNotifier, send_jira_notification
+
+pytestmark = pytest.mark.db_test
+
+jira_create_issue_payload = dict(
+    description="Test operator failed",
+    summary="Test Jira issue",
+    project=dict(id=10000),
+    issuetype=dict(id=10003),
+    labels=["airflow-dag-failure"],
+)
+
+
+class TestJiraNotifier:
+    @mock.patch.object(JiraHook, "get_conn")
+    def test_jira_notifier(self, mock_jira_hook, dag_maker):
+        with dag_maker("test_jira_notifier") as dag:
+            EmptyOperator(task_id="task1")
+
+        notifier = send_jira_notification(
+            jira_conn_id="jira_default",
+            project_id=10000,
+            description="Test operator failed",
+            summary="Test Jira issue",
+            issue_type_id=10003,
+            labels=["airflow-dag-failure"],
+        )
+        notifier({"dag": dag})
+        mock_jira_hook.return_value.create_issue.assert_called_once_with(jira_create_issue_payload)
+
+    @mock.patch.object(JiraHook, "get_conn")
+    def test_jira_notifier_with_notifier_class(self, mock_jira_hook, dag_maker):
+        with dag_maker("test_jira_notifier") as dag:
+            EmptyOperator(task_id="task1")
+
+        notifier = JiraNotifier(
+            jira_conn_id="jira_default",
+            project_id=10000,
+            description="Test operator failed",
+            summary="Test Jira issue",
+            issue_type_id=10003,
+            labels=["airflow-dag-failure"],
+        )
+        notifier({"dag": dag})
+        mock_jira_hook.return_value.create_issue.assert_called_once_with(jira_create_issue_payload)
+
+    @mock.patch.object(JiraHook, "get_conn")
+    def test_jira_notifier_templated(self, mock_jira_hook, dag_maker):
+        with dag_maker("test_jira_notifier") as dag:
+            EmptyOperator(task_id="task1")
+
+        notifier = send_jira_notification(
+            jira_conn_id="jira_default",
+            project_id=10000,
+            description="Test operator failed for dag: {{ dag.dag_id }}.",
+            summary="Test Jira issue",
+            issue_type_id=10003,
+            labels=["airflow-dag-failure"],
+        )
+        notifier({"dag": dag})
+        mock_jira_hook.return_value.create_issue.assert_called_once_with(
+            dict(
+                description="Test operator failed for dag: test_jira_notifier.",
+                summary="Test Jira issue",
+                project=dict(id=10000),
+                issuetype=dict(id=10003),
+                labels=["airflow-dag-failure"],
+            )
+        )