apache-airflow-providers-telegram 4.6.0__tar.gz → 4.7.0__tar.gz

{apache_airflow_providers_telegram-4.6.0 → apache_airflow_providers_telegram-4.7.0}/PKG-INFO

@@ -1,11 +1,11 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: apache-airflow-providers-telegram
-Version: 4.6.0
+Version: 4.7.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>
 Maintainer-email: Apache Software Foundation <dev@airflow.apache.org>
-Requires-Python: ~=3.8
+Requires-Python: ~=3.9
 Description-Content-Type: text/x-rst
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -15,20 +15,19 @@ Classifier: Intended Audience :: System Administrators
 Classifier: Framework :: Apache Airflow
 Classifier: Framework :: Apache Airflow :: Provider
 Classifier: License :: OSI Approved :: Apache Software License
-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.8.0
+Requires-Dist: apache-airflow>=2.9.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.6.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.6.0
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.0/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.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
+Project-URL: Twitter, https://x.com/ApacheAirflow
 Project-URL: YouTube, https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/
 
 
@@ -75,7 +74,7 @@ Project-URL: YouTube, https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/
 
 Package ``apache-airflow-providers-telegram``
 
-Release: ``4.6.0``
+Release: ``4.7.0``
 
 
 `Telegram <https://telegram.org/>`__
@@ -88,7 +87,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.6.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.0/>`_.
 
 Installation
 ------------
@@ -97,7 +96,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,3.12
+The package supports the following python versions: 3.9,3.10,3.11,3.12
 
 Requirements
 ------------
@@ -105,9 +104,9 @@ Requirements
 =======================  ==================
 PIP package              Version required
 =======================  ==================
-``apache-airflow``       ``>=2.8.0``
+``apache-airflow``       ``>=2.9.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.6.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.0/changelog.html>`_.

{apache_airflow_providers_telegram-4.6.0 → apache_airflow_providers_telegram-4.7.0}/README.rst

@@ -42,7 +42,7 @@
 
 Package ``apache-airflow-providers-telegram``
 
-Release: ``4.6.0``
+Release: ``4.7.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.6.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.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,3.12
+The package supports the following python versions: 3.9,3.10,3.11,3.12
 
 Requirements
 ------------
@@ -72,9 +72,9 @@ Requirements
 =======================  ==================
 PIP package              Version required
 =======================  ==================
-``apache-airflow``       ``>=2.8.0``
+``apache-airflow``       ``>=2.9.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.6.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.0/changelog.html>`_.

{apache_airflow_providers_telegram-4.6.0 → apache_airflow_providers_telegram-4.7.0}/airflow/providers/telegram/__init__.py

@@ -29,11 +29,11 @@ from airflow import __version__ as airflow_version
 
 __all__ = ["__version__"]
 
-__version__ = "4.6.0"
+__version__ = "4.7.0"
 
 if packaging.version.parse(packaging.version.parse(airflow_version).base_version) < packaging.version.parse(
-    "2.8.0"
+    "2.9.0"
 ):
     raise RuntimeError(
-        f"The package `apache-airflow-providers-telegram:{__version__}` needs Apache Airflow 2.8.0+"
+        f"The package `apache-airflow-providers-telegram:{__version__}` needs Apache Airflow 2.9.0+"
     )

{apache_airflow_providers_telegram-4.6.0 → apache_airflow_providers_telegram-4.7.0}/airflow/providers/telegram/get_provider_info.py

@@ -28,8 +28,9 @@ def get_provider_info():
         "name": "Telegram",
         "description": "`Telegram <https://telegram.org/>`__\n",
         "state": "ready",
-        "source-date-epoch": 1723970613,
+        "source-date-epoch": 1734537315,
         "versions": [
+            "4.7.0",
             "4.6.0",
             "4.5.2",
             "4.5.1",
@@ -53,7 +54,7 @@ def get_provider_info():
             "1.0.1",
             "1.0.0",
         ],
-        "dependencies": ["apache-airflow>=2.8.0", "python-telegram-bot>=20.2"],
+        "dependencies": ["apache-airflow>=2.9.0", "python-telegram-bot>=20.2"],
         "integrations": [
             {
                 "integration-name": "Telegram",

{apache_airflow_providers_telegram-4.6.0 → apache_airflow_providers_telegram-4.7.0}/airflow/providers/telegram/hooks/telegram.py

@@ -158,3 +158,33 @@ class TelegramHook(BaseHook):
 
         response = asyncio.run(self.connection.send_message(**kwargs))
         self.log.debug(response)
+
+    @tenacity.retry(
+        retry=tenacity.retry_if_exception_type(telegram.error.TelegramError),
+        stop=tenacity.stop_after_attempt(5),
+        wait=tenacity.wait_fixed(1),
+    )
+    def send_file(self, api_params: dict) -> None:
+        """
+        Send the file to a telegram channel or chat.
+
+        :param api_params: params for telegram_instance.send_document. It can also be used to override chat_id
+        """
+        kwargs: dict[str, Any] = {}
+
+        if self.chat_id is not None:
+            kwargs["chat_id"] = self.chat_id
+        kwargs.update(api_params)
+
+        if "file" not in kwargs or kwargs["file"] is None:
+            raise AirflowException(
+                "'file' parameter must be provided for sending a Telegram document message"
+            )
+
+        kwargs["document"] = kwargs.pop("file")  # rename 'file' to 'document'
+
+        if kwargs.get("chat_id") is None:
+            raise AirflowException("'chat_id' must be provided for telegram document message")
+
+        response = asyncio.run(self.connection.send_document(**kwargs))
+        self.log.debug(response)

{apache_airflow_providers_telegram-4.6.0 → apache_airflow_providers_telegram-4.7.0}/airflow/providers/telegram/operators/telegram.py

@@ -19,7 +19,8 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Sequence
+from collections.abc import Sequence
+from typing import TYPE_CHECKING
 
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator
@@ -83,3 +84,59 @@ class TelegramOperator(BaseOperator):
             chat_id=self.chat_id,
         )
         telegram_hook.send_message(self.telegram_kwargs)
+
+
+class TelegramFileOperator(BaseOperator):
+    """
+    This operator allows you to send file to Telegram using Telegram Bot API.
+
+    Takes both Telegram Bot API token directly or connection that has Telegram token in password field.
+    If both supplied, token parameter will be given precedence.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:TelegramOperator`
+
+    :param telegram_conn_id: Telegram connection ID which its password is Telegram API token
+    :param token: Telegram API Token
+    :param chat_id: Telegram chat ID for a chat/channel/group
+    :param file: The path of the file or media to be sent via Telegram
+    :param telegram_kwargs: Extra args to be passed to telegram client
+    """
+
+    template_fields: Sequence[str] = "chat_id"
+    ui_color = "#FFBA40"
+
+    def __init__(
+        self,
+        *,
+        telegram_conn_id: str = "telegram_default",
+        token: str | None = None,
+        chat_id: str | None = None,
+        file: str,
+        telegram_kwargs: dict | None = None,
+        **kwargs,
+    ):
+        self.chat_id = chat_id
+        self.token = token
+        self.telegram_kwargs = telegram_kwargs or {}
+        self.file = file
+
+        if telegram_conn_id is None:
+            raise AirflowException("No valid Telegram connection id supplied.")
+
+        self.telegram_conn_id = telegram_conn_id
+
+        super().__init__(**kwargs)
+
+    def execute(self, context: Context) -> None:
+        """Call the TelegramHook to send the provided Telegram file."""
+        if self.file:
+            self.telegram_kwargs["file"] = self.file
+
+        telegram_hook = TelegramHook(
+            telegram_conn_id=self.telegram_conn_id,
+            token=self.token,
+            chat_id=self.chat_id,
+        )
+        telegram_hook.send_file(**self.telegram_kwargs)

{apache_airflow_providers_telegram-4.6.0 → apache_airflow_providers_telegram-4.7.0}/pyproject.toml

@@ -21,14 +21,13 @@
 
 # IF YOU WANT TO MODIFY THIS FILE, YOU SHOULD MODIFY THE TEMPLATE
 # `pyproject_TEMPLATE.toml.jinja2` IN the `dev/breeze/src/airflow_breeze/templates` DIRECTORY
-#
 [build-system]
-requires = ["flit_core >=3.2,<4"]
+requires = ["flit_core==3.10.1"]
 build-backend = "flit_core.buildapi"
 
 [project]
 name = "apache-airflow-providers-telegram"
-version = "4.6.0"
+version = "4.7.0"
 description = "Provider package apache-airflow-providers-telegram for Apache Airflow"
 readme = "README.rst"
 authors = [
@@ -47,26 +46,25 @@ classifiers = [
     "Framework :: Apache Airflow",
     "Framework :: Apache Airflow :: Provider",
     "License :: OSI Approved :: Apache Software License",
-    "Programming Language :: Python :: 3.8",
     "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"
+requires-python = "~=3.9"
 dependencies = [
-    "apache-airflow>=2.8.0",
+    "apache-airflow>=2.9.0",
     "python-telegram-bot>=20.2",
 ]
 
 [project.urls]
-"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.6.0"
-"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.6.0/changelog.html"
+"Documentation" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.0"
+"Changelog" = "https://airflow.apache.org/docs/apache-airflow-providers-telegram/4.7.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"
-"Twitter" = "https://twitter.com/ApacheAirflow"
+"Twitter" = "https://x.com/ApacheAirflow"
 "YouTube" = "https://www.youtube.com/channel/UCSXwxpWZQ7XZ1WL3wqevChA/"
 
 [project.entry-points."apache_airflow_provider"]