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

.butcher/enums/BotCommandScopeType.yml

@@ -0,0 +1,16 @@
+name: BotCommandScopeType
+description: |
+  This object represents the scope to which bot commands are applied.
+
+  Source: https://core.telegram.org/bots/api#botcommandscope
+multi_parse:
+  attribute: type
+  regexp: "must be ([a-z_]+)"
+  entities:
+    - BotCommandScopeDefault
+    - BotCommandScopeAllPrivateChats
+    - BotCommandScopeAllGroupChats
+    - BotCommandScopeAllChatAdministrators
+    - BotCommandScopeChat
+    - BotCommandScopeChatAdministrators
+    - BotCommandScopeChatMember

.butcher/enums/ChatActions.yml

@@ -0,0 +1,22 @@
+name: ChatAction
+description: |
+  This object represents bot actions.
+
+  Choose one, depending on what the user is about to receive:
+
+  - typing for text messages,
+  - upload_photo for photos,
+  - record_video or upload_video for videos,
+  - record_voice or upload_voice for voice notes,
+  - upload_document for general files,
+  - choose_sticker for stickers,
+  - find_location for location data,
+  - record_video_note or upload_video_note for video notes.
+
+  Source: https://core.telegram.org/bots/api#sendchataction
+parse:
+  format: rst
+  entity: sendChatAction
+  category: methods
+  attribute: action
+  regexp: '\*([a-z_]+)\*'

.butcher/enums/ChatMemberStatus.yml

@@ -0,0 +1,15 @@
+name: ChatMemberStatus
+description: |
+  This object represents chat member status.
+
+  Source: https://core.telegram.org/bots/api#chatmember
+multi_parse:
+  attribute: status
+  regexp: "'([a-z_]+)'"
+  entities:
+    - ChatMemberOwner
+    - ChatMemberAdministrator
+    - ChatMemberMember
+    - ChatMemberRestricted
+    - ChatMemberLeft
+    - ChatMemberBanned

.butcher/enums/ChatType.yml

@@ -0,0 +1,11 @@
+name: ChatType
+description: |
+  This object represents a chat type
+
+  Source: https://core.telegram.org/bots/api#chat
+parse:
+  entity: Chat
+  attribute: type
+  regexp: "'([a-z]+)'"
+static:
+  SENDER: sender

.butcher/enums/content_type.yml → .butcher/enums/ContentType.yml

@@ -1,5 +1,6 @@
 name: ContentType
-description: "Message content type"
+description:
+  This object represents a type of content in message
 static:
   UNKNOWN: unknown
   ANY: any

.butcher/enums/dice.yml → .butcher/enums/DiceEmoji.yml

@@ -1,5 +1,8 @@
 name: DiceEmoji
-description: "Emoji on which the dice throw animation is based"
+description: |
+  Emoji on which the dice throw animation is based
+
+  Source: https://core.telegram.org/bots/api#dice
 static:
   DICE: 🎲
   DART: 🎯

.butcher/enums/InlineQueryResultType.yml

@@ -0,0 +1,29 @@
+name: InlineQueryResultType
+description: |
+  The part of the face relative to which the mask should be placed.
+
+  Source: https://core.telegram.org/bots/api#maskposition
+multi_parse:
+  attribute: type
+  regexp: "must be ([a-z_]+)"
+  entities:
+  - InlineQueryResultCachedAudio
+  - InlineQueryResultCachedDocument
+  - InlineQueryResultCachedGif
+  - InlineQueryResultCachedMpeg4Gif
+  - InlineQueryResultCachedPhoto
+  - InlineQueryResultCachedSticker
+  - InlineQueryResultCachedVideo
+  - InlineQueryResultCachedVoice
+  - InlineQueryResultArticle
+  - InlineQueryResultAudio
+  - InlineQueryResultContact
+  - InlineQueryResultGame
+  - InlineQueryResultDocument
+  - InlineQueryResultGif
+  - InlineQueryResultLocation
+  - InlineQueryResultMpeg4Gif
+  - InlineQueryResultPhoto
+  - InlineQueryResultVenue
+  - InlineQueryResultVideo
+  - InlineQueryResultVoice

.butcher/enums/InputMediaType.yml

@@ -0,0 +1,14 @@
+name: InputMediaType
+description: |
+  This object represents input media type
+
+  Source: https://core.telegram.org/bots/api#inputmedia
+multi_parse:
+  attribute: type
+  regexp: 'must be ([a-z_]+)'
+  entities:
+    - InputMediaAnimation
+    - InputMediaAudio
+    - InputMediaDocument
+    - InputMediaPhoto
+    - InputMediaVideo

.butcher/enums/MaskPositionPoint.yml

@@ -0,0 +1,9 @@
+name: MaskPositionPoint
+description: |
+  The part of the face relative to which the mask should be placed.
+
+  Source: https://core.telegram.org/bots/api#maskposition
+parse:
+  entity: MaskPosition
+  attribute: point
+  regexp: "'([a-z_]+)'"

.butcher/enums/MenuButtonType.yml

@@ -0,0 +1,13 @@
+name: MenuButtonType
+description: |
+  This object represents an type of Menu button
+
+  Source: https://core.telegram.org/bots/api#menubuttondefault
+multi_parse:
+  format: rst
+  attribute: type
+  regexp: '\*([a-z_]+)\*'
+  entities:
+    - MenuButtonDefault
+    - MenuButtonCommands
+    - MenuButtonWebApp

.butcher/enums/MessageEntityType.yml

@@ -0,0 +1,10 @@
+name: MessageEntityType
+description: |
+  This object represents type of message entity
+
+  Source: https://core.telegram.org/bots/api#messageentity
+parse:
+  entity: MessageEntity
+  category: types
+  attribute: type
+  regexp: "'([a-z_]+)'"

.butcher/enums/ParseMode.yml

@@ -0,0 +1,9 @@
+name: ParseMode
+description: |
+  Formatting options
+
+  Source: https://core.telegram.org/bots/api#formatting-options
+static:
+  MARKDOWN_V2: MarkdownV2
+  MARKDOWN: Markdown
+  HTML: HTML

.butcher/enums/PollType.yml

@@ -0,0 +1,9 @@
+name: PollType
+description: |
+  This object represents poll type
+
+  Source: https://core.telegram.org/bots/api#poll
+parse:
+  entity: Poll
+  attribute: type
+  regexp: "'([a-z]+)'"

.butcher/enums/StickerType.yml

@@ -0,0 +1,9 @@
+name: StickerType
+description: |
+  The part of the face relative to which the mask should be placed.
+
+  Source: https://core.telegram.org/bots/api#maskposition
+parse:
+  entity: Sticker
+  attribute: type
+  regexp: "'([a-z_]+)'"

.butcher/enums/UpdateType.yml

@@ -0,0 +1,9 @@
+name: UpdateType
+description: |
+  This object represents the complete list of allowed update types
+
+  Source: https://core.telegram.org/bots/api#update
+extract:
+  entity: Update
+  exclude:
+    - update_id

.butcher/templates/enums/index.rst.jinja2

@@ -1,5 +1,5 @@
 #####
-Types
+Enums
 #####
 
 Here is list of all available enums:

.butcher/templates/methods/entity.rst.jinja2

@@ -47,7 +47,7 @@ As reply into Webhook in handler
 
 {% if aliased %}
 As shortcut from received object
--------------------
+--------------------------------
 {% for alias in aliased %}
 - :meth:`aiogram.types.{{ alias.type|pythonize_name }}.{{ alias.type|pythonize_class_name }}.{{ alias.name }}`
 {%- endfor %}

.butcher/types/CallbackQuery/aliases.yml

@@ -0,0 +1,4 @@
+answer:
+  method: answerCallbackQuery
+  fill:
+    callback_query_id: self.id