telegrinder 0.1.dev166__py3-none-any.whl → 0.1.dev168__py3-none-any.whl

telegrinder/types/__init__.py

@@ -23,6 +23,7 @@ __all__ = (
     "BotCommandScopeChatAdministrators",
     "BotCommandScopeChatMember",
     "BotCommandScopeDefault",
+    "BotCommandScopeType",
     "BotDescription",
     "BotName",
     "BotShortDescription",
@@ -35,6 +36,7 @@ __all__ = (
     "CallbackGame",
     "CallbackQuery",
     "Chat",
+    "ChatAction",
     "ChatAdministratorRights",
     "ChatBackground",
     "ChatBoost",
@@ -44,6 +46,7 @@ __all__ = (
     "ChatBoostSourceGiftCode",
     "ChatBoostSourceGiveaway",
     "ChatBoostSourcePremium",
+    "ChatBoostSourceType",
     "ChatBoostUpdated",
     "ChatFullInfo",
     "ChatInviteLink",
@@ -56,16 +59,23 @@ __all__ = (
     "ChatMemberMember",
     "ChatMemberOwner",
     "ChatMemberRestricted",
+    "ChatMemberStatus",
     "ChatMemberUpdated",
     "ChatPermissions",
     "ChatPhoto",
     "ChatShared",
+    "ChatType",
     "ChosenInlineResult",
     "Contact",
+    "ContentType",
+    "Currency",
+    "DefaultAccentColor",
     "Dice",
+    "DiceEmoji",
     "Document",
     "EncryptedCredentials",
     "EncryptedPassportElement",
+    "EncryptedPassportElementType",
     "ExternalReplyInfo",
     "File",
     "ForceReply",
@@ -86,6 +96,7 @@ __all__ = (
     "InlineKeyboardButton",
     "InlineKeyboardMarkup",
     "InlineQuery",
+    "InlineQueryChatType",
     "InlineQueryResult",
     "InlineQueryResultArticle",
     "InlineQueryResultAudio",
@@ -99,13 +110,19 @@ __all__ = (
     "InlineQueryResultCachedVoice",
     "InlineQueryResultContact",
     "InlineQueryResultDocument",
+    "InlineQueryResultDocumentMimeType",
     "InlineQueryResultGame",
     "InlineQueryResultGif",
+    "InlineQueryResultGifThumbnailMimeType",
     "InlineQueryResultLocation",
+    "InlineQueryResultMimeType",
     "InlineQueryResultMpeg4Gif",
+    "InlineQueryResultMpeg4GifThumbnailMimeType",
     "InlineQueryResultPhoto",
+    "InlineQueryResultThumbnailMimeType",
     "InlineQueryResultVenue",
     "InlineQueryResultVideo",
+    "InlineQueryResultVideoMimeType",
     "InlineQueryResultVoice",
     "InlineQueryResultsButton",
     "InputContactMessageContent",
@@ -133,6 +150,7 @@ __all__ = (
     "Location",
     "LoginUrl",
     "MaskPosition",
+    "MaskPositionPoint",
     "MaybeInaccessibleMessage",
     "MenuButton",
     "MenuButtonCommands",
@@ -141,11 +159,13 @@ __all__ = (
     "Message",
     "MessageAutoDeleteTimerChanged",
     "MessageEntity",
+    "MessageEntityType",
     "MessageId",
     "MessageOrigin",
     "MessageOriginChannel",
     "MessageOriginChat",
     "MessageOriginHiddenUser",
+    "MessageOriginType",
     "MessageOriginUser",
     "MessageReactionCountUpdated",
     "MessageReactionUpdated",
@@ -161,18 +181,23 @@ __all__ = (
     "PassportElementErrorSelfie",
     "PassportElementErrorTranslationFile",
     "PassportElementErrorTranslationFiles",
+    "PassportElementErrorType",
     "PassportElementErrorUnspecified",
     "PassportFile",
     "PhotoSize",
     "Poll",
     "PollAnswer",
     "PollOption",
+    "PollType",
     "PreCheckoutQuery",
+    "ProgrammingLanguage",
     "ProximityAlertTriggered",
     "ReactionCount",
+    "ReactionEmoji",
     "ReactionType",
     "ReactionTypeCustomEmoji",
     "ReactionTypeEmoji",
+    "ReactionTypeType",
     "ReplyKeyboardMarkup",
     "ReplyKeyboardRemove",
     "ReplyParameters",
@@ -183,12 +208,17 @@ __all__ = (
     "ShippingOption",
     "ShippingQuery",
     "Sticker",
+    "StickerFormat",
     "StickerSet",
+    "StickerSetStickerType",
+    "StickerType",
     "Story",
     "SuccessfulPayment",
     "SwitchInlineQueryChosenChat",
     "TextQuote",
+    "TopicIconColor",
     "Update",
+    "UpdateType",
     "User",
     "UserChatBoosts",
     "UserProfilePhotos",

telegrinder/types/methods.py

@@ -139,9 +139,7 @@ class APIMethods:
         )
         return full_result(method_response, bool)
 
-    async def get_webhook_info(
-        self, **other: typing.Any
-    ) -> Result[WebhookInfo, APIError]:
+    async def get_webhook_info(self, **other: typing.Any) -> Result[WebhookInfo, APIError]:
         """Method `getWebhookInfo`, see the [documentation](https://core.telegram.org/bots/api#getwebhookinfo)
 
         Use this method to get current webhook status. Requires no parameters.
@@ -215,11 +213,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -357,11 +351,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[MessageId, APIError]:
@@ -473,11 +463,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -546,11 +532,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -630,11 +612,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -714,11 +692,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -805,11 +779,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -889,11 +859,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -960,11 +926,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -1020,9 +982,7 @@ class APIMethods:
     async def send_media_group(
         self,
         chat_id: int | str,
-        media: list[
-            InputMediaAudio | InputMediaDocument | InputMediaPhoto | InputMediaVideo
-        ],
+        media: list[InputMediaAudio | InputMediaDocument | InputMediaPhoto | InputMediaVideo],
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
         disable_notification: bool | None = None,
@@ -1076,11 +1036,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -1147,11 +1103,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -1216,11 +1168,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -1285,11 +1233,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -1373,11 +1317,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:
@@ -2379,9 +2319,7 @@ class APIMethods:
         )
         return full_result(method_response, bool)
 
-    async def get_forum_topic_icon_stickers(
-        self, **other: typing.Any
-    ) -> Result[list[Sticker], APIError]:
+    async def get_forum_topic_icon_stickers(self, **other: typing.Any) -> Result[list[Sticker], APIError]:
         """Method `getForumTopicIconStickers`, see the [documentation](https://core.telegram.org/bots/api#getforumtopiciconstickers)
 
         Use this method to get custom emoji stickers, which can be used as a forum
@@ -3011,9 +2949,7 @@ class APIMethods:
         self,
         chat_id: int | None = None,
         **other: typing.Any,
-    ) -> Result[
-        Variative[MenuButtonCommands, MenuButtonWebApp, MenuButtonDefault], APIError
-    ]:
+    ) -> Result[Variative[MenuButtonCommands, MenuButtonWebApp, MenuButtonDefault], APIError]:
         """Method `getChatMenuButton`, see the [documentation](https://core.telegram.org/bots/api#getchatmenubutton)
 
         Use this method to get the current value of the bot's menu button in a private 
@@ -3028,8 +2964,7 @@ class APIMethods:
             get_params(locals()),
         )
         return full_result(
-            method_response,
-            Variative[MenuButtonCommands, MenuButtonWebApp, MenuButtonDefault],
+            method_response, Variative[MenuButtonCommands, MenuButtonWebApp, MenuButtonDefault]
         )
 
     async def set_my_default_administrator_rights(
@@ -3424,11 +3359,7 @@ class APIMethods:
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | None = None,
         reply_markup: (
-            InlineKeyboardMarkup
-            | ReplyKeyboardMarkup
-            | ReplyKeyboardRemove
-            | ForceReply
-            | None
+            InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None
         ) = None,
         **other: typing.Any,
     ) -> Result[Message, APIError]:

telegrinder/types/objects.py

@@ -210,7 +210,7 @@ class Update(Model):
     or a user edited an existing connection with the bot."""
 
     business_message: Option["Message"] = Nothing
-    """Optional. New non-service message from a connected business account."""
+    """Optional. New message from a connected business account."""
 
     edited_business_message: Option["Message"] = Nothing
     """Optional. New version of a message from a connected business account."""
@@ -492,9 +492,7 @@ class ChatFullInfo(Model):
     personal_chat: Option["Chat"] = Nothing
     """Optional. For private chats, the personal channel of the user."""
 
-    available_reactions: Option[
-        list[Variative["ReactionTypeEmoji", "ReactionTypeCustomEmoji"]]
-    ] = Nothing
+    available_reactions: Option[list[Variative["ReactionTypeEmoji", "ReactionTypeCustomEmoji"]]] = Nothing
     """Optional. List of available reactions allowed in the chat. If omitted, 
     then all emoji reactions are allowed."""
 
@@ -534,8 +532,8 @@ class ChatFullInfo(Model):
     messages."""
 
     join_by_request: Option[bool] = Nothing
-    """Optional. True, if all users directly joining the supergroup need to be 
-    approved by supergroup administrators."""
+    """Optional. True, if all users directly joining the supergroup without using 
+    an invite link need to be approved by supergroup administrators."""
 
     description: Option[str] = Nothing
     """Optional. Description, for groups, supergroups and channel chats."""
@@ -647,12 +645,7 @@ class Message(MaybeInaccessibleMessage):
     bot chat which might share the same identifier."""
 
     forward_origin: Option[
-        Variative[
-            "MessageOriginUser",
-            "MessageOriginHiddenUser",
-            "MessageOriginChat",
-            "MessageOriginChannel",
-        ]
+        Variative["MessageOriginUser", "MessageOriginHiddenUser", "MessageOriginChat", "MessageOriginChannel"]
     ] = Nothing
     """Optional. Information about the original message for forwarded messages."""
 
@@ -941,9 +934,7 @@ class Message(MaybeInaccessibleMessage):
         Full name, for `private` chat."""
 
         return (
-            self.chat.full_name.unwrap()
-            if self.chat.type == ChatType.PRIVATE
-            else self.chat.title.unwrap()
+            self.chat.full_name.unwrap() if self.chat.type == ChatType.PRIVATE else self.chat.title.unwrap()
         )
 
     def __eq__(self, other: typing.Any) -> bool:
@@ -1049,10 +1040,7 @@ class ExternalReplyInfo(Model):
     """
 
     origin: Variative[
-        "MessageOriginUser",
-        "MessageOriginHiddenUser",
-        "MessageOriginChat",
-        "MessageOriginChannel",
+        "MessageOriginUser", "MessageOriginHiddenUser", "MessageOriginChat", "MessageOriginChannel"
     ]
     """Origin of the message replied to by the given message."""
 
@@ -1785,9 +1773,7 @@ class BackgroundTypeFill(BackgroundType):
     type: typing.Literal["fill"]
     """Type of the background, always `fill`."""
 
-    fill: Variative[
-        "BackgroundFillSolid", "BackgroundFillGradient", "BackgroundFillFreeformGradient"
-    ]
+    fill: Variative["BackgroundFillSolid", "BackgroundFillGradient", "BackgroundFillFreeformGradient"]
     """The background fill."""
 
     dark_theme_dimming: int
@@ -1829,9 +1815,7 @@ class BackgroundTypePattern(BackgroundType):
     document: "Document"
     """Document with the pattern."""
 
-    fill: Variative[
-        "BackgroundFillSolid", "BackgroundFillGradient", "BackgroundFillFreeformGradient"
-    ]
+    fill: Variative["BackgroundFillSolid", "BackgroundFillGradient", "BackgroundFillFreeformGradient"]
     """The background fill that is combined with the pattern."""
 
     intensity: int
@@ -1865,10 +1849,7 @@ class ChatBackground(Model):
     """
 
     type: Variative[
-        "BackgroundTypeFill",
-        "BackgroundTypeWallpaper",
-        "BackgroundTypePattern",
-        "BackgroundTypeChatTheme",
+        "BackgroundTypeFill", "BackgroundTypeWallpaper", "BackgroundTypePattern", "BackgroundTypeChatTheme"
     ]
     """Type of the background."""
 
@@ -2781,7 +2762,7 @@ class ChatMemberUpdated(Model):
 
     via_join_request: Option[bool] = Nothing
     """Optional. True, if the user joined the chat after sending a direct join request 
-    and being approved by an administrator."""
+    without using an invite link and being approved by an administrator."""
 
     via_chat_folder_invite_link: Option[bool] = Nothing
     """Optional. True, if the user joined the chat via a chat folder invite link."""
@@ -3111,9 +3092,7 @@ class Birthdate(Model):
         """Optional. Contains the user's age, if the user has a birth year specified."""
 
         return self.year.map(
-            lambda year: (
-                (datetime.now() - datetime(year, self.month, self.day)) // 365
-            ).days
+            lambda year: ((datetime.now() - datetime(year, self.month, self.day)) // 365).days
         )
 
 
@@ -3528,9 +3507,7 @@ class ChatBoost(Model):
     """Point in time (Unix timestamp) when the boost will automatically expire, 
     unless the booster's Telegram Premium subscription is prolonged."""
 
-    source: Variative[
-        "ChatBoostSourcePremium", "ChatBoostSourceGiftCode", "ChatBoostSourceGiveaway"
-    ]
+    source: Variative["ChatBoostSourcePremium", "ChatBoostSourceGiftCode", "ChatBoostSourceGiveaway"]
     """Source of the added boost."""
 
 
@@ -3562,9 +3539,7 @@ class ChatBoostRemoved(Model):
     remove_date: datetime
     """Point in time (Unix timestamp) when the boost was removed."""
 
-    source: Variative[
-        "ChatBoostSourcePremium", "ChatBoostSourceGiftCode", "ChatBoostSourceGiveaway"
-    ]
+    source: Variative["ChatBoostSourcePremium", "ChatBoostSourceGiftCode", "ChatBoostSourceGiveaway"]
     """Source of the removed boost."""
 
 
@@ -4196,9 +4171,7 @@ class InlineQueryResultGif(InlineQueryResult):
     gif_duration: Option[int] = Nothing
     """Optional. Duration of the GIF in seconds."""
 
-    thumbnail_mime_type: Option[
-        typing.Literal["image/jpeg", "image/gif", "video/mp4"]
-    ] = Nothing
+    thumbnail_mime_type: Option[typing.Literal["image/jpeg", "image/gif", "video/mp4"]] = Nothing
     """Optional. MIME type of the thumbnail, must be one of `image/jpeg`, `image/gif`, 
     or `video/mp4`. Defaults to `image/jpeg`."""
 
@@ -4259,9 +4232,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult):
     mpeg4_duration: Option[int] = Nothing
     """Optional. Video duration in seconds."""
 
-    thumbnail_mime_type: Option[
-        typing.Literal["image/jpeg", "image/gif", "video/mp4"]
-    ] = Nothing
+    thumbnail_mime_type: Option[typing.Literal["image/jpeg", "image/gif", "video/mp4"]] = Nothing
     """Optional. MIME type of the thumbnail, must be one of `image/jpeg`, `image/gif`, 
     or `video/mp4`. Defaults to `image/jpeg`."""
 

telegrinder/verification_utils.py

@@ -6,7 +6,8 @@ from telegrinder.api.abc import Token
 
 
 def verify_webapp_request(
-    secret_token: str, request_headers: typing.Mapping[str, typing.Any]
+    secret_token: str,
+    request_headers: typing.Mapping[str, typing.Any],
 ) -> bool:
     """Verifies update request is from telegram."""
 

{telegrinder-0.1.dev166.dist-info → telegrinder-0.1.dev168.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: telegrinder
-Version: 0.1.dev166
+Version: 0.1.dev168
 Summary: Framework for effective and reliable async telegram bot building.
 Home-page: https://github.com/timoniq/telegrinder
 License: MIT
@@ -49,23 +49,23 @@ Still in development.
 
 Install using pip:
 
-```
+```console
 pip install telegrinder
 ```
 
 Using poetry:
 
-```
+```console
 poetry add telegrinder
 ```
 
 Install from github:
 
-```
+```console
 pip install -U https://github.com/timoniq/telegrinder/archive/dev.zip
 ```
 
-```
+```console
 poetry add git+https://github.com/timoniq/telegrinder.git#dev
 ```