telegrinder 0.2.2__tar.gz → 0.3.0__tar.gz

{telegrinder-0.2.2 → telegrinder-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: telegrinder
-Version: 0.2.2
+Version: 0.3.0
 Summary: Modern visionary telegram bot framework.
 Home-page: https://github.com/timoniq/telegrinder
 License: MIT
@@ -43,7 +43,7 @@ Still in development.
 * Type hinted
 * Customizable and extensible
 * Ready to use scenarios and rules
-* Fast models built on msgspec
+* Fast models built on [msgspec](https://github.com/jcrist/msgspec)
 * Both low-level and high-level API
 * Support [optional dependecies](https://github.com/timoniq/telegrinder/blob/dev/docs/guide/optional_dependencies.md)
 

{telegrinder-0.2.2 → telegrinder-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "telegrinder"
-version = "0.2.2"
+version = "0.3.0"
 description = "Modern visionary telegram bot framework."
 authors = ["timoniq <tesseradecades@mail.ru>"]
 maintainers = ["luwqz1 <howluwqz1@gmail.com>"]
@@ -56,7 +56,8 @@ fntypes = "^0.1.3"
 pre-commit = "^3.8.0"
 ruff = ">=0.5,<0.7"
 basedpyright = "^1.12.1"
-sort-all = "1.2.0"
+sort-all = "^1.2.0"
+libcst = "^1.4.0"
 pytest = "^8.0.0"
 pytest-asyncio = ">=0.23.5,<0.25.0"
 pytest-cov = "^5.0.0"
@@ -81,6 +82,7 @@ asyncio_mode = "auto"
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = ["F401", "F403"]
+"typegen/**.py" = ["N802"]
 
 [tool.ruff.lint.flake8-quotes]
 docstring-quotes = "double"

{telegrinder-0.2.2 → telegrinder-0.3.0}/readme.md

@@ -7,7 +7,7 @@ Still in development.
 * Type hinted
 * Customizable and extensible
 * Ready to use scenarios and rules
-* Fast models built on msgspec
+* Fast models built on [msgspec](https://github.com/jcrist/msgspec)
 * Both low-level and high-level API
 * Support [optional dependecies](https://github.com/timoniq/telegrinder/blob/dev/docs/guide/optional_dependencies.md)
 

{telegrinder-0.2.2 → telegrinder-0.3.0}/telegrinder/__init__.py

@@ -5,7 +5,7 @@ Modern visionary telegram bot framework.
 * Type hinted
 * Customizable and extensible
 * Ready to use scenarios and rules
-* Fast models built on msgspec
+* Fast models built on [msgspec](https://github.com/jcrist/msgspec)
 * Both low-level and high-level API
 * Support [optional dependecies](https://github.com/timoniq/telegrinder/blob/dev/docs/guide/optional_dependencies.md)
 
@@ -35,6 +35,12 @@ import typing
 
 from .api import API, APIError, APIResponse, Token
 from .bot import (
+    CALLBACK_QUERY_FOR_MESSAGE,
+    CALLBACK_QUERY_FROM_CHAT,
+    CALLBACK_QUERY_IN_CHAT_FOR_MESSAGE,
+    MESSAGE_FROM_USER,
+    MESSAGE_FROM_USER_IN_CHAT,
+    MESSAGE_IN_CHAT,
     ABCDispatch,
     ABCHandler,
     ABCMiddleware,
@@ -64,6 +70,7 @@ from .bot import (
     Dispatch,
     DocumentReplyHandler,
     FuncHandler,
+    Hasher,
     InlineQueryCute,
     InlineQueryReturnManager,
     InlineQueryRule,
@@ -77,6 +84,7 @@ from .bot import (
     Polling,
     RawEventView,
     ShortState,
+    StateViewHasher,
     StickerReplyHandler,
     Telegrinder,
     UpdateCute,
@@ -144,6 +152,7 @@ __all__ = (
     "ABCRule",
     "ABCScenario",
     "ABCStateStorage",
+    "ABCStateStorage",
     "ABCStateView",
     "ABCTranslator",
     "ABCTranslatorMiddleware",
@@ -153,12 +162,16 @@ __all__ = (
     "APIResponse",
     "AiohttpClient",
     "AnyMarkup",
+    "AudioReplyHandler",
     "BaseCute",
     "BaseReturnManager",
     "BaseStateView",
     "BaseView",
     "Bot",
     "Button",
+    "CALLBACK_QUERY_FOR_MESSAGE",
+    "CALLBACK_QUERY_FROM_CHAT",
+    "CALLBACK_QUERY_IN_CHAT_FOR_MESSAGE",
     "CallbackQuery",
     "CallbackQueryCute",
     "CallbackQueryReturnManager",
@@ -171,8 +184,10 @@ __all__ = (
     "ChatMemberUpdated",
     "ChatMemberUpdatedCute",
     "ChatMemberView",
+    "DocumentReplyHandler",
     "Checkbox",
     "Choice",
+    "Context",
     "CtxVar",
     "DelayedTask",
     "Dispatch",
@@ -181,6 +196,7 @@ __all__ = (
     "FuncHandler",
     "GlobalContext",
     "HTMLFormatter",
+    "Hasher",
     "I18nEnum",
     "InlineButton",
     "InlineKeyboard",
@@ -193,8 +209,12 @@ __all__ = (
     "KeyboardSetYAML",
     "Lifespan",
     "LoopWrapper",
+    "MESSAGE_FROM_USER",
+    "MESSAGE_FROM_USER_IN_CHAT",
+    "MESSAGE_IN_CHAT",
     "MediaGroupReplyHandler",
     "MemoryStateStorage",
+    "MemoryStateStorage",
     "Message",
     "MessageCute",
     "MessageReplyHandler",
@@ -212,7 +232,10 @@ __all__ = (
     "SimpleI18n",
     "SimpleTranslator",
     "StateData",
+    "StateData",
+    "StateMeta",
     "StateMeta",
+    "StateViewHasher",
     "StickerReplyHandler",
     "Telegrinder",
     "Token",
@@ -225,5 +248,4 @@ __all__ = (
     "logger",
     "magic_bundle",
     "register_manager",
-    "Context",
 )

{telegrinder-0.2.2 → telegrinder-0.3.0}/telegrinder/bot/__init__.py

@@ -9,6 +9,12 @@ from telegrinder.bot.cute_types import (
     UpdateCute,
 )
 from telegrinder.bot.dispatch import (
+    CALLBACK_QUERY_FOR_MESSAGE,
+    CALLBACK_QUERY_FROM_CHAT,
+    CALLBACK_QUERY_IN_CHAT_FOR_MESSAGE,
+    MESSAGE_FROM_USER,
+    MESSAGE_FROM_USER_IN_CHAT,
+    MESSAGE_IN_CHAT,
     ABCDispatch,
     ABCHandler,
     ABCMiddleware,
@@ -27,6 +33,7 @@ from telegrinder.bot.dispatch import (
     Dispatch,
     DocumentReplyHandler,
     FuncHandler,
+    Hasher,
     InlineQueryReturnManager,
     Manager,
     MediaGroupReplyHandler,
@@ -36,6 +43,7 @@ from telegrinder.bot.dispatch import (
     PhotoReplyHandler,
     RawEventView,
     ShortState,
+    StateViewHasher,
     StickerReplyHandler,
     VideoReplyHandler,
     ViewBox,
@@ -68,6 +76,9 @@ __all__ = (
     "BaseReturnManager",
     "BaseStateView",
     "BaseView",
+    "CALLBACK_QUERY_FOR_MESSAGE",
+    "CALLBACK_QUERY_FROM_CHAT",
+    "CALLBACK_QUERY_IN_CHAT_FOR_MESSAGE",
     "CallbackQueryCute",
     "CallbackQueryReturnManager",
     "CallbackQueryRule",
@@ -83,9 +94,13 @@ __all__ = (
     "Dispatch",
     "DocumentReplyHandler",
     "FuncHandler",
+    "Hasher",
     "InlineQueryCute",
     "InlineQueryReturnManager",
     "InlineQueryRule",
+    "MESSAGE_FROM_USER",
+    "MESSAGE_FROM_USER_IN_CHAT",
+    "MESSAGE_IN_CHAT",
     "Manager",
     "MediaGroupReplyHandler",
     "MessageCute",
@@ -97,6 +112,7 @@ __all__ = (
     "Polling",
     "RawEventView",
     "ShortState",
+    "StateViewHasher",
     "StickerReplyHandler",
     "Telegrinder",
     "UpdateCute",

{telegrinder-0.2.2 → telegrinder-0.3.0}/telegrinder/bot/cute_types/callback_query.py

@@ -100,25 +100,7 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
 
         Use this method to send answers to callback queries sent from inline keyboards.
         The answer will be displayed to the user as a notification at the top of the
-        chat screen or as an alert. On success, True is returned.
-
-        :param callback_query_id: Unique identifier for the query to be answered.
-
-        :param text: Text of the notification. If not specified, nothing will be shown to the \
-        user, 0-200 characters.
-
-        :param show_alert: If True, an alert will be shown by the client instead of a notification at \
-        the top of the chat screen. Defaults to false.
-
-        :param url: URL that will be opened by the user's client. If you have created a Game and \
-        accepted the conditions via @BotFather, specify the URL that opens your \
-        game - note that this will only work if the query comes from a callback_game \
-        button. Otherwise, you may use links like t.me/your_bot?start=XXXX that \
-        open your bot with a parameter.
-
-        :param cache_time: The maximum amount of time in seconds that the result of the callback query \
-        may be cached client-side. Telegram apps will support caching starting \
-        in version 3.14. Defaults to 0."""
+        chat screen or as an alert. On success, True is returned."""
 
         params = compose_method_params(
             get_params(locals()), self, default_params={("callback_query_id", "id")}
@@ -149,47 +131,17 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
         reply_markup: ReplyMarkup | None = None,
+        show_caption_above_media: bool | None = None,
         **other: typing.Any,
     ) -> Result[MessageId, APIError]:
         """Shortcut `API.copy_message()`, see the [documentation](https://core.telegram.org/bots/api#copymessage)
 
-        Use this method to copy messages of any kind. Service messages, giveaway
-        messages, giveaway winners messages, and invoice messages can't be copied.
-        A quiz poll can be copied only if the value of the field correct_option_id
-        is known to the bot. The method is analogous to the method forwardMessage,
-        but the copied message doesn't have a link to the original message. Returns
-        the MessageId of the sent message on success.
-
-        :param chat_id: Unique identifier for the target chat or username of the target channel \
-        (in the format @channelusername).
-
-        :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
-        forum supergroups only.
-
-        :param from_chat_id: Unique identifier for the chat where the original message was sent (or channel \
-        username in the format @channelusername).
-
-        :param message_id: Message identifier in the chat specified in from_chat_id.
-
-        :param caption: New caption for media, 0-1024 characters after entities parsing. If not \
-        specified, the original caption is kept.
-
-        :param parse_mode: Mode for parsing entities in the new caption. See formatting options for \
-        more details.
-
-        :param caption_entities: A JSON-serialized list of special entities that appear in the new caption, \
-        which can be specified instead of parse_mode.
-
-        :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
-
-        :param protect_content: Protects the contents of the sent message from forwarding and saving.
-
-        :param reply_parameters: Description of the message to reply to.
-
-        :param reply_markup: Additional interface options. A JSON-serialized object for an inline \
-        keyboard, custom reply keyboard, instructions to remove reply keyboard \
-        or to force a reply from the user.
-        """
+        Use this method to copy messages of any kind. Service messages, paid media
+        messages, giveaway messages, giveaway winners messages, and invoice
+        messages can't be copied. A quiz poll can be copied only if the value of the
+        field correct_option_id is known to the bot. The method is analogous to
+        the method forwardMessage, but the copied message doesn't have a link to
+        the original message. Returns the MessageId of the sent message on success."""
 
         return await MessageCute.copy(self, **get_params(locals()))  # type: ignore
 
@@ -213,15 +165,7 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         can delete outgoing messages in channels. - If the bot is an administrator
         of a group, it can delete any message there. - If the bot has can_delete_messages
         permission in a supergroup or a channel, it can delete any message there.
-        Returns True on success.
-
-        :param chat_id: Unique identifier for the target chat or username of the target channel \
-        (in the format @channelusername).
-
-        :param message_id: Identifier of the message to delete.
-
-        :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
-        forum supergroups only."""
+        Returns True on success."""
 
         return await MessageCute.delete(self, **get_params(locals()))  # type: ignore
 
@@ -233,7 +177,7 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
     async def edit_text(
         self,
         text: str,
-        inline_message_id: int | None = None,
+        inline_message_id: str | None = None,
         chat_id: int | str | None = None,
         message_id: int | None = None,
         message_thread_id: int | None = None,
@@ -241,33 +185,28 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         entities: list[MessageEntity] | None = None,
         link_preview_options: LinkPreviewOptions | dict[str, typing.Any] | None = None,
         reply_markup: InlineKeyboardMarkup | None = None,
+        business_connection_id: str | None = None,
         **other: typing.Any,
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_text()`, see the [documentation](https://core.telegram.org/bots/api#editmessagetext)
 
         Use this method to edit text and game messages. On success, if the edited
         message is not an inline message, the edited Message is returned, otherwise
-        True is returned.
-
-        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of the \
-        inline message.
-
-        :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
-        the target chat or username of the target channel (in the format @channelusername). \
+        True is returned. Note that business messages that were not sent by the bot
+        and do not contain an inline keyboard can only be edited within 48 hours from
+        the time they were sent.
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the messageto be edited was sent.
 
-        :param message_id: Required if inline_message_id is not specified. Identifier of the message \
-        to edit.
+        :param chat_id: Required if inline_message_id is not specified. Unique identifier forthe target chat or username of the target channel (in the format @channelusername).
+        :param message_id: Required if inline_message_id is not specified. Identifier of the messageto edit.
 
-        :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
-        forum supergroups only.
+        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of theinline message.
 
         :param text: New text of the message, 1-4096 characters after entities parsing.
 
-        :param parse_mode: Mode for parsing entities in the message text. See formatting options for \
-        more details.
+        :param parse_mode: Mode for parsing entities in the message text. See formatting options formore details.
 
-        :param entities: A JSON-serialized list of special entities that appear in message text, \
-        which can be specified instead of parse_mode.
+        :param entities: A JSON-serialized list of special entities that appear in message text,which can be specified instead of parse_mode.
 
         :param link_preview_options: Link preview generation options for the message.
 
@@ -292,6 +231,8 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         heading: int | None = None,
         proximity_alert_radius: int | None = None,
         reply_markup: InlineKeyboardMarkup | None = None,
+        business_connection_id: str | None = None,
+        live_period: int | None = None,
         **other: typing.Any,
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_live_location()`, see the [documentation](https://core.telegram.org/bots/api#editmessagelivelocation)
@@ -300,30 +241,23 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         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 is returned, otherwise True is returned.
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the messageto be edited was sent.
 
-        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of the \
-        inline message.
+        :param chat_id: Required if inline_message_id is not specified. Unique identifier forthe target chat or username of the target channel (in the format @channelusername).
+        :param message_id: Required if inline_message_id is not specified. Identifier of the messageto edit.
 
-        :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
-        the target chat or username of the target channel (in the format @channelusername). \
-
-        :param message_id: Required if inline_message_id is not specified. Identifier of the message \
-        to edit.
-
-        :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
-        forum supergroups only.
+        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of theinline message.
 
         :param latitude: Latitude of new location.
 
         :param longitude: Longitude of new location.
 
-        :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500. \
+        :param live_period: New period in seconds during which the location can be updated, startingfrom the message send date. If 0x7FFFFFFF is specified, then the locationcan be updated forever. Otherwise, the new value must not exceed the currentlive_period by more than a day, and the live location expiration date mustremain within the next 90 days. If not specified, then live_period remainsunchanged.
 
-        :param heading: Direction in which the user is moving, in degrees. Must be between 1 and 360 \
-        if specified.
+        :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500.
+        :param heading: Direction in which the user is moving, in degrees. Must be between 1 and 360if specified.
 
-        :param proximity_alert_radius: The maximum distance for proximity alerts about approaching another chat \
-        member, in meters. Must be between 1 and 100000 if specified.
+        :param proximity_alert_radius: The maximum distance for proximity alerts about approaching another chatmember, in meters. Must be between 1 and 100000 if specified.
 
         :param reply_markup: A JSON-serialized object for a new inline keyboard."""
 
@@ -336,7 +270,7 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
     )
     async def edit_caption(
         self,
-        caption: str,
+        caption: str | None = None,
         chat_id: int | str | None = None,
         message_id: int | None = None,
         message_thread_id: int | None = None,
@@ -344,33 +278,30 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
         reply_markup: InlineKeyboardMarkup | None = None,
+        business_connection_id: str | None = None,
+        show_caption_above_media: bool | None = None,
         **other: typing.Any,
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_caption()`, see the [documentation](https://core.telegram.org/bots/api#editmessagecaption)
 
         Use this method to edit captions of messages. On success, if the edited message
         is not an inline message, the edited Message is returned, otherwise True
-        is returned.
-
-        :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
-        the target chat or username of the target channel (in the format @channelusername). \
+        is returned. Note that business messages that were not sent by the bot and
+        do not contain an inline keyboard can only be edited within 48 hours from
+        the time they were sent.
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the messageto be edited was sent.
 
-        :param message_id: Required if inline_message_id is not specified. Identifier of the message \
-        to edit.
+        :param chat_id: Required if inline_message_id is not specified. Unique identifier forthe target chat or username of the target channel (in the format @channelusername).
+        :param message_id: Required if inline_message_id is not specified. Identifier of the messageto edit.
 
-        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of the \
-        inline message.
+        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of theinline message.
 
-        :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
-        forum supergroups only.
+        :param caption: New caption of the message, 0-1024 characters after entities parsing.
+        :param parse_mode: Mode for parsing entities in the message caption. See formatting optionsfor more details.
 
-        :param caption: New caption of the message, 0-1024 characters after entities parsing. \
+        :param caption_entities: A JSON-serialized list of special entities that appear in the caption,which can be specified instead of parse_mode.
 
-        :param parse_mode: Mode for parsing entities in the message caption. See formatting options \
-        for more details.
-
-        :param caption_entities: A JSON-serialized list of special entities that appear in the caption, \
-        which can be specified instead of parse_mode.
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media. Supportedonly for animation, photo and video messages.
 
         :param reply_markup: A JSON-serialized object for an inline keyboard."""
 
@@ -399,6 +330,7 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         message_id: int | None = None,
         message_thread_id: int | None = None,
         reply_markup: InlineKeyboardMarkup | None = None,
+        business_connection_id: str | None = None,
         **other: typing.Any,
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_media()`, see the [documentation](https://core.telegram.org/bots/api#editmessagemedia)
@@ -409,33 +341,18 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         a video otherwise. When an inline message is edited, a new file can't be uploaded;
         use a previously uploaded file via its file_id or specify a URL. On success,
         if the edited message is not an inline message, the edited Message is returned,
-        otherwise True is returned.
-
-        :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
-        the target chat or username of the target channel (in the format @channelusername). \
-
-        :param message_id: Required if inline_message_id is not specified. Identifier of the message \
-        to edit.
+        otherwise True is returned. Note that business messages that were not sent
+        by the bot and do not contain an inline keyboard can only be edited within
+        48 hours from the time they were sent.
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the messageto be edited was sent.
 
-        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of the \
-        inline message.
+        :param chat_id: Required if inline_message_id is not specified. Unique identifier forthe target chat or username of the target channel (in the format @channelusername).
+        :param message_id: Required if inline_message_id is not specified. Identifier of the messageto edit.
 
-        :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
-        forum supergroups only.
+        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of theinline message.
 
         :param media: A JSON-serialized object for a new media content of the message.
 
-        :param caption: Audio caption, 0-1024 characters after entities parsing.
-
-        :param parse_mode: Mode for parsing entities in the audio caption. See formatting options \
-        for more details.
-
-        :param caption_entities: A JSON-serialized list of special entities that appear in the caption, \
-        which can be specified instead of parse_mode.
-
-        :param type: Required if media is not an `str | InputMedia` object. Type of the media, \
-        must be one of `photo`, `video`, `animation`, `audio`, `document`.
-
         :param reply_markup: A JSON-serialized object for a new inline keyboard."""
 
         return await MessageCute.edit_media(self, **get_params(locals()))  # type: ignore
@@ -452,25 +369,22 @@ class CallbackQueryCute(BaseCute[CallbackQuery], CallbackQuery, kw_only=True):
         message_thread_id: int | None = None,
         chat_id: int | str | None = None,
         reply_markup: InlineKeyboardMarkup | None = None,
+        business_connection_id: str | None = None,
         **other: typing.Any,
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_reply_markup()`, see the [documentation](https://core.telegram.org/bots/api#editmessagereplymarkup)
 
         Use this method to edit only the reply markup of messages. On success, if
         the edited message is not an inline message, the edited Message is returned,
-        otherwise True is returned.
-
-        :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
-        the target chat or username of the target channel (in the format @channelusername). \
-
-        :param message_id: Required if inline_message_id is not specified. Identifier of the message \
-        to edit.
+        otherwise True is returned. Note that business messages that were not sent
+        by the bot and do not contain an inline keyboard can only be edited within
+        48 hours from the time they were sent.
+        :param business_connection_id: Unique identifier of the business connection on behalf of which the messageto be edited was sent.
 
-        :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
-        forum supergroups only.
+        :param chat_id: Required if inline_message_id is not specified. Unique identifier forthe target chat or username of the target channel (in the format @channelusername).
+        :param message_id: Required if inline_message_id is not specified. Identifier of the messageto edit.
 
-        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of the \
-        inline message.
+        :param inline_message_id: Required if chat_id and message_id are not specified. Identifier of theinline message.
 
         :param reply_markup: A JSON-serialized object for an inline keyboard."""
 

{telegrinder-0.2.2 → telegrinder-0.3.0}/telegrinder/bot/cute_types/chat_join_request.py

@@ -19,7 +19,11 @@ class ChatJoinRequestCute(BaseCute[ChatJoinRequest], ChatJoinRequest, ChatMember
     def user_id(self) -> int:
         return self.from_user.id
 
-    @shortcut("approve_chat_join_request", executor=chat_member_interaction)
+    @shortcut(
+        "approve_chat_join_request",
+        executor=chat_member_interaction,
+        custom_params={"chat_id", "user_id"},
+    )
     async def approve(
         self,
         chat_id: int | str | None = None,
@@ -30,17 +34,15 @@ class ChatJoinRequestCute(BaseCute[ChatJoinRequest], ChatJoinRequest, ChatMember
 
         Use this method to approve a chat join request. The bot must be an administrator
         in the chat for this to work and must have the can_invite_users administrator
-        right. Returns True on success.
-
-        :param chat_id: Unique identifier for the target chat or username of the target channel \
-        (in the format @channelusername).
-
-        :param user_id: Unique identifier of the target user.
-        """
+        right. Returns True on success."""
 
         ...
 
-    @shortcut("decline_chat_join_request", executor=chat_member_interaction)
+    @shortcut(
+        "decline_chat_join_request",
+        executor=chat_member_interaction,
+        custom_params={"chat_id", "user_id"},
+    )
     async def decline(
         self,
         chat_id: int | str | None = None,
@@ -51,13 +53,7 @@ class ChatJoinRequestCute(BaseCute[ChatJoinRequest], ChatJoinRequest, ChatMember
 
         Use this method to decline a chat join request. The bot must be an administrator
         in the chat for this to work and must have the can_invite_users administrator
-        right. Returns True on success.
-
-        :param chat_id: Unique identifier for the target chat or username of the target channel \
-        (in the format @channelusername).
-
-        :param user_id: Unique identifier of the target user.
-        """
+        right. Returns True on success."""
 
         ...