Add missing shortcuts, new enums, reworked old stuff (#1070)

* Render shortcuts

* Render docs

* Added enumerations

* Added docs

* Use enums, removed Helper

* Bump butcher

* Added InputMediaType enum

* Added MaskPositionPoint, InlineQueryResultType enums

* Update texts

* Added StickerType enum

* Cover tests

* Update docs

* Fixed imports

* Re-enabled all pre-commit hooks

docs/api/methods/answer_callback_query.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return AnswerCallbackQuery(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.callback_query.CallbackQuery.answer`

docs/api/methods/answer_inline_query.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return AnswerInlineQuery(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.inline_query.InlineQuery.answer`

docs/api/methods/approve_chat_join_request.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return ApproveChatJoinRequest(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat_join_request.ChatJoinRequest.approve`

docs/api/methods/ban_chat_member.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return BanChatMember(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.ban`

docs/api/methods/ban_chat_sender_chat.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return BanChatSenderChat(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.ban_sender_chat`

docs/api/methods/copy_message.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return CopyMessage(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.copy_to`

docs/api/methods/create_chat_invite_link.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return CreateChatInviteLink(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.create_invite_link`

docs/api/methods/decline_chat_join_request.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return DeclineChatJoinRequest(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat_join_request.ChatJoinRequest.decline`

docs/api/methods/delete_chat_photo.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return DeleteChatPhoto(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.delete_photo`

docs/api/methods/delete_chat_sticker_set.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return DeleteChatStickerSet(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.delete_sticker_set`

docs/api/methods/delete_message.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return DeleteMessage(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.delete`
+- :meth:`aiogram.types.chat.Chat.delete_message`

docs/api/methods/delete_sticker_from_set.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return DeleteStickerFromSet(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.sticker.Sticker.delete_from_set`

docs/api/methods/edit_chat_invite_link.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return EditChatInviteLink(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.edit_invite_link`

docs/api/methods/edit_message_caption.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return EditMessageCaption(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.edit_caption`

docs/api/methods/edit_message_live_location.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return EditMessageLiveLocation(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.edit_live_location`

docs/api/methods/edit_message_media.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return EditMessageMedia(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.edit_media`

docs/api/methods/edit_message_reply_markup.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return EditMessageReplyMarkup(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.edit_reply_markup`

docs/api/methods/edit_message_text.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return EditMessageText(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.edit_text`

docs/api/methods/export_chat_invite_link.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return ExportChatInviteLink(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.export_invite_link`

docs/api/methods/forward_message.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return ForwardMessage(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.forward`

docs/api/methods/get_chat_administrators.rst

@@ -35,3 +35,11 @@ With specific bot
 .. code-block:: python
 
     result: List[Union[ChatMemberOwner, ChatMemberAdministrator, ChatMemberMember, ChatMemberRestricted, ChatMemberLeft, ChatMemberBanned]] = await bot(GetChatAdministrators(...))
+
+
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.get_administrators`

docs/api/methods/get_chat_member.rst

@@ -35,3 +35,11 @@ With specific bot
 .. code-block:: python
 
     result: Union[ChatMemberOwner, ChatMemberAdministrator, ChatMemberMember, ChatMemberRestricted, ChatMemberLeft, ChatMemberBanned] = await bot(GetChatMember(...))
+
+
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.get_member`

docs/api/methods/get_chat_member_count.rst

@@ -35,3 +35,11 @@ With specific bot
 .. code-block:: python
 
     result: int = await bot(GetChatMemberCount(...))
+
+
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.get_member_count`

docs/api/methods/get_chat_members_count.rst

@@ -1,37 +0,0 @@
-###################
-getChatMembersCount
-###################
-
-Returns: :obj:`int`
-
-.. automodule:: aiogram.methods.get_chat_members_count
-    :members:
-    :member-order: bysource
-    :undoc-members: True
-
-
-Usage
-=====
-
-As bot method
--------------
-
-.. code-block::
-
-    result: int = await bot.get_chat_members_count(...)
-
-
-Method as object
-----------------
-
-Imports:
-
-- :code:`from aiogram.methods.get_chat_members_count import GetChatMembersCount`
-- alias: :code:`from aiogram.methods import GetChatMembersCount`
-
-With specific bot
-~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    result: int = await bot(GetChatMembersCount(...))

docs/api/methods/get_user_profile_photos.rst

@@ -35,3 +35,11 @@ With specific bot
 .. code-block:: python
 
     result: UserProfilePhotos = await bot(GetUserProfilePhotos(...))
+
+
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.user.User.get_profile_photos`

docs/api/methods/kick_chat_member.rst

@@ -1,44 +0,0 @@
-##############
-kickChatMember
-##############
-
-Returns: :obj:`bool`
-
-.. automodule:: aiogram.methods.kick_chat_member
-    :members:
-    :member-order: bysource
-    :undoc-members: True
-
-
-Usage
-=====
-
-As bot method
--------------
-
-.. code-block::
-
-    result: bool = await bot.kick_chat_member(...)
-
-
-Method as object
-----------------
-
-Imports:
-
-- :code:`from aiogram.methods.kick_chat_member import KickChatMember`
-- alias: :code:`from aiogram.methods import KickChatMember`
-
-With specific bot
-~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    result: bool = await bot(KickChatMember(...))
-
-As reply into Webhook in handler
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    return KickChatMember(...)

docs/api/methods/leave_chat.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return LeaveChat(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.leave`

docs/api/methods/pin_chat_message.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return PinChatMessage(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.pin`
+- :meth:`aiogram.types.chat.Chat.pin_message`

docs/api/methods/promote_chat_member.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return PromoteChatMember(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.promote`

docs/api/methods/restrict_chat_member.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return RestrictChatMember(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.restrict`

docs/api/methods/revoke_chat_invite_link.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return RevokeChatInviteLink(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.revoke_invite_link`

docs/api/methods/send_animation.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendAnimation(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_animation`
+- :meth:`aiogram.types.message.Message.reply_animation`

docs/api/methods/send_audio.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendAudio(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_audio`
+- :meth:`aiogram.types.message.Message.reply_audio`

docs/api/methods/send_chat_action.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendChatAction(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.do`

docs/api/methods/send_contact.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendContact(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_contact`
+- :meth:`aiogram.types.message.Message.reply_contact`

docs/api/methods/send_dice.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendDice(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_dice`
+- :meth:`aiogram.types.message.Message.reply_dice`

docs/api/methods/send_document.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendDocument(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_document`
+- :meth:`aiogram.types.message.Message.reply_document`

docs/api/methods/send_game.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendGame(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_game`
+- :meth:`aiogram.types.message.Message.reply_game`

docs/api/methods/send_invoice.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendInvoice(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_invoice`
+- :meth:`aiogram.types.message.Message.reply_invoice`

docs/api/methods/send_location.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendLocation(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_location`
+- :meth:`aiogram.types.message.Message.reply_location`

docs/api/methods/send_media_group.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendMediaGroup(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_media_group`
+- :meth:`aiogram.types.message.Message.reply_media_group`

docs/api/methods/send_message.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendMessage(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer`
+- :meth:`aiogram.types.message.Message.reply`

docs/api/methods/send_photo.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendPhoto(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_photo`
+- :meth:`aiogram.types.message.Message.reply_photo`

docs/api/methods/send_poll.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendPoll(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_poll`
+- :meth:`aiogram.types.message.Message.reply_poll`

docs/api/methods/send_sticker.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendSticker(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_sticker`
+- :meth:`aiogram.types.message.Message.reply_sticker`

docs/api/methods/send_venue.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendVenue(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_venue`
+- :meth:`aiogram.types.message.Message.reply_venue`

docs/api/methods/send_video.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendVideo(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_video`
+- :meth:`aiogram.types.message.Message.reply_video`

docs/api/methods/send_video_note.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendVideoNote(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_video_note`
+- :meth:`aiogram.types.message.Message.reply_video_note`

docs/api/methods/send_voice.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SendVoice(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.answer_voice`
+- :meth:`aiogram.types.message.Message.reply_voice`

docs/api/methods/set_chat_administrator_custom_title.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SetChatAdministratorCustomTitle(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.set_administrator_custom_title`

docs/api/methods/set_chat_description.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SetChatDescription(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.set_description`

docs/api/methods/set_chat_permissions.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SetChatPermissions(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.set_permissions`

docs/api/methods/set_chat_photo.rst

@@ -35,3 +35,11 @@ With specific bot
 .. code-block:: python
 
     result: bool = await bot(SetChatPhoto(...))
+
+
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.set_photo`

docs/api/methods/set_chat_sticker_set.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SetChatStickerSet(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.set_sticker_set`

docs/api/methods/set_chat_title.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SetChatTitle(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.set_title`

docs/api/methods/set_sticker_position_in_set.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return SetStickerPositionInSet(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.sticker.Sticker.set_position_in_set`

docs/api/methods/stop_message_live_location.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return StopMessageLiveLocation(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.stop_live_location`

docs/api/methods/unban_chat_member.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return UnbanChatMember(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.unban`

docs/api/methods/unban_chat_sender_chat.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return UnbanChatSenderChat(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.unban_sender_chat`

docs/api/methods/unpin_all_chat_messages.rst

@@ -42,3 +42,9 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return UnpinAllChatMessages(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.chat.Chat.unpin_all_messages`

docs/api/methods/unpin_chat_message.rst

@@ -42,3 +42,10 @@ As reply into Webhook in handler
 .. code-block:: python
 
     return UnpinChatMessage(...)
+
+
+As shortcut from received object
+--------------------------------
+
+- :meth:`aiogram.types.message.Message.unpin`
+- :meth:`aiogram.types.chat.Chat.unpin_message`