apache-airflow-providers-telegram 4.4.0rc1__tar.gz → 4.5.0__tar.gz

{apache_airflow_providers_telegram-4.4.0rc1 → apache_airflow_providers_telegram-4.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apache-airflow-providers-telegram
-Version: 4.4.0rc1
+Version: 4.5.0
 Summary: Provider package apache-airflow-providers-telegram for Apache Airflow
 Keywords: airflow-provider,telegram,airflow,integration
 Author-email: Apache Software Foundation <dev@airflow.apache.org>
@@ -19,12 +19,13 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: System :: Monitoring
-Requires-Dist: apache-airflow>=2.6.0.dev0
+Requires-Dist: apache-airflow>=2.7.0
 Requires-Dist: python-telegram-bot>=20.2
 Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
-Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.5.0/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.5.0
 Project-URL: Slack Chat, https://s.apache.org/airflow-slack
 Project-URL: Source Code, https://github.com/apache/airflow
 Project-URL: Twitter, https://twitter.com/ApacheAirflow
@@ -74,7 +75,7 @@ Project-URL: YouTube, https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/
 
 Package ``apache-airflow-providers-telegram``
 
-Release: ``4.4.0.rc1``
+Release: ``4.5.0``
 
 
 `Telegram <https://telegram.org/>`__
@@ -87,7 +88,7 @@ This is a provider package for ``telegram`` provider. All classes for this provi
 are in ``airflow.providers.telegram`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.5.0/>`_.
 
 Installation
 ------------
@@ -96,7 +97,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-telegram``
 
-The package supports the following python versions: 3.8,3.9,3.10,3.11
+The package supports the following python versions: 3.8,3.9,3.10,3.11,3.12
 
 Requirements
 ------------
@@ -104,9 +105,9 @@ Requirements
 =======================  ==================
 PIP package              Version required
 =======================  ==================
-``apache-airflow``       ``>=2.6.0``
+``apache-airflow``       ``>=2.7.0``
 ``python-telegram-bot``  ``>=20.2``
 =======================  ==================
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.5.0/changelog.html>`_.

{apache_airflow_providers_telegram-4.4.0rc1 → apache_airflow_providers_telegram-4.5.0}/README.rst

@@ -42,7 +42,7 @@
 
 Package ``apache-airflow-providers-telegram``
 
-Release: ``4.4.0.rc1``
+Release: ``4.5.0``
 
 
 `Telegram <https://telegram.org/>`__
@@ -55,7 +55,7 @@ This is a provider package for ``telegram`` provider. All classes for this provi
 are in ``airflow.providers.telegram`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.5.0/>`_.
 
 Installation
 ------------
@@ -64,7 +64,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-telegram``
 
-The package supports the following python versions: 3.8,3.9,3.10,3.11
+The package supports the following python versions: 3.8,3.9,3.10,3.11,3.12
 
 Requirements
 ------------
@@ -72,9 +72,9 @@ Requirements
 =======================  ==================
 PIP package              Version required
 =======================  ==================
-``apache-airflow``       ``>=2.6.0``
+``apache-airflow``       ``>=2.7.0``
 ``python-telegram-bot``  ``>=20.2``
 =======================  ==================
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.5.0/changelog.html>`_.

{apache_airflow_providers_telegram-4.4.0rc1 → apache_airflow_providers_telegram-4.5.0}/airflow/providers/telegram/__init__.py

@@ -27,7 +27,7 @@ import packaging.version
 
 __all__ = ["__version__"]
 
-__version__ = "4.4.0"
+__version__ = "4.5.0"
 
 try:
     from airflow import __version__ as airflow_version
@@ -35,8 +35,8 @@ except ImportError:
     from airflow.version import version as airflow_version
 
 if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
-    "2.6.0"
+    "2.7.0"
 ):
     raise RuntimeError(
-        f"The package `apache-airflow-providers-telegram:{__version__}` needs Apache Airflow 2.6.0+"
+        f"The package `apache-airflow-providers-telegram:{__version__}` needs Apache Airflow 2.7.0+"
     )

{apache_airflow_providers_telegram-4.4.0rc1 → apache_airflow_providers_telegram-4.5.0}/airflow/providers/telegram/get_provider_info.py

@@ -28,9 +28,11 @@ def get_provider_info():
         "name": "Telegram",
         "description": "`Telegram <https://telegram.org/>`__\n",
         "state": "ready",
-        "source-date-epoch": 1705912297,
+        "source-date-epoch": 1714477687,
         "versions": [
+            "4.5.0",
             "4.4.0",
+            "4.3.1",
             "4.3.0",
             "4.2.0",
             "4.1.1",
@@ -48,7 +50,7 @@ def get_provider_info():
             "1.0.1",
             "1.0.0",
         ],
-        "dependencies": ["apache-airflow>=2.6.0", "python-telegram-bot>=20.2"],
+        "dependencies": ["apache-airflow>=2.7.0", "python-telegram-bot>=20.2"],
         "integrations": [
             {
                 "integration-name": "Telegram",
@@ -64,6 +66,12 @@ def get_provider_info():
                 "python-modules": ["airflow.providers.telegram.operators.telegram"],
             }
         ],
+        "connection-types": [
+            {
+                "hook-class-name": "airflow.providers.telegram.hooks.telegram.TelegramHook",
+                "connection-type": "telegram",
+            }
+        ],
         "hooks": [
             {"integration-name": "Telegram", "python-modules": ["airflow.providers.telegram.hooks.telegram"]}
         ],

{apache_airflow_providers_telegram-4.4.0rc1 → apache_airflow_providers_telegram-4.5.0}/airflow/providers/telegram/hooks/telegram.py

@@ -16,9 +16,11 @@
 # specific language governing permissions and limitations
 # under the License.
 """Hook for Telegram."""
+
 from __future__ import annotations
 
 import asyncio
+from typing import Any
 
 import telegram
 import tenacity
@@ -38,14 +40,15 @@ class TelegramHook(BaseHook):
     chat_id can also be provided in the connection using 'host' field in connection.
     Following is the details of a telegram_connection:
     name: 'telegram-connection-name'
-    conn_type: 'http'
-    password: 'TELEGRAM_TOKEN'
+    conn_type: 'telegram'
+    password: 'TELEGRAM_TOKEN' (optional)
     host: 'chat_id' (optional)
     Examples:
     .. code-block:: python
 
         # Create hook
         telegram_hook = TelegramHook(telegram_conn_id="telegram_default")
+        telegram_hook = TelegramHook()  # will use telegram_default
         # or telegram_hook = TelegramHook(telegram_conn_id='telegram_default', chat_id='-1xxx')
         # or telegram_hook = TelegramHook(token='xxx:xxx', chat_id='-1xxx')
 
@@ -58,21 +61,33 @@ class TelegramHook(BaseHook):
     :param chat_id: optional chat_id of the telegram chat/channel/group
     """
 
+    conn_name_attr = "telegram_conn_id"
+    default_conn_name = "telegram_default"
+    conn_type = "telegram"
+    hook_name = "Telegram"
+
     def __init__(
         self,
-        telegram_conn_id: str | None = None,
+        telegram_conn_id: str | None = default_conn_name,
         token: str | None = None,
         chat_id: str | None = None,
-        **kwargs,
     ) -> None:
-        super().__init__(**kwargs)
+        super().__init__()
         self.token = self.__get_token(token, telegram_conn_id)
         self.chat_id = self.__get_chat_id(chat_id, telegram_conn_id)
         self.connection = self.get_conn()
 
+    @classmethod
+    def get_ui_field_behaviour(cls) -> dict[str, Any]:
+        """Return custom field behaviour."""
+        return {
+            "hidden_fields": ["schema", "extra", "login", "port", "extra"],
+            "relabeling": {},
+        }
+
     def get_conn(self) -> telegram.Bot:
         """
-        Returns the telegram bot client.
+        Return the telegram bot client.
 
         :return: telegram bot client
         """
@@ -80,7 +95,7 @@ class TelegramHook(BaseHook):
 
     def __get_token(self, token: str | None, telegram_conn_id: str | None) -> str:
         """
-        Returns the telegram API token.
+        Return the telegram API token.
 
         :param token: telegram API token
         :param telegram_conn_id: telegram connection name
@@ -101,7 +116,7 @@ class TelegramHook(BaseHook):
 
     def __get_chat_id(self, chat_id: str | None, telegram_conn_id: str | None) -> str | None:
         """
-        Returns the telegram chat ID for a chat/channel/group.
+        Return the telegram chat ID for a chat/channel/group.
 
         :param chat_id: optional chat ID
         :param telegram_conn_id: telegram connection name
@@ -123,7 +138,7 @@ class TelegramHook(BaseHook):
     )
     def send_message(self, api_params: dict) -> None:
         """
-        Sends the message to a telegram channel or chat.
+        Send the message to a telegram channel or chat.
 
         :param api_params: params for telegram_instance.send_message. It can also be used to override chat_id
         """

{apache_airflow_providers_telegram-4.4.0rc1 → apache_airflow_providers_telegram-4.5.0}/airflow/providers/telegram/operators/telegram.py

@@ -16,6 +16,7 @@
 # specific language governing permissions and limitations
 # under the License.
 """Operator for Telegram."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Sequence
@@ -72,7 +73,7 @@ class TelegramOperator(BaseOperator):
         super().__init__(**kwargs)
 
     def execute(self, context: Context) -> None:
-        """Calls the TelegramHook to post the provided Telegram message."""
+        """Call the TelegramHook to post the provided Telegram message."""
         if self.text:
             self.telegram_kwargs["text"] = self.text
 

{apache_airflow_providers_telegram-4.4.0rc1 → apache_airflow_providers_telegram-4.5.0}/pyproject.toml

@@ -28,7 +28,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "apache-airflow-providers-telegram"
-version = "4.4.0.rc1"
+version = "4.5.0"
 description = "Provider package apache-airflow-providers-telegram for Apache Airflow"
 readme = "README.rst"
 authors = [
@@ -51,17 +51,18 @@ classifiers = [
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Topic :: System :: Monitoring",
 ]
 requires-python = "~=3.8"
 dependencies = [
-    "apache-airflow>=2.6.0.dev0",
+    "apache-airflow>=2.7.0",
     "python-telegram-bot>=20.2",
 ]
 
 [project.urls]
-"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0"
-"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.4.0/changelog.html"
+"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.5.0"
+"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.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"