pyTelegramBotAPI 4.27.0__tar.gz → 4.28.0__tar.gz

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyTelegramBotAPI
-Version: 4.27.0
+Version: 4.28.0
 Summary: Python Telegram bot api.
 Project-URL: Homepage, https://github.com/eternnoir/pyTelegramBotAPI
 Project-URL: Documentation, https://pytba.readthedocs.org
@@ -20,9 +20,10 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.9
+Requires-Dist: aiohttp
+Requires-Dist: pytest
 Requires-Dist: requests
-Provides-Extra: aiohttp
-Requires-Dist: aiohttp; extra == 'aiohttp'
+Requires-Dist: wheel
 Provides-Extra: coloredlogs
 Requires-Dist: coloredlogs; extra == 'coloredlogs'
 Provides-Extra: fastapi
@@ -53,7 +54,7 @@ Description-Content-Type: text/markdown
 <p align="center">A simple, but extensible Python implementation for the <a href="https://core.telegram.org/bots/api">Telegram Bot API</a>.</p>
 <p align="center">Both synchronous and asynchronous.</p>
 
-## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#april-11-2025"><img src="https://img.shields.io/badge/Bot%20API-9.0-blue?logo=telegram" alt="Supported Bot API version"></a>
+## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#july-3-2025"><img src="https://img.shields.io/badge/Bot%20API-9.1-blue?logo=telegram" alt="Supported Bot API version"></a>
 
 <h2><a href='https://pytba.readthedocs.io/en/latest/index.html'>Official documentation</a></h2>
 <h2><a href='https://pytba.readthedocs.io/ru/latest/index.html'>Official ru documentation</a></h2>

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/README.md

@@ -10,7 +10,7 @@
 <p align="center">A simple, but extensible Python implementation for the <a href="https://core.telegram.org/bots/api">Telegram Bot API</a>.</p>
 <p align="center">Both synchronous and asynchronous.</p>
 
-## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#april-11-2025"><img src="https://img.shields.io/badge/Bot%20API-9.0-blue?logo=telegram" alt="Supported Bot API version"></a>
+## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#july-3-2025"><img src="https://img.shields.io/badge/Bot%20API-9.1-blue?logo=telegram" alt="Supported Bot API version"></a>
 
 <h2><a href='https://pytba.readthedocs.io/en/latest/index.html'>Official documentation</a></h2>
 <h2><a href='https://pytba.readthedocs.io/ru/latest/index.html'>Official ru documentation</a></h2>

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/docs/source/conf.py

@@ -22,7 +22,7 @@ author = 'coder2020official'
 copyright = f'2022-{datetime.now().year}, {author}'
 
 # The full version, including alpha/beta/rc tags
-release = '4.27.0'
+release = '4.28.0'
 
 
 # -- General configuration ---------------------------------------------------

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pyTelegramBotAPI"
-version = "4.27.0"
+version = "4.28.0"
 description = "Python Telegram bot api."
 authors = [{name = "eternnoir", email = "eternnoir@gmail.com"}]
 license = {text = "GPL2"}
@@ -22,7 +22,7 @@ classifiers = [
     "Environment :: Console",
     "License :: OSI Approved :: GNU General Public License v2 (GPLv2)"
 ]
-dependencies = ["requests"]
+dependencies = ["pytest", "requests", "wheel", "aiohttp"]
 
 [project.urls]
 Homepage = "https://github.com/eternnoir/pyTelegramBotAPI"
@@ -35,7 +35,6 @@ Issues = "https://github.com/eternnoir/pyTelegramBotAPI/issues"
 json = ["ujson"]
 PIL = ["Pillow"]
 redis = ["redis>=3.4.1"]
-aiohttp = ["aiohttp"]
 fastapi = ["fastapi"]
 uvicorn = ["uvicorn"]
 psutil = ["psutil"]

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/requirements.txt

@@ -1,4 +1,4 @@
 pytest
-requests==2.32.0
+requests==2.32.4
 wheel==0.38.1
 aiohttp==3.10.11

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/telebot/__init__.py

@@ -2104,6 +2104,90 @@ class TeleBot:
             message_thread_id=message_thread_id, protect_content=protect_content, remove_caption=remove_caption)
         return [types.MessageID.de_json(message_id) for message_id in result]
     
+    def send_checklist(
+            self, business_connection_id: str, chat_id: Union[int, str],
+            checklist: types.InputChecklist,
+            disable_notification: Optional[bool]=None,
+            protect_content: Optional[bool]=None,
+            message_effect_id: Optional[str]=None,
+            reply_parameters: Optional[types.ReplyParameters]=None,
+            reply_markup: Optional[types.InlineKeyboardMarkup]=None) -> types.Message:
+        """
+        Use this method to send a checklist on behalf of a connected business account. On success,
+        the sent Message is returned.
+
+        Telegram documentation: https://core.telegram.org/bots/api#sendchecklist
+
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent
+        :type business_connection_id: :obj:`str`
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param checklist: A JSON-serialized object for the checklist to send
+        :type checklist: :class:`telebot.types.InputChecklist`
+
+        :param disable_notification: Sends the message silently. Users will receive a notification with no sound.
+        :type disable_notification: :obj:`bool`
+
+        :param protect_content: Protects the contents of the sent message from forwarding and saving
+        :type protect_content: :obj:`bool`
+
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only
+        :type message_effect_id: :obj:`str`
+
+        :param reply_parameters: Additional parameters for replies to messages
+        :type reply_parameters: :class:`telebot.types.ReplyParameters`
+
+        :param reply_markup: Additional interface options. A JSON-serialized object for an inline keyboard.
+        :type reply_markup: :class:`telebot.types.InlineKeyboardMarkup`
+
+        :return: On success, the sent Message is returned.
+        :rtype: :class:`telebot.types.Message`
+        """
+        disable_notification = self.disable_notification if (disable_notification is None) else disable_notification
+        protect_content = self.protect_content if (protect_content is None) else protect_content
+        
+        if reply_parameters and (reply_parameters.allow_sending_without_reply is None):
+            reply_parameters.allow_sending_without_reply = self.allow_sending_without_reply
+
+        return types.Message.de_json(
+            apihelper.send_checklist(
+                self.token, business_connection_id, chat_id, checklist, disable_notification=disable_notification,
+                protect_content=protect_content, message_effect_id=message_effect_id,
+                reply_parameters=reply_parameters, reply_markup=reply_markup))
+    
+    def edit_message_checklist(
+            self, business_connection_id: str, chat_id: Union[int, str],
+            message_id: int, checklist: types.InputChecklist,
+            reply_markup: Optional[types.InlineKeyboardMarkup]=None) -> types.Message:
+        """
+        Use this method to edit a checklist on behalf of a connected business account. On success,
+        the edited Message is returned.
+
+        Telegram documentation: https://core.telegram.org/bots/api#editmessagechecklist
+
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent
+        :type business_connection_id: :obj:`str`
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param message_id: Unique identifier for the target message
+        :type message_id: :obj:`int`
+
+        :param checklist: A JSON-serialized object for the new checklist
+        :type checklist: :class:`telebot.types.InputChecklist`
+
+        :param reply_markup: Additional interface options. A JSON-serialized object for an inline keyboard.
+        :type reply_markup: :class:`telebot.types.InlineKeyboardMarkup`
+
+        :return: On success, the edited Message is returned.
+        :rtype: :class:`telebot.types.Message`
+        """
+        return types.Message.de_json(
+            apihelper.edit_message_checklist(
+                self.token, business_connection_id, chat_id, message_id, checklist, reply_markup=reply_markup))
 
     def send_dice(
             self, chat_id: Union[int, str],
@@ -3528,7 +3612,7 @@ class TeleBot:
             proximity_alert_radius: Optional[int]=None,
             live_period: Optional[int]=None,
             business_connection_id: Optional[str]=None
-    ) -> types.Message or bool:
+    ) -> Union[types.Message, bool]:
         """
         Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly
             disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message
@@ -3590,7 +3674,7 @@ class TeleBot:
             inline_message_id: Optional[str]=None, 
             reply_markup: Optional[types.InlineKeyboardMarkup]=None,
             timeout: Optional[int]=None,
-            business_connection_id: Optional[str]=None) -> types.Message or bool:
+            business_connection_id: Optional[str]=None) -> Union[types.Message, bool]:
         """
         Use this method to stop updating a live location message before live_period expires.
         On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.
@@ -5599,7 +5683,7 @@ class TeleBot:
         :param question: Poll question, 1-300 characters
         :type question: :obj:`str`
 
-        :param options: A JSON-serialized list of 2-10 answer options
+        :param options: A JSON-serialized list of 2-12 answer options
         :type options: :obj:`list` of :obj:`InputPollOption` | :obj:`list` of :obj:`str`
 
         :param is_anonymous: True, if the poll needs to be anonymous, defaults to True
@@ -5818,6 +5902,17 @@ class TeleBot:
         """
         return apihelper.answer_pre_checkout_query(
             self.token, pre_checkout_query_id, ok, error_message=error_message)
+    
+    def get_my_star_balance(self) -> types.StarAmount:
+        """
+        Returns the bot's current Telegram Stars balance. On success, returns a StarAmount object.
+        
+        Telegram documentation: https://core.telegram.org/bots/api#getmystarbalance
+
+        :return: On success, returns a StarAmount object.
+        :rtype: :obj:`types.StarAmount`
+        """
+        return types.StarAmount.de_json(apihelper.get_my_star_balance(self.token))
 
 
     def get_star_transactions(self, offset: Optional[int]=None, limit: Optional[int]=None) -> types.StarTransactions:

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/telebot/apihelper.py

@@ -473,6 +473,36 @@ def copy_message(token, chat_id, from_chat_id, message_id, caption=None, parse_m
         payload['video_start_timestamp'] = video_start_timestamp
     return _make_request(token, method_url, params=payload)
 
+def send_checklist(
+        token, business_connection_id, chat_id, checklist,
+        disable_notification=None, protect_content=None, message_effect_id=None,
+        reply_parameters=None, reply_markup=None
+):
+    method_url = r'sendChecklist'
+    payload = {'chat_id': chat_id, 'checklist': checklist, 'business_connection_id': business_connection_id}
+    if disable_notification is not None:
+        payload['disable_notification'] = disable_notification
+    if protect_content is not None:
+        payload['protect_content'] = protect_content
+    if message_effect_id:
+        payload['message_effect_id'] = message_effect_id
+    if reply_parameters:
+        payload['reply_parameters'] = reply_parameters.to_json()
+    if reply_markup:
+        payload['reply_markup'] = _convert_markup(reply_markup)
+    return _make_request(token, method_url, params=payload)
+
+
+def edit_message_checklist(
+        token, business_connection_id, chat_id, message_id, checklist,
+        reply_markup=None
+):
+    method_url = r'editMessageChecklist'
+    payload = {'chat_id': chat_id, 'message_id': message_id, 'checklist': checklist, 'business_connection_id': business_connection_id}
+    if reply_markup:
+        payload['reply_markup'] = _convert_markup(reply_markup)
+    return _make_request(token, method_url, params=payload)
+
 
 def send_dice(
         token, chat_id,
@@ -1817,6 +1847,10 @@ def answer_pre_checkout_query(token, pre_checkout_query_id, ok, error_message=No
         payload['error_message'] = error_message
     return _make_request(token, method_url, params=payload)
 
+def get_my_star_balance(token):
+    method_url = 'getMyStarBalance'
+    return _make_request(token, method_url)
+
 def get_star_transactions(token, offset=None, limit=None):
     method_url = 'getStarTransactions'
     payload = {}

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/telebot/async_telebot.py

@@ -3619,6 +3619,91 @@ class AsyncTeleBot:
         result = await asyncio_helper.copy_messages(self.token, chat_id, from_chat_id, message_ids, disable_notification, message_thread_id,
                                         protect_content, remove_caption)
         return [types.MessageID.de_json(message_id) for message_id in result]
+    
+    async def send_checklist(
+            self, business_connection_id: str, chat_id: Union[int, str],
+            checklist: types.InputChecklist,
+            disable_notification: Optional[bool]=None,
+            protect_content: Optional[bool]=None,
+            message_effect_id: Optional[str]=None,
+            reply_parameters: Optional[types.ReplyParameters]=None,
+            reply_markup: Optional[types.InlineKeyboardMarkup]=None) -> types.Message:
+        """
+        Use this method to send a checklist on behalf of a connected business account. On success,
+        the sent Message is returned.
+
+        Telegram documentation: https://core.telegram.org/bots/api#sendchecklist
+
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent
+        :type business_connection_id: :obj:`str`
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param checklist: A JSON-serialized object for the checklist to send
+        :type checklist: :class:`telebot.types.InputChecklist`
+
+        :param disable_notification: Sends the message silently. Users will receive a notification with no sound.
+        :type disable_notification: :obj:`bool`
+
+        :param protect_content: Protects the contents of the sent message from forwarding and saving
+        :type protect_content: :obj:`bool`
+
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only
+        :type message_effect_id: :obj:`str`
+
+        :param reply_parameters: Additional parameters for replies to messages
+        :type reply_parameters: :class:`telebot.types.ReplyParameters`
+
+        :param reply_markup: Additional interface options. A JSON-serialized object for an inline keyboard.
+        :type reply_markup: :class:`telebot.types.InlineKeyboardMarkup`
+
+        :return: On success, the sent Message is returned.
+        :rtype: :class:`telebot.types.Message`
+        """
+        disable_notification = self.disable_notification if (disable_notification is None) else disable_notification
+        protect_content = self.protect_content if (protect_content is None) else protect_content
+        
+        if reply_parameters and (reply_parameters.allow_sending_without_reply is None):
+            reply_parameters.allow_sending_without_reply = self.allow_sending_without_reply
+
+        return types.Message.de_json(
+            await asyncio_helper.send_checklist(
+                self.token, business_connection_id, chat_id, checklist, disable_notification=disable_notification,
+                protect_content=protect_content, message_effect_id=message_effect_id,
+                reply_parameters=reply_parameters, reply_markup=reply_markup))
+    
+    async def edit_message_checklist(
+            self, business_connection_id: str, chat_id: Union[int, str],
+            message_id: int, checklist: types.InputChecklist,
+            reply_markup: Optional[types.InlineKeyboardMarkup]=None) -> types.Message:
+        """
+        Use this method to edit a checklist on behalf of a connected business account. On success,
+        the edited Message is returned.
+
+        Telegram documentation: https://core.telegram.org/bots/api#editmessagechecklist
+
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent
+        :type business_connection_id: :obj:`str`
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param message_id: Unique identifier for the target message
+        :type message_id: :obj:`int`
+
+        :param checklist: A JSON-serialized object for the new checklist
+        :type checklist: :class:`telebot.types.InputChecklist`
+
+        :param reply_markup: Additional interface options. A JSON-serialized object for an inline keyboard.
+        :type reply_markup: :class:`telebot.types.InlineKeyboardMarkup`
+
+        :return: On success, the edited Message is returned.
+        :rtype: :class:`telebot.types.Message`
+        """
+        return types.Message.de_json(
+            await asyncio_helper.edit_message_checklist(
+                self.token, business_connection_id, chat_id, message_id, checklist, reply_markup=reply_markup))
 
     async def send_dice(
             self, chat_id: Union[int, str],
@@ -7256,8 +7341,15 @@ class AsyncTeleBot:
         :rtype: :obj:`bool`
         """
         return await asyncio_helper.answer_pre_checkout_query(self.token, pre_checkout_query_id, ok, error_message)
-    
 
+
+    async def get_my_star_balance(self) -> types.StarAmount:
+        """
+        A method to get the current Telegram Stars balance of the bot. Requires no parameters.
+        On success, returns a StarAmount object.
+        """
+        return types.StarAmount.de_json(await asyncio_helper.get_my_star_balance(self.token))
+    
     async def get_star_transactions(self, offset: Optional[int]=None, limit: Optional[int]=None) -> types.StarTransactions:
         """
         Returns the bot's Telegram Star transactions in chronological order.

{pytelegrambotapi-4.27.0 → pytelegrambotapi-4.28.0}/telebot/asyncio_helper.py

@@ -477,6 +477,35 @@ async def copy_message(token, chat_id, from_chat_id, message_id, caption=None, p
         payload['video_start_timestamp'] = video_start_timestamp
     return await _process_request(token, method_url, params=payload)
 
+async def send_checklist(
+        token, business_connection_id, chat_id, checklist,
+        disable_notification=None, protect_content=None, message_effect_id=None,
+        reply_parameters=None, reply_markup=None
+):
+    method_url = r'sendChecklist'
+    payload = {'chat_id': chat_id, 'checklist': checklist, 'business_connection_id': business_connection_id}
+    if disable_notification is not None:
+        payload['disable_notification'] = disable_notification
+    if protect_content is not None:
+        payload['protect_content'] = protect_content
+    if message_effect_id:
+        payload['message_effect_id'] = message_effect_id
+    if reply_parameters:
+        payload['reply_parameters'] = reply_parameters.to_json()
+    if reply_markup:
+        payload['reply_markup'] = _convert_markup(reply_markup)
+    return await _process_request(token, method_url, params=payload)
+
+
+async def edit_message_checklist(
+        token, business_connection_id, chat_id, message_id, checklist,
+        reply_markup=None
+):
+    method_url = r'editMessageChecklist'
+    payload = {'chat_id': chat_id, 'message_id': message_id, 'checklist': checklist, 'business_connection_id': business_connection_id}
+    if reply_markup:
+        payload['reply_markup'] = await _convert_markup(reply_markup)
+    return await _process_request(token, method_url, params=payload)
 
 async def send_dice(
         token, chat_id,
@@ -1816,6 +1845,11 @@ async def answer_pre_checkout_query(token, pre_checkout_query_id, ok, error_mess
         payload['error_message'] = error_message
     return await _process_request(token, method_url, params=payload)
 
+
+async def get_my_star_balance(token):
+    method_url = 'getMyStarBalance'
+    return await _process_request(token, method_url)
+
 async def get_star_transactions(token, offset=None, limit=None):
     method_url = 'getStarTransactions'
     payload = {}