[3.x] Bot API 5.5 (#777)

* Re-generate API, cover changes

* Added patchnotes

aiogram/__init__.py

@@ -37,4 +37,4 @@ __all__ = (
 )
 
 __version__ = "3.0.0a19"
-__api_version__ = "5.4"
+__api_version__ = "5.5"

aiogram/client/bot.py

@@ -29,6 +29,7 @@ from ..methods import (
     AnswerShippingQuery,
     ApproveChatJoinRequest,
     BanChatMember,
+    BanChatSenderChat,
     Close,
     CopyMessage,
     CreateChatInviteLink,
@@ -102,6 +103,7 @@ from ..methods import (
     StopPoll,
     TelegramMethod,
     UnbanChatMember,
+    UnbanChatSenderChat,
     UnpinAllChatMessages,
     UnpinChatMessage,
     UploadStickerFile,
@@ -1637,6 +1639,50 @@ class Bot(ContextInstanceMixin["Bot"]):
         )
         return await self(call, request_timeout=request_timeout)
 
+    async def ban_chat_sender_chat(
+        self,
+        chat_id: Union[int, str],
+        sender_chat_id: int,
+        request_timeout: Optional[int] = None,
+    ) -> bool:
+        """
+        Use this method to ban a channel chat in a supergroup or a channel. Until the chat is `unbanned <https://core.telegram.org/bots/api#unbanchatsenderchat>`_, the owner of the banned chat won't be able to send messages on behalf of **any of their channels**. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns :code:`True` on success.
+
+        Source: https://core.telegram.org/bots/api#banchatsenderchat
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)
+        :param sender_chat_id: Unique identifier of the target sender chat
+        :param request_timeout: Request timeout
+        :return: Returns True on success.
+        """
+        call = BanChatSenderChat(
+            chat_id=chat_id,
+            sender_chat_id=sender_chat_id,
+        )
+        return await self(call, request_timeout=request_timeout)
+
+    async def unban_chat_sender_chat(
+        self,
+        chat_id: Union[int, str],
+        sender_chat_id: int,
+        request_timeout: Optional[int] = None,
+    ) -> bool:
+        """
+        Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns :code:`True` on success.
+
+        Source: https://core.telegram.org/bots/api#unbanchatsenderchat
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)
+        :param sender_chat_id: Unique identifier of the target sender chat
+        :param request_timeout: Request timeout
+        :return: Returns True on success.
+        """
+        call = UnbanChatSenderChat(
+            chat_id=chat_id,
+            sender_chat_id=sender_chat_id,
+        )
+        return await self(call, request_timeout=request_timeout)
+
     async def set_chat_permissions(
         self,
         chat_id: Union[int, str],

aiogram/dispatcher/router.py

@@ -16,8 +16,8 @@ INTERNAL_UPDATE_TYPES = frozenset({"update", "error"})
 
 class Router:
     """
-    Router can route update and it nested update types like messages, callback query, polls and all other event types.
-    Here is used event-observer pattern.
+    Router can route update, and it nested update types like messages, callback query,
+    polls and all other event types.
 
     Event handlers can be registered in observer by two ways:
 

aiogram/methods/__init__.py

@@ -5,6 +5,7 @@ from .answer_pre_checkout_query import AnswerPreCheckoutQuery
 from .answer_shipping_query import AnswerShippingQuery
 from .approve_chat_join_request import ApproveChatJoinRequest
 from .ban_chat_member import BanChatMember
+from .ban_chat_sender_chat import BanChatSenderChat
 from .base import Request, Response, TelegramMethod
 from .close import Close
 from .copy_message import CopyMessage
@@ -78,6 +79,7 @@ from .set_webhook import SetWebhook
 from .stop_message_live_location import StopMessageLiveLocation
 from .stop_poll import StopPoll
 from .unban_chat_member import UnbanChatMember
+from .unban_chat_sender_chat import UnbanChatSenderChat
 from .unpin_all_chat_messages import UnpinAllChatMessages
 from .unpin_chat_message import UnpinChatMessage
 from .upload_sticker_file import UploadStickerFile
@@ -120,6 +122,8 @@ __all__ = (
     "RestrictChatMember",
     "PromoteChatMember",
     "SetChatAdministratorCustomTitle",
+    "BanChatSenderChat",
+    "UnbanChatSenderChat",
     "SetChatPermissions",
     "ExportChatInviteLink",
     "CreateChatInviteLink",

aiogram/methods/ban_chat_sender_chat.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, Union
+
+from .base import Request, TelegramMethod
+
+if TYPE_CHECKING:
+    from ..client.bot import Bot
+
+
+class BanChatSenderChat(TelegramMethod[bool]):
+    """
+    Use this method to ban a channel chat in a supergroup or a channel. Until the chat is `unbanned <https://core.telegram.org/bots/api#unbanchatsenderchat>`_, the owner of the banned chat won't be able to send messages on behalf of **any of their channels**. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns :code:`True` on success.
+
+    Source: https://core.telegram.org/bots/api#banchatsenderchat
+    """
+
+    __returning__ = bool
+
+    chat_id: Union[int, str]
+    """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)"""
+    sender_chat_id: int
+    """Unique identifier of the target sender chat"""
+
+    def build_request(self, bot: Bot) -> Request:
+        data: Dict[str, Any] = self.dict()
+
+        return Request(method="banChatSenderChat", data=data)

aiogram/methods/unban_chat_sender_chat.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, Union
+
+from .base import Request, TelegramMethod
+
+if TYPE_CHECKING:
+    from ..client.bot import Bot
+
+
+class UnbanChatSenderChat(TelegramMethod[bool]):
+    """
+    Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns :code:`True` on success.
+
+    Source: https://core.telegram.org/bots/api#unbanchatsenderchat
+    """
+
+    __returning__ = bool
+
+    chat_id: Union[int, str]
+    """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)"""
+    sender_chat_id: int
+    """Unique identifier of the target sender chat"""
+
+    def build_request(self, bot: Bot) -> Request:
+        data: Dict[str, Any] = self.dict()
+
+        return Request(method="unbanChatSenderChat", data=data)

aiogram/types/chat.py

@@ -5,6 +5,7 @@ from typing import TYPE_CHECKING, Optional
 from .base import TelegramObject
 
 if TYPE_CHECKING:
+    from ..methods import BanChatSenderChat, UnbanChatSenderChat
     from .chat_location import ChatLocation
     from .chat_permissions import ChatPermissions
     from .chat_photo import ChatPhoto
@@ -34,6 +35,8 @@ class Chat(TelegramObject):
     """*Optional*. Chat photo. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
     bio: Optional[str] = None
     """*Optional*. Bio of the other party in a private chat. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
+    has_private_forwards: Optional[bool] = None
+    """*Optional*. True, if privacy settings of the other party in the private chat allows to use :code:`tg://user?id=<user_id>` links only in chats with the user. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
     description: Optional[str] = None
     """*Optional*. Description, for groups, supergroups and channel chats. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
     invite_link: Optional[str] = None
@@ -46,6 +49,8 @@ class Chat(TelegramObject):
     """*Optional*. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user; in seconds. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
     message_auto_delete_time: Optional[int] = None
     """*Optional*. The time after which all messages sent to the chat will be automatically deleted; in seconds. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
+    has_protected_content: Optional[bool] = None
+    """*Optional*. True, if messages from the chat can't be forwarded to other chats. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
     sticker_set_name: Optional[str] = None
     """*Optional*. For supergroups, name of group sticker set. Returned only in :class:`aiogram.methods.get_chat.GetChat`."""
     can_set_sticker_set: Optional[bool] = None
@@ -70,3 +75,19 @@ class Chat(TelegramObject):
         short_id = str(self.id).replace("-100", "")
         shift = int(-1 * pow(10, len(short_id) + 2))
         return shift - self.id
+
+    def ban_sender_chat(self, sender_chat_id: int) -> BanChatSenderChat:
+        from ..methods import BanChatSenderChat
+
+        return BanChatSenderChat(
+            chat_id=self.id,
+            sender_chat_id=sender_chat_id,
+        )
+
+    def unban_sender_chat(self, sender_chat_id: int) -> UnbanChatSenderChat:
+        from ..methods import UnbanChatSenderChat
+
+        return UnbanChatSenderChat(
+            chat_id=self.id,
+            sender_chat_id=sender_chat_id,
+        )

aiogram/types/inline_keyboard_button.py

@@ -19,7 +19,7 @@ class InlineKeyboardButton(MutableTelegramObject):
     text: str
     """Label text on the button"""
     url: Optional[str] = None
-    """*Optional*. HTTP or tg:// url to be opened when button is pressed"""
+    """*Optional*. HTTP or tg:// url to be opened when the button is pressed. Links :code:`tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings."""
     login_url: Optional[LoginUrl] = None
     """*Optional*. An HTTP URL used to automatically authorize the user. Can be used as a replacement for the `Telegram Login Widget <https://core.telegram.org/widgets/login>`_."""
     callback_data: Optional[str] = None

aiogram/types/input_file.py

@@ -79,10 +79,8 @@ class BufferedInputFile(InputFile):
 
     async def read(self, chunk_size: int) -> AsyncGenerator[bytes, None]:
         buffer = io.BytesIO(self.data)
-        chunk = buffer.read(chunk_size)
-        while chunk:
+        while chunk := buffer.read(chunk_size):
             yield chunk
-            chunk = buffer.read(chunk_size)
 
 
 class FSInputFile(InputFile):

aiogram/types/message.py

@@ -85,9 +85,9 @@ class Message(TelegramObject):
     chat: Chat
     """Conversation the message belongs to"""
     from_user: Optional[User] = Field(None, alias="from")
-    """*Optional*. Sender, empty for messages sent to channels"""
+    """*Optional*. Sender of the message; empty for messages sent to channels. For backward compatibility, the field contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat."""
     sender_chat: Optional[Chat] = None
-    """*Optional*. Sender of the message, sent on behalf of a chat. The channel itself for channel messages. The supergroup itself for messages from anonymous group administrators. The linked channel for messages automatically forwarded to the discussion group"""
+    """*Optional*. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group.  For backward compatibility, the field *from* contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat."""
     forward_from: Optional[User] = None
     """*Optional*. For forwarded messages, sender of the original message"""
     forward_from_chat: Optional[Chat] = None
@@ -100,12 +100,16 @@ class Message(TelegramObject):
     """*Optional*. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages"""
     forward_date: Optional[int] = None
     """*Optional*. For forwarded messages, date the original message was sent in Unix time"""
+    is_automatic_forward: Optional[bool] = None
+    """*Optional*. True, if the message is a channel post that was automatically forwarded to the connected discussion group"""
     reply_to_message: Optional[Message] = None
     """*Optional*. For replies, the original message. Note that the Message object in this field will not contain further *reply_to_message* fields even if it itself is a reply."""
     via_bot: Optional[User] = None
     """*Optional*. Bot through which the message was sent"""
     edit_date: Optional[int] = None
     """*Optional*. Date the message was last edited in Unix time"""
+    has_protected_content: Optional[bool] = None
+    """*Optional*. True, if the message can't be forwarded"""
     media_group_id: Optional[str] = None
     """*Optional*. The unique identifier of a media message group this message belongs to"""
     author_signature: Optional[str] = None