Add KafkaMessageQueueTrigger for enhanced message queue trigger usability on Kafka queue

[dingo4dev]

Closes #515225.

Why

While using the MessageQueueTrigger in Airflow 3.0+, the parameters in the common message queue trigger are not specific enough, leading to potential issues like unclear usage, difficulty in understanding, or unexpected behavior when using it on Kafka

What

This PR introduces the KafkaMessageQueueTrigger class to specify the parameters for the message queue trigger to enhance the usability

[boring-cyborg]

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

• Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
• In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
• Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
• Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
• Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
• Be sure to read the Airflow Coding style.
• Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
  Apache Airflow is a community-driven project and together we are making it better 🚀.
  In case of doubts contact the developers at:
  Mailing List: dev@airflow.apache.org
  Slack: https://s.apache.org/airflow-slack

[Copilot]

Pull Request Overview

This PR introduces the KafkaMessageQueueTrigger to provide a more specific interface for Kafka-based message queues in Airflow, along with a suite of tests, example DAGs, and documentation updates.

• Adds unit and system tests to verify the new trigger’s behavior.
• Implements KafkaMessageQueueTrigger and updates provider metadata, documentation, and version numbers accordingly.

Reviewed Changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
providers/apache/kafka/tests/unit/apache/kafka/triggers/test_msg_queue.py	Adds tests to verify queue URI generation and trigger serialization/run behavior for KafkaMessageQueueTrigger.
providers/apache/kafka/tests/system/apache/kafka/example_dag_message_queue_trigger.py	Updates example DAG to reference the correct apply_function for MessageQueueTrigger usage.
providers/apache/kafka/tests/system/apache/kafka/example_dag_kafka_message_queue_trigger.py	Introduces an example DAG demonstrating usage of KafkaMessageQueueTrigger.
providers/apache/kafka/src/airflow/providers/apache/kafka/triggers/msg_queue.py	Implements the KafkaMessageQueueTrigger class with Kafka-specific logic for queue URI generation and connection handling.
providers/apache/kafka/src/airflow/providers/apache/kafka/get_provider_info.py	Updates provider info to include the new trigger module.
providers/apache/kafka/src/airflow/providers/apache/kafka/init.py	Bumps the version from 1.9.0 to 1.9.1.
providers/apache/kafka/pyproject.toml	Updates package version and documentation/changelog URLs.
providers/apache/kafka/provider.yaml	Lists the new version 1.9.1.
providers/apache/kafka/docs/triggers.rst	Adds documentation for KafkaMessageQueueTrigger.
providers/apache/kafka/docs/message-queues/index.rst	Updates message-queue docs to reference the new trigger.
providers/apache/kafka/docs/index.rst	Updates version information.
providers/apache/kafka/docs/changelog.rst	Adds changelog entries for 1.9.1.
providers/apache/kafka/README.rst	Updates version and documentation URLs.

[dingo4dev]

TBR

[vincbeck]

nits

[dingo4dev]

@vincbeck Thanks for the reviews 😄

[jason810496]

Thanks for the PR!
After your change, the usage is much more clear.

IMO, we should also update the KafkaMessageQueueProvider to reduce the inconsistency on both side.

We could reuse your get_kafka_queue_uri in KafkaMessageQueueProvider.trigger_kwargs as well.

[dingo4dev]

Thanks for the PR!
After your change, the usage is much clear.

IMO, we should also update the KafkaMessageQueueProvider to reduce the inconsistency on both sides.

We could reuse your get_kafka_queue_uri in KafkaMessageQueueProvider.trigger_kwargs as well.

@jason810496 TIA.

ACK. I think we might still need to keep the feasibility for the direct access MessageQueueTrigger.
And we can move the function to utils file/folder for better readability.

Perhaps should we open new PRs for it?

[jason810496]

Perhaps should we open new PRs for it?

ACK. I think we might still need to keep the feasibility for the direct access MessageQueueTrigger.
And we can move the function to utils file/folder for better readability.

Sure, having a common module as utils is good and refactoring in followup PR is more suitable.

[boring-cyborg]

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.