From 6570d0bab102e0fcfa06c5490ded50ca0cffe2ee Mon Sep 17 00:00:00 2001 From: Alex Root Junior Date: Sat, 11 Mar 2023 02:17:47 +0200 Subject: [PATCH] Bot API 6.6 (#1139) * Added basic support of Bot API 6.6 * Update descriptions * Added StickerFormat enum * Bump version * Refresh from docs * Fixed CommandStart * Fixed files uploading * Cover new functionality * Added changelog * Update texts --- .apiversion | 2 +- .butcher/enums/InlineQueryResultType.yml | 4 +- .butcher/enums/StickerFormat.yml | 10 + .butcher/methods/addStickerToSet/entity.json | 48 +- .../methods/createNewStickerSet/entity.json | 68 +- .butcher/methods/deleteStickerSet/entity.json | 27 + .../editMessageLiveLocation/entity.json | 4 +- .butcher/methods/getMyDescription/entity.json | 27 + .../methods/getMyShortDescription/entity.json | 27 + .butcher/methods/sendAnimation/entity.json | 2 +- .butcher/methods/sendAudio/entity.json | 2 +- .butcher/methods/sendDocument/entity.json | 2 +- .butcher/methods/sendSticker/entity.json | 14 +- .butcher/methods/sendVideo/entity.json | 2 +- .butcher/methods/sendVideoNote/entity.json | 2 +- .../entity.json | 35 + .../entity.json | 6 +- .butcher/methods/setMyDescription/entity.json | 35 + .../methods/setMyShortDescription/entity.json | 35 + .../methods/setStickerEmojiList/entity.json | 35 + .../methods/setStickerKeywords/entity.json | 35 + .../setStickerMaskPosition/entity.json | 35 + .../methods/setStickerSetThumb/entity.json | 43 - .../setStickerSetThumbnail/entity.json | 43 + .../methods/setStickerSetTitle/entity.json | 35 + .../stopMessageLiveLocation/entity.json | 4 +- .../methods/uploadStickerFile/entity.json | 22 +- .butcher/schema/schema.json | 824 ++++++++++++------ .butcher/types/Animation/entity.json | 2 +- .butcher/types/Audio/entity.json | 2 +- .butcher/types/BotDescription/entity.json | 27 + .../types/BotShortDescription/entity.json | 27 + .butcher/types/Document/entity.json | 2 +- .../InlineQueryResultArticle/entity.json | 6 +- .../InlineQueryResultContact/entity.json | 6 +- .../InlineQueryResultDocument/entity.json | 6 +- .../types/InlineQueryResultGif/entity.json | 4 +- .../InlineQueryResultLocation/entity.json | 6 +- .../InlineQueryResultMpeg4Gif/entity.json | 4 +- .../types/InlineQueryResultPhoto/entity.json | 2 +- .../types/InlineQueryResultVenue/entity.json | 6 +- .../types/InlineQueryResultVideo/entity.json | 2 +- .../types/InputMediaAnimation/entity.json | 2 +- .butcher/types/InputMediaAudio/entity.json | 2 +- .butcher/types/InputMediaDocument/entity.json | 2 +- .butcher/types/InputMediaVideo/entity.json | 2 +- .butcher/types/InputSticker/entity.json | 51 ++ .butcher/types/Sticker/entity.json | 10 +- .butcher/types/StickerSet/entity.json | 2 +- .butcher/types/Video/entity.json | 2 +- .butcher/types/VideoNote/entity.json | 2 +- CHANGES/1139.misc.rst | 7 + README.rst | 2 +- aiogram/__init__.py | 4 +- aiogram/client/bot.py | 384 ++++++-- aiogram/client/session/aiohttp.py | 1 + aiogram/enums/__init__.py | 2 + aiogram/enums/inline_query_result_type.py | 4 +- aiogram/enums/sticker_format.py | 13 + aiogram/filters/command.py | 4 +- aiogram/methods/__init__.py | 24 +- aiogram/methods/add_sticker_to_set.py | 26 +- aiogram/methods/base.py | 20 +- aiogram/methods/create_new_sticker_set.py | 34 +- aiogram/methods/delete_sticker_set.py | 26 + aiogram/methods/get_my_description.py | 27 + aiogram/methods/get_my_short_description.py | 27 + aiogram/methods/send_animation.py | 4 +- aiogram/methods/send_audio.py | 4 +- aiogram/methods/send_document.py | 4 +- aiogram/methods/send_sticker.py | 4 +- aiogram/methods/send_video.py | 4 +- aiogram/methods/send_video_note.py | 4 +- .../set_custom_emoji_sticker_set_thumbnail.py | 28 + .../set_my_default_administrator_rights.py | 2 +- aiogram/methods/set_my_description.py | 28 + aiogram/methods/set_my_short_description.py | 28 + aiogram/methods/set_sticker_emoji_list.py | 28 + aiogram/methods/set_sticker_keywords.py | 28 + aiogram/methods/set_sticker_mask_position.py | 29 + aiogram/methods/set_sticker_set_thumb.py | 34 - aiogram/methods/set_sticker_set_thumbnail.py | 34 + aiogram/methods/set_sticker_set_title.py | 28 + aiogram/methods/upload_sticker_file.py | 12 +- aiogram/types/__init__.py | 6 + aiogram/types/animation.py | 2 +- aiogram/types/audio.py | 2 +- aiogram/types/bot_description.py | 12 + aiogram/types/bot_short_description.py | 12 + aiogram/types/document.py | 2 +- aiogram/types/inline_query_result_article.py | 6 +- aiogram/types/inline_query_result_contact.py | 6 +- aiogram/types/inline_query_result_document.py | 6 +- aiogram/types/inline_query_result_gif.py | 4 +- aiogram/types/inline_query_result_location.py | 6 +- .../types/inline_query_result_mpeg4_gif.py | 4 +- aiogram/types/inline_query_result_photo.py | 2 +- aiogram/types/inline_query_result_venue.py | 6 +- aiogram/types/inline_query_result_video.py | 2 +- aiogram/types/input_media_animation.py | 2 +- aiogram/types/input_media_audio.py | 2 +- aiogram/types/input_media_document.py | 2 +- aiogram/types/input_media_video.py | 2 +- aiogram/types/input_sticker.py | 26 + aiogram/types/message.py | 70 +- aiogram/types/sticker.py | 4 +- aiogram/types/sticker_set.py | 2 +- aiogram/types/video.py | 2 +- aiogram/types/video_note.py | 2 +- docs/api/enums/index.rst | 1 + docs/api/enums/sticker_format.rst | 9 + docs/api/methods/delete_sticker_set.rst | 44 + docs/api/methods/get_my_description.rst | 37 + docs/api/methods/get_my_short_description.rst | 37 + docs/api/methods/index.rst | 16 +- ...set_custom_emoji_sticker_set_thumbnail.rst | 44 + docs/api/methods/set_my_description.rst | 44 + docs/api/methods/set_my_short_description.rst | 44 + docs/api/methods/set_sticker_emoji_list.rst | 44 + docs/api/methods/set_sticker_keywords.rst | 44 + .../api/methods/set_sticker_mask_position.rst | 44 + .../api/methods/set_sticker_set_thumbnail.rst | 44 + docs/api/methods/set_sticker_set_title.rst | 44 + docs/api/types/bot_description.rst | 9 + docs/api/types/bot_short_description.rst | 9 + docs/api/types/index.rst | 3 + docs/api/types/input_sticker.rst | 9 + .../api/enums/inline_query_result_type.po | 14 +- .../LC_MESSAGES/api/enums/sticker_format.po | 30 + .../api/methods/add_sticker_to_set.po | 121 +-- .../api/methods/create_new_sticker_set.po | 128 ++- .../api/methods/delete_sticker_set.po | 73 ++ .../api/methods/get_chat_member.po | 20 +- .../api/methods/get_my_description.po | 70 ++ .../api/methods/get_my_short_description.po | 74 ++ .../api/methods/promote_chat_member.po | 16 +- .../api/methods/restrict_chat_member.po | 17 +- .../LC_MESSAGES/api/methods/send_sticker.po | 27 +- .../api/methods/set_chat_permissions.po | 17 +- .../set_custom_emoji_sticker_set_thumbnail.po | 90 ++ .../set_my_default_administrator_rights.po | 19 +- .../api/methods/set_my_description.po | 83 ++ .../api/methods/set_my_short_description.po | 88 ++ .../api/methods/set_sticker_emoji_list.po | 81 ++ .../api/methods/set_sticker_keywords.po | 83 ++ .../api/methods/set_sticker_mask_position.po | 86 ++ .../api/methods/set_sticker_set_thumb.po | 104 ++- .../api/methods/set_sticker_set_thumbnail.po | 108 +++ .../api/methods/set_sticker_set_title.po | 80 ++ .../api/methods/upload_sticker_file.po | 46 +- .../LC_MESSAGES/api/types/bot_description.po | 35 + .../api/types/bot_short_description.po | 36 + docs/locale/en/LC_MESSAGES/api/types/chat.po | 48 +- .../api/types/chat_administrator_rights.po | 16 +- .../api/types/chat_join_request.po | 16 +- .../en/LC_MESSAGES/api/types/chat_member.po | 62 +- .../api/types/chat_member_administrator.po | 16 +- .../api/types/chat_member_restricted.po | 120 ++- .../LC_MESSAGES/api/types/chat_permissions.po | 79 +- .../en/LC_MESSAGES/api/types/chat_shared.po | 49 ++ .../en/LC_MESSAGES/api/types/input_sticker.po | 56 ++ .../LC_MESSAGES/api/types/keyboard_button.po | 54 +- .../api/types/keyboard_button_request_chat.po | 104 +++ .../api/types/keyboard_button_request_user.po | 60 ++ .../en/LC_MESSAGES/api/types/message.po | 58 +- .../en/LC_MESSAGES/api/types/sticker.po | 14 +- .../en/LC_MESSAGES/api/types/user_shared.po | 49 ++ docs/locale/en/LC_MESSAGES/api/upload_file.po | 47 +- docs/locale/en/LC_MESSAGES/changelog.po | 512 +++++++---- docs/locale/en/LC_MESSAGES/contributing.po | 322 +++++++ .../en/LC_MESSAGES/dispatcher/dispatcher.po | 44 +- docs/locale/en/LC_MESSAGES/index.po | 106 +-- .../en/LC_MESSAGES/utils/callback_answer.po | 204 +++++ .../api/enums/inline_query_result_type.po | 14 +- .../LC_MESSAGES/api/enums/sticker_format.po | 30 + .../api/methods/add_sticker_to_set.po | 121 +-- .../api/methods/create_new_sticker_set.po | 128 ++- .../api/methods/delete_sticker_set.po | 73 ++ .../api/methods/get_my_description.po | 70 ++ .../api/methods/get_my_short_description.po | 74 ++ .../LC_MESSAGES/api/methods/send_sticker.po | 27 +- .../set_custom_emoji_sticker_set_thumbnail.po | 90 ++ .../set_my_default_administrator_rights.po | 19 +- .../api/methods/set_my_description.po | 83 ++ .../api/methods/set_my_short_description.po | 88 ++ .../api/methods/set_sticker_emoji_list.po | 81 ++ .../api/methods/set_sticker_keywords.po | 83 ++ .../api/methods/set_sticker_mask_position.po | 86 ++ .../api/methods/set_sticker_set_thumb.po | 104 ++- .../api/methods/set_sticker_set_thumbnail.po | 108 +++ .../api/methods/set_sticker_set_title.po | 80 ++ .../api/methods/upload_sticker_file.po | 46 +- .../LC_MESSAGES/api/types/bot_description.po | 35 + .../api/types/bot_short_description.po | 36 + .../LC_MESSAGES/api/types/input_sticker.po | 56 ++ .../uk_UA/LC_MESSAGES/api/types/message.po | 49 +- .../uk_UA/LC_MESSAGES/api/types/sticker.po | 14 +- .../uk_UA/LC_MESSAGES/api/upload_file.po | 71 +- docs/locale/uk_UA/LC_MESSAGES/changelog.po | 474 ++++++---- .../LC_MESSAGES/dispatcher/dispatcher.po | 63 +- docs/locale/uk_UA/LC_MESSAGES/index.po | 98 +-- .../test_methods/test_add_sticker_to_set.py | 9 +- .../test_methods/test_answer_inline_query.py | 6 +- .../test_create_new_sticker_set.py | 20 +- .../test_methods/test_delete_sticker_set.py | 20 + .../test_methods/test_get_my_description.py | 25 + .../test_get_my_short_description.py | 25 + .../test_methods/test_send_video_note.py | 8 +- ..._set_custom_emoji_sticker_set_thumbnail.py | 28 + .../test_methods/test_set_my_description.py | 20 + .../test_set_my_short_description.py | 20 + .../test_set_sticker_emoji_list.py | 20 + .../test_methods/test_set_sticker_keywords.py | 20 + .../test_set_sticker_mask_position.py | 20 + .../test_set_sticker_set_thumb.py | 22 - .../test_set_sticker_set_thumbnail.py | 22 + .../test_set_sticker_set_title.py | 20 + .../test_methods/test_upload_sticker_file.py | 9 +- 218 files changed, 7687 insertions(+), 1741 deletions(-) create mode 100644 .butcher/enums/StickerFormat.yml create mode 100644 .butcher/methods/deleteStickerSet/entity.json create mode 100644 .butcher/methods/getMyDescription/entity.json create mode 100644 .butcher/methods/getMyShortDescription/entity.json create mode 100644 .butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json create mode 100644 .butcher/methods/setMyDescription/entity.json create mode 100644 .butcher/methods/setMyShortDescription/entity.json create mode 100644 .butcher/methods/setStickerEmojiList/entity.json create mode 100644 .butcher/methods/setStickerKeywords/entity.json create mode 100644 .butcher/methods/setStickerMaskPosition/entity.json delete mode 100644 .butcher/methods/setStickerSetThumb/entity.json create mode 100644 .butcher/methods/setStickerSetThumbnail/entity.json create mode 100644 .butcher/methods/setStickerSetTitle/entity.json create mode 100644 .butcher/types/BotDescription/entity.json create mode 100644 .butcher/types/BotShortDescription/entity.json create mode 100644 .butcher/types/InputSticker/entity.json create mode 100644 CHANGES/1139.misc.rst create mode 100644 aiogram/enums/sticker_format.py create mode 100644 aiogram/methods/delete_sticker_set.py create mode 100644 aiogram/methods/get_my_description.py create mode 100644 aiogram/methods/get_my_short_description.py create mode 100644 aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py create mode 100644 aiogram/methods/set_my_description.py create mode 100644 aiogram/methods/set_my_short_description.py create mode 100644 aiogram/methods/set_sticker_emoji_list.py create mode 100644 aiogram/methods/set_sticker_keywords.py create mode 100644 aiogram/methods/set_sticker_mask_position.py delete mode 100644 aiogram/methods/set_sticker_set_thumb.py create mode 100644 aiogram/methods/set_sticker_set_thumbnail.py create mode 100644 aiogram/methods/set_sticker_set_title.py create mode 100644 aiogram/types/bot_description.py create mode 100644 aiogram/types/bot_short_description.py create mode 100644 aiogram/types/input_sticker.py create mode 100644 docs/api/enums/sticker_format.rst create mode 100644 docs/api/methods/delete_sticker_set.rst create mode 100644 docs/api/methods/get_my_description.rst create mode 100644 docs/api/methods/get_my_short_description.rst create mode 100644 docs/api/methods/set_custom_emoji_sticker_set_thumbnail.rst create mode 100644 docs/api/methods/set_my_description.rst create mode 100644 docs/api/methods/set_my_short_description.rst create mode 100644 docs/api/methods/set_sticker_emoji_list.rst create mode 100644 docs/api/methods/set_sticker_keywords.rst create mode 100644 docs/api/methods/set_sticker_mask_position.rst create mode 100644 docs/api/methods/set_sticker_set_thumbnail.rst create mode 100644 docs/api/methods/set_sticker_set_title.rst create mode 100644 docs/api/types/bot_description.rst create mode 100644 docs/api/types/bot_short_description.rst create mode 100644 docs/api/types/input_sticker.rst create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/sticker_format.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_set.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/get_my_description.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/get_my_short_description.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_my_description.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_my_short_description.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_sticker_emoji_list.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_sticker_keywords.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_sticker_mask_position.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po create mode 100644 docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_title.po create mode 100644 docs/locale/en/LC_MESSAGES/api/types/bot_description.po create mode 100644 docs/locale/en/LC_MESSAGES/api/types/bot_short_description.po create mode 100644 docs/locale/en/LC_MESSAGES/api/types/chat_shared.po create mode 100644 docs/locale/en/LC_MESSAGES/api/types/input_sticker.po create mode 100644 docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_chat.po create mode 100644 docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_user.po create mode 100644 docs/locale/en/LC_MESSAGES/api/types/user_shared.po create mode 100644 docs/locale/en/LC_MESSAGES/contributing.po create mode 100644 docs/locale/en/LC_MESSAGES/utils/callback_answer.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/sticker_format.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_set.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_description.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_short_description.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_description.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_short_description.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_emoji_list.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_keywords.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_mask_position.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_title.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/types/bot_description.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/types/bot_short_description.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/types/input_sticker.po create mode 100644 tests/test_api/test_methods/test_delete_sticker_set.py create mode 100644 tests/test_api/test_methods/test_get_my_description.py create mode 100644 tests/test_api/test_methods/test_get_my_short_description.py create mode 100644 tests/test_api/test_methods/test_set_custom_emoji_sticker_set_thumbnail.py create mode 100644 tests/test_api/test_methods/test_set_my_description.py create mode 100644 tests/test_api/test_methods/test_set_my_short_description.py create mode 100644 tests/test_api/test_methods/test_set_sticker_emoji_list.py create mode 100644 tests/test_api/test_methods/test_set_sticker_keywords.py create mode 100644 tests/test_api/test_methods/test_set_sticker_mask_position.py delete mode 100644 tests/test_api/test_methods/test_set_sticker_set_thumb.py create mode 100644 tests/test_api/test_methods/test_set_sticker_set_thumbnail.py create mode 100644 tests/test_api/test_methods/test_set_sticker_set_title.py diff --git a/.apiversion b/.apiversion index 7822c1ab..4074fe20 100644 --- a/.apiversion +++ b/.apiversion @@ -1 +1 @@ -6.5 +6.6 diff --git a/.butcher/enums/InlineQueryResultType.yml b/.butcher/enums/InlineQueryResultType.yml index 8ff8ee0c..74428a3c 100644 --- a/.butcher/enums/InlineQueryResultType.yml +++ b/.butcher/enums/InlineQueryResultType.yml @@ -1,8 +1,8 @@ name: InlineQueryResultType description: | - The part of the face relative to which the mask should be placed. + Type of inline query result - Source: https://core.telegram.org/bots/api#maskposition + Source: https://core.telegram.org/bots/api#inlinequeryresult multi_parse: attribute: type regexp: "must be ([a-z_]+)" diff --git a/.butcher/enums/StickerFormat.yml b/.butcher/enums/StickerFormat.yml new file mode 100644 index 00000000..acfbb00c --- /dev/null +++ b/.butcher/enums/StickerFormat.yml @@ -0,0 +1,10 @@ +name: StickerFormat +description: | + Format of the sticker + + Source: https://core.telegram.org/bots/api#createnewstickerset +parse: + category: methods + entity: createNewStickerSet + attribute: sticker_format + regexp: "'([a-z_]+)'" diff --git a/.butcher/methods/addStickerToSet/entity.json b/.butcher/methods/addStickerToSet/entity.json index 99217457..cab8f7af 100644 --- a/.butcher/methods/addStickerToSet/entity.json +++ b/.butcher/methods/addStickerToSet/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "addstickertoset", "name": "addStickerToSet", - "description": "Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", - "html_description": "

Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", - "rst_description": "Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", + "description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", + "html_description": "

Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", + "rst_description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -30,44 +30,12 @@ "name": "name" }, { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", + "type": "InputSticker", "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" - }, - { - "type": "MaskPosition", - "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" + "description": "A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.", + "html_description": "A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.", + "rst_description": "A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.\n", + "name": "sticker" } ], "category": "methods" diff --git a/.butcher/methods/createNewStickerSet/entity.json b/.butcher/methods/createNewStickerSet/entity.json index 8589f80d..34fcbfc5 100644 --- a/.butcher/methods/createNewStickerSet/entity.json +++ b/.butcher/methods/createNewStickerSet/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "createnewstickerset", "name": "createNewStickerSet", - "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.", - "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.

", - "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success.", + "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.", + "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.

", + "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -38,52 +38,36 @@ "name": "title" }, { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", - "required": false, - "description": "Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created.", - "html_description": "Type of stickers in the set, pass “regular” or “mask”. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created.", - "rst_description": "Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created.\n", - "name": "sticker_type" + "type": "Array of InputSticker", + "required": true, + "description": "A JSON-serialized list of 1-50 initial stickers to be added to the sticker set", + "html_description": "A JSON-serialized list of 1-50 initial stickers to be added to the sticker set", + "rst_description": "A JSON-serialized list of 1-50 initial stickers to be added to the sticker set\n", + "name": "stickers" }, { "type": "String", "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" + "description": "Format of stickers in the set, must be one of 'static', 'animated', 'video'", + "html_description": "Format of stickers in the set, must be one of “static”, “animated”, “video”", + "rst_description": "Format of stickers in the set, must be one of 'static', 'animated', 'video'\n", + "name": "sticker_format" }, { - "type": "MaskPosition", + "type": "String", "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" + "description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.", + "html_description": "Type of stickers in the set, pass “regular”, “mask”, or “custom_emoji”. By default, a regular sticker set is created.", + "rst_description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.\n", + "name": "sticker_type" + }, + { + "type": "Boolean", + "required": false, + "description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "html_description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "rst_description": "Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only\n", + "name": "needs_repainting" } ], "category": "methods" diff --git a/.butcher/methods/deleteStickerSet/entity.json b/.butcher/methods/deleteStickerSet/entity.json new file mode 100644 index 00000000..1ae6f1ba --- /dev/null +++ b/.butcher/methods/deleteStickerSet/entity.json @@ -0,0 +1,27 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "deletestickerset", + "name": "deleteStickerSet", + "description": "Use this method to delete a sticker set that was created by the bot. Returns True on success.", + "html_description": "

Use this method to delete a sticker set that was created by the bot. Returns True on success.

", + "rst_description": "Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/editMessageLiveLocation/entity.json b/.butcher/methods/editMessageLiveLocation/entity.json index 7605f142..77e1beb1 100644 --- a/.butcher/methods/editMessageLiveLocation/entity.json +++ b/.butcher/methods/editMessageLiveLocation/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Available methods", - "anchor": "available-methods" + "title": "Updating messages", + "anchor": "updating-messages" }, "object": { "anchor": "editmessagelivelocation", diff --git a/.butcher/methods/getMyDescription/entity.json b/.butcher/methods/getMyDescription/entity.json new file mode 100644 index 00000000..7b231729 --- /dev/null +++ b/.butcher/methods/getMyDescription/entity.json @@ -0,0 +1,27 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Available methods", + "anchor": "available-methods" + }, + "object": { + "anchor": "getmydescription", + "name": "getMyDescription", + "description": "Use this method to get the current bot description for the given user language. Returns BotDescription on success.", + "html_description": "

Use this method to get the current bot description for the given user language. Returns BotDescription on success.

", + "rst_description": "Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code or an empty string", + "html_description": "A two-letter ISO 639-1 language code or an empty string", + "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", + "name": "language_code" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/getMyShortDescription/entity.json b/.butcher/methods/getMyShortDescription/entity.json new file mode 100644 index 00000000..10f51d1b --- /dev/null +++ b/.butcher/methods/getMyShortDescription/entity.json @@ -0,0 +1,27 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Available methods", + "anchor": "available-methods" + }, + "object": { + "anchor": "getmyshortdescription", + "name": "getMyShortDescription", + "description": "Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.", + "html_description": "

Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.

", + "rst_description": "Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code or an empty string", + "html_description": "A two-letter ISO 639-1 language code or an empty string", + "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", + "name": "language_code" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/sendAnimation/entity.json b/.butcher/methods/sendAnimation/entity.json index 92ebaa2d..5a11b343 100644 --- a/.butcher/methods/sendAnimation/entity.json +++ b/.butcher/methods/sendAnimation/entity.json @@ -67,7 +67,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", diff --git a/.butcher/methods/sendAudio/entity.json b/.butcher/methods/sendAudio/entity.json index a2a3ff84..84eec416 100644 --- a/.butcher/methods/sendAudio/entity.json +++ b/.butcher/methods/sendAudio/entity.json @@ -91,7 +91,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", diff --git a/.butcher/methods/sendDocument/entity.json b/.butcher/methods/sendDocument/entity.json index e6295586..31680179 100644 --- a/.butcher/methods/sendDocument/entity.json +++ b/.butcher/methods/sendDocument/entity.json @@ -43,7 +43,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", diff --git a/.butcher/methods/sendSticker/entity.json b/.butcher/methods/sendSticker/entity.json index eb7e35a9..aca9254c 100644 --- a/.butcher/methods/sendSticker/entity.json +++ b/.butcher/methods/sendSticker/entity.json @@ -32,11 +32,19 @@ { "type": "InputFile or String", "required": true, - "description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", + "description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. More information on Sending Files. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.", + "html_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. More information on Sending Files ». Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.", + "rst_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.\n", "name": "sticker" }, + { + "type": "String", + "required": false, + "description": "Emoji associated with the sticker; only for just uploaded stickers", + "html_description": "Emoji associated with the sticker; only for just uploaded stickers", + "rst_description": "Emoji associated with the sticker; only for just uploaded stickers\n", + "name": "emoji" + }, { "type": "Boolean", "required": false, diff --git a/.butcher/methods/sendVideo/entity.json b/.butcher/methods/sendVideo/entity.json index 9343c43f..b19e2201 100644 --- a/.butcher/methods/sendVideo/entity.json +++ b/.butcher/methods/sendVideo/entity.json @@ -67,7 +67,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", diff --git a/.butcher/methods/sendVideoNote/entity.json b/.butcher/methods/sendVideoNote/entity.json index 2822e49c..ea382889 100644 --- a/.butcher/methods/sendVideoNote/entity.json +++ b/.butcher/methods/sendVideoNote/entity.json @@ -59,7 +59,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", diff --git a/.butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json b/.butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json new file mode 100644 index 00000000..a4b0e265 --- /dev/null +++ b/.butcher/methods/setCustomEmojiStickerSetThumbnail/entity.json @@ -0,0 +1,35 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "setcustomemojistickersetthumbnail", + "name": "setCustomEmojiStickerSetThumbnail", + "description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.", + "html_description": "

Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.

", + "rst_description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + }, + { + "type": "String", + "required": false, + "description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", + "html_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", + "rst_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.\n", + "name": "custom_emoji_id" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/setMyDefaultAdministratorRights/entity.json b/.butcher/methods/setMyDefaultAdministratorRights/entity.json index 687b8f3d..503198d7 100644 --- a/.butcher/methods/setMyDefaultAdministratorRights/entity.json +++ b/.butcher/methods/setMyDefaultAdministratorRights/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "setmydefaultadministratorrights", "name": "setMyDefaultAdministratorRights", - "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.", - "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.

", - "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success.", + "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.", + "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.

", + "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success.", "annotations": [ { "type": "ChatAdministratorRights", diff --git a/.butcher/methods/setMyDescription/entity.json b/.butcher/methods/setMyDescription/entity.json new file mode 100644 index 00000000..9487c34b --- /dev/null +++ b/.butcher/methods/setMyDescription/entity.json @@ -0,0 +1,35 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Available methods", + "anchor": "available-methods" + }, + "object": { + "anchor": "setmydescription", + "name": "setMyDescription", + "description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.", + "html_description": "

Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.

", + "rst_description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", + "html_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", + "rst_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.\n", + "name": "description" + }, + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", + "html_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", + "rst_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.\n", + "name": "language_code" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/setMyShortDescription/entity.json b/.butcher/methods/setMyShortDescription/entity.json new file mode 100644 index 00000000..0bb47047 --- /dev/null +++ b/.butcher/methods/setMyShortDescription/entity.json @@ -0,0 +1,35 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Available methods", + "anchor": "available-methods" + }, + "object": { + "anchor": "setmyshortdescription", + "name": "setMyShortDescription", + "description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.", + "html_description": "

Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.

", + "rst_description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", + "html_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", + "rst_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.\n", + "name": "short_description" + }, + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", + "html_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", + "rst_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.\n", + "name": "language_code" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/setStickerEmojiList/entity.json b/.butcher/methods/setStickerEmojiList/entity.json new file mode 100644 index 00000000..92d1fd39 --- /dev/null +++ b/.butcher/methods/setStickerEmojiList/entity.json @@ -0,0 +1,35 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "setstickeremojilist", + "name": "setStickerEmojiList", + "description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", + "html_description": "

Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", + "rst_description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "Array of String", + "required": true, + "description": "A JSON-serialized list of 1-20 emoji associated with the sticker", + "html_description": "A JSON-serialized list of 1-20 emoji associated with the sticker", + "rst_description": "A JSON-serialized list of 1-20 emoji associated with the sticker\n", + "name": "emoji_list" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/setStickerKeywords/entity.json b/.butcher/methods/setStickerKeywords/entity.json new file mode 100644 index 00000000..cabf2fbe --- /dev/null +++ b/.butcher/methods/setStickerKeywords/entity.json @@ -0,0 +1,35 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "setstickerkeywords", + "name": "setStickerKeywords", + "description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", + "html_description": "

Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", + "rst_description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "Array of String", + "required": false, + "description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", + "html_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", + "rst_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters\n", + "name": "keywords" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/setStickerMaskPosition/entity.json b/.butcher/methods/setStickerMaskPosition/entity.json new file mode 100644 index 00000000..e18fbd04 --- /dev/null +++ b/.butcher/methods/setStickerMaskPosition/entity.json @@ -0,0 +1,35 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "setstickermaskposition", + "name": "setStickerMaskPosition", + "description": "Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.", + "html_description": "

Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.

", + "rst_description": "Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "MaskPosition", + "required": false, + "description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", + "html_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", + "rst_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.\n", + "name": "mask_position" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/setStickerSetThumb/entity.json b/.butcher/methods/setStickerSetThumb/entity.json deleted file mode 100644 index cc7739b3..00000000 --- a/.butcher/methods/setStickerSetThumb/entity.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "meta": { - "deprecated": false - }, - "group": { - "title": "Stickers", - "anchor": "stickers" - }, - "object": { - "anchor": "setstickersetthumb", - "name": "setStickerSetThumb", - "description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.", - "html_description": "

Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.

", - "rst_description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns :code:`True` on success.", - "annotations": [ - { - "type": "String", - "required": true, - "description": "Sticker set name", - "html_description": "Sticker set name", - "rst_description": "Sticker set name\n", - "name": "name" - }, - { - "type": "Integer", - "required": true, - "description": "User identifier of the sticker set owner", - "html_description": "User identifier of the sticker set owner", - "rst_description": "User identifier of the sticker set owner\n", - "name": "user_id" - }, - { - "type": "InputFile or String", - "required": false, - "description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "html_description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "rst_description": "A **PNG** image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a **TGS** animation with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements, or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated sticker set thumbnails can't be uploaded via HTTP URL.\n", - "name": "thumb" - } - ], - "category": "methods" - } -} diff --git a/.butcher/methods/setStickerSetThumbnail/entity.json b/.butcher/methods/setStickerSetThumbnail/entity.json new file mode 100644 index 00000000..b5eac7cf --- /dev/null +++ b/.butcher/methods/setStickerSetThumbnail/entity.json @@ -0,0 +1,43 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "setstickersetthumbnail", + "name": "setStickerSetThumbnail", + "description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.", + "html_description": "

Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.

", + "rst_description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + }, + { + "type": "Integer", + "required": true, + "description": "User identifier of the sticker set owner", + "html_description": "User identifier of the sticker set owner", + "rst_description": "User identifier of the sticker set owner\n", + "name": "user_id" + }, + { + "type": "InputFile or String", + "required": false, + "description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", + "html_description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", + "rst_description": "A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.\n", + "name": "thumbnail" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/setStickerSetTitle/entity.json b/.butcher/methods/setStickerSetTitle/entity.json new file mode 100644 index 00000000..757f508a --- /dev/null +++ b/.butcher/methods/setStickerSetTitle/entity.json @@ -0,0 +1,35 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "setstickersettitle", + "name": "setStickerSetTitle", + "description": "Use this method to set the title of a created sticker set. Returns True on success.", + "html_description": "

Use this method to set the title of a created sticker set. Returns True on success.

", + "rst_description": "Use this method to set the title of a created sticker set. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + }, + { + "type": "String", + "required": true, + "description": "Sticker set title, 1-64 characters", + "html_description": "Sticker set title, 1-64 characters", + "rst_description": "Sticker set title, 1-64 characters\n", + "name": "title" + } + ], + "category": "methods" + } +} diff --git a/.butcher/methods/stopMessageLiveLocation/entity.json b/.butcher/methods/stopMessageLiveLocation/entity.json index 3ede9d40..6f1cb51c 100644 --- a/.butcher/methods/stopMessageLiveLocation/entity.json +++ b/.butcher/methods/stopMessageLiveLocation/entity.json @@ -3,8 +3,8 @@ "deprecated": false }, "group": { - "title": "Available methods", - "anchor": "available-methods" + "title": "Updating messages", + "anchor": "updating-messages" }, "object": { "anchor": "stopmessagelivelocation", diff --git a/.butcher/methods/uploadStickerFile/entity.json b/.butcher/methods/uploadStickerFile/entity.json index 445de997..687ae2cb 100644 --- a/.butcher/methods/uploadStickerFile/entity.json +++ b/.butcher/methods/uploadStickerFile/entity.json @@ -9,9 +9,9 @@ "object": { "anchor": "uploadstickerfile", "name": "uploadStickerFile", - "description": "Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.", - "html_description": "

Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.

", - "rst_description": "Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", + "description": "Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.", + "html_description": "

Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.

", + "rst_description": "Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", "annotations": [ { "type": "Integer", @@ -24,10 +24,18 @@ { "type": "InputFile", "required": true, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" + "description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files", + "html_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files »", + "rst_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `\n", + "name": "sticker" + }, + { + "type": "String", + "required": true, + "description": "Format of the sticker, must be one of 'static', 'animated', 'video'", + "html_description": "Format of the sticker, must be one of “static”, “animated”, “video”", + "rst_description": "Format of the sticker, must be one of 'static', 'animated', 'video'\n", + "name": "sticker_format" } ], "category": "methods" diff --git a/.butcher/schema/schema.json b/.butcher/schema/schema.json index 32dbfdac..02015146 100644 --- a/.butcher/schema/schema.json +++ b/.butcher/schema/schema.json @@ -1,7 +1,7 @@ { "api": { - "version": "6.5", - "release_date": "2023-02-03" + "version": "6.6", + "release_date": "2023-03-09" }, "items": [ { @@ -1458,7 +1458,7 @@ "description": "Animation thumbnail as defined by sender", "html_description": "Optional. Animation thumbnail as defined by sender", "rst_description": "*Optional*. Animation thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -1564,7 +1564,7 @@ "description": "Thumbnail of the album cover to which the music file belongs", "html_description": "Optional. Thumbnail of the album cover to which the music file belongs", "rst_description": "*Optional*. Thumbnail of the album cover to which the music file belongs\n", - "name": "thumb", + "name": "thumbnail", "required": false } ], @@ -1598,7 +1598,7 @@ "description": "Document thumbnail as defined by sender", "html_description": "Optional. Document thumbnail as defined by sender", "rst_description": "*Optional*. Document thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -1680,7 +1680,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -1754,7 +1754,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4252,6 +4252,42 @@ ], "category": "types" }, + { + "anchor": "botdescription", + "name": "BotDescription", + "description": "This object represents the bot's description.", + "html_description": "

This object represents the bot's description.

", + "rst_description": "This object represents the bot's description.", + "annotations": [ + { + "type": "String", + "description": "The bot's description", + "html_description": "The bot's description", + "rst_description": "The bot's description\n", + "name": "description", + "required": true + } + ], + "category": "types" + }, + { + "anchor": "botshortdescription", + "name": "BotShortDescription", + "description": "This object represents the bot's short description.", + "html_description": "

This object represents the bot's short description.

", + "rst_description": "This object represents the bot's short description.", + "annotations": [ + { + "type": "String", + "description": "The bot's short description", + "html_description": "The bot's short description", + "rst_description": "The bot's short description\n", + "name": "short_description", + "required": true + } + ], + "category": "types" + }, { "anchor": "menubutton", "name": "MenuButton", @@ -4452,7 +4488,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4550,7 +4586,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4640,7 +4676,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -4722,7 +4758,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -5256,7 +5292,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", @@ -5338,7 +5374,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -5476,7 +5512,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -5622,7 +5658,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "String", @@ -5858,7 +5894,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb" + "name": "thumbnail" }, { "type": "Boolean", @@ -6083,130 +6119,6 @@ ], "category": "methods" }, - { - "anchor": "editmessagelivelocation", - "name": "editMessageLiveLocation", - "description": "Use this method to edit live location messages. A location can be edited 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.", - "html_description": "

Use this method to edit live location messages. A location can be edited 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.

", - "rst_description": "Use this method to edit live location messages. A location can be edited until its *live_period* expires or editing is explicitly disabled by a call to :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", - "annotations": [ - { - "type": "Integer or String", - "required": false, - "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", - "name": "chat_id" - }, - { - "type": "Integer", - "required": false, - "description": "Required if inline_message_id is not specified. Identifier of the message to edit", - "html_description": "Required if inline_message_id is not specified. Identifier of the message to edit", - "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message to edit\n", - "name": "message_id" - }, - { - "type": "String", - "required": false, - "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", - "name": "inline_message_id" - }, - { - "type": "Float number", - "required": true, - "description": "Latitude of new location", - "html_description": "Latitude of new location", - "rst_description": "Latitude of new location\n", - "name": "latitude" - }, - { - "type": "Float number", - "required": true, - "description": "Longitude of new location", - "html_description": "Longitude of new location", - "rst_description": "Longitude of new location\n", - "name": "longitude" - }, - { - "type": "Float number", - "required": false, - "description": "The radius of uncertainty for the location, measured in meters; 0-1500", - "html_description": "The radius of uncertainty for the location, measured in meters; 0-1500", - "rst_description": "The radius of uncertainty for the location, measured in meters; 0-1500\n", - "name": "horizontal_accuracy" - }, - { - "type": "Integer", - "required": false, - "description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", - "html_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", - "rst_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.\n", - "name": "heading" - }, - { - "type": "Integer", - "required": false, - "description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", - "html_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", - "rst_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.\n", - "name": "proximity_alert_radius" - }, - { - "type": "InlineKeyboardMarkup", - "required": false, - "description": "A JSON-serialized object for a new inline keyboard.", - "html_description": "A JSON-serialized object for a new inline keyboard.", - "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", - "name": "reply_markup" - } - ], - "category": "methods" - }, - { - "anchor": "stopmessagelivelocation", - "name": "stopMessageLiveLocation", - "description": "Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.", - "html_description": "

Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.

", - "rst_description": "Use this method to stop updating a live location message before *live_period* expires. On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", - "annotations": [ - { - "type": "Integer or String", - "required": false, - "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", - "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", - "name": "chat_id" - }, - { - "type": "Integer", - "required": false, - "description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", - "html_description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", - "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message with live location to stop\n", - "name": "message_id" - }, - { - "type": "String", - "required": false, - "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", - "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", - "name": "inline_message_id" - }, - { - "type": "InlineKeyboardMarkup", - "required": false, - "description": "A JSON-serialized object for a new inline keyboard.", - "html_description": "A JSON-serialized object for a new inline keyboard.", - "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", - "name": "reply_markup" - } - ], - "category": "methods" - }, { "anchor": "sendvenue", "name": "sendVenue", @@ -8076,6 +7988,94 @@ ], "category": "methods" }, + { + "anchor": "setmydescription", + "name": "setMyDescription", + "description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.", + "html_description": "

Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success.

", + "rst_description": "Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", + "html_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.", + "rst_description": "New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.\n", + "name": "description" + }, + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", + "html_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.", + "rst_description": "A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.\n", + "name": "language_code" + } + ], + "category": "methods" + }, + { + "anchor": "getmydescription", + "name": "getMyDescription", + "description": "Use this method to get the current bot description for the given user language. Returns BotDescription on success.", + "html_description": "

Use this method to get the current bot description for the given user language. Returns BotDescription on success.

", + "rst_description": "Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code or an empty string", + "html_description": "A two-letter ISO 639-1 language code or an empty string", + "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", + "name": "language_code" + } + ], + "category": "methods" + }, + { + "anchor": "setmyshortdescription", + "name": "setMyShortDescription", + "description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.", + "html_description": "

Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success.

", + "rst_description": "Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", + "html_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.", + "rst_description": "New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.\n", + "name": "short_description" + }, + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", + "html_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.", + "rst_description": "A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.\n", + "name": "language_code" + } + ], + "category": "methods" + }, + { + "anchor": "getmyshortdescription", + "name": "getMyShortDescription", + "description": "Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.", + "html_description": "

Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success.

", + "rst_description": "Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success.", + "annotations": [ + { + "type": "String", + "required": false, + "description": "A two-letter ISO 639-1 language code or an empty string", + "html_description": "A two-letter ISO 639-1 language code or an empty string", + "rst_description": "A two-letter ISO 639-1 language code or an empty string\n", + "name": "language_code" + } + ], + "category": "methods" + }, { "anchor": "setchatmenubutton", "name": "setChatMenuButton", @@ -8123,9 +8123,9 @@ { "anchor": "setmydefaultadministratorrights", "name": "setMyDefaultAdministratorRights", - "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.", - "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success.

", - "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success.", + "description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.", + "html_description": "

Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns True on success.

", + "rst_description": "Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success.", "annotations": [ { "type": "ChatAdministratorRights", @@ -8361,6 +8361,130 @@ ], "category": "methods" }, + { + "anchor": "editmessagelivelocation", + "name": "editMessageLiveLocation", + "description": "Use this method to edit live location messages. A location can be edited 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.", + "html_description": "

Use this method to edit live location messages. A location can be edited 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.

", + "rst_description": "Use this method to edit live location messages. A location can be edited until its *live_period* expires or editing is explicitly disabled by a call to :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", + "annotations": [ + { + "type": "Integer or String", + "required": false, + "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", + "name": "chat_id" + }, + { + "type": "Integer", + "required": false, + "description": "Required if inline_message_id is not specified. Identifier of the message to edit", + "html_description": "Required if inline_message_id is not specified. Identifier of the message to edit", + "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message to edit\n", + "name": "message_id" + }, + { + "type": "String", + "required": false, + "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", + "name": "inline_message_id" + }, + { + "type": "Float number", + "required": true, + "description": "Latitude of new location", + "html_description": "Latitude of new location", + "rst_description": "Latitude of new location\n", + "name": "latitude" + }, + { + "type": "Float number", + "required": true, + "description": "Longitude of new location", + "html_description": "Longitude of new location", + "rst_description": "Longitude of new location\n", + "name": "longitude" + }, + { + "type": "Float number", + "required": false, + "description": "The radius of uncertainty for the location, measured in meters; 0-1500", + "html_description": "The radius of uncertainty for the location, measured in meters; 0-1500", + "rst_description": "The radius of uncertainty for the location, measured in meters; 0-1500\n", + "name": "horizontal_accuracy" + }, + { + "type": "Integer", + "required": false, + "description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", + "html_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.", + "rst_description": "Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.\n", + "name": "heading" + }, + { + "type": "Integer", + "required": false, + "description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", + "html_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.", + "rst_description": "The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.\n", + "name": "proximity_alert_radius" + }, + { + "type": "InlineKeyboardMarkup", + "required": false, + "description": "A JSON-serialized object for a new inline keyboard.", + "html_description": "A JSON-serialized object for a new inline keyboard.", + "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", + "name": "reply_markup" + } + ], + "category": "methods" + }, + { + "anchor": "stopmessagelivelocation", + "name": "stopMessageLiveLocation", + "description": "Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.", + "html_description": "

Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.

", + "rst_description": "Use this method to stop updating a live location message before *live_period* expires. On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.", + "annotations": [ + { + "type": "Integer or String", + "required": false, + "description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "html_description": "Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", + "rst_description": "Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n", + "name": "chat_id" + }, + { + "type": "Integer", + "required": false, + "description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", + "html_description": "Required if inline_message_id is not specified. Identifier of the message with live location to stop", + "rst_description": "Required if *inline_message_id* is not specified. Identifier of the message with live location to stop\n", + "name": "message_id" + }, + { + "type": "String", + "required": false, + "description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "html_description": "Required if chat_id and message_id are not specified. Identifier of the inline message", + "rst_description": "Required if *chat_id* and *message_id* are not specified. Identifier of the inline message\n", + "name": "inline_message_id" + }, + { + "type": "InlineKeyboardMarkup", + "required": false, + "description": "A JSON-serialized object for a new inline keyboard.", + "html_description": "A JSON-serialized object for a new inline keyboard.", + "rst_description": "A JSON-serialized object for a new `inline keyboard `_.\n", + "name": "reply_markup" + } + ], + "category": "methods" + }, { "anchor": "editmessagereplymarkup", "name": "editMessageReplyMarkup", @@ -8538,7 +8662,7 @@ "description": "Sticker thumbnail in the .WEBP or .JPG format", "html_description": "Optional. Sticker thumbnail in the .WEBP or .JPG format", "rst_description": "*Optional*. Sticker thumbnail in the .WEBP or .JPG format\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -8581,6 +8705,14 @@ "name": "custom_emoji_id", "required": false }, + { + "type": "True", + "description": "True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places", + "html_description": "Optional. True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places", + "rst_description": "*Optional*. :code:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places\n", + "name": "needs_repainting", + "required": false + }, { "type": "Integer", "description": "File size in bytes", @@ -8652,7 +8784,7 @@ "description": "Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", "html_description": "Optional. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", "rst_description": "*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format\n", - "name": "thumb", + "name": "thumbnail", "required": false } ], @@ -8700,6 +8832,48 @@ ], "category": "types" }, + { + "anchor": "inputsticker", + "name": "InputSticker", + "description": "This object describes a sticker to be added to a sticker set.", + "html_description": "

This object describes a sticker to be added to a sticker set.

", + "rst_description": "This object describes a sticker to be added to a sticker set.", + "annotations": [ + { + "type": "InputFile or String", + "description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files", + "html_description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files »", + "rst_description": "The added sticker. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. :ref:`More information on Sending Files » `\n", + "name": "sticker", + "required": true + }, + { + "type": "Array of String", + "description": "List of 1-20 emoji associated with the sticker", + "html_description": "List of 1-20 emoji associated with the sticker", + "rst_description": "List of 1-20 emoji associated with the sticker\n", + "name": "emoji_list", + "required": true + }, + { + "type": "MaskPosition", + "description": "Position where the mask should be placed on faces. For 'mask' stickers only.", + "html_description": "Optional. Position where the mask should be placed on faces. For “mask” stickers only.", + "rst_description": "*Optional*. Position where the mask should be placed on faces. For 'mask' stickers only.\n", + "name": "mask_position", + "required": false + }, + { + "type": "Array of String", + "description": "List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.", + "html_description": "Optional. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For “regular” and “custom_emoji” stickers only.", + "rst_description": "*Optional*. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.\n", + "name": "keywords", + "required": false + } + ], + "category": "types" + }, { "anchor": "sendsticker", "name": "sendSticker", @@ -8726,11 +8900,19 @@ { "type": "InputFile or String", "required": true, - "description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", + "description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. More information on Sending Files. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.", + "html_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. More information on Sending Files ». Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.", + "rst_description": "Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.\n", "name": "sticker" }, + { + "type": "String", + "required": false, + "description": "Emoji associated with the sticker; only for just uploaded stickers", + "html_description": "Emoji associated with the sticker; only for just uploaded stickers", + "rst_description": "Emoji associated with the sticker; only for just uploaded stickers\n", + "name": "emoji" + }, { "type": "Boolean", "required": false, @@ -8813,9 +8995,9 @@ { "anchor": "uploadstickerfile", "name": "uploadStickerFile", - "description": "Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.", - "html_description": "

Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success.

", - "rst_description": "Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", + "description": "Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.", + "html_description": "

Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success.

", + "rst_description": "Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success.", "annotations": [ { "type": "Integer", @@ -8828,10 +9010,18 @@ { "type": "InputFile", "required": true, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" + "description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files", + "html_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See https://core.telegram.org/stickers for technical requirements. More information on Sending Files »", + "rst_description": "A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `\n", + "name": "sticker" + }, + { + "type": "String", + "required": true, + "description": "Format of the sticker, must be one of 'static', 'animated', 'video'", + "html_description": "Format of the sticker, must be one of “static”, “animated”, “video”", + "rst_description": "Format of the sticker, must be one of 'static', 'animated', 'video'\n", + "name": "sticker_format" } ], "category": "methods" @@ -8839,9 +9029,9 @@ { "anchor": "createnewstickerset", "name": "createNewStickerSet", - "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.", - "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Returns True on success.

", - "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success.", + "description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.", + "html_description": "

Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns True on success.

", + "rst_description": "Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -8868,52 +9058,36 @@ "name": "title" }, { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", - "required": false, - "description": "Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created.", - "html_description": "Type of stickers in the set, pass “regular” or “mask”. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created.", - "rst_description": "Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created.\n", - "name": "sticker_type" + "type": "Array of InputSticker", + "required": true, + "description": "A JSON-serialized list of 1-50 initial stickers to be added to the sticker set", + "html_description": "A JSON-serialized list of 1-50 initial stickers to be added to the sticker set", + "rst_description": "A JSON-serialized list of 1-50 initial stickers to be added to the sticker set\n", + "name": "stickers" }, { "type": "String", "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" + "description": "Format of stickers in the set, must be one of 'static', 'animated', 'video'", + "html_description": "Format of stickers in the set, must be one of “static”, “animated”, “video”", + "rst_description": "Format of stickers in the set, must be one of 'static', 'animated', 'video'\n", + "name": "sticker_format" }, { - "type": "MaskPosition", + "type": "String", "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" + "description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.", + "html_description": "Type of stickers in the set, pass “regular”, “mask”, or “custom_emoji”. By default, a regular sticker set is created.", + "rst_description": "Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.\n", + "name": "sticker_type" + }, + { + "type": "Boolean", + "required": false, + "description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "html_description": "Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only", + "rst_description": "Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only\n", + "name": "needs_repainting" } ], "category": "methods" @@ -8921,9 +9095,9 @@ { "anchor": "addstickertoset", "name": "addStickerToSet", - "description": "Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", - "html_description": "

Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", - "rst_description": "Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", + "description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.", + "html_description": "

Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.

", + "rst_description": "Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success.", "annotations": [ { "type": "Integer", @@ -8942,44 +9116,12 @@ "name": "name" }, { - "type": "InputFile or String", - "required": false, - "description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files", - "html_description": "PNG image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »", - "rst_description": "**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `\n", - "name": "png_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "html_description": "TGS animation with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements", - "rst_description": "**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements\n", - "name": "tgs_sticker" - }, - { - "type": "InputFile", - "required": false, - "description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "html_description": "WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements", - "rst_description": "**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements\n", - "name": "webm_sticker" - }, - { - "type": "String", + "type": "InputSticker", "required": true, - "description": "One or more emoji corresponding to the sticker", - "html_description": "One or more emoji corresponding to the sticker", - "rst_description": "One or more emoji corresponding to the sticker\n", - "name": "emojis" - }, - { - "type": "MaskPosition", - "required": false, - "description": "A JSON-serialized object for position where the mask should be placed on faces", - "html_description": "A JSON-serialized object for position where the mask should be placed on faces", - "rst_description": "A JSON-serialized object for position where the mask should be placed on faces\n", - "name": "mask_position" + "description": "A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.", + "html_description": "A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.", + "rst_description": "A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.\n", + "name": "sticker" } ], "category": "methods" @@ -9029,11 +9171,115 @@ "category": "methods" }, { - "anchor": "setstickersetthumb", - "name": "setStickerSetThumb", - "description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.", - "html_description": "

Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns True on success.

", - "rst_description": "Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns :code:`True` on success.", + "anchor": "setstickeremojilist", + "name": "setStickerEmojiList", + "description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", + "html_description": "

Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", + "rst_description": "Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "Array of String", + "required": true, + "description": "A JSON-serialized list of 1-20 emoji associated with the sticker", + "html_description": "A JSON-serialized list of 1-20 emoji associated with the sticker", + "rst_description": "A JSON-serialized list of 1-20 emoji associated with the sticker\n", + "name": "emoji_list" + } + ], + "category": "methods" + }, + { + "anchor": "setstickerkeywords", + "name": "setStickerKeywords", + "description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.", + "html_description": "

Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success.

", + "rst_description": "Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "Array of String", + "required": false, + "description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", + "html_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters", + "rst_description": "A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters\n", + "name": "keywords" + } + ], + "category": "methods" + }, + { + "anchor": "setstickermaskposition", + "name": "setStickerMaskPosition", + "description": "Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.", + "html_description": "

Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns True on success.

", + "rst_description": "Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "File identifier of the sticker", + "html_description": "File identifier of the sticker", + "rst_description": "File identifier of the sticker\n", + "name": "sticker" + }, + { + "type": "MaskPosition", + "required": false, + "description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", + "html_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.", + "rst_description": "A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.\n", + "name": "mask_position" + } + ], + "category": "methods" + }, + { + "anchor": "setstickersettitle", + "name": "setStickerSetTitle", + "description": "Use this method to set the title of a created sticker set. Returns True on success.", + "html_description": "

Use this method to set the title of a created sticker set. Returns True on success.

", + "rst_description": "Use this method to set the title of a created sticker set. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + }, + { + "type": "String", + "required": true, + "description": "Sticker set title, 1-64 characters", + "html_description": "Sticker set title, 1-64 characters", + "rst_description": "Sticker set title, 1-64 characters\n", + "name": "title" + } + ], + "category": "methods" + }, + { + "anchor": "setstickersetthumbnail", + "name": "setStickerSetThumbnail", + "description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.", + "html_description": "

Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns True on success.

", + "rst_description": "Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success.", "annotations": [ { "type": "String", @@ -9054,10 +9300,54 @@ { "type": "InputFile or String", "required": false, - "description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "html_description": "A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL.", - "rst_description": "A **PNG** image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a **TGS** animation with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements, or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated sticker set thumbnails can't be uploaded via HTTP URL.\n", - "name": "thumb" + "description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", + "html_description": "A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.", + "rst_description": "A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.\n", + "name": "thumbnail" + } + ], + "category": "methods" + }, + { + "anchor": "setcustomemojistickersetthumbnail", + "name": "setCustomEmojiStickerSetThumbnail", + "description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.", + "html_description": "

Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success.

", + "rst_description": "Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" + }, + { + "type": "String", + "required": false, + "description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", + "html_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.", + "rst_description": "Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.\n", + "name": "custom_emoji_id" + } + ], + "category": "methods" + }, + { + "anchor": "deletestickerset", + "name": "deleteStickerSet", + "description": "Use this method to delete a sticker set that was created by the bot. Returns True on success.", + "html_description": "

Use this method to delete a sticker set that was created by the bot. Returns True on success.

", + "rst_description": "Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success.", + "annotations": [ + { + "type": "String", + "required": true, + "description": "Sticker set name", + "html_description": "Sticker set name", + "rst_description": "Sticker set name\n", + "name": "name" } ], "category": "methods" @@ -9278,7 +9568,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -9286,7 +9576,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -9294,7 +9584,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], @@ -9336,7 +9626,7 @@ "description": "URL of the thumbnail for the photo", "html_description": "URL of the thumbnail for the photo", "rst_description": "URL of the thumbnail for the photo\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -9474,7 +9764,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -9482,7 +9772,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { @@ -9596,7 +9886,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -9604,7 +9894,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { @@ -9702,7 +9992,7 @@ "description": "URL of the thumbnail (JPEG only) for the video", "html_description": "URL of the thumbnail (JPEG only) for the video", "rst_description": "URL of the thumbnail (JPEG only) for the video\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -10076,7 +10366,7 @@ "description": "URL of the thumbnail (JPEG only) for the file", "html_description": "Optional. URL of the thumbnail (JPEG only) for the file", "rst_description": "*Optional*. URL of the thumbnail (JPEG only) for the file\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -10084,7 +10374,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -10092,7 +10382,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], @@ -10198,7 +10488,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -10206,7 +10496,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -10214,7 +10504,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], @@ -10328,7 +10618,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -10336,7 +10626,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -10344,7 +10634,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], @@ -10426,7 +10716,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -10434,7 +10724,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -10442,7 +10732,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], diff --git a/.butcher/types/Animation/entity.json b/.butcher/types/Animation/entity.json index 2de45c1b..db471f53 100644 --- a/.butcher/types/Animation/entity.json +++ b/.butcher/types/Animation/entity.json @@ -58,7 +58,7 @@ "description": "Animation thumbnail as defined by sender", "html_description": "Optional. Animation thumbnail as defined by sender", "rst_description": "*Optional*. Animation thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/.butcher/types/Audio/entity.json b/.butcher/types/Audio/entity.json index 4b94b3a1..c65b9118 100644 --- a/.butcher/types/Audio/entity.json +++ b/.butcher/types/Audio/entity.json @@ -82,7 +82,7 @@ "description": "Thumbnail of the album cover to which the music file belongs", "html_description": "Optional. Thumbnail of the album cover to which the music file belongs", "rst_description": "*Optional*. Thumbnail of the album cover to which the music file belongs\n", - "name": "thumb", + "name": "thumbnail", "required": false } ], diff --git a/.butcher/types/BotDescription/entity.json b/.butcher/types/BotDescription/entity.json new file mode 100644 index 00000000..6d47a69d --- /dev/null +++ b/.butcher/types/BotDescription/entity.json @@ -0,0 +1,27 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Available types", + "anchor": "available-types" + }, + "object": { + "anchor": "botdescription", + "name": "BotDescription", + "description": "This object represents the bot's description.", + "html_description": "

This object represents the bot's description.

", + "rst_description": "This object represents the bot's description.", + "annotations": [ + { + "type": "String", + "description": "The bot's description", + "html_description": "The bot's description", + "rst_description": "The bot's description\n", + "name": "description", + "required": true + } + ], + "category": "types" + } +} diff --git a/.butcher/types/BotShortDescription/entity.json b/.butcher/types/BotShortDescription/entity.json new file mode 100644 index 00000000..dcd3e80c --- /dev/null +++ b/.butcher/types/BotShortDescription/entity.json @@ -0,0 +1,27 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Available types", + "anchor": "available-types" + }, + "object": { + "anchor": "botshortdescription", + "name": "BotShortDescription", + "description": "This object represents the bot's short description.", + "html_description": "

This object represents the bot's short description.

", + "rst_description": "This object represents the bot's short description.", + "annotations": [ + { + "type": "String", + "description": "The bot's short description", + "html_description": "The bot's short description", + "rst_description": "The bot's short description\n", + "name": "short_description", + "required": true + } + ], + "category": "types" + } +} diff --git a/.butcher/types/Document/entity.json b/.butcher/types/Document/entity.json index 65e0386d..036df2c4 100644 --- a/.butcher/types/Document/entity.json +++ b/.butcher/types/Document/entity.json @@ -34,7 +34,7 @@ "description": "Document thumbnail as defined by sender", "html_description": "Optional. Document thumbnail as defined by sender", "rst_description": "*Optional*. Document thumbnail as defined by sender\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/.butcher/types/InlineQueryResultArticle/entity.json b/.butcher/types/InlineQueryResultArticle/entity.json index 93c397e7..74b635ff 100644 --- a/.butcher/types/InlineQueryResultArticle/entity.json +++ b/.butcher/types/InlineQueryResultArticle/entity.json @@ -82,7 +82,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -90,7 +90,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -98,7 +98,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], diff --git a/.butcher/types/InlineQueryResultContact/entity.json b/.butcher/types/InlineQueryResultContact/entity.json index 3b9b65fa..2445e5d7 100644 --- a/.butcher/types/InlineQueryResultContact/entity.json +++ b/.butcher/types/InlineQueryResultContact/entity.json @@ -82,7 +82,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -90,7 +90,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -98,7 +98,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], diff --git a/.butcher/types/InlineQueryResultDocument/entity.json b/.butcher/types/InlineQueryResultDocument/entity.json index 76a1bb70..1eda8583 100644 --- a/.butcher/types/InlineQueryResultDocument/entity.json +++ b/.butcher/types/InlineQueryResultDocument/entity.json @@ -106,7 +106,7 @@ "description": "URL of the thumbnail (JPEG only) for the file", "html_description": "Optional. URL of the thumbnail (JPEG only) for the file", "rst_description": "*Optional*. URL of the thumbnail (JPEG only) for the file\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -114,7 +114,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -122,7 +122,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], diff --git a/.butcher/types/InlineQueryResultGif/entity.json b/.butcher/types/InlineQueryResultGif/entity.json index 89f56afc..b6ab8d8f 100644 --- a/.butcher/types/InlineQueryResultGif/entity.json +++ b/.butcher/types/InlineQueryResultGif/entity.json @@ -66,7 +66,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -74,7 +74,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { diff --git a/.butcher/types/InlineQueryResultLocation/entity.json b/.butcher/types/InlineQueryResultLocation/entity.json index 7f14565f..c4cdf8e7 100644 --- a/.butcher/types/InlineQueryResultLocation/entity.json +++ b/.butcher/types/InlineQueryResultLocation/entity.json @@ -106,7 +106,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -114,7 +114,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -122,7 +122,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], diff --git a/.butcher/types/InlineQueryResultMpeg4Gif/entity.json b/.butcher/types/InlineQueryResultMpeg4Gif/entity.json index 27ebd1e3..69916a5b 100644 --- a/.butcher/types/InlineQueryResultMpeg4Gif/entity.json +++ b/.butcher/types/InlineQueryResultMpeg4Gif/entity.json @@ -66,7 +66,7 @@ "description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "html_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result", "rst_description": "URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { @@ -74,7 +74,7 @@ "description": "MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'", "html_description": "Optional. MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg”", "rst_description": "*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'\n", - "name": "thumb_mime_type", + "name": "thumbnail_mime_type", "required": false }, { diff --git a/.butcher/types/InlineQueryResultPhoto/entity.json b/.butcher/types/InlineQueryResultPhoto/entity.json index 9aa12a16..a216aacf 100644 --- a/.butcher/types/InlineQueryResultPhoto/entity.json +++ b/.butcher/types/InlineQueryResultPhoto/entity.json @@ -42,7 +42,7 @@ "description": "URL of the thumbnail for the photo", "html_description": "URL of the thumbnail for the photo", "rst_description": "URL of the thumbnail for the photo\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { diff --git a/.butcher/types/InlineQueryResultVenue/entity.json b/.butcher/types/InlineQueryResultVenue/entity.json index af6c2d22..3bf6bebe 100644 --- a/.butcher/types/InlineQueryResultVenue/entity.json +++ b/.butcher/types/InlineQueryResultVenue/entity.json @@ -114,7 +114,7 @@ "description": "Url of the thumbnail for the result", "html_description": "Optional. Url of the thumbnail for the result", "rst_description": "*Optional*. Url of the thumbnail for the result\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": false }, { @@ -122,7 +122,7 @@ "description": "Thumbnail width", "html_description": "Optional. Thumbnail width", "rst_description": "*Optional*. Thumbnail width\n", - "name": "thumb_width", + "name": "thumbnail_width", "required": false }, { @@ -130,7 +130,7 @@ "description": "Thumbnail height", "html_description": "Optional. Thumbnail height", "rst_description": "*Optional*. Thumbnail height\n", - "name": "thumb_height", + "name": "thumbnail_height", "required": false } ], diff --git a/.butcher/types/InlineQueryResultVideo/entity.json b/.butcher/types/InlineQueryResultVideo/entity.json index 784a8728..abc82746 100644 --- a/.butcher/types/InlineQueryResultVideo/entity.json +++ b/.butcher/types/InlineQueryResultVideo/entity.json @@ -50,7 +50,7 @@ "description": "URL of the thumbnail (JPEG only) for the video", "html_description": "URL of the thumbnail (JPEG only) for the video", "rst_description": "URL of the thumbnail (JPEG only) for the video\n", - "name": "thumb_url", + "name": "thumbnail_url", "required": true }, { diff --git a/.butcher/types/InputMediaAnimation/entity.json b/.butcher/types/InputMediaAnimation/entity.json index 80dd5629..4d694d1b 100644 --- a/.butcher/types/InputMediaAnimation/entity.json +++ b/.butcher/types/InputMediaAnimation/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/.butcher/types/InputMediaAudio/entity.json b/.butcher/types/InputMediaAudio/entity.json index 43963950..e16a0a7d 100644 --- a/.butcher/types/InputMediaAudio/entity.json +++ b/.butcher/types/InputMediaAudio/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/.butcher/types/InputMediaDocument/entity.json b/.butcher/types/InputMediaDocument/entity.json index cd51dea9..97bcbcd3 100644 --- a/.butcher/types/InputMediaDocument/entity.json +++ b/.butcher/types/InputMediaDocument/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/.butcher/types/InputMediaVideo/entity.json b/.butcher/types/InputMediaVideo/entity.json index 97ceb6b7..1f5e6487 100644 --- a/.butcher/types/InputMediaVideo/entity.json +++ b/.butcher/types/InputMediaVideo/entity.json @@ -34,7 +34,7 @@ "description": "Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . More information on Sending Files", "html_description": "Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »", "rst_description": "*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/.butcher/types/InputSticker/entity.json b/.butcher/types/InputSticker/entity.json new file mode 100644 index 00000000..819f81f9 --- /dev/null +++ b/.butcher/types/InputSticker/entity.json @@ -0,0 +1,51 @@ +{ + "meta": { + "deprecated": false + }, + "group": { + "title": "Stickers", + "anchor": "stickers" + }, + "object": { + "anchor": "inputsticker", + "name": "InputSticker", + "description": "This object describes a sticker to be added to a sticker set.", + "html_description": "

This object describes a sticker to be added to a sticker set.

", + "rst_description": "This object describes a sticker to be added to a sticker set.", + "annotations": [ + { + "type": "InputFile or String", + "description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files", + "html_description": "The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. More information on Sending Files »", + "rst_description": "The added sticker. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. :ref:`More information on Sending Files » `\n", + "name": "sticker", + "required": true + }, + { + "type": "Array of String", + "description": "List of 1-20 emoji associated with the sticker", + "html_description": "List of 1-20 emoji associated with the sticker", + "rst_description": "List of 1-20 emoji associated with the sticker\n", + "name": "emoji_list", + "required": true + }, + { + "type": "MaskPosition", + "description": "Position where the mask should be placed on faces. For 'mask' stickers only.", + "html_description": "Optional. Position where the mask should be placed on faces. For “mask” stickers only.", + "rst_description": "*Optional*. Position where the mask should be placed on faces. For 'mask' stickers only.\n", + "name": "mask_position", + "required": false + }, + { + "type": "Array of String", + "description": "List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.", + "html_description": "Optional. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For “regular” and “custom_emoji” stickers only.", + "rst_description": "*Optional*. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.\n", + "name": "keywords", + "required": false + } + ], + "category": "types" + } +} diff --git a/.butcher/types/Sticker/entity.json b/.butcher/types/Sticker/entity.json index 8d0f1d88..cd3d092b 100644 --- a/.butcher/types/Sticker/entity.json +++ b/.butcher/types/Sticker/entity.json @@ -74,7 +74,7 @@ "description": "Sticker thumbnail in the .WEBP or .JPG format", "html_description": "Optional. Sticker thumbnail in the .WEBP or .JPG format", "rst_description": "*Optional*. Sticker thumbnail in the .WEBP or .JPG format\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { @@ -117,6 +117,14 @@ "name": "custom_emoji_id", "required": false }, + { + "type": "True", + "description": "True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places", + "html_description": "Optional. True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places", + "rst_description": "*Optional*. :code:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places\n", + "name": "needs_repainting", + "required": false + }, { "type": "Integer", "description": "File size in bytes", diff --git a/.butcher/types/StickerSet/entity.json b/.butcher/types/StickerSet/entity.json index 4e370e93..b766cd7d 100644 --- a/.butcher/types/StickerSet/entity.json +++ b/.butcher/types/StickerSet/entity.json @@ -66,7 +66,7 @@ "description": "Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", "html_description": "Optional. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format", "rst_description": "*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format\n", - "name": "thumb", + "name": "thumbnail", "required": false } ], diff --git a/.butcher/types/Video/entity.json b/.butcher/types/Video/entity.json index 65c5594f..52bb1439 100644 --- a/.butcher/types/Video/entity.json +++ b/.butcher/types/Video/entity.json @@ -58,7 +58,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/.butcher/types/VideoNote/entity.json b/.butcher/types/VideoNote/entity.json index 85dbf566..a27d9a7d 100644 --- a/.butcher/types/VideoNote/entity.json +++ b/.butcher/types/VideoNote/entity.json @@ -50,7 +50,7 @@ "description": "Video thumbnail", "html_description": "Optional. Video thumbnail", "rst_description": "*Optional*. Video thumbnail\n", - "name": "thumb", + "name": "thumbnail", "required": false }, { diff --git a/CHANGES/1139.misc.rst b/CHANGES/1139.misc.rst new file mode 100644 index 00000000..432607e0 --- /dev/null +++ b/CHANGES/1139.misc.rst @@ -0,0 +1,7 @@ +Added full support of `Bot API 6.6 `_ + +.. danger:: + + Note that this issue has breaking changes described in in the Bot API changelog, + this changes is not breaking in the API but breaking inside aiogram because + Beta stage is not finished. diff --git a/README.rst b/README.rst index bf5a7d11..3c2297a8 100644 --- a/README.rst +++ b/README.rst @@ -63,7 +63,7 @@ Features - Asynchronous (`asyncio docs `_, :pep:`492`) - Has type hints (:pep:`484`) and can be used with `mypy `_ - Supports `PyPy `_ -- Supports `Telegram Bot API 6.5 `_ and gets fast updates to the latest versions of the Bot API +- Supports `Telegram Bot API 6.6 `_ and gets fast updates to the latest versions of the Bot API - Telegram Bot API integration code was `autogenerated `_ and can be easily re-generated when API gets updated - Updates router (Blueprints) - Has Finite State Machine diff --git a/aiogram/__init__.py b/aiogram/__init__.py index a703578e..4ed355fc 100644 --- a/aiogram/__init__.py +++ b/aiogram/__init__.py @@ -37,5 +37,5 @@ __all__ = ( "flags", ) -__version__ = "3.0.0b7" -__api_version__ = "6.5" +__version__ = "3.0.0b8" +__api_version__ = "6.6" diff --git a/aiogram/client/bot.py b/aiogram/client/bot.py index d9ddc07a..91dd91fa 100644 --- a/aiogram/client/bot.py +++ b/aiogram/client/bot.py @@ -46,6 +46,7 @@ from ..methods import ( DeleteMessage, DeleteMyCommands, DeleteStickerFromSet, + DeleteStickerSet, DeleteWebhook, EditChatInviteLink, EditForumTopic, @@ -69,6 +70,8 @@ from ..methods import ( GetMe, GetMyCommands, GetMyDefaultAdministratorRights, + GetMyDescription, + GetMyShortDescription, GetStickerSet, GetUpdates, GetUserProfilePhotos, @@ -107,12 +110,19 @@ from ..methods import ( SetChatPhoto, SetChatStickerSet, SetChatTitle, + SetCustomEmojiStickerSetThumbnail, SetGameScore, SetMyCommands, SetMyDefaultAdministratorRights, + SetMyDescription, + SetMyShortDescription, SetPassportDataErrors, + SetStickerEmojiList, + SetStickerKeywords, + SetStickerMaskPosition, SetStickerPositionInSet, - SetStickerSetThumb, + SetStickerSetThumbnail, + SetStickerSetTitle, SetWebhook, StopMessageLiveLocation, StopPoll, @@ -129,6 +139,8 @@ from ..types import ( UNSET, BotCommand, BotCommandScope, + BotDescription, + BotShortDescription, Chat, ChatAdministratorRights, ChatInviteLink, @@ -152,6 +164,7 @@ from ..types import ( InputMediaDocument, InputMediaPhoto, InputMediaVideo, + InputSticker, LabeledPrice, MaskPosition, MenuButtonCommands, @@ -396,25 +409,17 @@ class Bot(ContextInstanceMixin["Bot"]): self, user_id: int, name: str, - emojis: str, - png_sticker: Optional[Union[InputFile, str]] = None, - tgs_sticker: Optional[InputFile] = None, - webm_sticker: Optional[InputFile] = None, - mask_position: Optional[MaskPosition] = None, + sticker: InputSticker, request_timeout: Optional[int] = None, ) -> bool: """ - Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. + Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#addstickertoset :param user_id: User identifier of sticker set owner :param name: Sticker set name - :param emojis: One or more emoji corresponding to the sticker - :param png_sticker: **PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param tgs_sticker: **TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements - :param webm_sticker: **WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements - :param mask_position: A JSON-serialized object for position where the mask should be placed on faces + :param sticker: A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed. :param request_timeout: Request timeout :return: Returns :code:`True` on success. """ @@ -422,11 +427,7 @@ class Bot(ContextInstanceMixin["Bot"]): call = AddStickerToSet( user_id=user_id, name=name, - emojis=emojis, - png_sticker=png_sticker, - tgs_sticker=tgs_sticker, - webm_sticker=webm_sticker, - mask_position=mask_position, + sticker=sticker, ) return await self(call, request_timeout=request_timeout) @@ -894,28 +895,24 @@ class Bot(ContextInstanceMixin["Bot"]): user_id: int, name: str, title: str, - emojis: str, - png_sticker: Optional[Union[InputFile, str]] = None, - tgs_sticker: Optional[InputFile] = None, - webm_sticker: Optional[InputFile] = None, + stickers: List[InputSticker], + sticker_format: str, sticker_type: Optional[str] = None, - mask_position: Optional[MaskPosition] = None, + needs_repainting: Optional[bool] = None, request_timeout: Optional[int] = None, ) -> bool: """ - Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success. + Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#createnewstickerset :param user_id: User identifier of created sticker set owner :param name: Short name of sticker set, to be used in :code:`t.me/addstickers/` URLs (e.g., *animals*). Can contain only English letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in :code:`"_by_"`. :code:`` is case insensitive. 1-64 characters. :param title: Sticker set title, 1-64 characters - :param emojis: One or more emoji corresponding to the sticker - :param png_sticker: **PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param tgs_sticker: **TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements - :param webm_sticker: **WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements - :param sticker_type: Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created. - :param mask_position: A JSON-serialized object for position where the mask should be placed on faces + :param stickers: A JSON-serialized list of 1-50 initial stickers to be added to the sticker set + :param sticker_format: Format of stickers in the set, must be one of 'static', 'animated', 'video' + :param sticker_type: Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created. + :param needs_repainting: Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only :param request_timeout: Request timeout :return: Returns :code:`True` on success. """ @@ -924,12 +921,10 @@ class Bot(ContextInstanceMixin["Bot"]): user_id=user_id, name=name, title=title, - emojis=emojis, - png_sticker=png_sticker, - tgs_sticker=tgs_sticker, - webm_sticker=webm_sticker, + stickers=stickers, + sticker_format=sticker_format, sticker_type=sticker_type, - mask_position=mask_position, + needs_repainting=needs_repainting, ) return await self(call, request_timeout=request_timeout) @@ -1998,7 +1993,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2023,7 +2018,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param duration: Duration of sent animation in seconds :param width: Animation width :param height: Animation height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the animation 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* @@ -2044,7 +2039,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2068,7 +2063,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2093,7 +2088,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param duration: Duration of the audio in seconds :param performer: Performer :param title: Track name - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :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_to_message_id: If the message is a reply, ID of the original message @@ -2113,7 +2108,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration=duration, performer=performer, title=title, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, @@ -2252,7 +2247,7 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id: Union[int, str], document: Union[InputFile, str], message_thread_id: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2274,7 +2269,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the document 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* @@ -2292,7 +2287,7 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id=chat_id, document=document, message_thread_id=message_thread_id, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2731,6 +2726,7 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id: Union[int, str], sticker: Union[InputFile, str], message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2746,8 +2742,9 @@ class Bot(ContextInstanceMixin["Bot"]): Source: https://core.telegram.org/bots/api#sendsticker :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) - :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL. :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji associated with the sticker; only for just uploaded stickers :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_to_message_id: If the message is a reply, ID of the original message @@ -2761,6 +2758,7 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id=chat_id, sticker=sticker, message_thread_id=message_thread_id, + emoji=emoji, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, @@ -2841,7 +2839,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2867,7 +2865,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param duration: Duration of sent video in seconds :param width: Video width :param height: Video height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the video 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* @@ -2889,7 +2887,7 @@ class Bot(ContextInstanceMixin["Bot"]): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2910,7 +2908,7 @@ class Bot(ContextInstanceMixin["Bot"]): message_thread_id: Optional[int] = None, duration: Optional[int] = None, length: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2930,7 +2928,7 @@ class Bot(ContextInstanceMixin["Bot"]): :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only :param duration: Duration of sent video in seconds :param length: Video width and height, i.e. diameter of the video message - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :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_to_message_id: If the message is a reply, ID of the original message @@ -2946,7 +2944,7 @@ class Bot(ContextInstanceMixin["Bot"]): message_thread_id=message_thread_id, duration=duration, length=length, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, @@ -3250,7 +3248,7 @@ class Bot(ContextInstanceMixin["Bot"]): request_timeout: Optional[int] = None, ) -> bool: """ - Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success. + Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights @@ -3313,32 +3311,6 @@ class Bot(ContextInstanceMixin["Bot"]): ) return await self(call, request_timeout=request_timeout) - async def set_sticker_set_thumb( - self, - name: str, - user_id: int, - thumb: Optional[Union[InputFile, str]] = None, - request_timeout: Optional[int] = None, - ) -> bool: - """ - Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns :code:`True` on success. - - Source: https://core.telegram.org/bots/api#setstickersetthumb - - :param name: Sticker set name - :param user_id: User identifier of the sticker set owner - :param thumb: A **PNG** image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a **TGS** animation with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements, or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated sticker set thumbnails can't be uploaded via HTTP URL. - :param request_timeout: Request timeout - :return: Returns :code:`True` on success. - """ - - call = SetStickerSetThumb( - name=name, - user_id=user_id, - thumb=thumb, - ) - return await self(call, request_timeout=request_timeout) - async def set_webhook( self, url: str, @@ -3560,23 +3532,26 @@ class Bot(ContextInstanceMixin["Bot"]): async def upload_sticker_file( self, user_id: int, - png_sticker: InputFile, + sticker: InputFile, + sticker_format: str, request_timeout: Optional[int] = None, ) -> File: """ - Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. + Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. Source: https://core.telegram.org/bots/api#uploadstickerfile :param user_id: User identifier of sticker file owner - :param png_sticker: **PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » ` + :param sticker: A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » ` + :param sticker_format: Format of the sticker, must be one of 'static', 'animated', 'video' :param request_timeout: Request timeout :return: Returns the uploaded :class:`aiogram.types.file.File` on success. """ call = UploadStickerFile( user_id=user_id, - png_sticker=png_sticker, + sticker=sticker, + sticker_format=sticker_format, ) return await self(call, request_timeout=request_timeout) @@ -3682,3 +3657,250 @@ class Bot(ContextInstanceMixin["Bot"]): chat_id=chat_id, ) return await self(call, request_timeout=request_timeout) + + async def delete_sticker_set( + self, + name: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerset + + :param name: Sticker set name + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteStickerSet( + name=name, + ) + return await self(call, request_timeout=request_timeout) + + async def get_my_description( + self, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> BotDescription: + """ + Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success. + + Source: https://core.telegram.org/bots/api#getmydescription + + :param language_code: A two-letter ISO 639-1 language code or an empty string + :param request_timeout: Request timeout + :return: Returns :class:`aiogram.types.bot_description.BotDescription` on success. + """ + + call = GetMyDescription( + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def get_my_short_description( + self, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> BotShortDescription: + """ + Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success. + + Source: https://core.telegram.org/bots/api#getmyshortdescription + + :param language_code: A two-letter ISO 639-1 language code or an empty string + :param request_timeout: Request timeout + :return: Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success. + """ + + call = GetMyShortDescription( + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_custom_emoji_sticker_set_thumbnail( + self, + name: str, + custom_emoji_id: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setcustomemojistickersetthumbnail + + :param name: Sticker set name + :param custom_emoji_id: Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetCustomEmojiStickerSetThumbnail( + name=name, + custom_emoji_id=custom_emoji_id, + ) + return await self(call, request_timeout=request_timeout) + + async def set_my_description( + self, + description: Optional[str] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmydescription + + :param description: New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language. + :param language_code: A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMyDescription( + description=description, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_my_short_description( + self, + short_description: Optional[str] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmyshortdescription + + :param short_description: New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language. + :param language_code: A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMyShortDescription( + short_description=short_description, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_emoji_list( + self, + sticker: str, + emoji_list: List[str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickeremojilist + + :param sticker: File identifier of the sticker + :param emoji_list: A JSON-serialized list of 1-20 emoji associated with the sticker + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerEmojiList( + sticker=sticker, + emoji_list=emoji_list, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_keywords( + self, + sticker: str, + keywords: Optional[List[str]] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerkeywords + + :param sticker: File identifier of the sticker + :param keywords: A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerKeywords( + sticker=sticker, + keywords=keywords, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_mask_position( + self, + sticker: str, + mask_position: Optional[MaskPosition] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickermaskposition + + :param sticker: File identifier of the sticker + :param mask_position: A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerMaskPosition( + sticker=sticker, + mask_position=mask_position, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_set_thumbnail( + self, + name: str, + user_id: int, + thumbnail: Optional[Union[InputFile, str]] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersetthumbnail + + :param name: Sticker set name + :param user_id: User identifier of the sticker set owner + :param thumbnail: A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerSetThumbnail( + name=name, + user_id=user_id, + thumbnail=thumbnail, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_set_title( + self, + name: str, + title: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set the title of a created sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersettitle + + :param name: Sticker set name + :param title: Sticker set title, 1-64 characters + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerSetTitle( + name=name, + title=title, + ) + return await self(call, request_timeout=request_timeout) diff --git a/aiogram/client/session/aiohttp.py b/aiogram/client/session/aiohttp.py index 4d9dff06..3f35a0e0 100644 --- a/aiogram/client/session/aiohttp.py +++ b/aiogram/client/session/aiohttp.py @@ -23,6 +23,7 @@ from aiogram.methods import Request, TelegramMethod from ...exceptions import TelegramNetworkError from ...methods.base import TelegramType +from ...types import InputFile from .base import UNSET, BaseSession if TYPE_CHECKING: diff --git a/aiogram/enums/__init__.py b/aiogram/enums/__init__.py index a744ba55..73422378 100644 --- a/aiogram/enums/__init__.py +++ b/aiogram/enums/__init__.py @@ -11,6 +11,7 @@ from .menu_button_type import MenuButtonType from .message_entity_type import MessageEntityType from .parse_mode import ParseMode from .poll_type import PollType +from .sticker_format import StickerFormat from .sticker_type import StickerType from .topic_icon_color import TopicIconColor from .update_type import UpdateType @@ -29,6 +30,7 @@ __all__ = ( "MessageEntityType", "ParseMode", "PollType", + "StickerFormat", "StickerType", "TopicIconColor", "UpdateType", diff --git a/aiogram/enums/inline_query_result_type.py b/aiogram/enums/inline_query_result_type.py index fa063fcb..771dc498 100644 --- a/aiogram/enums/inline_query_result_type.py +++ b/aiogram/enums/inline_query_result_type.py @@ -3,9 +3,9 @@ from enum import Enum class InlineQueryResultType(str, Enum): """ - The part of the face relative to which the mask should be placed. + Type of inline query result - Source: https://core.telegram.org/bots/api#maskposition + Source: https://core.telegram.org/bots/api#inlinequeryresult """ AUDIO = "audio" diff --git a/aiogram/enums/sticker_format.py b/aiogram/enums/sticker_format.py new file mode 100644 index 00000000..6c9441d9 --- /dev/null +++ b/aiogram/enums/sticker_format.py @@ -0,0 +1,13 @@ +from enum import Enum + + +class StickerFormat(str, Enum): + """ + Format of the sticker + + Source: https://core.telegram.org/bots/api#createnewstickerset + """ + + STATIC = "static" + ANIMATED = "animated" + VIDEO = "video" diff --git a/aiogram/filters/command.py b/aiogram/filters/command.py index 13997073..85ff4de6 100644 --- a/aiogram/filters/command.py +++ b/aiogram/filters/command.py @@ -279,8 +279,8 @@ class CommandStart(Command): await self.validate_mention(bot=bot, command=command) command = self.validate_command(command) command = self.validate_deeplink(command=command) - self.do_magic(command=command) - return command + command = self.do_magic(command=command) + return command # noqa: RET504 def validate_deeplink(self, command: CommandObject) -> CommandObject: if not self.deep_link: diff --git a/aiogram/methods/__init__.py b/aiogram/methods/__init__.py index d50e99a0..5bf0edf5 100644 --- a/aiogram/methods/__init__.py +++ b/aiogram/methods/__init__.py @@ -23,6 +23,7 @@ from .delete_forum_topic import DeleteForumTopic from .delete_message import DeleteMessage from .delete_my_commands import DeleteMyCommands from .delete_sticker_from_set import DeleteStickerFromSet +from .delete_sticker_set import DeleteStickerSet from .delete_webhook import DeleteWebhook from .edit_chat_invite_link import EditChatInviteLink from .edit_forum_topic import EditForumTopic @@ -46,6 +47,8 @@ from .get_game_high_scores import GetGameHighScores from .get_me import GetMe from .get_my_commands import GetMyCommands from .get_my_default_administrator_rights import GetMyDefaultAdministratorRights +from .get_my_description import GetMyDescription +from .get_my_short_description import GetMyShortDescription from .get_sticker_set import GetStickerSet from .get_updates import GetUpdates from .get_user_profile_photos import GetUserProfilePhotos @@ -84,12 +87,19 @@ from .set_chat_permissions import SetChatPermissions from .set_chat_photo import SetChatPhoto from .set_chat_sticker_set import SetChatStickerSet from .set_chat_title import SetChatTitle +from .set_custom_emoji_sticker_set_thumbnail import SetCustomEmojiStickerSetThumbnail from .set_game_score import SetGameScore from .set_my_commands import SetMyCommands from .set_my_default_administrator_rights import SetMyDefaultAdministratorRights +from .set_my_description import SetMyDescription +from .set_my_short_description import SetMyShortDescription from .set_passport_data_errors import SetPassportDataErrors +from .set_sticker_emoji_list import SetStickerEmojiList +from .set_sticker_keywords import SetStickerKeywords +from .set_sticker_mask_position import SetStickerMaskPosition from .set_sticker_position_in_set import SetStickerPositionInSet -from .set_sticker_set_thumb import SetStickerSetThumb +from .set_sticker_set_thumbnail import SetStickerSetThumbnail +from .set_sticker_set_title import SetStickerSetTitle from .set_webhook import SetWebhook from .stop_message_live_location import StopMessageLiveLocation from .stop_poll import StopPoll @@ -126,6 +136,7 @@ __all__ = ( "DeleteMessage", "DeleteMyCommands", "DeleteStickerFromSet", + "DeleteStickerSet", "DeleteWebhook", "EditChatInviteLink", "EditForumTopic", @@ -149,6 +160,8 @@ __all__ = ( "GetMe", "GetMyCommands", "GetMyDefaultAdministratorRights", + "GetMyDescription", + "GetMyShortDescription", "GetStickerSet", "GetUpdates", "GetUserProfilePhotos", @@ -189,12 +202,19 @@ __all__ = ( "SetChatPhoto", "SetChatStickerSet", "SetChatTitle", + "SetCustomEmojiStickerSetThumbnail", "SetGameScore", "SetMyCommands", "SetMyDefaultAdministratorRights", + "SetMyDescription", + "SetMyShortDescription", "SetPassportDataErrors", + "SetStickerEmojiList", + "SetStickerKeywords", + "SetStickerMaskPosition", "SetStickerPositionInSet", - "SetStickerSetThumb", + "SetStickerSetThumbnail", + "SetStickerSetTitle", "SetWebhook", "StopMessageLiveLocation", "StopPoll", diff --git a/aiogram/methods/add_sticker_to_set.py b/aiogram/methods/add_sticker_to_set.py index 6fe7b7a1..75b8387a 100644 --- a/aiogram/methods/add_sticker_to_set.py +++ b/aiogram/methods/add_sticker_to_set.py @@ -1,9 +1,9 @@ from __future__ import annotations -from typing import TYPE_CHECKING, Any, Dict, Optional, Union +from typing import TYPE_CHECKING, Any, Dict -from ..types import InputFile, MaskPosition -from .base import Request, TelegramMethod, prepare_file +from ..types import InputFile, InputSticker +from .base import Request, TelegramMethod, prepare_input_sticker if TYPE_CHECKING: from ..client.bot import Bot @@ -11,7 +11,7 @@ if TYPE_CHECKING: class AddStickerToSet(TelegramMethod[bool]): """ - Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. + Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#addstickertoset """ @@ -22,23 +22,13 @@ class AddStickerToSet(TelegramMethod[bool]): """User identifier of sticker set owner""" name: str """Sticker set name""" - emojis: str - """One or more emoji corresponding to the sticker""" - png_sticker: Optional[Union[InputFile, str]] = None - """**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" - tgs_sticker: Optional[InputFile] = None - """**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements""" - webm_sticker: Optional[InputFile] = None - """**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements""" - mask_position: Optional[MaskPosition] = None - """A JSON-serialized object for position where the mask should be placed on faces""" + sticker: InputSticker + """A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.""" def build_request(self, bot: Bot) -> Request: - data: Dict[str, Any] = self.dict(exclude={"png_sticker", "tgs_sticker", "webm_sticker"}) + data: Dict[str, Any] = self.dict() files: Dict[str, InputFile] = {} - prepare_file(data=data, files=files, name="png_sticker", value=self.png_sticker) - prepare_file(data=data, files=files, name="tgs_sticker", value=self.tgs_sticker) - prepare_file(data=data, files=files, name="webm_sticker", value=self.webm_sticker) + prepare_input_sticker(input_sticker=data["sticker"], files=files) return Request(method="addStickerToSet", data=data, files=files) diff --git a/aiogram/methods/base.py b/aiogram/methods/base.py index 699c10c7..8f9db0d4 100644 --- a/aiogram/methods/base.py +++ b/aiogram/methods/base.py @@ -100,10 +100,10 @@ class TelegramMethod(abc.ABC, BaseModel, Generic[TelegramType]): def prepare_file(name: str, value: Any, data: Dict[str, Any], files: Dict[str, Any]) -> None: if not value: return - if name == "thumb": + if name == "thumbnail": tag = secrets.token_urlsafe(10) files[tag] = value - data["thumb"] = f"attach://{tag}" + data["thumbnail"] = f"attach://{tag}" elif isinstance(value, InputFile): files[name] = value else: @@ -122,6 +122,22 @@ def prepare_input_media(data: Dict[str, Any], files: Dict[str, InputFile]) -> No input_media["media"] = f"attach://{tag}" +def prepare_input_sticker(input_sticker: Dict[str, Any], files: Dict[str, InputFile]) -> None: + if ( + "sticker" in input_sticker + and input_sticker["sticker"] + and isinstance(input_sticker["sticker"], InputFile) + ): + tag = secrets.token_urlsafe(10) + files[tag] = input_sticker.pop("sticker") + input_sticker["sticker"] = f"attach://{tag}" + + +def prepare_input_stickers(data: Dict[str, Any], files: Dict[str, InputFile]) -> None: + for input_sticker in data["stickers"]: + prepare_input_sticker(input_sticker, files=files) + + def prepare_media_file(data: Dict[str, Any], files: Dict[str, InputFile]) -> None: if ( data["media"] diff --git a/aiogram/methods/create_new_sticker_set.py b/aiogram/methods/create_new_sticker_set.py index 00ae4052..651c6672 100644 --- a/aiogram/methods/create_new_sticker_set.py +++ b/aiogram/methods/create_new_sticker_set.py @@ -1,9 +1,9 @@ from __future__ import annotations -from typing import TYPE_CHECKING, Any, Dict, Optional, Union +from typing import TYPE_CHECKING, Any, Dict, List, Optional -from ..types import InputFile, MaskPosition -from .base import Request, TelegramMethod, prepare_file +from ..types import InputFile, InputSticker +from .base import Request, TelegramMethod, prepare_input_sticker, prepare_input_stickers if TYPE_CHECKING: from ..client.bot import Bot @@ -11,7 +11,7 @@ if TYPE_CHECKING: class CreateNewStickerSet(TelegramMethod[bool]): """ - Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. You **must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. Returns :code:`True` on success. + Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set thus created. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#createnewstickerset """ @@ -24,25 +24,19 @@ class CreateNewStickerSet(TelegramMethod[bool]): """Short name of sticker set, to be used in :code:`t.me/addstickers/` URLs (e.g., *animals*). Can contain only English letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in :code:`"_by_"`. :code:`` is case insensitive. 1-64 characters.""" title: str """Sticker set title, 1-64 characters""" - emojis: str - """One or more emoji corresponding to the sticker""" - png_sticker: Optional[Union[InputFile, str]] = None - """**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" - tgs_sticker: Optional[InputFile] = None - """**TGS** animation with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for technical requirements""" - webm_sticker: Optional[InputFile] = None - """**WEBM** video with the sticker, uploaded using multipart/form-data. See `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for technical requirements""" + stickers: List[InputSticker] + """A JSON-serialized list of 1-50 initial stickers to be added to the sticker set""" + sticker_format: str + """Format of stickers in the set, must be one of 'static', 'animated', 'video'""" sticker_type: Optional[str] = None - """Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created.""" - mask_position: Optional[MaskPosition] = None - """A JSON-serialized object for position where the mask should be placed on faces""" + """Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.""" + needs_repainting: Optional[bool] = None + """Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only""" def build_request(self, bot: Bot) -> Request: - data: Dict[str, Any] = self.dict(exclude={"png_sticker", "tgs_sticker", "webm_sticker"}) - + data: Dict[str, Any] = self.dict() files: Dict[str, InputFile] = {} - prepare_file(data=data, files=files, name="png_sticker", value=self.png_sticker) - prepare_file(data=data, files=files, name="tgs_sticker", value=self.tgs_sticker) - prepare_file(data=data, files=files, name="webm_sticker", value=self.webm_sticker) + + prepare_input_stickers(data=data, files=files) return Request(method="createNewStickerSet", data=data, files=files) diff --git a/aiogram/methods/delete_sticker_set.py b/aiogram/methods/delete_sticker_set.py new file mode 100644 index 00000000..2ffa48f2 --- /dev/null +++ b/aiogram/methods/delete_sticker_set.py @@ -0,0 +1,26 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict + +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class DeleteStickerSet(TelegramMethod[bool]): + """ + Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerset + """ + + __returning__ = bool + + name: str + """Sticker set name""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="deleteStickerSet", data=data) diff --git a/aiogram/methods/get_my_description.py b/aiogram/methods/get_my_description.py new file mode 100644 index 00000000..770e6263 --- /dev/null +++ b/aiogram/methods/get_my_description.py @@ -0,0 +1,27 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, Optional + +from ..types import BotDescription +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class GetMyDescription(TelegramMethod[BotDescription]): + """ + Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success. + + Source: https://core.telegram.org/bots/api#getmydescription + """ + + __returning__ = BotDescription + + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code or an empty string""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="getMyDescription", data=data) diff --git a/aiogram/methods/get_my_short_description.py b/aiogram/methods/get_my_short_description.py new file mode 100644 index 00000000..a38d4ecc --- /dev/null +++ b/aiogram/methods/get_my_short_description.py @@ -0,0 +1,27 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, Optional + +from ..types import BotShortDescription +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class GetMyShortDescription(TelegramMethod[BotShortDescription]): + """ + Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success. + + Source: https://core.telegram.org/bots/api#getmyshortdescription + """ + + __returning__ = BotShortDescription + + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code or an empty string""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="getMyShortDescription", data=data) diff --git a/aiogram/methods/send_animation.py b/aiogram/methods/send_animation.py index 3bebdc78..7528d8be 100644 --- a/aiogram/methods/send_animation.py +++ b/aiogram/methods/send_animation.py @@ -39,7 +39,7 @@ class SendAnimation(TelegramMethod[Message]): """Animation width""" height: Optional[int] = None """Animation height""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing""" @@ -71,6 +71,6 @@ class SendAnimation(TelegramMethod[Message]): files: Dict[str, InputFile] = {} prepare_file(data=data, files=files, name="animation", value=self.animation) - prepare_file(data=data, files=files, name="thumb", value=self.thumb) + prepare_file(data=data, files=files, name="thumbnail", value=self.thumbnail) return Request(method="sendAnimation", data=data, files=files) diff --git a/aiogram/methods/send_audio.py b/aiogram/methods/send_audio.py index 1786f751..6557a5c1 100644 --- a/aiogram/methods/send_audio.py +++ b/aiogram/methods/send_audio.py @@ -46,7 +46,7 @@ class SendAudio(TelegramMethod[Message]): """Performer""" title: Optional[str] = None """Track name""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" disable_notification: Optional[bool] = None """Sends the message `silently `_. Users will receive a notification with no sound.""" @@ -70,6 +70,6 @@ class SendAudio(TelegramMethod[Message]): files: Dict[str, InputFile] = {} prepare_file(data=data, files=files, name="audio", value=self.audio) - prepare_file(data=data, files=files, name="thumb", value=self.thumb) + prepare_file(data=data, files=files, name="thumbnail", value=self.thumbnail) return Request(method="sendAudio", data=data, files=files) diff --git a/aiogram/methods/send_document.py b/aiogram/methods/send_document.py index 6f99e756..9b81b88f 100644 --- a/aiogram/methods/send_document.py +++ b/aiogram/methods/send_document.py @@ -33,7 +33,7 @@ class SendDocument(TelegramMethod[Message]): """File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" message_thread_id: Optional[int] = None """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing""" @@ -65,6 +65,6 @@ class SendDocument(TelegramMethod[Message]): files: Dict[str, InputFile] = {} prepare_file(data=data, files=files, name="document", value=self.document) - prepare_file(data=data, files=files, name="thumb", value=self.thumb) + prepare_file(data=data, files=files, name="thumbnail", value=self.thumbnail) return Request(method="sendDocument", data=data, files=files) diff --git a/aiogram/methods/send_sticker.py b/aiogram/methods/send_sticker.py index 81ab698d..e707cd2f 100644 --- a/aiogram/methods/send_sticker.py +++ b/aiogram/methods/send_sticker.py @@ -28,9 +28,11 @@ class SendSticker(TelegramMethod[Message]): chat_id: Union[int, str] """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" sticker: Union[InputFile, str] - """Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" + """Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL.""" message_thread_id: Optional[int] = None """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + emoji: Optional[str] = None + """Emoji associated with the sticker; only for just uploaded stickers""" disable_notification: Optional[bool] = None """Sends the message `silently `_. Users will receive a notification with no sound.""" protect_content: Optional[bool] = None diff --git a/aiogram/methods/send_video.py b/aiogram/methods/send_video.py index b144d090..8075b1fb 100644 --- a/aiogram/methods/send_video.py +++ b/aiogram/methods/send_video.py @@ -39,7 +39,7 @@ class SendVideo(TelegramMethod[Message]): """Video width""" height: Optional[int] = None """Video height""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing""" @@ -73,6 +73,6 @@ class SendVideo(TelegramMethod[Message]): files: Dict[str, InputFile] = {} prepare_file(data=data, files=files, name="video", value=self.video) - prepare_file(data=data, files=files, name="thumb", value=self.thumb) + prepare_file(data=data, files=files, name="thumbnail", value=self.thumbnail) return Request(method="sendVideo", data=data, files=files) diff --git a/aiogram/methods/send_video_note.py b/aiogram/methods/send_video_note.py index 19776e62..3db3a142 100644 --- a/aiogram/methods/send_video_note.py +++ b/aiogram/methods/send_video_note.py @@ -35,7 +35,7 @@ class SendVideoNote(TelegramMethod[Message]): """Duration of sent video in seconds""" length: Optional[int] = None """Video width and height, i.e. diameter of the video message""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" disable_notification: Optional[bool] = None """Sends the message `silently `_. Users will receive a notification with no sound.""" @@ -55,6 +55,6 @@ class SendVideoNote(TelegramMethod[Message]): files: Dict[str, InputFile] = {} prepare_file(data=data, files=files, name="video_note", value=self.video_note) - prepare_file(data=data, files=files, name="thumb", value=self.thumb) + prepare_file(data=data, files=files, name="thumbnail", value=self.thumbnail) return Request(method="sendVideoNote", data=data, files=files) diff --git a/aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py b/aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py new file mode 100644 index 00000000..35b047a2 --- /dev/null +++ b/aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py @@ -0,0 +1,28 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, Optional + +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetCustomEmojiStickerSetThumbnail(TelegramMethod[bool]): + """ + Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setcustomemojistickersetthumbnail + """ + + __returning__ = bool + + name: str + """Sticker set name""" + custom_emoji_id: Optional[str] = None + """Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="setCustomEmojiStickerSetThumbnail", data=data) diff --git a/aiogram/methods/set_my_default_administrator_rights.py b/aiogram/methods/set_my_default_administrator_rights.py index 84341180..f8177958 100644 --- a/aiogram/methods/set_my_default_administrator_rights.py +++ b/aiogram/methods/set_my_default_administrator_rights.py @@ -11,7 +11,7 @@ if TYPE_CHECKING: class SetMyDefaultAdministratorRights(TelegramMethod[bool]): """ - Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns :code:`True` on success. + Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success. Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights """ diff --git a/aiogram/methods/set_my_description.py b/aiogram/methods/set_my_description.py new file mode 100644 index 00000000..a05440ef --- /dev/null +++ b/aiogram/methods/set_my_description.py @@ -0,0 +1,28 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, Optional + +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetMyDescription(TelegramMethod[bool]): + """ + Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmydescription + """ + + __returning__ = bool + + description: Optional[str] = None + """New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="setMyDescription", data=data) diff --git a/aiogram/methods/set_my_short_description.py b/aiogram/methods/set_my_short_description.py new file mode 100644 index 00000000..c759d1ed --- /dev/null +++ b/aiogram/methods/set_my_short_description.py @@ -0,0 +1,28 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, Optional + +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetMyShortDescription(TelegramMethod[bool]): + """ + Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmyshortdescription + """ + + __returning__ = bool + + short_description: Optional[str] = None + """New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="setMyShortDescription", data=data) diff --git a/aiogram/methods/set_sticker_emoji_list.py b/aiogram/methods/set_sticker_emoji_list.py new file mode 100644 index 00000000..d6ef31f2 --- /dev/null +++ b/aiogram/methods/set_sticker_emoji_list.py @@ -0,0 +1,28 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, List + +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetStickerEmojiList(TelegramMethod[bool]): + """ + Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickeremojilist + """ + + __returning__ = bool + + sticker: str + """File identifier of the sticker""" + emoji_list: List[str] + """A JSON-serialized list of 1-20 emoji associated with the sticker""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="setStickerEmojiList", data=data) diff --git a/aiogram/methods/set_sticker_keywords.py b/aiogram/methods/set_sticker_keywords.py new file mode 100644 index 00000000..2fd5b1c4 --- /dev/null +++ b/aiogram/methods/set_sticker_keywords.py @@ -0,0 +1,28 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, List, Optional + +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetStickerKeywords(TelegramMethod[bool]): + """ + Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerkeywords + """ + + __returning__ = bool + + sticker: str + """File identifier of the sticker""" + keywords: Optional[List[str]] = None + """A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="setStickerKeywords", data=data) diff --git a/aiogram/methods/set_sticker_mask_position.py b/aiogram/methods/set_sticker_mask_position.py new file mode 100644 index 00000000..95aa8ca3 --- /dev/null +++ b/aiogram/methods/set_sticker_mask_position.py @@ -0,0 +1,29 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, Optional + +from ..types import MaskPosition +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetStickerMaskPosition(TelegramMethod[bool]): + """ + Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickermaskposition + """ + + __returning__ = bool + + sticker: str + """File identifier of the sticker""" + mask_position: Optional[MaskPosition] = None + """A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="setStickerMaskPosition", data=data) diff --git a/aiogram/methods/set_sticker_set_thumb.py b/aiogram/methods/set_sticker_set_thumb.py deleted file mode 100644 index cbab57e4..00000000 --- a/aiogram/methods/set_sticker_set_thumb.py +++ /dev/null @@ -1,34 +0,0 @@ -from __future__ import annotations - -from typing import TYPE_CHECKING, Any, Dict, Optional, Union - -from ..types import InputFile -from .base import Request, TelegramMethod, prepare_file - -if TYPE_CHECKING: - from ..client.bot import Bot - - -class SetStickerSetThumb(TelegramMethod[bool]): - """ - Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker sets only. Video thumbnails can be set only for video sticker sets only. Returns :code:`True` on success. - - Source: https://core.telegram.org/bots/api#setstickersetthumb - """ - - __returning__ = bool - - name: str - """Sticker set name""" - user_id: int - """User identifier of the sticker set owner""" - thumb: Optional[Union[InputFile, str]] = None - """A **PNG** image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a **TGS** animation with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements, or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated sticker set thumbnails can't be uploaded via HTTP URL.""" - - def build_request(self, bot: Bot) -> Request: - data: Dict[str, Any] = self.dict(exclude={"thumb"}) - - files: Dict[str, InputFile] = {} - prepare_file(data=data, files=files, name="thumb", value=self.thumb) - - return Request(method="setStickerSetThumb", data=data, files=files) diff --git a/aiogram/methods/set_sticker_set_thumbnail.py b/aiogram/methods/set_sticker_set_thumbnail.py new file mode 100644 index 00000000..829aa192 --- /dev/null +++ b/aiogram/methods/set_sticker_set_thumbnail.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict, Optional, Union + +from ..types import InputFile +from .base import Request, TelegramMethod, prepare_file + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetStickerSetThumbnail(TelegramMethod[bool]): + """ + Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersetthumbnail + """ + + __returning__ = bool + + name: str + """Sticker set name""" + user_id: int + """User identifier of the sticker set owner""" + thumbnail: Optional[Union[InputFile, str]] = None + """A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animated-sticker-requirements `_`https://core.telegram.org/stickers#animated-sticker-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-sticker-requirements `_`https://core.telegram.org/stickers#video-sticker-requirements `_ for video sticker technical requirements. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + files: Dict[str, InputFile] = {} + prepare_file("thumbnail", value=self.thumbnail, data=data, files=files) + + return Request(method="setStickerSetThumbnail", data=data) diff --git a/aiogram/methods/set_sticker_set_title.py b/aiogram/methods/set_sticker_set_title.py new file mode 100644 index 00000000..e699c082 --- /dev/null +++ b/aiogram/methods/set_sticker_set_title.py @@ -0,0 +1,28 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Dict + +from .base import Request, TelegramMethod + +if TYPE_CHECKING: + from ..client.bot import Bot + + +class SetStickerSetTitle(TelegramMethod[bool]): + """ + Use this method to set the title of a created sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersettitle + """ + + __returning__ = bool + + name: str + """Sticker set name""" + title: str + """Sticker set title, 1-64 characters""" + + def build_request(self, bot: Bot) -> Request: + data: Dict[str, Any] = self.dict() + + return Request(method="setStickerSetTitle", data=data) diff --git a/aiogram/methods/upload_sticker_file.py b/aiogram/methods/upload_sticker_file.py index cb36ae4d..d0fcbc44 100644 --- a/aiogram/methods/upload_sticker_file.py +++ b/aiogram/methods/upload_sticker_file.py @@ -11,7 +11,7 @@ if TYPE_CHECKING: class UploadStickerFile(TelegramMethod[File]): """ - Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and *addStickerToSet* methods (can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. + Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. Source: https://core.telegram.org/bots/api#uploadstickerfile """ @@ -20,13 +20,15 @@ class UploadStickerFile(TelegramMethod[File]): user_id: int """User identifier of sticker file owner""" - png_sticker: InputFile - """**PNG** image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. :ref:`More information on Sending Files » `""" + sticker: InputFile + """A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `""" + sticker_format: str + """Format of the sticker, must be one of 'static', 'animated', 'video'""" def build_request(self, bot: Bot) -> Request: - data: Dict[str, Any] = self.dict(exclude={"png_sticker"}) + data: Dict[str, Any] = self.dict(exclude={"sticker"}) files: Dict[str, InputFile] = {} - prepare_file(data=data, files=files, name="png_sticker", value=self.png_sticker) + prepare_file(data=data, files=files, name="sticker", value=self.sticker) return Request(method="uploadStickerFile", data=data, files=files) diff --git a/aiogram/types/__init__.py b/aiogram/types/__init__.py index 1d80489f..3fc98953 100644 --- a/aiogram/types/__init__.py +++ b/aiogram/types/__init__.py @@ -14,6 +14,8 @@ from .bot_command_scope_chat import BotCommandScopeChat from .bot_command_scope_chat_administrators import BotCommandScopeChatAdministrators from .bot_command_scope_chat_member import BotCommandScopeChatMember from .bot_command_scope_default import BotCommandScopeDefault +from .bot_description import BotDescription +from .bot_short_description import BotShortDescription from .callback_game import CallbackGame from .callback_query import CallbackQuery from .chat import Chat @@ -86,6 +88,7 @@ from .input_media_document import InputMediaDocument from .input_media_photo import InputMediaPhoto from .input_media_video import InputMediaVideo from .input_message_content import InputMessageContent +from .input_sticker import InputSticker from .input_text_message_content import InputTextMessageContent from .input_venue_message_content import InputVenueMessageContent from .invoice import Invoice @@ -165,6 +168,8 @@ __all__ = ( "BotCommandScopeChatAdministrators", "BotCommandScopeChatMember", "BotCommandScopeDefault", + "BotDescription", + "BotShortDescription", "BufferedInputFile", "CallbackGame", "CallbackQuery", @@ -240,6 +245,7 @@ __all__ = ( "InputMediaPhoto", "InputMediaVideo", "InputMessageContent", + "InputSticker", "InputTextMessageContent", "InputVenueMessageContent", "Invoice", diff --git a/aiogram/types/animation.py b/aiogram/types/animation.py index ce3c034e..15354156 100644 --- a/aiogram/types/animation.py +++ b/aiogram/types/animation.py @@ -25,7 +25,7 @@ class Animation(TelegramObject): """Video height as defined by sender""" duration: int """Duration of the video in seconds as defined by sender""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Animation thumbnail as defined by sender""" file_name: Optional[str] = None """*Optional*. Original animation filename as defined by sender""" diff --git a/aiogram/types/audio.py b/aiogram/types/audio.py index fa0557cd..0a147c36 100644 --- a/aiogram/types/audio.py +++ b/aiogram/types/audio.py @@ -31,5 +31,5 @@ class Audio(TelegramObject): """*Optional*. MIME type of the file as defined by sender""" file_size: Optional[int] = None """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Thumbnail of the album cover to which the music file belongs""" diff --git a/aiogram/types/bot_description.py b/aiogram/types/bot_description.py new file mode 100644 index 00000000..a69d492f --- /dev/null +++ b/aiogram/types/bot_description.py @@ -0,0 +1,12 @@ +from aiogram.types import TelegramObject + + +class BotDescription(TelegramObject): + """ + This object represents the bot's description. + + Source: https://core.telegram.org/bots/api#botdescription + """ + + description: str + """The bot's description""" diff --git a/aiogram/types/bot_short_description.py b/aiogram/types/bot_short_description.py new file mode 100644 index 00000000..46d5c1c3 --- /dev/null +++ b/aiogram/types/bot_short_description.py @@ -0,0 +1,12 @@ +from aiogram.types import TelegramObject + + +class BotShortDescription(TelegramObject): + """ + This object represents the bot's short description. + + Source: https://core.telegram.org/bots/api#botshortdescription + """ + + short_description: str + """The bot's short description""" diff --git a/aiogram/types/document.py b/aiogram/types/document.py index db2433a8..837bf4ec 100644 --- a/aiogram/types/document.py +++ b/aiogram/types/document.py @@ -19,7 +19,7 @@ class Document(TelegramObject): """Identifier for this file, which can be used to download or reuse the file""" file_unique_id: str """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Document thumbnail as defined by sender""" file_name: Optional[str] = None """*Optional*. Original filename as defined by sender""" diff --git a/aiogram/types/inline_query_result_article.py b/aiogram/types/inline_query_result_article.py index 611733c6..dd65b595 100644 --- a/aiogram/types/inline_query_result_article.py +++ b/aiogram/types/inline_query_result_article.py @@ -35,9 +35,9 @@ class InlineQueryResultArticle(InlineQueryResult): """*Optional*. Pass :code:`True` if you don't want the URL to be shown in the message""" description: Optional[str] = None """*Optional*. Short description of the result""" - thumb_url: Optional[str] = None + thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None + thumbnail_width: Optional[int] = None """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None + thumbnail_height: Optional[int] = None """*Optional*. Thumbnail height""" diff --git a/aiogram/types/inline_query_result_contact.py b/aiogram/types/inline_query_result_contact.py index 04ea46fb..0f88bb9f 100644 --- a/aiogram/types/inline_query_result_contact.py +++ b/aiogram/types/inline_query_result_contact.py @@ -36,9 +36,9 @@ class InlineQueryResultContact(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the contact""" - thumb_url: Optional[str] = None + thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None + thumbnail_width: Optional[int] = None """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None + thumbnail_height: Optional[int] = None """*Optional*. Thumbnail height""" diff --git a/aiogram/types/inline_query_result_document.py b/aiogram/types/inline_query_result_document.py index 941e1de8..d1c577cf 100644 --- a/aiogram/types/inline_query_result_document.py +++ b/aiogram/types/inline_query_result_document.py @@ -44,9 +44,9 @@ class InlineQueryResultDocument(InlineQueryResult): """*Optional*. Inline keyboard attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the file""" - thumb_url: Optional[str] = None + thumbnail_url: Optional[str] = None """*Optional*. URL of the thumbnail (JPEG only) for the file""" - thumb_width: Optional[int] = None + thumbnail_width: Optional[int] = None """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None + thumbnail_height: Optional[int] = None """*Optional*. Thumbnail height""" diff --git a/aiogram/types/inline_query_result_gif.py b/aiogram/types/inline_query_result_gif.py index d674b55a..ac4e0c05 100644 --- a/aiogram/types/inline_query_result_gif.py +++ b/aiogram/types/inline_query_result_gif.py @@ -27,7 +27,7 @@ class InlineQueryResultGif(InlineQueryResult): """Unique identifier for this result, 1-64 bytes""" gif_url: str """A valid URL for the GIF file. File size must not exceed 1MB""" - thumb_url: str + thumbnail_url: str """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" gif_width: Optional[int] = None """*Optional*. Width of the GIF""" @@ -35,7 +35,7 @@ class InlineQueryResultGif(InlineQueryResult): """*Optional*. Height of the GIF""" gif_duration: Optional[int] = None """*Optional*. Duration of the GIF in seconds""" - thumb_mime_type: Optional[str] = None + thumbnail_mime_type: Optional[str] = None """*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" title: Optional[str] = None """*Optional*. Title for the result""" diff --git a/aiogram/types/inline_query_result_location.py b/aiogram/types/inline_query_result_location.py index 395724ff..aa1f6d88 100644 --- a/aiogram/types/inline_query_result_location.py +++ b/aiogram/types/inline_query_result_location.py @@ -42,9 +42,9 @@ class InlineQueryResultLocation(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the location""" - thumb_url: Optional[str] = None + thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None + thumbnail_width: Optional[int] = None """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None + thumbnail_height: Optional[int] = None """*Optional*. Thumbnail height""" diff --git a/aiogram/types/inline_query_result_mpeg4_gif.py b/aiogram/types/inline_query_result_mpeg4_gif.py index d846aeb3..260ae839 100644 --- a/aiogram/types/inline_query_result_mpeg4_gif.py +++ b/aiogram/types/inline_query_result_mpeg4_gif.py @@ -27,7 +27,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult): """Unique identifier for this result, 1-64 bytes""" mpeg4_url: str """A valid URL for the MPEG4 file. File size must not exceed 1MB""" - thumb_url: str + thumbnail_url: str """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" mpeg4_width: Optional[int] = None """*Optional*. Video width""" @@ -35,7 +35,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult): """*Optional*. Video height""" mpeg4_duration: Optional[int] = None """*Optional*. Video duration in seconds""" - thumb_mime_type: Optional[str] = None + thumbnail_mime_type: Optional[str] = None """*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" title: Optional[str] = None """*Optional*. Title for the result""" diff --git a/aiogram/types/inline_query_result_photo.py b/aiogram/types/inline_query_result_photo.py index b63e0819..6ef09fc3 100644 --- a/aiogram/types/inline_query_result_photo.py +++ b/aiogram/types/inline_query_result_photo.py @@ -27,7 +27,7 @@ class InlineQueryResultPhoto(InlineQueryResult): """Unique identifier for this result, 1-64 bytes""" photo_url: str """A valid URL of the photo. Photo must be in **JPEG** format. Photo size must not exceed 5MB""" - thumb_url: str + thumbnail_url: str """URL of the thumbnail for the photo""" photo_width: Optional[int] = None """*Optional*. Width of the photo""" diff --git a/aiogram/types/inline_query_result_venue.py b/aiogram/types/inline_query_result_venue.py index 761886d8..0c92a008 100644 --- a/aiogram/types/inline_query_result_venue.py +++ b/aiogram/types/inline_query_result_venue.py @@ -44,9 +44,9 @@ class InlineQueryResultVenue(InlineQueryResult): """*Optional*. `Inline keyboard `_ attached to the message""" input_message_content: Optional[InputMessageContent] = None """*Optional*. Content of the message to be sent instead of the venue""" - thumb_url: Optional[str] = None + thumbnail_url: Optional[str] = None """*Optional*. Url of the thumbnail for the result""" - thumb_width: Optional[int] = None + thumbnail_width: Optional[int] = None """*Optional*. Thumbnail width""" - thumb_height: Optional[int] = None + thumbnail_height: Optional[int] = None """*Optional*. Thumbnail height""" diff --git a/aiogram/types/inline_query_result_video.py b/aiogram/types/inline_query_result_video.py index 1a1843ee..f35c55cb 100644 --- a/aiogram/types/inline_query_result_video.py +++ b/aiogram/types/inline_query_result_video.py @@ -31,7 +31,7 @@ class InlineQueryResultVideo(InlineQueryResult): """A valid URL for the embedded video player or video file""" mime_type: str """MIME type of the content of the video URL, 'text/html' or 'video/mp4'""" - thumb_url: str + thumbnail_url: str """URL of the thumbnail (JPEG only) for the video""" title: str """Title for the result""" diff --git a/aiogram/types/input_media_animation.py b/aiogram/types/input_media_animation.py index 326438d5..9b94f0c1 100644 --- a/aiogram/types/input_media_animation.py +++ b/aiogram/types/input_media_animation.py @@ -24,7 +24,7 @@ class InputMediaAnimation(InputMedia): """Type of the result, must be *animation*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the animation to be sent, 0-1024 characters after entities parsing""" diff --git a/aiogram/types/input_media_audio.py b/aiogram/types/input_media_audio.py index a9d69610..3d149dc8 100644 --- a/aiogram/types/input_media_audio.py +++ b/aiogram/types/input_media_audio.py @@ -24,7 +24,7 @@ class InputMediaAudio(InputMedia): """Type of the result, must be *audio*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the audio to be sent, 0-1024 characters after entities parsing""" diff --git a/aiogram/types/input_media_document.py b/aiogram/types/input_media_document.py index 22aea188..6eb6acfa 100644 --- a/aiogram/types/input_media_document.py +++ b/aiogram/types/input_media_document.py @@ -24,7 +24,7 @@ class InputMediaDocument(InputMedia): """Type of the result, must be *document*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the document to be sent, 0-1024 characters after entities parsing""" diff --git a/aiogram/types/input_media_video.py b/aiogram/types/input_media_video.py index bf701d9c..21379d5f 100644 --- a/aiogram/types/input_media_video.py +++ b/aiogram/types/input_media_video.py @@ -24,7 +24,7 @@ class InputMediaVideo(InputMedia): """Type of the result, must be *video*""" media: Union[str, InputFile] """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" - thumb: Optional[Union[InputFile, str]] = None + thumbnail: Optional[Union[InputFile, str]] = None """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" caption: Optional[str] = None """*Optional*. Caption of the video to be sent, 0-1024 characters after entities parsing""" diff --git a/aiogram/types/input_sticker.py b/aiogram/types/input_sticker.py new file mode 100644 index 00000000..46bec15c --- /dev/null +++ b/aiogram/types/input_sticker.py @@ -0,0 +1,26 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, List, Optional, Union + +from .base import TelegramObject + +if TYPE_CHECKING: + from .input_file import InputFile + from .mask_position import MaskPosition + + +class InputSticker(TelegramObject): + """ + This object describes a sticker to be added to a sticker set. + + Source: https://core.telegram.org/bots/api#inputsticker + """ + + sticker: Union[InputFile, str] + """The added sticker. Pass a *file_id* as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. :ref:`More information on Sending Files » `""" + emoji_list: List[str] + """List of 1-20 emoji associated with the sticker""" + mask_position: Optional[MaskPosition] = None + """*Optional*. Position where the mask should be placed on faces. For 'mask' stickers only.""" + keywords: Optional[List[str]] = None + """*Optional*. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.""" diff --git a/aiogram/types/message.py b/aiogram/types/message.py index 9431f835..bd18740a 100644 --- a/aiogram/types/message.py +++ b/aiogram/types/message.py @@ -348,7 +348,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -377,7 +377,7 @@ class Message(TelegramObject): :param duration: Duration of sent animation in seconds :param width: Animation width :param height: Animation height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the animation 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* @@ -401,7 +401,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -419,7 +419,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -448,7 +448,7 @@ class Message(TelegramObject): :param duration: Duration of sent animation in seconds :param width: Animation width :param height: Animation height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the animation 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* @@ -472,7 +472,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -494,7 +494,7 @@ class Message(TelegramObject): duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, @@ -523,7 +523,7 @@ class Message(TelegramObject): :param duration: Duration of the audio in seconds :param performer: Performer :param title: Track name - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :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 allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found @@ -546,7 +546,7 @@ class Message(TelegramObject): duration=duration, performer=performer, title=title, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, @@ -563,7 +563,7 @@ class Message(TelegramObject): duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -592,7 +592,7 @@ class Message(TelegramObject): :param duration: Duration of the audio in seconds :param performer: Performer :param title: Track name - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :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_to_message_id: If the message is a reply, ID of the original message @@ -615,7 +615,7 @@ class Message(TelegramObject): duration=duration, performer=performer, title=title, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, @@ -740,7 +740,7 @@ class Message(TelegramObject): def reply_document( self, document: Union[InputFile, str], - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -766,7 +766,7 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#senddocument :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the document 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* @@ -787,7 +787,7 @@ class Message(TelegramObject): message_thread_id=self.message_thread_id if self.is_topic_message else None, reply_to_message_id=self.message_id, document=document, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -802,7 +802,7 @@ class Message(TelegramObject): def answer_document( self, document: Union[InputFile, str], - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -828,7 +828,7 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#senddocument :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the document 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* @@ -849,7 +849,7 @@ class Message(TelegramObject): chat_id=self.chat.id, message_thread_id=self.message_thread_id if self.is_topic_message else None, document=document, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -1865,6 +1865,7 @@ class Message(TelegramObject): def reply_sticker( self, sticker: Union[InputFile, str], + emoji: Optional[str] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, @@ -1885,7 +1886,8 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#sendsticker - :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL. + :param emoji: Emoji associated with the sticker; only for just uploaded stickers :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 allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found @@ -1902,6 +1904,7 @@ class Message(TelegramObject): message_thread_id=self.message_thread_id if self.is_topic_message else None, reply_to_message_id=self.message_id, sticker=sticker, + emoji=emoji, disable_notification=disable_notification, protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, @@ -1912,6 +1915,7 @@ class Message(TelegramObject): def answer_sticker( self, sticker: Union[InputFile, str], + emoji: Optional[str] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -1932,7 +1936,8 @@ class Message(TelegramObject): Source: https://core.telegram.org/bots/api#sendsticker - :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL. + :param emoji: Emoji associated with the sticker; only for just uploaded stickers :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_to_message_id: If the message is a reply, ID of the original message @@ -1949,6 +1954,7 @@ class Message(TelegramObject): chat_id=self.chat.id, message_thread_id=self.message_thread_id if self.is_topic_message else None, sticker=sticker, + emoji=emoji, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, @@ -2100,7 +2106,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2130,7 +2136,7 @@ class Message(TelegramObject): :param duration: Duration of sent video in seconds :param width: Video width :param height: Video height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the video 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* @@ -2155,7 +2161,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2174,7 +2180,7 @@ class Message(TelegramObject): duration: Optional[int] = None, width: Optional[int] = None, height: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, @@ -2204,7 +2210,7 @@ class Message(TelegramObject): :param duration: Duration of sent video in seconds :param width: Video width :param height: Video height - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing :param parse_mode: Mode for parsing entities in the video 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* @@ -2229,7 +2235,7 @@ class Message(TelegramObject): duration=duration, width=width, height=height, - thumb=thumb, + thumbnail=thumbnail, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, @@ -2248,7 +2254,7 @@ class Message(TelegramObject): video_note: Union[InputFile, str], duration: Optional[int] = None, length: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, @@ -2272,7 +2278,7 @@ class Message(TelegramObject): :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported :param duration: Duration of sent video in seconds :param length: Video width and height, i.e. diameter of the video message - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :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 allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found @@ -2291,7 +2297,7 @@ class Message(TelegramObject): video_note=video_note, duration=duration, length=length, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, @@ -2304,7 +2310,7 @@ class Message(TelegramObject): video_note: Union[InputFile, str], duration: Optional[int] = None, length: Optional[int] = None, - thumb: Optional[Union[InputFile, str]] = None, + thumbnail: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, @@ -2328,7 +2334,7 @@ class Message(TelegramObject): :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported :param duration: Duration of sent video in seconds :param length: Video width and height, i.e. diameter of the video message - :param thumb: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` :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_to_message_id: If the message is a reply, ID of the original message @@ -2347,7 +2353,7 @@ class Message(TelegramObject): video_note=video_note, duration=duration, length=length, - thumb=thumb, + thumbnail=thumbnail, disable_notification=disable_notification, protect_content=protect_content, reply_to_message_id=reply_to_message_id, diff --git a/aiogram/types/sticker.py b/aiogram/types/sticker.py index 770dd204..1bac276f 100644 --- a/aiogram/types/sticker.py +++ b/aiogram/types/sticker.py @@ -32,7 +32,7 @@ class Sticker(TelegramObject): """:code:`True`, if the sticker is `animated `_""" is_video: bool """:code:`True`, if the sticker is a `video sticker `_""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Sticker thumbnail in the .WEBP or .JPG format""" emoji: Optional[str] = None """*Optional*. Emoji associated with the sticker""" @@ -44,6 +44,8 @@ class Sticker(TelegramObject): """*Optional*. For mask stickers, the position where the mask should be placed""" custom_emoji_id: Optional[str] = None """*Optional*. For custom emoji stickers, unique identifier of the custom emoji""" + needs_repainting: Optional[bool] = None + """*Optional*. :code:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places""" file_size: Optional[int] = None """*Optional*. File size in bytes""" diff --git a/aiogram/types/sticker_set.py b/aiogram/types/sticker_set.py index 8f2b264e..d212acd0 100644 --- a/aiogram/types/sticker_set.py +++ b/aiogram/types/sticker_set.py @@ -28,5 +28,5 @@ class StickerSet(TelegramObject): """:code:`True`, if the sticker set contains `video stickers `_""" stickers: List[Sticker] """List of all set stickers""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format""" diff --git a/aiogram/types/video.py b/aiogram/types/video.py index 473527d1..ca43493a 100644 --- a/aiogram/types/video.py +++ b/aiogram/types/video.py @@ -25,7 +25,7 @@ class Video(TelegramObject): """Video height as defined by sender""" duration: int """Duration of the video in seconds as defined by sender""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Video thumbnail""" file_name: Optional[str] = None """*Optional*. Original filename as defined by sender""" diff --git a/aiogram/types/video_note.py b/aiogram/types/video_note.py index c2488336..03654824 100644 --- a/aiogram/types/video_note.py +++ b/aiogram/types/video_note.py @@ -23,7 +23,7 @@ class VideoNote(TelegramObject): """Video width and height (diameter of the video message) as defined by sender""" duration: int """Duration of the video in seconds as defined by sender""" - thumb: Optional[PhotoSize] = None + thumbnail: Optional[PhotoSize] = None """*Optional*. Video thumbnail""" file_size: Optional[int] = None """*Optional*. File size in bytes""" diff --git a/docs/api/enums/index.rst b/docs/api/enums/index.rst index 0e208fce..84a4b837 100644 --- a/docs/api/enums/index.rst +++ b/docs/api/enums/index.rst @@ -21,6 +21,7 @@ Here is list of all available enums: message_entity_type parse_mode poll_type + sticker_format sticker_type topic_icon_color update_type diff --git a/docs/api/enums/sticker_format.rst b/docs/api/enums/sticker_format.rst new file mode 100644 index 00000000..278602a0 --- /dev/null +++ b/docs/api/enums/sticker_format.rst @@ -0,0 +1,9 @@ +############# +StickerFormat +############# + + +.. automodule:: aiogram.enums.sticker_format + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/methods/delete_sticker_set.rst b/docs/api/methods/delete_sticker_set.rst new file mode 100644 index 00000000..dc9be624 --- /dev/null +++ b/docs/api/methods/delete_sticker_set.rst @@ -0,0 +1,44 @@ +################ +deleteStickerSet +################ + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.delete_sticker_set + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.delete_sticker_set(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.delete_sticker_set import DeleteStickerSet` +- alias: :code:`from aiogram.methods import DeleteStickerSet` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(DeleteStickerSet(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return DeleteStickerSet(...) diff --git a/docs/api/methods/get_my_description.rst b/docs/api/methods/get_my_description.rst new file mode 100644 index 00000000..c68bda0d --- /dev/null +++ b/docs/api/methods/get_my_description.rst @@ -0,0 +1,37 @@ +################ +getMyDescription +################ + +Returns: :obj:`BotDescription` + +.. automodule:: aiogram.methods.get_my_description + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: BotDescription = await bot.get_my_description(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.get_my_description import GetMyDescription` +- alias: :code:`from aiogram.methods import GetMyDescription` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: BotDescription = await bot(GetMyDescription(...)) diff --git a/docs/api/methods/get_my_short_description.rst b/docs/api/methods/get_my_short_description.rst new file mode 100644 index 00000000..967d3318 --- /dev/null +++ b/docs/api/methods/get_my_short_description.rst @@ -0,0 +1,37 @@ +##################### +getMyShortDescription +##################### + +Returns: :obj:`BotShortDescription` + +.. automodule:: aiogram.methods.get_my_short_description + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: BotShortDescription = await bot.get_my_short_description(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.get_my_short_description import GetMyShortDescription` +- alias: :code:`from aiogram.methods import GetMyShortDescription` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: BotShortDescription = await bot(GetMyShortDescription(...)) diff --git a/docs/api/methods/index.rst b/docs/api/methods/index.rst index 7bb7d2b8..17626855 100644 --- a/docs/api/methods/index.rst +++ b/docs/api/methods/index.rst @@ -29,7 +29,6 @@ Available methods edit_chat_invite_link edit_forum_topic edit_general_forum_topic - edit_message_live_location export_chat_invite_link forward_message get_chat @@ -42,6 +41,8 @@ Available methods get_me get_my_commands get_my_default_administrator_rights + get_my_description + get_my_short_description get_user_profile_photos hide_general_forum_topic leave_chat @@ -76,7 +77,8 @@ Available methods set_chat_title set_my_commands set_my_default_administrator_rights - stop_message_live_location + set_my_description + set_my_short_description unban_chat_member unban_chat_sender_chat unhide_general_forum_topic @@ -104,11 +106,17 @@ Stickers add_sticker_to_set create_new_sticker_set delete_sticker_from_set + delete_sticker_set get_custom_emoji_stickers get_sticker_set send_sticker + set_custom_emoji_sticker_set_thumbnail + set_sticker_emoji_list + set_sticker_keywords + set_sticker_mask_position set_sticker_position_in_set - set_sticker_set_thumb + set_sticker_set_thumbnail + set_sticker_set_title upload_sticker_file Games @@ -148,9 +156,11 @@ Updating messages delete_message edit_message_caption + edit_message_live_location edit_message_media edit_message_reply_markup edit_message_text + stop_message_live_location stop_poll Inline mode diff --git a/docs/api/methods/set_custom_emoji_sticker_set_thumbnail.rst b/docs/api/methods/set_custom_emoji_sticker_set_thumbnail.rst new file mode 100644 index 00000000..093e30c9 --- /dev/null +++ b/docs/api/methods/set_custom_emoji_sticker_set_thumbnail.rst @@ -0,0 +1,44 @@ +################################# +setCustomEmojiStickerSetThumbnail +################################# + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_custom_emoji_sticker_set_thumbnail + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_custom_emoji_sticker_set_thumbnail(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_custom_emoji_sticker_set_thumbnail import SetCustomEmojiStickerSetThumbnail` +- alias: :code:`from aiogram.methods import SetCustomEmojiStickerSetThumbnail` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetCustomEmojiStickerSetThumbnail(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetCustomEmojiStickerSetThumbnail(...) diff --git a/docs/api/methods/set_my_description.rst b/docs/api/methods/set_my_description.rst new file mode 100644 index 00000000..126199ee --- /dev/null +++ b/docs/api/methods/set_my_description.rst @@ -0,0 +1,44 @@ +################ +setMyDescription +################ + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_my_description + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_my_description(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_my_description import SetMyDescription` +- alias: :code:`from aiogram.methods import SetMyDescription` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetMyDescription(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetMyDescription(...) diff --git a/docs/api/methods/set_my_short_description.rst b/docs/api/methods/set_my_short_description.rst new file mode 100644 index 00000000..f7f250d7 --- /dev/null +++ b/docs/api/methods/set_my_short_description.rst @@ -0,0 +1,44 @@ +##################### +setMyShortDescription +##################### + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_my_short_description + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_my_short_description(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_my_short_description import SetMyShortDescription` +- alias: :code:`from aiogram.methods import SetMyShortDescription` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetMyShortDescription(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetMyShortDescription(...) diff --git a/docs/api/methods/set_sticker_emoji_list.rst b/docs/api/methods/set_sticker_emoji_list.rst new file mode 100644 index 00000000..c8602f0f --- /dev/null +++ b/docs/api/methods/set_sticker_emoji_list.rst @@ -0,0 +1,44 @@ +################### +setStickerEmojiList +################### + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_sticker_emoji_list + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_sticker_emoji_list(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_sticker_emoji_list import SetStickerEmojiList` +- alias: :code:`from aiogram.methods import SetStickerEmojiList` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetStickerEmojiList(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetStickerEmojiList(...) diff --git a/docs/api/methods/set_sticker_keywords.rst b/docs/api/methods/set_sticker_keywords.rst new file mode 100644 index 00000000..d15c11ac --- /dev/null +++ b/docs/api/methods/set_sticker_keywords.rst @@ -0,0 +1,44 @@ +################## +setStickerKeywords +################## + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_sticker_keywords + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_sticker_keywords(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_sticker_keywords import SetStickerKeywords` +- alias: :code:`from aiogram.methods import SetStickerKeywords` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetStickerKeywords(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetStickerKeywords(...) diff --git a/docs/api/methods/set_sticker_mask_position.rst b/docs/api/methods/set_sticker_mask_position.rst new file mode 100644 index 00000000..48041877 --- /dev/null +++ b/docs/api/methods/set_sticker_mask_position.rst @@ -0,0 +1,44 @@ +###################### +setStickerMaskPosition +###################### + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_sticker_mask_position + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_sticker_mask_position(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_sticker_mask_position import SetStickerMaskPosition` +- alias: :code:`from aiogram.methods import SetStickerMaskPosition` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetStickerMaskPosition(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetStickerMaskPosition(...) diff --git a/docs/api/methods/set_sticker_set_thumbnail.rst b/docs/api/methods/set_sticker_set_thumbnail.rst new file mode 100644 index 00000000..218c1012 --- /dev/null +++ b/docs/api/methods/set_sticker_set_thumbnail.rst @@ -0,0 +1,44 @@ +###################### +setStickerSetThumbnail +###################### + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_sticker_set_thumbnail + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_sticker_set_thumbnail(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_sticker_set_thumbnail import SetStickerSetThumbnail` +- alias: :code:`from aiogram.methods import SetStickerSetThumbnail` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetStickerSetThumbnail(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetStickerSetThumbnail(...) diff --git a/docs/api/methods/set_sticker_set_title.rst b/docs/api/methods/set_sticker_set_title.rst new file mode 100644 index 00000000..f6924dd4 --- /dev/null +++ b/docs/api/methods/set_sticker_set_title.rst @@ -0,0 +1,44 @@ +################## +setStickerSetTitle +################## + +Returns: :obj:`bool` + +.. automodule:: aiogram.methods.set_sticker_set_title + :members: + :member-order: bysource + :undoc-members: True + + +Usage +===== + +As bot method +------------- + +.. code-block:: + + result: bool = await bot.set_sticker_set_title(...) + + +Method as object +---------------- + +Imports: + +- :code:`from aiogram.methods.set_sticker_set_title import SetStickerSetTitle` +- alias: :code:`from aiogram.methods import SetStickerSetTitle` + +With specific bot +~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + result: bool = await bot(SetStickerSetTitle(...)) + +As reply into Webhook in handler +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: python + + return SetStickerSetTitle(...) diff --git a/docs/api/types/bot_description.rst b/docs/api/types/bot_description.rst new file mode 100644 index 00000000..f3ea6d7a --- /dev/null +++ b/docs/api/types/bot_description.rst @@ -0,0 +1,9 @@ +############## +BotDescription +############## + + +.. automodule:: aiogram.types.bot_description + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/types/bot_short_description.rst b/docs/api/types/bot_short_description.rst new file mode 100644 index 00000000..e9812e64 --- /dev/null +++ b/docs/api/types/bot_short_description.rst @@ -0,0 +1,9 @@ +################### +BotShortDescription +################### + + +.. automodule:: aiogram.types.bot_short_description + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/types/index.rst b/docs/api/types/index.rst index 55a00dd4..400af0d9 100644 --- a/docs/api/types/index.rst +++ b/docs/api/types/index.rst @@ -59,6 +59,8 @@ Available types bot_command_scope_chat_administrators bot_command_scope_chat_member bot_command_scope_default + bot_description + bot_short_description callback_query chat chat_administrator_rights @@ -170,6 +172,7 @@ Stickers .. toctree:: :maxdepth: 1 + input_sticker mask_position sticker sticker_set diff --git a/docs/api/types/input_sticker.rst b/docs/api/types/input_sticker.rst new file mode 100644 index 00000000..176a0e15 --- /dev/null +++ b/docs/api/types/input_sticker.rst @@ -0,0 +1,9 @@ +############ +InputSticker +############ + + +.. automodule:: aiogram.types.input_sticker + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/locale/en/LC_MESSAGES/api/enums/inline_query_result_type.po b/docs/locale/en/LC_MESSAGES/api/enums/inline_query_result_type.po index 27a5da7e..b5a7a240 100644 --- a/docs/locale/en/LC_MESSAGES/api/enums/inline_query_result_type.po +++ b/docs/locale/en/LC_MESSAGES/api/enums/inline_query_result_type.po @@ -8,23 +8,29 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/enums/inline_query_result_type.rst:3 msgid "InlineQueryResultType" msgstr "" #: aiogram.enums.inline_query_result_type.InlineQueryResultType:1 of -msgid "The part of the face relative to which the mask should be placed." +msgid "Type of inline query result" msgstr "" #: aiogram.enums.inline_query_result_type.InlineQueryResultType:3 of -msgid "Source: https://core.telegram.org/bots/api#maskposition" +msgid "Source: https://core.telegram.org/bots/api#inlinequeryresult" msgstr "" + +#~ msgid "The part of the face relative to which the mask should be placed." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#maskposition" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/sticker_format.po b/docs/locale/en/LC_MESSAGES/api/enums/sticker_format.po new file mode 100644 index 00000000..57a8b198 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/sticker_format.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/enums/sticker_format.rst:3 +msgid "StickerFormat" +msgstr "" + +#: aiogram.enums.sticker_format.StickerFormat:1 of +msgid "Format of the sticker" +msgstr "" + +#: aiogram.enums.sticker_format.StickerFormat:3 of +msgid "Source: https://core.telegram.org/bots/api#createnewstickerset" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/add_sticker_to_set.po b/docs/locale/en/LC_MESSAGES/api/methods/add_sticker_to_set.po index f3b81bcd..483b44cd 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/add_sticker_to_set.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/add_sticker_to_set.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/add_sticker_to_set.rst:3 msgid "addStickerToSet" @@ -27,12 +27,11 @@ msgstr "" #: aiogram.methods.add_sticker_to_set.AddStickerToSet:1 of msgid "" -"Use this method to add a new sticker to a set created by the bot. You " -"**must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or " -"*webm_sticker*. Animated stickers can be added to animated sticker sets " -"and only to them. Animated sticker sets can have up to 50 stickers. " -"Static sticker sets can have up to 120 stickers. Returns :code:`True` on " -"success." +"Use this method to add a new sticker to a set created by the bot. The " +"format of the added sticker must match the format of the other stickers " +"in the set. Emoji sticker sets can have up to 200 stickers. Animated and " +"video sticker sets can have up to 50 stickers. Static sticker sets can " +"have up to 120 stickers. Returns :code:`True` on success." msgstr "" #: aiogram.methods.add_sticker_to_set.AddStickerToSet:3 of @@ -48,49 +47,12 @@ msgstr "" msgid "Sticker set name" msgstr "" -#: ../../docstring aiogram.methods.add_sticker_to_set.AddStickerToSet.emojis:1 +#: ../../docstring aiogram.methods.add_sticker_to_set.AddStickerToSet.sticker:1 #: of -msgid "One or more emoji corresponding to the sticker" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.png_sticker:1 of msgid "" -"**PNG** image with the sticker, must be up to 512 kilobytes in size, " -"dimensions must not exceed 512px, and either width or height must be " -"exactly 512px. Pass a *file_id* as a String to send a file that already " -"exists on the Telegram servers, pass an HTTP URL as a String for Telegram" -" to get a file from the Internet, or upload a new one using multipart" -"/form-data. :ref:`More information on Sending Files » `" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.tgs_sticker:1 of -msgid "" -"**TGS** animation with the sticker, uploaded using multipart/form-data. " -"See `https://core.telegram.org/stickers#animated-sticker-requirements " -"`_`https://core.telegram.org/stickers#animated-sticker-" -"requirements `_ for technical requirements" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.webm_sticker:1 of -msgid "" -"**WEBM** video with the sticker, uploaded using multipart/form-data. See " -"`https://core.telegram.org/stickers#video-sticker-requirements " -"`_`https://core.telegram.org/stickers#video-sticker-" -"requirements `_ for technical requirements" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.mask_position:1 of -msgid "" -"A JSON-serialized object for position where the mask should be placed on " -"faces" +"A JSON-serialized object with information about the added sticker. If " +"exactly the same sticker had already been added to the set, then the set " +"isn't changed." msgstr "" #: ../../api/methods/add_sticker_to_set.rst:14 @@ -124,3 +86,64 @@ msgstr "" #: ../../api/methods/add_sticker_to_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to add a new " +#~ "sticker to a set created by the" +#~ " bot. You **must** use exactly one" +#~ " of the fields *png_sticker*, " +#~ "*tgs_sticker*, or *webm_sticker*. Animated " +#~ "stickers can be added to animated " +#~ "sticker sets and only to them. " +#~ "Animated sticker sets can have up " +#~ "to 50 stickers. Static sticker sets " +#~ "can have up to 120 stickers. " +#~ "Returns :code:`True` on success." +#~ msgstr "" + +#~ msgid "One or more emoji corresponding to the sticker" +#~ msgstr "" + +#~ msgid "" +#~ "**PNG** image with the sticker, must " +#~ "be up to 512 kilobytes in size," +#~ " dimensions must not exceed 512px, " +#~ "and either width or height must be" +#~ " exactly 512px. Pass a *file_id* as" +#~ " a String to send a file that" +#~ " already exists on the Telegram " +#~ "servers, pass an HTTP URL as a " +#~ "String for Telegram to get a file" +#~ " from the Internet, or upload a " +#~ "new one using multipart/form-data. " +#~ ":ref:`More information on Sending Files " +#~ "» `" +#~ msgstr "" + +#~ msgid "" +#~ "**TGS** animation with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#animated-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#animated-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "**WEBM** video with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#video-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#video-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "A JSON-serialized object for position" +#~ " where the mask should be placed " +#~ "on faces" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/create_new_sticker_set.po b/docs/locale/en/LC_MESSAGES/api/methods/create_new_sticker_set.po index 1d3789be..045ca8f0 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/create_new_sticker_set.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/create_new_sticker_set.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/create_new_sticker_set.rst:3 msgid "createNewStickerSet" @@ -28,9 +28,8 @@ msgstr "" #: aiogram.methods.create_new_sticker_set.CreateNewStickerSet:1 of msgid "" "Use this method to create a new sticker set owned by a user. The bot will" -" be able to edit the sticker set thus created. You **must** use exactly " -"one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. " -"Returns :code:`True` on success." +" be able to edit the sticker set thus created. Returns :code:`True` on " +"success." msgstr "" #: aiogram.methods.create_new_sticker_set.CreateNewStickerSet:3 of @@ -58,57 +57,35 @@ msgid "Sticker set title, 1-64 characters" msgstr "" #: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.emojis:1 of -msgid "One or more emoji corresponding to the sticker" +#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.stickers:1 of +msgid "" +"A JSON-serialized list of 1-50 initial stickers to be added to the " +"sticker set" msgstr "" #: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.png_sticker:1 of +#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.sticker_format:1 +#: of msgid "" -"**PNG** image with the sticker, must be up to 512 kilobytes in size, " -"dimensions must not exceed 512px, and either width or height must be " -"exactly 512px. Pass a *file_id* as a String to send a file that already " -"exists on the Telegram servers, pass an HTTP URL as a String for Telegram" -" to get a file from the Internet, or upload a new one using multipart" -"/form-data. :ref:`More information on Sending Files » `" -msgstr "" - -#: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.tgs_sticker:1 of -msgid "" -"**TGS** animation with the sticker, uploaded using multipart/form-data. " -"See `https://core.telegram.org/stickers#animated-sticker-requirements " -"`_`https://core.telegram.org/stickers#animated-sticker-" -"requirements `_ for technical requirements" -msgstr "" - -#: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.webm_sticker:1 of -msgid "" -"**WEBM** video with the sticker, uploaded using multipart/form-data. See " -"`https://core.telegram.org/stickers#video-sticker-requirements " -"`_`https://core.telegram.org/stickers#video-sticker-" -"requirements `_ for technical requirements" +"Format of stickers in the set, must be one of 'static', 'animated', " +"'video'" msgstr "" #: ../../docstring #: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.sticker_type:1 of msgid "" -"Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji " -"sticker sets can't be created via the Bot API at the moment. By default, " -"a regular sticker set is created." +"Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. " +"By default, a regular sticker set is created." msgstr "" #: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.mask_position:1 +#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.needs_repainting:1 #: of msgid "" -"A JSON-serialized object for position where the mask should be placed on " -"faces" +"Pass :code:`True` if stickers in the sticker set must be repainted to the" +" color of text when used in messages, the accent color if used as emoji " +"status, white on chat photos, or another appropriate color based on " +"context; for custom emoji sticker sets only" msgstr "" #: ../../api/methods/create_new_sticker_set.rst:14 @@ -144,3 +121,70 @@ msgstr "" #: ../../api/methods/create_new_sticker_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to create a new" +#~ " sticker set owned by a user. " +#~ "The bot will be able to edit " +#~ "the sticker set thus created. You " +#~ "**must** use exactly one of the " +#~ "fields *png_sticker*, *tgs_sticker*, or " +#~ "*webm_sticker*. Returns :code:`True` on " +#~ "success." +#~ msgstr "" + +#~ msgid "One or more emoji corresponding to the sticker" +#~ msgstr "" + +#~ msgid "" +#~ "**PNG** image with the sticker, must " +#~ "be up to 512 kilobytes in size," +#~ " dimensions must not exceed 512px, " +#~ "and either width or height must be" +#~ " exactly 512px. Pass a *file_id* as" +#~ " a String to send a file that" +#~ " already exists on the Telegram " +#~ "servers, pass an HTTP URL as a " +#~ "String for Telegram to get a file" +#~ " from the Internet, or upload a " +#~ "new one using multipart/form-data. " +#~ ":ref:`More information on Sending Files " +#~ "» `" +#~ msgstr "" + +#~ msgid "" +#~ "**TGS** animation with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#animated-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#animated-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "**WEBM** video with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#video-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#video-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "Type of stickers in the set, pass" +#~ " 'regular' or 'mask'. Custom emoji " +#~ "sticker sets can't be created via " +#~ "the Bot API at the moment. By " +#~ "default, a regular sticker set is " +#~ "created." +#~ msgstr "" + +#~ msgid "" +#~ "A JSON-serialized object for position" +#~ " where the mask should be placed " +#~ "on faces" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_set.po b/docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_set.po new file mode 100644 index 00000000..b0d56a23 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_set.po @@ -0,0 +1,73 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/delete_sticker_set.rst:3 +msgid "deleteStickerSet" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.delete_sticker_set.DeleteStickerSet:1 of +msgid "" +"Use this method to delete a sticker set that was created by the bot. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.delete_sticker_set.DeleteStickerSet:3 of +msgid "Source: https://core.telegram.org/bots/api#deletestickerset" +msgstr "" + +#: ../../docstring aiogram.methods.delete_sticker_set.DeleteStickerSet.name:1 +#: of +msgid "Sticker set name" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:29 +msgid ":code:`from aiogram.methods.delete_sticker_set import DeleteStickerSet`" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:30 +msgid "alias: :code:`from aiogram.methods import DeleteStickerSet`" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member.po b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member.po index f882bd5a..0f6b9c1b 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-01-07 23:01+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/get_chat_member.rst:3 msgid "getChatMember" @@ -31,9 +31,9 @@ msgstr "" #: aiogram.methods.get_chat_member.GetChatMember:1 of msgid "" "Use this method to get information about a member of a chat. The method " -"is guaranteed to work for other users, only if the bot is an " -"administrator in the chat. Returns a " -":class:`aiogram.types.chat_member.ChatMember` object on success." +"is only guaranteed to work for other users if the bot is an administrator" +" in the chat. Returns a :class:`aiogram.types.chat_member.ChatMember` " +"object on success." msgstr "" #: aiogram.methods.get_chat_member.GetChatMember:3 of @@ -85,3 +85,13 @@ msgstr "" #: ../../api/methods/get_chat_member.rst:45 msgid ":meth:`aiogram.types.chat.Chat.get_member`" msgstr "" + +#~ msgid "" +#~ "Use this method to get information " +#~ "about a member of a chat. The " +#~ "method is guaranteed to work for " +#~ "other users, only if the bot is" +#~ " an administrator in the chat. " +#~ "Returns a :class:`aiogram.types.chat_member.ChatMember`" +#~ " object on success." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/get_my_description.po b/docs/locale/en/LC_MESSAGES/api/methods/get_my_description.po new file mode 100644 index 00000000..b7ae81ab --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/get_my_description.po @@ -0,0 +1,70 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/get_my_description.rst:3 +msgid "getMyDescription" +msgstr "" + +#: ../../api/methods/get_my_description.rst:5 +msgid "Returns: :obj:`BotDescription`" +msgstr "" + +#: aiogram.methods.get_my_description.GetMyDescription:1 of +msgid "" +"Use this method to get the current bot description for the given user " +"language. Returns :class:`aiogram.types.bot_description.BotDescription` " +"on success." +msgstr "" + +#: aiogram.methods.get_my_description.GetMyDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#getmydescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.get_my_description.GetMyDescription.language_code:1 of +msgid "A two-letter ISO 639-1 language code or an empty string" +msgstr "" + +#: ../../api/methods/get_my_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/get_my_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/get_my_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/get_my_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/get_my_description.rst:29 +msgid ":code:`from aiogram.methods.get_my_description import GetMyDescription`" +msgstr "" + +#: ../../api/methods/get_my_description.rst:30 +msgid "alias: :code:`from aiogram.methods import GetMyDescription`" +msgstr "" + +#: ../../api/methods/get_my_description.rst:33 +msgid "With specific bot" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/get_my_short_description.po b/docs/locale/en/LC_MESSAGES/api/methods/get_my_short_description.po new file mode 100644 index 00000000..0d4e2e77 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/get_my_short_description.po @@ -0,0 +1,74 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/get_my_short_description.rst:3 +msgid "getMyShortDescription" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:5 +msgid "Returns: :obj:`BotShortDescription`" +msgstr "" + +#: aiogram.methods.get_my_short_description.GetMyShortDescription:1 of +msgid "" +"Use this method to get the current bot short description for the given " +"user language. Returns " +":class:`aiogram.types.bot_short_description.BotShortDescription` on " +"success." +msgstr "" + +#: aiogram.methods.get_my_short_description.GetMyShortDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#getmyshortdescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.get_my_short_description.GetMyShortDescription.language_code:1 +#: of +msgid "A two-letter ISO 639-1 language code or an empty string" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:29 +msgid "" +":code:`from aiogram.methods.get_my_short_description import " +"GetMyShortDescription`" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:30 +msgid "alias: :code:`from aiogram.methods import GetMyShortDescription`" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:33 +msgid "With specific bot" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/promote_chat_member.po b/docs/locale/en/LC_MESSAGES/api/methods/promote_chat_member.po index 2d9c0978..04ff8a9f 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/promote_chat_member.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/promote_chat_member.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/promote_chat_member.rst:3 msgid "promoteChatMember" @@ -102,7 +102,7 @@ msgstr "" #: of msgid "" "Pass :code:`True` if the administrator can add new administrators with a " -"subset of their own privileges or demote administrators that he has " +"subset of their own privileges or demote administrators that they have " "promoted, directly or indirectly (promoted by administrators that were " "appointed by him)" msgstr "" @@ -170,3 +170,13 @@ msgstr "" #: ../../api/methods/promote_chat_member.rst:50 msgid ":meth:`aiogram.types.chat.Chat.promote`" msgstr "" + +#~ msgid "" +#~ "Pass :code:`True` if the administrator " +#~ "can add new administrators with a " +#~ "subset of their own privileges or " +#~ "demote administrators that he has " +#~ "promoted, directly or indirectly (promoted " +#~ "by administrators that were appointed by" +#~ " him)" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/restrict_chat_member.po b/docs/locale/en/LC_MESSAGES/api/methods/restrict_chat_member.po index 9c0755b7..5bc53fcb 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/restrict_chat_member.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/restrict_chat_member.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/restrict_chat_member.rst:3 msgid "restrictChatMember" @@ -54,6 +54,19 @@ msgstr "" msgid "A JSON-serialized object for new user permissions" msgstr "" +#: ../../docstring +#: aiogram.methods.restrict_chat_member.RestrictChatMember.use_independent_chat_permissions:1 +#: of +msgid "" +"Pass :code:`True` if chat permissions are set independently. Otherwise, " +"the *can_send_other_messages* and *can_add_web_page_previews* permissions" +" will imply the *can_send_messages*, *can_send_audios*, " +"*can_send_documents*, *can_send_photos*, *can_send_videos*, " +"*can_send_video_notes*, and *can_send_voice_notes* permissions; the " +"*can_send_polls* permission will imply the *can_send_messages* " +"permission." +msgstr "" + #: ../../docstring #: aiogram.methods.restrict_chat_member.RestrictChatMember.until_date:1 of msgid "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_sticker.po b/docs/locale/en/LC_MESSAGES/api/methods/send_sticker.po index b1e8bcb0..24650fbd 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_sticker.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_sticker.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/send_sticker.rst:3 msgid "sendSticker" @@ -48,9 +48,10 @@ msgstr "" msgid "" "Sticker to send. Pass a file_id as String to send a file that exists on " "the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a .WEBP file from the Internet, or upload a new one using" -" multipart/form-data. :ref:`More information on Sending Files » `" +"Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP " +"or .TGS sticker using multipart/form-data. :ref:`More information on " +"Sending Files » `. Video stickers can only be sent by a " +"file_id. Animated stickers can't be sent via an HTTP URL." msgstr "" #: ../../docstring aiogram.methods.send_sticker.SendSticker.message_thread_id:1 @@ -60,6 +61,10 @@ msgid "" " forum supergroups only" msgstr "" +#: ../../docstring aiogram.methods.send_sticker.SendSticker.emoji:1 of +msgid "Emoji associated with the sticker; only for just uploaded stickers" +msgstr "" + #: ../../docstring #: aiogram.methods.send_sticker.SendSticker.disable_notification:1 of msgid "" @@ -147,3 +152,15 @@ msgstr "" #~ "to remove reply keyboard or to " #~ "force a reply from the user." #~ msgstr "" + +#~ msgid "" +#~ "Sticker to send. Pass a file_id as" +#~ " String to send a file that " +#~ "exists on the Telegram servers " +#~ "(recommended), pass an HTTP URL as " +#~ "a String for Telegram to get a " +#~ ".WEBP file from the Internet, or " +#~ "upload a new one using multipart" +#~ "/form-data. :ref:`More information on " +#~ "Sending Files » `" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_permissions.po b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_permissions.po index d27d7878..ff34fff6 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_permissions.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_permissions.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/set_chat_permissions.rst:3 msgid "setChatPermissions" @@ -49,6 +49,19 @@ msgstr "" msgid "A JSON-serialized object for new default chat permissions" msgstr "" +#: ../../docstring +#: aiogram.methods.set_chat_permissions.SetChatPermissions.use_independent_chat_permissions:1 +#: of +msgid "" +"Pass :code:`True` if chat permissions are set independently. Otherwise, " +"the *can_send_other_messages* and *can_add_web_page_previews* permissions" +" will imply the *can_send_messages*, *can_send_audios*, " +"*can_send_documents*, *can_send_photos*, *can_send_videos*, " +"*can_send_video_notes*, and *can_send_voice_notes* permissions; the " +"*can_send_polls* permission will imply the *can_send_messages* " +"permission." +msgstr "" + #: ../../api/methods/set_chat_permissions.rst:14 msgid "Usage" msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po b/docs/locale/en/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po new file mode 100644 index 00000000..afadc9a2 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po @@ -0,0 +1,90 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:3 +msgid "setCustomEmojiStickerSetThumbnail" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail:1 +#: of +msgid "" +"Use this method to set the thumbnail of a custom emoji sticker set. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail:3 +#: of +msgid "" +"Source: " +"https://core.telegram.org/bots/api#setcustomemojistickersetthumbnail" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail.name:1 +#: of +msgid "Sticker set name" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail.custom_emoji_id:1 +#: of +msgid "" +"Custom emoji identifier of a sticker from the sticker set; pass an empty " +"string to drop the thumbnail and use the first sticker as the thumbnail." +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:29 +msgid "" +":code:`from aiogram.methods.set_custom_emoji_sticker_set_thumbnail import" +" SetCustomEmojiStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:30 +msgid "" +"alias: :code:`from aiogram.methods import " +"SetCustomEmojiStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po b/docs/locale/en/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po index 93f19f31..87382f51 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/set_my_default_administrator_rights.rst:3 msgid "setMyDefaultAdministratorRights" @@ -30,8 +30,8 @@ msgstr "" msgid "" "Use this method to change the default administrator rights requested by " "the bot when it's added as an administrator to groups or channels. These " -"rights will be suggested to users, but they are are free to modify the " -"list before adding the bot. Returns :code:`True` on success." +"rights will be suggested to users, but they are free to modify the list " +"before adding the bot. Returns :code:`True` on success." msgstr "" #: aiogram.methods.set_my_default_administrator_rights.SetMyDefaultAdministratorRights:3 @@ -89,3 +89,14 @@ msgstr "" #: ../../api/methods/set_my_default_administrator_rights.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to change the " +#~ "default administrator rights requested by " +#~ "the bot when it's added as an " +#~ "administrator to groups or channels. " +#~ "These rights will be suggested to " +#~ "users, but they are are free to" +#~ " modify the list before adding the" +#~ " bot. Returns :code:`True` on success." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_my_description.po b/docs/locale/en/LC_MESSAGES/api/methods/set_my_description.po new file mode 100644 index 00000000..b266de07 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_my_description.po @@ -0,0 +1,83 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_my_description.rst:3 +msgid "setMyDescription" +msgstr "" + +#: ../../api/methods/set_my_description.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_my_description.SetMyDescription:1 of +msgid "" +"Use this method to change the bot's description, which is shown in the " +"chat with the bot if the chat is empty. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_my_description.SetMyDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#setmydescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_description.SetMyDescription.description:1 of +msgid "" +"New bot description; 0-512 characters. Pass an empty string to remove the" +" dedicated description for the given language." +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_description.SetMyDescription.language_code:1 of +msgid "" +"A two-letter ISO 639-1 language code. If empty, the description will be " +"applied to all users for whose language there is no dedicated " +"description." +msgstr "" + +#: ../../api/methods/set_my_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_my_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_my_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_my_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_my_description.rst:29 +msgid ":code:`from aiogram.methods.set_my_description import SetMyDescription`" +msgstr "" + +#: ../../api/methods/set_my_description.rst:30 +msgid "alias: :code:`from aiogram.methods import SetMyDescription`" +msgstr "" + +#: ../../api/methods/set_my_description.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_my_description.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_my_short_description.po b/docs/locale/en/LC_MESSAGES/api/methods/set_my_short_description.po new file mode 100644 index 00000000..eb4e343b --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_my_short_description.po @@ -0,0 +1,88 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_my_short_description.rst:3 +msgid "setMyShortDescription" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_my_short_description.SetMyShortDescription:1 of +msgid "" +"Use this method to change the bot's short description, which is shown on " +"the bot's profile page and is sent together with the link when users " +"share the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_my_short_description.SetMyShortDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#setmyshortdescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_short_description.SetMyShortDescription.short_description:1 +#: of +msgid "" +"New short description for the bot; 0-120 characters. Pass an empty string" +" to remove the dedicated short description for the given language." +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_short_description.SetMyShortDescription.language_code:1 +#: of +msgid "" +"A two-letter ISO 639-1 language code. If empty, the short description " +"will be applied to all users for whose language there is no dedicated " +"short description." +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:29 +msgid "" +":code:`from aiogram.methods.set_my_short_description import " +"SetMyShortDescription`" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:30 +msgid "alias: :code:`from aiogram.methods import SetMyShortDescription`" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_emoji_list.po b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_emoji_list.po new file mode 100644 index 00000000..ad3536b3 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_emoji_list.po @@ -0,0 +1,81 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_emoji_list.rst:3 +msgid "setStickerEmojiList" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList:1 of +msgid "" +"Use this method to change the list of emoji assigned to a regular or " +"custom emoji sticker. The sticker must belong to a sticker set created by" +" the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickeremojilist" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList.sticker:1 of +msgid "File identifier of the sticker" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList.emoji_list:1 of +msgid "A JSON-serialized list of 1-20 emoji associated with the sticker" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_emoji_list import " +"SetStickerEmojiList`" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerEmojiList`" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_keywords.po b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_keywords.po new file mode 100644 index 00000000..22dfb120 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_keywords.po @@ -0,0 +1,83 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_keywords.rst:3 +msgid "setStickerKeywords" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords:1 of +msgid "" +"Use this method to change search keywords assigned to a regular or custom" +" emoji sticker. The sticker must belong to a sticker set created by the " +"bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickerkeywords" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords.sticker:1 of +msgid "File identifier of the sticker" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords.keywords:1 of +msgid "" +"A JSON-serialized list of 0-20 search keywords for the sticker with total" +" length of up to 64 characters" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_keywords import " +"SetStickerKeywords`" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerKeywords`" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_mask_position.po b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_mask_position.po new file mode 100644 index 00000000..8efc08ba --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_mask_position.po @@ -0,0 +1,86 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_mask_position.rst:3 +msgid "setStickerMaskPosition" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition:1 of +msgid "" +"Use this method to change the `mask position " +"`_ of a mask sticker. " +"The sticker must belong to a sticker set that was created by the bot. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickermaskposition" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition.sticker:1 +#: of +msgid "File identifier of the sticker" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition.mask_position:1 +#: of +msgid "" +"A JSON-serialized object with the position where the mask should be " +"placed on faces. Omit the parameter to remove the mask position." +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_mask_position import " +"SetStickerMaskPosition`" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerMaskPosition`" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumb.po b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumb.po index cb1608e8..8e279db0 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumb.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumb.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/set_sticker_set_thumb.rst:3 msgid "setStickerSetThumb" @@ -25,52 +25,6 @@ msgstr "" msgid "Returns: :obj:`bool`" msgstr "" -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb:1 of -msgid "" -"Use this method to set the thumbnail of a sticker set. Animated " -"thumbnails can be set for animated sticker sets only. Video thumbnails " -"can be set only for video sticker sets only. Returns :code:`True` on " -"success." -msgstr "" - -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb:3 of -msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" -msgstr "" - -#: ../../docstring -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb.name:1 of -msgid "Sticker set name" -msgstr "" - -#: ../../docstring -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb.user_id:1 of -msgid "User identifier of the sticker set owner" -msgstr "" - -#: ../../docstring -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb.thumb:1 of -msgid "" -"A **PNG** image with the thumbnail, must be up to 128 kilobytes in size " -"and have width and height exactly 100px, or a **TGS** animation with the " -"thumbnail up to 32 kilobytes in size; see " -"`https://core.telegram.org/stickers#animated-sticker-requirements " -"`_`https://core.telegram.org/stickers#animated-sticker-" -"requirements `_ for animated sticker technical requirements, or a " -"**WEBM** video with the thumbnail up to 32 kilobytes in size; see " -"`https://core.telegram.org/stickers#video-sticker-requirements " -"`_`https://core.telegram.org/stickers#video-sticker-" -"requirements `_ for video sticker technical requirements. Pass a " -"*file_id* as a String to send a file that already exists on the Telegram " -"servers, pass an HTTP URL as a String for Telegram to get a file from the" -" Internet, or upload a new one using multipart/form-data. :ref:`More " -"information on Sending Files » `. Animated sticker set " -"thumbnails can't be uploaded via HTTP URL." -msgstr "" - #: ../../api/methods/set_sticker_set_thumb.rst:14 msgid "Usage" msgstr "" @@ -104,3 +58,57 @@ msgstr "" #: ../../api/methods/set_sticker_set_thumb.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to set the " +#~ "thumbnail of a sticker set. Animated " +#~ "thumbnails can be set for animated " +#~ "sticker sets only. Video thumbnails can" +#~ " be set only for video sticker " +#~ "sets only. Returns :code:`True` on " +#~ "success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" +#~ msgstr "" + +#~ msgid "Sticker set name" +#~ msgstr "" + +#~ msgid "User identifier of the sticker set owner" +#~ msgstr "" + +#~ msgid "" +#~ "A **PNG** image with the thumbnail, " +#~ "must be up to 128 kilobytes in " +#~ "size and have width and height " +#~ "exactly 100px, or a **TGS** animation" +#~ " with the thumbnail up to 32 " +#~ "kilobytes in size; see " +#~ "`https://core.telegram.org/stickers#animated-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#animated-sticker-requirements " +#~ "`_ for animated sticker technical" +#~ " requirements, or a **WEBM** video " +#~ "with the thumbnail up to 32 " +#~ "kilobytes in size; see " +#~ "`https://core.telegram.org/stickers#video-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#video-sticker-requirements " +#~ "`_ for video sticker technical" +#~ " requirements. Pass a *file_id* as a" +#~ " String to send a file that " +#~ "already exists on the Telegram servers," +#~ " pass an HTTP URL as a String" +#~ " for Telegram to get a file " +#~ "from the Internet, or upload a new" +#~ " one using multipart/form-data. :ref:`More" +#~ " information on Sending Files » " +#~ "`. Animated sticker set " +#~ "thumbnails can't be uploaded via HTTP" +#~ " URL." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po new file mode 100644 index 00000000..c0d9b5ee --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po @@ -0,0 +1,108 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:3 +msgid "setStickerSetThumbnail" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail:1 of +msgid "" +"Use this method to set the thumbnail of a regular or mask sticker set. " +"The format of the thumbnail file must match the format of the stickers in" +" the set. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickersetthumbnail" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail.name:1 of +msgid "Sticker set name" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail.user_id:1 +#: of +msgid "User identifier of the sticker set owner" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail.thumbnail:1 +#: of +msgid "" +"A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 " +"kilobytes in size and have a width and height of exactly 100px, or a " +"**.TGS** animation with a thumbnail up to 32 kilobytes in size (see " +"`https://core.telegram.org/stickers#animated-sticker-requirements " +"`_`https://core.telegram.org/stickers#animated-sticker-" +"requirements `_ for animated sticker technical requirements), or a " +"**WEBM** video with the thumbnail up to 32 kilobytes in size; see " +"`https://core.telegram.org/stickers#video-sticker-requirements " +"`_`https://core.telegram.org/stickers#video-sticker-" +"requirements `_ for video sticker technical requirements. Pass a " +"*file_id* as a String to send a file that already exists on the Telegram " +"servers, pass an HTTP URL as a String for Telegram to get a file from the" +" Internet, or upload a new one using multipart/form-data. :ref:`More " +"information on Sending Files » `. Animated and video " +"sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then " +"the thumbnail is dropped and the first sticker is used as the thumbnail." +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_set_thumbnail import " +"SetStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_title.po b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_title.po new file mode 100644 index 00000000..fb27fdfc --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_set_title.po @@ -0,0 +1,80 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_set_title.rst:3 +msgid "setStickerSetTitle" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle:1 of +msgid "" +"Use this method to set the title of a created sticker set. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickersettitle" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle.name:1 of +msgid "Sticker set name" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle.title:1 of +msgid "Sticker set title, 1-64 characters" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_set_title import " +"SetStickerSetTitle`" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerSetTitle`" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/upload_sticker_file.po b/docs/locale/en/LC_MESSAGES/api/methods/upload_sticker_file.po index 5a9d256a..4e909bd1 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/upload_sticker_file.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/upload_sticker_file.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/upload_sticker_file.rst:3 msgid "uploadStickerFile" @@ -27,10 +27,11 @@ msgstr "" #: aiogram.methods.upload_sticker_file.UploadStickerFile:1 of msgid "" -"Use this method to upload a .PNG file with a sticker for later use in " -"*createNewStickerSet* and *addStickerToSet* methods (can be used multiple" -" times). Returns the uploaded :class:`aiogram.types.file.File` on " -"success." +"Use this method to upload a file with a sticker for later use in the " +":class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and " +":class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the " +"file can be used multiple times). Returns the uploaded " +":class:`aiogram.types.file.File` on success." msgstr "" #: aiogram.methods.upload_sticker_file.UploadStickerFile:3 of @@ -43,11 +44,18 @@ msgid "User identifier of sticker file owner" msgstr "" #: ../../docstring -#: aiogram.methods.upload_sticker_file.UploadStickerFile.png_sticker:1 of +#: aiogram.methods.upload_sticker_file.UploadStickerFile.sticker:1 of msgid "" -"**PNG** image with the sticker, must be up to 512 kilobytes in size, " -"dimensions must not exceed 512px, and either width or height must be " -"exactly 512px. :ref:`More information on Sending Files » `" +"A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See " +"`https://core.telegram.org/stickers " +"`_`https://core.telegram.org/stickers" +" `_ for technical requirements. " +":ref:`More information on Sending Files » `" +msgstr "" + +#: ../../docstring +#: aiogram.methods.upload_sticker_file.UploadStickerFile.sticker_format:1 of +msgid "Format of the sticker, must be one of 'static', 'animated', 'video'" msgstr "" #: ../../api/methods/upload_sticker_file.rst:14 @@ -77,3 +85,21 @@ msgstr "" #: ../../api/methods/upload_sticker_file.rst:33 msgid "With specific bot" msgstr "" + +#~ msgid "" +#~ "Use this method to upload a .PNG" +#~ " file with a sticker for later " +#~ "use in *createNewStickerSet* and " +#~ "*addStickerToSet* methods (can be used " +#~ "multiple times). Returns the uploaded " +#~ ":class:`aiogram.types.file.File` on success." +#~ msgstr "" + +#~ msgid "" +#~ "**PNG** image with the sticker, must " +#~ "be up to 512 kilobytes in size," +#~ " dimensions must not exceed 512px, " +#~ "and either width or height must be" +#~ " exactly 512px. :ref:`More information on" +#~ " Sending Files » `" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/bot_description.po b/docs/locale/en/LC_MESSAGES/api/types/bot_description.po new file mode 100644 index 00000000..2f295229 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/bot_description.po @@ -0,0 +1,35 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/bot_description.rst:3 +msgid "BotDescription" +msgstr "" + +#: aiogram.types.bot_description.BotDescription:1 of +msgid "This object represents the bot's description." +msgstr "" + +#: aiogram.types.bot_description.BotDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#botdescription" +msgstr "" + +#: ../../docstring aiogram.types.bot_description.BotDescription.description:1 +#: of +msgid "The bot's description" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/bot_short_description.po b/docs/locale/en/LC_MESSAGES/api/types/bot_short_description.po new file mode 100644 index 00000000..8855dc52 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/bot_short_description.po @@ -0,0 +1,36 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/bot_short_description.rst:3 +msgid "BotShortDescription" +msgstr "" + +#: aiogram.types.bot_short_description.BotShortDescription:1 of +msgid "This object represents the bot's short description." +msgstr "" + +#: aiogram.types.bot_short_description.BotShortDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#botshortdescription" +msgstr "" + +#: ../../docstring +#: aiogram.types.bot_short_description.BotShortDescription.short_description:1 +#: of +msgid "The bot's short description" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat.po b/docs/locale/en/LC_MESSAGES/api/types/chat.po index c0f95110..05363683 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-01-07 23:01+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/chat.rst:3 msgid "Chat" @@ -733,9 +733,9 @@ msgstr "" #: aiogram.types.chat.Chat.get_member:6 of msgid "" "Use this method to get information about a member of a chat. The method " -"is guaranteed to work for other users, only if the bot is an " -"administrator in the chat. Returns a " -":class:`aiogram.types.chat_member.ChatMember` object on success." +"is only guaranteed to work for other users if the bot is an administrator" +" in the chat. Returns a :class:`aiogram.types.chat_member.ChatMember` " +"object on success." msgstr "" #: aiogram.types.chat.Chat.get_member:8 of @@ -944,8 +944,20 @@ msgstr "" msgid "A JSON-serialized object for new default chat permissions" msgstr "" +#: aiogram.types.chat.Chat.restrict:12 #: aiogram.types.chat.Chat.set_permissions:11 of msgid "" +"Pass :code:`True` if chat permissions are set independently. Otherwise, " +"the *can_send_other_messages* and *can_add_web_page_previews* permissions" +" will imply the *can_send_messages*, *can_send_audios*, " +"*can_send_documents*, *can_send_photos*, *can_send_videos*, " +"*can_send_video_notes*, and *can_send_voice_notes* permissions; the " +"*can_send_polls* permission will imply the *can_send_messages* " +"permission." +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:12 of +msgid "" "instance of method " ":class:`aiogram.methods.set_chat_permissions.SetChatPermissions`" msgstr "" @@ -1010,7 +1022,7 @@ msgstr "" #: aiogram.types.chat.Chat.promote:18 of msgid "" "Pass :code:`True` if the administrator can add new administrators with a " -"subset of their own privileges or demote administrators that he has " +"subset of their own privileges or demote administrators that they have " "promoted, directly or indirectly (promoted by administrators that were " "appointed by him)" msgstr "" @@ -1064,14 +1076,14 @@ msgstr "" msgid "A JSON-serialized object for new user permissions" msgstr "" -#: aiogram.types.chat.Chat.restrict:12 of +#: aiogram.types.chat.Chat.restrict:13 of msgid "" "Date when restrictions will be lifted for the user, unix time. If user is" " restricted for more than 366 days or less than 30 seconds from the " "current time, they are considered to be restricted forever" msgstr "" -#: aiogram.types.chat.Chat.restrict:13 of +#: aiogram.types.chat.Chat.restrict:14 of msgid "" "instance of method " ":class:`aiogram.methods.restrict_chat_member.RestrictChatMember`" @@ -1256,3 +1268,23 @@ msgstr "" #: aiogram.types.chat.Chat.set_photo:11 of msgid "instance of method :class:`aiogram.methods.set_chat_photo.SetChatPhoto`" msgstr "" + +#~ msgid "" +#~ "Use this method to get information " +#~ "about a member of a chat. The " +#~ "method is guaranteed to work for " +#~ "other users, only if the bot is" +#~ " an administrator in the chat. " +#~ "Returns a :class:`aiogram.types.chat_member.ChatMember`" +#~ " object on success." +#~ msgstr "" + +#~ msgid "" +#~ "Pass :code:`True` if the administrator " +#~ "can add new administrators with a " +#~ "subset of their own privileges or " +#~ "demote administrators that he has " +#~ "promoted, directly or indirectly (promoted " +#~ "by administrators that were appointed by" +#~ " him)" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat_administrator_rights.po b/docs/locale/en/LC_MESSAGES/api/types/chat_administrator_rights.po index e792b43d..fc696d31 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat_administrator_rights.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_administrator_rights.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-06 14:18+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/chat_administrator_rights.rst:3 msgid "ChatAdministratorRights" @@ -68,7 +68,7 @@ msgstr "" #: of msgid "" ":code:`True`, if the administrator can add new administrators with a " -"subset of their own privileges or demote administrators that he has " +"subset of their own privileges or demote administrators that they have " "promoted, directly or indirectly (promoted by administrators that were " "appointed by the user)" msgstr "" @@ -118,3 +118,13 @@ msgid "" "*Optional*. :code:`True`, if the user is allowed to create, rename, " "close, and reopen forum topics; supergroups only" msgstr "" + +#~ msgid "" +#~ ":code:`True`, if the administrator can " +#~ "add new administrators with a subset " +#~ "of their own privileges or demote " +#~ "administrators that he has promoted, " +#~ "directly or indirectly (promoted by " +#~ "administrators that were appointed by " +#~ "the user)" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat_join_request.po b/docs/locale/en/LC_MESSAGES/api/types/chat_join_request.po index 0349c899..f1035f20 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat_join_request.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_join_request.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/chat_join_request.rst:3 msgid "ChatJoinRequest" @@ -38,6 +38,18 @@ msgstr "" msgid "User that sent the join request" msgstr "" +#: ../../docstring +#: aiogram.types.chat_join_request.ChatJoinRequest.user_chat_id:1 of +msgid "" +"Identifier of a private chat with the user who sent the join request. " +"This number may have more than 32 significant bits and some programming " +"languages may have difficulty/silent defects in interpreting it. But it " +"has at most 52 significant bits, so a 64-bit integer or double-precision " +"float type are safe for storing this identifier. The bot can use this " +"identifier for 24 hours to send messages until the join request is " +"processed, assuming no other administrator contacted the user." +msgstr "" + #: ../../docstring aiogram.types.chat_join_request.ChatJoinRequest.date:1 of msgid "Date the request was sent in Unix time" msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat_member.po b/docs/locale/en/LC_MESSAGES/api/types/chat_member.po index 87fe2331..6c775a80 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat_member.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_member.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/chat_member.rst:3 msgid "ChatMember" @@ -108,8 +108,8 @@ msgstr "" #: of msgid "" "*Optional*. :code:`True`, if the administrator can add new administrators" -" with a subset of their own privileges or demote administrators that he " -"has promoted, directly or indirectly (promoted by administrators that " +" with a subset of their own privileges or demote administrators that they" +" have promoted, directly or indirectly (promoted by administrators that " "were appointed by the user)" msgstr "" @@ -158,14 +158,33 @@ msgstr "" #: ../../docstring aiogram.types.chat_member.ChatMember.can_send_messages:1 of msgid "" "*Optional*. :code:`True`, if the user is allowed to send text messages, " -"contacts, locations and venues" +"contacts, invoices, locations and venues" msgstr "" -#: ../../docstring -#: aiogram.types.chat_member.ChatMember.can_send_media_messages:1 of -msgid "" -"*Optional*. :code:`True`, if the user is allowed to send audios, " -"documents, photos, videos, video notes and voice notes" +#: ../../docstring aiogram.types.chat_member.ChatMember.can_send_audios:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send audios" +msgstr "" + +#: ../../docstring aiogram.types.chat_member.ChatMember.can_send_documents:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send documents" +msgstr "" + +#: ../../docstring aiogram.types.chat_member.ChatMember.can_send_photos:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send photos" +msgstr "" + +#: ../../docstring aiogram.types.chat_member.ChatMember.can_send_videos:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send videos" +msgstr "" + +#: ../../docstring aiogram.types.chat_member.ChatMember.can_send_video_notes:1 +#: of +msgid "*Optional*. :code:`True`, if the user is allowed to send video notes" +msgstr "" + +#: ../../docstring aiogram.types.chat_member.ChatMember.can_send_voice_notes:1 +#: of +msgid "*Optional*. :code:`True`, if the user is allowed to send voice notes" msgstr "" #: ../../docstring aiogram.types.chat_member.ChatMember.can_send_polls:1 of @@ -194,3 +213,26 @@ msgstr "" #~ msgid "..." #~ msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the administrator" +#~ " can add new administrators with a" +#~ " subset of their own privileges or" +#~ " demote administrators that he has " +#~ "promoted, directly or indirectly (promoted " +#~ "by administrators that were appointed by" +#~ " the user)" +#~ msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the user is" +#~ " allowed to send text messages, " +#~ "contacts, locations and venues" +#~ msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the user is" +#~ " allowed to send audios, documents, " +#~ "photos, videos, video notes and voice" +#~ " notes" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat_member_administrator.po b/docs/locale/en/LC_MESSAGES/api/types/chat_member_administrator.po index 0045c783..9b51540f 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat_member_administrator.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_member_administrator.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-06 14:18+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/chat_member_administrator.rst:3 msgid "ChatMemberAdministrator" @@ -89,7 +89,7 @@ msgstr "" #: of msgid "" ":code:`True`, if the administrator can add new administrators with a " -"subset of their own privileges or demote administrators that he has " +"subset of their own privileges or demote administrators that they have " "promoted, directly or indirectly (promoted by administrators that were " "appointed by the user)" msgstr "" @@ -145,3 +145,13 @@ msgstr "" #: of msgid "*Optional*. Custom title for this user" msgstr "" + +#~ msgid "" +#~ ":code:`True`, if the administrator can " +#~ "add new administrators with a subset " +#~ "of their own privileges or demote " +#~ "administrators that he has promoted, " +#~ "directly or indirectly (promoted by " +#~ "administrators that were appointed by " +#~ "the user)" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat_member_restricted.po b/docs/locale/en/LC_MESSAGES/api/types/chat_member_restricted.po index 79784f6d..a0f2f184 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat_member_restricted.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_member_restricted.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-06 14:18+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/chat_member_restricted.rst:3 msgid "ChatMemberRestricted" @@ -49,6 +49,72 @@ msgid "" "request" msgstr "" +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_messages:1 +#: of +msgid "" +":code:`True`, if the user is allowed to send text messages, contacts, " +"invoices, locations and venues" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_audios:1 +#: of +msgid ":code:`True`, if the user is allowed to send audios" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_documents:1 +#: of +msgid ":code:`True`, if the user is allowed to send documents" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_photos:1 +#: of +msgid ":code:`True`, if the user is allowed to send photos" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_videos:1 +#: of +msgid ":code:`True`, if the user is allowed to send videos" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_video_notes:1 +#: of +msgid ":code:`True`, if the user is allowed to send video notes" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_voice_notes:1 +#: of +msgid ":code:`True`, if the user is allowed to send voice notes" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_polls:1 +#: of +msgid ":code:`True`, if the user is allowed to send polls" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_other_messages:1 +#: of +msgid "" +":code:`True`, if the user is allowed to send animations, games, stickers " +"and use inline bots" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_add_web_page_previews:1 +#: of +msgid "" +":code:`True`, if the user is allowed to add web page previews to their " +"messages" +msgstr "" + #: ../../docstring #: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_change_info:1 #: of @@ -75,47 +141,21 @@ msgstr "" msgid ":code:`True`, if the user is allowed to create forum topics" msgstr "" -#: ../../docstring -#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_messages:1 -#: of -msgid "" -":code:`True`, if the user is allowed to send text messages, contacts, " -"locations and venues" -msgstr "" - -#: ../../docstring -#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_media_messages:1 -#: of -msgid "" -":code:`True`, if the user is allowed to send audios, documents, photos, " -"videos, video notes and voice notes" -msgstr "" - -#: ../../docstring -#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_polls:1 -#: of -msgid ":code:`True`, if the user is allowed to send polls" -msgstr "" - -#: ../../docstring -#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_send_other_messages:1 -#: of -msgid "" -":code:`True`, if the user is allowed to send animations, games, stickers " -"and use inline bots" -msgstr "" - -#: ../../docstring -#: aiogram.types.chat_member_restricted.ChatMemberRestricted.can_add_web_page_previews:1 -#: of -msgid "" -":code:`True`, if the user is allowed to add web page previews to their " -"messages" -msgstr "" - #: ../../docstring #: aiogram.types.chat_member_restricted.ChatMemberRestricted.until_date:1 of msgid "" "Date when restrictions will be lifted for this user; unix time. If 0, " "then the user is restricted forever" msgstr "" + +#~ msgid "" +#~ ":code:`True`, if the user is allowed " +#~ "to send text messages, contacts, " +#~ "locations and venues" +#~ msgstr "" + +#~ msgid "" +#~ ":code:`True`, if the user is allowed " +#~ "to send audios, documents, photos, " +#~ "videos, video notes and voice notes" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat_permissions.po b/docs/locale/en/LC_MESSAGES/api/types/chat_permissions.po index d4bb052c..8dd59fb3 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat_permissions.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_permissions.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-06 14:18+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/chat_permissions.rst:3 msgid "ChatPermissions" @@ -35,29 +35,49 @@ msgstr "" #: aiogram.types.chat_permissions.ChatPermissions.can_send_messages:1 of msgid "" "*Optional*. :code:`True`, if the user is allowed to send text messages, " -"contacts, locations and venues" +"contacts, invoices, locations and venues" msgstr "" #: ../../docstring -#: aiogram.types.chat_permissions.ChatPermissions.can_send_media_messages:1 of -msgid "" -"*Optional*. :code:`True`, if the user is allowed to send audios, " -"documents, photos, videos, video notes and voice notes, implies " -"can_send_messages" +#: aiogram.types.chat_permissions.ChatPermissions.can_send_audios:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send audios" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_permissions.ChatPermissions.can_send_documents:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send documents" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_permissions.ChatPermissions.can_send_photos:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send photos" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_permissions.ChatPermissions.can_send_videos:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send videos" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_permissions.ChatPermissions.can_send_video_notes:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send video notes" +msgstr "" + +#: ../../docstring +#: aiogram.types.chat_permissions.ChatPermissions.can_send_voice_notes:1 of +msgid "*Optional*. :code:`True`, if the user is allowed to send voice notes" msgstr "" #: ../../docstring #: aiogram.types.chat_permissions.ChatPermissions.can_send_polls:1 of -msgid "" -"*Optional*. :code:`True`, if the user is allowed to send polls, implies " -"can_send_messages" +msgid "*Optional*. :code:`True`, if the user is allowed to send polls" msgstr "" #: ../../docstring #: aiogram.types.chat_permissions.ChatPermissions.can_send_other_messages:1 of msgid "" "*Optional*. :code:`True`, if the user is allowed to send animations, " -"games, stickers and use inline bots, implies can_send_media_messages" +"games, stickers and use inline bots" msgstr "" #: ../../docstring @@ -65,7 +85,7 @@ msgstr "" #: of msgid "" "*Optional*. :code:`True`, if the user is allowed to add web page previews" -" to their messages, implies can_send_media_messages" +" to their messages" msgstr "" #: ../../docstring @@ -95,3 +115,36 @@ msgid "" "*Optional*. :code:`True`, if the user is allowed to create forum topics. " "If omitted defaults to the value of can_pin_messages" msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the user is" +#~ " allowed to send text messages, " +#~ "contacts, locations and venues" +#~ msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the user is" +#~ " allowed to send audios, documents, " +#~ "photos, videos, video notes and voice" +#~ " notes, implies can_send_messages" +#~ msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the user is" +#~ " allowed to send polls, implies " +#~ "can_send_messages" +#~ msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the user is" +#~ " allowed to send animations, games, " +#~ "stickers and use inline bots, implies" +#~ " can_send_media_messages" +#~ msgstr "" + +#~ msgid "" +#~ "*Optional*. :code:`True`, if the user is" +#~ " allowed to add web page previews " +#~ "to their messages, implies " +#~ "can_send_media_messages" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat_shared.po b/docs/locale/en/LC_MESSAGES/api/types/chat_shared.po new file mode 100644 index 00000000..def83f98 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_shared.po @@ -0,0 +1,49 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/chat_shared.rst:3 +msgid "ChatShared" +msgstr "" + +#: aiogram.types.chat_shared.ChatShared:1 of +msgid "" +"This object contains information about the chat whose identifier was " +"shared with the bot using a " +":class:`aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat`" +" button." +msgstr "" + +#: aiogram.types.chat_shared.ChatShared:3 of +msgid "Source: https://core.telegram.org/bots/api#chatshared" +msgstr "" + +#: ../../docstring aiogram.types.chat_shared.ChatShared.request_id:1 of +msgid "Identifier of the request" +msgstr "" + +#: ../../docstring aiogram.types.chat_shared.ChatShared.chat_id:1 of +msgid "" +"Identifier of the shared chat. This number may have more than 32 " +"significant bits and some programming languages may have " +"difficulty/silent defects in interpreting it. But it has at most 52 " +"significant bits, so a 64-bit integer or double-precision float type are " +"safe for storing this identifier. The bot may not have access to the chat" +" and could be unable to use this identifier, unless the chat is already " +"known to the bot by some other means." +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/input_sticker.po b/docs/locale/en/LC_MESSAGES/api/types/input_sticker.po new file mode 100644 index 00000000..3bbc8b33 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/input_sticker.po @@ -0,0 +1,56 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/input_sticker.rst:3 +msgid "InputSticker" +msgstr "" + +#: aiogram.types.input_sticker.InputSticker:1 of +msgid "This object describes a sticker to be added to a sticker set." +msgstr "" + +#: aiogram.types.input_sticker.InputSticker:3 of +msgid "Source: https://core.telegram.org/bots/api#inputsticker" +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.sticker:1 of +msgid "" +"The added sticker. Pass a *file_id* as a String to send a file that " +"already exists on the Telegram servers, pass an HTTP URL as a String for " +"Telegram to get a file from the Internet, or upload a new one using " +"multipart/form-data. Animated and video stickers can't be uploaded via " +"HTTP URL. :ref:`More information on Sending Files » `" +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.emoji_list:1 of +msgid "List of 1-20 emoji associated with the sticker" +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.mask_position:1 of +msgid "" +"*Optional*. Position where the mask should be placed on faces. For 'mask'" +" stickers only." +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.keywords:1 of +msgid "" +"*Optional*. List of 0-20 search keywords for the sticker with total " +"length of up to 64 characters. For 'regular' and 'custom_emoji' stickers " +"only." +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/keyboard_button.po b/docs/locale/en/LC_MESSAGES/api/types/keyboard_button.po index 8a0ad540..a2578af9 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/keyboard_button.po +++ b/docs/locale/en/LC_MESSAGES/api/types/keyboard_button.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/keyboard_button.rst:3 msgid "KeyboardButton" @@ -24,12 +24,12 @@ msgstr "" #: aiogram.types.keyboard_button.KeyboardButton:1 of msgid "" "This object represents one button of the reply keyboard. For simple text " -"buttons *String* can be used instead of this object to specify text of " -"the button. Optional fields *web_app*, *request_contact*, " -"*request_location*, and *request_poll* are mutually exclusive. **Note:** " -"*request_contact* and *request_location* options will only work in " -"Telegram versions released after 9 April, 2016. Older clients will " -"display *unsupported message*." +"buttons, *String* can be used instead of this object to specify the " +"button text. The optional fields *web_app*, *request_user*, " +"*request_chat*, *request_contact*, *request_location*, and *request_poll*" +" are mutually exclusive. **Note:** *request_contact* and " +"*request_location* options will only work in Telegram versions released " +"after 9 April, 2016. Older clients will display *unsupported message*." msgstr "" #: aiogram.types.keyboard_button.KeyboardButton:4 of @@ -46,6 +46,13 @@ msgid "" msgstr "" #: aiogram.types.keyboard_button.KeyboardButton:8 of +msgid "" +"**Note:** *request_user* and *request_chat* options will only work in " +"Telegram versions released after 3 February, 2023. Older clients will " +"display *unsupported message*." +msgstr "" + +#: aiogram.types.keyboard_button.KeyboardButton:10 of msgid "Source: https://core.telegram.org/bots/api#keyboardbutton" msgstr "" @@ -55,6 +62,22 @@ msgid "" "sent as a message when the button is pressed" msgstr "" +#: ../../docstring aiogram.types.keyboard_button.KeyboardButton.request_user:1 +#: of +msgid "" +"*Optional.* If specified, pressing the button will open a list of " +"suitable users. Tapping on any user will send their identifier to the bot" +" in a 'user_shared' service message. Available in private chats only." +msgstr "" + +#: ../../docstring aiogram.types.keyboard_button.KeyboardButton.request_chat:1 +#: of +msgid "" +"*Optional.* If specified, pressing the button will open a list of " +"suitable chats. Tapping on a chat will send its identifier to the bot in " +"a 'chat_shared' service message. Available in private chats only." +msgstr "" + #: ../../docstring #: aiogram.types.keyboard_button.KeyboardButton.request_contact:1 of msgid "" @@ -84,3 +107,18 @@ msgid "" "button is pressed. The Web App will be able to send a 'web_app_data' " "service message. Available in private chats only." msgstr "" + +#~ msgid "" +#~ "This object represents one button of " +#~ "the reply keyboard. For simple text " +#~ "buttons *String* can be used instead " +#~ "of this object to specify text of" +#~ " the button. Optional fields *web_app*, " +#~ "*request_contact*, *request_location*, and " +#~ "*request_poll* are mutually exclusive. " +#~ "**Note:** *request_contact* and *request_location*" +#~ " options will only work in Telegram" +#~ " versions released after 9 April, " +#~ "2016. Older clients will display " +#~ "*unsupported message*." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_chat.po b/docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_chat.po new file mode 100644 index 00000000..69f4736f --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_chat.po @@ -0,0 +1,104 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/keyboard_button_request_chat.rst:3 +msgid "KeyboardButtonRequestChat" +msgstr "" + +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat:1 of +msgid "" +"This object defines the criteria used to request a suitable chat. The " +"identifier of the selected chat will be shared with the bot when the " +"corresponding button is pressed." +msgstr "" + +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat:3 of +msgid "Source: https://core.telegram.org/bots/api#keyboardbuttonrequestchat" +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.request_id:1 +#: of +msgid "" +"Signed 32-bit identifier of the request, which will be received back in " +"the :class:`aiogram.types.chat_shared.ChatShared` object. Must be unique " +"within the message" +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.chat_is_channel:1 +#: of +msgid "" +"Pass :code:`True` to request a channel chat, pass :code:`False` to " +"request a group or a supergroup chat." +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.chat_is_forum:1 +#: of +msgid "" +"*Optional*. Pass :code:`True` to request a forum supergroup, pass " +":code:`False` to request a non-forum chat. If not specified, no " +"additional restrictions are applied." +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.chat_has_username:1 +#: of +msgid "" +"*Optional*. Pass :code:`True` to request a supergroup or a channel with a" +" username, pass :code:`False` to request a chat without a username. If " +"not specified, no additional restrictions are applied." +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.chat_is_created:1 +#: of +msgid "" +"*Optional*. Pass :code:`True` to request a chat owned by the user. " +"Otherwise, no additional restrictions are applied." +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.user_administrator_rights:1 +#: of +msgid "" +"*Optional*. A JSON-serialized object listing the required administrator " +"rights of the user in the chat. The rights must be a superset of " +"*bot_administrator_rights*. If not specified, no additional restrictions " +"are applied." +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.bot_administrator_rights:1 +#: of +msgid "" +"*Optional*. A JSON-serialized object listing the required administrator " +"rights of the bot in the chat. The rights must be a subset of " +"*user_administrator_rights*. If not specified, no additional restrictions" +" are applied." +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat.bot_is_member:1 +#: of +msgid "" +"*Optional*. Pass :code:`True` to request a chat with the bot as a member." +" Otherwise, no additional restrictions are applied." +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_user.po b/docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_user.po new file mode 100644 index 00000000..faf737b0 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/keyboard_button_request_user.po @@ -0,0 +1,60 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/keyboard_button_request_user.rst:3 +msgid "KeyboardButtonRequestUser" +msgstr "" + +#: aiogram.types.keyboard_button_request_user.KeyboardButtonRequestUser:1 of +msgid "" +"This object defines the criteria used to request a suitable user. The " +"identifier of the selected user will be shared with the bot when the " +"corresponding button is pressed." +msgstr "" + +#: aiogram.types.keyboard_button_request_user.KeyboardButtonRequestUser:3 of +msgid "Source: https://core.telegram.org/bots/api#keyboardbuttonrequestuser" +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_user.KeyboardButtonRequestUser.request_id:1 +#: of +msgid "" +"Signed 32-bit identifier of the request, which will be received back in " +"the :class:`aiogram.types.user_shared.UserShared` object. Must be unique " +"within the message" +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_user.KeyboardButtonRequestUser.user_is_bot:1 +#: of +msgid "" +"*Optional*. Pass :code:`True` to request a bot, pass :code:`False` to " +"request a regular user. If not specified, no additional restrictions are " +"applied." +msgstr "" + +#: ../../docstring +#: aiogram.types.keyboard_button_request_user.KeyboardButtonRequestUser.user_is_premium:1 +#: of +msgid "" +"*Optional*. Pass :code:`True` to request a premium user, pass " +":code:`False` to request a non-premium user. If not specified, no " +"additional restrictions are applied." +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/message.po b/docs/locale/en/LC_MESSAGES/api/types/message.po index 516aa013..b3f65085 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/message.po +++ b/docs/locale/en/LC_MESSAGES/api/types/message.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-30 22:28+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/message.rst:3 msgid "Message" @@ -328,6 +328,14 @@ msgid "" "`_" msgstr "" +#: ../../docstring aiogram.types.message.Message.user_shared:1 of +msgid "*Optional*. Service message: a user was shared with the bot" +msgstr "" + +#: ../../docstring aiogram.types.message.Message.chat_shared:1 of +msgid "*Optional*. Service message: a chat was shared with the bot" +msgstr "" + #: ../../docstring aiogram.types.message.Message.connected_website:1 of msgid "" "*Optional*. The domain name of the website on which the user has logged " @@ -671,7 +679,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:17 #: aiogram.types.message.Message.answer_photo:16 #: aiogram.types.message.Message.answer_poll:23 -#: aiogram.types.message.Message.answer_sticker:12 +#: aiogram.types.message.Message.answer_sticker:13 #: aiogram.types.message.Message.answer_venue:19 #: aiogram.types.message.Message.answer_video:21 #: aiogram.types.message.Message.answer_video_note:15 @@ -689,7 +697,7 @@ msgstr "" #: aiogram.types.message.Message.reply_location:18 #: aiogram.types.message.Message.reply_photo:17 #: aiogram.types.message.Message.reply_poll:24 -#: aiogram.types.message.Message.reply_sticker:13 +#: aiogram.types.message.Message.reply_sticker:14 #: aiogram.types.message.Message.reply_venue:20 #: aiogram.types.message.Message.reply_video:22 #: aiogram.types.message.Message.reply_video_note:16 @@ -709,7 +717,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:18 #: aiogram.types.message.Message.answer_photo:17 #: aiogram.types.message.Message.answer_poll:24 -#: aiogram.types.message.Message.answer_sticker:13 +#: aiogram.types.message.Message.answer_sticker:14 #: aiogram.types.message.Message.answer_venue:20 #: aiogram.types.message.Message.answer_video:22 #: aiogram.types.message.Message.answer_video_note:16 @@ -725,7 +733,7 @@ msgstr "" #: aiogram.types.message.Message.reply_location:19 #: aiogram.types.message.Message.reply_photo:18 #: aiogram.types.message.Message.reply_poll:25 -#: aiogram.types.message.Message.reply_sticker:14 +#: aiogram.types.message.Message.reply_sticker:15 #: aiogram.types.message.Message.reply_venue:21 #: aiogram.types.message.Message.reply_video:23 #: aiogram.types.message.Message.reply_video_note:17 @@ -745,7 +753,7 @@ msgstr "" #: aiogram.types.message.Message.answer_media_group:15 #: aiogram.types.message.Message.answer_photo:19 #: aiogram.types.message.Message.answer_poll:26 -#: aiogram.types.message.Message.answer_sticker:15 +#: aiogram.types.message.Message.answer_sticker:16 #: aiogram.types.message.Message.answer_venue:22 #: aiogram.types.message.Message.answer_video:24 #: aiogram.types.message.Message.answer_video_note:18 @@ -763,7 +771,7 @@ msgstr "" #: aiogram.types.message.Message.reply_media_group:15 #: aiogram.types.message.Message.reply_photo:19 #: aiogram.types.message.Message.reply_poll:26 -#: aiogram.types.message.Message.reply_sticker:15 +#: aiogram.types.message.Message.reply_sticker:16 #: aiogram.types.message.Message.reply_venue:22 #: aiogram.types.message.Message.reply_video:24 #: aiogram.types.message.Message.reply_video_note:18 @@ -782,7 +790,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:21 #: aiogram.types.message.Message.answer_photo:20 #: aiogram.types.message.Message.answer_poll:27 -#: aiogram.types.message.Message.answer_sticker:16 +#: aiogram.types.message.Message.answer_sticker:17 #: aiogram.types.message.Message.answer_venue:23 #: aiogram.types.message.Message.answer_video:25 #: aiogram.types.message.Message.answer_video_note:19 @@ -797,7 +805,7 @@ msgstr "" #: aiogram.types.message.Message.reply_location:21 #: aiogram.types.message.Message.reply_photo:20 #: aiogram.types.message.Message.reply_poll:27 -#: aiogram.types.message.Message.reply_sticker:16 +#: aiogram.types.message.Message.reply_sticker:17 #: aiogram.types.message.Message.reply_venue:23 #: aiogram.types.message.Message.reply_video:25 #: aiogram.types.message.Message.reply_video_note:19 @@ -873,7 +881,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:19 #: aiogram.types.message.Message.answer_photo:18 #: aiogram.types.message.Message.answer_poll:25 -#: aiogram.types.message.Message.answer_sticker:14 +#: aiogram.types.message.Message.answer_sticker:15 #: aiogram.types.message.Message.answer_venue:21 #: aiogram.types.message.Message.answer_video:23 #: aiogram.types.message.Message.answer_video_note:17 @@ -1666,13 +1674,19 @@ msgstr "" msgid "" "Sticker to send. Pass a file_id as String to send a file that exists on " "the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a .WEBP file from the Internet, or upload a new one using" -" multipart/form-data. :ref:`More information on Sending Files » `" +"Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP " +"or .TGS sticker using multipart/form-data. :ref:`More information on " +"Sending Files » `. Video stickers can only be sent by a " +"file_id. Animated stickers can't be sent via an HTTP URL." msgstr "" -#: aiogram.types.message.Message.answer_sticker:17 -#: aiogram.types.message.Message.reply_sticker:17 of +#: aiogram.types.message.Message.answer_sticker:12 +#: aiogram.types.message.Message.reply_sticker:13 of +msgid "Emoji associated with the sticker; only for just uploaded stickers" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:18 +#: aiogram.types.message.Message.reply_sticker:18 of msgid "instance of method :class:`aiogram.methods.send_sticker.SendSticker`" msgstr "" @@ -2536,3 +2550,15 @@ msgstr "" #~ msgid "Copy message" #~ msgstr "" + +#~ msgid "" +#~ "Sticker to send. Pass a file_id as" +#~ " String to send a file that " +#~ "exists on the Telegram servers " +#~ "(recommended), pass an HTTP URL as " +#~ "a String for Telegram to get a " +#~ ".WEBP file from the Internet, or " +#~ "upload a new one using multipart" +#~ "/form-data. :ref:`More information on " +#~ "Sending Files » `" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/sticker.po b/docs/locale/en/LC_MESSAGES/api/types/sticker.po index 4f8fc38b..fe98cecc 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/sticker.po +++ b/docs/locale/en/LC_MESSAGES/api/types/sticker.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/sticker.rst:3 msgid "Sticker" @@ -66,7 +66,7 @@ msgid "" "`_" msgstr "" -#: ../../docstring aiogram.types.sticker.Sticker.thumb:1 of +#: ../../docstring aiogram.types.sticker.Sticker.thumbnail:1 of msgid "*Optional*. Sticker thumbnail in the .WEBP or .JPG format" msgstr "" @@ -96,6 +96,14 @@ msgid "" "emoji" msgstr "" +#: ../../docstring aiogram.types.sticker.Sticker.needs_repainting:1 of +msgid "" +"*Optional*. :code:`True`, if the sticker must be repainted to a text " +"color in messages, the color of the Telegram Premium badge in emoji " +"status, white color on chat photos, or another appropriate color in other" +" places" +msgstr "" + #: ../../docstring aiogram.types.sticker.Sticker.file_size:1 of msgid "*Optional*. File size in bytes" msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/user_shared.po b/docs/locale/en/LC_MESSAGES/api/types/user_shared.po new file mode 100644 index 00000000..d725744c --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/user_shared.po @@ -0,0 +1,49 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/user_shared.rst:3 +msgid "UserShared" +msgstr "" + +#: aiogram.types.user_shared.UserShared:1 of +msgid "" +"This object contains information about the user whose identifier was " +"shared with the bot using a " +":class:`aiogram.types.keyboard_button_request_user.KeyboardButtonRequestUser`" +" button." +msgstr "" + +#: aiogram.types.user_shared.UserShared:3 of +msgid "Source: https://core.telegram.org/bots/api#usershared" +msgstr "" + +#: ../../docstring aiogram.types.user_shared.UserShared.request_id:1 of +msgid "Identifier of the request" +msgstr "" + +#: ../../docstring aiogram.types.user_shared.UserShared.user_id:1 of +msgid "" +"Identifier of the shared user. This number may have more than 32 " +"significant bits and some programming languages may have " +"difficulty/silent defects in interpreting it. But it has at most 52 " +"significant bits, so a 64-bit integer or double-precision float type are " +"safe for storing this identifier. The bot may not have access to the user" +" and could be unable to use this identifier, unless the user is already " +"known to the bot by some other means." +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/upload_file.po b/docs/locale/en/LC_MESSAGES/api/upload_file.po index 3d0bea45..8e01cf9e 100644 --- a/docs/locale/en/LC_MESSAGES/api/upload_file.po +++ b/docs/locale/en/LC_MESSAGES/api/upload_file.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-03 01:03+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/upload_file.rst:5 msgid "How to upload file?" @@ -36,12 +36,12 @@ msgstr "" #: ../../api/upload_file.rst:13 msgid "" -"But if you need to upload new file just use subclasses of `InputFile " +"But if you need to upload a new file just use subclasses of `InputFile " "`__." msgstr "" #: ../../api/upload_file.rst:15 -msgid "Here is available three different builtin types of input file:" +msgid "Here are the three different available builtin types of input file:" msgstr "" #: ../../api/upload_file.rst:17 @@ -68,9 +68,9 @@ msgstr "" #: ../../api/upload_file.rst:25 msgid "" -"Instances of `InputFile` is reusable. That's mean you can create instance" -" of InputFile and sent this file multiple times but Telegram is not " -"recommend to do that and when you upload file once just save their " +"Instances of `InputFile` are reusable. That's mean you can create " +"instance of InputFile and sent this file multiple times but Telegram does" +" not recommend to do that and when you upload file once just save their " "`file_id` and use it in next times." msgstr "" @@ -118,8 +118,8 @@ msgstr "" #: ../../api/upload_file.rst:54 msgid "" "Files can be also passed from buffer (For example you generate image " -"using `Pillow `_ and the want's" -" to sent it to the Telegram):" +"using `Pillow `_ and you want " +"to send it to Telegram):" msgstr "" #: ../../api/upload_file.rst:58 ../../api/upload_file.rst:80 @@ -158,3 +158,32 @@ msgstr "" #~ msgid "instance of :obj:`BufferedInputFile`" #~ msgstr "" + +#~ msgid "" +#~ "But if you need to upload new " +#~ "file just use subclasses of `InputFile" +#~ " `__." +#~ msgstr "" + +#~ msgid "Here is available three different builtin types of input file:" +#~ msgstr "" + +#~ msgid "" +#~ "Instances of `InputFile` is reusable. " +#~ "That's mean you can create instance " +#~ "of InputFile and sent this file " +#~ "multiple times but Telegram is not " +#~ "recommend to do that and when you" +#~ " upload file once just save their " +#~ "`file_id` and use it in next " +#~ "times." +#~ msgstr "" + +#~ msgid "" +#~ "Files can be also passed from " +#~ "buffer (For example you generate image" +#~ " using `Pillow " +#~ "`_ and the " +#~ "want's to sent it to the " +#~ "Telegram):" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/changelog.po b/docs/locale/en/LC_MESSAGES/changelog.po index a8b8a071..ec08c2fa 100644 --- a/docs/locale/en/LC_MESSAGES/changelog.po +++ b/docs/locale/en/LC_MESSAGES/changelog.po @@ -8,49 +8,107 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-01-07 23:01+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../../CHANGES.rst:3 msgid "Changelog" msgstr "" #: ../../[towncrier-fragments]:2 -msgid "\\ |release| [UNRELEASED DRAFT] (2023-01-07)" +msgid "\\ |release| [UNRELEASED DRAFT] (2023-03-11)" msgstr "" -#: ../../../CHANGES.rst:23 ../../../CHANGES.rst:83 ../../../CHANGES.rst:134 -#: ../../../CHANGES.rst:207 ../../../CHANGES.rst:248 ../../../CHANGES.rst:286 -#: ../../../CHANGES.rst:334 ../../../CHANGES.rst:410 ../../../CHANGES.rst:443 -#: ../../../CHANGES.rst:474 ../../[towncrier-fragments]:5 -msgid "Features" +#: ../../../CHANGES.rst:193 ../../../CHANGES.rst:243 ../../../CHANGES.rst:623 +#: ../../[towncrier-fragments]:5 +msgid "Improved Documentation" msgstr "" #: ../../[towncrier-fragments]:7 +msgid "" +"Changed small grammar typos for `upload_file` `#1133 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:127 ../../../CHANGES.rst:204 ../../../CHANGES.rst:257 +#: ../../../CHANGES.rst:308 ../../../CHANGES.rst:362 ../../../CHANGES.rst:404 +#: ../../../CHANGES.rst:450 ../../../CHANGES.rst:510 ../../../CHANGES.rst:531 +#: ../../../CHANGES.rst:554 ../../../CHANGES.rst:591 ../../../CHANGES.rst:630 +#: ../../[towncrier-fragments]:12 +msgid "Misc" +msgstr "" + +#: ../../[towncrier-fragments]:14 +msgid "" +"Added full support of `Bot API 6.6 `_" +msgstr "" + +#: ../../[towncrier-fragments]:18 +msgid "" +"Note that this issue has breaking changes described in in the Bot API " +"changelog, this changes is not breaking in the API but breaking inside " +"aiogram because Beta stage is not finished." +msgstr "" + +#: ../../[towncrier-fragments]:21 +msgid "`#1139 `_" +msgstr "" + +#: ../../../CHANGES.rst:20 +msgid "3.0.0b7 (2023-02-18)" +msgstr "" + +#: ../../../CHANGES.rst:24 +msgid "" +"Note that this version has incompatibility with Python 3.8-3.9 in case " +"when you create an instance of Dispatcher outside of the any coroutine." +msgstr "" + +#: ../../../CHANGES.rst:26 +msgid "Sorry for the inconvenience, it will be fixed in the next version." +msgstr "" + +#: ../../../CHANGES.rst:28 +msgid "This code will not work:" +msgstr "" + +#: ../../../CHANGES.rst:40 +msgid "But if you change it like this it should works as well:" +msgstr "" + +#: ../../../CHANGES.rst:56 ../../../CHANGES.rst:156 ../../../CHANGES.rst:216 +#: ../../../CHANGES.rst:267 ../../../CHANGES.rst:340 ../../../CHANGES.rst:381 +#: ../../../CHANGES.rst:419 ../../../CHANGES.rst:467 ../../../CHANGES.rst:543 +#: ../../../CHANGES.rst:576 ../../../CHANGES.rst:607 +msgid "Features" +msgstr "" + +#: ../../../CHANGES.rst:58 msgid "Added missing shortcuts, new enums, reworked old stuff" msgstr "" -#: ../../[towncrier-fragments]:9 +#: ../../../CHANGES.rst:60 msgid "" "**Breaking** All previously added enums is re-generated in new place - " "`aiogram.enums` instead of `aiogram.types`" msgstr "" -#: ../../[towncrier-fragments]:27 +#: ../../../CHANGES.rst:78 msgid "" "**Added enums:** " ":class:`aiogram.enums.bot_command_scope_type.BotCommandScopeType`," msgstr "" -#: ../../[towncrier-fragments]:13 +#: ../../../CHANGES.rst:64 msgid "" -":class:`aiogram.enums.chat_action.ChatActions`, " +":class:`aiogram.enums.chat_action.ChatAction`, " ":class:`aiogram.enums.chat_member_status.ChatMemberStatus`, " ":class:`aiogram.enums.chat_type.ChatType`, " ":class:`aiogram.enums.content_type.ContentType`, " @@ -67,15 +125,15 @@ msgid "" ":class:`aiogram.enums.update_type.UpdateType`," msgstr "" -#: ../../[towncrier-fragments]:29 +#: ../../../CHANGES.rst:80 msgid "**Added shortcuts**:" msgstr "" -#: ../../[towncrier-fragments]:54 +#: ../../../CHANGES.rst:105 msgid "*Chat* :meth:`aiogram.types.chat.Chat.get_administrators`," msgstr "" -#: ../../[towncrier-fragments]:32 +#: ../../../CHANGES.rst:83 msgid "" ":meth:`aiogram.types.chat.Chat.delete_message`, " ":meth:`aiogram.types.chat.Chat.revoke_invite_link`, " @@ -103,175 +161,234 @@ msgid "" ":meth:`aiogram.types.chat.Chat.set_photo`," msgstr "" -#: ../../[towncrier-fragments]:56 +#: ../../../CHANGES.rst:107 msgid "*Sticker*: :meth:`aiogram.types.sticker.Sticker.set_position_in_set`," msgstr "" -#: ../../[towncrier-fragments]:57 +#: ../../../CHANGES.rst:108 msgid ":meth:`aiogram.types.sticker.Sticker.delete_from_set`," msgstr "" -#: ../../[towncrier-fragments]:58 +#: ../../../CHANGES.rst:109 msgid "*User*: :meth:`aiogram.types.user.User.get_profile_photos`" msgstr "" -#: ../../[towncrier-fragments]:59 +#: ../../../CHANGES.rst:110 msgid "`#952 `_" msgstr "" -#: ../../[towncrier-fragments]:60 +#: ../../../CHANGES.rst:111 msgid "" -"Added full support of `Bot API 6.4 `_ `#1088 " -"`_" +"Added :ref:`callback answer ` feature `#1091 " +"`_" msgstr "" -#: ../../../CHANGES.rst:71 ../../../CHANGES.rst:124 ../../../CHANGES.rst:175 -#: ../../../CHANGES.rst:229 ../../../CHANGES.rst:271 ../../../CHANGES.rst:317 -#: ../../../CHANGES.rst:377 ../../../CHANGES.rst:398 ../../../CHANGES.rst:421 -#: ../../../CHANGES.rst:458 ../../../CHANGES.rst:497 -#: ../../[towncrier-fragments]:65 -msgid "Misc" +#: ../../../CHANGES.rst:113 +msgid "" +"Added a method that allows you to compactly register routers `#1117 " +"`_" msgstr "" -#: ../../[towncrier-fragments]:67 +#: ../../../CHANGES.rst:118 ../../../CHANGES.rst:181 ../../../CHANGES.rst:230 +#: ../../../CHANGES.rst:291 ../../../CHANGES.rst:349 ../../../CHANGES.rst:395 +#: ../../../CHANGES.rst:443 ../../../CHANGES.rst:499 ../../../CHANGES.rst:584 +#: ../../../CHANGES.rst:616 +msgid "Bugfixes" +msgstr "" + +#: ../../../CHANGES.rst:120 +msgid "" +"Check status code when downloading file `#816 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:122 +msgid "" +"Fixed `ignore_case` parameter in :obj:`aiogram.filters.command.Command` " +"filter `#1106 `_" +msgstr "" + +#: ../../../CHANGES.rst:129 msgid "" "Added integration with new code-generator named `Butcher " "`_ `#1069 " "`_" msgstr "" -#: ../../../CHANGES.rst:20 +#: ../../../CHANGES.rst:131 +msgid "" +"Added full support of `Bot API 6.4 `_ `#1088 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:133 +msgid "" +"Updated package metadata, moved build internals from Poetry to Hatch, " +"added contributing guides. `#1095 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:135 +msgid "" +"Added full support of `Bot API 6.5 `_" +msgstr "" + +#: ../../../CHANGES.rst:139 +msgid "" +"Note that :obj:`aiogram.types.chat_permissions.ChatPermissions` is " +"updated without backward compatibility, so now this object has no " +":code:`can_send_media_messages` attribute" +msgstr "" + +#: ../../../CHANGES.rst:141 +msgid "`#1112 `_" +msgstr "" + +#: ../../../CHANGES.rst:142 +msgid "" +"Replaced error :code:`TypeError: TelegramEventObserver.__call__() got an " +"unexpected keyword argument ''` with a more understandable one for " +"developers and with a link to the documentation. `#1114 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:145 +msgid "" +"Added possibility to reply into webhook with files `#1120 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:147 +msgid "" +"Reworked graceful shutdown. Added method to stop polling. Now polling " +"started from dispatcher can be stopped by signals gracefully without " +"errors (on Linux and Mac). `#1124 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:153 msgid "3.0.0b6 (2022-11-18)" msgstr "" -#: ../../../CHANGES.rst:25 +#: ../../../CHANGES.rst:158 msgid "" "(again) Added possibility to combine filters with an *and*/*or* " "operations." msgstr "" -#: ../../../CHANGES.rst:27 +#: ../../../CHANGES.rst:160 msgid "" "Read more in \":ref:`Combining filters `\" " "documentation section `#1018 " "`_" msgstr "" -#: ../../../CHANGES.rst:29 +#: ../../../CHANGES.rst:162 msgid "Added following methods to ``Message`` class:" msgstr "" -#: ../../../CHANGES.rst:31 +#: ../../../CHANGES.rst:164 msgid ":code:`Message.forward(...)`" msgstr "" -#: ../../../CHANGES.rst:32 +#: ../../../CHANGES.rst:165 msgid ":code:`Message.edit_media(...)`" msgstr "" -#: ../../../CHANGES.rst:33 +#: ../../../CHANGES.rst:166 msgid ":code:`Message.edit_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:34 +#: ../../../CHANGES.rst:167 msgid ":code:`Message.stop_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:35 +#: ../../../CHANGES.rst:168 msgid ":code:`Message.pin(...)`" msgstr "" -#: ../../../CHANGES.rst:36 +#: ../../../CHANGES.rst:169 msgid ":code:`Message.unpin()`" msgstr "" -#: ../../../CHANGES.rst:37 +#: ../../../CHANGES.rst:170 msgid "`#1030 `_" msgstr "" -#: ../../../CHANGES.rst:38 +#: ../../../CHANGES.rst:171 msgid "Added following methods to :code:`User` class:" msgstr "" -#: ../../../CHANGES.rst:40 +#: ../../../CHANGES.rst:173 msgid ":code:`User.mention_markdown(...)`" msgstr "" -#: ../../../CHANGES.rst:41 +#: ../../../CHANGES.rst:174 msgid ":code:`User.mention_html(...)`" msgstr "" -#: ../../../CHANGES.rst:42 +#: ../../../CHANGES.rst:175 msgid "`#1049 `_" msgstr "" -#: ../../../CHANGES.rst:43 +#: ../../../CHANGES.rst:176 msgid "" "Added full support of `Bot API 6.3 `_ `#1057 " "`_" msgstr "" -#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:97 ../../../CHANGES.rst:158 -#: ../../../CHANGES.rst:216 ../../../CHANGES.rst:262 ../../../CHANGES.rst:310 -#: ../../../CHANGES.rst:366 ../../../CHANGES.rst:451 ../../../CHANGES.rst:483 -msgid "Bugfixes" -msgstr "" - -#: ../../../CHANGES.rst:50 +#: ../../../CHANGES.rst:183 msgid "" "Fixed :code:`Message.send_invoice` and :code:`Message.reply_invoice`, " "added missing arguments `#1047 " "`_" msgstr "" -#: ../../../CHANGES.rst:52 +#: ../../../CHANGES.rst:185 msgid "Fixed copy and forward in:" msgstr "" -#: ../../../CHANGES.rst:54 +#: ../../../CHANGES.rst:187 msgid ":code:`Message.answer(...)`" msgstr "" -#: ../../../CHANGES.rst:55 +#: ../../../CHANGES.rst:188 msgid ":code:`Message.copy_to(...)`" msgstr "" -#: ../../../CHANGES.rst:56 +#: ../../../CHANGES.rst:189 msgid "`#1064 `_" msgstr "" -#: ../../../CHANGES.rst:60 ../../../CHANGES.rst:110 ../../../CHANGES.rst:490 -msgid "Improved Documentation" -msgstr "" - -#: ../../../CHANGES.rst:62 +#: ../../../CHANGES.rst:195 msgid "" "Fixed UA translations in index.po `#1017 " "`_" msgstr "" -#: ../../../CHANGES.rst:64 +#: ../../../CHANGES.rst:197 msgid "" "Fix typehints for :code:`Message`, :code:`reply_media_group` and " ":code:`answer_media_group` methods `#1029 " "`_" msgstr "" -#: ../../../CHANGES.rst:66 +#: ../../../CHANGES.rst:199 msgid "" "Removed an old now non-working feature `#1060 " "`_" msgstr "" -#: ../../../CHANGES.rst:73 +#: ../../../CHANGES.rst:206 msgid "" "Enabled testing on Python 3.11 `#1044 " "`_" msgstr "" -#: ../../../CHANGES.rst:75 +#: ../../../CHANGES.rst:208 msgid "" "Added a mandatory dependency :code:`certifi` in due to in some cases on " "systems that doesn't have updated ca-certificates the requests to Bot API" @@ -280,23 +397,23 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:80 +#: ../../../CHANGES.rst:213 msgid "3.0.0b5 (2022-10-02)" msgstr "" -#: ../../../CHANGES.rst:85 +#: ../../../CHANGES.rst:218 msgid "" "Add PyPy support and run tests under PyPy `#985 " "`_" msgstr "" -#: ../../../CHANGES.rst:87 +#: ../../../CHANGES.rst:220 msgid "" "Added message text to aiogram exceptions representation `#988 " "`_" msgstr "" -#: ../../../CHANGES.rst:89 +#: ../../../CHANGES.rst:222 msgid "" "Added warning about using magic filter from `magic_filter` instead of " "`aiogram`'s ones. Is recommended to use `from aiogram import F` instead " @@ -304,65 +421,65 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:92 +#: ../../../CHANGES.rst:225 msgid "" "Added more detailed error when server response can't be deserialized. " "This feature will help to debug unexpected responses from the Server " "`#1014 `_" msgstr "" -#: ../../../CHANGES.rst:99 +#: ../../../CHANGES.rst:232 msgid "" "Reworked error event, introduced " ":class:`aiogram.types.error_event.ErrorEvent` object. `#898 " "`_" msgstr "" -#: ../../../CHANGES.rst:101 +#: ../../../CHANGES.rst:234 msgid "" "Fixed escaping markdown in `aiogram.utils.markdown` module `#903 " "`_" msgstr "" -#: ../../../CHANGES.rst:103 +#: ../../../CHANGES.rst:236 msgid "" "Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. " "`#995 `_" msgstr "" -#: ../../../CHANGES.rst:105 +#: ../../../CHANGES.rst:238 msgid "" "Fixed empty mention in command parsing, now it will be None instead of an" " empty string `#1013 `_" msgstr "" -#: ../../../CHANGES.rst:112 +#: ../../../CHANGES.rst:245 msgid "" "Initialized Docs translation (added Ukrainian language) `#925 " "`_" msgstr "" -#: ../../../CHANGES.rst:117 +#: ../../../CHANGES.rst:250 msgid "Deprecations and Removals" msgstr "" -#: ../../../CHANGES.rst:119 +#: ../../../CHANGES.rst:252 msgid "" "Removed filters factory as described in corresponding issue. `#942 " "`_" msgstr "" -#: ../../../CHANGES.rst:126 +#: ../../../CHANGES.rst:259 msgid "" "Now Router/Dispatcher accepts only keyword arguments. `#982 " "`_" msgstr "" -#: ../../../CHANGES.rst:131 +#: ../../../CHANGES.rst:264 msgid "3.0.0b4 (2022-08-14)" msgstr "" -#: ../../../CHANGES.rst:136 +#: ../../../CHANGES.rst:269 msgid "" "Add class helper ChatAction for constants that Telegram BotAPI uses in " "sendChatAction request. In my opinion, this will help users and will also" @@ -370,198 +487,198 @@ msgid "" "\"ChatActions\". `#803 `_" msgstr "" -#: ../../../CHANGES.rst:140 +#: ../../../CHANGES.rst:273 msgid "Added possibility to combine filters or invert result" msgstr "" -#: ../../../CHANGES.rst:142 +#: ../../../CHANGES.rst:275 msgid "Example:" msgstr "" -#: ../../../CHANGES.rst:150 +#: ../../../CHANGES.rst:283 msgid "`#894 `_" msgstr "" -#: ../../../CHANGES.rst:151 +#: ../../../CHANGES.rst:284 msgid "" "Fixed type hints for redis TTL params. `#922 " "`_" msgstr "" -#: ../../../CHANGES.rst:153 +#: ../../../CHANGES.rst:286 msgid "" "Added `full_name` shortcut for `Chat` object `#929 " "`_" msgstr "" -#: ../../../CHANGES.rst:160 +#: ../../../CHANGES.rst:293 msgid "" "Fixed false-positive coercing of Union types in API methods `#901 " "`_" msgstr "" -#: ../../../CHANGES.rst:162 +#: ../../../CHANGES.rst:295 msgid "Added 3 missing content types:" msgstr "" -#: ../../../CHANGES.rst:164 +#: ../../../CHANGES.rst:297 msgid "proximity_alert_triggered" msgstr "" -#: ../../../CHANGES.rst:165 +#: ../../../CHANGES.rst:298 msgid "supergroup_chat_created" msgstr "" -#: ../../../CHANGES.rst:166 +#: ../../../CHANGES.rst:299 msgid "channel_chat_created" msgstr "" -#: ../../../CHANGES.rst:167 +#: ../../../CHANGES.rst:300 msgid "`#906 `_" msgstr "" -#: ../../../CHANGES.rst:168 +#: ../../../CHANGES.rst:301 msgid "" "Fixed the ability to compare the state, now comparison to copy of the " "state will return `True`. `#927 " "`_" msgstr "" -#: ../../../CHANGES.rst:170 +#: ../../../CHANGES.rst:303 msgid "" "Fixed default lock kwargs in RedisEventIsolation. `#972 " "`_" msgstr "" -#: ../../../CHANGES.rst:177 +#: ../../../CHANGES.rst:310 msgid "" "Restrict including routers with strings `#896 " "`_" msgstr "" -#: ../../../CHANGES.rst:179 +#: ../../../CHANGES.rst:312 msgid "" "Changed CommandPatterType to CommandPatternType in " "`aiogram/dispatcher/filters/command.py` `#907 " "`_" msgstr "" -#: ../../../CHANGES.rst:181 +#: ../../../CHANGES.rst:314 msgid "" "Added full support of `Bot API 6.1 `_ `#936 " "`_" msgstr "" -#: ../../../CHANGES.rst:183 +#: ../../../CHANGES.rst:316 msgid "**Breaking!** More flat project structure" msgstr "" -#: ../../../CHANGES.rst:185 +#: ../../../CHANGES.rst:318 msgid "These packages was moved, imports in your code should be fixed:" msgstr "" -#: ../../../CHANGES.rst:187 +#: ../../../CHANGES.rst:320 msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`" msgstr "" -#: ../../../CHANGES.rst:188 +#: ../../../CHANGES.rst:321 msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`" msgstr "" -#: ../../../CHANGES.rst:189 +#: ../../../CHANGES.rst:322 msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`" msgstr "" -#: ../../../CHANGES.rst:190 +#: ../../../CHANGES.rst:323 msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`" msgstr "" -#: ../../../CHANGES.rst:191 +#: ../../../CHANGES.rst:324 msgid "" ":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` " "(single module instead of package)" msgstr "" -#: ../../../CHANGES.rst:192 +#: ../../../CHANGES.rst:325 msgid "`#938 `_" msgstr "" -#: ../../../CHANGES.rst:193 +#: ../../../CHANGES.rst:326 msgid "" "Removed deprecated :code:`router._handler` and " ":code:`router.register__handler` methods. `#941 " "`_" msgstr "" -#: ../../../CHANGES.rst:195 +#: ../../../CHANGES.rst:328 msgid "" "Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942" " `_" msgstr "" -#: ../../../CHANGES.rst:197 +#: ../../../CHANGES.rst:330 msgid "" "`MessageEntity` method `get_text` was removed and `extract` was renamed " "to `extract_from` `#944 `_" msgstr "" -#: ../../../CHANGES.rst:199 +#: ../../../CHANGES.rst:332 msgid "" "Added full support of `Bot API 6.2 `_ `#975 " "`_" msgstr "" -#: ../../../CHANGES.rst:204 +#: ../../../CHANGES.rst:337 msgid "3.0.0b3 (2022-04-19)" msgstr "" -#: ../../../CHANGES.rst:209 +#: ../../../CHANGES.rst:342 msgid "" "Added possibility to get command magic result as handler argument `#889 " "`_" msgstr "" -#: ../../../CHANGES.rst:211 +#: ../../../CHANGES.rst:344 msgid "" "Added full support of `Telegram Bot API 6.0 " "`_ `#890 " "`_" msgstr "" -#: ../../../CHANGES.rst:218 +#: ../../../CHANGES.rst:351 msgid "" "Fixed I18n lazy-proxy. Disabled caching. `#839 " "`_" msgstr "" -#: ../../../CHANGES.rst:220 +#: ../../../CHANGES.rst:353 msgid "" "Added parsing of spoiler message entity `#865 " "`_" msgstr "" -#: ../../../CHANGES.rst:222 +#: ../../../CHANGES.rst:355 msgid "" "Fixed default `parse_mode` for `Message.copy_to()` method. `#876 " "`_" msgstr "" -#: ../../../CHANGES.rst:224 +#: ../../../CHANGES.rst:357 msgid "" "Fixed CallbackData factory parsing IntEnum's `#885 " "`_" msgstr "" -#: ../../../CHANGES.rst:231 +#: ../../../CHANGES.rst:364 msgid "" "Added automated check that pull-request adds a changes description to " "**CHANGES** directory `#873 " "`_" msgstr "" -#: ../../../CHANGES.rst:233 +#: ../../../CHANGES.rst:366 msgid "" "Changed :code:`Message.html_text` and :code:`Message.md_text` attributes " "behaviour when message has no text. The empty string will be used instead" @@ -569,14 +686,14 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:236 +#: ../../../CHANGES.rst:369 msgid "" "Used `redis-py` instead of `aioredis` package in due to this packages was" " merged into single one `#882 " "`_" msgstr "" -#: ../../../CHANGES.rst:238 +#: ../../../CHANGES.rst:371 msgid "" "Solved common naming problem with middlewares that confusing too much " "developers - now you can't see the `middleware` and `middlewares` " @@ -585,113 +702,113 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:245 +#: ../../../CHANGES.rst:378 msgid "3.0.0b2 (2022-02-19)" msgstr "" -#: ../../../CHANGES.rst:250 +#: ../../../CHANGES.rst:383 msgid "" "Added possibility to pass additional arguments into the aiohttp webhook " "handler to use this arguments inside handlers as the same as it possible " "in polling mode. `#785 `_" msgstr "" -#: ../../../CHANGES.rst:253 +#: ../../../CHANGES.rst:386 msgid "" "Added possibility to add handler flags via decorator (like `pytest.mark` " "decorator but `aiogram.flags`) `#836 " "`_" msgstr "" -#: ../../../CHANGES.rst:255 +#: ../../../CHANGES.rst:388 msgid "" "Added :code:`ChatActionSender` utility to automatically sends chat action" " while long process is running." msgstr "" -#: ../../../CHANGES.rst:257 +#: ../../../CHANGES.rst:390 msgid "" "It also can be used as message middleware and can be customized via " ":code:`chat_action` flag. `#837 " "`_" msgstr "" -#: ../../../CHANGES.rst:264 +#: ../../../CHANGES.rst:397 msgid "" "Fixed unexpected behavior of sequences in the StateFilter. `#791 " "`_" msgstr "" -#: ../../../CHANGES.rst:266 +#: ../../../CHANGES.rst:399 msgid "" "Fixed exceptions filters `#827 " "`_" msgstr "" -#: ../../../CHANGES.rst:273 +#: ../../../CHANGES.rst:406 msgid "" "Logger name for processing events is changed to :code:`aiogram.events`. " "`#830 `_" msgstr "" -#: ../../../CHANGES.rst:275 +#: ../../../CHANGES.rst:408 msgid "" "Added full support of Telegram Bot API 5.6 and 5.7 `#835 " "`_" msgstr "" -#: ../../../CHANGES.rst:277 +#: ../../../CHANGES.rst:410 msgid "" "**BREAKING** Events isolation mechanism is moved from FSM storages to " "standalone managers `#838 " "`_" msgstr "" -#: ../../../CHANGES.rst:283 +#: ../../../CHANGES.rst:416 msgid "3.0.0b1 (2021-12-12)" msgstr "" -#: ../../../CHANGES.rst:288 +#: ../../../CHANGES.rst:421 msgid "Added new custom operation for MagicFilter named :code:`as_`" msgstr "" -#: ../../../CHANGES.rst:290 +#: ../../../CHANGES.rst:423 msgid "Now you can use it to get magic filter result as handler argument" msgstr "" -#: ../../../CHANGES.rst:306 +#: ../../../CHANGES.rst:439 msgid "`#759 `_" msgstr "" -#: ../../../CHANGES.rst:312 +#: ../../../CHANGES.rst:445 msgid "" "Fixed: Missing :code:`ChatMemberHandler` import in " ":code:`aiogram/dispatcher/handler` `#751 " "`_" msgstr "" -#: ../../../CHANGES.rst:319 +#: ../../../CHANGES.rst:452 msgid "" "Check :code:`destiny` in case of no :code:`with_destiny` enabled in " "RedisStorage key builder `#776 " "`_" msgstr "" -#: ../../../CHANGES.rst:321 +#: ../../../CHANGES.rst:454 msgid "" "Added full support of `Bot API 5.5 `_ `#777 " "`_" msgstr "" -#: ../../../CHANGES.rst:323 +#: ../../../CHANGES.rst:456 msgid "" "Stop using feature from #336. From now settings of client-session should " "be placed as initializer arguments instead of changing instance " "attributes. `#778 `_" msgstr "" -#: ../../../CHANGES.rst:325 +#: ../../../CHANGES.rst:458 msgid "" "Make TelegramAPIServer files wrapper in local mode bi-directional " "(server-client, client-server) Now you can convert local path to server " @@ -699,11 +816,11 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:331 +#: ../../../CHANGES.rst:464 msgid "3.0.0a18 (2021-11-10)" msgstr "" -#: ../../../CHANGES.rst:336 +#: ../../../CHANGES.rst:469 msgid "" "Breaking: Changed the signature of the session middlewares Breaking: " "Renamed AiohttpSession.make_request method parameter from call to method " @@ -711,258 +828,258 @@ msgid "" "outgoing requests `#716 `_" msgstr "" -#: ../../../CHANGES.rst:340 +#: ../../../CHANGES.rst:473 msgid "" "Improved description of filters resolving error. For example when you try" " to pass wrong type of argument to the filter but don't know why filter " "is not resolved now you can get error like this:" msgstr "" -#: ../../../CHANGES.rst:350 +#: ../../../CHANGES.rst:483 msgid "`#717 `_" msgstr "" -#: ../../../CHANGES.rst:351 +#: ../../../CHANGES.rst:484 msgid "" "**Breaking internal API change** Reworked FSM Storage record keys " "propagation `#723 `_" msgstr "" -#: ../../../CHANGES.rst:354 +#: ../../../CHANGES.rst:487 msgid "" "Implemented new filter named :code:`MagicData(magic_data)` that helps to " "filter event by data from middlewares or other filters" msgstr "" -#: ../../../CHANGES.rst:356 +#: ../../../CHANGES.rst:489 msgid "" "For example your bot is running with argument named :code:`config` that " "contains the application config then you can filter event by value from " "this config:" msgstr "" -#: ../../../CHANGES.rst:362 +#: ../../../CHANGES.rst:495 msgid "`#724 `_" msgstr "" -#: ../../../CHANGES.rst:368 +#: ../../../CHANGES.rst:501 msgid "" "Fixed I18n context inside error handlers `#726 " "`_" msgstr "" -#: ../../../CHANGES.rst:370 +#: ../../../CHANGES.rst:503 msgid "" "Fixed bot session closing before emit shutdown `#734 " "`_" msgstr "" -#: ../../../CHANGES.rst:372 +#: ../../../CHANGES.rst:505 msgid "" "Fixed: bound filter resolving does not require children routers `#736 " "`_" msgstr "" -#: ../../../CHANGES.rst:379 +#: ../../../CHANGES.rst:512 msgid "" "Enabled testing on Python 3.10 Removed `async_lru` dependency (is " "incompatible with Python 3.10) and replaced usage with protected property" " `#719 `_" msgstr "" -#: ../../../CHANGES.rst:382 +#: ../../../CHANGES.rst:515 msgid "" "Converted README.md to README.rst and use it as base file for docs `#725 " "`_" msgstr "" -#: ../../../CHANGES.rst:384 +#: ../../../CHANGES.rst:517 msgid "Rework filters resolving:" msgstr "" -#: ../../../CHANGES.rst:386 +#: ../../../CHANGES.rst:519 msgid "Automatically apply Bound Filters with default values to handlers" msgstr "" -#: ../../../CHANGES.rst:387 +#: ../../../CHANGES.rst:520 msgid "Fix data transfer from parent to included routers filters" msgstr "" -#: ../../../CHANGES.rst:388 +#: ../../../CHANGES.rst:521 msgid "`#727 `_" msgstr "" -#: ../../../CHANGES.rst:389 +#: ../../../CHANGES.rst:522 msgid "" "Added full support of Bot API 5.4 https://core.telegram.org/bots/api-" "changelog#november-5-2021 `#744 " "`_" msgstr "" -#: ../../../CHANGES.rst:395 +#: ../../../CHANGES.rst:528 msgid "3.0.0a17 (2021-09-24)" msgstr "" -#: ../../../CHANGES.rst:400 +#: ../../../CHANGES.rst:533 msgid "" "Added :code:`html_text` and :code:`md_text` to Message object `#708 " "`_" msgstr "" -#: ../../../CHANGES.rst:402 +#: ../../../CHANGES.rst:535 msgid "" "Refactored I18n, added context managers for I18n engine and current " "locale `#709 `_" msgstr "" -#: ../../../CHANGES.rst:407 +#: ../../../CHANGES.rst:540 msgid "3.0.0a16 (2021-09-22)" msgstr "" -#: ../../../CHANGES.rst:412 +#: ../../../CHANGES.rst:545 msgid "Added support of local Bot API server files downloading" msgstr "" -#: ../../../CHANGES.rst:414 +#: ../../../CHANGES.rst:547 msgid "" "When Local API is enabled files can be downloaded via " "`bot.download`/`bot.download_file` methods. `#698 " "`_" msgstr "" -#: ../../../CHANGES.rst:416 +#: ../../../CHANGES.rst:549 msgid "" "Implemented I18n & L10n support `#701 " "`_" msgstr "" -#: ../../../CHANGES.rst:423 +#: ../../../CHANGES.rst:556 msgid "" "Covered by tests and docs KeyboardBuilder util `#699 " "`_" msgstr "" -#: ../../../CHANGES.rst:425 +#: ../../../CHANGES.rst:558 msgid "**Breaking!!!**. Refactored and renamed exceptions." msgstr "" -#: ../../../CHANGES.rst:427 +#: ../../../CHANGES.rst:560 msgid "" "Exceptions module was moved from :code:`aiogram.utils.exceptions` to " ":code:`aiogram.exceptions`" msgstr "" -#: ../../../CHANGES.rst:428 +#: ../../../CHANGES.rst:561 msgid "Added prefix `Telegram` for all error classes" msgstr "" -#: ../../../CHANGES.rst:429 +#: ../../../CHANGES.rst:562 msgid "`#700 `_" msgstr "" -#: ../../../CHANGES.rst:430 +#: ../../../CHANGES.rst:563 msgid "" "Replaced all :code:`pragma: no cover` marks via global " ":code:`.coveragerc` config `#702 " "`_" msgstr "" -#: ../../../CHANGES.rst:432 +#: ../../../CHANGES.rst:565 msgid "Updated dependencies." msgstr "" -#: ../../../CHANGES.rst:434 +#: ../../../CHANGES.rst:567 msgid "" "**Breaking for framework developers** Now all optional dependencies " "should be installed as extra: `poetry install -E fast -E redis -E proxy " "-E i18n -E docs` `#703 `_" msgstr "" -#: ../../../CHANGES.rst:440 +#: ../../../CHANGES.rst:573 msgid "3.0.0a15 (2021-09-10)" msgstr "" -#: ../../../CHANGES.rst:445 +#: ../../../CHANGES.rst:578 msgid "" "Ability to iterate over all states in StatesGroup. Aiogram already had in" " check for states group so this is relative feature. `#666 " "`_" msgstr "" -#: ../../../CHANGES.rst:453 +#: ../../../CHANGES.rst:586 msgid "" "Fixed incorrect type checking in the " ":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 " "`_" msgstr "" -#: ../../../CHANGES.rst:460 +#: ../../../CHANGES.rst:593 msgid "" "Disable ContentType filter by default `#668 " "`_" msgstr "" -#: ../../../CHANGES.rst:462 +#: ../../../CHANGES.rst:595 msgid "" "Moved update type detection from Dispatcher to Update object `#669 " "`_" msgstr "" -#: ../../../CHANGES.rst:464 +#: ../../../CHANGES.rst:597 msgid "" "Updated **pre-commit** config `#681 " "`_" msgstr "" -#: ../../../CHANGES.rst:466 +#: ../../../CHANGES.rst:599 msgid "" "Reworked **handlers_in_use** util. Function moved to Router as method " "**.resolve_used_update_types()** `#682 " "`_" msgstr "" -#: ../../../CHANGES.rst:471 +#: ../../../CHANGES.rst:604 msgid "3.0.0a14 (2021-08-17)" msgstr "" -#: ../../../CHANGES.rst:476 +#: ../../../CHANGES.rst:609 msgid "" "add aliases for edit/delete reply markup to Message `#662 " "`_" msgstr "" -#: ../../../CHANGES.rst:478 +#: ../../../CHANGES.rst:611 msgid "" "Reworked outer middleware chain. Prevent to call many times the outer " "middleware for each nested router `#664 " "`_" msgstr "" -#: ../../../CHANGES.rst:485 +#: ../../../CHANGES.rst:618 msgid "" "Prepare parse mode for InputMessageContent in AnswerInlineQuery method " "`#660 `_" msgstr "" -#: ../../../CHANGES.rst:492 +#: ../../../CHANGES.rst:625 msgid "" "Added integration with :code:`towncrier` `#602 " "`_" msgstr "" -#: ../../../CHANGES.rst:499 +#: ../../../CHANGES.rst:632 msgid "" "Added `.editorconfig` `#650 " "`_" msgstr "" -#: ../../../CHANGES.rst:501 +#: ../../../CHANGES.rst:634 msgid "" "Redis storage speedup globals `#651 " "`_" msgstr "" -#: ../../../CHANGES.rst:503 +#: ../../../CHANGES.rst:636 msgid "" "add allow_sending_without_reply param to Message reply aliases `#663 " "`_" @@ -2480,3 +2597,24 @@ msgstr "" #: ../../../HISTORY.rst:497 msgid "0.1 (2017-06-03)" msgstr "" + +#~ msgid "\\ |release| [UNRELEASED DRAFT] (2023-01-07)" +#~ msgstr "" + +#~ msgid "" +#~ ":class:`aiogram.enums.chat_action.ChatActions`, " +#~ ":class:`aiogram.enums.chat_member_status.ChatMemberStatus`, " +#~ ":class:`aiogram.enums.chat_type.ChatType`, " +#~ ":class:`aiogram.enums.content_type.ContentType`, " +#~ ":class:`aiogram.enums.dice_emoji.DiceEmoji`, " +#~ ":class:`aiogram.enums.inline_query_result_type.InlineQueryResultType`," +#~ " :class:`aiogram.enums.input_media_type.InputMediaType`, " +#~ ":class:`aiogram.enums.mask_position_point.MaskPositionPoint`, " +#~ ":class:`aiogram.enums.menu_button_type.MenuButtonType`, " +#~ ":class:`aiogram.enums.message_entity_type.MessageEntityType`, " +#~ ":class:`aiogram.enums.parse_mode.ParseMode`, " +#~ ":class:`aiogram.enums.poll_type.PollType`, " +#~ ":class:`aiogram.enums.sticker_type.StickerType`, " +#~ ":class:`aiogram.enums.topic_icon_color.TopicIconColor`, " +#~ ":class:`aiogram.enums.update_type.UpdateType`," +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/contributing.po b/docs/locale/en/LC_MESSAGES/contributing.po new file mode 100644 index 00000000..2a7fe459 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/contributing.po @@ -0,0 +1,322 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../contributing.rst:3 +msgid "Contributing" +msgstr "" + +#: ../../contributing.rst:5 +msgid "You're welcome to contribute to aiogram!" +msgstr "" + +#: ../../contributing.rst:7 +msgid "" +"*aiogram* is an open-source project, and anyone can contribute to it in " +"any possible way" +msgstr "" + +#: ../../contributing.rst:11 +msgid "Developing" +msgstr "" + +#: ../../contributing.rst:13 +msgid "" +"Before making any changes in the framework code, it is necessary to fork " +"the project and clone the project to your PC and know how to do a pull-" +"request." +msgstr "" + +#: ../../contributing.rst:16 +msgid "" +"How to work with pull-request you can read in the `GitHub docs " +"`_" +msgstr "" + +#: ../../contributing.rst:18 +msgid "" +"Also in due to this project is written in Python, you will need Python to" +" be installed (is recommended to use latest Python versions, but any " +"version starting from 3.8 can be used)" +msgstr "" + +#: ../../contributing.rst:23 +msgid "Use virtualenv" +msgstr "" + +#: ../../contributing.rst:25 +msgid "" +"You can create a virtual environment in a directory using :code:`venv` " +"module (it should be pre-installed by default):" +msgstr "" + +#: ../../contributing.rst:31 +msgid "" +"This action will create a :code:`.venv` directory with the Python " +"binaries and then you will be able to install packages into that isolated" +" environment." +msgstr "" + +#: ../../contributing.rst:36 +msgid "Activate the environment" +msgstr "" + +#: ../../contributing.rst:38 +msgid "Linux/ macOS:" +msgstr "" + +#: ../../contributing.rst:44 +msgid "Windows PoweShell" +msgstr "" + +#: ../../contributing.rst:50 +msgid "" +"To check it worked, use described command, it should show the :code:`pip`" +" location inside the isolated environment" +msgstr "" + +#: ../../contributing.rst:53 +msgid "Linux, macOS:" +msgstr "" + +#: ../../contributing.rst:59 +msgid "Windows PowerShell" +msgstr "" + +#: ../../contributing.rst:65 +msgid "" +"Also make you shure you have the latest pip version in your virtual " +"environment to avoid errors on next steps:" +msgstr "" + +#: ../../contributing.rst:74 +msgid "Setup project" +msgstr "" + +#: ../../contributing.rst:76 +msgid "" +"After activating the environment install `aiogram` from sources and their" +" dependencies:" +msgstr "" + +#: ../../contributing.rst:82 +msgid "" +"It will install :code:`aiogram` in editable mode into your virtual " +"environment and all dependencies." +msgstr "" + +#: ../../contributing.rst:85 +msgid "Making changes in code" +msgstr "" + +#: ../../contributing.rst:87 +msgid "" +"At this point you can make any changes in the code that you want, it can " +"be any fixes, implementing new features or experimenting." +msgstr "" + +#: ../../contributing.rst:92 +msgid "Format the code (code-style)" +msgstr "" + +#: ../../contributing.rst:94 +msgid "" +"Note that this project is Black-formatted, so you should follow that " +"code-style, too be sure You're correctly doing this let's reformat the " +"code automatically:" +msgstr "" + +#: ../../contributing.rst:104 +msgid "Run tests" +msgstr "" + +#: ../../contributing.rst:106 +msgid "All changes should be tested:" +msgstr "" + +#: ../../contributing.rst:112 +msgid "" +"Also if you are doing something with Redis-storage, you will need to test" +" everything works with Redis:" +msgstr "" + +#: ../../contributing.rst:119 +msgid "Docs" +msgstr "" + +#: ../../contributing.rst:121 +msgid "" +"We are using `Sphinx` to render docs in different languages, all sources " +"located in `docs` directory, you can change the sources and to test it " +"you can start live-preview server and look what you are doing:" +msgstr "" + +#: ../../contributing.rst:130 +msgid "Docs translations" +msgstr "" + +#: ../../contributing.rst:132 +msgid "" +"Translation of the documentation is very necessary and cannot be done " +"without the help of the community from all over the world, so you are " +"welcome to translate the documentation into different languages." +msgstr "" + +#: ../../contributing.rst:136 +msgid "Before start, let's up to date all texts:" +msgstr "" + +#: ../../contributing.rst:144 +msgid "" +"Change the :code:`` in example below to the target " +"language code, after that you can modify texts inside " +":code:`docs/locale//LC_MESSAGES` as :code:`*.po` files by " +"using any text-editor or specialized utilites for GNU Gettext, for " +"example via `poedit `_." +msgstr "" + +#: ../../contributing.rst:149 +msgid "To view results:" +msgstr "" + +#: ../../contributing.rst:157 +msgid "Describe changes" +msgstr "" + +#: ../../contributing.rst:159 +msgid "" +"Describe your changes in one or more sentences so that bot developers " +"know what's changed in their favorite framework - create " +"`..rst` file and write the description." +msgstr "" + +#: ../../contributing.rst:162 +msgid "" +":code:`` is Issue or Pull-request number, after release link to " +"this issue will be published to the *Changelog* page." +msgstr "" + +#: ../../contributing.rst:165 +msgid ":code:`` is a changes category marker, it can be one of:" +msgstr "" + +#: ../../contributing.rst:167 +msgid ":code:`feature` - when you are implementing new feature" +msgstr "" + +#: ../../contributing.rst:168 +msgid ":code:`bugfix` - when you fix a bug" +msgstr "" + +#: ../../contributing.rst:169 +msgid ":code:`doc` - when you improve the docs" +msgstr "" + +#: ../../contributing.rst:170 +msgid ":code:`removal` - when you remove something from the framework" +msgstr "" + +#: ../../contributing.rst:171 +msgid "" +":code:`misc` - when changed something inside the Core or project " +"configuration" +msgstr "" + +#: ../../contributing.rst:173 +msgid "" +"If you have troubles with changing category feel free to ask Core-" +"contributors to help with choosing it." +msgstr "" + +#: ../../contributing.rst:176 +msgid "Complete" +msgstr "" + +#: ../../contributing.rst:178 +msgid "" +"After you have made all your changes, publish them to the repository and " +"create a pull request as mentioned at the beginning of the article and " +"wait for a review of these changes." +msgstr "" + +#: ../../contributing.rst:183 +msgid "Star on GitHub" +msgstr "" + +#: ../../contributing.rst:185 +msgid "" +"You can \"star\" repository on GitHub - " +"https://github.com/aiogram/aiogram (click the star button at the top " +"right)" +msgstr "" + +#: ../../contributing.rst:187 +msgid "" +"Adding stars makes it easier for other people to find this project and " +"understand how useful it is." +msgstr "" + +#: ../../contributing.rst:190 +msgid "Guides" +msgstr "" + +#: ../../contributing.rst:192 +msgid "" +"You can write guides how to develop Bots on top of aiogram and publish it" +" into YouTube, Medium, GitHub Books, any Courses platform or any other " +"platform that you know." +msgstr "" + +#: ../../contributing.rst:195 +msgid "" +"This will help more people learn about the framework and learn how to use" +" it" +msgstr "" + +#: ../../contributing.rst:199 +msgid "Take answers" +msgstr "" + +#: ../../contributing.rst:201 +msgid "" +"The developers is always asks for any question in our chats or any other " +"platforms like GitHub Discussions, StackOverflow and others, feel free to" +" answer to this questions." +msgstr "" + +#: ../../contributing.rst:205 +msgid "Funding" +msgstr "" + +#: ../../contributing.rst:207 +msgid "" +"The development of the project is free and not financed by commercial " +"organizations, it is my personal initiative (`@JRootJunior " +"`_) and I am engaged in the development of the " +"project in my free time." +msgstr "" + +#: ../../contributing.rst:211 +msgid "" +"So, if you want to financially support the project, or, for example, give" +" me a pizza or a beer, you can do it on `OpenCollective " +"`_ or `Patreon " +"`_." +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po b/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po index 21372b3e..d21aea70 100644 --- a/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po +++ b/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../dispatcher/dispatcher.rst:3 msgid "Dispatcher" @@ -92,23 +92,43 @@ msgstr "" msgid "Run many bots with polling" msgstr "" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:3 of -msgid "Bot instances" +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:3 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:3 of +msgid "Bot instances (one or mre)" msgstr "" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:4 of -msgid "Poling timeout" +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:4 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:4 of +msgid "Long-polling wait time" msgstr "" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:6 of +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:5 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:5 of msgid "Run task for each event and no wait result" msgstr "" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:7 of +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:6 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:6 of +msgid "backoff-retry config" +msgstr "" + +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:7 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:7 of msgid "List of the update types you want your bot to receive" msgstr "" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:8 of +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:8 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:8 of +msgid "handle signals (SIGINT/SIGTERM)" +msgstr "" + +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:9 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:9 of +msgid "close bot sessions on shutdown" +msgstr "" + +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:10 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:10 of msgid "contextual data" msgstr "" @@ -142,3 +162,9 @@ msgid "" "All updates can be propagated to the dispatcher by " ":obj:`Dispatcher.feed_update(bot=..., update=...)` method:" msgstr "" + +#~ msgid "Bot instances" +#~ msgstr "" + +#~ msgid "Poling timeout" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/index.po b/docs/locale/en/LC_MESSAGES/index.po index 5ac82a19..beb8f6d9 100644 --- a/docs/locale/en/LC_MESSAGES/index.po +++ b/docs/locale/en/LC_MESSAGES/index.po @@ -8,20 +8,20 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-30 22:28+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../../README.rst:3 msgid "aiogram |beta badge|" msgstr "" -#: ../../../README.rst:98 +#: ../../../README.rst:94 msgid "Beta badge" msgstr "" @@ -33,6 +33,18 @@ msgstr "" msgid "MIT License" msgstr "" +#: ../../../README.rst:-1 +msgid "PyPi status" +msgstr "" + +#: ../../../README.rst:-1 +msgid "PyPi Package Version" +msgstr "" + +#: ../../../README.rst:-1 +msgid "Downloads" +msgstr "" + #: ../../../README.rst:-1 msgid "Supported python versions" msgstr "" @@ -45,27 +57,11 @@ msgstr "" msgid "Tests" msgstr "" -#: ../../../README.rst:-1 -msgid "PyPi Package Version" -msgstr "" - -#: ../../../README.rst:-1 -msgid "PyPi status" -msgstr "" - -#: ../../../README.rst:-1 -msgid "Downloads" -msgstr "" - -#: ../../../README.rst:-1 -msgid "[Telegram] aiogram live" -msgstr "" - #: ../../../README.rst:-1 msgid "Codecov" msgstr "" -#: ../../../README.rst:44 +#: ../../../README.rst:40 msgid "" "**aiogram** is a modern and fully asynchronous framework for `Telegram " "Bot API `_ written in Python 3.8 " @@ -73,136 +69,136 @@ msgid "" "`aiohttp `_." msgstr "" -#: ../../../README.rst:49 +#: ../../../README.rst:45 msgid "Make your bots faster and more powerful!" msgstr "" -#: ../../../README.rst:54 +#: ../../../README.rst:50 msgid "Documentation:" msgstr "" -#: ../../../README.rst:52 +#: ../../../README.rst:48 msgid "🇺🇸 `English `_" msgstr "" -#: ../../../README.rst:53 +#: ../../../README.rst:49 msgid "🇺🇦 `Ukrainian `_" msgstr "" -#: ../../../README.rst:58 +#: ../../../README.rst:54 msgid "**Breaking News:**" msgstr "" -#: ../../../README.rst:60 +#: ../../../README.rst:56 msgid "*aiogram* 3.0 has breaking changes." msgstr "" -#: ../../../README.rst:62 +#: ../../../README.rst:58 msgid "It breaks backward compatibility by introducing new breaking changes!" msgstr "" -#: ../../../README.rst:65 +#: ../../../README.rst:61 msgid "Features" msgstr "" -#: ../../../README.rst:67 +#: ../../../README.rst:63 msgid "" "Asynchronous (`asyncio docs " "`_, :pep:`492`)" msgstr "" -#: ../../../README.rst:68 +#: ../../../README.rst:64 msgid "" "Has type hints (:pep:`484`) and can be used with `mypy `_" msgstr "" -#: ../../../README.rst:69 +#: ../../../README.rst:65 msgid "Supports `PyPy `_" msgstr "" -#: ../../../README.rst:70 +#: ../../../README.rst:66 msgid "" -"Supports `Telegram Bot API 6.4 `_ and" +"Supports `Telegram Bot API 6.6 `_ and" " gets fast updates to the latest versions of the Bot API" msgstr "" -#: ../../../README.rst:71 +#: ../../../README.rst:67 msgid "" "Telegram Bot API integration code was `autogenerated " "`_ and can be easily re-generated " "when API gets updated" msgstr "" -#: ../../../README.rst:72 +#: ../../../README.rst:68 msgid "Updates router (Blueprints)" msgstr "" -#: ../../../README.rst:73 +#: ../../../README.rst:69 msgid "Has Finite State Machine" msgstr "" -#: ../../../README.rst:74 +#: ../../../README.rst:70 msgid "" "Uses powerful `magic filters " "`" msgstr "" -#: ../../../README.rst:75 +#: ../../../README.rst:71 msgid "Middlewares (incoming updates and API calls)" msgstr "" -#: ../../../README.rst:76 +#: ../../../README.rst:72 msgid "" "Provides `Replies into Webhook `_" msgstr "" -#: ../../../README.rst:77 +#: ../../../README.rst:73 msgid "Integrated I18n/L10n support with GNU Gettext (or Fluent)" msgstr "" -#: ../../../README.rst:82 +#: ../../../README.rst:78 msgid "" "It is strongly advised that you have prior experience working with " "`asyncio `_ before " "beginning to use **aiogram**." msgstr "" -#: ../../../README.rst:86 +#: ../../../README.rst:82 msgid "If you have any questions, you can visit our community chats on Telegram:" msgstr "" -#: ../../../README.rst:88 +#: ../../../README.rst:84 msgid "🇺🇸 `@aiogram `_" msgstr "" -#: ../../../README.rst:89 +#: ../../../README.rst:85 msgid "🇺🇦 `@aiogramua `_" msgstr "" -#: ../../../README.rst:90 +#: ../../../README.rst:86 msgid "🇺🇿 `@aiogram_uz `_" msgstr "" -#: ../../../README.rst:91 +#: ../../../README.rst:87 msgid "🇰🇿 `@aiogram_kz `_" msgstr "" -#: ../../../README.rst:92 +#: ../../../README.rst:88 msgid "🇷🇺 `@aiogram_ru `_" msgstr "" -#: ../../../README.rst:93 +#: ../../../README.rst:89 msgid "🇮🇷 `@aiogram_fa `_" msgstr "" -#: ../../../README.rst:94 +#: ../../../README.rst:90 msgid "🇮🇹 `@aiogram_it `_" msgstr "" -#: ../../../README.rst:95 +#: ../../../README.rst:91 msgid "🇧🇷 `@aiogram_br `_" msgstr "" @@ -223,3 +219,13 @@ msgstr "" #~ " updates to the latest versions of" #~ " the Bot API" #~ msgstr "" + +#~ msgid "[Telegram] aiogram live" +#~ msgstr "" + +#~ msgid "" +#~ "Supports `Telegram Bot API 6.4 " +#~ "`_ and gets fast" +#~ " updates to the latest versions of" +#~ " the Bot API" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/utils/callback_answer.po b/docs/locale/en/LC_MESSAGES/utils/callback_answer.po new file mode 100644 index 00000000..daa3c973 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/utils/callback_answer.po @@ -0,0 +1,204 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../utils/callback_answer.rst:4 +msgid "Callback answer" +msgstr "" + +#: ../../utils/callback_answer.rst:6 +msgid "" +"Helper for callback query handlers, can be useful in bots with a lot of " +"callback handlers to automatically take answer to all requests." +msgstr "" + +#: ../../utils/callback_answer.rst:10 +msgid "Simple usage" +msgstr "" + +#: ../../utils/callback_answer.rst:12 +msgid "" +"For use, it is enough to register the inner middleware " +":class:`aiogram.utils.callback_answer.CallbackAnswerMiddleware` in " +"dispatcher or specific router:" +msgstr "" + +#: ../../utils/callback_answer.rst:18 +msgid "" +"After that all handled callback queries will be answered automatically " +"after processing the handler." +msgstr "" + +#: ../../utils/callback_answer.rst:21 +msgid "Advanced usage" +msgstr "" + +#: ../../utils/callback_answer.rst:23 +msgid "" +"In some cases you need to have some non-standard response parameters, " +"this can be done in several ways:" +msgstr "" + +#: ../../utils/callback_answer.rst:26 +msgid "Global defaults" +msgstr "" + +#: ../../utils/callback_answer.rst:28 +msgid "" +"Change default parameters while initializing middleware, for example " +"change answer to `pre` mode and text \"OK\":" +msgstr "" + +#: ../../utils/callback_answer.rst:35 +msgid "" +"Look at :class:`aiogram.utils.callback_answer.CallbackAnswerMiddleware` " +"to get all available parameters" +msgstr "" + +#: ../../utils/callback_answer.rst:39 +msgid "Handler specific" +msgstr "" + +#: ../../utils/callback_answer.rst:41 +msgid "" +"By using :ref:`flags ` you can change the behavior for specific " +"handler" +msgstr "" + +#: ../../utils/callback_answer.rst:50 +msgid "" +"Flag arguments is the same as in " +":class:`aiogram.utils.callback_answer.CallbackAnswerMiddleware` with " +"additional one :code:`disabled` to disable answer." +msgstr "" + +#: ../../utils/callback_answer.rst:54 +msgid "A special case" +msgstr "" + +#: ../../utils/callback_answer.rst:56 +msgid "" +"It is not always correct to answer the same in every case, so there is an" +" option to change the answer inside the handler. You can get an instance " +"of :class:`aiogram.utils.callback_answer.CallbackAnswer` object inside " +"handler and change whatever you want." +msgstr "" + +#: ../../utils/callback_answer.rst:61 +msgid "" +"Note that is impossible to change callback answer attributes when you use" +" :code:`pre=True` mode." +msgstr "" + +#: ../../utils/callback_answer.rst:76 +msgid "Combine that all at once" +msgstr "" + +#: ../../utils/callback_answer.rst:78 +msgid "" +"For example you want to answer in most of cases before handler with text " +"\"🤔\" but at some cases need to answer after the handler with custom " +"text, so you can do it:" +msgstr "" + +#: ../../utils/callback_answer.rst:94 +msgid "Description of objects" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware:1 of +msgid "Bases: :py:class:`~aiogram.dispatcher.middlewares.base.BaseMiddleware`" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware.__init__:1 of +msgid "" +"Inner middleware for callback query handlers, can be useful in bots with " +"a lot of callback handlers to automatically take answer to all requests" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__ +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware.__init__ of +msgid "Parameters" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware.__init__:4 of +msgid "send answer before execute handler" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__:5 +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware.__init__:5 of +msgid "answer with text" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__:6 +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware.__init__:6 of +msgid "show alert" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__:7 +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware.__init__:7 of +msgid "game url" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__:8 +#: aiogram.utils.callback_answer.CallbackAnswerMiddleware.__init__:8 of +msgid "cache answer for some time" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer:1 of +msgid "Bases: :py:class:`object`" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__:1 of +msgid "Callback answer configuration" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__:3 of +msgid "this request is already answered by middleware" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.__init__:4 of +msgid "answer will not be performed" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.disable:1 of +msgid "Deactivate answering for this handler" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.disabled:1 of +msgid "Indicates that automatic answer is disabled in this handler" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.answered:1 of +msgid "Indicates that request is already answered by middleware" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.text:1 of +msgid "Response text :return:" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.show_alert:1 of +msgid "Whether to display an alert" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.url:1 of +msgid "Game url" +msgstr "" + +#: aiogram.utils.callback_answer.CallbackAnswer.cache_time:1 of +msgid "Response cache time" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/inline_query_result_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/inline_query_result_type.po index 0baa2869..6b275e0f 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/enums/inline_query_result_type.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/inline_query_result_type.po @@ -8,23 +8,27 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/enums/inline_query_result_type.rst:3 msgid "InlineQueryResultType" msgstr "" #: aiogram.enums.inline_query_result_type.InlineQueryResultType:1 of -msgid "The part of the face relative to which the mask should be placed." -msgstr "Частина обличчя, щодо якої слід розмістити маску." +msgid "Type of inline query result" +msgstr "" #: aiogram.enums.inline_query_result_type.InlineQueryResultType:3 of -msgid "Source: https://core.telegram.org/bots/api#maskposition" +#, fuzzy +msgid "Source: https://core.telegram.org/bots/api#inlinequeryresult" msgstr "Джерело: https://core.telegram.org/bots/api#maskposition" + +#~ msgid "The part of the face relative to which the mask should be placed." +#~ msgstr "Частина обличчя, щодо якої слід розмістити маску." diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/sticker_format.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/sticker_format.po new file mode 100644 index 00000000..57a8b198 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/sticker_format.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/enums/sticker_format.rst:3 +msgid "StickerFormat" +msgstr "" + +#: aiogram.enums.sticker_format.StickerFormat:1 of +msgid "Format of the sticker" +msgstr "" + +#: aiogram.enums.sticker_format.StickerFormat:3 of +msgid "Source: https://core.telegram.org/bots/api#createnewstickerset" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/add_sticker_to_set.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/add_sticker_to_set.po index f3b81bcd..483b44cd 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/add_sticker_to_set.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/add_sticker_to_set.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/add_sticker_to_set.rst:3 msgid "addStickerToSet" @@ -27,12 +27,11 @@ msgstr "" #: aiogram.methods.add_sticker_to_set.AddStickerToSet:1 of msgid "" -"Use this method to add a new sticker to a set created by the bot. You " -"**must** use exactly one of the fields *png_sticker*, *tgs_sticker*, or " -"*webm_sticker*. Animated stickers can be added to animated sticker sets " -"and only to them. Animated sticker sets can have up to 50 stickers. " -"Static sticker sets can have up to 120 stickers. Returns :code:`True` on " -"success." +"Use this method to add a new sticker to a set created by the bot. The " +"format of the added sticker must match the format of the other stickers " +"in the set. Emoji sticker sets can have up to 200 stickers. Animated and " +"video sticker sets can have up to 50 stickers. Static sticker sets can " +"have up to 120 stickers. Returns :code:`True` on success." msgstr "" #: aiogram.methods.add_sticker_to_set.AddStickerToSet:3 of @@ -48,49 +47,12 @@ msgstr "" msgid "Sticker set name" msgstr "" -#: ../../docstring aiogram.methods.add_sticker_to_set.AddStickerToSet.emojis:1 +#: ../../docstring aiogram.methods.add_sticker_to_set.AddStickerToSet.sticker:1 #: of -msgid "One or more emoji corresponding to the sticker" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.png_sticker:1 of msgid "" -"**PNG** image with the sticker, must be up to 512 kilobytes in size, " -"dimensions must not exceed 512px, and either width or height must be " -"exactly 512px. Pass a *file_id* as a String to send a file that already " -"exists on the Telegram servers, pass an HTTP URL as a String for Telegram" -" to get a file from the Internet, or upload a new one using multipart" -"/form-data. :ref:`More information on Sending Files » `" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.tgs_sticker:1 of -msgid "" -"**TGS** animation with the sticker, uploaded using multipart/form-data. " -"See `https://core.telegram.org/stickers#animated-sticker-requirements " -"`_`https://core.telegram.org/stickers#animated-sticker-" -"requirements `_ for technical requirements" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.webm_sticker:1 of -msgid "" -"**WEBM** video with the sticker, uploaded using multipart/form-data. See " -"`https://core.telegram.org/stickers#video-sticker-requirements " -"`_`https://core.telegram.org/stickers#video-sticker-" -"requirements `_ for technical requirements" -msgstr "" - -#: ../../docstring -#: aiogram.methods.add_sticker_to_set.AddStickerToSet.mask_position:1 of -msgid "" -"A JSON-serialized object for position where the mask should be placed on " -"faces" +"A JSON-serialized object with information about the added sticker. If " +"exactly the same sticker had already been added to the set, then the set " +"isn't changed." msgstr "" #: ../../api/methods/add_sticker_to_set.rst:14 @@ -124,3 +86,64 @@ msgstr "" #: ../../api/methods/add_sticker_to_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to add a new " +#~ "sticker to a set created by the" +#~ " bot. You **must** use exactly one" +#~ " of the fields *png_sticker*, " +#~ "*tgs_sticker*, or *webm_sticker*. Animated " +#~ "stickers can be added to animated " +#~ "sticker sets and only to them. " +#~ "Animated sticker sets can have up " +#~ "to 50 stickers. Static sticker sets " +#~ "can have up to 120 stickers. " +#~ "Returns :code:`True` on success." +#~ msgstr "" + +#~ msgid "One or more emoji corresponding to the sticker" +#~ msgstr "" + +#~ msgid "" +#~ "**PNG** image with the sticker, must " +#~ "be up to 512 kilobytes in size," +#~ " dimensions must not exceed 512px, " +#~ "and either width or height must be" +#~ " exactly 512px. Pass a *file_id* as" +#~ " a String to send a file that" +#~ " already exists on the Telegram " +#~ "servers, pass an HTTP URL as a " +#~ "String for Telegram to get a file" +#~ " from the Internet, or upload a " +#~ "new one using multipart/form-data. " +#~ ":ref:`More information on Sending Files " +#~ "» `" +#~ msgstr "" + +#~ msgid "" +#~ "**TGS** animation with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#animated-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#animated-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "**WEBM** video with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#video-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#video-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "A JSON-serialized object for position" +#~ " where the mask should be placed " +#~ "on faces" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_new_sticker_set.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_new_sticker_set.po index 1d3789be..045ca8f0 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_new_sticker_set.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_new_sticker_set.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/create_new_sticker_set.rst:3 msgid "createNewStickerSet" @@ -28,9 +28,8 @@ msgstr "" #: aiogram.methods.create_new_sticker_set.CreateNewStickerSet:1 of msgid "" "Use this method to create a new sticker set owned by a user. The bot will" -" be able to edit the sticker set thus created. You **must** use exactly " -"one of the fields *png_sticker*, *tgs_sticker*, or *webm_sticker*. " -"Returns :code:`True` on success." +" be able to edit the sticker set thus created. Returns :code:`True` on " +"success." msgstr "" #: aiogram.methods.create_new_sticker_set.CreateNewStickerSet:3 of @@ -58,57 +57,35 @@ msgid "Sticker set title, 1-64 characters" msgstr "" #: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.emojis:1 of -msgid "One or more emoji corresponding to the sticker" +#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.stickers:1 of +msgid "" +"A JSON-serialized list of 1-50 initial stickers to be added to the " +"sticker set" msgstr "" #: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.png_sticker:1 of +#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.sticker_format:1 +#: of msgid "" -"**PNG** image with the sticker, must be up to 512 kilobytes in size, " -"dimensions must not exceed 512px, and either width or height must be " -"exactly 512px. Pass a *file_id* as a String to send a file that already " -"exists on the Telegram servers, pass an HTTP URL as a String for Telegram" -" to get a file from the Internet, or upload a new one using multipart" -"/form-data. :ref:`More information on Sending Files » `" -msgstr "" - -#: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.tgs_sticker:1 of -msgid "" -"**TGS** animation with the sticker, uploaded using multipart/form-data. " -"See `https://core.telegram.org/stickers#animated-sticker-requirements " -"`_`https://core.telegram.org/stickers#animated-sticker-" -"requirements `_ for technical requirements" -msgstr "" - -#: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.webm_sticker:1 of -msgid "" -"**WEBM** video with the sticker, uploaded using multipart/form-data. See " -"`https://core.telegram.org/stickers#video-sticker-requirements " -"`_`https://core.telegram.org/stickers#video-sticker-" -"requirements `_ for technical requirements" +"Format of stickers in the set, must be one of 'static', 'animated', " +"'video'" msgstr "" #: ../../docstring #: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.sticker_type:1 of msgid "" -"Type of stickers in the set, pass 'regular' or 'mask'. Custom emoji " -"sticker sets can't be created via the Bot API at the moment. By default, " -"a regular sticker set is created." +"Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. " +"By default, a regular sticker set is created." msgstr "" #: ../../docstring -#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.mask_position:1 +#: aiogram.methods.create_new_sticker_set.CreateNewStickerSet.needs_repainting:1 #: of msgid "" -"A JSON-serialized object for position where the mask should be placed on " -"faces" +"Pass :code:`True` if stickers in the sticker set must be repainted to the" +" color of text when used in messages, the accent color if used as emoji " +"status, white on chat photos, or another appropriate color based on " +"context; for custom emoji sticker sets only" msgstr "" #: ../../api/methods/create_new_sticker_set.rst:14 @@ -144,3 +121,70 @@ msgstr "" #: ../../api/methods/create_new_sticker_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to create a new" +#~ " sticker set owned by a user. " +#~ "The bot will be able to edit " +#~ "the sticker set thus created. You " +#~ "**must** use exactly one of the " +#~ "fields *png_sticker*, *tgs_sticker*, or " +#~ "*webm_sticker*. Returns :code:`True` on " +#~ "success." +#~ msgstr "" + +#~ msgid "One or more emoji corresponding to the sticker" +#~ msgstr "" + +#~ msgid "" +#~ "**PNG** image with the sticker, must " +#~ "be up to 512 kilobytes in size," +#~ " dimensions must not exceed 512px, " +#~ "and either width or height must be" +#~ " exactly 512px. Pass a *file_id* as" +#~ " a String to send a file that" +#~ " already exists on the Telegram " +#~ "servers, pass an HTTP URL as a " +#~ "String for Telegram to get a file" +#~ " from the Internet, or upload a " +#~ "new one using multipart/form-data. " +#~ ":ref:`More information on Sending Files " +#~ "» `" +#~ msgstr "" + +#~ msgid "" +#~ "**TGS** animation with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#animated-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#animated-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "**WEBM** video with the sticker, " +#~ "uploaded using multipart/form-data. See " +#~ "`https://core.telegram.org/stickers#video-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#video-sticker-requirements " +#~ "`_ for technical requirements" +#~ msgstr "" + +#~ msgid "" +#~ "Type of stickers in the set, pass" +#~ " 'regular' or 'mask'. Custom emoji " +#~ "sticker sets can't be created via " +#~ "the Bot API at the moment. By " +#~ "default, a regular sticker set is " +#~ "created." +#~ msgstr "" + +#~ msgid "" +#~ "A JSON-serialized object for position" +#~ " where the mask should be placed " +#~ "on faces" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_set.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_set.po new file mode 100644 index 00000000..b0d56a23 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_set.po @@ -0,0 +1,73 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/delete_sticker_set.rst:3 +msgid "deleteStickerSet" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.delete_sticker_set.DeleteStickerSet:1 of +msgid "" +"Use this method to delete a sticker set that was created by the bot. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.delete_sticker_set.DeleteStickerSet:3 of +msgid "Source: https://core.telegram.org/bots/api#deletestickerset" +msgstr "" + +#: ../../docstring aiogram.methods.delete_sticker_set.DeleteStickerSet.name:1 +#: of +msgid "Sticker set name" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:29 +msgid ":code:`from aiogram.methods.delete_sticker_set import DeleteStickerSet`" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:30 +msgid "alias: :code:`from aiogram.methods import DeleteStickerSet`" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/delete_sticker_set.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_description.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_description.po new file mode 100644 index 00000000..b7ae81ab --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_description.po @@ -0,0 +1,70 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/get_my_description.rst:3 +msgid "getMyDescription" +msgstr "" + +#: ../../api/methods/get_my_description.rst:5 +msgid "Returns: :obj:`BotDescription`" +msgstr "" + +#: aiogram.methods.get_my_description.GetMyDescription:1 of +msgid "" +"Use this method to get the current bot description for the given user " +"language. Returns :class:`aiogram.types.bot_description.BotDescription` " +"on success." +msgstr "" + +#: aiogram.methods.get_my_description.GetMyDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#getmydescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.get_my_description.GetMyDescription.language_code:1 of +msgid "A two-letter ISO 639-1 language code or an empty string" +msgstr "" + +#: ../../api/methods/get_my_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/get_my_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/get_my_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/get_my_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/get_my_description.rst:29 +msgid ":code:`from aiogram.methods.get_my_description import GetMyDescription`" +msgstr "" + +#: ../../api/methods/get_my_description.rst:30 +msgid "alias: :code:`from aiogram.methods import GetMyDescription`" +msgstr "" + +#: ../../api/methods/get_my_description.rst:33 +msgid "With specific bot" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_short_description.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_short_description.po new file mode 100644 index 00000000..0d4e2e77 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_my_short_description.po @@ -0,0 +1,74 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/get_my_short_description.rst:3 +msgid "getMyShortDescription" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:5 +msgid "Returns: :obj:`BotShortDescription`" +msgstr "" + +#: aiogram.methods.get_my_short_description.GetMyShortDescription:1 of +msgid "" +"Use this method to get the current bot short description for the given " +"user language. Returns " +":class:`aiogram.types.bot_short_description.BotShortDescription` on " +"success." +msgstr "" + +#: aiogram.methods.get_my_short_description.GetMyShortDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#getmyshortdescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.get_my_short_description.GetMyShortDescription.language_code:1 +#: of +msgid "A two-letter ISO 639-1 language code or an empty string" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:29 +msgid "" +":code:`from aiogram.methods.get_my_short_description import " +"GetMyShortDescription`" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:30 +msgid "alias: :code:`from aiogram.methods import GetMyShortDescription`" +msgstr "" + +#: ../../api/methods/get_my_short_description.rst:33 +msgid "With specific bot" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_sticker.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_sticker.po index b1e8bcb0..24650fbd 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_sticker.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_sticker.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/send_sticker.rst:3 msgid "sendSticker" @@ -48,9 +48,10 @@ msgstr "" msgid "" "Sticker to send. Pass a file_id as String to send a file that exists on " "the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a .WEBP file from the Internet, or upload a new one using" -" multipart/form-data. :ref:`More information on Sending Files » `" +"Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP " +"or .TGS sticker using multipart/form-data. :ref:`More information on " +"Sending Files » `. Video stickers can only be sent by a " +"file_id. Animated stickers can't be sent via an HTTP URL." msgstr "" #: ../../docstring aiogram.methods.send_sticker.SendSticker.message_thread_id:1 @@ -60,6 +61,10 @@ msgid "" " forum supergroups only" msgstr "" +#: ../../docstring aiogram.methods.send_sticker.SendSticker.emoji:1 of +msgid "Emoji associated with the sticker; only for just uploaded stickers" +msgstr "" + #: ../../docstring #: aiogram.methods.send_sticker.SendSticker.disable_notification:1 of msgid "" @@ -147,3 +152,15 @@ msgstr "" #~ "to remove reply keyboard or to " #~ "force a reply from the user." #~ msgstr "" + +#~ msgid "" +#~ "Sticker to send. Pass a file_id as" +#~ " String to send a file that " +#~ "exists on the Telegram servers " +#~ "(recommended), pass an HTTP URL as " +#~ "a String for Telegram to get a " +#~ ".WEBP file from the Internet, or " +#~ "upload a new one using multipart" +#~ "/form-data. :ref:`More information on " +#~ "Sending Files » `" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po new file mode 100644 index 00000000..afadc9a2 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_custom_emoji_sticker_set_thumbnail.po @@ -0,0 +1,90 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:3 +msgid "setCustomEmojiStickerSetThumbnail" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail:1 +#: of +msgid "" +"Use this method to set the thumbnail of a custom emoji sticker set. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail:3 +#: of +msgid "" +"Source: " +"https://core.telegram.org/bots/api#setcustomemojistickersetthumbnail" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail.name:1 +#: of +msgid "Sticker set name" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_custom_emoji_sticker_set_thumbnail.SetCustomEmojiStickerSetThumbnail.custom_emoji_id:1 +#: of +msgid "" +"Custom emoji identifier of a sticker from the sticker set; pass an empty " +"string to drop the thumbnail and use the first sticker as the thumbnail." +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:29 +msgid "" +":code:`from aiogram.methods.set_custom_emoji_sticker_set_thumbnail import" +" SetCustomEmojiStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:30 +msgid "" +"alias: :code:`from aiogram.methods import " +"SetCustomEmojiStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_custom_emoji_sticker_set_thumbnail.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po index 93f19f31..87382f51 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_default_administrator_rights.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/set_my_default_administrator_rights.rst:3 msgid "setMyDefaultAdministratorRights" @@ -30,8 +30,8 @@ msgstr "" msgid "" "Use this method to change the default administrator rights requested by " "the bot when it's added as an administrator to groups or channels. These " -"rights will be suggested to users, but they are are free to modify the " -"list before adding the bot. Returns :code:`True` on success." +"rights will be suggested to users, but they are free to modify the list " +"before adding the bot. Returns :code:`True` on success." msgstr "" #: aiogram.methods.set_my_default_administrator_rights.SetMyDefaultAdministratorRights:3 @@ -89,3 +89,14 @@ msgstr "" #: ../../api/methods/set_my_default_administrator_rights.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to change the " +#~ "default administrator rights requested by " +#~ "the bot when it's added as an " +#~ "administrator to groups or channels. " +#~ "These rights will be suggested to " +#~ "users, but they are are free to" +#~ " modify the list before adding the" +#~ " bot. Returns :code:`True` on success." +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_description.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_description.po new file mode 100644 index 00000000..b266de07 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_description.po @@ -0,0 +1,83 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_my_description.rst:3 +msgid "setMyDescription" +msgstr "" + +#: ../../api/methods/set_my_description.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_my_description.SetMyDescription:1 of +msgid "" +"Use this method to change the bot's description, which is shown in the " +"chat with the bot if the chat is empty. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_my_description.SetMyDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#setmydescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_description.SetMyDescription.description:1 of +msgid "" +"New bot description; 0-512 characters. Pass an empty string to remove the" +" dedicated description for the given language." +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_description.SetMyDescription.language_code:1 of +msgid "" +"A two-letter ISO 639-1 language code. If empty, the description will be " +"applied to all users for whose language there is no dedicated " +"description." +msgstr "" + +#: ../../api/methods/set_my_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_my_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_my_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_my_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_my_description.rst:29 +msgid ":code:`from aiogram.methods.set_my_description import SetMyDescription`" +msgstr "" + +#: ../../api/methods/set_my_description.rst:30 +msgid "alias: :code:`from aiogram.methods import SetMyDescription`" +msgstr "" + +#: ../../api/methods/set_my_description.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_my_description.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_short_description.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_short_description.po new file mode 100644 index 00000000..eb4e343b --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_my_short_description.po @@ -0,0 +1,88 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_my_short_description.rst:3 +msgid "setMyShortDescription" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_my_short_description.SetMyShortDescription:1 of +msgid "" +"Use this method to change the bot's short description, which is shown on " +"the bot's profile page and is sent together with the link when users " +"share the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_my_short_description.SetMyShortDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#setmyshortdescription" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_short_description.SetMyShortDescription.short_description:1 +#: of +msgid "" +"New short description for the bot; 0-120 characters. Pass an empty string" +" to remove the dedicated short description for the given language." +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_my_short_description.SetMyShortDescription.language_code:1 +#: of +msgid "" +"A two-letter ISO 639-1 language code. If empty, the short description " +"will be applied to all users for whose language there is no dedicated " +"short description." +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:29 +msgid "" +":code:`from aiogram.methods.set_my_short_description import " +"SetMyShortDescription`" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:30 +msgid "alias: :code:`from aiogram.methods import SetMyShortDescription`" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_my_short_description.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_emoji_list.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_emoji_list.po new file mode 100644 index 00000000..ad3536b3 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_emoji_list.po @@ -0,0 +1,81 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_emoji_list.rst:3 +msgid "setStickerEmojiList" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList:1 of +msgid "" +"Use this method to change the list of emoji assigned to a regular or " +"custom emoji sticker. The sticker must belong to a sticker set created by" +" the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickeremojilist" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList.sticker:1 of +msgid "File identifier of the sticker" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_emoji_list.SetStickerEmojiList.emoji_list:1 of +msgid "A JSON-serialized list of 1-20 emoji associated with the sticker" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_emoji_list import " +"SetStickerEmojiList`" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerEmojiList`" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_emoji_list.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_keywords.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_keywords.po new file mode 100644 index 00000000..22dfb120 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_keywords.po @@ -0,0 +1,83 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_keywords.rst:3 +msgid "setStickerKeywords" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords:1 of +msgid "" +"Use this method to change search keywords assigned to a regular or custom" +" emoji sticker. The sticker must belong to a sticker set created by the " +"bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickerkeywords" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords.sticker:1 of +msgid "File identifier of the sticker" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_keywords.SetStickerKeywords.keywords:1 of +msgid "" +"A JSON-serialized list of 0-20 search keywords for the sticker with total" +" length of up to 64 characters" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_keywords import " +"SetStickerKeywords`" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerKeywords`" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_keywords.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_mask_position.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_mask_position.po new file mode 100644 index 00000000..8efc08ba --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_mask_position.po @@ -0,0 +1,86 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_mask_position.rst:3 +msgid "setStickerMaskPosition" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition:1 of +msgid "" +"Use this method to change the `mask position " +"`_ of a mask sticker. " +"The sticker must belong to a sticker set that was created by the bot. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickermaskposition" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition.sticker:1 +#: of +msgid "File identifier of the sticker" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_mask_position.SetStickerMaskPosition.mask_position:1 +#: of +msgid "" +"A JSON-serialized object with the position where the mask should be " +"placed on faces. Omit the parameter to remove the mask position." +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_mask_position import " +"SetStickerMaskPosition`" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerMaskPosition`" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_mask_position.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumb.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumb.po index cb1608e8..8e279db0 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumb.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumb.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/set_sticker_set_thumb.rst:3 msgid "setStickerSetThumb" @@ -25,52 +25,6 @@ msgstr "" msgid "Returns: :obj:`bool`" msgstr "" -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb:1 of -msgid "" -"Use this method to set the thumbnail of a sticker set. Animated " -"thumbnails can be set for animated sticker sets only. Video thumbnails " -"can be set only for video sticker sets only. Returns :code:`True` on " -"success." -msgstr "" - -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb:3 of -msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" -msgstr "" - -#: ../../docstring -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb.name:1 of -msgid "Sticker set name" -msgstr "" - -#: ../../docstring -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb.user_id:1 of -msgid "User identifier of the sticker set owner" -msgstr "" - -#: ../../docstring -#: aiogram.methods.set_sticker_set_thumb.SetStickerSetThumb.thumb:1 of -msgid "" -"A **PNG** image with the thumbnail, must be up to 128 kilobytes in size " -"and have width and height exactly 100px, or a **TGS** animation with the " -"thumbnail up to 32 kilobytes in size; see " -"`https://core.telegram.org/stickers#animated-sticker-requirements " -"`_`https://core.telegram.org/stickers#animated-sticker-" -"requirements `_ for animated sticker technical requirements, or a " -"**WEBM** video with the thumbnail up to 32 kilobytes in size; see " -"`https://core.telegram.org/stickers#video-sticker-requirements " -"`_`https://core.telegram.org/stickers#video-sticker-" -"requirements `_ for video sticker technical requirements. Pass a " -"*file_id* as a String to send a file that already exists on the Telegram " -"servers, pass an HTTP URL as a String for Telegram to get a file from the" -" Internet, or upload a new one using multipart/form-data. :ref:`More " -"information on Sending Files » `. Animated sticker set " -"thumbnails can't be uploaded via HTTP URL." -msgstr "" - #: ../../api/methods/set_sticker_set_thumb.rst:14 msgid "Usage" msgstr "" @@ -104,3 +58,57 @@ msgstr "" #: ../../api/methods/set_sticker_set_thumb.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to set the " +#~ "thumbnail of a sticker set. Animated " +#~ "thumbnails can be set for animated " +#~ "sticker sets only. Video thumbnails can" +#~ " be set only for video sticker " +#~ "sets only. Returns :code:`True` on " +#~ "success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" +#~ msgstr "" + +#~ msgid "Sticker set name" +#~ msgstr "" + +#~ msgid "User identifier of the sticker set owner" +#~ msgstr "" + +#~ msgid "" +#~ "A **PNG** image with the thumbnail, " +#~ "must be up to 128 kilobytes in " +#~ "size and have width and height " +#~ "exactly 100px, or a **TGS** animation" +#~ " with the thumbnail up to 32 " +#~ "kilobytes in size; see " +#~ "`https://core.telegram.org/stickers#animated-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#animated-sticker-requirements " +#~ "`_ for animated sticker technical" +#~ " requirements, or a **WEBM** video " +#~ "with the thumbnail up to 32 " +#~ "kilobytes in size; see " +#~ "`https://core.telegram.org/stickers#video-sticker-" +#~ "requirements `_`https://core.telegram.org/stickers" +#~ "#video-sticker-requirements " +#~ "`_ for video sticker technical" +#~ " requirements. Pass a *file_id* as a" +#~ " String to send a file that " +#~ "already exists on the Telegram servers," +#~ " pass an HTTP URL as a String" +#~ " for Telegram to get a file " +#~ "from the Internet, or upload a new" +#~ " one using multipart/form-data. :ref:`More" +#~ " information on Sending Files » " +#~ "`. Animated sticker set " +#~ "thumbnails can't be uploaded via HTTP" +#~ " URL." +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po new file mode 100644 index 00000000..c0d9b5ee --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_thumbnail.po @@ -0,0 +1,108 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:3 +msgid "setStickerSetThumbnail" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail:1 of +msgid "" +"Use this method to set the thumbnail of a regular or mask sticker set. " +"The format of the thumbnail file must match the format of the stickers in" +" the set. Returns :code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickersetthumbnail" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail.name:1 of +msgid "Sticker set name" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail.user_id:1 +#: of +msgid "User identifier of the sticker set owner" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_thumbnail.SetStickerSetThumbnail.thumbnail:1 +#: of +msgid "" +"A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 " +"kilobytes in size and have a width and height of exactly 100px, or a " +"**.TGS** animation with a thumbnail up to 32 kilobytes in size (see " +"`https://core.telegram.org/stickers#animated-sticker-requirements " +"`_`https://core.telegram.org/stickers#animated-sticker-" +"requirements `_ for animated sticker technical requirements), or a " +"**WEBM** video with the thumbnail up to 32 kilobytes in size; see " +"`https://core.telegram.org/stickers#video-sticker-requirements " +"`_`https://core.telegram.org/stickers#video-sticker-" +"requirements `_ for video sticker technical requirements. Pass a " +"*file_id* as a String to send a file that already exists on the Telegram " +"servers, pass an HTTP URL as a String for Telegram to get a file from the" +" Internet, or upload a new one using multipart/form-data. :ref:`More " +"information on Sending Files » `. Animated and video " +"sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then " +"the thumbnail is dropped and the first sticker is used as the thumbnail." +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_set_thumbnail import " +"SetStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerSetThumbnail`" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_set_thumbnail.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_title.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_title.po new file mode 100644 index 00000000..fb27fdfc --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_set_title.po @@ -0,0 +1,80 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/methods/set_sticker_set_title.rst:3 +msgid "setStickerSetTitle" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle:1 of +msgid "" +"Use this method to set the title of a created sticker set. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle:3 of +msgid "Source: https://core.telegram.org/bots/api#setstickersettitle" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle.name:1 of +msgid "Sticker set name" +msgstr "" + +#: ../../docstring +#: aiogram.methods.set_sticker_set_title.SetStickerSetTitle.title:1 of +msgid "Sticker set title, 1-64 characters" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:14 +msgid "Usage" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:17 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:25 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:27 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:29 +msgid "" +":code:`from aiogram.methods.set_sticker_set_title import " +"SetStickerSetTitle`" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:30 +msgid "alias: :code:`from aiogram.methods import SetStickerSetTitle`" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:33 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/set_sticker_set_title.rst:40 +msgid "As reply into Webhook in handler" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/upload_sticker_file.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/upload_sticker_file.po index 5a9d256a..4e909bd1 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/upload_sticker_file.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/upload_sticker_file.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/methods/upload_sticker_file.rst:3 msgid "uploadStickerFile" @@ -27,10 +27,11 @@ msgstr "" #: aiogram.methods.upload_sticker_file.UploadStickerFile:1 of msgid "" -"Use this method to upload a .PNG file with a sticker for later use in " -"*createNewStickerSet* and *addStickerToSet* methods (can be used multiple" -" times). Returns the uploaded :class:`aiogram.types.file.File` on " -"success." +"Use this method to upload a file with a sticker for later use in the " +":class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet` and " +":class:`aiogram.methods.add_sticker_to_set.AddStickerToSet` methods (the " +"file can be used multiple times). Returns the uploaded " +":class:`aiogram.types.file.File` on success." msgstr "" #: aiogram.methods.upload_sticker_file.UploadStickerFile:3 of @@ -43,11 +44,18 @@ msgid "User identifier of sticker file owner" msgstr "" #: ../../docstring -#: aiogram.methods.upload_sticker_file.UploadStickerFile.png_sticker:1 of +#: aiogram.methods.upload_sticker_file.UploadStickerFile.sticker:1 of msgid "" -"**PNG** image with the sticker, must be up to 512 kilobytes in size, " -"dimensions must not exceed 512px, and either width or height must be " -"exactly 512px. :ref:`More information on Sending Files » `" +"A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See " +"`https://core.telegram.org/stickers " +"`_`https://core.telegram.org/stickers" +" `_ for technical requirements. " +":ref:`More information on Sending Files » `" +msgstr "" + +#: ../../docstring +#: aiogram.methods.upload_sticker_file.UploadStickerFile.sticker_format:1 of +msgid "Format of the sticker, must be one of 'static', 'animated', 'video'" msgstr "" #: ../../api/methods/upload_sticker_file.rst:14 @@ -77,3 +85,21 @@ msgstr "" #: ../../api/methods/upload_sticker_file.rst:33 msgid "With specific bot" msgstr "" + +#~ msgid "" +#~ "Use this method to upload a .PNG" +#~ " file with a sticker for later " +#~ "use in *createNewStickerSet* and " +#~ "*addStickerToSet* methods (can be used " +#~ "multiple times). Returns the uploaded " +#~ ":class:`aiogram.types.file.File` on success." +#~ msgstr "" + +#~ msgid "" +#~ "**PNG** image with the sticker, must " +#~ "be up to 512 kilobytes in size," +#~ " dimensions must not exceed 512px, " +#~ "and either width or height must be" +#~ " exactly 512px. :ref:`More information on" +#~ " Sending Files » `" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/bot_description.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/bot_description.po new file mode 100644 index 00000000..2f295229 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/bot_description.po @@ -0,0 +1,35 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/bot_description.rst:3 +msgid "BotDescription" +msgstr "" + +#: aiogram.types.bot_description.BotDescription:1 of +msgid "This object represents the bot's description." +msgstr "" + +#: aiogram.types.bot_description.BotDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#botdescription" +msgstr "" + +#: ../../docstring aiogram.types.bot_description.BotDescription.description:1 +#: of +msgid "The bot's description" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/bot_short_description.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/bot_short_description.po new file mode 100644 index 00000000..8855dc52 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/bot_short_description.po @@ -0,0 +1,36 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/bot_short_description.rst:3 +msgid "BotShortDescription" +msgstr "" + +#: aiogram.types.bot_short_description.BotShortDescription:1 of +msgid "This object represents the bot's short description." +msgstr "" + +#: aiogram.types.bot_short_description.BotShortDescription:3 of +msgid "Source: https://core.telegram.org/bots/api#botshortdescription" +msgstr "" + +#: ../../docstring +#: aiogram.types.bot_short_description.BotShortDescription.short_description:1 +#: of +msgid "The bot's short description" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/input_sticker.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/input_sticker.po new file mode 100644 index 00000000..3bbc8b33 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/input_sticker.po @@ -0,0 +1,56 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.11.0\n" + +#: ../../api/types/input_sticker.rst:3 +msgid "InputSticker" +msgstr "" + +#: aiogram.types.input_sticker.InputSticker:1 of +msgid "This object describes a sticker to be added to a sticker set." +msgstr "" + +#: aiogram.types.input_sticker.InputSticker:3 of +msgid "Source: https://core.telegram.org/bots/api#inputsticker" +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.sticker:1 of +msgid "" +"The added sticker. Pass a *file_id* as a String to send a file that " +"already exists on the Telegram servers, pass an HTTP URL as a String for " +"Telegram to get a file from the Internet, or upload a new one using " +"multipart/form-data. Animated and video stickers can't be uploaded via " +"HTTP URL. :ref:`More information on Sending Files » `" +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.emoji_list:1 of +msgid "List of 1-20 emoji associated with the sticker" +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.mask_position:1 of +msgid "" +"*Optional*. Position where the mask should be placed on faces. For 'mask'" +" stickers only." +msgstr "" + +#: ../../docstring aiogram.types.input_sticker.InputSticker.keywords:1 of +msgid "" +"*Optional*. List of 0-20 search keywords for the sticker with total " +"length of up to 64 characters. For 'regular' and 'custom_emoji' stickers " +"only." +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/message.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/message.po index 416cf8e9..b3f65085 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/message.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-12 00:22+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/message.rst:3 msgid "Message" @@ -679,7 +679,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:17 #: aiogram.types.message.Message.answer_photo:16 #: aiogram.types.message.Message.answer_poll:23 -#: aiogram.types.message.Message.answer_sticker:12 +#: aiogram.types.message.Message.answer_sticker:13 #: aiogram.types.message.Message.answer_venue:19 #: aiogram.types.message.Message.answer_video:21 #: aiogram.types.message.Message.answer_video_note:15 @@ -697,7 +697,7 @@ msgstr "" #: aiogram.types.message.Message.reply_location:18 #: aiogram.types.message.Message.reply_photo:17 #: aiogram.types.message.Message.reply_poll:24 -#: aiogram.types.message.Message.reply_sticker:13 +#: aiogram.types.message.Message.reply_sticker:14 #: aiogram.types.message.Message.reply_venue:20 #: aiogram.types.message.Message.reply_video:22 #: aiogram.types.message.Message.reply_video_note:16 @@ -717,7 +717,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:18 #: aiogram.types.message.Message.answer_photo:17 #: aiogram.types.message.Message.answer_poll:24 -#: aiogram.types.message.Message.answer_sticker:13 +#: aiogram.types.message.Message.answer_sticker:14 #: aiogram.types.message.Message.answer_venue:20 #: aiogram.types.message.Message.answer_video:22 #: aiogram.types.message.Message.answer_video_note:16 @@ -733,7 +733,7 @@ msgstr "" #: aiogram.types.message.Message.reply_location:19 #: aiogram.types.message.Message.reply_photo:18 #: aiogram.types.message.Message.reply_poll:25 -#: aiogram.types.message.Message.reply_sticker:14 +#: aiogram.types.message.Message.reply_sticker:15 #: aiogram.types.message.Message.reply_venue:21 #: aiogram.types.message.Message.reply_video:23 #: aiogram.types.message.Message.reply_video_note:17 @@ -753,7 +753,7 @@ msgstr "" #: aiogram.types.message.Message.answer_media_group:15 #: aiogram.types.message.Message.answer_photo:19 #: aiogram.types.message.Message.answer_poll:26 -#: aiogram.types.message.Message.answer_sticker:15 +#: aiogram.types.message.Message.answer_sticker:16 #: aiogram.types.message.Message.answer_venue:22 #: aiogram.types.message.Message.answer_video:24 #: aiogram.types.message.Message.answer_video_note:18 @@ -771,7 +771,7 @@ msgstr "" #: aiogram.types.message.Message.reply_media_group:15 #: aiogram.types.message.Message.reply_photo:19 #: aiogram.types.message.Message.reply_poll:26 -#: aiogram.types.message.Message.reply_sticker:15 +#: aiogram.types.message.Message.reply_sticker:16 #: aiogram.types.message.Message.reply_venue:22 #: aiogram.types.message.Message.reply_video:24 #: aiogram.types.message.Message.reply_video_note:18 @@ -790,7 +790,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:21 #: aiogram.types.message.Message.answer_photo:20 #: aiogram.types.message.Message.answer_poll:27 -#: aiogram.types.message.Message.answer_sticker:16 +#: aiogram.types.message.Message.answer_sticker:17 #: aiogram.types.message.Message.answer_venue:23 #: aiogram.types.message.Message.answer_video:25 #: aiogram.types.message.Message.answer_video_note:19 @@ -805,7 +805,7 @@ msgstr "" #: aiogram.types.message.Message.reply_location:21 #: aiogram.types.message.Message.reply_photo:20 #: aiogram.types.message.Message.reply_poll:27 -#: aiogram.types.message.Message.reply_sticker:16 +#: aiogram.types.message.Message.reply_sticker:17 #: aiogram.types.message.Message.reply_venue:23 #: aiogram.types.message.Message.reply_video:25 #: aiogram.types.message.Message.reply_video_note:19 @@ -881,7 +881,7 @@ msgstr "" #: aiogram.types.message.Message.answer_location:19 #: aiogram.types.message.Message.answer_photo:18 #: aiogram.types.message.Message.answer_poll:25 -#: aiogram.types.message.Message.answer_sticker:14 +#: aiogram.types.message.Message.answer_sticker:15 #: aiogram.types.message.Message.answer_venue:21 #: aiogram.types.message.Message.answer_video:23 #: aiogram.types.message.Message.answer_video_note:17 @@ -1674,13 +1674,19 @@ msgstr "" msgid "" "Sticker to send. Pass a file_id as String to send a file that exists on " "the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a .WEBP file from the Internet, or upload a new one using" -" multipart/form-data. :ref:`More information on Sending Files » `" +"Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP " +"or .TGS sticker using multipart/form-data. :ref:`More information on " +"Sending Files » `. Video stickers can only be sent by a " +"file_id. Animated stickers can't be sent via an HTTP URL." msgstr "" -#: aiogram.types.message.Message.answer_sticker:17 -#: aiogram.types.message.Message.reply_sticker:17 of +#: aiogram.types.message.Message.answer_sticker:12 +#: aiogram.types.message.Message.reply_sticker:13 of +msgid "Emoji associated with the sticker; only for just uploaded stickers" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:18 +#: aiogram.types.message.Message.reply_sticker:18 of msgid "instance of method :class:`aiogram.methods.send_sticker.SendSticker`" msgstr "" @@ -2545,3 +2551,14 @@ msgstr "" #~ msgid "Copy message" #~ msgstr "" +#~ msgid "" +#~ "Sticker to send. Pass a file_id as" +#~ " String to send a file that " +#~ "exists on the Telegram servers " +#~ "(recommended), pass an HTTP URL as " +#~ "a String for Telegram to get a " +#~ ".WEBP file from the Internet, or " +#~ "upload a new one using multipart" +#~ "/form-data. :ref:`More information on " +#~ "Sending Files » `" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/sticker.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/sticker.po index 4f8fc38b..fe98cecc 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/sticker.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/sticker.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-23 00:47+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/types/sticker.rst:3 msgid "Sticker" @@ -66,7 +66,7 @@ msgid "" "`_" msgstr "" -#: ../../docstring aiogram.types.sticker.Sticker.thumb:1 of +#: ../../docstring aiogram.types.sticker.Sticker.thumbnail:1 of msgid "*Optional*. Sticker thumbnail in the .WEBP or .JPG format" msgstr "" @@ -96,6 +96,14 @@ msgid "" "emoji" msgstr "" +#: ../../docstring aiogram.types.sticker.Sticker.needs_repainting:1 of +msgid "" +"*Optional*. :code:`True`, if the sticker must be repainted to a text " +"color in messages, the color of the Telegram Premium badge in emoji " +"status, white color on chat photos, or another appropriate color in other" +" places" +msgstr "" + #: ../../docstring aiogram.types.sticker.Sticker.file_size:1 of msgid "*Optional*. File size in bytes" msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/upload_file.po b/docs/locale/uk_UA/LC_MESSAGES/api/upload_file.po index 9b0c2440..0506fffc 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/upload_file.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/upload_file.po @@ -5,17 +5,16 @@ # msgid "" msgstr "" -"Project-Id-Version: aiogram\n" +"Project-Id-Version: aiogram\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-03 01:03+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: 2022-12-13 21:40+0200\n" "Last-Translator: \n" "Language-Team: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" -"X-Generator: Poedit 3.2.2\n" +"Generated-By: Babel 2.11.0\n" #: ../../api/upload_file.rst:5 msgid "How to upload file?" @@ -23,13 +22,13 @@ msgstr "Як відвантажити файл?" #: ../../api/upload_file.rst:7 msgid "" -"As says `official Telegram Bot API documentation `_ there are three ways to send files " -"(photos, stickers, audio, media, etc.):" +"As says `official Telegram Bot API documentation " +"`_ there are three ways" +" to send files (photos, stickers, audio, media, etc.):" msgstr "" -"Як стверджує `official Telegram Bot API documentation `_ існує три способа надіслати файл " -"(фото, наклейки, аудіо, медіа тощо):" +"Як стверджує `official Telegram Bot API documentation " +"`_ існує три способа " +"надіслати файл (фото, наклейки, аудіо, медіа тощо):" #: ../../api/upload_file.rst:10 msgid "" @@ -40,15 +39,17 @@ msgstr "" "за URL-адресою, вам не потрібно його повторно завантажувати." #: ../../api/upload_file.rst:13 +#, fuzzy msgid "" -"But if you need to upload new file just use subclasses of `InputFile " +"But if you need to upload a new file just use subclasses of `InputFile " "`__." msgstr "" "Але якщо вам потрібно завантажити новий файл, просто використовуйте " "підкласи `InputFile `__." #: ../../api/upload_file.rst:15 -msgid "Here is available three different builtin types of input file:" +#, fuzzy +msgid "Here are the three different available builtin types of input file:" msgstr "Тут доступні три різні типи вхідних файлів:" #: ../../api/upload_file.rst:17 @@ -56,8 +57,8 @@ msgid "" ":class:`aiogram.types.input_file.FSInputFile` - `uploading from file " "system <#upload-from-file-system>`__" msgstr "" -":class:`aiogram.types.input_file.FSInputFile` - `відвантажений з " -"файлової системи <#upload-from-file-system>`__" +":class:`aiogram.types.input_file.FSInputFile` - `відвантажений з файлової" +" системи <#upload-from-file-system>`__" #: ../../api/upload_file.rst:18 msgid "" @@ -80,17 +81,18 @@ msgid "**Be respectful with Telegram**" msgstr "**Поважайте Telegram**" #: ../../api/upload_file.rst:25 +#, fuzzy msgid "" -"Instances of `InputFile` is reusable. That's mean you can create " -"instance of InputFile and sent this file multiple times but Telegram is " -"not recommend to do that and when you upload file once just save their " +"Instances of `InputFile` are reusable. That's mean you can create " +"instance of InputFile and sent this file multiple times but Telegram does" +" not recommend to do that and when you upload file once just save their " "`file_id` and use it in next times." msgstr "" "Екземпляри `InputFile` можна використовувати повторно. Це означає, що ви " "можете створити екземпляр InputFile і надіслати цей файл кілька разів, " -"але Telegram не рекомендує цього робити, і коли ви завантажуєте файл " -"один раз, просто збережіть його `file_id` і використовуйте його " -"наступного разу." +"але Telegram не рекомендує цього робити, і коли ви завантажуєте файл один" +" раз, просто збережіть його `file_id` і використовуйте його наступного " +"разу." #: ../../api/upload_file.rst:31 msgid "Upload from file system" @@ -123,8 +125,8 @@ msgid "" "Filename to be propagated to telegram. By default, will be parsed from " "path" msgstr "" -"Ім'я файлу, яке буде передано в telegram. За замовчуванням, буде взято " -"зі шляху" +"Ім'я файлу, яке буде передано в telegram. За замовчуванням, буде взято зі" +" шляху" #: aiogram.types.input_file.BufferedInputFile.__init__:5 #: aiogram.types.input_file.FSInputFile.__init__:6 of @@ -136,14 +138,15 @@ msgid "Upload from buffer" msgstr "Відвантаження з буферу" #: ../../api/upload_file.rst:54 +#, fuzzy msgid "" "Files can be also passed from buffer (For example you generate image " -"using `Pillow `_ and the " -"want's to sent it to the Telegram):" +"using `Pillow `_ and you want " +"to send it to Telegram):" msgstr "" -"Файли також можна передавати з буфера (наприклад, ви створюєте " -"зображення за допомогою `Pillow `_ і хочете надіслати його в Telegram):" +"Файли також можна передавати з буфера (наприклад, ви створюєте зображення" +" за допомогою `Pillow `_ і " +"хочете надіслати його в Telegram):" #: ../../api/upload_file.rst:58 ../../api/upload_file.rst:80 msgid "Import wrapper:" @@ -169,11 +172,11 @@ msgstr "Відвантаження з URL" msgid "" "If you need to upload a file from another server, but the direct link is " "bound to your server's IP, or you want to bypass native `upload limits " -"`_ by URL, you can " -"use :obj:`aiogram.types.input_file.URLInputFile`." +"`_ by URL, you can use " +":obj:`aiogram.types.input_file.URLInputFile`." msgstr "" -"Якщо вам потрібно відвантажити файл з іншого сервера, але пряме " -"посилання прив’язано до IP-адреси вашого сервера, або ви хочете обійти " -"власні `обмеження на завантаження `_ за URL-адресою, ви можете використовувати :obj:" -"`aiogram.types.input_file.URLInputFile`." +"Якщо вам потрібно відвантажити файл з іншого сервера, але пряме посилання" +" прив’язано до IP-адреси вашого сервера, або ви хочете обійти власні " +"`обмеження на завантаження `_ за URL-адресою, ви можете використовувати " +":obj:`aiogram.types.input_file.URLInputFile`." diff --git a/docs/locale/uk_UA/LC_MESSAGES/changelog.po b/docs/locale/uk_UA/LC_MESSAGES/changelog.po index 975e4939..eb5c4ffc 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/changelog.po +++ b/docs/locale/uk_UA/LC_MESSAGES/changelog.po @@ -8,49 +8,107 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-12 00:22+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.11.0\n" #: ../../../CHANGES.rst:3 msgid "Changelog" msgstr "" #: ../../[towncrier-fragments]:2 -msgid "\\ |release| [UNRELEASED DRAFT] (2023-02-12)" +msgid "\\ |release| [UNRELEASED DRAFT] (2023-03-11)" msgstr "" -#: ../../../CHANGES.rst:23 ../../../CHANGES.rst:83 ../../../CHANGES.rst:134 -#: ../../../CHANGES.rst:207 ../../../CHANGES.rst:248 ../../../CHANGES.rst:286 -#: ../../../CHANGES.rst:334 ../../../CHANGES.rst:410 ../../../CHANGES.rst:443 -#: ../../../CHANGES.rst:474 ../../[towncrier-fragments]:5 -msgid "Features" +#: ../../../CHANGES.rst:193 ../../../CHANGES.rst:243 ../../../CHANGES.rst:623 +#: ../../[towncrier-fragments]:5 +msgid "Improved Documentation" msgstr "" #: ../../[towncrier-fragments]:7 +msgid "" +"Changed small grammar typos for `upload_file` `#1133 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:127 ../../../CHANGES.rst:204 ../../../CHANGES.rst:257 +#: ../../../CHANGES.rst:308 ../../../CHANGES.rst:362 ../../../CHANGES.rst:404 +#: ../../../CHANGES.rst:450 ../../../CHANGES.rst:510 ../../../CHANGES.rst:531 +#: ../../../CHANGES.rst:554 ../../../CHANGES.rst:591 ../../../CHANGES.rst:630 +#: ../../[towncrier-fragments]:12 +msgid "Misc" +msgstr "" + +#: ../../[towncrier-fragments]:14 +msgid "" +"Added full support of `Bot API 6.6 `_" +msgstr "" + +#: ../../[towncrier-fragments]:18 +msgid "" +"Note that this issue has breaking changes described in in the Bot API " +"changelog, this changes is not breaking in the API but breaking inside " +"aiogram because Beta stage is not finished." +msgstr "" + +#: ../../[towncrier-fragments]:21 +msgid "`#1139 `_" +msgstr "" + +#: ../../../CHANGES.rst:20 +msgid "3.0.0b7 (2023-02-18)" +msgstr "" + +#: ../../../CHANGES.rst:24 +msgid "" +"Note that this version has incompatibility with Python 3.8-3.9 in case " +"when you create an instance of Dispatcher outside of the any coroutine." +msgstr "" + +#: ../../../CHANGES.rst:26 +msgid "Sorry for the inconvenience, it will be fixed in the next version." +msgstr "" + +#: ../../../CHANGES.rst:28 +msgid "This code will not work:" +msgstr "" + +#: ../../../CHANGES.rst:40 +msgid "But if you change it like this it should works as well:" +msgstr "" + +#: ../../../CHANGES.rst:56 ../../../CHANGES.rst:156 ../../../CHANGES.rst:216 +#: ../../../CHANGES.rst:267 ../../../CHANGES.rst:340 ../../../CHANGES.rst:381 +#: ../../../CHANGES.rst:419 ../../../CHANGES.rst:467 ../../../CHANGES.rst:543 +#: ../../../CHANGES.rst:576 ../../../CHANGES.rst:607 +msgid "Features" +msgstr "" + +#: ../../../CHANGES.rst:58 msgid "Added missing shortcuts, new enums, reworked old stuff" msgstr "" -#: ../../[towncrier-fragments]:9 +#: ../../../CHANGES.rst:60 msgid "" "**Breaking** All previously added enums is re-generated in new place - " "`aiogram.enums` instead of `aiogram.types`" msgstr "" -#: ../../[towncrier-fragments]:27 +#: ../../../CHANGES.rst:78 msgid "" "**Added enums:** " ":class:`aiogram.enums.bot_command_scope_type.BotCommandScopeType`," msgstr "" -#: ../../[towncrier-fragments]:13 +#: ../../../CHANGES.rst:64 msgid "" -":class:`aiogram.enums.chat_action.ChatActions`, " +":class:`aiogram.enums.chat_action.ChatAction`, " ":class:`aiogram.enums.chat_member_status.ChatMemberStatus`, " ":class:`aiogram.enums.chat_type.ChatType`, " ":class:`aiogram.enums.content_type.ContentType`, " @@ -67,15 +125,15 @@ msgid "" ":class:`aiogram.enums.update_type.UpdateType`," msgstr "" -#: ../../[towncrier-fragments]:29 +#: ../../../CHANGES.rst:80 msgid "**Added shortcuts**:" msgstr "" -#: ../../[towncrier-fragments]:54 +#: ../../../CHANGES.rst:105 msgid "*Chat* :meth:`aiogram.types.chat.Chat.get_administrators`," msgstr "" -#: ../../[towncrier-fragments]:32 +#: ../../../CHANGES.rst:83 msgid "" ":meth:`aiogram.types.chat.Chat.delete_message`, " ":meth:`aiogram.types.chat.Chat.revoke_invite_link`, " @@ -103,88 +161,92 @@ msgid "" ":meth:`aiogram.types.chat.Chat.set_photo`," msgstr "" -#: ../../[towncrier-fragments]:56 +#: ../../../CHANGES.rst:107 msgid "*Sticker*: :meth:`aiogram.types.sticker.Sticker.set_position_in_set`," msgstr "" -#: ../../[towncrier-fragments]:57 +#: ../../../CHANGES.rst:108 msgid ":meth:`aiogram.types.sticker.Sticker.delete_from_set`," msgstr "" -#: ../../[towncrier-fragments]:58 +#: ../../../CHANGES.rst:109 msgid "*User*: :meth:`aiogram.types.user.User.get_profile_photos`" msgstr "" -#: ../../[towncrier-fragments]:59 +#: ../../../CHANGES.rst:110 msgid "`#952 `_" msgstr "" -#: ../../[towncrier-fragments]:60 +#: ../../../CHANGES.rst:111 msgid "" "Added :ref:`callback answer ` feature `#1091 " "`_" msgstr "" -#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:97 ../../../CHANGES.rst:158 -#: ../../../CHANGES.rst:216 ../../../CHANGES.rst:262 ../../../CHANGES.rst:310 -#: ../../../CHANGES.rst:366 ../../../CHANGES.rst:451 ../../../CHANGES.rst:483 -#: ../../[towncrier-fragments]:65 +#: ../../../CHANGES.rst:113 +msgid "" +"Added a method that allows you to compactly register routers `#1117 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:118 ../../../CHANGES.rst:181 ../../../CHANGES.rst:230 +#: ../../../CHANGES.rst:291 ../../../CHANGES.rst:349 ../../../CHANGES.rst:395 +#: ../../../CHANGES.rst:443 ../../../CHANGES.rst:499 ../../../CHANGES.rst:584 +#: ../../../CHANGES.rst:616 msgid "Bugfixes" msgstr "" -#: ../../[towncrier-fragments]:67 +#: ../../../CHANGES.rst:120 +msgid "" +"Check status code when downloading file `#816 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:122 msgid "" "Fixed `ignore_case` parameter in :obj:`aiogram.filters.command.Command` " "filter `#1106 `_" msgstr "" -#: ../../../CHANGES.rst:71 ../../../CHANGES.rst:124 ../../../CHANGES.rst:175 -#: ../../../CHANGES.rst:229 ../../../CHANGES.rst:271 ../../../CHANGES.rst:317 -#: ../../../CHANGES.rst:377 ../../../CHANGES.rst:398 ../../../CHANGES.rst:421 -#: ../../../CHANGES.rst:458 ../../../CHANGES.rst:497 -#: ../../[towncrier-fragments]:72 -msgid "Misc" -msgstr "" - -#: ../../[towncrier-fragments]:74 +#: ../../../CHANGES.rst:129 msgid "" "Added integration with new code-generator named `Butcher " "`_ `#1069 " "`_" msgstr "" -#: ../../[towncrier-fragments]:76 +#: ../../../CHANGES.rst:131 msgid "" "Added full support of `Bot API 6.4 `_ `#1088 " "`_" msgstr "" -#: ../../[towncrier-fragments]:78 +#: ../../../CHANGES.rst:133 msgid "" "Updated package metadata, moved build internals from Poetry to Hatch, " "added contributing guides. `#1095 " "`_" msgstr "" -#: ../../[towncrier-fragments]:80 +#: ../../../CHANGES.rst:135 msgid "" "Added full support of `Bot API 6.5 `_" msgstr "" -#: ../../[towncrier-fragments]:84 +#: ../../../CHANGES.rst:139 msgid "" "Note that :obj:`aiogram.types.chat_permissions.ChatPermissions` is " "updated without backward compatibility, so now this object has no " ":code:`can_send_media_messages` attribute" msgstr "" -#: ../../[towncrier-fragments]:86 +#: ../../../CHANGES.rst:141 msgid "`#1112 `_" msgstr "" -#: ../../[towncrier-fragments]:87 +#: ../../../CHANGES.rst:142 msgid "" "Replaced error :code:`TypeError: TelegramEventObserver.__call__() got an " "unexpected keyword argument ''` with a more understandable one for " @@ -192,131 +254,141 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:20 +#: ../../../CHANGES.rst:145 +msgid "" +"Added possibility to reply into webhook with files `#1120 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:147 +msgid "" +"Reworked graceful shutdown. Added method to stop polling. Now polling " +"started from dispatcher can be stopped by signals gracefully without " +"errors (on Linux and Mac). `#1124 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:153 msgid "3.0.0b6 (2022-11-18)" msgstr "" -#: ../../../CHANGES.rst:25 +#: ../../../CHANGES.rst:158 msgid "" "(again) Added possibility to combine filters with an *and*/*or* " "operations." msgstr "" -#: ../../../CHANGES.rst:27 +#: ../../../CHANGES.rst:160 msgid "" "Read more in \":ref:`Combining filters `\" " "documentation section `#1018 " "`_" msgstr "" -#: ../../../CHANGES.rst:29 +#: ../../../CHANGES.rst:162 msgid "Added following methods to ``Message`` class:" msgstr "" -#: ../../../CHANGES.rst:31 +#: ../../../CHANGES.rst:164 msgid ":code:`Message.forward(...)`" msgstr "" -#: ../../../CHANGES.rst:32 +#: ../../../CHANGES.rst:165 msgid ":code:`Message.edit_media(...)`" msgstr "" -#: ../../../CHANGES.rst:33 +#: ../../../CHANGES.rst:166 msgid ":code:`Message.edit_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:34 +#: ../../../CHANGES.rst:167 msgid ":code:`Message.stop_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:35 +#: ../../../CHANGES.rst:168 msgid ":code:`Message.pin(...)`" msgstr "" -#: ../../../CHANGES.rst:36 +#: ../../../CHANGES.rst:169 msgid ":code:`Message.unpin()`" msgstr "" -#: ../../../CHANGES.rst:37 +#: ../../../CHANGES.rst:170 msgid "`#1030 `_" msgstr "" -#: ../../../CHANGES.rst:38 +#: ../../../CHANGES.rst:171 msgid "Added following methods to :code:`User` class:" msgstr "" -#: ../../../CHANGES.rst:40 +#: ../../../CHANGES.rst:173 msgid ":code:`User.mention_markdown(...)`" msgstr "" -#: ../../../CHANGES.rst:41 +#: ../../../CHANGES.rst:174 msgid ":code:`User.mention_html(...)`" msgstr "" -#: ../../../CHANGES.rst:42 +#: ../../../CHANGES.rst:175 msgid "`#1049 `_" msgstr "" -#: ../../../CHANGES.rst:43 +#: ../../../CHANGES.rst:176 msgid "" "Added full support of `Bot API 6.3 `_ `#1057 " "`_" msgstr "" -#: ../../../CHANGES.rst:50 +#: ../../../CHANGES.rst:183 msgid "" "Fixed :code:`Message.send_invoice` and :code:`Message.reply_invoice`, " "added missing arguments `#1047 " "`_" msgstr "" -#: ../../../CHANGES.rst:52 +#: ../../../CHANGES.rst:185 msgid "Fixed copy and forward in:" msgstr "" -#: ../../../CHANGES.rst:54 +#: ../../../CHANGES.rst:187 msgid ":code:`Message.answer(...)`" msgstr "" -#: ../../../CHANGES.rst:55 +#: ../../../CHANGES.rst:188 msgid ":code:`Message.copy_to(...)`" msgstr "" -#: ../../../CHANGES.rst:56 +#: ../../../CHANGES.rst:189 msgid "`#1064 `_" msgstr "" -#: ../../../CHANGES.rst:60 ../../../CHANGES.rst:110 ../../../CHANGES.rst:490 -msgid "Improved Documentation" -msgstr "" - -#: ../../../CHANGES.rst:62 +#: ../../../CHANGES.rst:195 msgid "" "Fixed UA translations in index.po `#1017 " "`_" msgstr "" -#: ../../../CHANGES.rst:64 +#: ../../../CHANGES.rst:197 msgid "" "Fix typehints for :code:`Message`, :code:`reply_media_group` and " ":code:`answer_media_group` methods `#1029 " "`_" msgstr "" -#: ../../../CHANGES.rst:66 +#: ../../../CHANGES.rst:199 msgid "" "Removed an old now non-working feature `#1060 " "`_" msgstr "" -#: ../../../CHANGES.rst:73 +#: ../../../CHANGES.rst:206 msgid "" "Enabled testing on Python 3.11 `#1044 " "`_" msgstr "" -#: ../../../CHANGES.rst:75 +#: ../../../CHANGES.rst:208 msgid "" "Added a mandatory dependency :code:`certifi` in due to in some cases on " "systems that doesn't have updated ca-certificates the requests to Bot API" @@ -325,23 +397,23 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:80 +#: ../../../CHANGES.rst:213 msgid "3.0.0b5 (2022-10-02)" msgstr "" -#: ../../../CHANGES.rst:85 +#: ../../../CHANGES.rst:218 msgid "" "Add PyPy support and run tests under PyPy `#985 " "`_" msgstr "" -#: ../../../CHANGES.rst:87 +#: ../../../CHANGES.rst:220 msgid "" "Added message text to aiogram exceptions representation `#988 " "`_" msgstr "" -#: ../../../CHANGES.rst:89 +#: ../../../CHANGES.rst:222 msgid "" "Added warning about using magic filter from `magic_filter` instead of " "`aiogram`'s ones. Is recommended to use `from aiogram import F` instead " @@ -349,65 +421,65 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:92 +#: ../../../CHANGES.rst:225 msgid "" "Added more detailed error when server response can't be deserialized. " "This feature will help to debug unexpected responses from the Server " "`#1014 `_" msgstr "" -#: ../../../CHANGES.rst:99 +#: ../../../CHANGES.rst:232 msgid "" "Reworked error event, introduced " ":class:`aiogram.types.error_event.ErrorEvent` object. `#898 " "`_" msgstr "" -#: ../../../CHANGES.rst:101 +#: ../../../CHANGES.rst:234 msgid "" "Fixed escaping markdown in `aiogram.utils.markdown` module `#903 " "`_" msgstr "" -#: ../../../CHANGES.rst:103 +#: ../../../CHANGES.rst:236 msgid "" "Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. " "`#995 `_" msgstr "" -#: ../../../CHANGES.rst:105 +#: ../../../CHANGES.rst:238 msgid "" "Fixed empty mention in command parsing, now it will be None instead of an" " empty string `#1013 `_" msgstr "" -#: ../../../CHANGES.rst:112 +#: ../../../CHANGES.rst:245 msgid "" "Initialized Docs translation (added Ukrainian language) `#925 " "`_" msgstr "" -#: ../../../CHANGES.rst:117 +#: ../../../CHANGES.rst:250 msgid "Deprecations and Removals" msgstr "" -#: ../../../CHANGES.rst:119 +#: ../../../CHANGES.rst:252 msgid "" "Removed filters factory as described in corresponding issue. `#942 " "`_" msgstr "" -#: ../../../CHANGES.rst:126 +#: ../../../CHANGES.rst:259 msgid "" "Now Router/Dispatcher accepts only keyword arguments. `#982 " "`_" msgstr "" -#: ../../../CHANGES.rst:131 +#: ../../../CHANGES.rst:264 msgid "3.0.0b4 (2022-08-14)" msgstr "" -#: ../../../CHANGES.rst:136 +#: ../../../CHANGES.rst:269 msgid "" "Add class helper ChatAction for constants that Telegram BotAPI uses in " "sendChatAction request. In my opinion, this will help users and will also" @@ -415,198 +487,198 @@ msgid "" "\"ChatActions\". `#803 `_" msgstr "" -#: ../../../CHANGES.rst:140 +#: ../../../CHANGES.rst:273 msgid "Added possibility to combine filters or invert result" msgstr "" -#: ../../../CHANGES.rst:142 +#: ../../../CHANGES.rst:275 msgid "Example:" msgstr "" -#: ../../../CHANGES.rst:150 +#: ../../../CHANGES.rst:283 msgid "`#894 `_" msgstr "" -#: ../../../CHANGES.rst:151 +#: ../../../CHANGES.rst:284 msgid "" "Fixed type hints for redis TTL params. `#922 " "`_" msgstr "" -#: ../../../CHANGES.rst:153 +#: ../../../CHANGES.rst:286 msgid "" "Added `full_name` shortcut for `Chat` object `#929 " "`_" msgstr "" -#: ../../../CHANGES.rst:160 +#: ../../../CHANGES.rst:293 msgid "" "Fixed false-positive coercing of Union types in API methods `#901 " "`_" msgstr "" -#: ../../../CHANGES.rst:162 +#: ../../../CHANGES.rst:295 msgid "Added 3 missing content types:" msgstr "" -#: ../../../CHANGES.rst:164 +#: ../../../CHANGES.rst:297 msgid "proximity_alert_triggered" msgstr "" -#: ../../../CHANGES.rst:165 +#: ../../../CHANGES.rst:298 msgid "supergroup_chat_created" msgstr "" -#: ../../../CHANGES.rst:166 +#: ../../../CHANGES.rst:299 msgid "channel_chat_created" msgstr "" -#: ../../../CHANGES.rst:167 +#: ../../../CHANGES.rst:300 msgid "`#906 `_" msgstr "" -#: ../../../CHANGES.rst:168 +#: ../../../CHANGES.rst:301 msgid "" "Fixed the ability to compare the state, now comparison to copy of the " "state will return `True`. `#927 " "`_" msgstr "" -#: ../../../CHANGES.rst:170 +#: ../../../CHANGES.rst:303 msgid "" "Fixed default lock kwargs in RedisEventIsolation. `#972 " "`_" msgstr "" -#: ../../../CHANGES.rst:177 +#: ../../../CHANGES.rst:310 msgid "" "Restrict including routers with strings `#896 " "`_" msgstr "" -#: ../../../CHANGES.rst:179 +#: ../../../CHANGES.rst:312 msgid "" "Changed CommandPatterType to CommandPatternType in " "`aiogram/dispatcher/filters/command.py` `#907 " "`_" msgstr "" -#: ../../../CHANGES.rst:181 +#: ../../../CHANGES.rst:314 msgid "" "Added full support of `Bot API 6.1 `_ `#936 " "`_" msgstr "" -#: ../../../CHANGES.rst:183 +#: ../../../CHANGES.rst:316 msgid "**Breaking!** More flat project structure" msgstr "" -#: ../../../CHANGES.rst:185 +#: ../../../CHANGES.rst:318 msgid "These packages was moved, imports in your code should be fixed:" msgstr "" -#: ../../../CHANGES.rst:187 +#: ../../../CHANGES.rst:320 msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`" msgstr "" -#: ../../../CHANGES.rst:188 +#: ../../../CHANGES.rst:321 msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`" msgstr "" -#: ../../../CHANGES.rst:189 +#: ../../../CHANGES.rst:322 msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`" msgstr "" -#: ../../../CHANGES.rst:190 +#: ../../../CHANGES.rst:323 msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`" msgstr "" -#: ../../../CHANGES.rst:191 +#: ../../../CHANGES.rst:324 msgid "" ":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` " "(single module instead of package)" msgstr "" -#: ../../../CHANGES.rst:192 +#: ../../../CHANGES.rst:325 msgid "`#938 `_" msgstr "" -#: ../../../CHANGES.rst:193 +#: ../../../CHANGES.rst:326 msgid "" "Removed deprecated :code:`router._handler` and " ":code:`router.register__handler` methods. `#941 " "`_" msgstr "" -#: ../../../CHANGES.rst:195 +#: ../../../CHANGES.rst:328 msgid "" "Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942" " `_" msgstr "" -#: ../../../CHANGES.rst:197 +#: ../../../CHANGES.rst:330 msgid "" "`MessageEntity` method `get_text` was removed and `extract` was renamed " "to `extract_from` `#944 `_" msgstr "" -#: ../../../CHANGES.rst:199 +#: ../../../CHANGES.rst:332 msgid "" "Added full support of `Bot API 6.2 `_ `#975 " "`_" msgstr "" -#: ../../../CHANGES.rst:204 +#: ../../../CHANGES.rst:337 msgid "3.0.0b3 (2022-04-19)" msgstr "" -#: ../../../CHANGES.rst:209 +#: ../../../CHANGES.rst:342 msgid "" "Added possibility to get command magic result as handler argument `#889 " "`_" msgstr "" -#: ../../../CHANGES.rst:211 +#: ../../../CHANGES.rst:344 msgid "" "Added full support of `Telegram Bot API 6.0 " "`_ `#890 " "`_" msgstr "" -#: ../../../CHANGES.rst:218 +#: ../../../CHANGES.rst:351 msgid "" "Fixed I18n lazy-proxy. Disabled caching. `#839 " "`_" msgstr "" -#: ../../../CHANGES.rst:220 +#: ../../../CHANGES.rst:353 msgid "" "Added parsing of spoiler message entity `#865 " "`_" msgstr "" -#: ../../../CHANGES.rst:222 +#: ../../../CHANGES.rst:355 msgid "" "Fixed default `parse_mode` for `Message.copy_to()` method. `#876 " "`_" msgstr "" -#: ../../../CHANGES.rst:224 +#: ../../../CHANGES.rst:357 msgid "" "Fixed CallbackData factory parsing IntEnum's `#885 " "`_" msgstr "" -#: ../../../CHANGES.rst:231 +#: ../../../CHANGES.rst:364 msgid "" "Added automated check that pull-request adds a changes description to " "**CHANGES** directory `#873 " "`_" msgstr "" -#: ../../../CHANGES.rst:233 +#: ../../../CHANGES.rst:366 msgid "" "Changed :code:`Message.html_text` and :code:`Message.md_text` attributes " "behaviour when message has no text. The empty string will be used instead" @@ -614,14 +686,14 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:236 +#: ../../../CHANGES.rst:369 msgid "" "Used `redis-py` instead of `aioredis` package in due to this packages was" " merged into single one `#882 " "`_" msgstr "" -#: ../../../CHANGES.rst:238 +#: ../../../CHANGES.rst:371 msgid "" "Solved common naming problem with middlewares that confusing too much " "developers - now you can't see the `middleware` and `middlewares` " @@ -630,113 +702,113 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:245 +#: ../../../CHANGES.rst:378 msgid "3.0.0b2 (2022-02-19)" msgstr "" -#: ../../../CHANGES.rst:250 +#: ../../../CHANGES.rst:383 msgid "" "Added possibility to pass additional arguments into the aiohttp webhook " "handler to use this arguments inside handlers as the same as it possible " "in polling mode. `#785 `_" msgstr "" -#: ../../../CHANGES.rst:253 +#: ../../../CHANGES.rst:386 msgid "" "Added possibility to add handler flags via decorator (like `pytest.mark` " "decorator but `aiogram.flags`) `#836 " "`_" msgstr "" -#: ../../../CHANGES.rst:255 +#: ../../../CHANGES.rst:388 msgid "" "Added :code:`ChatActionSender` utility to automatically sends chat action" " while long process is running." msgstr "" -#: ../../../CHANGES.rst:257 +#: ../../../CHANGES.rst:390 msgid "" "It also can be used as message middleware and can be customized via " ":code:`chat_action` flag. `#837 " "`_" msgstr "" -#: ../../../CHANGES.rst:264 +#: ../../../CHANGES.rst:397 msgid "" "Fixed unexpected behavior of sequences in the StateFilter. `#791 " "`_" msgstr "" -#: ../../../CHANGES.rst:266 +#: ../../../CHANGES.rst:399 msgid "" "Fixed exceptions filters `#827 " "`_" msgstr "" -#: ../../../CHANGES.rst:273 +#: ../../../CHANGES.rst:406 msgid "" "Logger name for processing events is changed to :code:`aiogram.events`. " "`#830 `_" msgstr "" -#: ../../../CHANGES.rst:275 +#: ../../../CHANGES.rst:408 msgid "" "Added full support of Telegram Bot API 5.6 and 5.7 `#835 " "`_" msgstr "" -#: ../../../CHANGES.rst:277 +#: ../../../CHANGES.rst:410 msgid "" "**BREAKING** Events isolation mechanism is moved from FSM storages to " "standalone managers `#838 " "`_" msgstr "" -#: ../../../CHANGES.rst:283 +#: ../../../CHANGES.rst:416 msgid "3.0.0b1 (2021-12-12)" msgstr "" -#: ../../../CHANGES.rst:288 +#: ../../../CHANGES.rst:421 msgid "Added new custom operation for MagicFilter named :code:`as_`" msgstr "" -#: ../../../CHANGES.rst:290 +#: ../../../CHANGES.rst:423 msgid "Now you can use it to get magic filter result as handler argument" msgstr "" -#: ../../../CHANGES.rst:306 +#: ../../../CHANGES.rst:439 msgid "`#759 `_" msgstr "" -#: ../../../CHANGES.rst:312 +#: ../../../CHANGES.rst:445 msgid "" "Fixed: Missing :code:`ChatMemberHandler` import in " ":code:`aiogram/dispatcher/handler` `#751 " "`_" msgstr "" -#: ../../../CHANGES.rst:319 +#: ../../../CHANGES.rst:452 msgid "" "Check :code:`destiny` in case of no :code:`with_destiny` enabled in " "RedisStorage key builder `#776 " "`_" msgstr "" -#: ../../../CHANGES.rst:321 +#: ../../../CHANGES.rst:454 msgid "" "Added full support of `Bot API 5.5 `_ `#777 " "`_" msgstr "" -#: ../../../CHANGES.rst:323 +#: ../../../CHANGES.rst:456 msgid "" "Stop using feature from #336. From now settings of client-session should " "be placed as initializer arguments instead of changing instance " "attributes. `#778 `_" msgstr "" -#: ../../../CHANGES.rst:325 +#: ../../../CHANGES.rst:458 msgid "" "Make TelegramAPIServer files wrapper in local mode bi-directional " "(server-client, client-server) Now you can convert local path to server " @@ -744,11 +816,11 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:331 +#: ../../../CHANGES.rst:464 msgid "3.0.0a18 (2021-11-10)" msgstr "" -#: ../../../CHANGES.rst:336 +#: ../../../CHANGES.rst:469 msgid "" "Breaking: Changed the signature of the session middlewares Breaking: " "Renamed AiohttpSession.make_request method parameter from call to method " @@ -756,258 +828,258 @@ msgid "" "outgoing requests `#716 `_" msgstr "" -#: ../../../CHANGES.rst:340 +#: ../../../CHANGES.rst:473 msgid "" "Improved description of filters resolving error. For example when you try" " to pass wrong type of argument to the filter but don't know why filter " "is not resolved now you can get error like this:" msgstr "" -#: ../../../CHANGES.rst:350 +#: ../../../CHANGES.rst:483 msgid "`#717 `_" msgstr "" -#: ../../../CHANGES.rst:351 +#: ../../../CHANGES.rst:484 msgid "" "**Breaking internal API change** Reworked FSM Storage record keys " "propagation `#723 `_" msgstr "" -#: ../../../CHANGES.rst:354 +#: ../../../CHANGES.rst:487 msgid "" "Implemented new filter named :code:`MagicData(magic_data)` that helps to " "filter event by data from middlewares or other filters" msgstr "" -#: ../../../CHANGES.rst:356 +#: ../../../CHANGES.rst:489 msgid "" "For example your bot is running with argument named :code:`config` that " "contains the application config then you can filter event by value from " "this config:" msgstr "" -#: ../../../CHANGES.rst:362 +#: ../../../CHANGES.rst:495 msgid "`#724 `_" msgstr "" -#: ../../../CHANGES.rst:368 +#: ../../../CHANGES.rst:501 msgid "" "Fixed I18n context inside error handlers `#726 " "`_" msgstr "" -#: ../../../CHANGES.rst:370 +#: ../../../CHANGES.rst:503 msgid "" "Fixed bot session closing before emit shutdown `#734 " "`_" msgstr "" -#: ../../../CHANGES.rst:372 +#: ../../../CHANGES.rst:505 msgid "" "Fixed: bound filter resolving does not require children routers `#736 " "`_" msgstr "" -#: ../../../CHANGES.rst:379 +#: ../../../CHANGES.rst:512 msgid "" "Enabled testing on Python 3.10 Removed `async_lru` dependency (is " "incompatible with Python 3.10) and replaced usage with protected property" " `#719 `_" msgstr "" -#: ../../../CHANGES.rst:382 +#: ../../../CHANGES.rst:515 msgid "" "Converted README.md to README.rst and use it as base file for docs `#725 " "`_" msgstr "" -#: ../../../CHANGES.rst:384 +#: ../../../CHANGES.rst:517 msgid "Rework filters resolving:" msgstr "" -#: ../../../CHANGES.rst:386 +#: ../../../CHANGES.rst:519 msgid "Automatically apply Bound Filters with default values to handlers" msgstr "" -#: ../../../CHANGES.rst:387 +#: ../../../CHANGES.rst:520 msgid "Fix data transfer from parent to included routers filters" msgstr "" -#: ../../../CHANGES.rst:388 +#: ../../../CHANGES.rst:521 msgid "`#727 `_" msgstr "" -#: ../../../CHANGES.rst:389 +#: ../../../CHANGES.rst:522 msgid "" "Added full support of Bot API 5.4 https://core.telegram.org/bots/api-" "changelog#november-5-2021 `#744 " "`_" msgstr "" -#: ../../../CHANGES.rst:395 +#: ../../../CHANGES.rst:528 msgid "3.0.0a17 (2021-09-24)" msgstr "" -#: ../../../CHANGES.rst:400 +#: ../../../CHANGES.rst:533 msgid "" "Added :code:`html_text` and :code:`md_text` to Message object `#708 " "`_" msgstr "" -#: ../../../CHANGES.rst:402 +#: ../../../CHANGES.rst:535 msgid "" "Refactored I18n, added context managers for I18n engine and current " "locale `#709 `_" msgstr "" -#: ../../../CHANGES.rst:407 +#: ../../../CHANGES.rst:540 msgid "3.0.0a16 (2021-09-22)" msgstr "" -#: ../../../CHANGES.rst:412 +#: ../../../CHANGES.rst:545 msgid "Added support of local Bot API server files downloading" msgstr "" -#: ../../../CHANGES.rst:414 +#: ../../../CHANGES.rst:547 msgid "" "When Local API is enabled files can be downloaded via " "`bot.download`/`bot.download_file` methods. `#698 " "`_" msgstr "" -#: ../../../CHANGES.rst:416 +#: ../../../CHANGES.rst:549 msgid "" "Implemented I18n & L10n support `#701 " "`_" msgstr "" -#: ../../../CHANGES.rst:423 +#: ../../../CHANGES.rst:556 msgid "" "Covered by tests and docs KeyboardBuilder util `#699 " "`_" msgstr "" -#: ../../../CHANGES.rst:425 +#: ../../../CHANGES.rst:558 msgid "**Breaking!!!**. Refactored and renamed exceptions." msgstr "" -#: ../../../CHANGES.rst:427 +#: ../../../CHANGES.rst:560 msgid "" "Exceptions module was moved from :code:`aiogram.utils.exceptions` to " ":code:`aiogram.exceptions`" msgstr "" -#: ../../../CHANGES.rst:428 +#: ../../../CHANGES.rst:561 msgid "Added prefix `Telegram` for all error classes" msgstr "" -#: ../../../CHANGES.rst:429 +#: ../../../CHANGES.rst:562 msgid "`#700 `_" msgstr "" -#: ../../../CHANGES.rst:430 +#: ../../../CHANGES.rst:563 msgid "" "Replaced all :code:`pragma: no cover` marks via global " ":code:`.coveragerc` config `#702 " "`_" msgstr "" -#: ../../../CHANGES.rst:432 +#: ../../../CHANGES.rst:565 msgid "Updated dependencies." msgstr "" -#: ../../../CHANGES.rst:434 +#: ../../../CHANGES.rst:567 msgid "" "**Breaking for framework developers** Now all optional dependencies " "should be installed as extra: `poetry install -E fast -E redis -E proxy " "-E i18n -E docs` `#703 `_" msgstr "" -#: ../../../CHANGES.rst:440 +#: ../../../CHANGES.rst:573 msgid "3.0.0a15 (2021-09-10)" msgstr "" -#: ../../../CHANGES.rst:445 +#: ../../../CHANGES.rst:578 msgid "" "Ability to iterate over all states in StatesGroup. Aiogram already had in" " check for states group so this is relative feature. `#666 " "`_" msgstr "" -#: ../../../CHANGES.rst:453 +#: ../../../CHANGES.rst:586 msgid "" "Fixed incorrect type checking in the " ":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 " "`_" msgstr "" -#: ../../../CHANGES.rst:460 +#: ../../../CHANGES.rst:593 msgid "" "Disable ContentType filter by default `#668 " "`_" msgstr "" -#: ../../../CHANGES.rst:462 +#: ../../../CHANGES.rst:595 msgid "" "Moved update type detection from Dispatcher to Update object `#669 " "`_" msgstr "" -#: ../../../CHANGES.rst:464 +#: ../../../CHANGES.rst:597 msgid "" "Updated **pre-commit** config `#681 " "`_" msgstr "" -#: ../../../CHANGES.rst:466 +#: ../../../CHANGES.rst:599 msgid "" "Reworked **handlers_in_use** util. Function moved to Router as method " "**.resolve_used_update_types()** `#682 " "`_" msgstr "" -#: ../../../CHANGES.rst:471 +#: ../../../CHANGES.rst:604 msgid "3.0.0a14 (2021-08-17)" msgstr "" -#: ../../../CHANGES.rst:476 +#: ../../../CHANGES.rst:609 msgid "" "add aliases for edit/delete reply markup to Message `#662 " "`_" msgstr "" -#: ../../../CHANGES.rst:478 +#: ../../../CHANGES.rst:611 msgid "" "Reworked outer middleware chain. Prevent to call many times the outer " "middleware for each nested router `#664 " "`_" msgstr "" -#: ../../../CHANGES.rst:485 +#: ../../../CHANGES.rst:618 msgid "" "Prepare parse mode for InputMessageContent in AnswerInlineQuery method " "`#660 `_" msgstr "" -#: ../../../CHANGES.rst:492 +#: ../../../CHANGES.rst:625 msgid "" "Added integration with :code:`towncrier` `#602 " "`_" msgstr "" -#: ../../../CHANGES.rst:499 +#: ../../../CHANGES.rst:632 msgid "" "Added `.editorconfig` `#650 " "`_" msgstr "" -#: ../../../CHANGES.rst:501 +#: ../../../CHANGES.rst:634 msgid "" "Redis storage speedup globals `#651 " "`_" msgstr "" -#: ../../../CHANGES.rst:503 +#: ../../../CHANGES.rst:636 msgid "" "add allow_sending_without_reply param to Message reply aliases `#663 " "`_" @@ -2529,3 +2601,23 @@ msgstr "" #~ msgid "\\ |release| [UNRELEASED DRAFT] (2023-01-07)" #~ msgstr "" +#~ msgid "\\ |release| [UNRELEASED DRAFT] (2023-02-12)" +#~ msgstr "" + +#~ msgid "" +#~ ":class:`aiogram.enums.chat_action.ChatActions`, " +#~ ":class:`aiogram.enums.chat_member_status.ChatMemberStatus`, " +#~ ":class:`aiogram.enums.chat_type.ChatType`, " +#~ ":class:`aiogram.enums.content_type.ContentType`, " +#~ ":class:`aiogram.enums.dice_emoji.DiceEmoji`, " +#~ ":class:`aiogram.enums.inline_query_result_type.InlineQueryResultType`," +#~ " :class:`aiogram.enums.input_media_type.InputMediaType`, " +#~ ":class:`aiogram.enums.mask_position_point.MaskPositionPoint`, " +#~ ":class:`aiogram.enums.menu_button_type.MenuButtonType`, " +#~ ":class:`aiogram.enums.message_entity_type.MessageEntityType`, " +#~ ":class:`aiogram.enums.parse_mode.ParseMode`, " +#~ ":class:`aiogram.enums.poll_type.PollType`, " +#~ ":class:`aiogram.enums.sticker_type.StickerType`, " +#~ ":class:`aiogram.enums.topic_icon_color.TopicIconColor`, " +#~ ":class:`aiogram.enums.update_type.UpdateType`," +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po index 053c8cbd..391505ee 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po +++ b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po @@ -5,17 +5,16 @@ # msgid "" msgstr "" -"Project-Id-Version: aiogram\n" +"Project-Id-Version: aiogram\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: 2022-12-10 19:44+0200\n" "Last-Translator: \n" "Language-Team: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" -"X-Generator: Poedit 3.2.2\n" +"Generated-By: Babel 2.11.0\n" #: ../../dispatcher/dispatcher.rst:3 msgid "Dispatcher" @@ -73,8 +72,8 @@ msgstr "Ізоляція подій" #: aiogram.dispatcher.dispatcher.Dispatcher.__init__:6 of msgid "" -"Disable FSM, note that if you disable FSM then you should not use " -"storage and events isolation" +"Disable FSM, note that if you disable FSM then you should not use storage" +" and events isolation" msgstr "" "Відключення кінцевого апарату, зауважте що при вимкненому кінцевому " "апаратові вам не слід використовувати сховище (кінцевого апарату) та " @@ -92,8 +91,8 @@ msgstr "Основна точка входу для подій" #: aiogram.dispatcher.dispatcher.Dispatcher.feed_update:1 of msgid "" -"Main entry point for incoming updates Response of this method can be " -"used as Webhook response" +"Main entry point for incoming updates Response of this method can be used" +" as Webhook response" msgstr "" "Основна точка входу для подій. Відповідь цього метода може бути " "використана для відповіді у Webhook" @@ -102,23 +101,44 @@ msgstr "" msgid "Run many bots with polling" msgstr "Запуск кількох ботів з опитуванням" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:3 of -msgid "Bot instances" +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:3 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:3 of +#, fuzzy +msgid "Bot instances (one or mre)" msgstr "Екземпляри ботів" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:4 of -msgid "Poling timeout" -msgstr "Час очікування на відповідь" +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:4 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:4 of +msgid "Long-polling wait time" +msgstr "" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:6 of +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:5 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:5 of msgid "Run task for each event and no wait result" msgstr "Запуск обробки без очікування результату" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:7 of +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:6 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:6 of +msgid "backoff-retry config" +msgstr "" + +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:7 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:7 of msgid "List of the update types you want your bot to receive" msgstr "Список типів подій, які має опрацьовувати ваш бот" -#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:8 of +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:8 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:8 of +msgid "handle signals (SIGINT/SIGTERM)" +msgstr "" + +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:9 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:9 of +msgid "close bot sessions on shutdown" +msgstr "" + +#: aiogram.dispatcher.dispatcher.Dispatcher.run_polling:10 +#: aiogram.dispatcher.dispatcher.Dispatcher.start_polling:10 of msgid "contextual data" msgstr "контекстні дані" @@ -149,8 +169,11 @@ msgstr "Обробка подій" #: ../../dispatcher/dispatcher.rst:45 msgid "" -"All updates can be propagated to the dispatcher by :obj:`Dispatcher." -"feed_update(bot=..., update=...)` method:" +"All updates can be propagated to the dispatcher by " +":obj:`Dispatcher.feed_update(bot=..., update=...)` method:" msgstr "" -"Усі оновлення можна передати диспетчеру через :obj:`Dispatcher." -"feed_update(bot=..., update=...)` method:" +"Усі оновлення можна передати диспетчеру через " +":obj:`Dispatcher.feed_update(bot=..., update=...)` method:" + +#~ msgid "Poling timeout" +#~ msgstr "Час очікування на відповідь" diff --git a/docs/locale/uk_UA/LC_MESSAGES/index.po b/docs/locale/uk_UA/LC_MESSAGES/index.po index 7add5fd0..e7da04ce 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/index.po +++ b/docs/locale/uk_UA/LC_MESSAGES/index.po @@ -8,20 +8,20 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-12 00:22+0200\n" +"POT-Creation-Date: 2023-03-11 01:52+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.11.0\n" #: ../../../README.rst:3 msgid "aiogram |beta badge|" msgstr "" -#: ../../../README.rst:98 +#: ../../../README.rst:94 msgid "Beta badge" msgstr "" @@ -33,6 +33,18 @@ msgstr "Ще в розробці!" msgid "MIT License" msgstr "" +#: ../../../README.rst:-1 +msgid "PyPi status" +msgstr "" + +#: ../../../README.rst:-1 +msgid "PyPi Package Version" +msgstr "" + +#: ../../../README.rst:-1 +msgid "Downloads" +msgstr "Завантаження" + #: ../../../README.rst:-1 msgid "Supported python versions" msgstr "Підтримувані версії Python" @@ -45,27 +57,11 @@ msgstr "" msgid "Tests" msgstr "Тести" -#: ../../../README.rst:-1 -msgid "PyPi Package Version" -msgstr "" - -#: ../../../README.rst:-1 -msgid "PyPi status" -msgstr "" - -#: ../../../README.rst:-1 -msgid "Downloads" -msgstr "Завантаження" - -#: ../../../README.rst:-1 -msgid "[Telegram] aiogram live" -msgstr "" - #: ../../../README.rst:-1 msgid "Codecov" msgstr "" -#: ../../../README.rst:44 +#: ../../../README.rst:40 msgid "" "**aiogram** is a modern and fully asynchronous framework for `Telegram " "Bot API `_ written in Python 3.8 " @@ -78,39 +74,39 @@ msgstr "" "`_ та `aiohttp " "`_." -#: ../../../README.rst:49 +#: ../../../README.rst:45 msgid "Make your bots faster and more powerful!" msgstr "Зробіть своїх ботів швидшими та потужнішими!" -#: ../../../README.rst:54 +#: ../../../README.rst:50 msgid "Documentation:" msgstr "Документація" -#: ../../../README.rst:52 +#: ../../../README.rst:48 msgid "🇺🇸 `English `_" msgstr "🇺🇸 `English `_" -#: ../../../README.rst:53 +#: ../../../README.rst:49 msgid "🇺🇦 `Ukrainian `_" msgstr "🇺🇦 `Українською `_" -#: ../../../README.rst:58 +#: ../../../README.rst:54 msgid "**Breaking News:**" msgstr "**Важливі новини**" -#: ../../../README.rst:60 +#: ../../../README.rst:56 msgid "*aiogram* 3.0 has breaking changes." msgstr "*aiogram* 3.0 має зміни, що ламають зворотну сумісність." -#: ../../../README.rst:62 +#: ../../../README.rst:58 msgid "It breaks backward compatibility by introducing new breaking changes!" msgstr "Порушує зворотну сумісність, вводячи нові критичні зміни!" -#: ../../../README.rst:65 +#: ../../../README.rst:61 msgid "Features" msgstr "Особливості" -#: ../../../README.rst:67 +#: ../../../README.rst:63 msgid "" "Asynchronous (`asyncio docs " "`_, :pep:`492`)" @@ -118,7 +114,7 @@ msgstr "" "Асинхронність (`asyncio docs " "`_, :pep:`492`)" -#: ../../../README.rst:68 +#: ../../../README.rst:64 msgid "" "Has type hints (:pep:`484`) and can be used with `mypy `_" @@ -126,20 +122,20 @@ msgstr "" "Має анотації типів (:pep:`484`) та може використовуватись з `mypy `_" -#: ../../../README.rst:69 +#: ../../../README.rst:65 msgid "Supports `PyPy `_" msgstr "Працює з `PyPy `_" -#: ../../../README.rst:70 +#: ../../../README.rst:66 #, fuzzy msgid "" -"Supports `Telegram Bot API 6.5 `_ and" +"Supports `Telegram Bot API 6.6 `_ and" " gets fast updates to the latest versions of the Bot API" msgstr "" "Підтримує `Telegram Bot API 6.3 `_ та" " швидко отримує оновлення до нових версії АПІ" -#: ../../../README.rst:71 +#: ../../../README.rst:67 msgid "" "Telegram Bot API integration code was `autogenerated " "`_ and can be easily re-generated " @@ -149,28 +145,28 @@ msgstr "" "/tg-codegen>`_ що надає змогу дуже легко оновлювати фреймворк до останніх" " версій АПІ" -#: ../../../README.rst:72 +#: ../../../README.rst:68 msgid "Updates router (Blueprints)" msgstr "Має роутери подій (Blueprints)" -#: ../../../README.rst:73 +#: ../../../README.rst:69 msgid "Has Finite State Machine" msgstr "Має вбудований кінцевий автомат" -#: ../../../README.rst:74 +#: ../../../README.rst:70 msgid "" "Uses powerful `magic filters " "`" msgstr "" -#: ../../../README.rst:75 +#: ../../../README.rst:71 msgid "Middlewares (incoming updates and API calls)" msgstr "" "Підтримує мідлвари (для вхідних подій від АПІ та для вихідних запитів до " "АПІ)" -#: ../../../README.rst:76 +#: ../../../README.rst:72 msgid "" "Provides `Replies into Webhook `_" @@ -179,13 +175,13 @@ msgstr "" "`_" -#: ../../../README.rst:77 +#: ../../../README.rst:73 msgid "Integrated I18n/L10n support with GNU Gettext (or Fluent)" msgstr "" "Має вбудовану інтеграцію для використання інтернаціоналізації та " "локалізації GNU Gettext (або Fluent)" -#: ../../../README.rst:82 +#: ../../../README.rst:78 msgid "" "It is strongly advised that you have prior experience working with " "`asyncio `_ before " @@ -195,39 +191,39 @@ msgstr "" "починати використовувати цей фреймворк. `asyncio " "`_" -#: ../../../README.rst:86 +#: ../../../README.rst:82 msgid "If you have any questions, you can visit our community chats on Telegram:" msgstr "Якщо є якість додаткові запитання, ласкаво просимо до онлайн-спільнот:" -#: ../../../README.rst:88 +#: ../../../README.rst:84 msgid "🇺🇸 `@aiogram `_" msgstr "" -#: ../../../README.rst:89 +#: ../../../README.rst:85 msgid "🇺🇦 `@aiogramua `_" msgstr "" -#: ../../../README.rst:90 +#: ../../../README.rst:86 msgid "🇺🇿 `@aiogram_uz `_" msgstr "" -#: ../../../README.rst:91 +#: ../../../README.rst:87 msgid "🇰🇿 `@aiogram_kz `_" msgstr "" -#: ../../../README.rst:92 +#: ../../../README.rst:88 msgid "🇷🇺 `@aiogram_ru `_" msgstr "💩 `@aiogram_ru `_" -#: ../../../README.rst:93 +#: ../../../README.rst:89 msgid "🇮🇷 `@aiogram_fa `_" msgstr "" -#: ../../../README.rst:94 +#: ../../../README.rst:90 msgid "🇮🇹 `@aiogram_it `_" msgstr "" -#: ../../../README.rst:95 +#: ../../../README.rst:91 msgid "🇧🇷 `@aiogram_br `_" msgstr "" @@ -239,3 +235,5 @@ msgstr "Приклад використання" msgid "Contents" msgstr "Зміст" +#~ msgid "[Telegram] aiogram live" +#~ msgstr "" diff --git a/tests/test_api/test_methods/test_add_sticker_to_set.py b/tests/test_api/test_methods/test_add_sticker_to_set.py index 0bc6472c..94e9c3f1 100644 --- a/tests/test_api/test_methods/test_add_sticker_to_set.py +++ b/tests/test_api/test_methods/test_add_sticker_to_set.py @@ -1,4 +1,5 @@ from aiogram.methods import AddStickerToSet, Request +from aiogram.types import InputSticker from tests.mocked_bot import MockedBot @@ -7,7 +8,9 @@ class TestAddStickerToSet: prepare_result = bot.add_result_for(AddStickerToSet, ok=True, result=True) response: bool = await AddStickerToSet( - user_id=42, name="test stickers pack", png_sticker="file id", emojis=":)" + user_id=42, + name="test stickers pack", + sticker=InputSticker(sticker="file id", emoji_list=[":)"]), ) request: Request = bot.get_request() assert request.method == "addStickerToSet" @@ -17,7 +20,9 @@ class TestAddStickerToSet: prepare_result = bot.add_result_for(AddStickerToSet, ok=True, result=True) response: bool = await bot.add_sticker_to_set( - user_id=42, name="test stickers pack", png_sticker="file id", emojis=":)" + user_id=42, + name="test stickers pack", + sticker=InputSticker(sticker="file id", emoji_list=[":)"]), ) request: Request = bot.get_request() assert request.method == "addStickerToSet" diff --git a/tests/test_api/test_methods/test_answer_inline_query.py b/tests/test_api/test_methods/test_answer_inline_query.py index c2d11b43..c3b35a2e 100644 --- a/tests/test_api/test_methods/test_answer_inline_query.py +++ b/tests/test_api/test_methods/test_answer_inline_query.py @@ -32,7 +32,9 @@ class TestAnswerInlineQuery: def test_parse_mode(self, bot: MockedBot): query = AnswerInlineQuery( inline_query_id="query id", - results=[InlineQueryResultPhoto(id="result id", photo_url="photo", thumb_url="thumb")], + results=[ + InlineQueryResultPhoto(id="result id", photo_url="photo", thumbnail_url="thumb") + ], ) request = query.build_request(bot) assert request.data["results"][0]["parse_mode"] is None @@ -48,7 +50,7 @@ class TestAnswerInlineQuery: InlineQueryResultPhoto( id="result id", photo_url="photo", - thumb_url="thumb", + thumbnail_url="thumb", input_message_content=InputTextMessageContent(message_text="test"), ) ], diff --git a/tests/test_api/test_methods/test_create_new_sticker_set.py b/tests/test_api/test_methods/test_create_new_sticker_set.py index b82b1974..ba44266e 100644 --- a/tests/test_api/test_methods/test_create_new_sticker_set.py +++ b/tests/test_api/test_methods/test_create_new_sticker_set.py @@ -1,4 +1,6 @@ +from aiogram.enums import StickerFormat from aiogram.methods import CreateNewStickerSet, Request +from aiogram.types import FSInputFile, InputSticker from tests.mocked_bot import MockedBot @@ -7,7 +9,14 @@ class TestCreateNewStickerSet: prepare_result = bot.add_result_for(CreateNewStickerSet, ok=True, result=True) response: bool = await CreateNewStickerSet( - user_id=42, name="name", title="title", png_sticker="file id", emojis=":)" + user_id=42, + name="name", + title="title", + stickers=[ + InputSticker(sticker="file id", emoji_list=[":)"]), + InputSticker(sticker=FSInputFile("file.png"), emoji_list=["=("]), + ], + sticker_format=StickerFormat.STATIC, ) request: Request = bot.get_request() assert request.method == "createNewStickerSet" @@ -17,7 +26,14 @@ class TestCreateNewStickerSet: prepare_result = bot.add_result_for(CreateNewStickerSet, ok=True, result=True) response: bool = await bot.create_new_sticker_set( - user_id=42, name="name", title="title", png_sticker="file id", emojis=":)" + user_id=42, + name="name", + title="title", + stickers=[ + InputSticker(sticker="file id", emoji_list=[":)"]), + InputSticker(sticker=FSInputFile("file.png"), emoji_list=["=("]), + ], + sticker_format=StickerFormat.STATIC, ) request: Request = bot.get_request() assert request.method == "createNewStickerSet" diff --git a/tests/test_api/test_methods/test_delete_sticker_set.py b/tests/test_api/test_methods/test_delete_sticker_set.py new file mode 100644 index 00000000..4ab6a1a0 --- /dev/null +++ b/tests/test_api/test_methods/test_delete_sticker_set.py @@ -0,0 +1,20 @@ +from aiogram.methods import DeleteStickerSet, Request +from tests.mocked_bot import MockedBot + + +class TestDeleteStickerSet: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(DeleteStickerSet, ok=True, result=True) + + response: bool = await DeleteStickerSet(name="test") + request: Request = bot.get_request() + assert request.method == "deleteStickerSet" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(DeleteStickerSet, ok=True, result=True) + + response: bool = await bot.delete_sticker_set(name="test") + request: Request = bot.get_request() + assert request.method == "deleteStickerSet" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_get_my_description.py b/tests/test_api/test_methods/test_get_my_description.py new file mode 100644 index 00000000..8a861ecb --- /dev/null +++ b/tests/test_api/test_methods/test_get_my_description.py @@ -0,0 +1,25 @@ +from aiogram.methods import GetMyDescription, Request +from aiogram.types import BotDescription +from tests.mocked_bot import MockedBot + + +class TestGetMyDescription: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for( + GetMyDescription, ok=True, result=BotDescription(description="Test") + ) + + response: BotDescription = await GetMyDescription() + request: Request = bot.get_request() + assert request.method == "getMyDescription" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for( + GetMyDescription, ok=True, result=BotDescription(description="Test") + ) + + response: BotDescription = await bot.get_my_description() + request: Request = bot.get_request() + assert request.method == "getMyDescription" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_get_my_short_description.py b/tests/test_api/test_methods/test_get_my_short_description.py new file mode 100644 index 00000000..5d362fdb --- /dev/null +++ b/tests/test_api/test_methods/test_get_my_short_description.py @@ -0,0 +1,25 @@ +from aiogram.methods import GetMyShortDescription, Request +from aiogram.types import BotShortDescription +from tests.mocked_bot import MockedBot + + +class TestGetMyShortDescription: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for( + GetMyShortDescription, ok=True, result=BotShortDescription(short_description="Test") + ) + + response: BotShortDescription = await GetMyShortDescription() + request: Request = bot.get_request() + assert request.method == "getMyShortDescription" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for( + GetMyShortDescription, ok=True, result=BotShortDescription(short_description="Test") + ) + + response: BotShortDescription = await bot.get_my_short_description() + request: Request = bot.get_request() + assert request.method == "getMyShortDescription" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_send_video_note.py b/tests/test_api/test_methods/test_send_video_note.py index e9afee41..bec233c7 100644 --- a/tests/test_api/test_methods/test_send_video_note.py +++ b/tests/test_api/test_methods/test_send_video_note.py @@ -21,7 +21,9 @@ class TestSendVideoNote: ) response: Message = await SendVideoNote( - chat_id=42, video_note="file id", thumb=BufferedInputFile(b"", "file.png") + chat_id=42, + video_note="file id", + thumbnail=BufferedInputFile(b"", "file.png"), ) request: Request = bot.get_request() assert request.method == "sendVideoNote" @@ -42,7 +44,9 @@ class TestSendVideoNote: ) response: Message = await bot.send_video_note( - chat_id=42, video_note="file id", thumb=BufferedInputFile(b"", "file.png") + chat_id=42, + video_note="file id", + thumbnail=BufferedInputFile(b"", "file.png"), ) request: Request = bot.get_request() assert request.method == "sendVideoNote" diff --git a/tests/test_api/test_methods/test_set_custom_emoji_sticker_set_thumbnail.py b/tests/test_api/test_methods/test_set_custom_emoji_sticker_set_thumbnail.py new file mode 100644 index 00000000..20ad08c9 --- /dev/null +++ b/tests/test_api/test_methods/test_set_custom_emoji_sticker_set_thumbnail.py @@ -0,0 +1,28 @@ +from aiogram.methods import Request, SetCustomEmojiStickerSetThumbnail +from tests.mocked_bot import MockedBot + + +class TestSetCustomEmojiStickerSetThumbnail: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for( + SetCustomEmojiStickerSetThumbnail, ok=True, result=True + ) + + response: bool = await SetCustomEmojiStickerSetThumbnail( + name="test", custom_emoji_id="custom id" + ) + request: Request = bot.get_request() + assert request.method == "setCustomEmojiStickerSetThumbnail" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for( + SetCustomEmojiStickerSetThumbnail, ok=True, result=True + ) + + response: bool = await bot.set_custom_emoji_sticker_set_thumbnail( + name="test", custom_emoji_id="custom id" + ) + request: Request = bot.get_request() + assert request.method == "setCustomEmojiStickerSetThumbnail" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_my_description.py b/tests/test_api/test_methods/test_set_my_description.py new file mode 100644 index 00000000..843b66d2 --- /dev/null +++ b/tests/test_api/test_methods/test_set_my_description.py @@ -0,0 +1,20 @@ +from aiogram.methods import Request, SetMyDescription +from tests.mocked_bot import MockedBot + + +class TestSetMyDescription: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetMyDescription, ok=True, result=True) + + response: bool = await SetMyDescription(description="Test") + request: Request = bot.get_request() + assert request.method == "setMyDescription" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetMyDescription, ok=True, result=True) + + response: bool = await bot.set_my_description(description="Test") + request: Request = bot.get_request() + assert request.method == "setMyDescription" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_my_short_description.py b/tests/test_api/test_methods/test_set_my_short_description.py new file mode 100644 index 00000000..c985dee2 --- /dev/null +++ b/tests/test_api/test_methods/test_set_my_short_description.py @@ -0,0 +1,20 @@ +from aiogram.methods import Request, SetMyDescription, SetMyShortDescription +from tests.mocked_bot import MockedBot + + +class TestSetMyShortDescription: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetMyShortDescription, ok=True, result=True) + + response: bool = await SetMyShortDescription(short_description="Test") + request: Request = bot.get_request() + assert request.method == "setMyShortDescription" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetMyShortDescription, ok=True, result=True) + + response: bool = await bot.set_my_short_description(short_description="Test") + request: Request = bot.get_request() + assert request.method == "setMyShortDescription" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_sticker_emoji_list.py b/tests/test_api/test_methods/test_set_sticker_emoji_list.py new file mode 100644 index 00000000..b5ae829c --- /dev/null +++ b/tests/test_api/test_methods/test_set_sticker_emoji_list.py @@ -0,0 +1,20 @@ +from aiogram.methods import Request, SetStickerEmojiList +from tests.mocked_bot import MockedBot + + +class TestSetStickerEmojiList: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerEmojiList, ok=True, result=True) + + response: bool = await SetStickerEmojiList(sticker="sticker id", emoji_list=["X"]) + request: Request = bot.get_request() + assert request.method == "setStickerEmojiList" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerEmojiList, ok=True, result=True) + + response: bool = await bot.set_sticker_emoji_list(sticker="sticker id", emoji_list=["X"]) + request: Request = bot.get_request() + assert request.method == "setStickerEmojiList" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_sticker_keywords.py b/tests/test_api/test_methods/test_set_sticker_keywords.py new file mode 100644 index 00000000..7cea6cae --- /dev/null +++ b/tests/test_api/test_methods/test_set_sticker_keywords.py @@ -0,0 +1,20 @@ +from aiogram.methods import Request, SetStickerKeywords +from tests.mocked_bot import MockedBot + + +class TestSetStickerKeywords: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerKeywords, ok=True, result=True) + + response: bool = await SetStickerKeywords(sticker="sticker id", keywords=["X"]) + request: Request = bot.get_request() + assert request.method == "setStickerKeywords" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerKeywords, ok=True, result=True) + + response: bool = await bot.set_sticker_keywords(sticker="sticker id", keywords=["X"]) + request: Request = bot.get_request() + assert request.method == "setStickerKeywords" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_sticker_mask_position.py b/tests/test_api/test_methods/test_set_sticker_mask_position.py new file mode 100644 index 00000000..dec92d19 --- /dev/null +++ b/tests/test_api/test_methods/test_set_sticker_mask_position.py @@ -0,0 +1,20 @@ +from aiogram.methods import Request, SetStickerEmojiList, SetStickerMaskPosition +from tests.mocked_bot import MockedBot + + +class TestSetStickerEmojiList: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerMaskPosition, ok=True, result=True) + + response: bool = await SetStickerMaskPosition(sticker="sticker id") + request: Request = bot.get_request() + assert request.method == "setStickerMaskPosition" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerMaskPosition, ok=True, result=True) + + response: bool = await bot.set_sticker_mask_position(sticker="sticker id") + request: Request = bot.get_request() + assert request.method == "setStickerMaskPosition" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_sticker_set_thumb.py b/tests/test_api/test_methods/test_set_sticker_set_thumb.py deleted file mode 100644 index ca1b596a..00000000 --- a/tests/test_api/test_methods/test_set_sticker_set_thumb.py +++ /dev/null @@ -1,22 +0,0 @@ -from aiogram.methods import Request, SetStickerSetThumb -from tests.mocked_bot import MockedBot - - -class TestSetStickerSetThumb: - async def test_method(self, bot: MockedBot): - prepare_result = bot.add_result_for(SetStickerSetThumb, ok=True, result=None) - - response: bool = await SetStickerSetThumb(name="test", user_id=42) - request: Request = bot.get_request() - assert request.method == "setStickerSetThumb" - # assert request.data == {} - assert response == prepare_result.result - - async def test_bot_method(self, bot: MockedBot): - prepare_result = bot.add_result_for(SetStickerSetThumb, ok=True, result=None) - - response: bool = await bot.set_sticker_set_thumb(name="test", user_id=42) - request: Request = bot.get_request() - assert request.method == "setStickerSetThumb" - # assert request.data == {} - assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_sticker_set_thumbnail.py b/tests/test_api/test_methods/test_set_sticker_set_thumbnail.py new file mode 100644 index 00000000..41795be6 --- /dev/null +++ b/tests/test_api/test_methods/test_set_sticker_set_thumbnail.py @@ -0,0 +1,22 @@ +from aiogram.methods import Request, SetStickerSetThumbnail +from tests.mocked_bot import MockedBot + + +class TestSetStickerSetThumbnail: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerSetThumbnail, ok=True, result=None) + + response: bool = await SetStickerSetThumbnail(name="test", user_id=42) + request: Request = bot.get_request() + assert request.method == "setStickerSetThumbnail" + # assert request.data == {} + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerSetThumbnail, ok=True, result=None) + + response: bool = await bot.set_sticker_set_thumbnail(name="test", user_id=42) + request: Request = bot.get_request() + assert request.method == "setStickerSetThumbnail" + # assert request.data == {} + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_set_sticker_set_title.py b/tests/test_api/test_methods/test_set_sticker_set_title.py new file mode 100644 index 00000000..1dc306bc --- /dev/null +++ b/tests/test_api/test_methods/test_set_sticker_set_title.py @@ -0,0 +1,20 @@ +from aiogram.methods import Request, SetStickerEmojiList, SetStickerSetTitle +from tests.mocked_bot import MockedBot + + +class TestSetStickerSetTitle: + async def test_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerSetTitle, ok=True, result=True) + + response: bool = await SetStickerSetTitle(name="test", title="Test") + request: Request = bot.get_request() + assert request.method == "setStickerSetTitle" + assert response == prepare_result.result + + async def test_bot_method(self, bot: MockedBot): + prepare_result = bot.add_result_for(SetStickerSetTitle, ok=True, result=True) + + response: bool = await bot.set_sticker_set_title(name="test", title="Test") + request: Request = bot.get_request() + assert request.method == "setStickerSetTitle" + assert response == prepare_result.result diff --git a/tests/test_api/test_methods/test_upload_sticker_file.py b/tests/test_api/test_methods/test_upload_sticker_file.py index f8332815..7a6bded9 100644 --- a/tests/test_api/test_methods/test_upload_sticker_file.py +++ b/tests/test_api/test_methods/test_upload_sticker_file.py @@ -1,3 +1,4 @@ +from aiogram.enums import StickerFormat from aiogram.methods import Request, UploadStickerFile from aiogram.types import BufferedInputFile, File from tests.mocked_bot import MockedBot @@ -10,7 +11,9 @@ class TestUploadStickerFile: ) response: File = await UploadStickerFile( - user_id=42, png_sticker=BufferedInputFile(b"", "file.png") + user_id=42, + sticker=BufferedInputFile(b"", "file.png"), + sticker_format=StickerFormat.STATIC, ) request: Request = bot.get_request() assert request.method == "uploadStickerFile" @@ -22,7 +25,9 @@ class TestUploadStickerFile: ) response: File = await bot.upload_sticker_file( - user_id=42, png_sticker=BufferedInputFile(b"", "file.png") + user_id=42, + sticker=BufferedInputFile(b"", "file.png"), + sticker_format=StickerFormat.STATIC, ) request: Request = bot.get_request() assert request.method == "uploadStickerFile"