From 3ea73fbbbdfd5dd5c71e9b19e39cbd1ff99b500d Mon Sep 17 00:00:00 2001 From: Alex Root Junior Date: Sun, 4 Dec 2022 03:05:49 +0200 Subject: [PATCH] Add missing shortcuts, new enums, reworked old stuff (#1070) * Render shortcuts * Render docs * Added enumerations * Added docs * Use enums, removed Helper * Bump butcher * Added InputMediaType enum * Added MaskPositionPoint, InlineQueryResultType enums * Update texts * Added StickerType enum * Cover tests * Update docs * Fixed imports * Re-enabled all pre-commit hooks --- .butcher/enums/BotCommandScopeType.yml | 16 + .butcher/enums/ChatActions.yml | 22 + .butcher/enums/ChatMemberStatus.yml | 15 + .butcher/enums/ChatType.yml | 11 + .../{content_type.yml => ContentType.yml} | 3 +- .butcher/enums/{dice.yml => DiceEmoji.yml} | 5 +- .butcher/enums/InlineQueryResultType.yml | 29 + .butcher/enums/InputMediaType.yml | 14 + .butcher/enums/MaskPositionPoint.yml | 9 + .butcher/enums/MenuButtonType.yml | 13 + .butcher/enums/MessageEntityType.yml | 10 + .butcher/enums/ParseMode.yml | 9 + .butcher/enums/PollType.yml | 9 + .butcher/enums/StickerType.yml | 9 + ...opic_icon_color.yml => TopicIconColor.yml} | 0 .butcher/enums/UpdateType.yml | 9 + .butcher/enums/chat_type.yml | 6 - .butcher/enums/update_type.yml | 6 - .butcher/templates/enums/index.rst.jinja2 | 2 +- .butcher/templates/methods/entity.rst.jinja2 | 2 +- .butcher/types/CallbackQuery/aliases.yml | 4 + .butcher/types/Chat/aliases.yml | 216 +- .butcher/types/ChatJoinRequest/aliases.yml | 8 + .butcher/types/ErrorEvent/replace.yml | 2 + .butcher/types/InlineQuery/aliases.yml | 4 + .butcher/types/Message/aliases.yml | 328 +- .butcher/types/Sticker/aliases.yml | 8 + .butcher/types/User/aliases.yml | 4 + CHANGES/952.feature.rst | 52 + aiogram/client/bot.py | 11 +- aiogram/enums/__init__.py | 22 + aiogram/enums/bot_command_scope_type.py | 17 + aiogram/enums/chat_action.py | 32 + aiogram/enums/chat_member_status.py | 16 + aiogram/enums/chat_type.py | 5 +- aiogram/enums/content_type.py | 2 +- aiogram/enums/dice_emoji.py | 2 + aiogram/enums/inline_query_result_type.py | 23 + aiogram/enums/input_media_type.py | 15 + aiogram/enums/mask_position_point.py | 14 + aiogram/enums/menu_button_type.py | 13 + aiogram/enums/message_entity_type.py | 27 + aiogram/enums/parse_mode.py | 13 + aiogram/enums/poll_type.py | 12 + aiogram/enums/sticker_type.py | 13 + aiogram/enums/update_type.py | 4 +- aiogram/types/__init__.py | 224 +- ...t_command_scope_all_chat_administrators.py | 3 +- .../bot_command_scope_all_group_chats.py | 3 +- .../bot_command_scope_all_private_chats.py | 3 +- aiogram/types/bot_command_scope_chat.py | 3 +- .../bot_command_scope_chat_administrators.py | 3 +- .../types/bot_command_scope_chat_member.py | 3 +- aiogram/types/bot_command_scope_default.py | 3 +- aiogram/types/callback_query.py | 30 +- aiogram/types/chat.py | 890 +++- aiogram/types/chat_action.py | 33 - aiogram/types/chat_join_request.py | 48 +- aiogram/types/chat_member_administrator.py | 3 +- aiogram/types/chat_member_banned.py | 3 +- aiogram/types/chat_member_left.py | 3 +- aiogram/types/chat_member_member.py | 3 +- aiogram/types/chat_member_owner.py | 3 +- aiogram/types/chat_member_restricted.py | 3 +- aiogram/types/error_event.py | 20 +- aiogram/types/inline_query.py | 34 +- aiogram/types/inline_query_result_article.py | 3 +- aiogram/types/inline_query_result_audio.py | 3 +- .../types/inline_query_result_cached_audio.py | 3 +- .../inline_query_result_cached_document.py | 3 +- .../types/inline_query_result_cached_gif.py | 3 +- .../inline_query_result_cached_mpeg4_gif.py | 3 +- .../types/inline_query_result_cached_photo.py | 3 +- .../inline_query_result_cached_sticker.py | 3 +- .../types/inline_query_result_cached_video.py | 3 +- .../types/inline_query_result_cached_voice.py | 3 +- aiogram/types/inline_query_result_contact.py | 3 +- aiogram/types/inline_query_result_document.py | 3 +- aiogram/types/inline_query_result_game.py | 3 +- aiogram/types/inline_query_result_gif.py | 3 +- aiogram/types/inline_query_result_location.py | 3 +- .../types/inline_query_result_mpeg4_gif.py | 3 +- aiogram/types/inline_query_result_photo.py | 3 +- aiogram/types/inline_query_result_venue.py | 3 +- aiogram/types/inline_query_result_video.py | 3 +- aiogram/types/inline_query_result_voice.py | 3 +- aiogram/types/input_media_animation.py | 3 +- aiogram/types/input_media_audio.py | 3 +- aiogram/types/input_media_document.py | 3 +- aiogram/types/input_media_photo.py | 3 +- aiogram/types/input_media_video.py | 3 +- aiogram/types/menu_button_commands.py | 3 +- aiogram/types/menu_button_default.py | 3 +- aiogram/types/menu_button_web_app.py | 3 +- aiogram/types/message.py | 1789 +++++-- aiogram/types/sticker.py | 58 +- aiogram/types/user.py | 37 +- aiogram/utils/enum.py | 8 - aiogram/utils/helper.py | 293 -- aiogram/utils/text_decorations.py | 26 +- docs/api/bot.rst | 1 + docs/api/enums/bot_command_scope_type.rst | 9 + docs/api/enums/chat_action.rst | 9 + docs/api/enums/chat_member_status.rst | 9 + docs/api/enums/index.rst | 13 +- docs/api/enums/inline_query_result_type.rst | 9 + docs/api/enums/input_media_type.rst | 9 + docs/api/enums/mask_position_point.rst | 9 + docs/api/enums/menu_button_type.rst | 9 + docs/api/enums/message_entity_type.rst | 9 + docs/api/enums/parse_mode.rst | 9 + docs/api/enums/poll_type.rst | 9 + docs/api/enums/sticker_type.rst | 9 + docs/api/methods/answer_callback_query.rst | 6 + docs/api/methods/answer_inline_query.rst | 6 + .../api/methods/approve_chat_join_request.rst | 6 + docs/api/methods/ban_chat_member.rst | 6 + docs/api/methods/ban_chat_sender_chat.rst | 6 + docs/api/methods/copy_message.rst | 6 + docs/api/methods/create_chat_invite_link.rst | 6 + .../api/methods/decline_chat_join_request.rst | 6 + docs/api/methods/delete_chat_photo.rst | 6 + docs/api/methods/delete_chat_sticker_set.rst | 6 + docs/api/methods/delete_message.rst | 7 + docs/api/methods/delete_sticker_from_set.rst | 6 + docs/api/methods/edit_chat_invite_link.rst | 6 + docs/api/methods/edit_message_caption.rst | 6 + .../methods/edit_message_live_location.rst | 6 + docs/api/methods/edit_message_media.rst | 6 + .../api/methods/edit_message_reply_markup.rst | 6 + docs/api/methods/edit_message_text.rst | 6 + docs/api/methods/export_chat_invite_link.rst | 6 + docs/api/methods/forward_message.rst | 6 + docs/api/methods/get_chat_administrators.rst | 8 + docs/api/methods/get_chat_member.rst | 8 + docs/api/methods/get_chat_member_count.rst | 8 + docs/api/methods/get_chat_members_count.rst | 37 - docs/api/methods/get_user_profile_photos.rst | 8 + docs/api/methods/kick_chat_member.rst | 44 - docs/api/methods/leave_chat.rst | 6 + docs/api/methods/pin_chat_message.rst | 7 + docs/api/methods/promote_chat_member.rst | 6 + docs/api/methods/restrict_chat_member.rst | 6 + docs/api/methods/revoke_chat_invite_link.rst | 6 + docs/api/methods/send_animation.rst | 7 + docs/api/methods/send_audio.rst | 7 + docs/api/methods/send_chat_action.rst | 6 + docs/api/methods/send_contact.rst | 7 + docs/api/methods/send_dice.rst | 7 + docs/api/methods/send_document.rst | 7 + docs/api/methods/send_game.rst | 7 + docs/api/methods/send_invoice.rst | 7 + docs/api/methods/send_location.rst | 7 + docs/api/methods/send_media_group.rst | 7 + docs/api/methods/send_message.rst | 7 + docs/api/methods/send_photo.rst | 7 + docs/api/methods/send_poll.rst | 7 + docs/api/methods/send_sticker.rst | 7 + docs/api/methods/send_venue.rst | 7 + docs/api/methods/send_video.rst | 7 + docs/api/methods/send_video_note.rst | 7 + docs/api/methods/send_voice.rst | 7 + .../set_chat_administrator_custom_title.rst | 6 + docs/api/methods/set_chat_description.rst | 6 + docs/api/methods/set_chat_permissions.rst | 6 + docs/api/methods/set_chat_photo.rst | 8 + docs/api/methods/set_chat_sticker_set.rst | 6 + docs/api/methods/set_chat_title.rst | 6 + .../methods/set_sticker_position_in_set.rst | 6 + .../methods/stop_message_live_location.rst | 6 + docs/api/methods/unban_chat_member.rst | 6 + docs/api/methods/unban_chat_sender_chat.rst | 6 + docs/api/methods/unpin_all_chat_messages.rst | 6 + docs/api/methods/unpin_chat_message.rst | 7 + docs/api/types/index.rst | 8 + docs/locale/en/LC_MESSAGES/api/bot.po | 4616 +++++++++-------- .../api/enums/bot_command_scope_type.po | 30 + .../en/LC_MESSAGES/api/enums/chat_action.po | 66 + .../api/enums/chat_member_status.po | 30 + .../en/LC_MESSAGES/api/enums/chat_type.po | 30 + .../en/LC_MESSAGES/api/enums/content_type.po | 26 + .../en/LC_MESSAGES/api/enums/dice_emoji.po | 30 + docs/locale/en/LC_MESSAGES/api/enums/index.po | 26 + .../api/enums/inline_query_result_type.po | 30 + .../LC_MESSAGES/api/enums/input_media_type.po | 30 + .../api/enums/mask_position_point.po | 30 + .../LC_MESSAGES/api/enums/menu_button_type.po | 30 + .../api/enums/message_entity_type.po | 30 + .../en/LC_MESSAGES/api/enums/parse_mode.po | 30 + .../en/LC_MESSAGES/api/enums/poll_type.po | 30 + .../LC_MESSAGES/api/enums/topic_icon_color.po | 32 + .../en/LC_MESSAGES/api/enums/update_type.po | 30 + .../api/methods/answer_callback_query.po | 10 +- .../api/methods/answer_inline_query.po | 10 +- .../api/methods/approve_chat_join_request.po | 10 +- .../api/methods/ban_chat_member.po | 10 +- .../api/methods/ban_chat_sender_chat.po | 10 +- .../LC_MESSAGES/api/methods/copy_message.po | 10 +- .../api/methods/create_chat_invite_link.po | 10 +- .../api/methods/create_forum_topic.po | 14 +- .../api/methods/decline_chat_join_request.po | 10 +- .../api/methods/delete_chat_photo.po | 10 +- .../api/methods/delete_chat_sticker_set.po | 10 +- .../LC_MESSAGES/api/methods/delete_message.po | 14 +- .../api/methods/delete_sticker_from_set.po | 10 +- .../api/methods/edit_chat_invite_link.po | 10 +- .../api/methods/edit_forum_topic.po | 13 +- .../api/methods/edit_message_caption.po | 10 +- .../api/methods/edit_message_live_location.po | 10 +- .../api/methods/edit_message_media.po | 10 +- .../api/methods/edit_message_reply_markup.po | 10 +- .../api/methods/edit_message_text.po | 10 +- .../api/methods/export_chat_invite_link.po | 10 +- .../api/methods/forward_message.po | 10 +- .../api/methods/get_chat_administrators.po | 10 +- .../api/methods/get_chat_member.po | 10 +- .../api/methods/get_chat_member_count.po | 10 +- .../api/methods/get_chat_members_count.po | 35 +- .../api/methods/get_user_profile_photos.po | 10 +- .../api/methods/kick_chat_member.po | 94 +- .../en/LC_MESSAGES/api/methods/leave_chat.po | 10 +- .../api/methods/pin_chat_message.po | 14 +- .../api/methods/promote_chat_member.po | 10 +- .../api/methods/restrict_chat_member.po | 10 +- .../api/methods/revoke_chat_invite_link.po | 10 +- .../LC_MESSAGES/api/methods/send_animation.po | 14 +- .../en/LC_MESSAGES/api/methods/send_audio.po | 14 +- .../api/methods/send_chat_action.po | 10 +- .../LC_MESSAGES/api/methods/send_contact.po | 14 +- .../en/LC_MESSAGES/api/methods/send_dice.po | 14 +- .../LC_MESSAGES/api/methods/send_document.po | 14 +- .../en/LC_MESSAGES/api/methods/send_game.po | 14 +- .../LC_MESSAGES/api/methods/send_invoice.po | 14 +- .../LC_MESSAGES/api/methods/send_location.po | 14 +- .../api/methods/send_media_group.po | 14 +- .../LC_MESSAGES/api/methods/send_message.po | 14 +- .../en/LC_MESSAGES/api/methods/send_photo.po | 14 +- .../en/LC_MESSAGES/api/methods/send_poll.po | 14 +- .../LC_MESSAGES/api/methods/send_sticker.po | 14 +- .../en/LC_MESSAGES/api/methods/send_venue.po | 14 +- .../en/LC_MESSAGES/api/methods/send_video.po | 14 +- .../api/methods/send_video_note.po | 14 +- .../en/LC_MESSAGES/api/methods/send_voice.po | 14 +- .../set_chat_administrator_custom_title.po | 10 +- .../api/methods/set_chat_description.po | 10 +- .../api/methods/set_chat_permissions.po | 10 +- .../LC_MESSAGES/api/methods/set_chat_photo.po | 10 +- .../api/methods/set_chat_sticker_set.po | 10 +- .../LC_MESSAGES/api/methods/set_chat_title.po | 10 +- .../methods/set_sticker_position_in_set.po | 10 +- .../api/methods/stop_message_live_location.po | 10 +- .../api/methods/unban_chat_member.po | 10 +- .../api/methods/unban_chat_sender_chat.po | 10 +- .../api/methods/unpin_all_chat_messages.po | 10 +- .../api/methods/unpin_chat_message.po | 14 +- .../LC_MESSAGES/api/types/callback_query.po | 71 +- docs/locale/en/LC_MESSAGES/api/types/chat.po | 1016 +++- .../api/types/chat_join_request.po | 67 +- .../en/LC_MESSAGES/api/types/chat_member.po | 7 +- docs/locale/en/LC_MESSAGES/api/types/index.po | 31 +- .../en/LC_MESSAGES/api/types/inline_query.po | 73 +- .../en/LC_MESSAGES/api/types/menu_button.po | 7 +- .../en/LC_MESSAGES/api/types/message.po | 1983 ++++++- .../LC_MESSAGES/api/types/message_entity.po | 16 +- .../api/types/reply_keyboard_markup.po | 17 +- .../en/LC_MESSAGES/api/types/sticker.po | 66 +- docs/locale/en/LC_MESSAGES/api/types/user.po | 49 +- docs/locale/en/LC_MESSAGES/changelog.po | 447 +- .../en/LC_MESSAGES/dispatcher/router.po | 14 +- docs/locale/uk_UA/LC_MESSAGES/api/bot.po | 4616 +++++++++-------- .../api/enums/bot_command_scope_type.po | 30 + .../LC_MESSAGES/api/enums/chat_action.po | 66 + .../api/enums/chat_member_status.po | 30 + .../uk_UA/LC_MESSAGES/api/enums/chat_type.po | 30 + .../LC_MESSAGES/api/enums/content_type.po | 26 + .../uk_UA/LC_MESSAGES/api/enums/dice_emoji.po | 30 + .../uk_UA/LC_MESSAGES/api/enums/index.po | 26 + .../api/enums/inline_query_result_type.po | 30 + .../LC_MESSAGES/api/enums/input_media_type.po | 30 + .../api/enums/mask_position_point.po | 30 + .../LC_MESSAGES/api/enums/menu_button_type.po | 30 + .../api/enums/message_entity_type.po | 30 + .../uk_UA/LC_MESSAGES/api/enums/parse_mode.po | 30 + .../uk_UA/LC_MESSAGES/api/enums/poll_type.po | 30 + .../LC_MESSAGES/api/enums/topic_icon_color.po | 32 + .../LC_MESSAGES/api/enums/update_type.po | 30 + .../api/methods/answer_callback_query.po | 10 +- .../api/methods/answer_inline_query.po | 10 +- .../api/methods/approve_chat_join_request.po | 10 +- .../api/methods/ban_chat_member.po | 10 +- .../api/methods/ban_chat_sender_chat.po | 10 +- .../LC_MESSAGES/api/methods/copy_message.po | 10 +- .../api/methods/create_chat_invite_link.po | 10 +- .../api/methods/create_forum_topic.po | 14 +- .../api/methods/decline_chat_join_request.po | 10 +- .../api/methods/delete_chat_photo.po | 10 +- .../api/methods/delete_chat_sticker_set.po | 10 +- .../LC_MESSAGES/api/methods/delete_message.po | 14 +- .../api/methods/delete_sticker_from_set.po | 10 +- .../api/methods/edit_chat_invite_link.po | 10 +- .../api/methods/edit_forum_topic.po | 13 +- .../api/methods/edit_message_caption.po | 10 +- .../api/methods/edit_message_live_location.po | 10 +- .../api/methods/edit_message_media.po | 10 +- .../api/methods/edit_message_reply_markup.po | 10 +- .../api/methods/edit_message_text.po | 10 +- .../api/methods/export_chat_invite_link.po | 10 +- .../api/methods/forward_message.po | 10 +- .../api/methods/get_chat_administrators.po | 10 +- .../api/methods/get_chat_member.po | 10 +- .../api/methods/get_chat_member_count.po | 10 +- .../api/methods/get_chat_members_count.po | 35 +- .../api/methods/get_user_profile_photos.po | 10 +- .../api/methods/kick_chat_member.po | 94 +- .../LC_MESSAGES/api/methods/leave_chat.po | 10 +- .../api/methods/pin_chat_message.po | 14 +- .../api/methods/promote_chat_member.po | 10 +- .../api/methods/restrict_chat_member.po | 10 +- .../api/methods/revoke_chat_invite_link.po | 10 +- .../LC_MESSAGES/api/methods/send_animation.po | 14 +- .../LC_MESSAGES/api/methods/send_audio.po | 14 +- .../api/methods/send_chat_action.po | 10 +- .../LC_MESSAGES/api/methods/send_contact.po | 14 +- .../LC_MESSAGES/api/methods/send_dice.po | 14 +- .../LC_MESSAGES/api/methods/send_document.po | 14 +- .../LC_MESSAGES/api/methods/send_game.po | 14 +- .../LC_MESSAGES/api/methods/send_invoice.po | 14 +- .../LC_MESSAGES/api/methods/send_location.po | 14 +- .../api/methods/send_media_group.po | 14 +- .../LC_MESSAGES/api/methods/send_message.po | 14 +- .../LC_MESSAGES/api/methods/send_photo.po | 14 +- .../LC_MESSAGES/api/methods/send_poll.po | 14 +- .../LC_MESSAGES/api/methods/send_sticker.po | 14 +- .../LC_MESSAGES/api/methods/send_venue.po | 14 +- .../LC_MESSAGES/api/methods/send_video.po | 14 +- .../api/methods/send_video_note.po | 14 +- .../LC_MESSAGES/api/methods/send_voice.po | 14 +- .../set_chat_administrator_custom_title.po | 10 +- .../api/methods/set_chat_description.po | 10 +- .../api/methods/set_chat_permissions.po | 10 +- .../LC_MESSAGES/api/methods/set_chat_photo.po | 10 +- .../api/methods/set_chat_sticker_set.po | 10 +- .../LC_MESSAGES/api/methods/set_chat_title.po | 10 +- .../methods/set_sticker_position_in_set.po | 10 +- .../api/methods/stop_message_live_location.po | 10 +- .../api/methods/unban_chat_member.po | 10 +- .../api/methods/unban_chat_sender_chat.po | 10 +- .../api/methods/unpin_all_chat_messages.po | 10 +- .../api/methods/unpin_chat_message.po | 14 +- .../LC_MESSAGES/api/types/callback_query.po | 71 +- .../uk_UA/LC_MESSAGES/api/types/chat.po | 1016 +++- .../api/types/chat_join_request.po | 67 +- .../LC_MESSAGES/api/types/chat_member.po | 7 +- .../uk_UA/LC_MESSAGES/api/types/index.po | 31 +- .../LC_MESSAGES/api/types/inline_query.po | 73 +- .../LC_MESSAGES/api/types/menu_button.po | 7 +- .../uk_UA/LC_MESSAGES/api/types/message.po | 1983 ++++++- .../LC_MESSAGES/api/types/message_entity.po | 16 +- .../api/types/reply_keyboard_markup.po | 17 +- .../uk_UA/LC_MESSAGES/api/types/sticker.po | 66 +- .../uk_UA/LC_MESSAGES/api/types/user.po | 49 +- docs/locale/uk_UA/LC_MESSAGES/changelog.po | 447 +- .../uk_UA/LC_MESSAGES/dispatcher/router.po | 14 +- poetry.lock | 8 +- pyproject.toml | 2 +- .../test_methods/test_send_chat_action.py | 2 +- tests/test_api/test_types/test_chat.py | 169 +- tests/test_api/test_types/test_sticker.py | 32 + tests/test_api/test_types/test_user.py | 6 + tests/test_utils/test_helper.py | 181 - 370 files changed, 18326 insertions(+), 6971 deletions(-) create mode 100644 .butcher/enums/BotCommandScopeType.yml create mode 100644 .butcher/enums/ChatActions.yml create mode 100644 .butcher/enums/ChatMemberStatus.yml create mode 100644 .butcher/enums/ChatType.yml rename .butcher/enums/{content_type.yml => ContentType.yml} (89%) rename .butcher/enums/{dice.yml => DiceEmoji.yml} (51%) create mode 100644 .butcher/enums/InlineQueryResultType.yml create mode 100644 .butcher/enums/InputMediaType.yml create mode 100644 .butcher/enums/MaskPositionPoint.yml create mode 100644 .butcher/enums/MenuButtonType.yml create mode 100644 .butcher/enums/MessageEntityType.yml create mode 100644 .butcher/enums/ParseMode.yml create mode 100644 .butcher/enums/PollType.yml create mode 100644 .butcher/enums/StickerType.yml rename .butcher/enums/{topic_icon_color.yml => TopicIconColor.yml} (100%) create mode 100644 .butcher/enums/UpdateType.yml delete mode 100644 .butcher/enums/chat_type.yml delete mode 100644 .butcher/enums/update_type.yml create mode 100644 .butcher/types/CallbackQuery/aliases.yml create mode 100644 .butcher/types/ChatJoinRequest/aliases.yml create mode 100644 .butcher/types/ErrorEvent/replace.yml create mode 100644 .butcher/types/InlineQuery/aliases.yml create mode 100644 .butcher/types/Sticker/aliases.yml create mode 100644 .butcher/types/User/aliases.yml create mode 100644 CHANGES/952.feature.rst create mode 100644 aiogram/enums/bot_command_scope_type.py create mode 100644 aiogram/enums/chat_action.py create mode 100644 aiogram/enums/chat_member_status.py create mode 100644 aiogram/enums/inline_query_result_type.py create mode 100644 aiogram/enums/input_media_type.py create mode 100644 aiogram/enums/mask_position_point.py create mode 100644 aiogram/enums/menu_button_type.py create mode 100644 aiogram/enums/message_entity_type.py create mode 100644 aiogram/enums/parse_mode.py create mode 100644 aiogram/enums/poll_type.py create mode 100644 aiogram/enums/sticker_type.py delete mode 100644 aiogram/types/chat_action.py delete mode 100644 aiogram/utils/enum.py delete mode 100644 aiogram/utils/helper.py create mode 100644 docs/api/enums/bot_command_scope_type.rst create mode 100644 docs/api/enums/chat_action.rst create mode 100644 docs/api/enums/chat_member_status.rst create mode 100644 docs/api/enums/inline_query_result_type.rst create mode 100644 docs/api/enums/input_media_type.rst create mode 100644 docs/api/enums/mask_position_point.rst create mode 100644 docs/api/enums/menu_button_type.rst create mode 100644 docs/api/enums/message_entity_type.rst create mode 100644 docs/api/enums/parse_mode.rst create mode 100644 docs/api/enums/poll_type.rst create mode 100644 docs/api/enums/sticker_type.rst delete mode 100644 docs/api/methods/get_chat_members_count.rst delete mode 100644 docs/api/methods/kick_chat_member.rst create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/bot_command_scope_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/chat_action.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/chat_member_status.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/chat_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/content_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/dice_emoji.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/index.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/inline_query_result_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/input_media_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/mask_position_point.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/menu_button_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/message_entity_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/parse_mode.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/poll_type.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/topic_icon_color.po create mode 100644 docs/locale/en/LC_MESSAGES/api/enums/update_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/bot_command_scope_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_action.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_member_status.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/content_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/dice_emoji.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/index.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/inline_query_result_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/input_media_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/mask_position_point.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/menu_button_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/message_entity_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/parse_mode.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/poll_type.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/topic_icon_color.po create mode 100644 docs/locale/uk_UA/LC_MESSAGES/api/enums/update_type.po create mode 100644 tests/test_api/test_types/test_sticker.py delete mode 100644 tests/test_utils/test_helper.py diff --git a/.butcher/enums/BotCommandScopeType.yml b/.butcher/enums/BotCommandScopeType.yml new file mode 100644 index 0000000000..8d2f50bd5a --- /dev/null +++ b/.butcher/enums/BotCommandScopeType.yml @@ -0,0 +1,16 @@ +name: BotCommandScopeType +description: | + This object represents the scope to which bot commands are applied. + + Source: https://core.telegram.org/bots/api#botcommandscope +multi_parse: + attribute: type + regexp: "must be ([a-z_]+)" + entities: + - BotCommandScopeDefault + - BotCommandScopeAllPrivateChats + - BotCommandScopeAllGroupChats + - BotCommandScopeAllChatAdministrators + - BotCommandScopeChat + - BotCommandScopeChatAdministrators + - BotCommandScopeChatMember diff --git a/.butcher/enums/ChatActions.yml b/.butcher/enums/ChatActions.yml new file mode 100644 index 0000000000..49710dc3d3 --- /dev/null +++ b/.butcher/enums/ChatActions.yml @@ -0,0 +1,22 @@ +name: ChatAction +description: | + This object represents bot actions. + + Choose one, depending on what the user is about to receive: + + - typing for text messages, + - upload_photo for photos, + - record_video or upload_video for videos, + - record_voice or upload_voice for voice notes, + - upload_document for general files, + - choose_sticker for stickers, + - find_location for location data, + - record_video_note or upload_video_note for video notes. + + Source: https://core.telegram.org/bots/api#sendchataction +parse: + format: rst + entity: sendChatAction + category: methods + attribute: action + regexp: '\*([a-z_]+)\*' diff --git a/.butcher/enums/ChatMemberStatus.yml b/.butcher/enums/ChatMemberStatus.yml new file mode 100644 index 0000000000..037e8717c9 --- /dev/null +++ b/.butcher/enums/ChatMemberStatus.yml @@ -0,0 +1,15 @@ +name: ChatMemberStatus +description: | + This object represents chat member status. + + Source: https://core.telegram.org/bots/api#chatmember +multi_parse: + attribute: status + regexp: "'([a-z_]+)'" + entities: + - ChatMemberOwner + - ChatMemberAdministrator + - ChatMemberMember + - ChatMemberRestricted + - ChatMemberLeft + - ChatMemberBanned diff --git a/.butcher/enums/ChatType.yml b/.butcher/enums/ChatType.yml new file mode 100644 index 0000000000..39125b26c5 --- /dev/null +++ b/.butcher/enums/ChatType.yml @@ -0,0 +1,11 @@ +name: ChatType +description: | + This object represents a chat type + + Source: https://core.telegram.org/bots/api#chat +parse: + entity: Chat + attribute: type + regexp: "'([a-z]+)'" +static: + SENDER: sender diff --git a/.butcher/enums/content_type.yml b/.butcher/enums/ContentType.yml similarity index 89% rename from .butcher/enums/content_type.yml rename to .butcher/enums/ContentType.yml index 7ee024d84e..654c89ac3d 100644 --- a/.butcher/enums/content_type.yml +++ b/.butcher/enums/ContentType.yml @@ -1,5 +1,6 @@ name: ContentType -description: "Message content type" +description: + This object represents a type of content in message static: UNKNOWN: unknown ANY: any diff --git a/.butcher/enums/dice.yml b/.butcher/enums/DiceEmoji.yml similarity index 51% rename from .butcher/enums/dice.yml rename to .butcher/enums/DiceEmoji.yml index 593cdad1e4..bf7576dcc9 100644 --- a/.butcher/enums/dice.yml +++ b/.butcher/enums/DiceEmoji.yml @@ -1,5 +1,8 @@ name: DiceEmoji -description: "Emoji on which the dice throw animation is based" +description: | + Emoji on which the dice throw animation is based + + Source: https://core.telegram.org/bots/api#dice static: DICE: 🎲 DART: 🎯 diff --git a/.butcher/enums/InlineQueryResultType.yml b/.butcher/enums/InlineQueryResultType.yml new file mode 100644 index 0000000000..8ff8ee0ca8 --- /dev/null +++ b/.butcher/enums/InlineQueryResultType.yml @@ -0,0 +1,29 @@ +name: InlineQueryResultType +description: | + The part of the face relative to which the mask should be placed. + + Source: https://core.telegram.org/bots/api#maskposition +multi_parse: + attribute: type + regexp: "must be ([a-z_]+)" + entities: + - InlineQueryResultCachedAudio + - InlineQueryResultCachedDocument + - InlineQueryResultCachedGif + - InlineQueryResultCachedMpeg4Gif + - InlineQueryResultCachedPhoto + - InlineQueryResultCachedSticker + - InlineQueryResultCachedVideo + - InlineQueryResultCachedVoice + - InlineQueryResultArticle + - InlineQueryResultAudio + - InlineQueryResultContact + - InlineQueryResultGame + - InlineQueryResultDocument + - InlineQueryResultGif + - InlineQueryResultLocation + - InlineQueryResultMpeg4Gif + - InlineQueryResultPhoto + - InlineQueryResultVenue + - InlineQueryResultVideo + - InlineQueryResultVoice diff --git a/.butcher/enums/InputMediaType.yml b/.butcher/enums/InputMediaType.yml new file mode 100644 index 0000000000..39e7e2f1e3 --- /dev/null +++ b/.butcher/enums/InputMediaType.yml @@ -0,0 +1,14 @@ +name: InputMediaType +description: | + This object represents input media type + + Source: https://core.telegram.org/bots/api#inputmedia +multi_parse: + attribute: type + regexp: 'must be ([a-z_]+)' + entities: + - InputMediaAnimation + - InputMediaAudio + - InputMediaDocument + - InputMediaPhoto + - InputMediaVideo diff --git a/.butcher/enums/MaskPositionPoint.yml b/.butcher/enums/MaskPositionPoint.yml new file mode 100644 index 0000000000..4b1da92258 --- /dev/null +++ b/.butcher/enums/MaskPositionPoint.yml @@ -0,0 +1,9 @@ +name: MaskPositionPoint +description: | + The part of the face relative to which the mask should be placed. + + Source: https://core.telegram.org/bots/api#maskposition +parse: + entity: MaskPosition + attribute: point + regexp: "'([a-z_]+)'" diff --git a/.butcher/enums/MenuButtonType.yml b/.butcher/enums/MenuButtonType.yml new file mode 100644 index 0000000000..a539d0582f --- /dev/null +++ b/.butcher/enums/MenuButtonType.yml @@ -0,0 +1,13 @@ +name: MenuButtonType +description: | + This object represents an type of Menu button + + Source: https://core.telegram.org/bots/api#menubuttondefault +multi_parse: + format: rst + attribute: type + regexp: '\*([a-z_]+)\*' + entities: + - MenuButtonDefault + - MenuButtonCommands + - MenuButtonWebApp diff --git a/.butcher/enums/MessageEntityType.yml b/.butcher/enums/MessageEntityType.yml new file mode 100644 index 0000000000..95719bc901 --- /dev/null +++ b/.butcher/enums/MessageEntityType.yml @@ -0,0 +1,10 @@ +name: MessageEntityType +description: | + This object represents type of message entity + + Source: https://core.telegram.org/bots/api#messageentity +parse: + entity: MessageEntity + category: types + attribute: type + regexp: "'([a-z_]+)'" diff --git a/.butcher/enums/ParseMode.yml b/.butcher/enums/ParseMode.yml new file mode 100644 index 0000000000..5ccb98b8b1 --- /dev/null +++ b/.butcher/enums/ParseMode.yml @@ -0,0 +1,9 @@ +name: ParseMode +description: | + Formatting options + + Source: https://core.telegram.org/bots/api#formatting-options +static: + MARKDOWN_V2: MarkdownV2 + MARKDOWN: Markdown + HTML: HTML diff --git a/.butcher/enums/PollType.yml b/.butcher/enums/PollType.yml new file mode 100644 index 0000000000..02bf95de8a --- /dev/null +++ b/.butcher/enums/PollType.yml @@ -0,0 +1,9 @@ +name: PollType +description: | + This object represents poll type + + Source: https://core.telegram.org/bots/api#poll +parse: + entity: Poll + attribute: type + regexp: "'([a-z]+)'" diff --git a/.butcher/enums/StickerType.yml b/.butcher/enums/StickerType.yml new file mode 100644 index 0000000000..5fd3542eb4 --- /dev/null +++ b/.butcher/enums/StickerType.yml @@ -0,0 +1,9 @@ +name: StickerType +description: | + The part of the face relative to which the mask should be placed. + + Source: https://core.telegram.org/bots/api#maskposition +parse: + entity: Sticker + attribute: type + regexp: "'([a-z_]+)'" diff --git a/.butcher/enums/topic_icon_color.yml b/.butcher/enums/TopicIconColor.yml similarity index 100% rename from .butcher/enums/topic_icon_color.yml rename to .butcher/enums/TopicIconColor.yml diff --git a/.butcher/enums/UpdateType.yml b/.butcher/enums/UpdateType.yml new file mode 100644 index 0000000000..ad18ef2fa1 --- /dev/null +++ b/.butcher/enums/UpdateType.yml @@ -0,0 +1,9 @@ +name: UpdateType +description: | + This object represents the complete list of allowed update types + + Source: https://core.telegram.org/bots/api#update +extract: + entity: Update + exclude: + - update_id diff --git a/.butcher/enums/chat_type.yml b/.butcher/enums/chat_type.yml deleted file mode 100644 index 2d43fc1e86..0000000000 --- a/.butcher/enums/chat_type.yml +++ /dev/null @@ -1,6 +0,0 @@ -name: ChatType -description: "Type of chat" -parse: - entity: Chat - attribute: type - regexp: "'([a-z]+)'" diff --git a/.butcher/enums/update_type.yml b/.butcher/enums/update_type.yml deleted file mode 100644 index 28b6e3e8ea..0000000000 --- a/.butcher/enums/update_type.yml +++ /dev/null @@ -1,6 +0,0 @@ -name: UpdateType -description: Known update types -extract: - entity: Update - exclude: - - update_id diff --git a/.butcher/templates/enums/index.rst.jinja2 b/.butcher/templates/enums/index.rst.jinja2 index 4dd55eb273..9cbf463af6 100644 --- a/.butcher/templates/enums/index.rst.jinja2 +++ b/.butcher/templates/enums/index.rst.jinja2 @@ -1,5 +1,5 @@ ##### -Types +Enums ##### Here is list of all available enums: diff --git a/.butcher/templates/methods/entity.rst.jinja2 b/.butcher/templates/methods/entity.rst.jinja2 index 3e3ab837c4..d2843b17d7 100755 --- a/.butcher/templates/methods/entity.rst.jinja2 +++ b/.butcher/templates/methods/entity.rst.jinja2 @@ -47,7 +47,7 @@ As reply into Webhook in handler {% if aliased %} As shortcut from received object -------------------- +-------------------------------- {% for alias in aliased %} - :meth:`aiogram.types.{{ alias.type|pythonize_name }}.{{ alias.type|pythonize_class_name }}.{{ alias.name }}` {%- endfor %} diff --git a/.butcher/types/CallbackQuery/aliases.yml b/.butcher/types/CallbackQuery/aliases.yml new file mode 100644 index 0000000000..d0eadfce47 --- /dev/null +++ b/.butcher/types/CallbackQuery/aliases.yml @@ -0,0 +1,4 @@ +answer: + method: answerCallbackQuery + fill: + callback_query_id: self.id diff --git a/.butcher/types/Chat/aliases.yml b/.butcher/types/Chat/aliases.yml index 3d3a2da423..4538f7e148 100644 --- a/.butcher/types/Chat/aliases.yml +++ b/.butcher/types/Chat/aliases.yml @@ -1,108 +1,108 @@ -#ban_sender_chat: -# method: banChatSenderChat -# fill: &self -# chat_id: self.id -# -#unban_sender_chat: -# method: unbanChatSenderChat -# fill: *self -# -#get_administrators: -# method: getChatAdministrators -# fill: *self -# -#delete_message: -# method: deleteMessage -# fill: *self -# -#revoke_invite_link: -# method: revokeChatInviteLink -# fill: *self -# -#edit_invite_link: -# method: editChatInviteLink -# fill: *self -# -#create_invite_link: -# method: createChatInviteLink -# fill: *self -# -#export_invite_link: -# method: exportChatInviteLink -# fill: *self -# -#do: -# method: sendChatAction -# fill: *self -# -#delete_sticker_set: -# method: deleteChatStickerSet -# fill: *self -# -#set_sticker_set: -# method: setChatStickerSet -# fill: *self -# -#get_member: -# method: getChatMember -# fill: *self -# -#get_member_count: -# method: getChatMemberCount -# fill: *self -# -#leave: -# method: leaveChat -# fill: *self -# -#unpin_all_messages: -# method: unpinAllChatMessages -# fill: *self -# -#unpin_message: -# method: unpinChatMessage -# fill: *self -# -#pin_message: -# method: pinChatMessage -# fill: *self -# -#set_administrator_custom_title: -# method: setChatAdministratorCustomTitle -# fill: *self -# -#set_permissions: -# method: setChatPermissions -# fill: *self -# -#promote: -# method: promoteChatMember -# fill: *self -# -#restrict: -# method: restrictChatMember -# fill: *self -# -#unban: -# method: unbanChatMember -# fill: *self -# -#ban: -# method: banChatMember -# fill: *self -# -#set_description: -# method: setChatDescription -# fill: *self -# -#set_title: -# method: setChatTitle -# fill: *self -# -#delete_photo: -# method: deleteChatPhoto -# fill: *self -# -#set_photo: -# method: setChatPhoto -# fill: *self +ban_sender_chat: + method: banChatSenderChat + fill: &self + chat_id: self.id + +unban_sender_chat: + method: unbanChatSenderChat + fill: *self + +get_administrators: + method: getChatAdministrators + fill: *self + +delete_message: + method: deleteMessage + fill: *self + +revoke_invite_link: + method: revokeChatInviteLink + fill: *self + +edit_invite_link: + method: editChatInviteLink + fill: *self + +create_invite_link: + method: createChatInviteLink + fill: *self + +export_invite_link: + method: exportChatInviteLink + fill: *self + +do: + method: sendChatAction + fill: *self + +delete_sticker_set: + method: deleteChatStickerSet + fill: *self + +set_sticker_set: + method: setChatStickerSet + fill: *self + +get_member: + method: getChatMember + fill: *self + +get_member_count: + method: getChatMemberCount + fill: *self + +leave: + method: leaveChat + fill: *self + +unpin_all_messages: + method: unpinAllChatMessages + fill: *self + +unpin_message: + method: unpinChatMessage + fill: *self + +pin_message: + method: pinChatMessage + fill: *self + +set_administrator_custom_title: + method: setChatAdministratorCustomTitle + fill: *self + +set_permissions: + method: setChatPermissions + fill: *self + +promote: + method: promoteChatMember + fill: *self + +restrict: + method: restrictChatMember + fill: *self + +unban: + method: unbanChatMember + fill: *self + +ban: + method: banChatMember + fill: *self + +set_description: + method: setChatDescription + fill: *self + +set_title: + method: setChatTitle + fill: *self + +delete_photo: + method: deleteChatPhoto + fill: *self + +set_photo: + method: setChatPhoto + fill: *self diff --git a/.butcher/types/ChatJoinRequest/aliases.yml b/.butcher/types/ChatJoinRequest/aliases.yml new file mode 100644 index 0000000000..aa88cebd9b --- /dev/null +++ b/.butcher/types/ChatJoinRequest/aliases.yml @@ -0,0 +1,8 @@ +approve: + method: approveChatJoinRequest + fill: &request-target + chat_id: self.chat.id + user_id: self.from_user.id +decline: + method: declineChatJoinRequest + fill: *request-target diff --git a/.butcher/types/ErrorEvent/replace.yml b/.butcher/types/ErrorEvent/replace.yml new file mode 100644 index 0000000000..aea86aff0c --- /dev/null +++ b/.butcher/types/ErrorEvent/replace.yml @@ -0,0 +1,2 @@ +bases: + - _ErrorEvent diff --git a/.butcher/types/InlineQuery/aliases.yml b/.butcher/types/InlineQuery/aliases.yml new file mode 100644 index 0000000000..5fd8601371 --- /dev/null +++ b/.butcher/types/InlineQuery/aliases.yml @@ -0,0 +1,4 @@ +answer: + method: answerInlineQuery + fill: + inline_query_id: self.id diff --git a/.butcher/types/Message/aliases.yml b/.butcher/types/Message/aliases.yml index 7fab6d037f..4d73187556 100644 --- a/.butcher/types/Message/aliases.yml +++ b/.butcher/types/Message/aliases.yml @@ -1,139 +1,189 @@ -#answer: -# method: sendMessage -# fill: &fill-answer -# chat_id: self.chat.id -# message_thread_id: self.message_thread_id if self.is_topic_message else None -# -#reply: -# method: sendMessage -# fill: &fill-reply -# <<: *fill-answer -# reply_to_message_id: self.message_id -# -#answer_animation: -# method: sendAnimation -# fill: *fill-answer -# -#reply_animation: -# method: sendAnimation -# fill: *fill-reply -# -#answer_audio: -# method: sendAudio -# fill: *fill-answer -# -#reply_audio: -# method: sendAudio -# fill: *fill-reply -# -#answer_contact: -# method: sendContact -# fill: *fill-answer -# -#reply_contact: -# method: sendContact -# fill: *fill-reply -# -#answer_document: -# method: sendDocument -# fill: *fill-answer -# -#reply_document: -# method: sendDocument -# fill: *fill-reply -# -#answer_game: -# method: sendGame -# fill: *fill-answer -# -#reply_game: -# method: sendGame -# fill: *fill-reply -# -#answer_invoice: -# method: sendInvoice -# fill: *fill-answer -# -#reply_invoice: -# method: sendInvoice -# fill: *fill-reply -# -#answer_location: -# method: sendLocation -# fill: *fill-answer -# -#reply_location: -# method: sendLocation -# fill: *fill-reply -# -#answer_media_group: -# method: sendMediaGroup -# fill: *fill-answer -# -#reply_media_group: -# method: sendMediaGroup -# fill: *fill-reply -# -#answer_photo: -# method: sendPhoto -# fill: *fill-answer -# -#reply_photo: -# method: sendPhoto -# fill: *fill-reply -# -#answer_poll: -# method: sendPoll -# fill: *fill-answer -# -#reply_poll: -# method: sendPoll -# fill: *fill-reply -# -#answer_dice: -# method: sendDice -# fill: *fill-answer -# -#reply_dice: -# method: sendDice -# fill: *fill-reply -# -#answer_sticker: -# method: sendSticker -# fill: *fill-answer -# -#reply_sticker: -# method: sendSticker -# fill: *fill-reply -# -#answer_venue: -# method: sendVenue -# fill: *fill-answer -# -#reply_venue: -# method: sendVenue -# fill: *fill-reply -# -#answer_video: -# method: sendVideo -# fill: *fill-answer -# -#reply_video: -# method: sendVideo -# fill: *fill-reply -# -#answer_video_note: -# method: sendVideoNote -# fill: *fill-answer -# -#reply_video_note: -# method: sendVideoNote -# fill: *fill-reply -# -#answer_voice: -# method: sendVoice -# fill: *fill-answer -# -#reply_voice: -# method: sendVoice -# fill: *fill-reply +answer: + method: sendMessage + fill: &fill-answer + chat_id: self.chat.id + message_thread_id: self.message_thread_id if self.is_topic_message else None + +reply: + method: sendMessage + fill: &fill-reply + <<: *fill-answer + reply_to_message_id: self.message_id + +answer_animation: + method: sendAnimation + fill: *fill-answer + +reply_animation: + method: sendAnimation + fill: *fill-reply + +answer_audio: + method: sendAudio + fill: *fill-answer + +reply_audio: + method: sendAudio + fill: *fill-reply + +answer_contact: + method: sendContact + fill: *fill-answer + +reply_contact: + method: sendContact + fill: *fill-reply + +answer_document: + method: sendDocument + fill: *fill-answer + +reply_document: + method: sendDocument + fill: *fill-reply + +answer_game: + method: sendGame + fill: *fill-answer + +reply_game: + method: sendGame + fill: *fill-reply + +answer_invoice: + method: sendInvoice + fill: *fill-answer + +reply_invoice: + method: sendInvoice + fill: *fill-reply + +answer_location: + method: sendLocation + fill: *fill-answer + +reply_location: + method: sendLocation + fill: *fill-reply + +answer_media_group: + method: sendMediaGroup + fill: *fill-answer + +reply_media_group: + method: sendMediaGroup + fill: *fill-reply + +answer_photo: + method: sendPhoto + fill: *fill-answer + +reply_photo: + method: sendPhoto + fill: *fill-reply + +answer_poll: + method: sendPoll + fill: *fill-answer + +reply_poll: + method: sendPoll + fill: *fill-reply + +answer_dice: + method: sendDice + fill: *fill-answer + +reply_dice: + method: sendDice + fill: *fill-reply + +answer_sticker: + method: sendSticker + fill: *fill-answer + +reply_sticker: + method: sendSticker + fill: *fill-reply + +answer_venue: + method: sendVenue + fill: *fill-answer + +reply_venue: + method: sendVenue + fill: *fill-reply + +answer_video: + method: sendVideo + fill: *fill-answer + +reply_video: + method: sendVideo + fill: *fill-reply + +answer_video_note: + method: sendVideoNote + fill: *fill-answer + +reply_video_note: + method: sendVideoNote + fill: *fill-reply + +answer_voice: + method: sendVoice + fill: *fill-answer + +reply_voice: + method: sendVoice + fill: *fill-reply + +copy_to: + method: copyMessage + fill: + from_chat_id: self.chat.id + message_id: self.message_id + +edit_text: + method: editMessageText + fill: &message-target + chat_id: self.chat.id + message_id: self.message_id + +forward: + method: forwardMessage + fill: + from_chat_id: self.chat.id + message_id: self.message_id + +edit_media: + method: editMessageMedia + fill: *message-target + +edit_reply_markup: + method: editMessageReplyMarkup + fill: *message-target + +edit_live_location: + method: editMessageLiveLocation + fill: *message-target + +stop_live_location: + method: stopMessageLiveLocation + fill: *message-target + +edit_caption: + method: editMessageCaption + fill: *message-target + +delete: + method: deleteMessage + fill: *message-target + +pin: + method: pinChatMessage + fill: *message-target + +unpin: + method: unpinChatMessage + fill: *message-target diff --git a/.butcher/types/Sticker/aliases.yml b/.butcher/types/Sticker/aliases.yml new file mode 100644 index 0000000000..c02126fe97 --- /dev/null +++ b/.butcher/types/Sticker/aliases.yml @@ -0,0 +1,8 @@ +set_position_in_set: + method: setStickerPositionInSet + fill: &set-target + sticker: self.file_id + +delete_from_set: + method: deleteStickerFromSet + fill: *set-target diff --git a/.butcher/types/User/aliases.yml b/.butcher/types/User/aliases.yml new file mode 100644 index 0000000000..85d2188d2f --- /dev/null +++ b/.butcher/types/User/aliases.yml @@ -0,0 +1,4 @@ +get_profile_photos: + method: getUserProfilePhotos + fill: + user_id: self.id diff --git a/CHANGES/952.feature.rst b/CHANGES/952.feature.rst new file mode 100644 index 0000000000..86135dc822 --- /dev/null +++ b/CHANGES/952.feature.rst @@ -0,0 +1,52 @@ +Added missing shortcuts, new enums, reworked old stuff + +**Breaking** +All previously added enums is re-generated in new place - `aiogram.enums` instead of `aiogram.types` + +**Added enums:** :class:`aiogram.enums.bot_command_scope_type.BotCommandScopeType`, + :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`, + +**Added shortcuts**: + +- *Chat* :meth:`aiogram.types.chat.Chat.get_administrators`, + :meth:`aiogram.types.chat.Chat.delete_message`, + :meth:`aiogram.types.chat.Chat.revoke_invite_link`, + :meth:`aiogram.types.chat.Chat.edit_invite_link`, + :meth:`aiogram.types.chat.Chat.create_invite_link`, + :meth:`aiogram.types.chat.Chat.export_invite_link`, + :meth:`aiogram.types.chat.Chat.do`, + :meth:`aiogram.types.chat.Chat.delete_sticker_set`, + :meth:`aiogram.types.chat.Chat.set_sticker_set`, + :meth:`aiogram.types.chat.Chat.get_member`, + :meth:`aiogram.types.chat.Chat.get_member_count`, + :meth:`aiogram.types.chat.Chat.leave`, + :meth:`aiogram.types.chat.Chat.unpin_all_messages`, + :meth:`aiogram.types.chat.Chat.unpin_message`, + :meth:`aiogram.types.chat.Chat.pin_message`, + :meth:`aiogram.types.chat.Chat.set_administrator_custom_title`, + :meth:`aiogram.types.chat.Chat.set_permissions`, + :meth:`aiogram.types.chat.Chat.promote`, + :meth:`aiogram.types.chat.Chat.restrict`, + :meth:`aiogram.types.chat.Chat.unban`, + :meth:`aiogram.types.chat.Chat.ban`, + :meth:`aiogram.types.chat.Chat.set_description`, + :meth:`aiogram.types.chat.Chat.set_title`, + :meth:`aiogram.types.chat.Chat.delete_photo`, + :meth:`aiogram.types.chat.Chat.set_photo`, +- *Sticker*: :meth:`aiogram.types.sticker.Sticker.set_position_in_set`, + :meth:`aiogram.types.sticker.Sticker.delete_from_set`, +- *User*: :meth:`aiogram.types.user.User.get_profile_photos` diff --git a/aiogram/client/bot.py b/aiogram/client/bot.py index 25f96bcacd..ca06a62ddc 100644 --- a/aiogram/client/bot.py +++ b/aiogram/client/bot.py @@ -175,10 +175,6 @@ class Bot(ContextInstanceMixin["Bot"]): - """ - Bot class - """ - def __init__( self, token: str, @@ -186,6 +182,8 @@ def __init__( parse_mode: Optional[str] = None, ) -> None: """ + Bot class + :param token: Telegram Bot token `Obtained from @BotFather `_ :param session: HTTP Client session (For example AiohttpSession). If not specified it will be automatically created. @@ -234,6 +232,11 @@ async def context(self, auto_close: bool = True) -> AsyncIterator[Bot]: self.reset_current(token) async def me(self) -> User: + """ + Cached alias for getMe method + + :return: + """ if self._me is None: # pragma: no cover self._me = await self.get_me() return self._me diff --git a/aiogram/enums/__init__.py b/aiogram/enums/__init__.py index 7e3935feff..a744ba5506 100644 --- a/aiogram/enums/__init__.py +++ b/aiogram/enums/__init__.py @@ -1,13 +1,35 @@ +from .bot_command_scope_type import BotCommandScopeType +from .chat_action import ChatAction +from .chat_member_status import ChatMemberStatus from .chat_type import ChatType from .content_type import ContentType from .dice_emoji import DiceEmoji +from .inline_query_result_type import InlineQueryResultType +from .input_media_type import InputMediaType +from .mask_position_point import MaskPositionPoint +from .menu_button_type import MenuButtonType +from .message_entity_type import MessageEntityType +from .parse_mode import ParseMode +from .poll_type import PollType +from .sticker_type import StickerType from .topic_icon_color import TopicIconColor from .update_type import UpdateType __all__ = ( + "BotCommandScopeType", + "ChatAction", + "ChatMemberStatus", "ChatType", "ContentType", "DiceEmoji", + "InlineQueryResultType", + "InputMediaType", + "MaskPositionPoint", + "MenuButtonType", + "MessageEntityType", + "ParseMode", + "PollType", + "StickerType", "TopicIconColor", "UpdateType", ) diff --git a/aiogram/enums/bot_command_scope_type.py b/aiogram/enums/bot_command_scope_type.py new file mode 100644 index 0000000000..f0994316f7 --- /dev/null +++ b/aiogram/enums/bot_command_scope_type.py @@ -0,0 +1,17 @@ +from enum import Enum + + +class BotCommandScopeType(str, Enum): + """ + This object represents the scope to which bot commands are applied. + + Source: https://core.telegram.org/bots/api#botcommandscope + """ + + DEFAULT = "default" + ALL_PRIVATE_CHATS = "all_private_chats" + ALL_GROUP_CHATS = "all_group_chats" + ALL_CHAT_ADMINISTRATORS = "all_chat_administrators" + CHAT = "chat" + CHAT_ADMINISTRATORS = "chat_administrators" + CHAT_MEMBER = "chat_member" diff --git a/aiogram/enums/chat_action.py b/aiogram/enums/chat_action.py new file mode 100644 index 0000000000..4402b5b4e3 --- /dev/null +++ b/aiogram/enums/chat_action.py @@ -0,0 +1,32 @@ +from enum import Enum + + +class ChatAction(str, Enum): + """ + This object represents bot actions. + + Choose one, depending on what the user is about to receive: + + - typing for text messages, + - upload_photo for photos, + - record_video or upload_video for videos, + - record_voice or upload_voice for voice notes, + - upload_document for general files, + - choose_sticker for stickers, + - find_location for location data, + - record_video_note or upload_video_note for video notes. + + Source: https://core.telegram.org/bots/api#sendchataction + """ + + TYPING = "typing" + UPLOAD_PHOTO = "upload_photo" + RECORD_VIDEO = "record_video" + UPLOAD_VIDEO = "upload_video" + RECORD_VOICE = "record_voice" + UPLOAD_VOICE = "upload_voice" + UPLOAD_DOCUMENT = "upload_document" + CHOOSE_STICKER = "choose_sticker" + FIND_LOCATION = "find_location" + RECORD_VIDEO_NOTE = "record_video_note" + UPLOAD_VIDEO_NOTE = "upload_video_note" diff --git a/aiogram/enums/chat_member_status.py b/aiogram/enums/chat_member_status.py new file mode 100644 index 0000000000..db6f92133d --- /dev/null +++ b/aiogram/enums/chat_member_status.py @@ -0,0 +1,16 @@ +from enum import Enum + + +class ChatMemberStatus(str, Enum): + """ + This object represents chat member status. + + Source: https://core.telegram.org/bots/api#chatmember + """ + + CREATOR = "creator" + ADMINISTRATOR = "administrator" + MEMBER = "member" + RESTRICTED = "restricted" + LEFT = "left" + KICKED = "kicked" diff --git a/aiogram/enums/chat_type.py b/aiogram/enums/chat_type.py index d2e9794bd0..10dccc85ba 100644 --- a/aiogram/enums/chat_type.py +++ b/aiogram/enums/chat_type.py @@ -3,9 +3,12 @@ class ChatType(str, Enum): """ - Type of chat + This object represents a chat type + + Source: https://core.telegram.org/bots/api#chat """ + SENDER = "sender" PRIVATE = "private" GROUP = "group" SUPERGROUP = "supergroup" diff --git a/aiogram/enums/content_type.py b/aiogram/enums/content_type.py index d3d0de28aa..18fa348446 100644 --- a/aiogram/enums/content_type.py +++ b/aiogram/enums/content_type.py @@ -3,7 +3,7 @@ class ContentType(str, Enum): """ - Message content type + This object represents a type of content in message """ UNKNOWN = "unknown" diff --git a/aiogram/enums/dice_emoji.py b/aiogram/enums/dice_emoji.py index b9514cb0cf..68519324ad 100644 --- a/aiogram/enums/dice_emoji.py +++ b/aiogram/enums/dice_emoji.py @@ -4,6 +4,8 @@ class DiceEmoji(str, Enum): """ Emoji on which the dice throw animation is based + + Source: https://core.telegram.org/bots/api#dice """ DICE = "🎲" diff --git a/aiogram/enums/inline_query_result_type.py b/aiogram/enums/inline_query_result_type.py new file mode 100644 index 0000000000..fa063fcbe6 --- /dev/null +++ b/aiogram/enums/inline_query_result_type.py @@ -0,0 +1,23 @@ +from enum import Enum + + +class InlineQueryResultType(str, Enum): + """ + The part of the face relative to which the mask should be placed. + + Source: https://core.telegram.org/bots/api#maskposition + """ + + AUDIO = "audio" + DOCUMENT = "document" + GIF = "gif" + MPEG = "mpeg" + PHOTO = "photo" + STICKER = "sticker" + VIDEO = "video" + VOICE = "voice" + ARTICLE = "article" + CONTACT = "contact" + GAME = "game" + LOCATION = "location" + VENUE = "venue" diff --git a/aiogram/enums/input_media_type.py b/aiogram/enums/input_media_type.py new file mode 100644 index 0000000000..30741dd49c --- /dev/null +++ b/aiogram/enums/input_media_type.py @@ -0,0 +1,15 @@ +from enum import Enum + + +class InputMediaType(str, Enum): + """ + This object represents input media type + + Source: https://core.telegram.org/bots/api#inputmedia + """ + + ANIMATION = "animation" + AUDIO = "audio" + DOCUMENT = "document" + PHOTO = "photo" + VIDEO = "video" diff --git a/aiogram/enums/mask_position_point.py b/aiogram/enums/mask_position_point.py new file mode 100644 index 0000000000..348ae007e8 --- /dev/null +++ b/aiogram/enums/mask_position_point.py @@ -0,0 +1,14 @@ +from enum import Enum + + +class MaskPositionPoint(str, Enum): + """ + The part of the face relative to which the mask should be placed. + + Source: https://core.telegram.org/bots/api#maskposition + """ + + FOREHEAD = "forehead" + EYES = "eyes" + MOUTH = "mouth" + CHIN = "chin" diff --git a/aiogram/enums/menu_button_type.py b/aiogram/enums/menu_button_type.py new file mode 100644 index 0000000000..4c1015b99a --- /dev/null +++ b/aiogram/enums/menu_button_type.py @@ -0,0 +1,13 @@ +from enum import Enum + + +class MenuButtonType(str, Enum): + """ + This object represents an type of Menu button + + Source: https://core.telegram.org/bots/api#menubuttondefault + """ + + DEFAULT = "default" + COMMANDS = "commands" + WEB_APP = "web_app" diff --git a/aiogram/enums/message_entity_type.py b/aiogram/enums/message_entity_type.py new file mode 100644 index 0000000000..f58f487a95 --- /dev/null +++ b/aiogram/enums/message_entity_type.py @@ -0,0 +1,27 @@ +from enum import Enum + + +class MessageEntityType(str, Enum): + """ + This object represents type of message entity + + Source: https://core.telegram.org/bots/api#messageentity + """ + + MENTION = "mention" + HASHTAG = "hashtag" + CASHTAG = "cashtag" + BOT_COMMAND = "bot_command" + URL = "url" + EMAIL = "email" + PHONE_NUMBER = "phone_number" + BOLD = "bold" + ITALIC = "italic" + UNDERLINE = "underline" + STRIKETHROUGH = "strikethrough" + SPOILER = "spoiler" + CODE = "code" + PRE = "pre" + TEXT_LINK = "text_link" + TEXT_MENTION = "text_mention" + CUSTOM_EMOJI = "custom_emoji" diff --git a/aiogram/enums/parse_mode.py b/aiogram/enums/parse_mode.py new file mode 100644 index 0000000000..f17dd984a6 --- /dev/null +++ b/aiogram/enums/parse_mode.py @@ -0,0 +1,13 @@ +from enum import Enum + + +class ParseMode(str, Enum): + """ + Formatting options + + Source: https://core.telegram.org/bots/api#formatting-options + """ + + MARKDOWN_V2 = "MarkdownV2" + MARKDOWN = "Markdown" + HTML = "HTML" diff --git a/aiogram/enums/poll_type.py b/aiogram/enums/poll_type.py new file mode 100644 index 0000000000..039d600dfc --- /dev/null +++ b/aiogram/enums/poll_type.py @@ -0,0 +1,12 @@ +from enum import Enum + + +class PollType(str, Enum): + """ + This object represents poll type + + Source: https://core.telegram.org/bots/api#poll + """ + + REGULAR = "regular" + QUIZ = "quiz" diff --git a/aiogram/enums/sticker_type.py b/aiogram/enums/sticker_type.py new file mode 100644 index 0000000000..748f85e6ff --- /dev/null +++ b/aiogram/enums/sticker_type.py @@ -0,0 +1,13 @@ +from enum import Enum + + +class StickerType(str, Enum): + """ + The part of the face relative to which the mask should be placed. + + Source: https://core.telegram.org/bots/api#maskposition + """ + + REGULAR = "regular" + MASK = "mask" + CUSTOM_EMOJI = "custom_emoji" diff --git a/aiogram/enums/update_type.py b/aiogram/enums/update_type.py index aaf0b970e4..6025accc4b 100644 --- a/aiogram/enums/update_type.py +++ b/aiogram/enums/update_type.py @@ -3,7 +3,9 @@ class UpdateType(str, Enum): """ - Known update types + This object represents the complete list of allowed update types + + Source: https://core.telegram.org/bots/api#update """ MESSAGE = "message" diff --git a/aiogram/types/__init__.py b/aiogram/types/__init__.py index 8c262c7482..91d19870ec 100644 --- a/aiogram/types/__init__.py +++ b/aiogram/types/__init__.py @@ -15,7 +15,6 @@ from .callback_game import CallbackGame from .callback_query import CallbackQuery from .chat import Chat -from .chat_action import ChatAction from .chat_administrator_rights import ChatAdministratorRights from .chat_invite_link import ChatInviteLink from .chat_join_request import ChatJoinRequest @@ -37,6 +36,7 @@ from .downloadable import Downloadable from .encrypted_credentials import EncryptedCredentials from .encrypted_passport_element import EncryptedPassportElement +from .error_event import ErrorEvent from .file import File from .force_reply import ForceReply from .forum_topic import ForumTopic @@ -142,151 +142,151 @@ from .webhook_info import WebhookInfo __all__ = ( - "TelegramObject", - "Downloadable", - "UNSET", - "BufferedInputFile", - "FSInputFile", - "URLInputFile", - "Update", - "WebhookInfo", - "User", - "Chat", - "Message", - "ContentType", - "MessageId", - "MessageEntity", - "PhotoSize", "Animation", "Audio", - "Document", - "Video", - "VideoNote", - "Voice", - "Contact", - "Dice", - "PollOption", - "PollAnswer", - "Poll", - "Location", - "Venue", - "WebAppData", - "ProximityAlertTriggered", - "MessageAutoDeleteTimerChanged", - "ForumTopicCreated", - "ForumTopicClosed", - "ForumTopicReopened", - "VideoChatScheduled", - "VideoChatStarted", - "VideoChatEnded", - "VideoChatParticipantsInvited", - "UserProfilePhotos", - "File", - "WebAppInfo", - "ReplyKeyboardMarkup", - "KeyboardButton", - "KeyboardButtonPollType", - "ReplyKeyboardRemove", - "InlineKeyboardMarkup", - "InlineKeyboardButton", - "LoginUrl", + "BotCommand", + "BotCommandScope", + "BotCommandScopeAllChatAdministrators", + "BotCommandScopeAllGroupChats", + "BotCommandScopeAllPrivateChats", + "BotCommandScopeChat", + "BotCommandScopeChatAdministrators", + "BotCommandScopeChatMember", + "BotCommandScopeDefault", + "BufferedInputFile", + "CallbackGame", "CallbackQuery", - "ForceReply", - "ChatPhoto", - "ChatInviteLink", + "Chat", "ChatAdministratorRights", + "ChatInviteLink", + "ChatJoinRequest", + "ChatLocation", "ChatMember", - "ChatMemberOwner", "ChatMemberAdministrator", + "ChatMemberBanned", + "ChatMemberLeft", "ChatMemberMember", + "ChatMemberOwner", "ChatMemberRestricted", - "ChatMemberLeft", - "ChatMemberBanned", "ChatMemberUpdated", - "ChatJoinRequest", "ChatPermissions", - "ChatLocation", + "ChatPhoto", + "ChosenInlineResult", + "Contact", + "ContentType", + "Dice", + "Document", + "Downloadable", + "EncryptedCredentials", + "EncryptedPassportElement", + "ErrorEvent", + "FSInputFile", + "File", + "ForceReply", "ForumTopic", - "BotCommand", - "BotCommandScope", - "BotCommandScopeDefault", - "BotCommandScopeAllPrivateChats", - "BotCommandScopeAllGroupChats", - "BotCommandScopeAllChatAdministrators", - "BotCommandScopeChat", - "BotCommandScopeChatAdministrators", - "BotCommandScopeChatMember", - "MenuButton", - "MenuButtonCommands", - "MenuButtonWebApp", - "MenuButtonDefault", - "ResponseParameters", - "InputMedia", - "InputMediaPhoto", - "InputMediaVideo", - "InputMediaAnimation", - "InputMediaAudio", - "InputMediaDocument", - "InputFile", - "Sticker", - "StickerSet", - "MaskPosition", + "ForumTopicClosed", + "ForumTopicCreated", + "ForumTopicReopened", + "Game", + "GameHighScore", + "InlineKeyboardButton", + "InlineKeyboardMarkup", "InlineQuery", "InlineQueryResult", "InlineQueryResultArticle", - "InlineQueryResultPhoto", - "InlineQueryResultGif", - "InlineQueryResultMpeg4Gif", - "InlineQueryResultVideo", "InlineQueryResultAudio", - "InlineQueryResultVoice", - "InlineQueryResultDocument", - "InlineQueryResultLocation", - "InlineQueryResultVenue", - "InlineQueryResultContact", - "InlineQueryResultGame", - "InlineQueryResultCachedPhoto", + "InlineQueryResultCachedAudio", + "InlineQueryResultCachedDocument", "InlineQueryResultCachedGif", "InlineQueryResultCachedMpeg4Gif", + "InlineQueryResultCachedPhoto", "InlineQueryResultCachedSticker", - "InlineQueryResultCachedDocument", "InlineQueryResultCachedVideo", "InlineQueryResultCachedVoice", - "InlineQueryResultCachedAudio", + "InlineQueryResultContact", + "InlineQueryResultDocument", + "InlineQueryResultGame", + "InlineQueryResultGif", + "InlineQueryResultLocation", + "InlineQueryResultMpeg4Gif", + "InlineQueryResultPhoto", + "InlineQueryResultVenue", + "InlineQueryResultVideo", + "InlineQueryResultVoice", + "InputContactMessageContent", + "InputFile", + "InputInvoiceMessageContent", + "InputLocationMessageContent", + "InputMedia", + "InputMediaAnimation", + "InputMediaAudio", + "InputMediaDocument", + "InputMediaPhoto", + "InputMediaVideo", "InputMessageContent", "InputTextMessageContent", - "InputLocationMessageContent", "InputVenueMessageContent", - "InputContactMessageContent", - "InputInvoiceMessageContent", - "ChosenInlineResult", - "SentWebAppMessage", - "LabeledPrice", "Invoice", - "ShippingAddress", + "KeyboardButton", + "KeyboardButtonPollType", + "LabeledPrice", + "Location", + "LoginUrl", + "MaskPosition", + "MenuButton", + "MenuButtonCommands", + "MenuButtonDefault", + "MenuButtonWebApp", + "Message", + "MessageAutoDeleteTimerChanged", + "MessageEntity", + "MessageId", "OrderInfo", - "ShippingOption", - "SuccessfulPayment", - "ShippingQuery", - "PreCheckoutQuery", "PassportData", - "PassportFile", - "EncryptedPassportElement", - "EncryptedCredentials", "PassportElementError", "PassportElementErrorDataField", + "PassportElementErrorFile", + "PassportElementErrorFiles", "PassportElementErrorFrontSide", "PassportElementErrorReverseSide", "PassportElementErrorSelfie", - "PassportElementErrorFile", - "PassportElementErrorFiles", "PassportElementErrorTranslationFile", "PassportElementErrorTranslationFiles", "PassportElementErrorUnspecified", - "Game", - "CallbackGame", - "GameHighScore", - "ChatAction", + "PassportFile", + "PhotoSize", + "Poll", + "PollAnswer", + "PollOption", + "PreCheckoutQuery", + "ProximityAlertTriggered", + "ReplyKeyboardMarkup", + "ReplyKeyboardRemove", + "ResponseParameters", + "SentWebAppMessage", + "ShippingAddress", + "ShippingOption", + "ShippingQuery", + "Sticker", + "StickerSet", + "SuccessfulPayment", + "TelegramObject", + "UNSET", + "URLInputFile", + "Update", + "User", + "UserProfilePhotos", + "Venue", + "Video", + "VideoChatEnded", + "VideoChatParticipantsInvited", + "VideoChatScheduled", + "VideoChatStarted", + "VideoNote", + "Voice", + "WebAppData", + "WebAppInfo", + "WebhookInfo", ) # Load typing forward refs for every TelegramObject diff --git a/aiogram/types/bot_command_scope_all_chat_administrators.py b/aiogram/types/bot_command_scope_all_chat_administrators.py index 25a35cbf37..e9f6a96930 100644 --- a/aiogram/types/bot_command_scope_all_chat_administrators.py +++ b/aiogram/types/bot_command_scope_all_chat_administrators.py @@ -2,6 +2,7 @@ from pydantic import Field +from ..enums import BotCommandScopeType from .bot_command_scope import BotCommandScope @@ -12,5 +13,5 @@ class BotCommandScopeAllChatAdministrators(BotCommandScope): Source: https://core.telegram.org/bots/api#botcommandscopeallchatadministrators """ - type: str = Field("all_chat_administrators", const=True) + type: str = Field(BotCommandScopeType.ALL_CHAT_ADMINISTRATORS, const=True) """Scope type, must be *all_chat_administrators*""" diff --git a/aiogram/types/bot_command_scope_all_group_chats.py b/aiogram/types/bot_command_scope_all_group_chats.py index 00e2984e95..f9675ad606 100644 --- a/aiogram/types/bot_command_scope_all_group_chats.py +++ b/aiogram/types/bot_command_scope_all_group_chats.py @@ -2,6 +2,7 @@ from pydantic import Field +from ..enums import BotCommandScopeType from .bot_command_scope import BotCommandScope @@ -12,5 +13,5 @@ class BotCommandScopeAllGroupChats(BotCommandScope): Source: https://core.telegram.org/bots/api#botcommandscopeallgroupchats """ - type: str = Field("all_group_chats", const=True) + type: str = Field(BotCommandScopeType.ALL_GROUP_CHATS, const=True) """Scope type, must be *all_group_chats*""" diff --git a/aiogram/types/bot_command_scope_all_private_chats.py b/aiogram/types/bot_command_scope_all_private_chats.py index debc3bafb5..f13e28660e 100644 --- a/aiogram/types/bot_command_scope_all_private_chats.py +++ b/aiogram/types/bot_command_scope_all_private_chats.py @@ -2,6 +2,7 @@ from pydantic import Field +from ..enums import BotCommandScopeType from .bot_command_scope import BotCommandScope @@ -12,5 +13,5 @@ class BotCommandScopeAllPrivateChats(BotCommandScope): Source: https://core.telegram.org/bots/api#botcommandscopeallprivatechats """ - type: str = Field("all_private_chats", const=True) + type: str = Field(BotCommandScopeType.ALL_PRIVATE_CHATS, const=True) """Scope type, must be *all_private_chats*""" diff --git a/aiogram/types/bot_command_scope_chat.py b/aiogram/types/bot_command_scope_chat.py index 5d89c04666..d96bc6f476 100644 --- a/aiogram/types/bot_command_scope_chat.py +++ b/aiogram/types/bot_command_scope_chat.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import BotCommandScopeType from .bot_command_scope import BotCommandScope @@ -14,7 +15,7 @@ class BotCommandScopeChat(BotCommandScope): Source: https://core.telegram.org/bots/api#botcommandscopechat """ - type: str = Field("chat", const=True) + type: str = Field(BotCommandScopeType.CHAT, const=True) """Scope type, must be *chat*""" chat_id: Union[int, str] """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" diff --git a/aiogram/types/bot_command_scope_chat_administrators.py b/aiogram/types/bot_command_scope_chat_administrators.py index 152eab1314..824dc5a144 100644 --- a/aiogram/types/bot_command_scope_chat_administrators.py +++ b/aiogram/types/bot_command_scope_chat_administrators.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import BotCommandScopeType from .bot_command_scope import BotCommandScope @@ -14,7 +15,7 @@ class BotCommandScopeChatAdministrators(BotCommandScope): Source: https://core.telegram.org/bots/api#botcommandscopechatadministrators """ - type: str = Field("chat_administrators", const=True) + type: str = Field(BotCommandScopeType.CHAT_ADMINISTRATORS, const=True) """Scope type, must be *chat_administrators*""" chat_id: Union[int, str] """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" diff --git a/aiogram/types/bot_command_scope_chat_member.py b/aiogram/types/bot_command_scope_chat_member.py index e69ff64272..e9fb0ddae1 100644 --- a/aiogram/types/bot_command_scope_chat_member.py +++ b/aiogram/types/bot_command_scope_chat_member.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import BotCommandScopeType from .bot_command_scope import BotCommandScope @@ -14,7 +15,7 @@ class BotCommandScopeChatMember(BotCommandScope): Source: https://core.telegram.org/bots/api#botcommandscopechatmember """ - type: str = Field("chat_member", const=True) + type: str = Field(BotCommandScopeType.CHAT_MEMBER, const=True) """Scope type, must be *chat_member*""" chat_id: Union[int, str] """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" diff --git a/aiogram/types/bot_command_scope_default.py b/aiogram/types/bot_command_scope_default.py index 8cf1a1d5f3..79825631da 100644 --- a/aiogram/types/bot_command_scope_default.py +++ b/aiogram/types/bot_command_scope_default.py @@ -2,6 +2,7 @@ from pydantic import Field +from ..enums import BotCommandScopeType from .bot_command_scope import BotCommandScope @@ -12,5 +13,5 @@ class BotCommandScopeDefault(BotCommandScope): Source: https://core.telegram.org/bots/api#botcommandscopedefault """ - type: str = Field("default", const=True) + type: str = Field(BotCommandScopeType.DEFAULT, const=True) """Scope type, must be *default*""" diff --git a/aiogram/types/callback_query.py b/aiogram/types/callback_query.py index 4f96c8a3aa..5812bb13e9 100644 --- a/aiogram/types/callback_query.py +++ b/aiogram/types/callback_query.py @@ -1,6 +1,6 @@ from __future__ import annotations -from typing import TYPE_CHECKING, Optional +from typing import TYPE_CHECKING, Any, Optional from pydantic import Field @@ -42,17 +42,30 @@ def answer( show_alert: Optional[bool] = None, url: Optional[str] = None, cache_time: Optional[int] = None, + **kwargs: Any, ) -> AnswerCallbackQuery: """ - Answer to callback query + Shortcut for method :class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery` + will automatically fill method attributes: - :param text: - :param show_alert: - :param url: - :param cache_time: - :return: + - :code:`callback_query_id` + + Use this method to send answers to callback queries sent from `inline keyboards `_. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, :code:`True` is returned. + + Alternatively, the user can be redirected to the specified Game URL. For this option to work, you must first create a game for your bot via `@BotFather `_ and accept the terms. Otherwise, you may use links like :code:`t.me/your_bot?start=XXXX` that open your bot with a parameter. + + Source: https://core.telegram.org/bots/api#answercallbackquery + + :param text: Text of the notification. If not specified, nothing will be shown to the user, 0-200 characters + :param show_alert: If :code:`True`, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to *false*. + :param url: URL that will be opened by the user's client. If you have created a :class:`aiogram.types.game.Game` and accepted the conditions via `@BotFather `_, specify the URL that opens your game - note that this will only work if the query comes from a `https://core.telegram.org/bots/api#inlinekeyboardbutton `_ *callback_game* button. + :param cache_time: The maximum amount of time in seconds that the result of the callback query may be cached client-side. Telegram apps will support caching starting in version 3.14. Defaults to 0. + :return: instance of method :class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery` """ - from ..methods import AnswerCallbackQuery + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import AnswerCallbackQuery return AnswerCallbackQuery( callback_query_id=self.id, @@ -60,4 +73,5 @@ def answer( show_alert=show_alert, url=url, cache_time=cache_time, + **kwargs, ) diff --git a/aiogram/types/chat.py b/aiogram/types/chat.py index 7e276c2521..a5b0817316 100644 --- a/aiogram/types/chat.py +++ b/aiogram/types/chat.py @@ -1,14 +1,44 @@ from __future__ import annotations -from typing import TYPE_CHECKING, List, Optional +import datetime +from typing import TYPE_CHECKING, Any, List, Optional, Union from .base import TelegramObject if TYPE_CHECKING: - from ..methods import BanChatSenderChat, UnbanChatSenderChat + from ..methods import ( + BanChatMember, + BanChatSenderChat, + CreateChatInviteLink, + DeleteChatPhoto, + DeleteChatStickerSet, + DeleteMessage, + EditChatInviteLink, + ExportChatInviteLink, + GetChatAdministrators, + GetChatMember, + GetChatMemberCount, + LeaveChat, + PinChatMessage, + PromoteChatMember, + RestrictChatMember, + RevokeChatInviteLink, + SendChatAction, + SetChatAdministratorCustomTitle, + SetChatDescription, + SetChatPermissions, + SetChatPhoto, + SetChatStickerSet, + SetChatTitle, + UnbanChatMember, + UnbanChatSenderChat, + UnpinAllChatMessages, + UnpinChatMessage, + ) from .chat_location import ChatLocation from .chat_permissions import ChatPermissions from .chat_photo import ChatPhoto + from .input_file import InputFile from .message import Message @@ -103,18 +133,866 @@ def full_name(self) -> str: return f"{self.first_name}" - def ban_sender_chat(self, sender_chat_id: int) -> BanChatSenderChat: - from ..methods import BanChatSenderChat + def ban_sender_chat( + self, + sender_chat_id: int, + **kwargs: Any, + ) -> BanChatSenderChat: + """ + Shortcut for method :class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to ban a channel chat in a supergroup or a channel. Until the chat is `unbanned `_, the owner of the banned chat won't be able to send messages on behalf of **any of their channels**. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatsenderchat + + :param sender_chat_id: Unique identifier of the target sender chat + :return: instance of method :class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import BanChatSenderChat return BanChatSenderChat( chat_id=self.id, sender_chat_id=sender_chat_id, + **kwargs, ) - def unban_sender_chat(self, sender_chat_id: int) -> UnbanChatSenderChat: - from ..methods import UnbanChatSenderChat + def unban_sender_chat( + self, + sender_chat_id: int, + **kwargs: Any, + ) -> UnbanChatSenderChat: + """ + Shortcut for method :class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatsenderchat + + :param sender_chat_id: Unique identifier of the target sender chat + :return: instance of method :class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnbanChatSenderChat return UnbanChatSenderChat( chat_id=self.id, sender_chat_id=sender_chat_id, + **kwargs, + ) + + def get_administrators( + self, + **kwargs: Any, + ) -> GetChatAdministrators: + """ + Shortcut for method :class:`aiogram.methods.get_chat_administrators.GetChatAdministrators` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to get a list of administrators in a chat, which aren't bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` objects. + + Source: https://core.telegram.org/bots/api#getchatadministrators + + :return: instance of method :class:`aiogram.methods.get_chat_administrators.GetChatAdministrators` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetChatAdministrators + + return GetChatAdministrators( + chat_id=self.id, + **kwargs, + ) + + def delete_message( + self, + message_id: int, + **kwargs: Any, + ) -> DeleteMessage: + """ + Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to delete a message, including service messages, with the following limitations: + + - A message can only be deleted if it was sent less than 48 hours ago. + + - Service messages about a supergroup, channel, or forum topic creation can't be deleted. + + - A dice message in a private chat can only be deleted if it was sent more than 24 hours ago. + + - Bots can delete outgoing messages in private chats, groups, and supergroups. + + - Bots can delete incoming messages in private chats. + + - Bots granted *can_post_messages* permissions can delete outgoing messages in channels. + + - If the bot is an administrator of a group, it can delete any message there. + + - If the bot has *can_delete_messages* permission in a supergroup or a channel, it can delete any message there. + + Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessage + + :param message_id: Identifier of the message to delete + :return: instance of method :class:`aiogram.methods.delete_message.DeleteMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteMessage + + return DeleteMessage( + chat_id=self.id, + message_id=message_id, + **kwargs, + ) + + def revoke_invite_link( + self, + invite_link: str, + **kwargs: Any, + ) -> RevokeChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#revokechatinvitelink + + :param invite_link: The invite link to revoke + :return: instance of method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import RevokeChatInviteLink + + return RevokeChatInviteLink( + chat_id=self.id, + invite_link=invite_link, + **kwargs, + ) + + def edit_invite_link( + self, + invite_link: str, + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + **kwargs: Any, + ) -> EditChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#editchatinvitelink + + :param invite_link: The invite link to edit + :param name: Invite link name; 0-32 characters + :param expire_date: Point in time (Unix timestamp) when the link will expire + :param member_limit: The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 + :param creates_join_request: :code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified + :return: instance of method :class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditChatInviteLink + + return EditChatInviteLink( + chat_id=self.id, + invite_link=invite_link, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + **kwargs, + ) + + def create_invite_link( + self, + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + **kwargs: Any, + ) -> CreateChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to create an additional invite link for a chat. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. The link can be revoked using the method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. Returns the new invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#createchatinvitelink + + :param name: Invite link name; 0-32 characters + :param expire_date: Point in time (Unix timestamp) when the link will expire + :param member_limit: The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 + :param creates_join_request: :code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified + :return: instance of method :class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import CreateChatInviteLink + + return CreateChatInviteLink( + chat_id=self.id, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + **kwargs, + ) + + def export_invite_link( + self, + **kwargs: Any, + ) -> ExportChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the new invite link as *String* on success. + + Note: Each administrator in a chat generates their own invite links. Bots can't use invite links generated by other administrators. If you want your bot to work with invite links, it will need to generate its own link using :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your bot needs to generate a new primary invite link replacing its previous one, use :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` again. + + Source: https://core.telegram.org/bots/api#exportchatinvitelink + + :return: instance of method :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import ExportChatInviteLink + + return ExportChatInviteLink( + chat_id=self.id, + **kwargs, + ) + + def do( + self, + action: str, + **kwargs: Any, + ) -> SendChatAction: + """ + Shortcut for method :class:`aiogram.methods.send_chat_action.SendChatAction` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status). Returns :code:`True` on success. + + Example: The `ImageBot `_ needs some time to process a request and upload the image. Instead of sending a text message along the lines of 'Retrieving image, please wait…', the bot may use :class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = *upload_photo*. The user will see a 'sending photo' status for the bot. + + We only recommend using this method when a response from the bot will take a **noticeable** amount of time to arrive. + + Source: https://core.telegram.org/bots/api#sendchataction + + :param action: Type of action to broadcast. Choose one, depending on what the user is about to receive: *typing* for `text messages `_, *upload_photo* for `photos `_, *record_video* or *upload_video* for `videos `_, *record_voice* or *upload_voice* for `voice notes `_, *upload_document* for `general files `_, *choose_sticker* for `stickers `_, *find_location* for `location data `_, *record_video_note* or *upload_video_note* for `video notes `_. + :return: instance of method :class:`aiogram.methods.send_chat_action.SendChatAction` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendChatAction + + return SendChatAction( + chat_id=self.id, + action=action, + **kwargs, + ) + + def delete_sticker_set( + self, + **kwargs: Any, + ) -> DeleteChatStickerSet: + """ + Shortcut for method :class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatstickerset + + :return: instance of method :class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteChatStickerSet + + return DeleteChatStickerSet( + chat_id=self.id, + **kwargs, + ) + + def set_sticker_set( + self, + sticker_set_name: str, + **kwargs: Any, + ) -> SetChatStickerSet: + """ + Shortcut for method :class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatstickerset + + :param sticker_set_name: Name of the sticker set to be set as the group sticker set + :return: instance of method :class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatStickerSet + + return SetChatStickerSet( + chat_id=self.id, + sticker_set_name=sticker_set_name, + **kwargs, + ) + + def get_member( + self, + user_id: int, + **kwargs: Any, + ) -> GetChatMember: + """ + Shortcut for method :class:`aiogram.methods.get_chat_member.GetChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to get information about a member of a chat. Returns a :class:`aiogram.types.chat_member.ChatMember` object on success. + + Source: https://core.telegram.org/bots/api#getchatmember + + :param user_id: Unique identifier of the target user + :return: instance of method :class:`aiogram.methods.get_chat_member.GetChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetChatMember + + return GetChatMember( + chat_id=self.id, + user_id=user_id, + **kwargs, + ) + + def get_member_count( + self, + **kwargs: Any, + ) -> GetChatMemberCount: + """ + Shortcut for method :class:`aiogram.methods.get_chat_member_count.GetChatMemberCount` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to get the number of members in a chat. Returns *Int* on success. + + Source: https://core.telegram.org/bots/api#getchatmembercount + + :return: instance of method :class:`aiogram.methods.get_chat_member_count.GetChatMemberCount` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetChatMemberCount + + return GetChatMemberCount( + chat_id=self.id, + **kwargs, + ) + + def leave( + self, + **kwargs: Any, + ) -> LeaveChat: + """ + Shortcut for method :class:`aiogram.methods.leave_chat.LeaveChat` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method for your bot to leave a group, supergroup or channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#leavechat + + :return: instance of method :class:`aiogram.methods.leave_chat.LeaveChat` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import LeaveChat + + return LeaveChat( + chat_id=self.id, + **kwargs, + ) + + def unpin_all_messages( + self, + **kwargs: Any, + ) -> UnpinAllChatMessages: + """ + Shortcut for method :class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to clear the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallchatmessages + + :return: instance of method :class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnpinAllChatMessages + + return UnpinAllChatMessages( + chat_id=self.id, + **kwargs, + ) + + def unpin_message( + self, + message_id: Optional[int] = None, + **kwargs: Any, + ) -> UnpinChatMessage: + """ + Shortcut for method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinchatmessage + + :param message_id: Identifier of a message to unpin. If not specified, the most recent pinned message (by sending date) will be unpinned. + :return: instance of method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnpinChatMessage + + return UnpinChatMessage( + chat_id=self.id, + message_id=message_id, + **kwargs, + ) + + def pin_message( + self, + message_id: int, + disable_notification: Optional[bool] = None, + **kwargs: Any, + ) -> PinChatMessage: + """ + Shortcut for method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#pinchatmessage + + :param message_id: Identifier of a message to pin + :param disable_notification: Pass :code:`True` if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. + :return: instance of method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import PinChatMessage + + return PinChatMessage( + chat_id=self.id, + message_id=message_id, + disable_notification=disable_notification, + **kwargs, + ) + + def set_administrator_custom_title( + self, + user_id: int, + custom_title: str, + **kwargs: Any, + ) -> SetChatAdministratorCustomTitle: + """ + Shortcut for method :class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set a custom title for an administrator in a supergroup promoted by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle + + :param user_id: Unique identifier of the target user + :param custom_title: New custom title for the administrator; 0-16 characters, emoji are not allowed + :return: instance of method :class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatAdministratorCustomTitle + + return SetChatAdministratorCustomTitle( + chat_id=self.id, + user_id=user_id, + custom_title=custom_title, + **kwargs, + ) + + def set_permissions( + self, + permissions: ChatPermissions, + **kwargs: Any, + ) -> SetChatPermissions: + """ + Shortcut for method :class:`aiogram.methods.set_chat_permissions.SetChatPermissions` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the *can_restrict_members* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatpermissions + + :param permissions: A JSON-serialized object for new default chat permissions + :return: instance of method :class:`aiogram.methods.set_chat_permissions.SetChatPermissions` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatPermissions + + return SetChatPermissions( + chat_id=self.id, + permissions=permissions, + **kwargs, + ) + + def promote( + self, + user_id: int, + is_anonymous: Optional[bool] = None, + can_manage_chat: Optional[bool] = None, + can_post_messages: Optional[bool] = None, + can_edit_messages: Optional[bool] = None, + can_delete_messages: Optional[bool] = None, + can_manage_video_chats: Optional[bool] = None, + can_restrict_members: Optional[bool] = None, + can_promote_members: Optional[bool] = None, + can_change_info: Optional[bool] = None, + can_invite_users: Optional[bool] = None, + can_pin_messages: Optional[bool] = None, + can_manage_topics: Optional[bool] = None, + **kwargs: Any, + ) -> PromoteChatMember: + """ + Shortcut for method :class:`aiogram.methods.promote_chat_member.PromoteChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Pass :code:`False` for all boolean parameters to demote a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#promotechatmember + + :param user_id: Unique identifier of the target user + :param is_anonymous: Pass :code:`True` if the administrator's presence in the chat is hidden + :param can_manage_chat: Pass :code:`True` if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege + :param can_post_messages: Pass :code:`True` if the administrator can create channel posts, channels only + :param can_edit_messages: Pass :code:`True` if the administrator can edit messages of other users and can pin messages, channels only + :param can_delete_messages: Pass :code:`True` if the administrator can delete messages of other users + :param can_manage_video_chats: Pass :code:`True` if the administrator can manage video chats + :param can_restrict_members: Pass :code:`True` if the administrator can restrict, ban or unban chat members + :param can_promote_members: 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) + :param can_change_info: Pass :code:`True` if the administrator can change chat title, photo and other settings + :param can_invite_users: Pass :code:`True` if the administrator can invite new users to the chat + :param can_pin_messages: Pass :code:`True` if the administrator can pin messages, supergroups only + :param can_manage_topics: Pass :code:`True` if the user is allowed to create, rename, close, and reopen forum topics, supergroups only + :return: instance of method :class:`aiogram.methods.promote_chat_member.PromoteChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import PromoteChatMember + + return PromoteChatMember( + chat_id=self.id, + user_id=user_id, + is_anonymous=is_anonymous, + can_manage_chat=can_manage_chat, + can_post_messages=can_post_messages, + can_edit_messages=can_edit_messages, + can_delete_messages=can_delete_messages, + can_manage_video_chats=can_manage_video_chats, + can_restrict_members=can_restrict_members, + can_promote_members=can_promote_members, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + **kwargs, + ) + + def restrict( + self, + user_id: int, + permissions: ChatPermissions, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + **kwargs: Any, + ) -> RestrictChatMember: + """ + Shortcut for method :class:`aiogram.methods.restrict_chat_member.RestrictChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate administrator rights. Pass :code:`True` for all permissions to lift restrictions from a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#restrictchatmember + + :param user_id: Unique identifier of the target user + :param permissions: A JSON-serialized object for new user permissions + :param until_date: 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 + :return: instance of method :class:`aiogram.methods.restrict_chat_member.RestrictChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import RestrictChatMember + + return RestrictChatMember( + chat_id=self.id, + user_id=user_id, + permissions=permissions, + until_date=until_date, + **kwargs, + ) + + def unban( + self, + user_id: int, + only_if_banned: Optional[bool] = None, + **kwargs: Any, + ) -> UnbanChatMember: + """ + Shortcut for method :class:`aiogram.methods.unban_chat_member.UnbanChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to unban a previously banned user in a supergroup or channel. The user will **not** return to the group or channel automatically, but will be able to join via link, etc. The bot must be an administrator for this to work. By default, this method guarantees that after the call the user is not a member of the chat, but will be able to join it. So if the user is a member of the chat they will also be **removed** from the chat. If you don't want this, use the parameter *only_if_banned*. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatmember + + :param user_id: Unique identifier of the target user + :param only_if_banned: Do nothing if the user is not banned + :return: instance of method :class:`aiogram.methods.unban_chat_member.UnbanChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnbanChatMember + + return UnbanChatMember( + chat_id=self.id, + user_id=user_id, + only_if_banned=only_if_banned, + **kwargs, + ) + + def ban( + self, + user_id: int, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + revoke_messages: Optional[bool] = None, + **kwargs: Any, + ) -> BanChatMember: + """ + Shortcut for method :class:`aiogram.methods.ban_chat_member.BanChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless `unbanned `_ first. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatmember + + :param user_id: Unique identifier of the target user + :param until_date: Date when the user will be unbanned, unix time. If user is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever. Applied for supergroups and channels only. + :param revoke_messages: Pass :code:`True` to delete all messages from the chat for the user that is being removed. If :code:`False`, the user will be able to see messages in the group that were sent before the user was removed. Always :code:`True` for supergroups and channels. + :return: instance of method :class:`aiogram.methods.ban_chat_member.BanChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import BanChatMember + + return BanChatMember( + chat_id=self.id, + user_id=user_id, + until_date=until_date, + revoke_messages=revoke_messages, + **kwargs, + ) + + def set_description( + self, + description: Optional[str] = None, + **kwargs: Any, + ) -> SetChatDescription: + """ + Shortcut for method :class:`aiogram.methods.set_chat_description.SetChatDescription` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to change the description of a group, a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatdescription + + :param description: New chat description, 0-255 characters + :return: instance of method :class:`aiogram.methods.set_chat_description.SetChatDescription` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatDescription + + return SetChatDescription( + chat_id=self.id, + description=description, + **kwargs, + ) + + def set_title( + self, + title: str, + **kwargs: Any, + ) -> SetChatTitle: + """ + Shortcut for method :class:`aiogram.methods.set_chat_title.SetChatTitle` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to change the title of a chat. Titles can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchattitle + + :param title: New chat title, 1-128 characters + :return: instance of method :class:`aiogram.methods.set_chat_title.SetChatTitle` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatTitle + + return SetChatTitle( + chat_id=self.id, + title=title, + **kwargs, + ) + + def delete_photo( + self, + **kwargs: Any, + ) -> DeleteChatPhoto: + """ + Shortcut for method :class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to delete a chat photo. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatphoto + + :return: instance of method :class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteChatPhoto + + return DeleteChatPhoto( + chat_id=self.id, + **kwargs, + ) + + def set_photo( + self, + photo: InputFile, + **kwargs: Any, + ) -> SetChatPhoto: + """ + Shortcut for method :class:`aiogram.methods.set_chat_photo.SetChatPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set a new profile photo for the chat. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatphoto + + :param photo: New chat photo, uploaded using multipart/form-data + :return: instance of method :class:`aiogram.methods.set_chat_photo.SetChatPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatPhoto + + return SetChatPhoto( + chat_id=self.id, + photo=photo, + **kwargs, ) diff --git a/aiogram/types/chat_action.py b/aiogram/types/chat_action.py deleted file mode 100644 index 619a0dc5fb..0000000000 --- a/aiogram/types/chat_action.py +++ /dev/null @@ -1,33 +0,0 @@ -import enum - -from ..utils.enum import AutoName - - -class ChatAction(AutoName): - """ - This object represents bot actions. - - Choose one, depending on what the user is about to receive: - • typing for text messages, - • upload_photo for photos, - • record_video or upload_video for videos, - • record_voice or upload_voice for voice notes, - • upload_document for general files, - • choose_sticker for stickers, - • find_location for location data, - • record_video_note or upload_video_note for video notes. - - Source: https://core.telegram.org/bots/api#sendchataction - """ - - TYPING = enum.auto() - UPLOAD_PHOTO = enum.auto() - RECORD_VIDEO = enum.auto() - UPLOAD_VIDEO = enum.auto() - RECORD_VOICE = enum.auto() - UPLOAD_VOICE = enum.auto() - UPLOAD_DOCUMENT = enum.auto() - CHOOSE_STICKER = enum.auto() - FIND_LOCATION = enum.auto() - RECORD_VIDEO_NOTE = enum.auto() - UPLOAD_VIDEO_NOTE = enum.auto() diff --git a/aiogram/types/chat_join_request.py b/aiogram/types/chat_join_request.py index b9c862eeeb..a8a9f5a8c0 100644 --- a/aiogram/types/chat_join_request.py +++ b/aiogram/types/chat_join_request.py @@ -1,7 +1,7 @@ from __future__ import annotations import datetime -from typing import TYPE_CHECKING, Optional +from typing import TYPE_CHECKING, Any, Optional from pydantic import Field @@ -34,24 +34,58 @@ class ChatJoinRequest(TelegramObject): invite_link: Optional[ChatInviteLink] = None """*Optional*. Chat invite link that was used by the user to send the join request""" - def approve(self) -> ApproveChatJoinRequest: + def approve( + self, + **kwargs: Any, + ) -> ApproveChatJoinRequest: """ - Use this method to approve a chat join request. + Shortcut for method :class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`user_id` + + Use this method to approve a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#approvechatjoinrequest + + :return: instance of method :class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest` """ - from ..methods import ApproveChatJoinRequest + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import ApproveChatJoinRequest return ApproveChatJoinRequest( chat_id=self.chat.id, user_id=self.from_user.id, + **kwargs, ) - def decline(self) -> DeclineChatJoinRequest: + def decline( + self, + **kwargs: Any, + ) -> DeclineChatJoinRequest: """ - Use this method to decline a chat join request. + Shortcut for method :class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`user_id` + + Use this method to decline a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#declinechatjoinrequest + + :return: instance of method :class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest` """ - from ..methods import DeclineChatJoinRequest + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeclineChatJoinRequest return DeclineChatJoinRequest( chat_id=self.chat.id, user_id=self.from_user.id, + **kwargs, ) diff --git a/aiogram/types/chat_member_administrator.py b/aiogram/types/chat_member_administrator.py index 1c9a8aae5e..4692981dc6 100644 --- a/aiogram/types/chat_member_administrator.py +++ b/aiogram/types/chat_member_administrator.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import ChatMemberStatus from .chat_member import ChatMember if TYPE_CHECKING: @@ -17,7 +18,7 @@ class ChatMemberAdministrator(ChatMember): Source: https://core.telegram.org/bots/api#chatmemberadministrator """ - status: str = Field("administrator", const=True) + status: str = Field(ChatMemberStatus.ADMINISTRATOR, const=True) """The member's status in the chat, always 'administrator'""" user: User """Information about the user""" diff --git a/aiogram/types/chat_member_banned.py b/aiogram/types/chat_member_banned.py index cbed54935d..85c07f5135 100644 --- a/aiogram/types/chat_member_banned.py +++ b/aiogram/types/chat_member_banned.py @@ -5,6 +5,7 @@ from pydantic import Field +from ..enums import ChatMemberStatus from .chat_member import ChatMember if TYPE_CHECKING: @@ -18,7 +19,7 @@ class ChatMemberBanned(ChatMember): Source: https://core.telegram.org/bots/api#chatmemberbanned """ - status: str = Field("kicked", const=True) + status: str = Field(ChatMemberStatus.KICKED, const=True) """The member's status in the chat, always 'kicked'""" user: User """Information about the user""" diff --git a/aiogram/types/chat_member_left.py b/aiogram/types/chat_member_left.py index 02df05dea7..6d7968c15c 100644 --- a/aiogram/types/chat_member_left.py +++ b/aiogram/types/chat_member_left.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import ChatMemberStatus from .chat_member import ChatMember if TYPE_CHECKING: @@ -17,7 +18,7 @@ class ChatMemberLeft(ChatMember): Source: https://core.telegram.org/bots/api#chatmemberleft """ - status: str = Field("left", const=True) + status: str = Field(ChatMemberStatus.LEFT, const=True) """The member's status in the chat, always 'left'""" user: User """Information about the user""" diff --git a/aiogram/types/chat_member_member.py b/aiogram/types/chat_member_member.py index db5d5731ae..303a7d9dc7 100644 --- a/aiogram/types/chat_member_member.py +++ b/aiogram/types/chat_member_member.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import ChatMemberStatus from .chat_member import ChatMember if TYPE_CHECKING: @@ -17,7 +18,7 @@ class ChatMemberMember(ChatMember): Source: https://core.telegram.org/bots/api#chatmembermember """ - status: str = Field("member", const=True) + status: str = Field(ChatMemberStatus.MEMBER, const=True) """The member's status in the chat, always 'member'""" user: User """Information about the user""" diff --git a/aiogram/types/chat_member_owner.py b/aiogram/types/chat_member_owner.py index 308539961e..e7c64fc176 100644 --- a/aiogram/types/chat_member_owner.py +++ b/aiogram/types/chat_member_owner.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import ChatMemberStatus from .chat_member import ChatMember if TYPE_CHECKING: @@ -17,7 +18,7 @@ class ChatMemberOwner(ChatMember): Source: https://core.telegram.org/bots/api#chatmemberowner """ - status: str = Field("creator", const=True) + status: str = Field(ChatMemberStatus.CREATOR, const=True) """The member's status in the chat, always 'creator'""" user: User """Information about the user""" diff --git a/aiogram/types/chat_member_restricted.py b/aiogram/types/chat_member_restricted.py index cc6fe6798a..916b343b7a 100644 --- a/aiogram/types/chat_member_restricted.py +++ b/aiogram/types/chat_member_restricted.py @@ -5,6 +5,7 @@ from pydantic import Field +from ..enums import ChatMemberStatus from .chat_member import ChatMember if TYPE_CHECKING: @@ -18,7 +19,7 @@ class ChatMemberRestricted(ChatMember): Source: https://core.telegram.org/bots/api#chatmemberrestricted """ - status: str = Field("restricted", const=True) + status: str = Field(ChatMemberStatus.RESTRICTED, const=True) """The member's status in the chat, always 'restricted'""" user: User """Information about the user""" diff --git a/aiogram/types/error_event.py b/aiogram/types/error_event.py index ef376a160f..1667d9e93e 100644 --- a/aiogram/types/error_event.py +++ b/aiogram/types/error_event.py @@ -1,16 +1,26 @@ -from aiogram.types import Update +from __future__ import annotations + +from typing import TYPE_CHECKING + from aiogram.types.base import MutableTelegramObject +if TYPE_CHECKING: + from .update import Update + + +class _ErrorEvent(MutableTelegramObject): + class Config: + arbitrary_types_allowed = True -class ErrorEvent(MutableTelegramObject): + +class ErrorEvent(_ErrorEvent): """ Internal event, should be used to receive errors while processing Updates from Telegram + + Source: https://core.telegram.org/bots/api#error-event """ update: Update """Received update""" exception: Exception """Exception""" - - class Config: - arbitrary_types_allowed = True diff --git a/aiogram/types/inline_query.py b/aiogram/types/inline_query.py index d5c674aefb..1feb6f7ff1 100644 --- a/aiogram/types/inline_query.py +++ b/aiogram/types/inline_query.py @@ -1,6 +1,6 @@ from __future__ import annotations -from typing import TYPE_CHECKING, List, Optional +from typing import TYPE_CHECKING, Any, List, Optional from pydantic import Field @@ -41,17 +41,32 @@ def answer( next_offset: Optional[str] = None, switch_pm_text: Optional[str] = None, switch_pm_parameter: Optional[str] = None, + **kwargs: Any, ) -> AnswerInlineQuery: """ - :param results: - :param cache_time: - :param is_personal: - :param next_offset: - :param switch_pm_text: - :param switch_pm_parameter: - :return: + Shortcut for method :class:`aiogram.methods.answer_inline_query.AnswerInlineQuery` + will automatically fill method attributes: + + - :code:`inline_query_id` + + Use this method to send answers to an inline query. On success, :code:`True` is returned. + + No more than **50** results per query are allowed. + + Source: https://core.telegram.org/bots/api#answerinlinequery + + :param results: A JSON-serialized array of results for the inline query + :param cache_time: The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300. + :param is_personal: Pass :code:`True` if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query + :param next_offset: Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes. + :param switch_pm_text: If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with the parameter *switch_pm_parameter* + :param switch_pm_parameter: `Deep-linking `_ parameter for the /start message sent to the bot when user presses the switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. + :return: instance of method :class:`aiogram.methods.answer_inline_query.AnswerInlineQuery` """ - from ..methods import AnswerInlineQuery + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import AnswerInlineQuery return AnswerInlineQuery( inline_query_id=self.id, @@ -61,4 +76,5 @@ def answer( next_offset=next_offset, switch_pm_text=switch_pm_text, switch_pm_parameter=switch_pm_parameter, + **kwargs, ) diff --git a/aiogram/types/inline_query_result_article.py b/aiogram/types/inline_query_result_article.py index 0b4578ddc7..611733c65e 100644 --- a/aiogram/types/inline_query_result_article.py +++ b/aiogram/types/inline_query_result_article.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .inline_query_result import InlineQueryResult if TYPE_CHECKING: @@ -18,7 +19,7 @@ class InlineQueryResultArticle(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultarticle """ - type: str = Field("article", const=True) + type: str = Field(InlineQueryResultType.ARTICLE, const=True) """Type of the result, must be *article*""" id: str """Unique identifier for this result, 1-64 Bytes""" diff --git a/aiogram/types/inline_query_result_audio.py b/aiogram/types/inline_query_result_audio.py index 615980f6b2..d217d246c1 100644 --- a/aiogram/types/inline_query_result_audio.py +++ b/aiogram/types/inline_query_result_audio.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -21,7 +22,7 @@ class InlineQueryResultAudio(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultaudio """ - type: str = Field("audio", const=True) + type: str = Field(InlineQueryResultType.AUDIO, const=True) """Type of the result, must be *audio*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_audio.py b/aiogram/types/inline_query_result_cached_audio.py index 08971c79c5..f630ee5142 100644 --- a/aiogram/types/inline_query_result_cached_audio.py +++ b/aiogram/types/inline_query_result_cached_audio.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -21,7 +22,7 @@ class InlineQueryResultCachedAudio(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcachedaudio """ - type: str = Field("audio", const=True) + type: str = Field(InlineQueryResultType.AUDIO, const=True) """Type of the result, must be *audio*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_document.py b/aiogram/types/inline_query_result_cached_document.py index f5fc741f8f..34ca123823 100644 --- a/aiogram/types/inline_query_result_cached_document.py +++ b/aiogram/types/inline_query_result_cached_document.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -21,7 +22,7 @@ class InlineQueryResultCachedDocument(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcacheddocument """ - type: str = Field("document", const=True) + type: str = Field(InlineQueryResultType.DOCUMENT, const=True) """Type of the result, must be *document*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_gif.py b/aiogram/types/inline_query_result_cached_gif.py index 03abe92e83..3bb77f44f9 100644 --- a/aiogram/types/inline_query_result_cached_gif.py +++ b/aiogram/types/inline_query_result_cached_gif.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -20,7 +21,7 @@ class InlineQueryResultCachedGif(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcachedgif """ - type: str = Field("gif", const=True) + type: str = Field(InlineQueryResultType.GIF, const=True) """Type of the result, must be *gif*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_mpeg4_gif.py b/aiogram/types/inline_query_result_cached_mpeg4_gif.py index 6ff85564ce..5175bc8c37 100644 --- a/aiogram/types/inline_query_result_cached_mpeg4_gif.py +++ b/aiogram/types/inline_query_result_cached_mpeg4_gif.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -20,7 +21,7 @@ class InlineQueryResultCachedMpeg4Gif(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcachedmpeg4gif """ - type: str = Field("mpeg4_gif", const=True) + type: str = Field(InlineQueryResultType.MPEG, const=True) """Type of the result, must be *mpeg4_gif*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_photo.py b/aiogram/types/inline_query_result_cached_photo.py index 9d570b664e..09a9f5b0c6 100644 --- a/aiogram/types/inline_query_result_cached_photo.py +++ b/aiogram/types/inline_query_result_cached_photo.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -20,7 +21,7 @@ class InlineQueryResultCachedPhoto(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcachedphoto """ - type: str = Field("photo", const=True) + type: str = Field(InlineQueryResultType.PHOTO, const=True) """Type of the result, must be *photo*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_sticker.py b/aiogram/types/inline_query_result_cached_sticker.py index 850e08c650..3d75c29c8e 100644 --- a/aiogram/types/inline_query_result_cached_sticker.py +++ b/aiogram/types/inline_query_result_cached_sticker.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .inline_query_result import InlineQueryResult if TYPE_CHECKING: @@ -19,7 +20,7 @@ class InlineQueryResultCachedSticker(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcachedsticker """ - type: str = Field("sticker", const=True) + type: str = Field(InlineQueryResultType.STICKER, const=True) """Type of the result, must be *sticker*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_video.py b/aiogram/types/inline_query_result_cached_video.py index 75196161e6..10720c8008 100644 --- a/aiogram/types/inline_query_result_cached_video.py +++ b/aiogram/types/inline_query_result_cached_video.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -20,7 +21,7 @@ class InlineQueryResultCachedVideo(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcachedvideo """ - type: str = Field("video", const=True) + type: str = Field(InlineQueryResultType.VIDEO, const=True) """Type of the result, must be *video*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_cached_voice.py b/aiogram/types/inline_query_result_cached_voice.py index c62e467a67..23595edf8d 100644 --- a/aiogram/types/inline_query_result_cached_voice.py +++ b/aiogram/types/inline_query_result_cached_voice.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -21,7 +22,7 @@ class InlineQueryResultCachedVoice(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcachedvoice """ - type: str = Field("voice", const=True) + type: str = Field(InlineQueryResultType.VOICE, const=True) """Type of the result, must be *voice*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_contact.py b/aiogram/types/inline_query_result_contact.py index d6bb278a85..04ea46fbc9 100644 --- a/aiogram/types/inline_query_result_contact.py +++ b/aiogram/types/inline_query_result_contact.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .inline_query_result import InlineQueryResult if TYPE_CHECKING: @@ -19,7 +20,7 @@ class InlineQueryResultContact(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultcontact """ - type: str = Field("contact", const=True) + type: str = Field(InlineQueryResultType.CONTACT, const=True) """Type of the result, must be *contact*""" id: str """Unique identifier for this result, 1-64 Bytes""" diff --git a/aiogram/types/inline_query_result_document.py b/aiogram/types/inline_query_result_document.py index 7b35c69a99..941e1de8e1 100644 --- a/aiogram/types/inline_query_result_document.py +++ b/aiogram/types/inline_query_result_document.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -21,7 +22,7 @@ class InlineQueryResultDocument(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultdocument """ - type: str = Field("document", const=True) + type: str = Field(InlineQueryResultType.DOCUMENT, const=True) """Type of the result, must be *document*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_game.py b/aiogram/types/inline_query_result_game.py index bcf56acbc8..e4d92a61ff 100644 --- a/aiogram/types/inline_query_result_game.py +++ b/aiogram/types/inline_query_result_game.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .inline_query_result import InlineQueryResult if TYPE_CHECKING: @@ -18,7 +19,7 @@ class InlineQueryResultGame(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultgame """ - type: str = Field("game", const=True) + type: str = Field(InlineQueryResultType.GAME, const=True) """Type of the result, must be *game*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_gif.py b/aiogram/types/inline_query_result_gif.py index cf53e72684..d674b55a41 100644 --- a/aiogram/types/inline_query_result_gif.py +++ b/aiogram/types/inline_query_result_gif.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -20,7 +21,7 @@ class InlineQueryResultGif(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultgif """ - type: str = Field("gif", const=True) + type: str = Field(InlineQueryResultType.GIF, const=True) """Type of the result, must be *gif*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_location.py b/aiogram/types/inline_query_result_location.py index 339a967e91..395724ff34 100644 --- a/aiogram/types/inline_query_result_location.py +++ b/aiogram/types/inline_query_result_location.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .inline_query_result import InlineQueryResult if TYPE_CHECKING: @@ -19,7 +20,7 @@ class InlineQueryResultLocation(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultlocation """ - type: str = Field("location", const=True) + type: str = Field(InlineQueryResultType.LOCATION, const=True) """Type of the result, must be *location*""" id: str """Unique identifier for this result, 1-64 Bytes""" diff --git a/aiogram/types/inline_query_result_mpeg4_gif.py b/aiogram/types/inline_query_result_mpeg4_gif.py index e4ed3e6038..d846aeb35b 100644 --- a/aiogram/types/inline_query_result_mpeg4_gif.py +++ b/aiogram/types/inline_query_result_mpeg4_gif.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -20,7 +21,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultmpeg4gif """ - type: str = Field("mpeg4_gif", const=True) + type: str = Field(InlineQueryResultType.MPEG, const=True) """Type of the result, must be *mpeg4_gif*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_photo.py b/aiogram/types/inline_query_result_photo.py index 6925b0bb47..b63e0819ea 100644 --- a/aiogram/types/inline_query_result_photo.py +++ b/aiogram/types/inline_query_result_photo.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -20,7 +21,7 @@ class InlineQueryResultPhoto(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultphoto """ - type: str = Field("photo", const=True) + type: str = Field(InlineQueryResultType.PHOTO, const=True) """Type of the result, must be *photo*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_venue.py b/aiogram/types/inline_query_result_venue.py index 38d362b7ca..761886d8bd 100644 --- a/aiogram/types/inline_query_result_venue.py +++ b/aiogram/types/inline_query_result_venue.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .inline_query_result import InlineQueryResult if TYPE_CHECKING: @@ -19,7 +20,7 @@ class InlineQueryResultVenue(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultvenue """ - type: str = Field("venue", const=True) + type: str = Field(InlineQueryResultType.VENUE, const=True) """Type of the result, must be *venue*""" id: str """Unique identifier for this result, 1-64 Bytes""" diff --git a/aiogram/types/inline_query_result_video.py b/aiogram/types/inline_query_result_video.py index 3848396f4e..1a1843eee4 100644 --- a/aiogram/types/inline_query_result_video.py +++ b/aiogram/types/inline_query_result_video.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -22,7 +23,7 @@ class InlineQueryResultVideo(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultvideo """ - type: str = Field("video", const=True) + type: str = Field(InlineQueryResultType.VIDEO, const=True) """Type of the result, must be *video*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/inline_query_result_voice.py b/aiogram/types/inline_query_result_voice.py index e0ed729670..ea5230b20f 100644 --- a/aiogram/types/inline_query_result_voice.py +++ b/aiogram/types/inline_query_result_voice.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InlineQueryResultType from .base import UNSET from .inline_query_result import InlineQueryResult @@ -21,7 +22,7 @@ class InlineQueryResultVoice(InlineQueryResult): Source: https://core.telegram.org/bots/api#inlinequeryresultvoice """ - type: str = Field("voice", const=True) + type: str = Field(InlineQueryResultType.VOICE, const=True) """Type of the result, must be *voice*""" id: str """Unique identifier for this result, 1-64 bytes""" diff --git a/aiogram/types/input_media_animation.py b/aiogram/types/input_media_animation.py index 7e25a8a254..194428ec6f 100644 --- a/aiogram/types/input_media_animation.py +++ b/aiogram/types/input_media_animation.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InputMediaType from .base import UNSET from .input_media import InputMedia @@ -19,7 +20,7 @@ class InputMediaAnimation(InputMedia): Source: https://core.telegram.org/bots/api#inputmediaanimation """ - type: str = Field("animation", const=True) + type: str = Field(InputMediaType.ANIMATION, const=True) """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 » `""" diff --git a/aiogram/types/input_media_audio.py b/aiogram/types/input_media_audio.py index 35884192f6..a9d6961086 100644 --- a/aiogram/types/input_media_audio.py +++ b/aiogram/types/input_media_audio.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InputMediaType from .base import UNSET from .input_media import InputMedia @@ -19,7 +20,7 @@ class InputMediaAudio(InputMedia): Source: https://core.telegram.org/bots/api#inputmediaaudio """ - type: str = Field("audio", const=True) + type: str = Field(InputMediaType.AUDIO, const=True) """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 » `""" diff --git a/aiogram/types/input_media_document.py b/aiogram/types/input_media_document.py index 639be1edaf..22aea18816 100644 --- a/aiogram/types/input_media_document.py +++ b/aiogram/types/input_media_document.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InputMediaType from .base import UNSET from .input_media import InputMedia @@ -19,7 +20,7 @@ class InputMediaDocument(InputMedia): Source: https://core.telegram.org/bots/api#inputmediadocument """ - type: str = Field("document", const=True) + type: str = Field(InputMediaType.DOCUMENT, const=True) """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 » `""" diff --git a/aiogram/types/input_media_photo.py b/aiogram/types/input_media_photo.py index d824f5f51d..d3eb85d175 100644 --- a/aiogram/types/input_media_photo.py +++ b/aiogram/types/input_media_photo.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InputMediaType from .base import UNSET from .input_media import InputMedia @@ -19,7 +20,7 @@ class InputMediaPhoto(InputMedia): Source: https://core.telegram.org/bots/api#inputmediaphoto """ - type: str = Field("photo", const=True) + type: str = Field(InputMediaType.PHOTO, const=True) """Type of the result, must be *photo*""" 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 » `""" diff --git a/aiogram/types/input_media_video.py b/aiogram/types/input_media_video.py index 224663e34c..eb9dd4dd2b 100644 --- a/aiogram/types/input_media_video.py +++ b/aiogram/types/input_media_video.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import InputMediaType from .base import UNSET from .input_media import InputMedia @@ -19,7 +20,7 @@ class InputMediaVideo(InputMedia): Source: https://core.telegram.org/bots/api#inputmediavideo """ - type: str = Field("video", const=True) + type: str = Field(InputMediaType.VIDEO, const=True) """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 » `""" diff --git a/aiogram/types/menu_button_commands.py b/aiogram/types/menu_button_commands.py index f115bdd6de..62a9061c63 100644 --- a/aiogram/types/menu_button_commands.py +++ b/aiogram/types/menu_button_commands.py @@ -2,6 +2,7 @@ from pydantic import Field +from ..enums import MenuButtonType from .menu_button import MenuButton @@ -12,5 +13,5 @@ class MenuButtonCommands(MenuButton): Source: https://core.telegram.org/bots/api#menubuttoncommands """ - type: str = Field("commands", const=True) + type: str = Field(MenuButtonType.COMMANDS, const=True) """Type of the button, must be *commands*""" diff --git a/aiogram/types/menu_button_default.py b/aiogram/types/menu_button_default.py index 2ff09546c8..dc754ec066 100644 --- a/aiogram/types/menu_button_default.py +++ b/aiogram/types/menu_button_default.py @@ -2,6 +2,7 @@ from pydantic import Field +from ..enums import MenuButtonType from .menu_button import MenuButton @@ -12,5 +13,5 @@ class MenuButtonDefault(MenuButton): Source: https://core.telegram.org/bots/api#menubuttondefault """ - type: str = Field("default", const=True) + type: str = Field(MenuButtonType.DEFAULT, const=True) """Type of the button, must be *default*""" diff --git a/aiogram/types/menu_button_web_app.py b/aiogram/types/menu_button_web_app.py index 982dfa0613..f77ed2eabd 100644 --- a/aiogram/types/menu_button_web_app.py +++ b/aiogram/types/menu_button_web_app.py @@ -4,6 +4,7 @@ from pydantic import Field +from ..enums import MenuButtonType from .menu_button import MenuButton if TYPE_CHECKING: @@ -17,7 +18,7 @@ class MenuButtonWebApp(MenuButton): Source: https://core.telegram.org/bots/api#menubuttonwebapp """ - type: str = Field("web_app", const=True) + type: str = Field(MenuButtonType.WEB_APP, const=True) """Type of the button, must be *web_app*""" text: str """Text on the button""" diff --git a/aiogram/types/message.py b/aiogram/types/message.py index b25dd27955..34a96a634b 100644 --- a/aiogram/types/message.py +++ b/aiogram/types/message.py @@ -5,9 +5,9 @@ from pydantic import Field -from aiogram.utils import helper from aiogram.utils.text_decorations import TextDecoration, html_decoration, markdown_decoration +from ..enums import ContentType from .base import UNSET, TelegramObject if TYPE_CHECKING: @@ -327,7 +327,9 @@ def reply_animation( thumb: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -335,24 +337,40 @@ def reply_animation( **kwargs: Any, ) -> SendAnimation: """ - Reply with animation + Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation` + will automatically fill method attributes: - :param animation: - :param duration: - :param width: - :param height: - :param thumb: - :param caption: - :param parse_mode: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :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 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* + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` """ - from ..methods import SendAnimation + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAnimation return SendAnimation( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, animation=animation, duration=duration, width=width, @@ -360,11 +378,11 @@ def reply_animation( thumb=thumb, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -377,30 +395,50 @@ def answer_animation( thumb: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendAnimation: """ - Answer with animation + Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation` + will automatically fill method attributes: - :param animation: - :param duration: - :param width: - :param height: - :param thumb: - :param caption: - :param parse_mode: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :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 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* + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` """ - from ..methods import SendAnimation + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAnimation return SendAnimation( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, animation=animation, duration=duration, width=width, @@ -408,10 +446,12 @@ def answer_animation( thumb=thumb, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -420,11 +460,13 @@ def reply_audio( audio: Union[InputFile, str], caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, thumb: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -432,36 +474,53 @@ def reply_audio( **kwargs: Any, ) -> SendAudio: """ - Reply with audio + Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` + will automatically fill method attributes: - :param audio: - :param caption: - :param parse_mode: - :param duration: - :param performer: - :param title: - :param thumb: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param 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 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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` """ - from ..methods import SendAudio + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAudio return SendAudio( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, audio=audio, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, duration=duration, performer=performer, title=title, thumb=thumb, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -470,45 +529,68 @@ def answer_audio( audio: Union[InputFile, str], caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, duration: Optional[int] = None, performer: Optional[str] = None, title: Optional[str] = None, thumb: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendAudio: """ - Answer with audio + Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` + will automatically fill method attributes: - :param audio: - :param caption: - :param parse_mode: - :param duration: - :param performer: - :param title: - :param thumb: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param 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 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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` """ - from ..methods import SendAudio + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAudio return SendAudio( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, audio=audio, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, duration=duration, performer=performer, title=title, thumb=thumb, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -519,6 +601,7 @@ def reply_contact( last_name: Optional[str] = None, vcard: Optional[str] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -526,30 +609,44 @@ def reply_contact( **kwargs: Any, ) -> SendContact: """ - Reply with contact + Shortcut for method :class:`aiogram.methods.send_contact.SendContact` + will automatically fill method attributes: - :param phone_number: - :param first_name: - :param last_name: - :param vcard: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_contact.SendContact` """ - from ..methods import SendContact + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendContact return SendContact( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, phone_number=phone_number, first_name=first_name, last_name=last_name, vcard=vcard, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -560,34 +657,53 @@ def answer_contact( last_name: Optional[str] = None, vcard: Optional[str] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendContact: """ - Answer with contact + Shortcut for method :class:`aiogram.methods.send_contact.SendContact` + will automatically fill method attributes: - :param phone_number: - :param first_name: - :param last_name: - :param vcard: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_contact.SendContact` """ - from ..methods import SendContact + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendContact return SendContact( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, phone_number=phone_number, first_name=first_name, last_name=last_name, vcard=vcard, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -597,7 +713,10 @@ def reply_document( thumb: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -605,30 +724,48 @@ def reply_document( **kwargs: Any, ) -> SendDocument: """ - Reply with document + Shortcut for method :class:`aiogram.methods.send_document.SendDocument` + will automatically fill method attributes: - :param document: - :param thumb: - :param caption: - :param parse_mode: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + 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 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* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_document.SendDocument` """ - from ..methods import SendDocument + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDocument return SendDocument( chat_id=self.chat.id, + 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, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -638,35 +775,60 @@ def answer_document( thumb: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendDocument: """ - Answer with document + Shortcut for method :class:`aiogram.methods.send_document.SendDocument` + will automatically fill method attributes: - :param document: - :param thumb: - :param caption: - :param parse_mode: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + 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 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* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_document.SendDocument` """ - from ..methods import SendDocument + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDocument return SendDocument( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, document=document, thumb=thumb, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -674,29 +836,44 @@ def reply_game( self, game_short_name: str, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> SendGame: """ - Reply with game + Shortcut for method :class:`aiogram.methods.send_game.SendGame` + will automatically fill method attributes: - :param game_short_name: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :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 + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :return: instance of method :class:`aiogram.methods.send_game.SendGame` """ - from ..methods import SendGame + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendGame return SendGame( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, game_short_name=game_short_name, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -704,26 +881,45 @@ def answer_game( self, game_short_name: str, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> SendGame: """ - Answer with game + Shortcut for method :class:`aiogram.methods.send_game.SendGame` + will automatically fill method attributes: - :param game_short_name: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :return: instance of method :class:`aiogram.methods.send_game.SendGame` """ - from ..methods import SendGame + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendGame return SendGame( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, game_short_name=game_short_name, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -757,7 +953,16 @@ def reply_invoice( **kwargs: Any, ) -> SendInvoice: """ - Reply with invoice + Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice :param title: Product name, 1-32 characters :param description: Product description, 1-255 characters @@ -783,13 +988,18 @@ def reply_invoice( :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 - :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. - :return: On success, the sent Message is returned. + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :return: instance of method :class:`aiogram.methods.send_invoice.SendInvoice` """ - from ..methods import SendInvoice + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendInvoice return SendInvoice( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, title=title, description=description, payload=payload, @@ -813,10 +1023,8 @@ def reply_invoice( is_flexible=is_flexible, disable_notification=disable_notification, protect_content=protect_content, - reply_to_message_id=self.message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -845,11 +1053,21 @@ def answer_invoice( is_flexible: Optional[bool] = None, disable_notification: Optional[bool] = None, protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> SendInvoice: """ - Answer with invoice + Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice :param title: Product name, 1-32 characters :param description: Product description, 1-255 characters @@ -874,13 +1092,19 @@ def answer_invoice( :param is_flexible: Pass :code:`True` if the final price depends on the shipping method :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_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. - :return: On success, the sent Message is returned. + :param reply_to_message_id: If the message is a reply, ID of the original message + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :return: instance of method :class:`aiogram.methods.send_invoice.SendInvoice` """ - from ..methods import SendInvoice + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendInvoice return SendInvoice( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, title=title, description=description, payload=payload, @@ -904,9 +1128,9 @@ def answer_invoice( is_flexible=is_flexible, disable_notification=disable_notification, protect_content=protect_content, - reply_to_message_id=None, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -914,8 +1138,12 @@ def reply_location( self, latitude: float, longitude: float, + horizontal_accuracy: Optional[float] = None, live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -923,28 +1151,48 @@ def reply_location( **kwargs: Any, ) -> SendLocation: """ - Reply with location + Shortcut for method :class:`aiogram.methods.send_location.SendLocation` + will automatically fill method attributes: - :param latitude: - :param longitude: - :param live_period: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds for which the location will be updated (see `Live Locations `_, should be between 60 and 86400. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_location.SendLocation` """ - from ..methods import SendLocation + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendLocation return SendLocation( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, latitude=latitude, longitude=longitude, + horizontal_accuracy=horizontal_accuracy, live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -952,34 +1200,62 @@ def answer_location( self, latitude: float, longitude: float, + horizontal_accuracy: Optional[float] = None, live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendLocation: """ - Answer with location + Shortcut for method :class:`aiogram.methods.send_location.SendLocation` + will automatically fill method attributes: - :param latitude: - :param longitude: - :param live_period: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds for which the location will be updated (see `Live Locations `_, should be between 60 and 86400. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_location.SendLocation` """ - from ..methods import SendLocation + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendLocation return SendLocation( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, latitude=latitude, longitude=longitude, + horizontal_accuracy=horizontal_accuracy, live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -987,26 +1263,41 @@ def reply_media_group( self, media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, **kwargs: Any, ) -> SendMediaGroup: """ - Reply with media group + Shortcut for method :class:`aiogram.methods.send_media_group.SendMediaGroup` + will automatically fill method attributes: - :param media: - :param disable_notification: - :param allow_sending_without_reply: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages 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 + :return: instance of method :class:`aiogram.methods.send_media_group.SendMediaGroup` """ - from ..methods import SendMediaGroup + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMediaGroup return SendMediaGroup( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, media=media, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1014,23 +1305,42 @@ def answer_media_group( self, media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, **kwargs: Any, ) -> SendMediaGroup: """ - Answer with media group + Shortcut for method :class:`aiogram.methods.send_media_group.SendMediaGroup` + will automatically fill method attributes: - :param media: - :param disable_notification: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param reply_to_message_id: If the messages are a reply, ID of the original message + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_media_group.SendMediaGroup` """ - from ..methods import SendMediaGroup + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMediaGroup return SendMediaGroup( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, media=media, disable_notification=disable_notification, - reply_to_message_id=None, - message_thread_id=self.message_thread_id if self.is_topic_message else None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, **kwargs, ) @@ -1038,8 +1348,10 @@ def reply( self, text: str, parse_mode: Optional[str] = UNSET, + entities: Optional[List[MessageEntity]] = None, disable_web_page_preview: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1047,28 +1359,44 @@ def reply( **kwargs: Any, ) -> SendMessage: """ - Reply with text message + Shortcut for method :class:`aiogram.methods.send_message.SendMessage` + will automatically fill method attributes: - :param text: - :param parse_mode: - :param disable_web_page_preview: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param disable_web_page_preview: Disables link previews for links in this message + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_message.SendMessage` """ - from ..methods import SendMessage + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMessage return SendMessage( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, text=text, parse_mode=parse_mode, + entities=entities, disable_web_page_preview=disable_web_page_preview, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1076,34 +1404,56 @@ def answer( self, text: str, parse_mode: Optional[str] = UNSET, + entities: Optional[List[MessageEntity]] = None, disable_web_page_preview: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendMessage: """ - Answer with text message + Shortcut for method :class:`aiogram.methods.send_message.SendMessage` + will automatically fill method attributes: - :param text: - :param parse_mode: - :param disable_web_page_preview: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param disable_web_page_preview: Disables link previews for links in this message + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_message.SendMessage` """ - from ..methods import SendMessage + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMessage return SendMessage( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, text=text, parse_mode=parse_mode, + entities=entities, disable_web_page_preview=disable_web_page_preview, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1112,7 +1462,9 @@ def reply_photo( photo: Union[InputFile, str], caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1120,28 +1472,44 @@ def reply_photo( **kwargs: Any, ) -> SendPhoto: """ - Reply with photo + Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` + will automatically fill method attributes: - :param photo: - :param caption: - :param parse_mode: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param 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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_photo.SendPhoto` """ - from ..methods import SendPhoto + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPhoto return SendPhoto( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, photo=photo, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1150,33 +1518,55 @@ def answer_photo( photo: Union[InputFile, str], caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendPhoto: """ - Answer with photo + Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` + will automatically fill method attributes: - :param photo: - :param caption: - :param parse_mode: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param 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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_photo.SendPhoto` """ - from ..methods import SendPhoto + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPhoto return SendPhoto( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, photo=photo, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1190,10 +1580,12 @@ def reply_poll( correct_option_id: Optional[int] = None, explanation: Optional[str] = None, explanation_parse_mode: Optional[str] = UNSET, + explanation_entities: Optional[List[MessageEntity]] = None, open_period: Optional[int] = None, close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, is_closed: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1201,28 +1593,44 @@ def reply_poll( **kwargs: Any, ) -> SendPoll: """ - Reply with poll - - :param question: - :param options: - :param is_anonymous: - :param type: - :param allows_multiple_answers: - :param correct_option_id: - :param explanation: - :param explanation_parse_mode: - :param open_period: - :param close_date: - :param is_closed: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of answer options, 2-10 strings 1-100 characters each + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation, which can be specified instead of *parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_poll.SendPoll` """ - from ..methods import SendPoll + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPoll return SendPoll( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, question=question, options=options, is_anonymous=is_anonymous, @@ -1231,14 +1639,14 @@ def reply_poll( correct_option_id=correct_option_id, explanation=explanation, explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, open_period=open_period, close_date=close_date, is_closed=is_closed, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1252,37 +1660,57 @@ def answer_poll( correct_option_id: Optional[int] = None, explanation: Optional[str] = None, explanation_parse_mode: Optional[str] = UNSET, + explanation_entities: Optional[List[MessageEntity]] = None, open_period: Optional[int] = None, close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, is_closed: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendPoll: """ - Answer with poll - - :param question: - :param options: - :param is_anonymous: - :param type: - :param allows_multiple_answers: - :param correct_option_id: - :param explanation: - :param explanation_parse_mode: - :param open_period: - :param close_date: - :param is_closed: - :param disable_notification: - :param reply_markup: - :return: + Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of answer options, 2-10 strings 1-100 characters each + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation, which can be specified instead of *parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_poll.SendPoll` """ - from ..methods import SendPoll + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPoll return SendPoll( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, question=question, options=options, is_anonymous=is_anonymous, @@ -1291,13 +1719,15 @@ def answer_poll( correct_option_id=correct_option_id, explanation=explanation, explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, open_period=open_period, close_date=close_date, is_closed=is_closed, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1305,6 +1735,7 @@ def reply_dice( self, emoji: Optional[str] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1312,24 +1743,38 @@ def reply_dice( **kwargs: Any, ) -> SendDice: """ - Reply with dice + Shortcut for method :class:`aiogram.methods.send_dice.SendDice` + will automatically fill method attributes: - :param emoji: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_dice.SendDice` """ - from ..methods import SendDice + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDice return SendDice( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, emoji=emoji, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1337,28 +1782,47 @@ def answer_dice( self, emoji: Optional[str] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendDice: """ - Answer with dice + Shortcut for method :class:`aiogram.methods.send_dice.SendDice` + will automatically fill method attributes: - :param emoji: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :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 + :param reply_to_message_id: If the message is a reply, ID of the original message + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_dice.SendDice` """ - from ..methods import SendDice + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDice return SendDice( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, emoji=emoji, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1366,6 +1830,7 @@ def reply_sticker( self, sticker: Union[InputFile, str], disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1373,24 +1838,38 @@ def reply_sticker( **kwargs: Any, ) -> SendSticker: """ - Reply with sticker + Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` + will automatically fill method attributes: - :param sticker: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + 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 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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` """ - from ..methods import SendSticker + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendSticker return SendSticker( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, sticker=sticker, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1398,28 +1877,47 @@ def answer_sticker( self, sticker: Union[InputFile, str], disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendSticker: """ - Answer with sticker + Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` + will automatically fill method attributes: - :param sticker: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + 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 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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` """ - from ..methods import SendSticker + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendSticker return SendSticker( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, sticker=sticker, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1431,7 +1929,10 @@ def reply_venue( address: str, foursquare_id: Optional[str] = None, foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1439,34 +1940,52 @@ def reply_venue( **kwargs: Any, ) -> SendVenue: """ - Reply with venue + Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` + will automatically fill method attributes: - :param latitude: - :param longitude: - :param title: - :param address: - :param foursquare_id: - :param foursquare_type: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_venue.SendVenue` """ - from ..methods import SendVenue + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVenue return SendVenue( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, latitude=latitude, longitude=longitude, title=title, address=address, foursquare_id=foursquare_id, foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1478,39 +1997,64 @@ def answer_venue( address: str, foursquare_id: Optional[str] = None, foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendVenue: """ - Answer with venue + Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` + will automatically fill method attributes: - :param latitude: - :param longitude: - :param title: - :param address: - :param foursquare_id: - :param foursquare_type: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_venue.SendVenue` """ - from ..methods import SendVenue + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVenue return SendVenue( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, latitude=latitude, longitude=longitude, title=title, address=address, foursquare_id=foursquare_id, foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1523,8 +2067,10 @@ def reply_video( thumb: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, supports_streaming: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1532,25 +2078,41 @@ def reply_video( **kwargs: Any, ) -> SendVideo: """ - Reply with video + Shortcut for method :class:`aiogram.methods.send_video.SendVideo` + will automatically fill method attributes: - :param video: - :param duration: - :param width: - :param height: - :param thumb: - :param caption: - :param parse_mode: - :param supports_streaming: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :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 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* + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_video.SendVideo` """ - from ..methods import SendVideo + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideo return SendVideo( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, video=video, duration=duration, width=width, @@ -1558,12 +2120,12 @@ def reply_video( thumb=thumb, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, supports_streaming=supports_streaming, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1576,32 +2138,52 @@ def answer_video( thumb: Optional[Union[InputFile, str]] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, supports_streaming: Optional[bool] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendVideo: """ - Answer with video + Shortcut for method :class:`aiogram.methods.send_video.SendVideo` + will automatically fill method attributes: - :param video: - :param duration: - :param width: - :param height: - :param thumb: - :param caption: - :param parse_mode: - :param supports_streaming: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :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 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* + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_video.SendVideo` """ - from ..methods import SendVideo + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideo return SendVideo( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, video=video, duration=duration, width=width, @@ -1609,11 +2191,13 @@ def answer_video( thumb=thumb, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, supports_streaming=supports_streaming, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1624,6 +2208,7 @@ def reply_video_note( length: Optional[int] = None, thumb: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1631,30 +2216,44 @@ def reply_video_note( **kwargs: Any, ) -> SendVideoNote: """ - Reply wit video note + Shortcut for method :class:`aiogram.methods.send_video_note.SendVideoNote` + will automatically fill method attributes: - :param video_note: - :param duration: - :param length: - :param thumb: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :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 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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` """ - from ..methods import SendVideoNote + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideoNote return SendVideoNote( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, video_note=video_note, duration=duration, length=length, thumb=thumb, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1665,34 +2264,53 @@ def answer_video_note( length: Optional[int] = None, thumb: Optional[Union[InputFile, str]] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendVideoNote: """ - Answer wit video note + Shortcut for method :class:`aiogram.methods.send_video_note.SendVideoNote` + will automatically fill method attributes: - :param video_note: - :param duration: - :param length: - :param thumb: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :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 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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` """ - from ..methods import SendVideoNote + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideoNote return SendVideoNote( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, video_note=video_note, duration=duration, length=length, thumb=thumb, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1701,8 +2319,10 @@ def reply_voice( voice: Union[InputFile, str], caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, duration: Optional[int] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] @@ -1710,30 +2330,46 @@ def reply_voice( **kwargs: Any, ) -> SendVoice: """ - Reply with voice + Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` + will automatically fill method attributes: - :param voice: - :param caption: - :param parse_mode: - :param duration: - :param disable_notification: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`reply_to_message_id` + + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param voice: Audio 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 caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :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 + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_voice.SendVoice` """ - from ..methods import SendVoice + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVoice return SendVoice( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + reply_to_message_id=self.message_id, voice=voice, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, duration=duration, disable_notification=disable_notification, - reply_to_message_id=self.message_id, + protect_content=protect_content, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1742,36 +2378,58 @@ def answer_voice( voice: Union[InputFile, str], caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, + caption_entities: Optional[List[MessageEntity]] = None, duration: Optional[int] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] ] = None, **kwargs: Any, ) -> SendVoice: """ - Answer with voice + Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` + will automatically fill method attributes: - :param voice: - :param caption: - :param parse_mode: - :param duration: - :param disable_notification: - :param reply_markup: - :return: + - :code:`chat_id` + - :code:`message_thread_id` + + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param voice: Audio 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 caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :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 + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.send_voice.SendVoice` """ - from ..methods import SendVoice + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVoice return SendVoice( chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, voice=voice, caption=caption, parse_mode=parse_mode, + caption_entities=caption_entities, duration=duration, disable_notification=disable_notification, - reply_to_message_id=None, + protect_content=protect_content, + reply_to_message_id=reply_to_message_id, + allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1916,11 +2574,12 @@ def send_copy( def copy_to( self, chat_id: Union[int, str], + message_thread_id: Optional[int] = None, caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, - message_thread_id: Optional[int] = None, disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, reply_to_message_id: Optional[int] = None, allow_sending_without_reply: Optional[bool] = None, reply_markup: Optional[ @@ -1929,56 +2588,92 @@ def copy_to( **kwargs: Any, ) -> CopyMessage: """ - Copy message + Shortcut for method :class:`aiogram.methods.copy_message.CopyMessage` + will automatically fill method attributes: - :param chat_id: - :param caption: - :param parse_mode: - :param caption_entities: - :param message_thread_id: - :param disable_notification: - :param reply_to_message_id: - :param allow_sending_without_reply: - :param reply_markup: - :return: + - :code:`from_chat_id` + - :code:`message_id` + + Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success. + + Source: https://core.telegram.org/bots/api#copymessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: New caption for media, 0-1024 characters after entities parsing. If not specified, the original caption is kept + :param parse_mode: Mode for parsing entities in the new caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the new caption, which can be specified instead of *parse_mode* + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param reply_to_message_id: If the message is a reply, ID of the original message + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove reply keyboard or to force a reply from the user. + :return: instance of method :class:`aiogram.methods.copy_message.CopyMessage` """ - from ..methods import CopyMessage + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import CopyMessage return CopyMessage( - chat_id=chat_id, from_chat_id=self.chat.id, message_id=self.message_id, + chat_id=chat_id, + message_thread_id=message_thread_id, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, disable_notification=disable_notification, + protect_content=protect_content, reply_to_message_id=reply_to_message_id, allow_sending_without_reply=allow_sending_without_reply, reply_markup=reply_markup, - message_thread_id=message_thread_id, **kwargs, ) def edit_text( self, text: str, + inline_message_id: Optional[str] = None, parse_mode: Optional[str] = UNSET, entities: Optional[List[MessageEntity]] = None, disable_web_page_preview: Optional[bool] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> EditMessageText: - from ..methods import EditMessageText + """ + Shortcut for method :class:`aiogram.methods.edit_message_text.EditMessageText` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit text and `game `_ messages. 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. + + Source: https://core.telegram.org/bots/api#editmessagetext + + :param text: New text of the message, 1-4096 characters after entities parsing + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param disable_web_page_preview: Disables link previews for links in this message + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_text.EditMessageText` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageText return EditMessageText( chat_id=self.chat.id, message_id=self.message_id, text=text, + inline_message_id=inline_message_id, parse_mode=parse_mode, entities=entities, disable_web_page_preview=disable_web_page_preview, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -1990,47 +2685,106 @@ def forward( protect_content: Optional[bool] = None, **kwargs: Any, ) -> ForwardMessage: - from ..methods import ForwardMessage + """ + Shortcut for method :class:`aiogram.methods.forward_message.ForwardMessage` + will automatically fill method attributes: + + - :code:`from_chat_id` + - :code:`message_id` + + Use this method to forward messages of any kind. Service messages can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#forwardmessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the forwarded message from forwarding and saving + :return: instance of method :class:`aiogram.methods.forward_message.ForwardMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import ForwardMessage return ForwardMessage( - chat_id=chat_id, from_chat_id=self.chat.id, message_id=self.message_id, + chat_id=chat_id, + message_thread_id=message_thread_id, disable_notification=disable_notification, protect_content=protect_content, - message_thread_id=message_thread_id, **kwargs, ) def edit_media( self, media: InputMedia, + inline_message_id: Optional[str] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> EditMessageMedia: - from ..methods import EditMessageMedia + """ + Shortcut for method :class:`aiogram.methods.edit_message_media.EditMessageMedia` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#editmessagemedia + + :param media: A JSON-serialized object for a new media content of the message + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_media.EditMessageMedia` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageMedia return EditMessageMedia( - media=media, chat_id=self.chat.id, message_id=self.message_id, + media=media, + inline_message_id=inline_message_id, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) def edit_reply_markup( self, + inline_message_id: Optional[str] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> EditMessageReplyMarkup: - from ..methods import EditMessageReplyMarkup + """ + Shortcut for method :class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit only the reply markup of messages. 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. + + Source: https://core.telegram.org/bots/api#editmessagereplymarkup + + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageReplyMarkup return EditMessageReplyMarkup( chat_id=self.chat.id, message_id=self.message_id, + inline_message_id=inline_message_id, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -2041,60 +2795,125 @@ def edit_live_location( self, latitude: float, longitude: float, + inline_message_id: Optional[str] = None, horizontal_accuracy: Optional[float] = None, heading: Optional[int] = None, proximity_alert_radius: Optional[int] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> EditMessageLiveLocation: - from ..methods import EditMessageLiveLocation + """ + Shortcut for method :class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + 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. + + Source: https://core.telegram.org/bots/api#editmessagelivelocation + + :param latitude: Latitude of new location + :param longitude: Longitude of new location + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param heading: Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageLiveLocation return EditMessageLiveLocation( - latitude=latitude, - longitude=longitude, chat_id=self.chat.id, message_id=self.message_id, + latitude=latitude, + longitude=longitude, + inline_message_id=inline_message_id, horizontal_accuracy=horizontal_accuracy, heading=heading, proximity_alert_radius=proximity_alert_radius, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) def stop_live_location( self, + inline_message_id: Optional[str] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> StopMessageLiveLocation: - from ..methods import StopMessageLiveLocation + """ + Shortcut for method :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + 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. + + Source: https://core.telegram.org/bots/api#stopmessagelivelocation + + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import StopMessageLiveLocation return StopMessageLiveLocation( chat_id=self.chat.id, message_id=self.message_id, + inline_message_id=inline_message_id, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) def edit_caption( self, - caption: str, + inline_message_id: Optional[str] = None, + caption: Optional[str] = None, parse_mode: Optional[str] = UNSET, caption_entities: Optional[List[MessageEntity]] = None, reply_markup: Optional[InlineKeyboardMarkup] = None, **kwargs: Any, ) -> EditMessageCaption: - from ..methods import EditMessageCaption + """ + Shortcut for method :class:`aiogram.methods.edit_message_caption.EditMessageCaption` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit captions of messages. 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. + + Source: https://core.telegram.org/bots/api#editmessagecaption + + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param caption: New caption of the message, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_caption.EditMessageCaption` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageCaption return EditMessageCaption( chat_id=self.chat.id, message_id=self.message_id, + inline_message_id=inline_message_id, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities, reply_markup=reply_markup, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -2102,12 +2921,45 @@ def delete( self, **kwargs: Any, ) -> DeleteMessage: - from ..methods import DeleteMessage + """ + Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to delete a message, including service messages, with the following limitations: + + - A message can only be deleted if it was sent less than 48 hours ago. + + - Service messages about a supergroup, channel, or forum topic creation can't be deleted. + + - A dice message in a private chat can only be deleted if it was sent more than 24 hours ago. + + - Bots can delete outgoing messages in private chats, groups, and supergroups. + + - Bots can delete incoming messages in private chats. + + - Bots granted *can_post_messages* permissions can delete outgoing messages in channels. + + - If the bot is an administrator of a group, it can delete any message there. + + - If the bot has *can_delete_messages* permission in a supergroup or a channel, it can delete any message there. + + Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessage + + :return: instance of method :class:`aiogram.methods.delete_message.DeleteMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteMessage return DeleteMessage( chat_id=self.chat.id, message_id=self.message_id, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -2116,13 +2968,29 @@ def pin( disable_notification: Optional[bool] = None, **kwargs: Any, ) -> PinChatMessage: - from ..methods import PinChatMessage + """ + Shortcut for method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#pinchatmessage + + :param disable_notification: Pass :code:`True` if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. + :return: instance of method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import PinChatMessage return PinChatMessage( chat_id=self.chat.id, message_id=self.message_id, disable_notification=disable_notification, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -2130,12 +2998,27 @@ def unpin( self, **kwargs: Any, ) -> UnpinChatMessage: - from ..methods import UnpinChatMessage + """ + Shortcut for method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinchatmessage + + :return: instance of method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnpinChatMessage return UnpinChatMessage( chat_id=self.chat.id, message_id=self.message_id, - message_thread_id=self.message_thread_id if self.is_topic_message else None, **kwargs, ) @@ -2157,51 +3040,3 @@ def get_url(self, force_private: bool = False) -> Optional[str]: chat_value = self.chat.username return f"https://t.me/{chat_value}/{self.message_id}" - - -class ContentType(helper.Helper): - mode = helper.HelperMode.snake_case - - TEXT = helper.Item() # text - AUDIO = helper.Item() # audio - DOCUMENT = helper.Item() # document - ANIMATION = helper.Item() # animation - GAME = helper.Item() # game - PHOTO = helper.Item() # photo - STICKER = helper.Item() # sticker - VIDEO = helper.Item() # video - VIDEO_NOTE = helper.Item() # video_note - VOICE = helper.Item() # voice - CONTACT = helper.Item() # contact - LOCATION = helper.Item() # location - VENUE = helper.Item() # venue - NEW_CHAT_MEMBERS = helper.Item() # new_chat_member - LEFT_CHAT_MEMBER = helper.Item() # left_chat_member - INVOICE = helper.Item() # invoice - SUCCESSFUL_PAYMENT = helper.Item() # successful_payment - CONNECTED_WEBSITE = helper.Item() # connected_website - MIGRATE_TO_CHAT_ID = helper.Item() # migrate_to_chat_id - MIGRATE_FROM_CHAT_ID = helper.Item() # migrate_from_chat_id - PINNED_MESSAGE = helper.Item() # pinned_message - NEW_CHAT_TITLE = helper.Item() # new_chat_title - NEW_CHAT_PHOTO = helper.Item() # new_chat_photo - DELETE_CHAT_PHOTO = helper.Item() # delete_chat_photo - GROUP_CHAT_CREATED = helper.Item() # group_chat_created - SUPERGROUP_CHAT_CREATED = helper.Item() # supergroup_chat_created - CHANNEL_CHAT_CREATED = helper.Item() # channel_chat_created - PASSPORT_DATA = helper.Item() # passport_data - PROXIMITY_ALERT_TRIGGERED = helper.Item() # proximity_alert_triggered - POLL = helper.Item() # poll - DICE = helper.Item() # dice - MESSAGE_AUTO_DELETE_TIMER_CHANGED = helper.Item() # message_auto_delete_timer_changed - FORUM_TOPIC_CREATED = helper.Item() # forum_topic_created - FORUM_TOPIC_CLOSED = helper.Item() # forum_topic_closed - FORUM_TOPIC_REOPENED = helper.Item() # forum_topic_reopened - VIDEO_CHAT_SCHEDULED = helper.Item() # video_chat_scheduled - VIDEO_CHAT_STARTED = helper.Item() # video_chat_started - VIDEO_CHAT_ENDED = helper.Item() # video_chat_ended - VIDEO_CHAT_PARTICIPANTS_INVITED = helper.Item() # video_chat_participants_invited - WEB_APP_DATA = helper.Item() # web_app_data - - UNKNOWN = helper.Item() # unknown - ANY = helper.Item() # any diff --git a/aiogram/types/sticker.py b/aiogram/types/sticker.py index 19f01a02a1..770dd204ea 100644 --- a/aiogram/types/sticker.py +++ b/aiogram/types/sticker.py @@ -1,10 +1,11 @@ from __future__ import annotations -from typing import TYPE_CHECKING, Optional +from typing import TYPE_CHECKING, Any, Optional from .base import TelegramObject if TYPE_CHECKING: + from ..methods import DeleteStickerFromSet, SetStickerPositionInSet from .file import File from .mask_position import MaskPosition from .photo_size import PhotoSize @@ -45,3 +46,58 @@ class Sticker(TelegramObject): """*Optional*. For custom emoji stickers, unique identifier of the custom emoji""" file_size: Optional[int] = None """*Optional*. File size in bytes""" + + def set_position_in_set( + self, + position: int, + **kwargs: Any, + ) -> SetStickerPositionInSet: + """ + Shortcut for method :class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet` + will automatically fill method attributes: + + - :code:`sticker` + + Use this method to move a sticker in a set created by the bot to a specific position. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerpositioninset + + :param position: New sticker position in the set, zero-based + :return: instance of method :class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetStickerPositionInSet + + return SetStickerPositionInSet( + sticker=self.file_id, + position=position, + **kwargs, + ) + + def delete_from_set( + self, + **kwargs: Any, + ) -> DeleteStickerFromSet: + """ + Shortcut for method :class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet` + will automatically fill method attributes: + + - :code:`sticker` + + Use this method to delete a sticker from a set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerfromset + + :return: instance of method :class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteStickerFromSet + + return DeleteStickerFromSet( + sticker=self.file_id, + **kwargs, + ) diff --git a/aiogram/types/user.py b/aiogram/types/user.py index 2308dbd48d..3b71af1910 100644 --- a/aiogram/types/user.py +++ b/aiogram/types/user.py @@ -1,11 +1,14 @@ from __future__ import annotations -from typing import Optional +from typing import TYPE_CHECKING, Any, Optional from ..utils import markdown from ..utils.link import create_tg_link from .base import TelegramObject +if TYPE_CHECKING: + from ..methods import GetUserProfilePhotos + class User(TelegramObject): """ @@ -56,3 +59,35 @@ def mention_html(self, name: Optional[str] = None) -> str: if name is None: name = self.full_name return markdown.hlink(name, self.url) + + def get_profile_photos( + self, + offset: Optional[int] = None, + limit: Optional[int] = None, + **kwargs: Any, + ) -> GetUserProfilePhotos: + """ + Shortcut for method :class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos` + will automatically fill method attributes: + + - :code:`user_id` + + Use this method to get a list of profile pictures for a user. Returns a :class:`aiogram.types.user_profile_photos.UserProfilePhotos` object. + + Source: https://core.telegram.org/bots/api#getuserprofilephotos + + :param offset: Sequential number of the first photo to be returned. By default, all photos are returned. + :param limit: Limits the number of photos to be retrieved. Values between 1-100 are accepted. Defaults to 100. + :return: instance of method :class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetUserProfilePhotos + + return GetUserProfilePhotos( + user_id=self.id, + offset=offset, + limit=limit, + **kwargs, + ) diff --git a/aiogram/utils/enum.py b/aiogram/utils/enum.py deleted file mode 100644 index b239ebc00c..0000000000 --- a/aiogram/utils/enum.py +++ /dev/null @@ -1,8 +0,0 @@ -import enum -from typing import Any, List - - -class AutoName(str, enum.Enum): - @staticmethod - def _generate_next_value_(name: str, start: int, count: int, last_values: List[Any]) -> str: - return name.lower() diff --git a/aiogram/utils/helper.py b/aiogram/utils/helper.py deleted file mode 100644 index 97b6f008bb..0000000000 --- a/aiogram/utils/helper.py +++ /dev/null @@ -1,293 +0,0 @@ -""" -Example: - >>> from aiogram.utils.helper import Helper, ListItem, HelperMode, Item - >>> class MyHelper(Helper): - ... mode = HelperMode.lowerCamelCase - ... FOO_ITEM = ListItem() - ... BAR_ITEM = ListItem() - ... BAZ_ITEM = ListItem() - ... LOREM = Item() - ... - >>> print(MyHelper.FOO_ITEM & MyHelper.BAR_ITEM) - <<< ['fooItem', 'barItem'] - >>> print(MyHelper.all()) - <<< ['barItem', 'bazItem', 'fooItem', 'lorem'] -""" -import inspect -from typing import Any, Callable, Generic, Iterable, List, Optional, TypeVar, Union, cast -from weakref import WeakKeyDictionary - -T = TypeVar("T") - -PROPS_KEYS_ATTR_NAME = "_props_keys" - - -class Helper: - mode = "" - - @classmethod - def all(cls) -> List[Any]: - """ - Get all consts - :return: list - """ - result: List[Any] = [] - for name in dir(cls): - if not name.isupper(): - continue - value = getattr(cls, name) - if isinstance(value, ItemsList): - result.append(value[0]) - else: - result.append(value) - return result - - -class HelperMode(Helper): - mode = "original" - - SCREAMING_SNAKE_CASE = "SCREAMING_SNAKE_CASE" - lowerCamelCase = "lowerCamelCase" - CamelCase = "CamelCase" - snake_case = "snake_case" - lowercase = "lowercase" - - @classmethod - def all(cls) -> List[str]: - return [ - cls.SCREAMING_SNAKE_CASE, - cls.lowerCamelCase, - cls.CamelCase, - cls.snake_case, - cls.lowercase, - ] - - @classmethod - def _screaming_snake_case(cls, text: str) -> str: - """ - Transform text to SCREAMING_SNAKE_CASE - - :param text: - :return: - """ - if text.isupper(): - return text - result = "" - for pos, symbol in enumerate(text): - if symbol.isupper() and pos > 0: - result += "_" + symbol - else: - result += symbol.upper() - return result - - @classmethod - def _snake_case(cls, text: str) -> str: - """ - Transform text to snake case (Based on SCREAMING_SNAKE_CASE) - - :param text: - :return: - """ - if text.islower(): - return text - return cls._screaming_snake_case(text).lower() - - @classmethod - def _camel_case(cls, text: str, first_upper: bool = False) -> str: - """ - Transform text to camelCase or CamelCase - - :param text: - :param first_upper: first symbol must be upper? - :return: - """ - result = "" - need_upper = False - for pos, symbol in enumerate(text): - if symbol == "_" and pos > 0: - need_upper = True - else: - if need_upper: - result += symbol.upper() - else: - result += symbol.lower() - need_upper = False - if first_upper: - result = result[0].upper() + result[1:] - return result - - @classmethod - def apply(cls, text: str, mode: Union[str, Callable[[str], str]]) -> str: - """ - Apply mode for text - - :param text: - :param mode: - :return: - """ - if mode == cls.SCREAMING_SNAKE_CASE: - return cls._screaming_snake_case(text) - if mode == cls.snake_case: - return cls._snake_case(text) - if mode == cls.lowercase: - return cls._snake_case(text).replace("_", "") - if mode == cls.lowerCamelCase: - return cls._camel_case(text) - if mode == cls.CamelCase: - return cls._camel_case(text, True) - if callable(mode): - return mode(text) - return text - - -class _BaseItem: - def __init__(self, value: Optional[str] = None): - self._value = cast(str, value) - - def __set_name__(self, owner: Any, name: str) -> None: - if not name.isupper(): - raise NameError("Name for helper item must be in uppercase!") - if not self._value: - if not inspect.isclass(owner) or not issubclass(owner, Helper): - raise RuntimeError("Instances of Item can be used only as Helper attributes") - self._value = HelperMode.apply(name, owner.mode) - - -class Item(_BaseItem): - """ - Helper item - - If a value is not provided, - it will be automatically generated based on a variable's name - """ - - def __get__(self, instance: Any, owner: Any) -> str: - return self._value - - -class ListItem(_BaseItem): - """ - This item is always a list - - You can use &, | and + operators for that. - """ - - def add(self, other: "ListItem") -> "ListItem": # pragma: no cover - return self + other - - def __get__(self, instance: Any, owner: Any) -> "ItemsList": - return ItemsList(self._value) - - def __getitem__(self, item: Any) -> Any: # pragma: no cover - # Only for IDE. This method is never be called. - return self._value - - # Need only for IDE - __iadd__ = __add__ = __rand__ = __and__ = __ror__ = __or__ = add - - -class ItemsList(List[str]): - """ - Patch for default list - - This class provides +, &, |, +=, &=, |= operators for extending the list - """ - - def __init__(self, *seq: Any): - super(ItemsList, self).__init__(map(str, seq)) - - def add(self, other: Iterable[str]) -> "ItemsList": - self.extend(other) - return self - - __iadd__ = __add__ = __rand__ = __and__ = __ror__ = __or__ = add # type: ignore - - -class OrderedHelperMeta(type): - def __new__(mcs, name: Any, bases: Any, namespace: Any, **kwargs: Any) -> "OrderedHelperMeta": - cls = super().__new__(mcs, name, bases, namespace) - - props_keys = [] - - for prop_name in ( - name for name, prop in namespace.items() if isinstance(prop, (Item, ListItem)) - ): - props_keys.append(prop_name) - - setattr(cls, PROPS_KEYS_ATTR_NAME, props_keys) - - return cls - - -class OrderedHelper(Helper, metaclass=OrderedHelperMeta): - mode = "" - - @classmethod - def all(cls) -> List[str]: - """ - Get all Items values - """ - result = [] - for name in getattr(cls, PROPS_KEYS_ATTR_NAME, []): - value = getattr(cls, name) - if isinstance(value, ItemsList): - result.append(value[0]) - else: - result.append(value) - return result - - -class Default(Generic[T]): - """ - Descriptor that holds default value getter - - Example: - >>> class MyClass: - ... att = Default("dflt") - ... - >>> my_instance = MyClass() - >>> my_instance.att = "not dflt" - >>> my_instance.att - 'not dflt' - >>> MyClass.att - 'dflt' - >>> del my_instance.att - >>> my_instance.att - 'dflt' - >>> - - Intended to be used as a class attribute and only internally. - """ - - __slots__ = "fget", "_descriptor_instances" - - def __init__( - self, - default: Optional[T] = None, - *, - fget: Optional[Callable[[Any], T]] = None, - ) -> None: - self.fget = fget or (lambda _: cast(T, default)) - self._descriptor_instances = WeakKeyDictionary() # type: ignore - - def __get__(self, instance: Any, owner: Any) -> T: - if instance is None: - return self.fget(instance) - - return self._descriptor_instances.get(instance, self.fget(instance)) - - def __set__(self, instance: Any, value: T) -> None: - if instance is None or isinstance(instance, type): - raise AttributeError( - "Instance cannot be class or None. Setter must be called from a class." - ) - - self._descriptor_instances[instance] = value - - def __delete__(self, instance: Any) -> None: - if instance is None or isinstance(instance, type): - raise AttributeError( - "Instance cannot be class or None. Deleter must be called from a class." - ) - - self._descriptor_instances.pop(instance, None) diff --git a/aiogram/utils/text_decorations.py b/aiogram/utils/text_decorations.py index 36e4121939..93dc71110a 100644 --- a/aiogram/utils/text_decorations.py +++ b/aiogram/utils/text_decorations.py @@ -5,6 +5,8 @@ from abc import ABC, abstractmethod from typing import TYPE_CHECKING, Generator, List, Optional, Pattern, cast +from aiogram.enums import MessageEntityType + if TYPE_CHECKING: from aiogram.types import MessageEntity @@ -36,25 +38,37 @@ def apply_entity(self, entity: MessageEntity, text: str) -> str: :param text: :return: """ - if entity.type in {"bot_command", "url", "mention", "phone_number"}: + if entity.type in { + MessageEntityType.BOT_COMMAND, + MessageEntityType.URL, + MessageEntityType.MENTION, + MessageEntityType.PHONE_NUMBER, + }: # This entities should not be changed return text - if entity.type in {"bold", "italic", "code", "underline", "strikethrough", "spoiler"}: + if entity.type in { + MessageEntityType.BOLD, + MessageEntityType.ITALIC, + MessageEntityType.CODE, + MessageEntityType.UNDERLINE, + MessageEntityType.STRIKETHROUGH, + MessageEntityType.SPOILER, + }: return cast(str, getattr(self, entity.type)(value=text)) - if entity.type == "pre": + if entity.type == MessageEntityType.PRE: return ( self.pre_language(value=text, language=entity.language) if entity.language else self.pre(value=text) ) - if entity.type == "text_mention": + if entity.type == MessageEntityType.TEXT_MENTION: from aiogram.types import User user = cast(User, entity.user) return self.link(value=text, link=f"tg://user?id={user.id}") - if entity.type == "text_link": + if entity.type == MessageEntityType.TEXT_LINK: return self.link(value=text, link=cast(str, entity.url)) - if entity.type == "custom_emoji": + if entity.type == MessageEntityType.CUSTOM_EMOJI: return self.custom_emoji(value=text, custom_emoji_id=cast(str, entity.custom_emoji_id)) return self.quote(text) diff --git a/docs/api/bot.rst b/docs/api/bot.rst index 3ee89dc27b..215c4b5b8d 100644 --- a/docs/api/bot.rst +++ b/docs/api/bot.rst @@ -15,3 +15,4 @@ For example :code:`sendMessage` named :code:`send_message` and has the same spec :member-order: bysource :special-members: __init__ :undoc-members: True + :noindex: diff --git a/docs/api/enums/bot_command_scope_type.rst b/docs/api/enums/bot_command_scope_type.rst new file mode 100644 index 0000000000..06209bd4f7 --- /dev/null +++ b/docs/api/enums/bot_command_scope_type.rst @@ -0,0 +1,9 @@ +################### +BotCommandScopeType +################### + + +.. automodule:: aiogram.enums.bot_command_scope_type + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/chat_action.rst b/docs/api/enums/chat_action.rst new file mode 100644 index 0000000000..75141b3851 --- /dev/null +++ b/docs/api/enums/chat_action.rst @@ -0,0 +1,9 @@ +########## +ChatAction +########## + + +.. automodule:: aiogram.enums.chat_action + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/chat_member_status.rst b/docs/api/enums/chat_member_status.rst new file mode 100644 index 0000000000..38581606df --- /dev/null +++ b/docs/api/enums/chat_member_status.rst @@ -0,0 +1,9 @@ +################ +ChatMemberStatus +################ + + +.. automodule:: aiogram.enums.chat_member_status + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/index.rst b/docs/api/enums/index.rst index d2cb7041d8..0e208fce90 100644 --- a/docs/api/enums/index.rst +++ b/docs/api/enums/index.rst @@ -1,5 +1,5 @@ ##### -Types +Enums ##### Here is list of all available enums: @@ -8,8 +8,19 @@ Here is list of all available enums: .. toctree:: :maxdepth: 1 + bot_command_scope_type + chat_action + chat_member_status chat_type content_type dice_emoji + inline_query_result_type + input_media_type + mask_position_point + menu_button_type + message_entity_type + parse_mode + poll_type + sticker_type topic_icon_color update_type diff --git a/docs/api/enums/inline_query_result_type.rst b/docs/api/enums/inline_query_result_type.rst new file mode 100644 index 0000000000..51268f5749 --- /dev/null +++ b/docs/api/enums/inline_query_result_type.rst @@ -0,0 +1,9 @@ +##################### +InlineQueryResultType +##################### + + +.. automodule:: aiogram.enums.inline_query_result_type + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/input_media_type.rst b/docs/api/enums/input_media_type.rst new file mode 100644 index 0000000000..7cb3451b33 --- /dev/null +++ b/docs/api/enums/input_media_type.rst @@ -0,0 +1,9 @@ +############## +InputMediaType +############## + + +.. automodule:: aiogram.enums.input_media_type + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/mask_position_point.rst b/docs/api/enums/mask_position_point.rst new file mode 100644 index 0000000000..ba8b43377f --- /dev/null +++ b/docs/api/enums/mask_position_point.rst @@ -0,0 +1,9 @@ +################# +MaskPositionPoint +################# + + +.. automodule:: aiogram.enums.mask_position_point + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/menu_button_type.rst b/docs/api/enums/menu_button_type.rst new file mode 100644 index 0000000000..551e3d7872 --- /dev/null +++ b/docs/api/enums/menu_button_type.rst @@ -0,0 +1,9 @@ +############## +MenuButtonType +############## + + +.. automodule:: aiogram.enums.menu_button_type + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/message_entity_type.rst b/docs/api/enums/message_entity_type.rst new file mode 100644 index 0000000000..66e0656457 --- /dev/null +++ b/docs/api/enums/message_entity_type.rst @@ -0,0 +1,9 @@ +################# +MessageEntityType +################# + + +.. automodule:: aiogram.enums.message_entity_type + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/parse_mode.rst b/docs/api/enums/parse_mode.rst new file mode 100644 index 0000000000..66abbd1c39 --- /dev/null +++ b/docs/api/enums/parse_mode.rst @@ -0,0 +1,9 @@ +######### +ParseMode +######### + + +.. automodule:: aiogram.enums.parse_mode + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/poll_type.rst b/docs/api/enums/poll_type.rst new file mode 100644 index 0000000000..977805cdb8 --- /dev/null +++ b/docs/api/enums/poll_type.rst @@ -0,0 +1,9 @@ +######## +PollType +######## + + +.. automodule:: aiogram.enums.poll_type + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/enums/sticker_type.rst b/docs/api/enums/sticker_type.rst new file mode 100644 index 0000000000..549c1d27f6 --- /dev/null +++ b/docs/api/enums/sticker_type.rst @@ -0,0 +1,9 @@ +########### +StickerType +########### + + +.. automodule:: aiogram.enums.sticker_type + :members: + :member-order: bysource + :undoc-members: True diff --git a/docs/api/methods/answer_callback_query.rst b/docs/api/methods/answer_callback_query.rst index 3dc5096f55..aadbc1fa5e 100644 --- a/docs/api/methods/answer_callback_query.rst +++ b/docs/api/methods/answer_callback_query.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return AnswerCallbackQuery(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.callback_query.CallbackQuery.answer` diff --git a/docs/api/methods/answer_inline_query.rst b/docs/api/methods/answer_inline_query.rst index 193f9fdf7c..79b46888c0 100644 --- a/docs/api/methods/answer_inline_query.rst +++ b/docs/api/methods/answer_inline_query.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return AnswerInlineQuery(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.inline_query.InlineQuery.answer` diff --git a/docs/api/methods/approve_chat_join_request.rst b/docs/api/methods/approve_chat_join_request.rst index 490c1d5b95..0f54f2a8a0 100644 --- a/docs/api/methods/approve_chat_join_request.rst +++ b/docs/api/methods/approve_chat_join_request.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return ApproveChatJoinRequest(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat_join_request.ChatJoinRequest.approve` diff --git a/docs/api/methods/ban_chat_member.rst b/docs/api/methods/ban_chat_member.rst index b5ff4bfe52..a28db5df1a 100644 --- a/docs/api/methods/ban_chat_member.rst +++ b/docs/api/methods/ban_chat_member.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return BanChatMember(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.ban` diff --git a/docs/api/methods/ban_chat_sender_chat.rst b/docs/api/methods/ban_chat_sender_chat.rst index 435fd8b9e7..68b2fba595 100644 --- a/docs/api/methods/ban_chat_sender_chat.rst +++ b/docs/api/methods/ban_chat_sender_chat.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return BanChatSenderChat(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.ban_sender_chat` diff --git a/docs/api/methods/copy_message.rst b/docs/api/methods/copy_message.rst index ac8acb3dad..92edcb1a03 100644 --- a/docs/api/methods/copy_message.rst +++ b/docs/api/methods/copy_message.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return CopyMessage(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.copy_to` diff --git a/docs/api/methods/create_chat_invite_link.rst b/docs/api/methods/create_chat_invite_link.rst index af2a47b53a..1543a40f4d 100644 --- a/docs/api/methods/create_chat_invite_link.rst +++ b/docs/api/methods/create_chat_invite_link.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return CreateChatInviteLink(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.create_invite_link` diff --git a/docs/api/methods/decline_chat_join_request.rst b/docs/api/methods/decline_chat_join_request.rst index a0a82e992a..b0ba4a24b9 100644 --- a/docs/api/methods/decline_chat_join_request.rst +++ b/docs/api/methods/decline_chat_join_request.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return DeclineChatJoinRequest(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat_join_request.ChatJoinRequest.decline` diff --git a/docs/api/methods/delete_chat_photo.rst b/docs/api/methods/delete_chat_photo.rst index b80144d7a2..c218a1c0c4 100644 --- a/docs/api/methods/delete_chat_photo.rst +++ b/docs/api/methods/delete_chat_photo.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return DeleteChatPhoto(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.delete_photo` diff --git a/docs/api/methods/delete_chat_sticker_set.rst b/docs/api/methods/delete_chat_sticker_set.rst index ef06d79dd7..f8472556b6 100644 --- a/docs/api/methods/delete_chat_sticker_set.rst +++ b/docs/api/methods/delete_chat_sticker_set.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return DeleteChatStickerSet(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.delete_sticker_set` diff --git a/docs/api/methods/delete_message.rst b/docs/api/methods/delete_message.rst index 025954a8a2..4e6ee2efc7 100644 --- a/docs/api/methods/delete_message.rst +++ b/docs/api/methods/delete_message.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return DeleteMessage(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.delete` +- :meth:`aiogram.types.chat.Chat.delete_message` diff --git a/docs/api/methods/delete_sticker_from_set.rst b/docs/api/methods/delete_sticker_from_set.rst index a620464d78..f00d3a9dab 100644 --- a/docs/api/methods/delete_sticker_from_set.rst +++ b/docs/api/methods/delete_sticker_from_set.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return DeleteStickerFromSet(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.sticker.Sticker.delete_from_set` diff --git a/docs/api/methods/edit_chat_invite_link.rst b/docs/api/methods/edit_chat_invite_link.rst index c72f1d1012..a1543b3e8c 100644 --- a/docs/api/methods/edit_chat_invite_link.rst +++ b/docs/api/methods/edit_chat_invite_link.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return EditChatInviteLink(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.edit_invite_link` diff --git a/docs/api/methods/edit_message_caption.rst b/docs/api/methods/edit_message_caption.rst index f1a40a4854..cb90bba396 100644 --- a/docs/api/methods/edit_message_caption.rst +++ b/docs/api/methods/edit_message_caption.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return EditMessageCaption(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.edit_caption` diff --git a/docs/api/methods/edit_message_live_location.rst b/docs/api/methods/edit_message_live_location.rst index 3d9ec289be..edeb535369 100644 --- a/docs/api/methods/edit_message_live_location.rst +++ b/docs/api/methods/edit_message_live_location.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return EditMessageLiveLocation(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.edit_live_location` diff --git a/docs/api/methods/edit_message_media.rst b/docs/api/methods/edit_message_media.rst index efd8a3cba1..faa4c6c250 100644 --- a/docs/api/methods/edit_message_media.rst +++ b/docs/api/methods/edit_message_media.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return EditMessageMedia(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.edit_media` diff --git a/docs/api/methods/edit_message_reply_markup.rst b/docs/api/methods/edit_message_reply_markup.rst index 050af021e2..d8db9a2b31 100644 --- a/docs/api/methods/edit_message_reply_markup.rst +++ b/docs/api/methods/edit_message_reply_markup.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return EditMessageReplyMarkup(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.edit_reply_markup` diff --git a/docs/api/methods/edit_message_text.rst b/docs/api/methods/edit_message_text.rst index f75e944e5a..0098e9a1ca 100644 --- a/docs/api/methods/edit_message_text.rst +++ b/docs/api/methods/edit_message_text.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return EditMessageText(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.edit_text` diff --git a/docs/api/methods/export_chat_invite_link.rst b/docs/api/methods/export_chat_invite_link.rst index 90c02f3683..c9bd9945de 100644 --- a/docs/api/methods/export_chat_invite_link.rst +++ b/docs/api/methods/export_chat_invite_link.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return ExportChatInviteLink(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.export_invite_link` diff --git a/docs/api/methods/forward_message.rst b/docs/api/methods/forward_message.rst index 2b02dfdc05..38465cf571 100644 --- a/docs/api/methods/forward_message.rst +++ b/docs/api/methods/forward_message.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return ForwardMessage(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.forward` diff --git a/docs/api/methods/get_chat_administrators.rst b/docs/api/methods/get_chat_administrators.rst index 04f2b41bf8..f56966d254 100644 --- a/docs/api/methods/get_chat_administrators.rst +++ b/docs/api/methods/get_chat_administrators.rst @@ -35,3 +35,11 @@ With specific bot .. code-block:: python result: List[Union[ChatMemberOwner, ChatMemberAdministrator, ChatMemberMember, ChatMemberRestricted, ChatMemberLeft, ChatMemberBanned]] = await bot(GetChatAdministrators(...)) + + + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.get_administrators` diff --git a/docs/api/methods/get_chat_member.rst b/docs/api/methods/get_chat_member.rst index 46ee5c04d4..6155fb24d9 100644 --- a/docs/api/methods/get_chat_member.rst +++ b/docs/api/methods/get_chat_member.rst @@ -35,3 +35,11 @@ With specific bot .. code-block:: python result: Union[ChatMemberOwner, ChatMemberAdministrator, ChatMemberMember, ChatMemberRestricted, ChatMemberLeft, ChatMemberBanned] = await bot(GetChatMember(...)) + + + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.get_member` diff --git a/docs/api/methods/get_chat_member_count.rst b/docs/api/methods/get_chat_member_count.rst index 43858d9253..ec4497b6fa 100644 --- a/docs/api/methods/get_chat_member_count.rst +++ b/docs/api/methods/get_chat_member_count.rst @@ -35,3 +35,11 @@ With specific bot .. code-block:: python result: int = await bot(GetChatMemberCount(...)) + + + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.get_member_count` diff --git a/docs/api/methods/get_chat_members_count.rst b/docs/api/methods/get_chat_members_count.rst deleted file mode 100644 index 1a11da5b61..0000000000 --- a/docs/api/methods/get_chat_members_count.rst +++ /dev/null @@ -1,37 +0,0 @@ -################### -getChatMembersCount -################### - -Returns: :obj:`int` - -.. automodule:: aiogram.methods.get_chat_members_count - :members: - :member-order: bysource - :undoc-members: True - - -Usage -===== - -As bot method -------------- - -.. code-block:: - - result: int = await bot.get_chat_members_count(...) - - -Method as object ----------------- - -Imports: - -- :code:`from aiogram.methods.get_chat_members_count import GetChatMembersCount` -- alias: :code:`from aiogram.methods import GetChatMembersCount` - -With specific bot -~~~~~~~~~~~~~~~~~ - -.. code-block:: python - - result: int = await bot(GetChatMembersCount(...)) diff --git a/docs/api/methods/get_user_profile_photos.rst b/docs/api/methods/get_user_profile_photos.rst index 3ab9fe888a..f0c36a610a 100644 --- a/docs/api/methods/get_user_profile_photos.rst +++ b/docs/api/methods/get_user_profile_photos.rst @@ -35,3 +35,11 @@ With specific bot .. code-block:: python result: UserProfilePhotos = await bot(GetUserProfilePhotos(...)) + + + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.user.User.get_profile_photos` diff --git a/docs/api/methods/kick_chat_member.rst b/docs/api/methods/kick_chat_member.rst deleted file mode 100644 index 5c80b77356..0000000000 --- a/docs/api/methods/kick_chat_member.rst +++ /dev/null @@ -1,44 +0,0 @@ -############## -kickChatMember -############## - -Returns: :obj:`bool` - -.. automodule:: aiogram.methods.kick_chat_member - :members: - :member-order: bysource - :undoc-members: True - - -Usage -===== - -As bot method -------------- - -.. code-block:: - - result: bool = await bot.kick_chat_member(...) - - -Method as object ----------------- - -Imports: - -- :code:`from aiogram.methods.kick_chat_member import KickChatMember` -- alias: :code:`from aiogram.methods import KickChatMember` - -With specific bot -~~~~~~~~~~~~~~~~~ - -.. code-block:: python - - result: bool = await bot(KickChatMember(...)) - -As reply into Webhook in handler -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: python - - return KickChatMember(...) diff --git a/docs/api/methods/leave_chat.rst b/docs/api/methods/leave_chat.rst index c88ee52027..8c84e324f2 100644 --- a/docs/api/methods/leave_chat.rst +++ b/docs/api/methods/leave_chat.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return LeaveChat(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.leave` diff --git a/docs/api/methods/pin_chat_message.rst b/docs/api/methods/pin_chat_message.rst index ec73027887..11de4e5372 100644 --- a/docs/api/methods/pin_chat_message.rst +++ b/docs/api/methods/pin_chat_message.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return PinChatMessage(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.pin` +- :meth:`aiogram.types.chat.Chat.pin_message` diff --git a/docs/api/methods/promote_chat_member.rst b/docs/api/methods/promote_chat_member.rst index e3081d97ef..aada3f0581 100644 --- a/docs/api/methods/promote_chat_member.rst +++ b/docs/api/methods/promote_chat_member.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return PromoteChatMember(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.promote` diff --git a/docs/api/methods/restrict_chat_member.rst b/docs/api/methods/restrict_chat_member.rst index 0cf2a5aff5..b063b8b1ab 100644 --- a/docs/api/methods/restrict_chat_member.rst +++ b/docs/api/methods/restrict_chat_member.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return RestrictChatMember(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.restrict` diff --git a/docs/api/methods/revoke_chat_invite_link.rst b/docs/api/methods/revoke_chat_invite_link.rst index d643c9017e..f8293be2fa 100644 --- a/docs/api/methods/revoke_chat_invite_link.rst +++ b/docs/api/methods/revoke_chat_invite_link.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return RevokeChatInviteLink(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.revoke_invite_link` diff --git a/docs/api/methods/send_animation.rst b/docs/api/methods/send_animation.rst index 4372fc3335..220bf5baa1 100644 --- a/docs/api/methods/send_animation.rst +++ b/docs/api/methods/send_animation.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendAnimation(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_animation` +- :meth:`aiogram.types.message.Message.reply_animation` diff --git a/docs/api/methods/send_audio.rst b/docs/api/methods/send_audio.rst index 8aa40c8f76..877478bac8 100644 --- a/docs/api/methods/send_audio.rst +++ b/docs/api/methods/send_audio.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendAudio(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_audio` +- :meth:`aiogram.types.message.Message.reply_audio` diff --git a/docs/api/methods/send_chat_action.rst b/docs/api/methods/send_chat_action.rst index 7a3100bdc2..c1ad9e616d 100644 --- a/docs/api/methods/send_chat_action.rst +++ b/docs/api/methods/send_chat_action.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return SendChatAction(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.do` diff --git a/docs/api/methods/send_contact.rst b/docs/api/methods/send_contact.rst index ce5760072e..05af5b1ef0 100644 --- a/docs/api/methods/send_contact.rst +++ b/docs/api/methods/send_contact.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendContact(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_contact` +- :meth:`aiogram.types.message.Message.reply_contact` diff --git a/docs/api/methods/send_dice.rst b/docs/api/methods/send_dice.rst index dbb0fd0526..5e1548f7d8 100644 --- a/docs/api/methods/send_dice.rst +++ b/docs/api/methods/send_dice.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendDice(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_dice` +- :meth:`aiogram.types.message.Message.reply_dice` diff --git a/docs/api/methods/send_document.rst b/docs/api/methods/send_document.rst index 1fb86b4e49..60d9d0b061 100644 --- a/docs/api/methods/send_document.rst +++ b/docs/api/methods/send_document.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendDocument(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_document` +- :meth:`aiogram.types.message.Message.reply_document` diff --git a/docs/api/methods/send_game.rst b/docs/api/methods/send_game.rst index 21cc7a8a6a..d145c4303c 100644 --- a/docs/api/methods/send_game.rst +++ b/docs/api/methods/send_game.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendGame(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_game` +- :meth:`aiogram.types.message.Message.reply_game` diff --git a/docs/api/methods/send_invoice.rst b/docs/api/methods/send_invoice.rst index e7fa090401..1e5ce258b8 100644 --- a/docs/api/methods/send_invoice.rst +++ b/docs/api/methods/send_invoice.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendInvoice(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_invoice` +- :meth:`aiogram.types.message.Message.reply_invoice` diff --git a/docs/api/methods/send_location.rst b/docs/api/methods/send_location.rst index d4dbfeb2fb..3c52df7572 100644 --- a/docs/api/methods/send_location.rst +++ b/docs/api/methods/send_location.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendLocation(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_location` +- :meth:`aiogram.types.message.Message.reply_location` diff --git a/docs/api/methods/send_media_group.rst b/docs/api/methods/send_media_group.rst index b57701d7c0..fe0f8e03b1 100644 --- a/docs/api/methods/send_media_group.rst +++ b/docs/api/methods/send_media_group.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendMediaGroup(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_media_group` +- :meth:`aiogram.types.message.Message.reply_media_group` diff --git a/docs/api/methods/send_message.rst b/docs/api/methods/send_message.rst index 4f72f1639d..9edb4bf3f7 100644 --- a/docs/api/methods/send_message.rst +++ b/docs/api/methods/send_message.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendMessage(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer` +- :meth:`aiogram.types.message.Message.reply` diff --git a/docs/api/methods/send_photo.rst b/docs/api/methods/send_photo.rst index 38d54218e1..85fb092197 100644 --- a/docs/api/methods/send_photo.rst +++ b/docs/api/methods/send_photo.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendPhoto(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_photo` +- :meth:`aiogram.types.message.Message.reply_photo` diff --git a/docs/api/methods/send_poll.rst b/docs/api/methods/send_poll.rst index 29e0a791f7..14e10d190c 100644 --- a/docs/api/methods/send_poll.rst +++ b/docs/api/methods/send_poll.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendPoll(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_poll` +- :meth:`aiogram.types.message.Message.reply_poll` diff --git a/docs/api/methods/send_sticker.rst b/docs/api/methods/send_sticker.rst index 4a1212e8f8..395fb12b99 100644 --- a/docs/api/methods/send_sticker.rst +++ b/docs/api/methods/send_sticker.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendSticker(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_sticker` +- :meth:`aiogram.types.message.Message.reply_sticker` diff --git a/docs/api/methods/send_venue.rst b/docs/api/methods/send_venue.rst index 5a8e0d3cdf..4985cbc1c4 100644 --- a/docs/api/methods/send_venue.rst +++ b/docs/api/methods/send_venue.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendVenue(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_venue` +- :meth:`aiogram.types.message.Message.reply_venue` diff --git a/docs/api/methods/send_video.rst b/docs/api/methods/send_video.rst index 2ee8a3dda7..a8e6e1b43f 100644 --- a/docs/api/methods/send_video.rst +++ b/docs/api/methods/send_video.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendVideo(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_video` +- :meth:`aiogram.types.message.Message.reply_video` diff --git a/docs/api/methods/send_video_note.rst b/docs/api/methods/send_video_note.rst index d53d91e006..aa27c198fb 100644 --- a/docs/api/methods/send_video_note.rst +++ b/docs/api/methods/send_video_note.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendVideoNote(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_video_note` +- :meth:`aiogram.types.message.Message.reply_video_note` diff --git a/docs/api/methods/send_voice.rst b/docs/api/methods/send_voice.rst index 397a4e75fe..3742cdb3b0 100644 --- a/docs/api/methods/send_voice.rst +++ b/docs/api/methods/send_voice.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return SendVoice(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.answer_voice` +- :meth:`aiogram.types.message.Message.reply_voice` diff --git a/docs/api/methods/set_chat_administrator_custom_title.rst b/docs/api/methods/set_chat_administrator_custom_title.rst index 7b3deaf04f..60d8df84ee 100644 --- a/docs/api/methods/set_chat_administrator_custom_title.rst +++ b/docs/api/methods/set_chat_administrator_custom_title.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return SetChatAdministratorCustomTitle(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.set_administrator_custom_title` diff --git a/docs/api/methods/set_chat_description.rst b/docs/api/methods/set_chat_description.rst index 2cb8f08e19..85cd7d4863 100644 --- a/docs/api/methods/set_chat_description.rst +++ b/docs/api/methods/set_chat_description.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return SetChatDescription(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.set_description` diff --git a/docs/api/methods/set_chat_permissions.rst b/docs/api/methods/set_chat_permissions.rst index 8e546011df..7867065ce6 100644 --- a/docs/api/methods/set_chat_permissions.rst +++ b/docs/api/methods/set_chat_permissions.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return SetChatPermissions(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.set_permissions` diff --git a/docs/api/methods/set_chat_photo.rst b/docs/api/methods/set_chat_photo.rst index 99ff36c273..ee7434f9ce 100644 --- a/docs/api/methods/set_chat_photo.rst +++ b/docs/api/methods/set_chat_photo.rst @@ -35,3 +35,11 @@ With specific bot .. code-block:: python result: bool = await bot(SetChatPhoto(...)) + + + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.set_photo` diff --git a/docs/api/methods/set_chat_sticker_set.rst b/docs/api/methods/set_chat_sticker_set.rst index a7cfcea18f..eccd0da356 100644 --- a/docs/api/methods/set_chat_sticker_set.rst +++ b/docs/api/methods/set_chat_sticker_set.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return SetChatStickerSet(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.set_sticker_set` diff --git a/docs/api/methods/set_chat_title.rst b/docs/api/methods/set_chat_title.rst index 739b817d68..ffac0b6e43 100644 --- a/docs/api/methods/set_chat_title.rst +++ b/docs/api/methods/set_chat_title.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return SetChatTitle(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.set_title` diff --git a/docs/api/methods/set_sticker_position_in_set.rst b/docs/api/methods/set_sticker_position_in_set.rst index 168dbe9c78..04a8a9cf52 100644 --- a/docs/api/methods/set_sticker_position_in_set.rst +++ b/docs/api/methods/set_sticker_position_in_set.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return SetStickerPositionInSet(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.sticker.Sticker.set_position_in_set` diff --git a/docs/api/methods/stop_message_live_location.rst b/docs/api/methods/stop_message_live_location.rst index 1ef6440abb..74f105d1eb 100644 --- a/docs/api/methods/stop_message_live_location.rst +++ b/docs/api/methods/stop_message_live_location.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return StopMessageLiveLocation(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.stop_live_location` diff --git a/docs/api/methods/unban_chat_member.rst b/docs/api/methods/unban_chat_member.rst index fef8e7fed1..0b588b7020 100644 --- a/docs/api/methods/unban_chat_member.rst +++ b/docs/api/methods/unban_chat_member.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return UnbanChatMember(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.unban` diff --git a/docs/api/methods/unban_chat_sender_chat.rst b/docs/api/methods/unban_chat_sender_chat.rst index c694503b5b..1fdfd5a3c7 100644 --- a/docs/api/methods/unban_chat_sender_chat.rst +++ b/docs/api/methods/unban_chat_sender_chat.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return UnbanChatSenderChat(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.unban_sender_chat` diff --git a/docs/api/methods/unpin_all_chat_messages.rst b/docs/api/methods/unpin_all_chat_messages.rst index 4421245efc..854091e59b 100644 --- a/docs/api/methods/unpin_all_chat_messages.rst +++ b/docs/api/methods/unpin_all_chat_messages.rst @@ -42,3 +42,9 @@ As reply into Webhook in handler .. code-block:: python return UnpinAllChatMessages(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.chat.Chat.unpin_all_messages` diff --git a/docs/api/methods/unpin_chat_message.rst b/docs/api/methods/unpin_chat_message.rst index 1531ec1956..9a03c08b1f 100644 --- a/docs/api/methods/unpin_chat_message.rst +++ b/docs/api/methods/unpin_chat_message.rst @@ -42,3 +42,10 @@ As reply into Webhook in handler .. code-block:: python return UnpinChatMessage(...) + + +As shortcut from received object +-------------------------------- + +- :meth:`aiogram.types.message.Message.unpin` +- :meth:`aiogram.types.chat.Chat.unpin_message` diff --git a/docs/api/types/index.rst b/docs/api/types/index.rst index d3de3be6f5..a561506227 100644 --- a/docs/api/types/index.rst +++ b/docs/api/types/index.rst @@ -190,3 +190,11 @@ Games callback_game game game_high_score + +Internals +========= + +.. toctree:: + :maxdepth: 1 + + error_event diff --git a/docs/locale/en/LC_MESSAGES/api/bot.po b/docs/locale/en/LC_MESSAGES/api/bot.po index 28acf6605c..8c5c3fc920 100644 --- a/docs/locale/en/LC_MESSAGES/api/bot.po +++ b/docs/locale/en/LC_MESSAGES/api/bot.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -86,7 +86,6 @@ msgstr "" #: aiogram.client.bot.Bot.get_chat_administrators #: aiogram.client.bot.Bot.get_chat_member #: aiogram.client.bot.Bot.get_chat_member_count -#: aiogram.client.bot.Bot.get_chat_members_count #: aiogram.client.bot.Bot.get_chat_menu_button #: aiogram.client.bot.Bot.get_custom_emoji_stickers #: aiogram.client.bot.Bot.get_file @@ -96,8 +95,7 @@ msgstr "" #: aiogram.client.bot.Bot.get_my_default_administrator_rights #: aiogram.client.bot.Bot.get_sticker_set aiogram.client.bot.Bot.get_updates #: aiogram.client.bot.Bot.get_user_profile_photos -#: aiogram.client.bot.Bot.get_webhook_info -#: aiogram.client.bot.Bot.kick_chat_member aiogram.client.bot.Bot.leave_chat +#: aiogram.client.bot.Bot.get_webhook_info aiogram.client.bot.Bot.leave_chat #: aiogram.client.bot.Bot.log_out aiogram.client.bot.Bot.pin_chat_message #: aiogram.client.bot.Bot.promote_chat_member #: aiogram.client.bot.Bot.reopen_forum_topic @@ -198,7 +196,6 @@ msgstr "" #: aiogram.client.bot.Bot.get_chat_administrators #: aiogram.client.bot.Bot.get_chat_member #: aiogram.client.bot.Bot.get_chat_member_count -#: aiogram.client.bot.Bot.get_chat_members_count #: aiogram.client.bot.Bot.get_chat_menu_button #: aiogram.client.bot.Bot.get_custom_emoji_stickers #: aiogram.client.bot.Bot.get_file @@ -209,8 +206,8 @@ msgstr "" #: aiogram.client.bot.Bot.get_sticker_set aiogram.client.bot.Bot.get_updates #: aiogram.client.bot.Bot.get_user_profile_photos #: aiogram.client.bot.Bot.get_webhook_info aiogram.client.bot.Bot.id -#: aiogram.client.bot.Bot.kick_chat_member aiogram.client.bot.Bot.leave_chat -#: aiogram.client.bot.Bot.log_out aiogram.client.bot.Bot.pin_chat_message +#: aiogram.client.bot.Bot.leave_chat aiogram.client.bot.Bot.log_out +#: aiogram.client.bot.Bot.pin_chat_message #: aiogram.client.bot.Bot.promote_chat_member #: aiogram.client.bot.Bot.reopen_forum_topic #: aiogram.client.bot.Bot.restrict_chat_member @@ -296,562 +293,546 @@ msgstr "" msgid "file_id or Downloadable object" msgstr "" -#: aiogram.client.bot.Bot.get_updates:1 of +#: aiogram.client.bot.Bot.add_sticker_to_set:1 of msgid "" -"Use this method to receive incoming updates using long polling (`wiki " -"`_). Returns " -"an Array of :class:`aiogram.types.update.Update` objects." -msgstr "" - -#: aiogram.client.bot.Bot.get_updates:3 aiogram.client.bot.Bot.set_webhook:4 of -msgid "**Notes**" +"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 "" -#: aiogram.client.bot.Bot.get_updates:5 of -msgid "**1.** This method will not work if an outgoing webhook is set up." +#: aiogram.client.bot.Bot.add_sticker_to_set:3 of +msgid "User identifier of sticker set owner" msgstr "" -#: aiogram.client.bot.Bot.get_updates:7 of -msgid "" -"**2.** In order to avoid getting duplicate updates, recalculate *offset* " -"after each server response." +#: aiogram.client.bot.Bot.add_sticker_to_set:4 +#: aiogram.client.bot.Bot.set_sticker_set_thumb:3 of +msgid "Sticker set name" msgstr "" -#: aiogram.client.bot.Bot.get_updates:9 of -msgid "Source: https://core.telegram.org/bots/api#getupdates" +#: aiogram.client.bot.Bot.add_sticker_to_set:5 +#: aiogram.client.bot.Bot.create_new_sticker_set:6 of +msgid "One or more emoji corresponding to the sticker" msgstr "" -#: aiogram.client.bot.Bot.get_updates:11 of +#: aiogram.client.bot.Bot.add_sticker_to_set:6 +#: aiogram.client.bot.Bot.create_new_sticker_set:7 of msgid "" -"Identifier of the first update to be returned. Must be greater by one " -"than the highest among the identifiers of previously received updates. By" -" default, updates starting with the earliest unconfirmed update are " -"returned. An update is considered confirmed as soon as " -":class:`aiogram.methods.get_updates.GetUpdates` is called with an " -"*offset* higher than its *update_id*. The negative offset can be " -"specified to retrieve updates starting from *-offset* update from the end" -" of the updates queue. All previous updates will forgotten." +"**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 "" -#: aiogram.client.bot.Bot.get_updates:12 of +#: aiogram.client.bot.Bot.add_sticker_to_set:7 +#: aiogram.client.bot.Bot.create_new_sticker_set:8 of msgid "" -"Limits the number of updates to be retrieved. Values between 1-100 are " -"accepted. Defaults to 100." +"**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 "" -#: aiogram.client.bot.Bot.get_updates:13 of +#: aiogram.client.bot.Bot.add_sticker_to_set:8 +#: aiogram.client.bot.Bot.create_new_sticker_set:9 of msgid "" -"Timeout in seconds for long polling. Defaults to 0, i.e. usual short " -"polling. Should be positive, short polling should be used for testing " -"purposes only." +"**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 "" -#: aiogram.client.bot.Bot.get_updates:14 aiogram.client.bot.Bot.set_webhook:19 -#: of +#: aiogram.client.bot.Bot.add_sticker_to_set:9 +#: aiogram.client.bot.Bot.create_new_sticker_set:11 of msgid "" -"A JSON-serialized list of the update types you want your bot to receive. " -"For example, specify ['message', 'edited_channel_post', 'callback_query']" -" to only receive updates of these types. See " -":class:`aiogram.types.update.Update` for a complete list of available " -"update types. Specify an empty list to receive all update types except " -"*chat_member* (default). If not specified, the previous setting will be " -"used." +"A JSON-serialized object for position where the mask should be placed on " +"faces" msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:12 -#: aiogram.client.bot.Bot.answer_callback_query:12 -#: aiogram.client.bot.Bot.answer_inline_query:14 -#: aiogram.client.bot.Bot.answer_pre_checkout_query:8 -#: aiogram.client.bot.Bot.answer_shipping_query:9 -#: aiogram.client.bot.Bot.answer_web_app_query:7 -#: aiogram.client.bot.Bot.approve_chat_join_request:7 -#: aiogram.client.bot.Bot.ban_chat_member:9 -#: aiogram.client.bot.Bot.ban_chat_sender_chat:7 aiogram.client.bot.Bot.close:5 -#: aiogram.client.bot.Bot.close_forum_topic:7 -#: aiogram.client.bot.Bot.copy_message:17 -#: aiogram.client.bot.Bot.create_chat_invite_link:10 -#: aiogram.client.bot.Bot.create_forum_topic:9 -#: aiogram.client.bot.Bot.create_invoice_link:25 -#: aiogram.client.bot.Bot.create_new_sticker_set:14 -#: aiogram.client.bot.Bot.decline_chat_join_request:7 -#: aiogram.client.bot.Bot.delete_chat_photo:6 -#: aiogram.client.bot.Bot.delete_chat_sticker_set:6 -#: aiogram.client.bot.Bot.delete_forum_topic:7 -#: aiogram.client.bot.Bot.delete_message:25 -#: aiogram.client.bot.Bot.delete_my_commands:7 -#: aiogram.client.bot.Bot.delete_sticker_from_set:6 -#: aiogram.client.bot.Bot.delete_webhook:6 -#: aiogram.client.bot.Bot.edit_chat_invite_link:11 -#: aiogram.client.bot.Bot.edit_forum_topic:9 -#: aiogram.client.bot.Bot.edit_message_caption:12 -#: aiogram.client.bot.Bot.edit_message_live_location:14 -#: aiogram.client.bot.Bot.edit_message_media:10 -#: aiogram.client.bot.Bot.edit_message_reply_markup:9 -#: aiogram.client.bot.Bot.edit_message_text:13 -#: aiogram.client.bot.Bot.export_chat_invite_link:8 -#: aiogram.client.bot.Bot.forward_message:11 aiogram.client.bot.Bot.get_chat:6 -#: aiogram.client.bot.Bot.get_chat_administrators:6 -#: aiogram.client.bot.Bot.get_chat_member:7 -#: aiogram.client.bot.Bot.get_chat_member_count:6 -#: aiogram.client.bot.Bot.get_chat_members_count:10 -#: aiogram.client.bot.Bot.get_chat_menu_button:6 -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:6 -#: aiogram.client.bot.Bot.get_file:7 -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:5 -#: aiogram.client.bot.Bot.get_game_high_scores:11 -#: aiogram.client.bot.Bot.get_me:5 aiogram.client.bot.Bot.get_my_commands:7 -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:6 -#: aiogram.client.bot.Bot.get_sticker_set:6 -#: aiogram.client.bot.Bot.get_updates:15 -#: aiogram.client.bot.Bot.get_user_profile_photos:8 -#: aiogram.client.bot.Bot.get_webhook_info:5 -#: aiogram.client.bot.Bot.kick_chat_member:13 -#: aiogram.client.bot.Bot.leave_chat:6 aiogram.client.bot.Bot.log_out:5 -#: aiogram.client.bot.Bot.pin_chat_message:8 -#: aiogram.client.bot.Bot.promote_chat_member:19 -#: aiogram.client.bot.Bot.reopen_forum_topic:7 -#: aiogram.client.bot.Bot.restrict_chat_member:9 -#: aiogram.client.bot.Bot.revoke_chat_invite_link:7 -#: aiogram.client.bot.Bot.send_animation:20 -#: aiogram.client.bot.Bot.send_audio:21 -#: aiogram.client.bot.Bot.send_chat_action:11 -#: aiogram.client.bot.Bot.send_contact:16 aiogram.client.bot.Bot.send_dice:13 -#: aiogram.client.bot.Bot.send_document:18 aiogram.client.bot.Bot.send_game:13 -#: aiogram.client.bot.Bot.send_invoice:33 -#: aiogram.client.bot.Bot.send_location:18 -#: aiogram.client.bot.Bot.send_media_group:12 -#: aiogram.client.bot.Bot.send_message:16 aiogram.client.bot.Bot.send_photo:16 -#: aiogram.client.bot.Bot.send_poll:24 aiogram.client.bot.Bot.send_sticker:13 -#: aiogram.client.bot.Bot.send_venue:20 aiogram.client.bot.Bot.send_video:21 -#: aiogram.client.bot.Bot.send_video_note:16 -#: aiogram.client.bot.Bot.send_voice:17 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:8 -#: aiogram.client.bot.Bot.set_chat_description:7 -#: aiogram.client.bot.Bot.set_chat_menu_button:7 -#: aiogram.client.bot.Bot.set_chat_permissions:7 -#: aiogram.client.bot.Bot.set_chat_photo:7 -#: aiogram.client.bot.Bot.set_chat_sticker_set:7 -#: aiogram.client.bot.Bot.set_chat_title:7 -#: aiogram.client.bot.Bot.set_game_score:12 -#: aiogram.client.bot.Bot.set_my_commands:8 -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:7 -#: aiogram.client.bot.Bot.set_passport_data_errors:8 -#: aiogram.client.bot.Bot.set_sticker_position_in_set:7 -#: aiogram.client.bot.Bot.set_sticker_set_thumb:8 -#: aiogram.client.bot.Bot.set_webhook:22 -#: aiogram.client.bot.Bot.stop_message_live_location:9 -#: aiogram.client.bot.Bot.stop_poll:8 -#: aiogram.client.bot.Bot.unban_chat_member:8 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:7 -#: aiogram.client.bot.Bot.unpin_all_chat_messages:6 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:7 -#: aiogram.client.bot.Bot.unpin_chat_message:7 -#: aiogram.client.bot.Bot.upload_sticker_file:7 of +#: aiogram.client.bot.Bot.add_sticker_to_set:10 +#: aiogram.client.bot.Bot.answer_callback_query:10 +#: aiogram.client.bot.Bot.answer_inline_query:12 +#: aiogram.client.bot.Bot.answer_pre_checkout_query:6 +#: aiogram.client.bot.Bot.answer_shipping_query:7 +#: aiogram.client.bot.Bot.answer_web_app_query:5 +#: aiogram.client.bot.Bot.approve_chat_join_request:5 +#: aiogram.client.bot.Bot.ban_chat_member:7 +#: aiogram.client.bot.Bot.ban_chat_sender_chat:5 aiogram.client.bot.Bot.close:3 +#: aiogram.client.bot.Bot.close_forum_topic:5 +#: aiogram.client.bot.Bot.copy_message:15 +#: aiogram.client.bot.Bot.create_chat_invite_link:8 +#: aiogram.client.bot.Bot.create_forum_topic:7 +#: aiogram.client.bot.Bot.create_invoice_link:23 +#: aiogram.client.bot.Bot.create_new_sticker_set:12 +#: aiogram.client.bot.Bot.decline_chat_join_request:5 +#: aiogram.client.bot.Bot.delete_chat_photo:4 +#: aiogram.client.bot.Bot.delete_chat_sticker_set:4 +#: aiogram.client.bot.Bot.delete_forum_topic:5 +#: aiogram.client.bot.Bot.delete_message:23 +#: aiogram.client.bot.Bot.delete_my_commands:5 +#: aiogram.client.bot.Bot.delete_sticker_from_set:4 +#: aiogram.client.bot.Bot.delete_webhook:4 +#: aiogram.client.bot.Bot.edit_chat_invite_link:9 +#: aiogram.client.bot.Bot.edit_forum_topic:7 +#: aiogram.client.bot.Bot.edit_message_caption:10 +#: aiogram.client.bot.Bot.edit_message_live_location:12 +#: aiogram.client.bot.Bot.edit_message_media:8 +#: aiogram.client.bot.Bot.edit_message_reply_markup:7 +#: aiogram.client.bot.Bot.edit_message_text:11 +#: aiogram.client.bot.Bot.export_chat_invite_link:6 +#: aiogram.client.bot.Bot.forward_message:9 aiogram.client.bot.Bot.get_chat:4 +#: aiogram.client.bot.Bot.get_chat_administrators:4 +#: aiogram.client.bot.Bot.get_chat_member:5 +#: aiogram.client.bot.Bot.get_chat_member_count:4 +#: aiogram.client.bot.Bot.get_chat_menu_button:4 +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:4 +#: aiogram.client.bot.Bot.get_file:5 +#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:3 +#: aiogram.client.bot.Bot.get_game_high_scores:9 +#: aiogram.client.bot.Bot.get_me:3 aiogram.client.bot.Bot.get_my_commands:5 +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:4 +#: aiogram.client.bot.Bot.get_sticker_set:4 +#: aiogram.client.bot.Bot.get_updates:13 +#: aiogram.client.bot.Bot.get_user_profile_photos:6 +#: aiogram.client.bot.Bot.get_webhook_info:3 +#: aiogram.client.bot.Bot.leave_chat:4 aiogram.client.bot.Bot.log_out:3 +#: aiogram.client.bot.Bot.pin_chat_message:6 +#: aiogram.client.bot.Bot.promote_chat_member:17 +#: aiogram.client.bot.Bot.reopen_forum_topic:5 +#: aiogram.client.bot.Bot.restrict_chat_member:7 +#: aiogram.client.bot.Bot.revoke_chat_invite_link:5 +#: aiogram.client.bot.Bot.send_animation:18 +#: aiogram.client.bot.Bot.send_audio:19 +#: aiogram.client.bot.Bot.send_chat_action:9 +#: aiogram.client.bot.Bot.send_contact:14 aiogram.client.bot.Bot.send_dice:11 +#: aiogram.client.bot.Bot.send_document:16 aiogram.client.bot.Bot.send_game:11 +#: aiogram.client.bot.Bot.send_invoice:31 +#: aiogram.client.bot.Bot.send_location:16 +#: aiogram.client.bot.Bot.send_media_group:10 +#: aiogram.client.bot.Bot.send_message:14 aiogram.client.bot.Bot.send_photo:14 +#: aiogram.client.bot.Bot.send_poll:22 aiogram.client.bot.Bot.send_sticker:11 +#: aiogram.client.bot.Bot.send_venue:18 aiogram.client.bot.Bot.send_video:19 +#: aiogram.client.bot.Bot.send_video_note:14 +#: aiogram.client.bot.Bot.send_voice:15 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:6 +#: aiogram.client.bot.Bot.set_chat_description:5 +#: aiogram.client.bot.Bot.set_chat_menu_button:5 +#: aiogram.client.bot.Bot.set_chat_permissions:5 +#: aiogram.client.bot.Bot.set_chat_photo:5 +#: aiogram.client.bot.Bot.set_chat_sticker_set:5 +#: aiogram.client.bot.Bot.set_chat_title:5 +#: aiogram.client.bot.Bot.set_game_score:10 +#: aiogram.client.bot.Bot.set_my_commands:6 +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:5 +#: aiogram.client.bot.Bot.set_passport_data_errors:6 +#: aiogram.client.bot.Bot.set_sticker_position_in_set:5 +#: aiogram.client.bot.Bot.set_sticker_set_thumb:6 +#: aiogram.client.bot.Bot.set_webhook:20 +#: aiogram.client.bot.Bot.stop_message_live_location:7 +#: aiogram.client.bot.Bot.stop_poll:6 +#: aiogram.client.bot.Bot.unban_chat_member:6 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:5 +#: aiogram.client.bot.Bot.unpin_all_chat_messages:4 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:5 +#: aiogram.client.bot.Bot.unpin_chat_message:5 +#: aiogram.client.bot.Bot.upload_sticker_file:5 of msgid "Request timeout" msgstr "" -#: aiogram.client.bot.Bot.get_updates:16 of -msgid "Returns an Array of Update objects." +#: aiogram.client.bot.Bot.add_sticker_to_set:11 +#: aiogram.client.bot.Bot.approve_chat_join_request:6 +#: aiogram.client.bot.Bot.ban_chat_member:8 +#: aiogram.client.bot.Bot.ban_chat_sender_chat:6 +#: aiogram.client.bot.Bot.close_forum_topic:6 +#: aiogram.client.bot.Bot.create_new_sticker_set:13 +#: aiogram.client.bot.Bot.decline_chat_join_request:6 +#: aiogram.client.bot.Bot.delete_chat_photo:5 +#: aiogram.client.bot.Bot.delete_chat_sticker_set:5 +#: aiogram.client.bot.Bot.delete_forum_topic:6 +#: aiogram.client.bot.Bot.delete_message:19 +#: aiogram.client.bot.Bot.delete_my_commands:6 +#: aiogram.client.bot.Bot.delete_sticker_from_set:5 +#: aiogram.client.bot.Bot.delete_webhook:5 +#: aiogram.client.bot.Bot.edit_forum_topic:8 +#: aiogram.client.bot.Bot.leave_chat:5 +#: aiogram.client.bot.Bot.pin_chat_message:7 +#: aiogram.client.bot.Bot.promote_chat_member:18 +#: aiogram.client.bot.Bot.reopen_forum_topic:6 +#: aiogram.client.bot.Bot.restrict_chat_member:8 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:7 +#: aiogram.client.bot.Bot.set_chat_description:6 +#: aiogram.client.bot.Bot.set_chat_menu_button:6 +#: aiogram.client.bot.Bot.set_chat_permissions:6 +#: aiogram.client.bot.Bot.set_chat_photo:6 +#: aiogram.client.bot.Bot.set_chat_sticker_set:6 +#: aiogram.client.bot.Bot.set_chat_title:6 +#: aiogram.client.bot.Bot.set_my_commands:7 +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:6 +#: aiogram.client.bot.Bot.set_sticker_position_in_set:6 +#: aiogram.client.bot.Bot.set_sticker_set_thumb:7 +#: aiogram.client.bot.Bot.unban_chat_member:7 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:6 +#: aiogram.client.bot.Bot.unpin_all_chat_messages:5 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:6 +#: aiogram.client.bot.Bot.unpin_chat_message:6 of +msgid "Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:1 of +#: aiogram.client.bot.Bot.answer_callback_query:1 of msgid "" -"Use this method to specify a URL and receive incoming updates via an " -"outgoing webhook. Whenever there is an update for the bot, we will send " -"an HTTPS POST request to the specified URL, containing a JSON-serialized " -":class:`aiogram.types.update.Update`. In case of an unsuccessful request," -" we will give up after a reasonable amount of attempts. Returns " -":code:`True` on success. If you'd like to make sure that the webhook was " -"set by you, you can specify secret data in the parameter *secret_token*. " -"If specified, the request will contain a header 'X-Telegram-Bot-Api-" -"Secret-Token' with the secret token as content." +"Use this method to send answers to callback queries sent from `inline " +"keyboards `_. " +"The answer will be displayed to the user as a notification at the top of " +"the chat screen or as an alert. On success, :code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:6 of +#: aiogram.client.bot.Bot.answer_callback_query:3 of msgid "" -"**1.** You will not be able to receive updates using " -":class:`aiogram.methods.get_updates.GetUpdates` for as long as an " -"outgoing webhook is set up." +"Alternatively, the user can be redirected to the specified Game URL. For " +"this option to work, you must first create a game for your bot via " +"`@BotFather `_ and accept the terms. Otherwise, " +"you may use links like :code:`t.me/your_bot?start=XXXX` that open your " +"bot with a parameter." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:8 of -msgid "" -"**2.** To use a self-signed certificate, you need to upload your `public " -"key certificate `_ using " -"*certificate* parameter. Please upload as InputFile, sending a String " -"will not work." +#: aiogram.client.bot.Bot.answer_callback_query:5 +#: aiogram.client.bot.Bot.answer_pre_checkout_query:3 +#: aiogram.client.bot.Bot.answer_shipping_query:3 +#: aiogram.client.bot.Bot.answer_web_app_query:3 of +msgid "Unique identifier for the query to be answered" msgstr "" -#: aiogram.client.bot.Bot.set_webhook:10 of +#: aiogram.client.bot.Bot.answer_callback_query:6 of msgid "" -"**3.** Ports currently supported *for webhooks*: **443, 80, 88, 8443**. " -"If you're having any trouble setting up webhooks, please check out this " -"`amazing guide to webhooks `_." -msgstr "" - -#: aiogram.client.bot.Bot.set_webhook:13 of -msgid "Source: https://core.telegram.org/bots/api#setwebhook" +"Text of the notification. If not specified, nothing will be shown to the " +"user, 0-200 characters" msgstr "" -#: aiogram.client.bot.Bot.set_webhook:15 of +#: aiogram.client.bot.Bot.answer_callback_query:7 of msgid "" -"HTTPS URL to send updates to. Use an empty string to remove webhook " -"integration" +"If :code:`True`, an alert will be shown by the client instead of a " +"notification at the top of the chat screen. Defaults to *false*." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:16 of +#: aiogram.client.bot.Bot.answer_callback_query:8 of msgid "" -"Upload your public key certificate so that the root certificate in use " -"can be checked. See our `self-signed guide " -"`_ for details." +"URL that will be opened by the user's client. If you have created a " +":class:`aiogram.types.game.Game` and accepted the conditions via " +"`@BotFather `_, specify the URL that opens your " +"game - note that this will only work if the query comes from a " +"`https://core.telegram.org/bots/api#inlinekeyboardbutton " +"`_ " +"*callback_game* button." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:17 of +#: aiogram.client.bot.Bot.answer_callback_query:9 of msgid "" -"The fixed IP address which will be used to send webhook requests instead " -"of the IP address resolved through DNS" +"The maximum amount of time in seconds that the result of the callback " +"query may be cached client-side. Telegram apps will support caching " +"starting in version 3.14. Defaults to 0." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:18 of +#: aiogram.client.bot.Bot.answer_callback_query:11 of msgid "" -"The maximum allowed number of simultaneous HTTPS connections to the " -"webhook for update delivery, 1-100. Defaults to *40*. Use lower values to" -" limit the load on your bot's server, and higher values to increase your " -"bot's throughput." -msgstr "" - -#: aiogram.client.bot.Bot.delete_webhook:5 -#: aiogram.client.bot.Bot.set_webhook:20 of -msgid "Pass :code:`True` to drop all pending updates" +"Otherwise, you may use links like :code:`t.me/your_bot?start=XXXX` that " +"open your bot with a parameter." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:21 of +#: aiogram.client.bot.Bot.answer_inline_query:1 of msgid "" -"A secret token to be sent in a header 'X-Telegram-Bot-Api-Secret-Token' " -"in every webhook request, 1-256 characters. Only characters :code:`A-Z`, " -":code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. The header" -" is useful to ensure that the request comes from a webhook set by you." +"Use this method to send answers to an inline query. On success, " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:13 -#: aiogram.client.bot.Bot.approve_chat_join_request:8 -#: aiogram.client.bot.Bot.ban_chat_sender_chat:8 -#: aiogram.client.bot.Bot.close_forum_topic:8 -#: aiogram.client.bot.Bot.create_new_sticker_set:15 -#: aiogram.client.bot.Bot.decline_chat_join_request:8 -#: aiogram.client.bot.Bot.delete_chat_photo:7 -#: aiogram.client.bot.Bot.delete_forum_topic:8 -#: aiogram.client.bot.Bot.delete_message:26 -#: aiogram.client.bot.Bot.delete_my_commands:8 -#: aiogram.client.bot.Bot.delete_sticker_from_set:7 -#: aiogram.client.bot.Bot.delete_webhook:7 -#: aiogram.client.bot.Bot.edit_forum_topic:10 -#: aiogram.client.bot.Bot.leave_chat:7 aiogram.client.bot.Bot.log_out:6 -#: aiogram.client.bot.Bot.pin_chat_message:9 -#: aiogram.client.bot.Bot.promote_chat_member:20 -#: aiogram.client.bot.Bot.reopen_forum_topic:8 -#: aiogram.client.bot.Bot.restrict_chat_member:10 -#: aiogram.client.bot.Bot.send_chat_action:12 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:9 -#: aiogram.client.bot.Bot.set_chat_description:8 -#: aiogram.client.bot.Bot.set_chat_menu_button:8 -#: aiogram.client.bot.Bot.set_chat_permissions:8 -#: aiogram.client.bot.Bot.set_chat_photo:8 -#: aiogram.client.bot.Bot.set_chat_title:8 -#: aiogram.client.bot.Bot.set_my_commands:9 -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:8 -#: aiogram.client.bot.Bot.set_sticker_position_in_set:8 -#: aiogram.client.bot.Bot.set_sticker_set_thumb:9 -#: aiogram.client.bot.Bot.set_webhook:23 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:8 -#: aiogram.client.bot.Bot.unpin_all_chat_messages:7 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:8 -#: aiogram.client.bot.Bot.unpin_chat_message:8 of -msgid "Returns True on success." +#: aiogram.client.bot.Bot.answer_inline_query:3 of +msgid "No more than **50** results per query are allowed." msgstr "" -#: aiogram.client.bot.Bot.delete_webhook:1 of -msgid "" -"Use this method to remove webhook integration if you decide to switch " -"back to :class:`aiogram.methods.get_updates.GetUpdates`. Returns " -":code:`True` on success." +#: aiogram.client.bot.Bot.answer_inline_query:5 of +msgid "Unique identifier for the answered query" msgstr "" -#: aiogram.client.bot.Bot.delete_webhook:3 of -msgid "Source: https://core.telegram.org/bots/api#deletewebhook" +#: aiogram.client.bot.Bot.answer_inline_query:6 of +msgid "A JSON-serialized array of results for the inline query" msgstr "" -#: aiogram.client.bot.Bot.get_webhook_info:1 of +#: aiogram.client.bot.Bot.answer_inline_query:7 of msgid "" -"Use this method to get current webhook status. Requires no parameters. On" -" success, returns a :class:`aiogram.types.webhook_info.WebhookInfo` " -"object. If the bot is using " -":class:`aiogram.methods.get_updates.GetUpdates`, will return an object " -"with the *url* field empty." +"The maximum amount of time in seconds that the result of the inline query" +" may be cached on the server. Defaults to 300." msgstr "" -#: aiogram.client.bot.Bot.get_webhook_info:3 of -msgid "Source: https://core.telegram.org/bots/api#getwebhookinfo" +#: aiogram.client.bot.Bot.answer_inline_query:8 of +msgid "" +"Pass :code:`True` if results may be cached on the server side only for " +"the user that sent the query. By default, results may be returned to any " +"user who sends the same query" msgstr "" -#: aiogram.client.bot.Bot.get_webhook_info:6 of +#: aiogram.client.bot.Bot.answer_inline_query:9 of msgid "" -"On success, returns a WebhookInfo object. If the bot is using getUpdates," -" will return an object with the url field empty." +"Pass the offset that a client should send in the next query with the same" +" text to receive more results. Pass an empty string if there are no more " +"results or if you don't support pagination. Offset length can't exceed 64" +" bytes." msgstr "" -#: aiogram.client.bot.Bot.get_me:1 of +#: aiogram.client.bot.Bot.answer_inline_query:10 of msgid "" -"A simple method for testing your bot's authentication token. Requires no " -"parameters. Returns basic information about the bot in form of a " -":class:`aiogram.types.user.User` object." +"If passed, clients will display a button with specified text that " +"switches the user to a private chat with the bot and sends the bot a " +"start message with the parameter *switch_pm_parameter*" msgstr "" -#: aiogram.client.bot.Bot.get_me:3 of -msgid "Source: https://core.telegram.org/bots/api#getme" +#: aiogram.client.bot.Bot.answer_inline_query:11 of +msgid "" +"`Deep-linking `_ " +"parameter for the /start message sent to the bot when user presses the " +"switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, " +":code:`0-9`, :code:`_` and :code:`-` are allowed." msgstr "" -#: aiogram.client.bot.Bot.get_me:6 of -msgid "Returns basic information about the bot in form of a User object." +#: aiogram.client.bot.Bot.answer_inline_query:13 +#: aiogram.client.bot.Bot.answer_shipping_query:8 of +msgid "On success, :code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.log_out:1 of +#: aiogram.client.bot.Bot.answer_pre_checkout_query:1 of msgid "" -"Use this method to log out from the cloud Bot API server before launching" -" the bot locally. You **must** log out the bot before running it locally," -" otherwise there is no guarantee that the bot will receive updates. After" -" a successful call, you can immediately log in on a local server, but " -"will not be able to log in back to the cloud Bot API server for 10 " -"minutes. Returns :code:`True` on success. Requires no parameters." +"Once the user has confirmed their payment and shipping details, the Bot " +"API sends the final confirmation in the form of an " +":class:`aiogram.types.update.Update` with the field *pre_checkout_query*." +" Use this method to respond to such pre-checkout queries. On success, " +":code:`True` is returned. **Note:** The Bot API must receive an answer " +"within 10 seconds after the pre-checkout query was sent." msgstr "" -#: aiogram.client.bot.Bot.log_out:3 of -msgid "Source: https://core.telegram.org/bots/api#logout" +#: aiogram.client.bot.Bot.answer_pre_checkout_query:4 of +msgid "" +"Specify :code:`True` if everything is alright (goods are available, etc.)" +" and the bot is ready to proceed with the order. Use :code:`False` if " +"there are any problems." msgstr "" -#: aiogram.client.bot.Bot.close:1 of +#: aiogram.client.bot.Bot.answer_pre_checkout_query:5 of msgid "" -"Use this method to close the bot instance before moving it from one local" -" server to another. You need to delete the webhook before calling this " -"method to ensure that the bot isn't launched again after server restart. " -"The method will return error 429 in the first 10 minutes after the bot is" -" launched. Returns :code:`True` on success. Requires no parameters." +"Required if *ok* is :code:`False`. Error message in human readable form " +"that explains the reason for failure to proceed with the checkout (e.g. " +"\"Sorry, somebody just bought the last of our amazing black T-shirts " +"while you were busy filling out your payment details. Please choose a " +"different color or garment!\"). Telegram will display this message to the" +" user." msgstr "" -#: aiogram.client.bot.Bot.close:3 of -msgid "Source: https://core.telegram.org/bots/api#close" +#: aiogram.client.bot.Bot.answer_pre_checkout_query:7 of +msgid "" +"**Note:** The Bot API must receive an answer within 10 seconds after the " +"pre-checkout query was sent." msgstr "" -#: aiogram.client.bot.Bot.close:6 of +#: aiogram.client.bot.Bot.answer_shipping_query:1 of msgid "" -"The method will return error 429 in the first 10 minutes after the bot is" -" launched. Returns True on success." +"If you sent an invoice requesting a shipping address and the parameter " +"*is_flexible* was specified, the Bot API will send an " +":class:`aiogram.types.update.Update` with a *shipping_query* field to the" +" bot. Use this method to reply to shipping queries. On success, " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.send_message:1 of +#: aiogram.client.bot.Bot.answer_shipping_query:4 of msgid "" -"Use this method to send text messages. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Pass :code:`True` if delivery to the specified address is possible and " +":code:`False` if there are any problems (for example, if delivery to the " +"specified address is not possible)" msgstr "" -#: aiogram.client.bot.Bot.send_message:3 of -msgid "Source: https://core.telegram.org/bots/api#sendmessage" +#: aiogram.client.bot.Bot.answer_shipping_query:5 of +msgid "" +"Required if *ok* is :code:`True`. A JSON-serialized array of available " +"shipping options." msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:5 -#: aiogram.client.bot.Bot.ban_chat_sender_chat:5 -#: aiogram.client.bot.Bot.copy_message:5 -#: aiogram.client.bot.Bot.create_chat_invite_link:5 -#: aiogram.client.bot.Bot.decline_chat_join_request:5 -#: aiogram.client.bot.Bot.delete_chat_photo:5 -#: aiogram.client.bot.Bot.delete_message:23 -#: aiogram.client.bot.Bot.edit_chat_invite_link:5 -#: aiogram.client.bot.Bot.export_chat_invite_link:7 -#: aiogram.client.bot.Bot.forward_message:5 -#: aiogram.client.bot.Bot.pin_chat_message:5 -#: aiogram.client.bot.Bot.promote_chat_member:5 -#: aiogram.client.bot.Bot.send_animation:5 aiogram.client.bot.Bot.send_audio:6 -#: aiogram.client.bot.Bot.send_chat_action:9 -#: aiogram.client.bot.Bot.send_contact:5 aiogram.client.bot.Bot.send_dice:5 -#: aiogram.client.bot.Bot.send_document:5 aiogram.client.bot.Bot.send_invoice:5 -#: aiogram.client.bot.Bot.send_location:5 -#: aiogram.client.bot.Bot.send_media_group:5 -#: aiogram.client.bot.Bot.send_message:5 aiogram.client.bot.Bot.send_photo:5 -#: aiogram.client.bot.Bot.send_poll:5 aiogram.client.bot.Bot.send_sticker:5 -#: aiogram.client.bot.Bot.send_venue:5 aiogram.client.bot.Bot.send_video:5 -#: aiogram.client.bot.Bot.send_video_note:5 aiogram.client.bot.Bot.send_voice:5 -#: aiogram.client.bot.Bot.set_chat_description:5 -#: aiogram.client.bot.Bot.set_chat_photo:5 -#: aiogram.client.bot.Bot.set_chat_title:5 aiogram.client.bot.Bot.stop_poll:5 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:5 -#: aiogram.client.bot.Bot.unpin_all_chat_messages:5 -#: aiogram.client.bot.Bot.unpin_chat_message:5 of +#: aiogram.client.bot.Bot.answer_shipping_query:6 of msgid "" -"Unique identifier for the target chat or username of the target channel " -"(in the format :code:`@channelusername`)" +"Required if *ok* is :code:`False`. Error message in human readable form " +"that explains why it is impossible to complete the order (e.g. \"Sorry, " +"delivery to your desired address is unavailable'). Telegram will display " +"this message to the user." msgstr "" -#: aiogram.client.bot.Bot.send_message:6 of -msgid "Text of the message to be sent, 1-4096 characters after entities parsing" +#: aiogram.client.bot.Bot.answer_web_app_query:1 of +msgid "" +"Use this method to set the result of an interaction with a `Web App " +"`_ and send a corresponding " +"message on behalf of the user to the chat from which the query " +"originated. On success, a " +":class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.copy_message:8 -#: aiogram.client.bot.Bot.forward_message:8 -#: aiogram.client.bot.Bot.send_animation:7 aiogram.client.bot.Bot.send_audio:8 -#: aiogram.client.bot.Bot.send_contact:8 aiogram.client.bot.Bot.send_dice:6 -#: aiogram.client.bot.Bot.send_document:7 aiogram.client.bot.Bot.send_game:7 -#: aiogram.client.bot.Bot.send_invoice:12 -#: aiogram.client.bot.Bot.send_location:8 -#: aiogram.client.bot.Bot.send_media_group:7 -#: aiogram.client.bot.Bot.send_message:7 aiogram.client.bot.Bot.send_photo:7 -#: aiogram.client.bot.Bot.send_poll:8 aiogram.client.bot.Bot.send_sticker:7 -#: aiogram.client.bot.Bot.send_venue:10 aiogram.client.bot.Bot.send_video:7 -#: aiogram.client.bot.Bot.send_video_note:7 aiogram.client.bot.Bot.send_voice:7 -#: of +#: aiogram.client.bot.Bot.answer_web_app_query:4 of +msgid "A JSON-serialized object describing the message to be sent" +msgstr "" + +#: aiogram.client.bot.Bot.answer_web_app_query:6 of msgid "" -"Unique identifier for the target message thread (topic) of the forum; for" -" forum supergroups only" +"On success, a " +":class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:9 -#: aiogram.client.bot.Bot.send_message:8 of +#: aiogram.client.bot.Bot.approve_chat_join_request:1 of msgid "" -"Mode for parsing entities in the message text. See `formatting options " -"`_ for more " -"details." +"Use this method to approve a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:10 -#: aiogram.client.bot.Bot.send_message:9 of +#: aiogram.client.bot.Bot.approve_chat_join_request:3 +#: aiogram.client.bot.Bot.ban_chat_sender_chat:3 +#: aiogram.client.bot.Bot.copy_message:3 +#: aiogram.client.bot.Bot.create_chat_invite_link:3 +#: aiogram.client.bot.Bot.decline_chat_join_request:3 +#: aiogram.client.bot.Bot.delete_chat_photo:3 +#: aiogram.client.bot.Bot.delete_message:21 +#: aiogram.client.bot.Bot.edit_chat_invite_link:3 +#: aiogram.client.bot.Bot.export_chat_invite_link:5 +#: aiogram.client.bot.Bot.forward_message:3 +#: aiogram.client.bot.Bot.pin_chat_message:3 +#: aiogram.client.bot.Bot.promote_chat_member:3 +#: aiogram.client.bot.Bot.send_animation:3 aiogram.client.bot.Bot.send_audio:4 +#: aiogram.client.bot.Bot.send_chat_action:7 +#: aiogram.client.bot.Bot.send_contact:3 aiogram.client.bot.Bot.send_dice:3 +#: aiogram.client.bot.Bot.send_document:3 aiogram.client.bot.Bot.send_invoice:3 +#: aiogram.client.bot.Bot.send_location:3 +#: aiogram.client.bot.Bot.send_media_group:3 +#: aiogram.client.bot.Bot.send_message:3 aiogram.client.bot.Bot.send_photo:3 +#: aiogram.client.bot.Bot.send_poll:3 aiogram.client.bot.Bot.send_sticker:3 +#: aiogram.client.bot.Bot.send_venue:3 aiogram.client.bot.Bot.send_video:3 +#: aiogram.client.bot.Bot.send_video_note:3 aiogram.client.bot.Bot.send_voice:3 +#: aiogram.client.bot.Bot.set_chat_description:3 +#: aiogram.client.bot.Bot.set_chat_photo:3 +#: aiogram.client.bot.Bot.set_chat_title:3 aiogram.client.bot.Bot.stop_poll:3 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:3 +#: aiogram.client.bot.Bot.unpin_all_chat_messages:3 +#: aiogram.client.bot.Bot.unpin_chat_message:3 of msgid "" -"A JSON-serialized list of special entities that appear in message text, " -"which can be specified instead of *parse_mode*" +"Unique identifier for the target chat or username of the target channel " +"(in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:11 -#: aiogram.client.bot.Bot.send_message:10 of -msgid "Disables link previews for links in this message" +#: aiogram.client.bot.Bot.approve_chat_join_request:4 +#: aiogram.client.bot.Bot.ban_chat_member:4 +#: aiogram.client.bot.Bot.decline_chat_join_request:4 +#: aiogram.client.bot.Bot.get_chat_member:4 +#: aiogram.client.bot.Bot.get_user_profile_photos:3 +#: aiogram.client.bot.Bot.promote_chat_member:4 +#: aiogram.client.bot.Bot.restrict_chat_member:4 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:4 +#: aiogram.client.bot.Bot.unban_chat_member:4 of +msgid "Unique identifier of the target user" msgstr "" -#: aiogram.client.bot.Bot.copy_message:12 -#: aiogram.client.bot.Bot.forward_message:9 -#: aiogram.client.bot.Bot.send_animation:15 -#: aiogram.client.bot.Bot.send_audio:16 aiogram.client.bot.Bot.send_contact:11 -#: aiogram.client.bot.Bot.send_dice:8 aiogram.client.bot.Bot.send_document:13 -#: aiogram.client.bot.Bot.send_game:8 aiogram.client.bot.Bot.send_invoice:28 -#: aiogram.client.bot.Bot.send_location:13 -#: aiogram.client.bot.Bot.send_message:11 aiogram.client.bot.Bot.send_photo:11 -#: aiogram.client.bot.Bot.send_poll:19 aiogram.client.bot.Bot.send_sticker:8 -#: aiogram.client.bot.Bot.send_venue:15 aiogram.client.bot.Bot.send_video:16 -#: aiogram.client.bot.Bot.send_video_note:11 -#: aiogram.client.bot.Bot.send_voice:12 of +#: aiogram.client.bot.Bot.ban_chat_member:1 of msgid "" -"Sends the message `silently `_. Users will receive a notification with no sound." +"Use this method to ban a user in a group, a supergroup or a channel. In " +"the case of supergroups and channels, the user will not be able to return" +" to the chat on their own using invite links, etc., unless `unbanned " +"`_ first. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.copy_message:13 -#: aiogram.client.bot.Bot.send_animation:16 -#: aiogram.client.bot.Bot.send_audio:17 aiogram.client.bot.Bot.send_contact:12 -#: aiogram.client.bot.Bot.send_document:14 aiogram.client.bot.Bot.send_game:9 -#: aiogram.client.bot.Bot.send_invoice:29 -#: aiogram.client.bot.Bot.send_location:14 -#: aiogram.client.bot.Bot.send_message:12 aiogram.client.bot.Bot.send_photo:12 -#: aiogram.client.bot.Bot.send_poll:20 aiogram.client.bot.Bot.send_sticker:9 -#: aiogram.client.bot.Bot.send_venue:16 aiogram.client.bot.Bot.send_video:17 -#: aiogram.client.bot.Bot.send_video_note:12 -#: aiogram.client.bot.Bot.send_voice:13 of -msgid "Protects the contents of the sent message from forwarding and saving" +#: aiogram.client.bot.Bot.ban_chat_member:3 +#: aiogram.client.bot.Bot.unban_chat_member:3 of +msgid "" +"Unique identifier for the target group or username of the target " +"supergroup or channel (in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.copy_message:14 -#: aiogram.client.bot.Bot.send_animation:17 -#: aiogram.client.bot.Bot.send_audio:18 aiogram.client.bot.Bot.send_contact:13 -#: aiogram.client.bot.Bot.send_dice:10 aiogram.client.bot.Bot.send_document:15 -#: aiogram.client.bot.Bot.send_game:10 aiogram.client.bot.Bot.send_invoice:30 -#: aiogram.client.bot.Bot.send_location:15 -#: aiogram.client.bot.Bot.send_message:13 aiogram.client.bot.Bot.send_photo:13 -#: aiogram.client.bot.Bot.send_poll:21 aiogram.client.bot.Bot.send_sticker:10 -#: aiogram.client.bot.Bot.send_venue:17 aiogram.client.bot.Bot.send_video:18 -#: aiogram.client.bot.Bot.send_video_note:13 -#: aiogram.client.bot.Bot.send_voice:14 of -msgid "If the message is a reply, ID of the original message" +#: aiogram.client.bot.Bot.ban_chat_member:5 of +msgid "" +"Date when the user will be unbanned, unix time. If user is banned for " +"more than 366 days or less than 30 seconds from the current time they are" +" considered to be banned forever. Applied for supergroups and channels " +"only." msgstr "" -#: aiogram.client.bot.Bot.copy_message:15 -#: aiogram.client.bot.Bot.send_animation:18 -#: aiogram.client.bot.Bot.send_audio:19 aiogram.client.bot.Bot.send_contact:14 -#: aiogram.client.bot.Bot.send_dice:11 aiogram.client.bot.Bot.send_document:16 -#: aiogram.client.bot.Bot.send_game:11 aiogram.client.bot.Bot.send_invoice:31 -#: aiogram.client.bot.Bot.send_location:16 -#: aiogram.client.bot.Bot.send_media_group:11 -#: aiogram.client.bot.Bot.send_message:14 aiogram.client.bot.Bot.send_photo:14 -#: aiogram.client.bot.Bot.send_poll:22 aiogram.client.bot.Bot.send_sticker:11 -#: aiogram.client.bot.Bot.send_venue:18 aiogram.client.bot.Bot.send_video:19 -#: aiogram.client.bot.Bot.send_video_note:14 -#: aiogram.client.bot.Bot.send_voice:15 of +#: aiogram.client.bot.Bot.ban_chat_member:6 of msgid "" -"Pass :code:`True` if the message should be sent even if the specified " -"replied-to message is not found" +"Pass :code:`True` to delete all messages from the chat for the user that " +"is being removed. If :code:`False`, the user will be able to see messages" +" in the group that were sent before the user was removed. Always " +":code:`True` for supergroups and channels." msgstr "" -#: aiogram.client.bot.Bot.copy_message:16 -#: aiogram.client.bot.Bot.send_animation:19 -#: aiogram.client.bot.Bot.send_audio:20 aiogram.client.bot.Bot.send_contact:15 -#: aiogram.client.bot.Bot.send_dice:12 aiogram.client.bot.Bot.send_document:17 -#: aiogram.client.bot.Bot.send_location:17 -#: aiogram.client.bot.Bot.send_message:15 aiogram.client.bot.Bot.send_photo:15 -#: aiogram.client.bot.Bot.send_poll:23 aiogram.client.bot.Bot.send_sticker:12 -#: aiogram.client.bot.Bot.send_venue:19 aiogram.client.bot.Bot.send_video:20 -#: aiogram.client.bot.Bot.send_video_note:15 -#: aiogram.client.bot.Bot.send_voice:16 of +#: aiogram.client.bot.Bot.ban_chat_sender_chat:1 of msgid "" -"Additional interface options. A JSON-serialized object for an `inline " -"keyboard `_, " -"`custom reply keyboard " -"`_, instructions to " -"remove reply keyboard or to force a reply from the user." +"Use this method to ban a channel chat in a supergroup or a channel. Until" +" the chat is `unbanned " +"`_, the owner of " +"the banned chat won't be able to send messages on behalf of **any of " +"their channels**. The bot must be an administrator in the supergroup or " +"channel for this to work and must have the appropriate administrator " +"rights. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.forward_message:12 -#: aiogram.client.bot.Bot.send_animation:21 -#: aiogram.client.bot.Bot.send_audio:22 aiogram.client.bot.Bot.send_contact:17 -#: aiogram.client.bot.Bot.send_dice:14 aiogram.client.bot.Bot.send_document:19 -#: aiogram.client.bot.Bot.send_game:14 aiogram.client.bot.Bot.send_invoice:34 -#: aiogram.client.bot.Bot.send_location:19 -#: aiogram.client.bot.Bot.send_message:17 aiogram.client.bot.Bot.send_photo:17 -#: aiogram.client.bot.Bot.send_poll:25 aiogram.client.bot.Bot.send_sticker:14 -#: aiogram.client.bot.Bot.send_venue:21 aiogram.client.bot.Bot.send_video:22 -#: aiogram.client.bot.Bot.send_video_note:17 -#: aiogram.client.bot.Bot.send_voice:18 of -msgid "On success, the sent Message is returned." +#: aiogram.client.bot.Bot.ban_chat_sender_chat:4 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:4 of +msgid "Unique identifier of the target sender chat" msgstr "" -#: aiogram.client.bot.Bot.forward_message:1 of +#: aiogram.client.bot.Bot.close:1 of msgid "" -"Use this method to forward messages of any kind. Service messages can't " -"be forwarded. On success, the sent :class:`aiogram.types.message.Message`" -" is returned." +"Use this method to close the bot instance before moving it from one local" +" server to another. You need to delete the webhook before calling this " +"method to ensure that the bot isn't launched again after server restart. " +"The method will return error 429 in the first 10 minutes after the bot is" +" launched. Returns :code:`True` on success. Requires no parameters." msgstr "" -#: aiogram.client.bot.Bot.forward_message:3 of -msgid "Source: https://core.telegram.org/bots/api#forwardmessage" +#: aiogram.client.bot.Bot.close:4 aiogram.client.bot.Bot.log_out:4 of +msgid "Requires no parameters." msgstr "" -#: aiogram.client.bot.Bot.copy_message:6 -#: aiogram.client.bot.Bot.forward_message:6 of +#: aiogram.client.bot.Bot.close_forum_topic:1 of msgid "" -"Unique identifier for the chat where the original message was sent (or " -"channel username in the format :code:`@channelusername`)" +"Use this method to close an open topic in a forum supergroup chat. The " +"bot must be an administrator in the chat for this to work and must have " +"the *can_manage_topics* administrator rights, unless it is the creator of" +" the topic. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.copy_message:7 -#: aiogram.client.bot.Bot.forward_message:7 of -msgid "Message identifier in the chat specified in *from_chat_id*" +#: aiogram.client.bot.Bot.close_forum_topic:3 +#: aiogram.client.bot.Bot.create_forum_topic:3 +#: aiogram.client.bot.Bot.delete_chat_sticker_set:3 +#: aiogram.client.bot.Bot.delete_forum_topic:3 +#: aiogram.client.bot.Bot.edit_forum_topic:3 +#: aiogram.client.bot.Bot.reopen_forum_topic:3 +#: aiogram.client.bot.Bot.restrict_chat_member:3 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:3 +#: aiogram.client.bot.Bot.set_chat_permissions:3 +#: aiogram.client.bot.Bot.set_chat_sticker_set:3 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:3 of +msgid "" +"Unique identifier for the target chat or username of the target " +"supergroup (in the format :code:`@supergroupusername`)" msgstr "" -#: aiogram.client.bot.Bot.forward_message:10 of -msgid "Protects the contents of the forwarded message from forwarding and saving" +#: aiogram.client.bot.Bot.close_forum_topic:4 +#: aiogram.client.bot.Bot.delete_forum_topic:4 +#: aiogram.client.bot.Bot.edit_forum_topic:4 +#: aiogram.client.bot.Bot.reopen_forum_topic:4 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:4 of +msgid "Unique identifier for the target message thread of the forum topic" msgstr "" #: aiogram.client.bot.Bot.copy_message:1 of @@ -866,934 +847,1160 @@ msgid "" "message on success." msgstr "" -#: aiogram.client.bot.Bot.copy_message:3 of -msgid "Source: https://core.telegram.org/bots/api#copymessage" +#: aiogram.client.bot.Bot.copy_message:4 +#: aiogram.client.bot.Bot.forward_message:4 of +msgid "" +"Unique identifier for the chat where the original message was sent (or " +"channel username in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.copy_message:9 of +#: aiogram.client.bot.Bot.copy_message:5 +#: aiogram.client.bot.Bot.forward_message:5 of +msgid "Message identifier in the chat specified in *from_chat_id*" +msgstr "" + +#: aiogram.client.bot.Bot.copy_message:6 +#: aiogram.client.bot.Bot.forward_message:6 +#: aiogram.client.bot.Bot.send_animation:5 aiogram.client.bot.Bot.send_audio:6 +#: aiogram.client.bot.Bot.send_contact:6 aiogram.client.bot.Bot.send_dice:4 +#: aiogram.client.bot.Bot.send_document:5 aiogram.client.bot.Bot.send_game:5 +#: aiogram.client.bot.Bot.send_invoice:10 +#: aiogram.client.bot.Bot.send_location:6 +#: aiogram.client.bot.Bot.send_media_group:5 +#: aiogram.client.bot.Bot.send_message:5 aiogram.client.bot.Bot.send_photo:5 +#: aiogram.client.bot.Bot.send_poll:6 aiogram.client.bot.Bot.send_sticker:5 +#: aiogram.client.bot.Bot.send_venue:8 aiogram.client.bot.Bot.send_video:5 +#: aiogram.client.bot.Bot.send_video_note:5 aiogram.client.bot.Bot.send_voice:5 +#: of +msgid "" +"Unique identifier for the target message thread (topic) of the forum; for" +" forum supergroups only" +msgstr "" + +#: aiogram.client.bot.Bot.copy_message:7 of msgid "" "New caption for media, 0-1024 characters after entities parsing. If not " "specified, the original caption is kept" msgstr "" -#: aiogram.client.bot.Bot.copy_message:10 of +#: aiogram.client.bot.Bot.copy_message:8 of msgid "" "Mode for parsing entities in the new caption. See `formatting options " "`_ for more " "details." msgstr "" -#: aiogram.client.bot.Bot.copy_message:11 of +#: aiogram.client.bot.Bot.copy_message:9 of msgid "" "A JSON-serialized list of special entities that appear in the new " "caption, which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.copy_message:18 of -msgid "Returns the MessageId of the sent message on success." +#: aiogram.client.bot.Bot.copy_message:10 +#: aiogram.client.bot.Bot.forward_message:7 +#: aiogram.client.bot.Bot.send_animation:13 +#: aiogram.client.bot.Bot.send_audio:14 aiogram.client.bot.Bot.send_contact:9 +#: aiogram.client.bot.Bot.send_dice:6 aiogram.client.bot.Bot.send_document:11 +#: aiogram.client.bot.Bot.send_game:6 aiogram.client.bot.Bot.send_invoice:26 +#: aiogram.client.bot.Bot.send_location:11 +#: aiogram.client.bot.Bot.send_message:9 aiogram.client.bot.Bot.send_photo:9 +#: aiogram.client.bot.Bot.send_poll:17 aiogram.client.bot.Bot.send_sticker:6 +#: aiogram.client.bot.Bot.send_venue:13 aiogram.client.bot.Bot.send_video:14 +#: aiogram.client.bot.Bot.send_video_note:9 +#: aiogram.client.bot.Bot.send_voice:10 of +msgid "" +"Sends the message `silently `_. Users will receive a notification with no sound." msgstr "" -#: aiogram.client.bot.Bot.send_photo:1 of -msgid "" -"Use this method to send photos. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +#: aiogram.client.bot.Bot.copy_message:11 +#: aiogram.client.bot.Bot.send_animation:14 +#: aiogram.client.bot.Bot.send_audio:15 aiogram.client.bot.Bot.send_contact:10 +#: aiogram.client.bot.Bot.send_document:12 aiogram.client.bot.Bot.send_game:7 +#: aiogram.client.bot.Bot.send_invoice:27 +#: aiogram.client.bot.Bot.send_location:12 +#: aiogram.client.bot.Bot.send_message:10 aiogram.client.bot.Bot.send_photo:10 +#: aiogram.client.bot.Bot.send_poll:18 aiogram.client.bot.Bot.send_sticker:7 +#: aiogram.client.bot.Bot.send_venue:14 aiogram.client.bot.Bot.send_video:15 +#: aiogram.client.bot.Bot.send_video_note:10 +#: aiogram.client.bot.Bot.send_voice:11 of +msgid "Protects the contents of the sent message from forwarding and saving" msgstr "" -#: aiogram.client.bot.Bot.send_photo:3 of -msgid "Source: https://core.telegram.org/bots/api#sendphoto" +#: aiogram.client.bot.Bot.copy_message:12 +#: aiogram.client.bot.Bot.send_animation:15 +#: aiogram.client.bot.Bot.send_audio:16 aiogram.client.bot.Bot.send_contact:11 +#: aiogram.client.bot.Bot.send_dice:8 aiogram.client.bot.Bot.send_document:13 +#: aiogram.client.bot.Bot.send_game:8 aiogram.client.bot.Bot.send_invoice:28 +#: aiogram.client.bot.Bot.send_location:13 +#: aiogram.client.bot.Bot.send_message:11 aiogram.client.bot.Bot.send_photo:11 +#: aiogram.client.bot.Bot.send_poll:19 aiogram.client.bot.Bot.send_sticker:8 +#: aiogram.client.bot.Bot.send_venue:15 aiogram.client.bot.Bot.send_video:16 +#: aiogram.client.bot.Bot.send_video_note:11 +#: aiogram.client.bot.Bot.send_voice:12 of +msgid "If the message is a reply, ID of the original message" msgstr "" -#: aiogram.client.bot.Bot.send_photo:6 of -msgid "" -"Photo to send. Pass a file_id as String to send a photo that exists on " -"the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a photo from the Internet, or upload a new photo using " -"multipart/form-data. The photo must be at most 10 MB in size. The photo's" -" width and height must not exceed 10000 in total. Width and height ratio " -"must be at most 20. :ref:`More information on Sending Files » `" +#: aiogram.client.bot.Bot.copy_message:13 +#: aiogram.client.bot.Bot.send_animation:16 +#: aiogram.client.bot.Bot.send_audio:17 aiogram.client.bot.Bot.send_contact:12 +#: aiogram.client.bot.Bot.send_dice:9 aiogram.client.bot.Bot.send_document:14 +#: aiogram.client.bot.Bot.send_game:9 aiogram.client.bot.Bot.send_invoice:29 +#: aiogram.client.bot.Bot.send_location:14 +#: aiogram.client.bot.Bot.send_media_group:9 +#: aiogram.client.bot.Bot.send_message:12 aiogram.client.bot.Bot.send_photo:12 +#: aiogram.client.bot.Bot.send_poll:20 aiogram.client.bot.Bot.send_sticker:9 +#: aiogram.client.bot.Bot.send_venue:16 aiogram.client.bot.Bot.send_video:17 +#: aiogram.client.bot.Bot.send_video_note:12 +#: aiogram.client.bot.Bot.send_voice:13 of +msgid "" +"Pass :code:`True` if the message should be sent even if the specified " +"replied-to message is not found" msgstr "" -#: aiogram.client.bot.Bot.send_photo:8 of +#: aiogram.client.bot.Bot.copy_message:14 +#: aiogram.client.bot.Bot.send_animation:17 +#: aiogram.client.bot.Bot.send_audio:18 aiogram.client.bot.Bot.send_contact:13 +#: aiogram.client.bot.Bot.send_dice:10 aiogram.client.bot.Bot.send_document:15 +#: aiogram.client.bot.Bot.send_location:15 +#: aiogram.client.bot.Bot.send_message:13 aiogram.client.bot.Bot.send_photo:13 +#: aiogram.client.bot.Bot.send_poll:21 aiogram.client.bot.Bot.send_sticker:10 +#: aiogram.client.bot.Bot.send_venue:17 aiogram.client.bot.Bot.send_video:18 +#: aiogram.client.bot.Bot.send_video_note:13 +#: aiogram.client.bot.Bot.send_voice:14 of msgid "" -"Photo caption (may also be used when resending photos by *file_id*), " -"0-1024 characters after entities parsing" +"Additional interface options. A JSON-serialized object for an `inline " +"keyboard `_, " +"`custom reply keyboard " +"`_, instructions to " +"remove reply keyboard or to force a reply from the user." msgstr "" -#: aiogram.client.bot.Bot.send_photo:9 of +#: aiogram.client.bot.Bot.copy_message:16 of msgid "" -"Mode for parsing entities in the photo caption. See `formatting options " -"`_ for more " -"details." +"Returns the :class:`aiogram.types.message_id.MessageId` of the sent " +"message on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:10 -#: aiogram.client.bot.Bot.send_animation:14 -#: aiogram.client.bot.Bot.send_audio:11 aiogram.client.bot.Bot.send_document:11 -#: aiogram.client.bot.Bot.send_photo:10 aiogram.client.bot.Bot.send_video:14 -#: aiogram.client.bot.Bot.send_voice:10 of +#: aiogram.client.bot.Bot.create_chat_invite_link:1 of msgid "" -"A JSON-serialized list of special entities that appear in the caption, " -"which can be specified instead of *parse_mode*" +"Use this method to create an additional invite link for a chat. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. The link can be revoked using the " +"method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. " +"Returns the new invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.send_audio:1 of -msgid "" -"Use this method to send audio files, if you want Telegram clients to " -"display them in the music player. Your audio must be in the .MP3 or .M4A " -"format. On success, the sent :class:`aiogram.types.message.Message` is " -"returned. Bots can currently send audio files of up to 50 MB in size, " -"this limit may be changed in the future. For sending voice messages, use " -"the :class:`aiogram.methods.send_voice.SendVoice` method instead." +#: aiogram.client.bot.Bot.create_chat_invite_link:4 +#: aiogram.client.bot.Bot.edit_chat_invite_link:5 of +msgid "Invite link name; 0-32 characters" +msgstr "" + +#: aiogram.client.bot.Bot.create_chat_invite_link:5 +#: aiogram.client.bot.Bot.edit_chat_invite_link:6 of +msgid "Point in time (Unix timestamp) when the link will expire" msgstr "" -#: aiogram.client.bot.Bot.send_audio:4 of -msgid "Source: https://core.telegram.org/bots/api#sendaudio" +#: aiogram.client.bot.Bot.create_chat_invite_link:6 +#: aiogram.client.bot.Bot.edit_chat_invite_link:7 of +msgid "" +"The maximum number of users that can be members of the chat " +"simultaneously after joining the chat via this invite link; 1-99999" msgstr "" -#: aiogram.client.bot.Bot.send_audio:7 of +#: aiogram.client.bot.Bot.create_chat_invite_link:7 +#: aiogram.client.bot.Bot.edit_chat_invite_link:8 of msgid "" -"Audio file to send. Pass a file_id as String to send an audio file that " -"exists on the Telegram servers (recommended), pass an HTTP URL as a " -"String for Telegram to get an audio file from the Internet, or upload a " -"new one using multipart/form-data. :ref:`More information on Sending " -"Files » `" +":code:`True`, if users joining the chat via the link need to be approved " +"by chat administrators. If :code:`True`, *member_limit* can't be " +"specified" msgstr "" -#: aiogram.client.bot.Bot.send_audio:9 of -msgid "Audio caption, 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.create_chat_invite_link:9 of +msgid "" +"Returns the new invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.send_audio:10 of +#: aiogram.client.bot.Bot.create_forum_topic:1 of msgid "" -"Mode for parsing entities in the audio caption. See `formatting options " -"`_ for more " -"details." +"Use this method to create a topic in a forum supergroup chat. The bot " +"must be an administrator in the chat for this to work and must have the " +"*can_manage_topics* administrator rights. Returns information about the " +"created topic as a :class:`aiogram.types.forum_topic.ForumTopic` object." msgstr "" -#: aiogram.client.bot.Bot.send_audio:12 of -msgid "Duration of the audio in seconds" +#: aiogram.client.bot.Bot.create_forum_topic:4 of +msgid "Topic name, 1-128 characters" msgstr "" -#: aiogram.client.bot.Bot.send_audio:13 of -msgid "Performer" +#: aiogram.client.bot.Bot.create_forum_topic:5 of +msgid "" +"Color of the topic icon in RGB format. Currently, must be one of 7322096 " +"(0x6FB9F0), 16766590 (0xFFD67E), 13338331 (0xCB86DB), 9367192 (0x8EEE98)," +" 16749490 (0xFF93B2), or 16478047 (0xFB6F5F)" msgstr "" -#: aiogram.client.bot.Bot.send_audio:14 of -msgid "Track name" +#: aiogram.client.bot.Bot.create_forum_topic:6 of +msgid "" +"Unique identifier of the custom emoji shown as the topic icon. Use " +":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +" to get all allowed custom emoji identifiers." msgstr "" -#: aiogram.client.bot.Bot.send_animation:11 -#: aiogram.client.bot.Bot.send_audio:15 aiogram.client.bot.Bot.send_document:8 -#: aiogram.client.bot.Bot.send_video:11 -#: aiogram.client.bot.Bot.send_video_note:10 of +#: aiogram.client.bot.Bot.create_forum_topic:8 of msgid "" -"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 » `" +"Returns information about the created topic as a " +":class:`aiogram.types.forum_topic.ForumTopic` object." msgstr "" -#: aiogram.client.bot.Bot.send_document:1 of +#: aiogram.client.bot.Bot.create_invoice_link:1 of msgid "" -"Use this method to send general files. On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send files of any type of up to 50 MB in size, this limit may be changed " -"in the future." +"Use this method to create a link for an invoice. Returns the created " +"invoice link as *String* on success." +msgstr "" + +#: aiogram.client.bot.Bot.create_invoice_link:3 +#: aiogram.client.bot.Bot.send_invoice:4 of +msgid "Product name, 1-32 characters" msgstr "" -#: aiogram.client.bot.Bot.send_document:3 of -msgid "Source: https://core.telegram.org/bots/api#senddocument" +#: aiogram.client.bot.Bot.create_invoice_link:4 +#: aiogram.client.bot.Bot.send_invoice:5 of +msgid "Product description, 1-255 characters" msgstr "" -#: aiogram.client.bot.Bot.send_document:6 of +#: aiogram.client.bot.Bot.create_invoice_link:5 +#: aiogram.client.bot.Bot.send_invoice:6 of msgid "" -"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 » `" +"Bot-defined invoice payload, 1-128 bytes. This will not be displayed to " +"the user, use for your internal processes." +msgstr "" + +#: aiogram.client.bot.Bot.create_invoice_link:6 of +msgid "Payment provider token, obtained via `BotFather `_" msgstr "" -#: aiogram.client.bot.Bot.send_document:9 of +#: aiogram.client.bot.Bot.create_invoice_link:7 +#: aiogram.client.bot.Bot.send_invoice:8 of msgid "" -"Document caption (may also be used when resending documents by " -"*file_id*), 0-1024 characters after entities parsing" +"Three-letter ISO 4217 currency code, see `more on currencies " +"`_" msgstr "" -#: aiogram.client.bot.Bot.send_document:10 of +#: aiogram.client.bot.Bot.create_invoice_link:8 +#: aiogram.client.bot.Bot.send_invoice:9 of msgid "" -"Mode for parsing entities in the document caption. See `formatting " -"options `_ for " -"more details." +"Price breakdown, a JSON-serialized list of components (e.g. product " +"price, tax, discount, delivery cost, delivery tax, bonus, etc.)" msgstr "" -#: aiogram.client.bot.Bot.send_document:12 of +#: aiogram.client.bot.Bot.create_invoice_link:9 +#: aiogram.client.bot.Bot.send_invoice:11 of msgid "" -"Disables automatic server-side content type detection for files uploaded " -"using multipart/form-data" +"The maximum accepted amount for tips in the *smallest units* of the " +"currency (integer, **not** float/double). For example, for a maximum tip " +"of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* " +"parameter in `currencies.json " +"`_, it shows the" +" number of digits past the decimal point for each currency (2 for the " +"majority of currencies). Defaults to 0" msgstr "" -#: aiogram.client.bot.Bot.send_video:1 of +#: aiogram.client.bot.Bot.create_invoice_link:10 +#: aiogram.client.bot.Bot.send_invoice:12 of msgid "" -"Use this method to send video files, Telegram clients support MPEG4 " -"videos (other formats may be sent as " -":class:`aiogram.types.document.Document`). On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send video files of up to 50 MB in size, this limit may be changed in the" -" future." +"A JSON-serialized array of suggested amounts of tips in the *smallest " +"units* of the currency (integer, **not** float/double). At most 4 " +"suggested tip amounts can be specified. The suggested tip amounts must be" +" positive, passed in a strictly increased order and must not exceed " +"*max_tip_amount*." msgstr "" -#: aiogram.client.bot.Bot.send_video:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvideo" +#: aiogram.client.bot.Bot.create_invoice_link:11 +#: aiogram.client.bot.Bot.send_invoice:14 of +msgid "" +"JSON-serialized data about the invoice, which will be shared with the " +"payment provider. A detailed description of required fields should be " +"provided by the payment provider." msgstr "" -#: aiogram.client.bot.Bot.send_video:6 of +#: aiogram.client.bot.Bot.create_invoice_link:12 of msgid "" -"Video to send. Pass a file_id as String to send a video that exists on " -"the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a video from the Internet, or upload a new video using " -"multipart/form-data. :ref:`More information on Sending Files » `" +"URL of the product photo for the invoice. Can be a photo of the goods or " +"a marketing image for a service." msgstr "" -#: aiogram.client.bot.Bot.send_video:8 aiogram.client.bot.Bot.send_video_note:8 -#: of -msgid "Duration of sent video in seconds" +#: aiogram.client.bot.Bot.create_invoice_link:13 +#: aiogram.client.bot.Bot.send_invoice:16 of +msgid "Photo size in bytes" msgstr "" -#: aiogram.client.bot.Bot.send_video:9 of -msgid "Video width" +#: aiogram.client.bot.Bot.create_invoice_link:14 +#: aiogram.client.bot.Bot.send_invoice:17 of +msgid "Photo width" msgstr "" -#: aiogram.client.bot.Bot.send_video:10 of -msgid "Video height" +#: aiogram.client.bot.Bot.create_invoice_link:15 +#: aiogram.client.bot.Bot.send_invoice:18 of +msgid "Photo height" msgstr "" -#: aiogram.client.bot.Bot.send_video:12 of +#: aiogram.client.bot.Bot.create_invoice_link:16 +#: aiogram.client.bot.Bot.send_invoice:19 of msgid "" -"Video caption (may also be used when resending videos by *file_id*), " -"0-1024 characters after entities parsing" +"Pass :code:`True` if you require the user's full name to complete the " +"order" msgstr "" -#: aiogram.client.bot.Bot.send_video:13 of +#: aiogram.client.bot.Bot.create_invoice_link:17 +#: aiogram.client.bot.Bot.send_invoice:20 of msgid "" -"Mode for parsing entities in the video caption. See `formatting options " -"`_ for more " -"details." +"Pass :code:`True` if you require the user's phone number to complete the " +"order" msgstr "" -#: aiogram.client.bot.Bot.send_video:15 of -msgid "Pass :code:`True` if the uploaded video is suitable for streaming" +#: aiogram.client.bot.Bot.create_invoice_link:18 +#: aiogram.client.bot.Bot.send_invoice:21 of +msgid "" +"Pass :code:`True` if you require the user's email address to complete the" +" order" msgstr "" -#: aiogram.client.bot.Bot.send_animation:1 of +#: aiogram.client.bot.Bot.create_invoice_link:19 +#: aiogram.client.bot.Bot.send_invoice:22 of msgid "" -"Use this method to send animation files (GIF or H.264/MPEG-4 AVC video " -"without sound). On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send animation files of up to 50 MB in size, this limit may be changed in" -" the future." +"Pass :code:`True` if you require the user's shipping address to complete " +"the order" msgstr "" -#: aiogram.client.bot.Bot.send_animation:3 of -msgid "Source: https://core.telegram.org/bots/api#sendanimation" +#: aiogram.client.bot.Bot.create_invoice_link:20 of +msgid "" +"Pass :code:`True` if the user's phone number should be sent to the " +"provider" msgstr "" -#: aiogram.client.bot.Bot.send_animation:6 of +#: aiogram.client.bot.Bot.create_invoice_link:21 of msgid "" -"Animation to send. Pass a file_id as String to send an animation that " -"exists on the Telegram servers (recommended), pass an HTTP URL as a " -"String for Telegram to get an animation from the Internet, or upload a " -"new animation using multipart/form-data. :ref:`More information on " -"Sending Files » `" +"Pass :code:`True` if the user's email address should be sent to the " +"provider" msgstr "" -#: aiogram.client.bot.Bot.send_animation:8 of -msgid "Duration of sent animation in seconds" +#: aiogram.client.bot.Bot.create_invoice_link:22 +#: aiogram.client.bot.Bot.send_invoice:25 of +msgid "Pass :code:`True` if the final price depends on the shipping method" msgstr "" -#: aiogram.client.bot.Bot.send_animation:9 of -msgid "Animation width" +#: aiogram.client.bot.Bot.create_invoice_link:24 of +msgid "Returns the created invoice link as *String* on success." msgstr "" -#: aiogram.client.bot.Bot.send_animation:10 of -msgid "Animation height" +#: aiogram.client.bot.Bot.create_new_sticker_set: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." msgstr "" -#: aiogram.client.bot.Bot.send_animation:12 of -msgid "" -"Animation caption (may also be used when resending animation by " -"*file_id*), 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.create_new_sticker_set:3 of +msgid "User identifier of created sticker set owner" msgstr "" -#: aiogram.client.bot.Bot.send_animation:13 of +#: aiogram.client.bot.Bot.create_new_sticker_set:4 of msgid "" -"Mode for parsing entities in the animation caption. See `formatting " -"options `_ for " -"more details." +"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." msgstr "" -#: aiogram.client.bot.Bot.send_voice:1 of -msgid "" -"Use this method to send audio files, if you want Telegram clients to " -"display the file as a playable voice message. For this to work, your " -"audio must be in an .OGG file encoded with OPUS (other formats may be " -"sent as :class:`aiogram.types.audio.Audio` or " -":class:`aiogram.types.document.Document`). On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send voice messages of up to 50 MB in size, this limit may be changed in " -"the future." +#: aiogram.client.bot.Bot.create_new_sticker_set:5 of +msgid "Sticker set title, 1-64 characters" msgstr "" -#: aiogram.client.bot.Bot.send_voice:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvoice" +#: aiogram.client.bot.Bot.create_new_sticker_set:10 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." msgstr "" -#: aiogram.client.bot.Bot.send_voice:6 of +#: aiogram.client.bot.Bot.decline_chat_join_request:1 of msgid "" -"Audio 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 » `" +"Use this method to decline a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_voice:8 of -msgid "Voice message caption, 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.delete_chat_photo:1 of +msgid "" +"Use this method to delete a chat photo. Photos can't be changed for " +"private chats. The bot must be an administrator in the chat for this to " +"work and must have the appropriate administrator rights. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_voice:9 of +#: aiogram.client.bot.Bot.delete_chat_sticker_set:1 of msgid "" -"Mode for parsing entities in the voice message caption. See `formatting " -"options `_ for " -"more details." +"Use this method to delete a group sticker set from a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." msgstr "" -#: aiogram.client.bot.Bot.send_voice:11 of -msgid "Duration of the voice message in seconds" +#: aiogram.client.bot.Bot.delete_forum_topic:1 of +msgid "" +"Use this method to delete a forum topic along with all its messages in a " +"forum supergroup chat. The bot must be an administrator in the chat for " +"this to work and must have the *can_delete_messages* administrator " +"rights. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_video_note:1 of +#: aiogram.client.bot.Bot.delete_message:1 +#: aiogram.client.bot.Bot.delete_message:24 of msgid "" -"As of `v.4.0 `_, " -"Telegram clients support rounded square MPEG4 videos of up to 1 minute " -"long. Use this method to send video messages. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Use this method to delete a message, including service messages, with the" +" following limitations:" msgstr "" -#: aiogram.client.bot.Bot.send_video_note:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvideonote" +#: aiogram.client.bot.Bot.delete_message:3 of +msgid "A message can only be deleted if it was sent less than 48 hours ago." msgstr "" -#: aiogram.client.bot.Bot.send_video_note:6 of +#: aiogram.client.bot.Bot.delete_message:5 of msgid "" -"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" +"Service messages about a supergroup, channel, or forum topic creation " +"can't be deleted." msgstr "" -#: aiogram.client.bot.Bot.send_video_note:9 of -msgid "Video width and height, i.e. diameter of the video message" +#: aiogram.client.bot.Bot.delete_message:7 of +msgid "" +"A dice message in a private chat can only be deleted if it was sent more " +"than 24 hours ago." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:1 of +#: aiogram.client.bot.Bot.delete_message:9 of msgid "" -"Use this method to send a group of photos, videos, documents or audios as" -" an album. Documents and audio files can be only grouped in an album with" -" messages of the same type. On success, an array of `Messages " -"`_ that were sent is " -"returned." +"Bots can delete outgoing messages in private chats, groups, and " +"supergroups." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:3 of -msgid "Source: https://core.telegram.org/bots/api#sendmediagroup" +#: aiogram.client.bot.Bot.delete_message:11 of +msgid "Bots can delete incoming messages in private chats." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:6 of +#: aiogram.client.bot.Bot.delete_message:13 of msgid "" -"A JSON-serialized array describing messages to be sent, must include 2-10" -" items" +"Bots granted *can_post_messages* permissions can delete outgoing messages" +" in channels." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:8 of +#: aiogram.client.bot.Bot.delete_message:15 of msgid "" -"Sends messages `silently `_. Users will receive a notification with no sound." +"If the bot is an administrator of a group, it can delete any message " +"there." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:9 of -msgid "Protects the contents of the sent messages from forwarding and saving" +#: aiogram.client.bot.Bot.delete_message:17 of +msgid "" +"If the bot has *can_delete_messages* permission in a supergroup or a " +"channel, it can delete any message there." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:10 of -msgid "If the messages are a reply, ID of the original message" +#: aiogram.client.bot.Bot.delete_message:22 of +msgid "Identifier of the message to delete" msgstr "" -#: aiogram.client.bot.Bot.send_media_group:13 of -msgid "On success, an array of Messages that were sent is returned." +#: aiogram.client.bot.Bot.delete_my_commands:1 of +msgid "" +"Use this method to delete the list of the bot's commands for the given " +"scope and user language. After deletion, `higher level commands " +"`_ will " +"be shown to affected users. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_location:1 of +#: aiogram.client.bot.Bot.delete_my_commands:3 +#: aiogram.client.bot.Bot.set_my_commands:4 of msgid "" -"Use this method to send point on the map. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"A JSON-serialized object, describing scope of users for which the " +"commands are relevant. Defaults to " +":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." msgstr "" -#: aiogram.client.bot.Bot.send_location:3 of -msgid "Source: https://core.telegram.org/bots/api#sendlocation" +#: aiogram.client.bot.Bot.delete_my_commands:4 +#: aiogram.client.bot.Bot.set_my_commands:5 of +msgid "" +"A two-letter ISO 639-1 language code. If empty, commands will be applied " +"to all users from the given scope, for whose language there are no " +"dedicated commands" msgstr "" -#: aiogram.client.bot.Bot.send_location:6 of -msgid "Latitude of the location" +#: aiogram.client.bot.Bot.delete_sticker_from_set:1 of +msgid "" +"Use this method to delete a sticker from a set created by the bot. " +"Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_location:7 of -msgid "Longitude of the location" +#: aiogram.client.bot.Bot.delete_sticker_from_set:3 +#: aiogram.client.bot.Bot.set_sticker_position_in_set:3 of +msgid "File identifier of the sticker" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:10 -#: aiogram.client.bot.Bot.send_location:9 of -msgid "The radius of uncertainty for the location, measured in meters; 0-1500" +#: aiogram.client.bot.Bot.delete_webhook:1 of +msgid "" +"Use this method to remove webhook integration if you decide to switch " +"back to :class:`aiogram.methods.get_updates.GetUpdates`. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_location:10 of -msgid "" -"Period in seconds for which the location will be updated (see `Live " -"Locations `_, should be between" -" 60 and 86400." +#: aiogram.client.bot.Bot.delete_webhook:3 +#: aiogram.client.bot.Bot.set_webhook:18 of +msgid "Pass :code:`True` to drop all pending updates" msgstr "" -#: aiogram.client.bot.Bot.send_location:11 of +#: aiogram.client.bot.Bot.edit_chat_invite_link:1 of msgid "" -"For live locations, a direction in which the user is moving, in degrees. " -"Must be between 1 and 360 if specified." +"Use this method to edit a non-primary invite link created by the bot. The" +" bot must be an administrator in the chat for this to work and must have " +"the appropriate administrator rights. Returns the edited invite link as a" +" :class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.send_location:12 of +#: aiogram.client.bot.Bot.edit_chat_invite_link:4 of +msgid "The invite link to edit" +msgstr "" + +#: aiogram.client.bot.Bot.edit_chat_invite_link:10 of msgid "" -"For live locations, a maximum distance for proximity alerts about " -"approaching another chat member, in meters. Must be between 1 and 100000 " -"if specified." +"Returns the edited invite link as a " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:1 of +#: aiogram.client.bot.Bot.edit_forum_topic:1 of msgid "" -"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." +"Use this method to edit name and icon of a topic in a forum supergroup " +"chat. The bot must be an administrator in the chat for this to work and " +"must have *can_manage_topics* administrator rights, unless it is the " +"creator of the topic. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagelivelocation" +#: aiogram.client.bot.Bot.edit_forum_topic:5 of +msgid "New topic name, 1-128 characters" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:5 of -msgid "Latitude of new location" +#: aiogram.client.bot.Bot.edit_forum_topic:6 of +msgid "" +"New unique identifier of the custom emoji shown as the topic icon. Use " +":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +" to get all allowed custom emoji identifiers." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:6 of -msgid "Longitude of new location" +#: aiogram.client.bot.Bot.edit_message_caption:1 of +msgid "" +"Use this method to edit captions of messages. 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." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:5 -#: aiogram.client.bot.Bot.edit_message_live_location:7 -#: aiogram.client.bot.Bot.edit_message_media:6 -#: aiogram.client.bot.Bot.edit_message_reply_markup:5 -#: aiogram.client.bot.Bot.edit_message_text:6 -#: aiogram.client.bot.Bot.stop_message_live_location:5 of +#: aiogram.client.bot.Bot.edit_message_caption:3 +#: aiogram.client.bot.Bot.edit_message_live_location:5 +#: aiogram.client.bot.Bot.edit_message_media:4 +#: aiogram.client.bot.Bot.edit_message_reply_markup:3 +#: aiogram.client.bot.Bot.edit_message_text:4 +#: aiogram.client.bot.Bot.stop_message_live_location:3 of msgid "" "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`)" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:6 -#: aiogram.client.bot.Bot.edit_message_live_location:8 -#: aiogram.client.bot.Bot.edit_message_media:7 -#: aiogram.client.bot.Bot.edit_message_reply_markup:6 -#: aiogram.client.bot.Bot.edit_message_text:7 of +#: aiogram.client.bot.Bot.edit_message_caption:4 +#: aiogram.client.bot.Bot.edit_message_live_location:6 +#: aiogram.client.bot.Bot.edit_message_media:5 +#: aiogram.client.bot.Bot.edit_message_reply_markup:4 +#: aiogram.client.bot.Bot.edit_message_text:5 of msgid "" "Required if *inline_message_id* is not specified. Identifier of the " "message to edit" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:7 -#: aiogram.client.bot.Bot.edit_message_live_location:9 -#: aiogram.client.bot.Bot.edit_message_media:8 -#: aiogram.client.bot.Bot.edit_message_reply_markup:7 -#: aiogram.client.bot.Bot.edit_message_text:8 -#: aiogram.client.bot.Bot.get_game_high_scores:10 -#: aiogram.client.bot.Bot.set_game_score:11 -#: aiogram.client.bot.Bot.stop_message_live_location:7 of +#: aiogram.client.bot.Bot.edit_message_caption:5 +#: aiogram.client.bot.Bot.edit_message_live_location:7 +#: aiogram.client.bot.Bot.edit_message_media:6 +#: aiogram.client.bot.Bot.edit_message_reply_markup:5 +#: aiogram.client.bot.Bot.edit_message_text:6 +#: aiogram.client.bot.Bot.get_game_high_scores:8 +#: aiogram.client.bot.Bot.set_game_score:9 +#: aiogram.client.bot.Bot.stop_message_live_location:5 of msgid "" "Required if *chat_id* and *message_id* are not specified. Identifier of " "the inline message" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:11 of +#: aiogram.client.bot.Bot.edit_message_caption:6 of +msgid "New caption of the message, 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.client.bot.Bot.edit_message_caption:7 of msgid "" -"Direction in which the user is moving, in degrees. Must be between 1 and " -"360 if specified." +"Mode for parsing entities in the message caption. See `formatting options" +" `_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:12 of +#: aiogram.client.bot.Bot.edit_message_caption:8 +#: aiogram.client.bot.Bot.send_animation:12 aiogram.client.bot.Bot.send_audio:9 +#: aiogram.client.bot.Bot.send_document:9 aiogram.client.bot.Bot.send_photo:8 +#: aiogram.client.bot.Bot.send_video:12 aiogram.client.bot.Bot.send_voice:8 of msgid "" -"The maximum distance for proximity alerts about approaching another chat " -"member, in meters. Must be between 1 and 100000 if specified." +"A JSON-serialized list of special entities that appear in the caption, " +"which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:13 -#: aiogram.client.bot.Bot.edit_message_media:9 -#: aiogram.client.bot.Bot.stop_message_live_location:8 of +#: aiogram.client.bot.Bot.edit_message_caption:9 +#: aiogram.client.bot.Bot.edit_message_reply_markup:6 +#: aiogram.client.bot.Bot.edit_message_text:10 of msgid "" -"A JSON-serialized object for a new `inline keyboard " +"A JSON-serialized object for an `inline keyboard " "`_." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:13 -#: aiogram.client.bot.Bot.edit_message_live_location:15 -#: aiogram.client.bot.Bot.edit_message_media:11 -#: aiogram.client.bot.Bot.edit_message_reply_markup:10 -#: aiogram.client.bot.Bot.edit_message_text:14 of +#: aiogram.client.bot.Bot.edit_message_caption:11 +#: aiogram.client.bot.Bot.edit_message_live_location:13 +#: aiogram.client.bot.Bot.edit_message_media:9 +#: aiogram.client.bot.Bot.edit_message_reply_markup:8 +#: aiogram.client.bot.Bot.edit_message_text:12 of msgid "" "On success, if the edited message is not an inline message, the edited " -"Message is returned, otherwise True is returned." +":class:`aiogram.types.message.Message` is returned, otherwise " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.stop_message_live_location:1 of +#: aiogram.client.bot.Bot.edit_message_live_location:1 of msgid "" -"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." -msgstr "" - -#: aiogram.client.bot.Bot.stop_message_live_location:3 of -msgid "Source: https://core.telegram.org/bots/api#stopmessagelivelocation" -msgstr "" - -#: aiogram.client.bot.Bot.stop_message_live_location:6 of -msgid "" -"Required if *inline_message_id* is not specified. Identifier of the " -"message with live location to stop" +"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." msgstr "" -#: aiogram.client.bot.Bot.stop_message_live_location:10 of -msgid "" -"On success, if the message is not an inline message, the edited Message " -"is returned, otherwise True is returned." +#: aiogram.client.bot.Bot.edit_message_live_location:3 of +msgid "Latitude of new location" msgstr "" -#: aiogram.client.bot.Bot.send_venue:1 of -msgid "" -"Use this method to send information about a venue. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +#: aiogram.client.bot.Bot.edit_message_live_location:4 of +msgid "Longitude of new location" msgstr "" -#: aiogram.client.bot.Bot.send_venue:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvenue" +#: aiogram.client.bot.Bot.edit_message_live_location:8 +#: aiogram.client.bot.Bot.send_location:7 of +msgid "The radius of uncertainty for the location, measured in meters; 0-1500" msgstr "" -#: aiogram.client.bot.Bot.send_venue:6 of -msgid "Latitude of the venue" +#: aiogram.client.bot.Bot.edit_message_live_location:9 of +msgid "" +"Direction in which the user is moving, in degrees. Must be between 1 and " +"360 if specified." msgstr "" -#: aiogram.client.bot.Bot.send_venue:7 of -msgid "Longitude of the venue" +#: aiogram.client.bot.Bot.edit_message_live_location:10 of +msgid "" +"The maximum distance for proximity alerts about approaching another chat " +"member, in meters. Must be between 1 and 100000 if specified." msgstr "" -#: aiogram.client.bot.Bot.send_venue:8 of -msgid "Name of the venue" +#: aiogram.client.bot.Bot.edit_message_live_location:11 +#: aiogram.client.bot.Bot.edit_message_media:7 +#: aiogram.client.bot.Bot.stop_message_live_location:6 of +msgid "" +"A JSON-serialized object for a new `inline keyboard " +"`_." msgstr "" -#: aiogram.client.bot.Bot.send_venue:9 of -msgid "Address of the venue" +#: aiogram.client.bot.Bot.edit_message_media:1 of +msgid "" +"Use this method to edit animation, audio, document, photo, or video " +"messages. If a message is part of a message album, then it can be edited " +"only to an audio for audio albums, only to a document for document albums" +" and to a photo or a video otherwise. When an inline message is edited, a" +" new file can't be uploaded; use a previously uploaded file via its " +"file_id or specify a URL. On success, if the edited message is not an " +"inline message, the edited :class:`aiogram.types.message.Message` is " +"returned, otherwise :code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.send_venue:11 of -msgid "Foursquare identifier of the venue" +#: aiogram.client.bot.Bot.edit_message_media:3 of +msgid "A JSON-serialized object for a new media content of the message" msgstr "" -#: aiogram.client.bot.Bot.send_venue:12 of +#: aiogram.client.bot.Bot.edit_message_reply_markup:1 of msgid "" -"Foursquare type of the venue, if known. (For example, " -"'arts_entertainment/default', 'arts_entertainment/aquarium' or " -"'food/icecream'.)" +"Use this method to edit only the reply markup of messages. 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." msgstr "" -#: aiogram.client.bot.Bot.send_venue:13 of -msgid "Google Places identifier of the venue" +#: aiogram.client.bot.Bot.edit_message_text:1 of +msgid "" +"Use this method to edit text and `game " +"`_ messages. 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." msgstr "" -#: aiogram.client.bot.Bot.send_venue:14 of -msgid "" -"Google Places type of the venue. (See `supported types " -"`_.)" +#: aiogram.client.bot.Bot.edit_message_text:3 of +msgid "New text of the message, 1-4096 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.send_contact:1 of +#: aiogram.client.bot.Bot.edit_message_text:7 +#: aiogram.client.bot.Bot.send_message:6 of msgid "" -"Use this method to send phone contacts. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Mode for parsing entities in the message text. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.send_contact:3 of -msgid "Source: https://core.telegram.org/bots/api#sendcontact" +#: aiogram.client.bot.Bot.edit_message_text:8 +#: aiogram.client.bot.Bot.send_message:7 of +msgid "" +"A JSON-serialized list of special entities that appear in message text, " +"which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.send_contact:6 of -msgid "Contact's phone number" +#: aiogram.client.bot.Bot.edit_message_text:9 +#: aiogram.client.bot.Bot.send_message:8 of +msgid "Disables link previews for links in this message" msgstr "" -#: aiogram.client.bot.Bot.send_contact:7 of -msgid "Contact's first name" +#: aiogram.client.bot.Bot.export_chat_invite_link:1 of +msgid "" +"Use this method to generate a new primary invite link for a chat; any " +"previously generated primary link is revoked. The bot must be an " +"administrator in the chat for this to work and must have the appropriate " +"administrator rights. Returns the new invite link as *String* on success." msgstr "" -#: aiogram.client.bot.Bot.send_contact:9 of -msgid "Contact's last name" +#: aiogram.client.bot.Bot.export_chat_invite_link:3 of +msgid "" +"Note: Each administrator in a chat generates their own invite links. Bots" +" can't use invite links generated by other administrators. If you want " +"your bot to work with invite links, it will need to generate its own link" +" using " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or " +"by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your " +"bot needs to generate a new primary invite link replacing its previous " +"one, use " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"again." msgstr "" -#: aiogram.client.bot.Bot.send_contact:10 of +#: aiogram.client.bot.Bot.export_chat_invite_link:7 of msgid "" -"Additional data about the contact in the form of a `vCard " -"`_, 0-2048 bytes" +"If your bot needs to generate a new primary invite link replacing its " +"previous one, use " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"again." msgstr "" -#: aiogram.client.bot.Bot.send_poll:1 of +#: aiogram.client.bot.Bot.forward_message:1 of msgid "" -"Use this method to send a native poll. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Use this method to forward messages of any kind. Service messages can't " +"be forwarded. On success, the sent :class:`aiogram.types.message.Message`" +" is returned." msgstr "" -#: aiogram.client.bot.Bot.send_poll:3 of -msgid "Source: https://core.telegram.org/bots/api#sendpoll" +#: aiogram.client.bot.Bot.forward_message:8 of +msgid "Protects the contents of the forwarded message from forwarding and saving" msgstr "" -#: aiogram.client.bot.Bot.send_poll:6 of -msgid "Poll question, 1-300 characters" +#: aiogram.client.bot.Bot.forward_message:10 +#: aiogram.client.bot.Bot.send_contact:15 aiogram.client.bot.Bot.send_dice:12 +#: aiogram.client.bot.Bot.send_game:12 aiogram.client.bot.Bot.send_invoice:32 +#: aiogram.client.bot.Bot.send_location:17 +#: aiogram.client.bot.Bot.send_message:15 aiogram.client.bot.Bot.send_photo:15 +#: aiogram.client.bot.Bot.send_poll:23 aiogram.client.bot.Bot.send_sticker:12 +#: aiogram.client.bot.Bot.send_venue:19 +#: aiogram.client.bot.Bot.send_video_note:15 of +msgid "On success, the sent :class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.send_poll:7 of +#: aiogram.client.bot.Bot.get_chat:1 of msgid "" -"A JSON-serialized list of answer options, 2-10 strings 1-100 characters " -"each" +"Use this method to get up to date information about the chat (current " +"name of the user for one-on-one conversations, current username of a " +"user, group or channel, etc.). Returns a :class:`aiogram.types.chat.Chat`" +" object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:9 of -msgid ":code:`True`, if the poll needs to be anonymous, defaults to :code:`True`" +#: aiogram.client.bot.Bot.get_chat:3 +#: aiogram.client.bot.Bot.get_chat_administrators:3 +#: aiogram.client.bot.Bot.get_chat_member:3 +#: aiogram.client.bot.Bot.get_chat_member_count:3 +#: aiogram.client.bot.Bot.leave_chat:3 of +msgid "" +"Unique identifier for the target chat or username of the target " +"supergroup or channel (in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.send_poll:10 of -msgid "Poll type, 'quiz' or 'regular', defaults to 'regular'" +#: aiogram.client.bot.Bot.get_chat:5 of +msgid "Returns a :class:`aiogram.types.chat.Chat` object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:11 of +#: aiogram.client.bot.Bot.get_chat_administrators:1 of msgid "" -":code:`True`, if the poll allows multiple answers, ignored for polls in " -"quiz mode, defaults to :code:`False`" +"Use this method to get a list of administrators in a chat, which aren't " +"bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` " +"objects." msgstr "" -#: aiogram.client.bot.Bot.send_poll:12 of -msgid "" -"0-based identifier of the correct answer option, required for polls in " -"quiz mode" +#: aiogram.client.bot.Bot.get_chat_administrators:5 of +msgid "Returns an Array of :class:`aiogram.types.chat_member.ChatMember` objects." msgstr "" -#: aiogram.client.bot.Bot.send_poll:13 of +#: aiogram.client.bot.Bot.get_chat_member:1 of msgid "" -"Text that is shown when a user chooses an incorrect answer or taps on the" -" lamp icon in a quiz-style poll, 0-200 characters with at most 2 line " -"feeds after entities parsing" +"Use this method to get information about a member of a chat. Returns a " +":class:`aiogram.types.chat_member.ChatMember` object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:14 of -msgid "" -"Mode for parsing entities in the explanation. See `formatting options " -"`_ for more " -"details." +#: aiogram.client.bot.Bot.get_chat_member:6 of +msgid "Returns a :class:`aiogram.types.chat_member.ChatMember` object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:15 of +#: aiogram.client.bot.Bot.get_chat_member_count:1 of msgid "" -"A JSON-serialized list of special entities that appear in the poll " -"explanation, which can be specified instead of *parse_mode*" +"Use this method to get the number of members in a chat. Returns *Int* on " +"success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:16 of +#: aiogram.client.bot.Bot.get_chat_member_count:5 of +msgid "Returns *Int* on success." +msgstr "" + +#: aiogram.client.bot.Bot.get_chat_menu_button:1 of msgid "" -"Amount of time in seconds the poll will be active after creation, 5-600. " -"Can't be used together with *close_date*." +"Use this method to get the current value of the bot's menu button in a " +"private chat, or the default menu button. Returns " +":class:`aiogram.types.menu_button.MenuButton` on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:17 of +#: aiogram.client.bot.Bot.get_chat_menu_button:3 of msgid "" -"Point in time (Unix timestamp) when the poll will be automatically " -"closed. Must be at least 5 and no more than 600 seconds in the future. " -"Can't be used together with *open_period*." +"Unique identifier for the target private chat. If not specified, default " +"bot's menu button will be returned" msgstr "" -#: aiogram.client.bot.Bot.send_poll:18 of +#: aiogram.client.bot.Bot.get_chat_menu_button:5 of +msgid "Returns :class:`aiogram.types.menu_button.MenuButton` on success." +msgstr "" + +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:1 of msgid "" -"Pass :code:`True` if the poll needs to be immediately closed. This can be" -" useful for poll preview." +"Use this method to get information about custom emoji stickers by their " +"identifiers. Returns an Array of :class:`aiogram.types.sticker.Sticker` " +"objects." msgstr "" -#: aiogram.client.bot.Bot.send_dice:1 of +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:3 of msgid "" -"Use this method to send an animated emoji that will display a random " -"value. On success, the sent :class:`aiogram.types.message.Message` is " -"returned." +"List of custom emoji identifiers. At most 200 custom emoji identifiers " +"can be specified." msgstr "" -#: aiogram.client.bot.Bot.send_dice:3 of -msgid "Source: https://core.telegram.org/bots/api#senddice" +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:5 +#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:4 of +msgid "Returns an Array of :class:`aiogram.types.sticker.Sticker` objects." msgstr "" -#: aiogram.client.bot.Bot.send_dice:7 of +#: aiogram.client.bot.Bot.get_file:1 of msgid "" -"Emoji on which the dice throw animation is based. Currently, must be one " -"of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯'" -" and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults " -"to '🎲'" +"Use this method to get basic information about a file and prepare it for " +"downloading. For the moment, bots can download files of up to 20MB in " +"size. On success, a :class:`aiogram.types.file.File` object is returned. " +"The file can then be downloaded via the link " +":code:`https://api.telegram.org/file/bot/`, where " +":code:`` is taken from the response. It is guaranteed that the" +" link will be valid for at least 1 hour. When the link expires, a new one" +" can be requested by calling :class:`aiogram.methods.get_file.GetFile` " +"again. **Note:** This function may not preserve the original file name " +"and MIME type. You should save the file's MIME type and name (if " +"available) when the File object is received." msgstr "" -#: aiogram.client.bot.Bot.send_dice:9 of -msgid "Protects the contents of the sent message from forwarding" +#: aiogram.client.bot.Bot.get_file:4 of +msgid "File identifier to get information about" msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:1 of +#: aiogram.client.bot.Bot.get_file:6 of msgid "" -"Use this method when you need to tell the user that something is " -"happening on the bot's side. The status is set for 5 seconds or less " -"(when a message arrives from your bot, Telegram clients clear its typing " -"status). Returns :code:`True` on success." +"You should save the file's MIME type and name (if available) when the " +"File object is received." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:3 of +#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:1 of msgid "" -"Example: The `ImageBot `_ needs some time to " -"process a request and upload the image. Instead of sending a text message" -" along the lines of 'Retrieving image, please wait…', the bot may use " -":class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = " -"*upload_photo*. The user will see a 'sending photo' status for the bot." +"Use this method to get custom emoji stickers, which can be used as a " +"forum topic icon by any user. Requires no parameters. Returns an Array of" +" :class:`aiogram.types.sticker.Sticker` objects." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:5 of +#: aiogram.client.bot.Bot.get_game_high_scores:1 of msgid "" -"We only recommend using this method when a response from the bot will " -"take a **noticeable** amount of time to arrive." +"Use this method to get data for high score tables. Will return the score " +"of the specified user and several of their neighbors in a game. Returns " +"an Array of :class:`aiogram.types.game_high_score.GameHighScore` objects." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:7 of -msgid "Source: https://core.telegram.org/bots/api#sendchataction" +#: aiogram.client.bot.Bot.get_game_high_scores:3 of +msgid "" +"This method will currently return scores for the target user, plus two of" +" their closest neighbors on each side. Will also return the top three " +"users if the user and their neighbors are not among them. Please note " +"that this behavior is subject to change." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:10 of -msgid "" -"Type of action to broadcast. Choose one, depending on what the user is " -"about to receive: *typing* for `text messages " -"`_, *upload_photo* for " -"`photos `_, *record_video* " -"or *upload_video* for `videos " -"`_, *record_voice* or " -"*upload_voice* for `voice notes " -"`_, *upload_document* for " -"`general files `_, " -"*choose_sticker* for `stickers " -"`_, *find_location* for " -"`location data `_, " -"*record_video_note* or *upload_video_note* for `video notes " -"`_." +#: aiogram.client.bot.Bot.get_game_high_scores:5 of +msgid "Target user id" msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:1 of +#: aiogram.client.bot.Bot.get_game_high_scores:6 +#: aiogram.client.bot.Bot.set_game_score:7 of msgid "" -"Use this method to get a list of profile pictures for a user. Returns a " -":class:`aiogram.types.user_profile_photos.UserProfilePhotos` object." +"Required if *inline_message_id* is not specified. Unique identifier for " +"the target chat" msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:3 of -msgid "Source: https://core.telegram.org/bots/api#getuserprofilephotos" +#: aiogram.client.bot.Bot.get_game_high_scores:7 +#: aiogram.client.bot.Bot.set_game_score:8 of +msgid "" +"Required if *inline_message_id* is not specified. Identifier of the sent " +"message" msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:6 -#: aiogram.client.bot.Bot.ban_chat_member:6 -#: aiogram.client.bot.Bot.decline_chat_join_request:6 -#: aiogram.client.bot.Bot.get_chat_member:6 -#: aiogram.client.bot.Bot.get_user_profile_photos:5 -#: aiogram.client.bot.Bot.kick_chat_member:10 -#: aiogram.client.bot.Bot.promote_chat_member:6 -#: aiogram.client.bot.Bot.restrict_chat_member:6 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:6 -#: aiogram.client.bot.Bot.unban_chat_member:6 of -msgid "Unique identifier of the target user" +#: aiogram.client.bot.Bot.get_game_high_scores:10 of +msgid "Please note that this behavior is subject to change." msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:6 of +#: aiogram.client.bot.Bot.get_me:1 of msgid "" -"Sequential number of the first photo to be returned. By default, all " -"photos are returned." +"A simple method for testing your bot's authentication token. Requires no " +"parameters. Returns basic information about the bot in form of a " +":class:`aiogram.types.user.User` object." msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:7 of +#: aiogram.client.bot.Bot.get_me:4 of msgid "" -"Limits the number of photos to be retrieved. Values between 1-100 are " -"accepted. Defaults to 100." +"Returns basic information about the bot in form of a " +":class:`aiogram.types.user.User` object." msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:9 of -msgid "Returns a UserProfilePhotos object." +#: aiogram.client.bot.Bot.get_my_commands:1 of +msgid "" +"Use this method to get the current list of the bot's commands for the " +"given scope and user language. Returns an Array of " +":class:`aiogram.types.bot_command.BotCommand` objects. If commands aren't" +" set, an empty list is returned." msgstr "" -#: aiogram.client.bot.Bot.get_file:1 of +#: aiogram.client.bot.Bot.get_my_commands:3 of msgid "" -"Use this method to get basic information about a file and prepare it for " -"downloading. For the moment, bots can download files of up to 20MB in " -"size. On success, a :class:`aiogram.types.file.File` object is returned. " -"The file can then be downloaded via the link " -":code:`https://api.telegram.org/file/bot/`, where " -":code:`` is taken from the response. It is guaranteed that the" -" link will be valid for at least 1 hour. When the link expires, a new one" -" can be requested by calling :class:`aiogram.methods.get_file.GetFile` " -"again. **Note:** This function may not preserve the original file name " -"and MIME type. You should save the file's MIME type and name (if " -"available) when the File object is received." +"A JSON-serialized object, describing scope of users. Defaults to " +":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." msgstr "" -#: aiogram.client.bot.Bot.get_file:4 of -msgid "Source: https://core.telegram.org/bots/api#getfile" +#: aiogram.client.bot.Bot.get_my_commands:4 of +msgid "A two-letter ISO 639-1 language code or an empty string" msgstr "" -#: aiogram.client.bot.Bot.get_file:6 of -msgid "File identifier to get information about" +#: aiogram.client.bot.Bot.get_my_commands:6 of +msgid "If commands aren't set, an empty list is returned." msgstr "" -#: aiogram.client.bot.Bot.get_file:8 of -msgid "On success, a File object is returned." +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:1 of +msgid "" +"Use this method to get the current default administrator rights of the " +"bot. Returns " +":class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` " +"on success." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:1 -#: aiogram.client.bot.Bot.kick_chat_member:5 of +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:3 of msgid "" -"Use this method to ban a user in a group, a supergroup or a channel. In " -"the case of supergroups and channels, the user will not be able to return" -" to the chat on their own using invite links, etc., unless `unbanned " -"`_ first. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Returns :code:`True` on success." +"Pass :code:`True` to get default administrator rights of the bot in " +"channels. Otherwise, default administrator rights of the bot for groups " +"and supergroups will be returned." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:3 -#: aiogram.client.bot.Bot.kick_chat_member:7 of -msgid "Source: https://core.telegram.org/bots/api#banchatmember" +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:5 of +msgid "" +"Returns " +":class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` " +"on success." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:5 -#: aiogram.client.bot.Bot.kick_chat_member:9 -#: aiogram.client.bot.Bot.unban_chat_member:5 of +#: aiogram.client.bot.Bot.get_sticker_set:1 of msgid "" -"Unique identifier for the target group or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" +"Use this method to get a sticker set. On success, a " +":class:`aiogram.types.sticker_set.StickerSet` object is returned." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:7 -#: aiogram.client.bot.Bot.kick_chat_member:11 of +#: aiogram.client.bot.Bot.get_sticker_set:3 of +msgid "Name of the sticker set" +msgstr "" + +#: aiogram.client.bot.Bot.get_sticker_set:5 of msgid "" -"Date when the user will be unbanned, unix time. If user is banned for " -"more than 366 days or less than 30 seconds from the current time they are" -" considered to be banned forever. Applied for supergroups and channels " -"only." +"On success, a :class:`aiogram.types.sticker_set.StickerSet` object is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:8 -#: aiogram.client.bot.Bot.kick_chat_member:12 of +#: aiogram.client.bot.Bot.get_updates:1 of msgid "" -"Pass :code:`True` to delete all messages from the chat for the user that " -"is being removed. If :code:`False`, the user will be able to see messages" -" in the group that were sent before the user was removed. Always " -":code:`True` for supergroups and channels." +"Use this method to receive incoming updates using long polling (`wiki " +"`_). Returns " +"an Array of :class:`aiogram.types.update.Update` objects." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:10 -#: aiogram.client.bot.Bot.kick_chat_member:14 of +#: aiogram.client.bot.Bot.get_updates:3 aiogram.client.bot.Bot.set_webhook:4 of +msgid "**Notes**" +msgstr "" + +#: aiogram.client.bot.Bot.get_updates:5 of +msgid "**1.** This method will not work if an outgoing webhook is set up." +msgstr "" + +#: aiogram.client.bot.Bot.get_updates:7 of msgid "" -"In the case of supergroups and channels, the user will not be able to " -"return to the chat on their own using invite links, etc. Returns True on " -"success." +"**2.** In order to avoid getting duplicate updates, recalculate *offset* " +"after each server response." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:1 of +#: aiogram.client.bot.Bot.get_updates:9 of msgid "" -"Use this method to unban a previously banned user in a supergroup or " -"channel. The user will **not** return to the group or channel " -"automatically, but will be able to join via link, etc. The bot must be an" -" administrator for this to work. By default, this method guarantees that " -"after the call the user is not a member of the chat, but will be able to " -"join it. So if the user is a member of the chat they will also be " -"**removed** from the chat. If you don't want this, use the parameter " -"*only_if_banned*. Returns :code:`True` on success." +"Identifier of the first update to be returned. Must be greater by one " +"than the highest among the identifiers of previously received updates. By" +" default, updates starting with the earliest unconfirmed update are " +"returned. An update is considered confirmed as soon as " +":class:`aiogram.methods.get_updates.GetUpdates` is called with an " +"*offset* higher than its *update_id*. The negative offset can be " +"specified to retrieve updates starting from *-offset* update from the end" +" of the updates queue. All previous updates will forgotten." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#unbanchatmember" +#: aiogram.client.bot.Bot.get_updates:10 of +msgid "" +"Limits the number of updates to be retrieved. Values between 1-100 are " +"accepted. Defaults to 100." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:7 of -msgid "Do nothing if the user is not banned" +#: aiogram.client.bot.Bot.get_updates:11 of +msgid "" +"Timeout in seconds for long polling. Defaults to 0, i.e. usual short " +"polling. Should be positive, short polling should be used for testing " +"purposes only." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:9 of +#: aiogram.client.bot.Bot.get_updates:12 aiogram.client.bot.Bot.set_webhook:17 +#: of msgid "" -"The user will not return to the group or channel automatically, but will " -"be able to join via link, etc. Returns True on success." +"A JSON-serialized list of the update types you want your bot to receive. " +"For example, specify ['message', 'edited_channel_post', 'callback_query']" +" to only receive updates of these types. See " +":class:`aiogram.types.update.Update` for a complete list of available " +"update types. Specify an empty list to receive all update types except " +"*chat_member* (default). If not specified, the previous setting will be " +"used." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:1 of +#: aiogram.client.bot.Bot.get_updates:14 of +msgid "Returns an Array of :class:`aiogram.types.update.Update` objects." +msgstr "" + +#: aiogram.client.bot.Bot.get_user_profile_photos:1 of msgid "" -"Use this method to restrict a user in a supergroup. The bot must be an " -"administrator in the supergroup for this to work and must have the " -"appropriate administrator rights. Pass :code:`True` for all permissions " -"to lift restrictions from a user. Returns :code:`True` on success." +"Use this method to get a list of profile pictures for a user. Returns a " +":class:`aiogram.types.user_profile_photos.UserProfilePhotos` object." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#restrictchatmember" +#: aiogram.client.bot.Bot.get_user_profile_photos:4 of +msgid "" +"Sequential number of the first photo to be returned. By default, all " +"photos are returned." msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:5 -#: aiogram.client.bot.Bot.create_forum_topic:5 -#: aiogram.client.bot.Bot.delete_chat_sticker_set:5 -#: aiogram.client.bot.Bot.delete_forum_topic:5 -#: aiogram.client.bot.Bot.edit_forum_topic:5 -#: aiogram.client.bot.Bot.reopen_forum_topic:5 -#: aiogram.client.bot.Bot.restrict_chat_member:5 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:5 -#: aiogram.client.bot.Bot.set_chat_permissions:5 -#: aiogram.client.bot.Bot.set_chat_sticker_set:5 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:5 of +#: aiogram.client.bot.Bot.get_user_profile_photos:5 of msgid "" -"Unique identifier for the target chat or username of the target " -"supergroup (in the format :code:`@supergroupusername`)" +"Limits the number of photos to be retrieved. Values between 1-100 are " +"accepted. Defaults to 100." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:7 of -msgid "A JSON-serialized object for new user permissions" +#: aiogram.client.bot.Bot.get_user_profile_photos:7 of +msgid "" +"Returns a :class:`aiogram.types.user_profile_photos.UserProfilePhotos` " +"object." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:8 of +#: aiogram.client.bot.Bot.get_webhook_info:1 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" +"Use this method to get current webhook status. Requires no parameters. On" +" success, returns a :class:`aiogram.types.webhook_info.WebhookInfo` " +"object. If the bot is using " +":class:`aiogram.methods.get_updates.GetUpdates`, will return an object " +"with the *url* field empty." +msgstr "" + +#: aiogram.client.bot.Bot.get_webhook_info:4 of +msgid "" +"If the bot is using :class:`aiogram.methods.get_updates.GetUpdates`, will" +" return an object with the *url* field empty." +msgstr "" + +#: aiogram.client.bot.Bot.leave_chat:1 of +msgid "" +"Use this method for your bot to leave a group, supergroup or channel. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.log_out:1 of +msgid "" +"Use this method to log out from the cloud Bot API server before launching" +" the bot locally. You **must** log out the bot before running it locally," +" otherwise there is no guarantee that the bot will receive updates. After" +" a successful call, you can immediately log in on a local server, but " +"will not be able to log in back to the cloud Bot API server for 10 " +"minutes. Returns :code:`True` on success. Requires no parameters." +msgstr "" + +#: aiogram.client.bot.Bot.pin_chat_message:1 of +msgid "" +"Use this method to add a message to the list of pinned messages in a " +"chat. If the chat is not a private chat, the bot must be an administrator" +" in the chat for this to work and must have the 'can_pin_messages' " +"administrator right in a supergroup or 'can_edit_messages' administrator " +"right in a channel. Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.pin_chat_message:4 of +msgid "Identifier of a message to pin" +msgstr "" + +#: aiogram.client.bot.Bot.pin_chat_message:5 of +msgid "" +"Pass :code:`True` if it is not necessary to send a notification to all " +"chat members about the new pinned message. Notifications are always " +"disabled in channels and private chats." msgstr "" #: aiogram.client.bot.Bot.promote_chat_member:1 of @@ -1804,15 +2011,11 @@ msgid "" "boolean parameters to demote a user. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#promotechatmember" -msgstr "" - -#: aiogram.client.bot.Bot.promote_chat_member:7 of +#: aiogram.client.bot.Bot.promote_chat_member:5 of msgid "Pass :code:`True` if the administrator's presence in the chat is hidden" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:8 of +#: aiogram.client.bot.Bot.promote_chat_member:6 of msgid "" "Pass :code:`True` if the administrator can access the chat event log, " "chat statistics, message statistics in channels, see channel members, see" @@ -1820,33 +2023,33 @@ msgid "" " any other administrator privilege" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:9 of +#: aiogram.client.bot.Bot.promote_chat_member:7 of msgid "" "Pass :code:`True` if the administrator can create channel posts, channels" " only" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:10 of +#: aiogram.client.bot.Bot.promote_chat_member:8 of msgid "" "Pass :code:`True` if the administrator can edit messages of other users " "and can pin messages, channels only" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:11 of +#: aiogram.client.bot.Bot.promote_chat_member:9 of msgid "Pass :code:`True` if the administrator can delete messages of other users" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:12 of +#: aiogram.client.bot.Bot.promote_chat_member:10 of msgid "Pass :code:`True` if the administrator can manage video chats" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:13 of +#: aiogram.client.bot.Bot.promote_chat_member:11 of msgid "" "Pass :code:`True` if the administrator can restrict, ban or unban chat " "members" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:14 of +#: aiogram.client.bot.Bot.promote_chat_member:12 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 " @@ -1854,736 +2057,772 @@ msgid "" "appointed by him)" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:15 of +#: aiogram.client.bot.Bot.promote_chat_member:13 of msgid "" "Pass :code:`True` if the administrator can change chat title, photo and " "other settings" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:16 of +#: aiogram.client.bot.Bot.promote_chat_member:14 of msgid "Pass :code:`True` if the administrator can invite new users to the chat" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:17 of +#: aiogram.client.bot.Bot.promote_chat_member:15 of msgid "Pass :code:`True` if the administrator can pin messages, supergroups only" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:18 of +#: aiogram.client.bot.Bot.promote_chat_member:16 of msgid "" "Pass :code:`True` if the user is allowed to create, rename, close, and " "reopen forum topics, supergroups only" msgstr "" -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:1 of +#: aiogram.client.bot.Bot.reopen_forum_topic:1 of msgid "" -"Use this method to set a custom title for an administrator in a " -"supergroup promoted by the bot. Returns :code:`True` on success." -msgstr "" - -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle" +"Use this method to reopen a closed topic in a forum supergroup chat. The " +"bot must be an administrator in the chat for this to work and must have " +"the *can_manage_topics* administrator rights, unless it is the creator of" +" the topic. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:7 of +#: aiogram.client.bot.Bot.restrict_chat_member:1 of msgid "" -"New custom title for the administrator; 0-16 characters, emoji are not " -"allowed" +"Use this method to restrict a user in a supergroup. The bot must be an " +"administrator in the supergroup for this to work and must have the " +"appropriate administrator rights. Pass :code:`True` for all permissions " +"to lift restrictions from a user. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_sender_chat:1 of -msgid "" -"Use this method to ban a channel chat in a supergroup or a channel. Until" -" the chat is `unbanned " -"`_, the owner of " -"the banned chat won't be able to send messages on behalf of **any of " -"their channels**. The bot must be an administrator in the supergroup or " -"channel for this to work and must have the appropriate administrator " -"rights. Returns :code:`True` on success." +#: aiogram.client.bot.Bot.restrict_chat_member:5 of +msgid "A JSON-serialized object for new user permissions" msgstr "" -#: aiogram.client.bot.Bot.ban_chat_sender_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#banchatsenderchat" +#: aiogram.client.bot.Bot.restrict_chat_member:6 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.client.bot.Bot.ban_chat_sender_chat:6 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:6 of -msgid "Unique identifier of the target sender chat" +#: aiogram.client.bot.Bot.revoke_chat_invite_link:1 of +msgid "" +"Use this method to revoke an invite link created by the bot. If the " +"primary link is revoked, a new link is automatically generated. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns the revoked invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_sender_chat:1 of +#: aiogram.client.bot.Bot.revoke_chat_invite_link:3 of msgid "" -"Use this method to unban a previously banned channel chat in a supergroup" -" or channel. The bot must be an administrator for this to work and must " -"have the appropriate administrator rights. Returns :code:`True` on " -"success." +"Unique identifier of the target chat or username of the target channel " +"(in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.unban_chat_sender_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#unbanchatsenderchat" +#: aiogram.client.bot.Bot.revoke_chat_invite_link:4 of +msgid "The invite link to revoke" msgstr "" -#: aiogram.client.bot.Bot.set_chat_permissions:1 of +#: aiogram.client.bot.Bot.revoke_chat_invite_link:6 of msgid "" -"Use this method to set default chat permissions for all members. The bot " -"must be an administrator in the group or a supergroup for this to work " -"and must have the *can_restrict_members* administrator rights. Returns " -":code:`True` on success." -msgstr "" - -#: aiogram.client.bot.Bot.set_chat_permissions:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatpermissions" +"Returns the revoked invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.set_chat_permissions:6 of -msgid "A JSON-serialized object for new default chat permissions" +#: aiogram.client.bot.Bot.send_animation:1 of +msgid "" +"Use this method to send animation files (GIF or H.264/MPEG-4 AVC video " +"without sound). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send animation files of up to 50 MB in size, this limit may be changed in" +" the future." msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_animation:4 of msgid "" -"Use this method to generate a new primary invite link for a chat; any " -"previously generated primary link is revoked. The bot must be an " -"administrator in the chat for this to work and must have the appropriate " -"administrator rights. Returns the new invite link as *String* on success." +"Animation to send. Pass a file_id as String to send an animation that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an animation from the Internet, or upload a " +"new animation using multipart/form-data. :ref:`More information on " +"Sending Files » `" msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:3 of -msgid "" -"Note: Each administrator in a chat generates their own invite links. Bots" -" can't use invite links generated by other administrators. If you want " -"your bot to work with invite links, it will need to generate its own link" -" using " -":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or " -"by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your " -"bot needs to generate a new primary invite link replacing its previous " -"one, use " -":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " -"again." +#: aiogram.client.bot.Bot.send_animation:6 of +msgid "Duration of sent animation in seconds" msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:5 of -msgid "Source: https://core.telegram.org/bots/api#exportchatinvitelink" +#: aiogram.client.bot.Bot.send_animation:7 of +msgid "Animation width" msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:9 of -msgid "Returns the new invite link as String on success." +#: aiogram.client.bot.Bot.send_animation:8 of +msgid "Animation height" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_animation:9 aiogram.client.bot.Bot.send_audio:13 +#: aiogram.client.bot.Bot.send_document:6 aiogram.client.bot.Bot.send_video:9 +#: aiogram.client.bot.Bot.send_video_note:8 of msgid "" -"Use this method to create an additional invite link for a chat. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. The link can be revoked using the " -"method " -":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. " -"Returns the new invite link as " -":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +"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 » `" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:3 of -msgid "Source: https://core.telegram.org/bots/api#createchatinvitelink" +#: aiogram.client.bot.Bot.send_animation:10 of +msgid "" +"Animation caption (may also be used when resending animation by " +"*file_id*), 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:6 -#: aiogram.client.bot.Bot.edit_chat_invite_link:7 of -msgid "Invite link name; 0-32 characters" +#: aiogram.client.bot.Bot.send_animation:11 of +msgid "" +"Mode for parsing entities in the animation caption. See `formatting " +"options `_ for " +"more details." msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:7 -#: aiogram.client.bot.Bot.edit_chat_invite_link:8 of -msgid "Point in time (Unix timestamp) when the link will expire" +#: aiogram.client.bot.Bot.send_animation:19 of +msgid "" +"Bots can currently send animation files of up to 50 MB in size, this " +"limit may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:8 -#: aiogram.client.bot.Bot.edit_chat_invite_link:9 of +#: aiogram.client.bot.Bot.send_audio:1 of msgid "" -"The maximum number of users that can be members of the chat " -"simultaneously after joining the chat via this invite link; 1-99999" +"Use this method to send audio files, if you want Telegram clients to " +"display them in the music player. Your audio must be in the .MP3 or .M4A " +"format. On success, the sent :class:`aiogram.types.message.Message` is " +"returned. Bots can currently send audio files of up to 50 MB in size, " +"this limit may be changed in the future. For sending voice messages, use " +"the :class:`aiogram.methods.send_voice.SendVoice` method instead." msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:9 -#: aiogram.client.bot.Bot.edit_chat_invite_link:10 of +#: aiogram.client.bot.Bot.send_audio:5 of msgid "" -":code:`True`, if users joining the chat via the link need to be approved " -"by chat administrators. If :code:`True`, *member_limit* can't be " -"specified" +"Audio file to send. Pass a file_id as String to send an audio file that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an audio file from the Internet, or upload a " +"new one using multipart/form-data. :ref:`More information on Sending " +"Files » `" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:11 of -msgid "Returns the new invite link as ChatInviteLink object." +#: aiogram.client.bot.Bot.send_audio:7 of +msgid "Audio caption, 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_audio:8 of msgid "" -"Use this method to edit a non-primary invite link created by the bot. The" -" bot must be an administrator in the chat for this to work and must have " -"the appropriate administrator rights. Returns the edited invite link as a" -" :class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +"Mode for parsing entities in the audio caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:3 of -msgid "Source: https://core.telegram.org/bots/api#editchatinvitelink" +#: aiogram.client.bot.Bot.send_audio:10 of +msgid "Duration of the audio in seconds" msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:6 of -msgid "The invite link to edit" +#: aiogram.client.bot.Bot.send_audio:11 of +msgid "Performer" msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:12 of -msgid "Returns the edited invite link as a ChatInviteLink object." +#: aiogram.client.bot.Bot.send_audio:12 of +msgid "Track name" msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_audio:20 of msgid "" -"Use this method to revoke an invite link created by the bot. If the " -"primary link is revoked, a new link is automatically generated. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Returns the revoked invite link as " -":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +"Bots can currently send audio files of up to 50 MB in size, this limit " +"may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:3 of -msgid "Source: https://core.telegram.org/bots/api#revokechatinvitelink" -msgstr "" - -#: aiogram.client.bot.Bot.revoke_chat_invite_link:5 of +#: aiogram.client.bot.Bot.send_chat_action:1 of msgid "" -"Unique identifier of the target chat or username of the target channel " -"(in the format :code:`@channelusername`)" +"Use this method when you need to tell the user that something is " +"happening on the bot's side. The status is set for 5 seconds or less " +"(when a message arrives from your bot, Telegram clients clear its typing " +"status). Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:6 of -msgid "The invite link to revoke" +#: aiogram.client.bot.Bot.send_chat_action:3 of +msgid "" +"Example: The `ImageBot `_ needs some time to " +"process a request and upload the image. Instead of sending a text message" +" along the lines of 'Retrieving image, please wait…', the bot may use " +":class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = " +"*upload_photo*. The user will see a 'sending photo' status for the bot." msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:8 of -msgid "Returns the revoked invite link as ChatInviteLink object." +#: aiogram.client.bot.Bot.send_chat_action:5 of +msgid "" +"We only recommend using this method when a response from the bot will " +"take a **noticeable** amount of time to arrive." msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:1 of +#: aiogram.client.bot.Bot.send_chat_action:8 of msgid "" -"Use this method to approve a chat join request. The bot must be an " -"administrator in the chat for this to work and must have the " -"*can_invite_users* administrator right. Returns :code:`True` on success." +"Type of action to broadcast. Choose one, depending on what the user is " +"about to receive: *typing* for `text messages " +"`_, *upload_photo* for " +"`photos `_, *record_video* " +"or *upload_video* for `videos " +"`_, *record_voice* or " +"*upload_voice* for `voice notes " +"`_, *upload_document* for " +"`general files `_, " +"*choose_sticker* for `stickers " +"`_, *find_location* for " +"`location data `_, " +"*record_video_note* or *upload_video_note* for `video notes " +"`_." msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:3 of -msgid "Source: https://core.telegram.org/bots/api#approvechatjoinrequest" +#: aiogram.client.bot.Bot.send_chat_action:10 of +msgid "The user will see a 'sending photo' status for the bot." msgstr "" -#: aiogram.client.bot.Bot.decline_chat_join_request:1 of +#: aiogram.client.bot.Bot.send_contact:1 of msgid "" -"Use this method to decline a chat join request. The bot must be an " -"administrator in the chat for this to work and must have the " -"*can_invite_users* administrator right. Returns :code:`True` on success." -msgstr "" - -#: aiogram.client.bot.Bot.decline_chat_join_request:3 of -msgid "Source: https://core.telegram.org/bots/api#declinechatjoinrequest" +"Use this method to send phone contacts. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_photo:1 of -msgid "" -"Use this method to set a new profile photo for the chat. Photos can't be " -"changed for private chats. The bot must be an administrator in the chat " -"for this to work and must have the appropriate administrator rights. " -"Returns :code:`True` on success." +#: aiogram.client.bot.Bot.send_contact:4 of +msgid "Contact's phone number" msgstr "" -#: aiogram.client.bot.Bot.set_chat_photo:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatphoto" +#: aiogram.client.bot.Bot.send_contact:5 of +msgid "Contact's first name" msgstr "" -#: aiogram.client.bot.Bot.set_chat_photo:6 of -msgid "New chat photo, uploaded using multipart/form-data" +#: aiogram.client.bot.Bot.send_contact:7 of +msgid "Contact's last name" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_photo:1 of +#: aiogram.client.bot.Bot.send_contact:8 of msgid "" -"Use this method to delete a chat photo. Photos can't be changed for " -"private chats. The bot must be an administrator in the chat for this to " -"work and must have the appropriate administrator rights. Returns " -":code:`True` on success." +"Additional data about the contact in the form of a `vCard " +"`_, 0-2048 bytes" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_photo:3 of -msgid "Source: https://core.telegram.org/bots/api#deletechatphoto" +#: aiogram.client.bot.Bot.send_dice:1 of +msgid "" +"Use this method to send an animated emoji that will display a random " +"value. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_title:1 of +#: aiogram.client.bot.Bot.send_dice:5 of msgid "" -"Use this method to change the title of a chat. Titles can't be changed " -"for private chats. The bot must be an administrator in the chat for this " -"to work and must have the appropriate administrator rights. Returns " -":code:`True` on success." +"Emoji on which the dice throw animation is based. Currently, must be one " +"of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯'" +" and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults " +"to '🎲'" msgstr "" -#: aiogram.client.bot.Bot.set_chat_title:3 of -msgid "Source: https://core.telegram.org/bots/api#setchattitle" +#: aiogram.client.bot.Bot.send_dice:7 of +msgid "Protects the contents of the sent message from forwarding" msgstr "" -#: aiogram.client.bot.Bot.set_chat_title:6 of -msgid "New chat title, 1-128 characters" +#: aiogram.client.bot.Bot.send_document:1 of +msgid "" +"Use this method to send general files. On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send files of any type of up to 50 MB in size, this limit may be changed " +"in the future." msgstr "" -#: aiogram.client.bot.Bot.set_chat_description:1 of +#: aiogram.client.bot.Bot.send_document:4 of msgid "" -"Use this method to change the description of a group, a supergroup or a " -"channel. The bot must be an administrator in the chat for this to work " -"and must have the appropriate administrator rights. Returns :code:`True` " -"on success." +"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 » `" msgstr "" -#: aiogram.client.bot.Bot.set_chat_description:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatdescription" +#: aiogram.client.bot.Bot.send_document:7 of +msgid "" +"Document caption (may also be used when resending documents by " +"*file_id*), 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.set_chat_description:6 of -msgid "New chat description, 0-255 characters" +#: aiogram.client.bot.Bot.send_document:8 of +msgid "" +"Mode for parsing entities in the document caption. See `formatting " +"options `_ for " +"more details." msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:1 of +#: aiogram.client.bot.Bot.send_document:10 of msgid "" -"Use this method to add a message to the list of pinned messages in a " -"chat. If the chat is not a private chat, the bot must be an administrator" -" in the chat for this to work and must have the 'can_pin_messages' " -"administrator right in a supergroup or 'can_edit_messages' administrator " -"right in a channel. Returns :code:`True` on success." +"Disables automatic server-side content type detection for files uploaded " +"using multipart/form-data" msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:3 of -msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +#: aiogram.client.bot.Bot.send_document:17 of +msgid "" +"Bots can currently send files of any type of up to 50 MB in size, this " +"limit may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:6 of -msgid "Identifier of a message to pin" +#: aiogram.client.bot.Bot.send_game:1 of +msgid "" +"Use this method to send a game. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:7 of -msgid "" -"Pass :code:`True` if it is not necessary to send a notification to all " -"chat members about the new pinned message. Notifications are always " -"disabled in channels and private chats." +#: aiogram.client.bot.Bot.send_game:3 of +msgid "Unique identifier for the target chat" msgstr "" -#: aiogram.client.bot.Bot.unpin_chat_message:1 of +#: aiogram.client.bot.Bot.send_game:4 of msgid "" -"Use this method to remove a message from the list of pinned messages in a" -" chat. If the chat is not a private chat, the bot must be an " -"administrator in the chat for this to work and must have the " -"'can_pin_messages' administrator right in a supergroup or " -"'can_edit_messages' administrator right in a channel. Returns " -":code:`True` on success." +"Short name of the game, serves as the unique identifier for the game. Set" +" up your games via `@BotFather `_." msgstr "" -#: aiogram.client.bot.Bot.unpin_chat_message:3 of -msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +#: aiogram.client.bot.Bot.send_game:10 of +msgid "" +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Play game_title' button will be shown. If not empty, the first " +"button must launch the game." msgstr "" -#: aiogram.client.bot.Bot.unpin_chat_message:6 of +#: aiogram.client.bot.Bot.send_invoice:1 of msgid "" -"Identifier of a message to unpin. If not specified, the most recent " -"pinned message (by sending date) will be unpinned." +"Use this method to send invoices. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.unpin_all_chat_messages:1 of +#: aiogram.client.bot.Bot.send_invoice:7 of msgid "" -"Use this method to clear the list of pinned messages in a chat. If the " -"chat is not a private chat, the bot must be an administrator in the chat " -"for this to work and must have the 'can_pin_messages' administrator right" -" in a supergroup or 'can_edit_messages' administrator right in a channel." -" Returns :code:`True` on success." +"Payment provider token, obtained via `@BotFather " +"`_" msgstr "" -#: aiogram.client.bot.Bot.unpin_all_chat_messages:3 of -msgid "Source: https://core.telegram.org/bots/api#unpinallchatmessages" +#: aiogram.client.bot.Bot.send_invoice:13 of +msgid "" +"Unique deep-linking parameter. If left empty, **forwarded copies** of the" +" sent message will have a *Pay* button, allowing multiple users to pay " +"directly from the forwarded message, using the same invoice. If non-" +"empty, forwarded copies of the sent message will have a *URL* button with" +" a deep link to the bot (instead of a *Pay* button), with the value used " +"as the start parameter" msgstr "" -#: aiogram.client.bot.Bot.leave_chat:1 of +#: aiogram.client.bot.Bot.send_invoice:15 of msgid "" -"Use this method for your bot to leave a group, supergroup or channel. " -"Returns :code:`True` on success." +"URL of the product photo for the invoice. Can be a photo of the goods or " +"a marketing image for a service. People like it better when they see what" +" they are paying for." msgstr "" -#: aiogram.client.bot.Bot.leave_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#leavechat" +#: aiogram.client.bot.Bot.send_invoice:23 of +msgid "Pass :code:`True` if the user's phone number should be sent to provider" msgstr "" -#: aiogram.client.bot.Bot.get_chat:5 -#: aiogram.client.bot.Bot.get_chat_administrators:5 -#: aiogram.client.bot.Bot.get_chat_member:5 -#: aiogram.client.bot.Bot.get_chat_member_count:5 -#: aiogram.client.bot.Bot.get_chat_members_count:9 -#: aiogram.client.bot.Bot.leave_chat:5 of -msgid "" -"Unique identifier for the target chat or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" +#: aiogram.client.bot.Bot.send_invoice:24 of +msgid "Pass :code:`True` if the user's email address should be sent to provider" msgstr "" -#: aiogram.client.bot.Bot.get_chat:1 of +#: aiogram.client.bot.Bot.send_invoice:30 of msgid "" -"Use this method to get up to date information about the chat (current " -"name of the user for one-on-one conversations, current username of a " -"user, group or channel, etc.). Returns a :class:`aiogram.types.chat.Chat`" -" object on success." +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Pay :code:`total price`' button will be shown. If not empty, the " +"first button must be a Pay button." msgstr "" -#: aiogram.client.bot.Bot.get_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#getchat" +#: aiogram.client.bot.Bot.send_location:1 of +msgid "" +"Use this method to send point on the map. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_chat:7 of -msgid "Returns a Chat object on success." +#: aiogram.client.bot.Bot.send_location:4 of +msgid "Latitude of the location" msgstr "" -#: aiogram.client.bot.Bot.get_chat_administrators:1 of -msgid "" -"Use this method to get a list of administrators in a chat, which aren't " -"bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` " -"objects." +#: aiogram.client.bot.Bot.send_location:5 of +msgid "Longitude of the location" msgstr "" -#: aiogram.client.bot.Bot.get_chat_administrators:3 of -msgid "Source: https://core.telegram.org/bots/api#getchatadministrators" +#: aiogram.client.bot.Bot.send_location:8 of +msgid "" +"Period in seconds for which the location will be updated (see `Live " +"Locations `_, should be between" +" 60 and 86400." msgstr "" -#: aiogram.client.bot.Bot.get_chat_administrators:7 of -msgid "Returns an Array of ChatMember objects." +#: aiogram.client.bot.Bot.send_location:9 of +msgid "" +"For live locations, a direction in which the user is moving, in degrees. " +"Must be between 1 and 360 if specified." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member_count:1 -#: aiogram.client.bot.Bot.get_chat_members_count:5 of +#: aiogram.client.bot.Bot.send_location:10 of msgid "" -"Use this method to get the number of members in a chat. Returns *Int* on " -"success." +"For live locations, a maximum distance for proximity alerts about " +"approaching another chat member, in meters. Must be between 1 and 100000 " +"if specified." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member_count:3 -#: aiogram.client.bot.Bot.get_chat_members_count:7 of -msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +#: aiogram.client.bot.Bot.send_media_group:1 of +msgid "" +"Use this method to send a group of photos, videos, documents or audios as" +" an album. Documents and audio files can be only grouped in an album with" +" messages of the same type. On success, an array of `Messages " +"`_ that were sent is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member_count:7 -#: aiogram.client.bot.Bot.get_chat_members_count:11 of -msgid "Returns Int on success." +#: aiogram.client.bot.Bot.send_media_group:4 of +msgid "" +"A JSON-serialized array describing messages to be sent, must include 2-10" +" items" msgstr "" -#: aiogram.client.bot.Bot.get_chat_member:1 of +#: aiogram.client.bot.Bot.send_media_group:6 of msgid "" -"Use this method to get information about a member of a chat. Returns a " -":class:`aiogram.types.chat_member.ChatMember` object on success." +"Sends messages `silently `_. Users will receive a notification with no sound." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#getchatmember" +#: aiogram.client.bot.Bot.send_media_group:7 of +msgid "Protects the contents of the sent messages from forwarding and saving" msgstr "" -#: aiogram.client.bot.Bot.get_chat_member:8 of -msgid "Returns a ChatMember object on success." +#: aiogram.client.bot.Bot.send_media_group:8 of +msgid "If the messages are a reply, ID of the original message" msgstr "" -#: aiogram.client.bot.Bot.set_chat_sticker_set:1 of +#: aiogram.client.bot.Bot.send_media_group:11 of msgid "" -"Use this method to set a new group sticker set for a supergroup. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Use the field *can_set_sticker_set* " -"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" -" to check if the bot can use this method. Returns :code:`True` on " -"success." +"On success, an array of `Messages " +"`_ that were sent is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatstickerset" +#: aiogram.client.bot.Bot.send_message:1 of +msgid "" +"Use this method to send text messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_sticker_set:6 of -msgid "Name of the sticker set to be set as the group sticker set" +#: aiogram.client.bot.Bot.send_message:4 of +msgid "Text of the message to be sent, 1-4096 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_sticker_set:7 -#: aiogram.client.bot.Bot.set_chat_sticker_set:8 of +#: aiogram.client.bot.Bot.send_photo:1 of msgid "" -"Use the field can_set_sticker_set optionally returned in getChat requests" -" to check if the bot can use this method. Returns True on success." +"Use this method to send photos. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.delete_chat_sticker_set:1 of +#: aiogram.client.bot.Bot.send_photo:4 of msgid "" -"Use this method to delete a group sticker set from a supergroup. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Use the field *can_set_sticker_set* " -"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" -" to check if the bot can use this method. Returns :code:`True` on " -"success." +"Photo to send. Pass a file_id as String to send a photo that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a photo from the Internet, or upload a new photo using " +"multipart/form-data. The photo must be at most 10 MB in size. The photo's" +" width and height must not exceed 10000 in total. Width and height ratio " +"must be at most 20. :ref:`More information on Sending Files » `" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#deletechatstickerset" +#: aiogram.client.bot.Bot.send_photo:6 of +msgid "" +"Photo caption (may also be used when resending photos by *file_id*), " +"0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:1 of +#: aiogram.client.bot.Bot.send_photo:7 of msgid "" -"Use this method to get custom emoji stickers, which can be used as a " -"forum topic icon by any user. Requires no parameters. Returns an Array of" -" :class:`aiogram.types.sticker.Sticker` objects." +"Mode for parsing entities in the photo caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:3 of -msgid "Source: https://core.telegram.org/bots/api#getforumtopiciconstickers" +#: aiogram.client.bot.Bot.send_poll:1 of +msgid "" +"Use this method to send a native poll. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:7 -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:6 of -msgid "Returns an Array of Sticker objects." +#: aiogram.client.bot.Bot.send_poll:4 of +msgid "Poll question, 1-300 characters" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:1 of +#: aiogram.client.bot.Bot.send_poll:5 of msgid "" -"Use this method to create a topic in a forum supergroup chat. The bot " -"must be an administrator in the chat for this to work and must have the " -"*can_manage_topics* administrator rights. Returns information about the " -"created topic as a :class:`aiogram.types.forum_topic.ForumTopic` object." +"A JSON-serialized list of answer options, 2-10 strings 1-100 characters " +"each" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#createforumtopic" +#: aiogram.client.bot.Bot.send_poll:7 of +msgid ":code:`True`, if the poll needs to be anonymous, defaults to :code:`True`" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:6 of -msgid "Topic name, 1-128 characters" +#: aiogram.client.bot.Bot.send_poll:8 of +msgid "Poll type, 'quiz' or 'regular', defaults to 'regular'" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:7 of +#: aiogram.client.bot.Bot.send_poll:9 of msgid "" -"Color of the topic icon in RGB format. Currently, must be one of " -"0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F" +":code:`True`, if the poll allows multiple answers, ignored for polls in " +"quiz mode, defaults to :code:`False`" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:8 of +#: aiogram.client.bot.Bot.send_poll:10 of msgid "" -"Unique identifier of the custom emoji shown as the topic icon. Use " -":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" -" to get all allowed custom emoji identifiers." +"0-based identifier of the correct answer option, required for polls in " +"quiz mode" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:10 of -msgid "Returns information about the created topic as a ForumTopic object." +#: aiogram.client.bot.Bot.send_poll:11 of +msgid "" +"Text that is shown when a user chooses an incorrect answer or taps on the" +" lamp icon in a quiz-style poll, 0-200 characters with at most 2 line " +"feeds after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:1 of +#: aiogram.client.bot.Bot.send_poll:12 of msgid "" -"Use this method to edit name and icon of a topic in a forum supergroup " -"chat. The bot must be an administrator in the chat for this to work and " -"must have *can_manage_topics* administrator rights, unless it is the " -"creator of the topic. Returns :code:`True` on success." +"Mode for parsing entities in the explanation. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#editforumtopic" +#: aiogram.client.bot.Bot.send_poll:13 of +msgid "" +"A JSON-serialized list of special entities that appear in the poll " +"explanation, which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:6 -#: aiogram.client.bot.Bot.delete_forum_topic:6 -#: aiogram.client.bot.Bot.edit_forum_topic:6 -#: aiogram.client.bot.Bot.reopen_forum_topic:6 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:6 of -msgid "Unique identifier for the target message thread of the forum topic" +#: aiogram.client.bot.Bot.send_poll:14 of +msgid "" +"Amount of time in seconds the poll will be active after creation, 5-600. " +"Can't be used together with *close_date*." msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:7 of -msgid "New topic name, 1-128 characters" +#: aiogram.client.bot.Bot.send_poll:15 of +msgid "" +"Point in time (Unix timestamp) when the poll will be automatically " +"closed. Must be at least 5 and no more than 600 seconds in the future. " +"Can't be used together with *open_period*." msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:8 of +#: aiogram.client.bot.Bot.send_poll:16 of msgid "" -"New unique identifier of the custom emoji shown as the topic icon. Use " -":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" -" to get all allowed custom emoji identifiers" +"Pass :code:`True` if the poll needs to be immediately closed. This can be" +" useful for poll preview." msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:1 of +#: aiogram.client.bot.Bot.send_sticker:1 of msgid "" -"Use this method to close an open topic in a forum supergroup chat. The " -"bot must be an administrator in the chat for this to work and must have " -"the *can_manage_topics* administrator rights, unless it is the creator of" -" the topic. Returns :code:`True` on success." +"Use this method to send static .WEBP, `animated " +"`_ .TGS, or `video " +"`_ .WEBM " +"stickers. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#closeforumtopic" +#: aiogram.client.bot.Bot.send_sticker:4 of +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 "" -#: aiogram.client.bot.Bot.reopen_forum_topic:1 of +#: aiogram.client.bot.Bot.send_venue:1 of msgid "" -"Use this method to reopen a closed topic in a forum supergroup chat. The " -"bot must be an administrator in the chat for this to work and must have " -"the *can_manage_topics* administrator rights, unless it is the creator of" -" the topic. Returns :code:`True` on success." +"Use this method to send information about a venue. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.reopen_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#reopenforumtopic" +#: aiogram.client.bot.Bot.send_venue:4 of +msgid "Latitude of the venue" msgstr "" -#: aiogram.client.bot.Bot.delete_forum_topic:1 of -msgid "" -"Use this method to delete a forum topic along with all its messages in a " -"forum supergroup chat. The bot must be an administrator in the chat for " -"this to work and must have the *can_delete_messages* administrator " -"rights. Returns :code:`True` on success." +#: aiogram.client.bot.Bot.send_venue:5 of +msgid "Longitude of the venue" +msgstr "" + +#: aiogram.client.bot.Bot.send_venue:6 of +msgid "Name of the venue" msgstr "" -#: aiogram.client.bot.Bot.delete_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#deleteforumtopic" +#: aiogram.client.bot.Bot.send_venue:7 of +msgid "Address of the venue" msgstr "" -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:1 of +#: aiogram.client.bot.Bot.send_venue:9 of +msgid "Foursquare identifier of the venue" +msgstr "" + +#: aiogram.client.bot.Bot.send_venue:10 of msgid "" -"Use this method to clear the list of pinned messages in a forum topic. " -"The bot must be an administrator in the chat for this to work and must " -"have the *can_pin_messages* administrator right in the supergroup. " -"Returns :code:`True` on success." +"Foursquare type of the venue, if known. (For example, " +"'arts_entertainment/default', 'arts_entertainment/aquarium' or " +"'food/icecream'.)" msgstr "" -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:3 of -msgid "Source: https://core.telegram.org/bots/api#unpinallforumtopicmessages" +#: aiogram.client.bot.Bot.send_venue:11 of +msgid "Google Places identifier of the venue" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:1 of +#: aiogram.client.bot.Bot.send_venue:12 of msgid "" -"Use this method to send answers to callback queries sent from `inline " -"keyboards `_. " -"The answer will be displayed to the user as a notification at the top of " -"the chat screen or as an alert. On success, :code:`True` is returned." +"Google Places type of the venue. (See `supported types " +"`_.)" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:3 of +#: aiogram.client.bot.Bot.send_video:1 of msgid "" -"Alternatively, the user can be redirected to the specified Game URL. For " -"this option to work, you must first create a game for your bot via " -"`@BotFather `_ and accept the terms. Otherwise, " -"you may use links like :code:`t.me/your_bot?start=XXXX` that open your " -"bot with a parameter." +"Use this method to send video files, Telegram clients support MPEG4 " +"videos (other formats may be sent as " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send video files of up to 50 MB in size, this limit may be changed in the" +" future." msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:5 of -msgid "Source: https://core.telegram.org/bots/api#answercallbackquery" +#: aiogram.client.bot.Bot.send_video:4 of +msgid "" +"Video to send. Pass a file_id as String to send a video that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a video from the Internet, or upload a new video using " +"multipart/form-data. :ref:`More information on Sending Files » `" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:7 -#: aiogram.client.bot.Bot.answer_pre_checkout_query:5 -#: aiogram.client.bot.Bot.answer_shipping_query:5 -#: aiogram.client.bot.Bot.answer_web_app_query:5 of -msgid "Unique identifier for the query to be answered" +#: aiogram.client.bot.Bot.send_video:6 aiogram.client.bot.Bot.send_video_note:6 +#: of +msgid "Duration of sent video in seconds" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:8 of -msgid "" -"Text of the notification. If not specified, nothing will be shown to the " -"user, 0-200 characters" +#: aiogram.client.bot.Bot.send_video:7 of +msgid "Video width" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:9 of -msgid "" -"If :code:`True`, an alert will be shown by the client instead of a " -"notification at the top of the chat screen. Defaults to *false*." +#: aiogram.client.bot.Bot.send_video:8 of +msgid "Video height" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:10 of +#: aiogram.client.bot.Bot.send_video:10 of msgid "" -"URL that will be opened by the user's client. If you have created a " -":class:`aiogram.types.game.Game` and accepted the conditions via " -"`@BotFather `_, specify the URL that opens your " -"game - note that this will only work if the query comes from a " -"`https://core.telegram.org/bots/api#inlinekeyboardbutton " -"`_ " -"*callback_game* button." +"Video caption (may also be used when resending videos by *file_id*), " +"0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:11 of +#: aiogram.client.bot.Bot.send_video:11 of msgid "" -"The maximum amount of time in seconds that the result of the callback " -"query may be cached client-side. Telegram apps will support caching " -"starting in version 3.14. Defaults to 0." +"Mode for parsing entities in the video caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:13 -#: aiogram.client.bot.Bot.answer_inline_query:15 -#: aiogram.client.bot.Bot.answer_pre_checkout_query:9 -#: aiogram.client.bot.Bot.answer_shipping_query:10 of -msgid "On success, True is returned." +#: aiogram.client.bot.Bot.send_video:13 of +msgid "Pass :code:`True` if the uploaded video is suitable for streaming" msgstr "" -#: aiogram.client.bot.Bot.set_my_commands:1 of +#: aiogram.client.bot.Bot.send_video:20 of msgid "" -"Use this method to change the list of the bot's commands. See `this " -"manual `_ for more " -"details about bot commands. Returns :code:`True` on success." +"Bots can currently send video files of up to 50 MB in size, this limit " +"may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.set_my_commands:3 of -msgid "Source: https://core.telegram.org/bots/api#setmycommands" +#: aiogram.client.bot.Bot.send_video_note:1 of +msgid "" +"As of `v.4.0 `_, " +"Telegram clients support rounded square MPEG4 videos of up to 1 minute " +"long. Use this method to send video messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_my_commands:5 of +#: aiogram.client.bot.Bot.send_video_note:4 of msgid "" -"A JSON-serialized list of bot commands to be set as the list of the bot's" -" commands. At most 100 commands can be specified." +"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" msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:5 -#: aiogram.client.bot.Bot.set_my_commands:6 of -msgid "" -"A JSON-serialized object, describing scope of users for which the " -"commands are relevant. Defaults to " -":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." +#: aiogram.client.bot.Bot.send_video_note:7 of +msgid "Video width and height, i.e. diameter of the video message" msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:6 -#: aiogram.client.bot.Bot.set_my_commands:7 of +#: aiogram.client.bot.Bot.send_voice:1 of msgid "" -"A two-letter ISO 639-1 language code. If empty, commands will be applied " -"to all users from the given scope, for whose language there are no " -"dedicated commands" +"Use this method to send audio files, if you want Telegram clients to " +"display the file as a playable voice message. For this to work, your " +"audio must be in an .OGG file encoded with OPUS (other formats may be " +"sent as :class:`aiogram.types.audio.Audio` or " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send voice messages of up to 50 MB in size, this limit may be changed in " +"the future." msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:1 of +#: aiogram.client.bot.Bot.send_voice:4 of msgid "" -"Use this method to delete the list of the bot's commands for the given " -"scope and user language. After deletion, `higher level commands " -"`_ will " -"be shown to affected users. Returns :code:`True` on success." +"Audio 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 » `" msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:3 of -msgid "Source: https://core.telegram.org/bots/api#deletemycommands" +#: aiogram.client.bot.Bot.send_voice:6 of +msgid "Voice message caption, 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:1 of +#: aiogram.client.bot.Bot.send_voice:7 of msgid "" -"Use this method to get the current list of the bot's commands for the " -"given scope and user language. Returns an Array of " -":class:`aiogram.types.bot_command.BotCommand` objects. If commands aren't" -" set, an empty list is returned." +"Mode for parsing entities in the voice message caption. See `formatting " +"options `_ for " +"more details." msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:3 of -msgid "Source: https://core.telegram.org/bots/api#getmycommands" +#: aiogram.client.bot.Bot.send_voice:9 of +msgid "Duration of the voice message in seconds" msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:5 of +#: aiogram.client.bot.Bot.send_voice:16 of msgid "" -"A JSON-serialized object, describing scope of users. Defaults to " -":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." +"Bots can currently send voice messages of up to 50 MB in size, this limit" +" may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:6 of -msgid "A two-letter ISO 639-1 language code or an empty string" +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:1 of +msgid "" +"Use this method to set a custom title for an administrator in a " +"supergroup promoted by the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:5 of +msgid "" +"New custom title for the administrator; 0-16 characters, emoji are not " +"allowed" msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:8 of +#: aiogram.client.bot.Bot.set_chat_description:1 of msgid "" -"Returns an Array of BotCommand objects. If commands aren't set, an empty " -"list is returned." +"Use this method to change the description of a group, a supergroup or a " +"channel. The bot must be an administrator in the chat for this to work " +"and must have the appropriate administrator rights. Returns :code:`True` " +"on success." +msgstr "" + +#: aiogram.client.bot.Bot.set_chat_description:4 of +msgid "New chat description, 0-255 characters" msgstr "" #: aiogram.client.bot.Bot.set_chat_menu_button:1 of @@ -2593,311 +2832,376 @@ msgid "" msgstr "" #: aiogram.client.bot.Bot.set_chat_menu_button:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatmenubutton" -msgstr "" - -#: aiogram.client.bot.Bot.set_chat_menu_button:5 of msgid "" "Unique identifier for the target private chat. If not specified, default " "bot's menu button will be changed" msgstr "" -#: aiogram.client.bot.Bot.set_chat_menu_button:6 of +#: aiogram.client.bot.Bot.set_chat_menu_button:4 of msgid "" "A JSON-serialized object for the bot's new menu button. Defaults to " ":class:`aiogram.types.menu_button_default.MenuButtonDefault`" msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:1 of +#: aiogram.client.bot.Bot.set_chat_permissions:1 of msgid "" -"Use this method to get the current value of the bot's menu button in a " -"private chat, or the default menu button. Returns " -":class:`aiogram.types.menu_button.MenuButton` on success." +"Use this method to set default chat permissions for all members. The bot " +"must be an administrator in the group or a supergroup for this to work " +"and must have the *can_restrict_members* administrator rights. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:3 of -msgid "Source: https://core.telegram.org/bots/api#getchatmenubutton" +#: aiogram.client.bot.Bot.set_chat_permissions:4 of +msgid "A JSON-serialized object for new default chat permissions" msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:5 of +#: aiogram.client.bot.Bot.set_chat_photo:1 of msgid "" -"Unique identifier for the target private chat. If not specified, default " -"bot's menu button will be returned" +"Use this method to set a new profile photo for the chat. Photos can't be " +"changed for private chats. The bot must be an administrator in the chat " +"for this to work and must have the appropriate administrator rights. " +"Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:7 of -msgid "Returns MenuButton on success." +#: aiogram.client.bot.Bot.set_chat_photo:4 of +msgid "New chat photo, uploaded using multipart/form-data" msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:1 of +#: aiogram.client.bot.Bot.set_chat_sticker_set:1 of 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." +"Use this method to set a new group sticker set for a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:3 of -msgid "Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights" +#: aiogram.client.bot.Bot.set_chat_sticker_set:4 of +msgid "Name of the sticker set to be set as the group sticker set" msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:5 of +#: aiogram.client.bot.Bot.set_chat_title:1 of msgid "" -"A JSON-serialized object describing new default administrator rights. If " -"not specified, the default administrator rights will be cleared." +"Use this method to change the title of a chat. Titles can't be changed " +"for private chats. The bot must be an administrator in the chat for this " +"to work and must have the appropriate administrator rights. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:6 of -msgid "" -"Pass :code:`True` to change the default administrator rights of the bot " -"in channels. Otherwise, the default administrator rights of the bot for " -"groups and supergroups will be changed." +#: aiogram.client.bot.Bot.set_chat_title:4 of +msgid "New chat title, 1-128 characters" msgstr "" -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:1 of +#: aiogram.client.bot.Bot.set_game_score:1 of msgid "" -"Use this method to get the current default administrator rights of the " -"bot. Returns " -":class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` " -"on success." +"Use this method to set the score of the specified user in a game message." +" On success, if the message is not an inline message, the " +":class:`aiogram.types.message.Message` is returned, otherwise " +":code:`True` is returned. Returns an error, if the new score is not " +"greater than the user's current score in the chat and *force* is " +":code:`False`." msgstr "" -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:3 of -msgid "Source: https://core.telegram.org/bots/api#getmydefaultadministratorrights" +#: aiogram.client.bot.Bot.set_game_score:3 +#: aiogram.client.bot.Bot.set_passport_data_errors:4 of +msgid "User identifier" msgstr "" -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:5 of -msgid "" -"Pass :code:`True` to get default administrator rights of the bot in " -"channels. Otherwise, default administrator rights of the bot for groups " -"and supergroups will be returned." -msgstr "" - -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:7 of -msgid "Returns ChatAdministratorRights on success." +#: aiogram.client.bot.Bot.set_game_score:4 of +msgid "New score, must be non-negative" msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:1 of +#: aiogram.client.bot.Bot.set_game_score:5 of msgid "" -"Use this method to edit text and `game " -"`_ messages. 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." -msgstr "" - -#: aiogram.client.bot.Bot.edit_message_text:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagetext" -msgstr "" - -#: aiogram.client.bot.Bot.edit_message_text:5 of -msgid "New text of the message, 1-4096 characters after entities parsing" +"Pass :code:`True` if the high score is allowed to decrease. This can be " +"useful when fixing mistakes or banning cheaters" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:11 -#: aiogram.client.bot.Bot.edit_message_reply_markup:8 -#: aiogram.client.bot.Bot.edit_message_text:12 of +#: aiogram.client.bot.Bot.set_game_score:6 of msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_." +"Pass :code:`True` if the game message should not be automatically edited " +"to include the current scoreboard" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:1 of +#: aiogram.client.bot.Bot.set_game_score:11 of msgid "" -"Use this method to edit captions of messages. 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." -msgstr "" - -#: aiogram.client.bot.Bot.edit_message_caption:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagecaption" +"Returns an error, if the new score is not greater than the user's current" +" score in the chat and *force* is :code:`False`." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:8 of -msgid "New caption of the message, 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.set_my_commands:1 of +msgid "" +"Use this method to change the list of the bot's commands. See `this " +"manual `_ for more " +"details about bot commands. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:9 of +#: aiogram.client.bot.Bot.set_my_commands:3 of msgid "" -"Mode for parsing entities in the message caption. See `formatting options" -" `_ for more " -"details." +"A JSON-serialized list of bot commands to be set as the list of the bot's" +" commands. At most 100 commands can be specified." msgstr "" -#: aiogram.client.bot.Bot.edit_message_media:1 of +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:1 of msgid "" -"Use this method to edit animation, audio, document, photo, or video " -"messages. If a message is part of a message album, then it can be edited " -"only to an audio for audio albums, only to a document for document albums" -" and to a photo or a video otherwise. When an inline message is edited, a" -" new file can't be uploaded; use a previously uploaded file via its " -"file_id or specify a URL. On success, if the edited message is not an " -"inline message, the edited :class:`aiogram.types.message.Message` is " -"returned, otherwise :code:`True` is returned." +"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 "" -#: aiogram.client.bot.Bot.edit_message_media:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagemedia" +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:3 of +msgid "" +"A JSON-serialized object describing new default administrator rights. If " +"not specified, the default administrator rights will be cleared." msgstr "" -#: aiogram.client.bot.Bot.edit_message_media:5 of -msgid "A JSON-serialized object for a new media content of the message" +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:4 of +msgid "" +"Pass :code:`True` to change the default administrator rights of the bot " +"in channels. Otherwise, the default administrator rights of the bot for " +"groups and supergroups will be changed." msgstr "" -#: aiogram.client.bot.Bot.edit_message_reply_markup:1 of +#: aiogram.client.bot.Bot.set_passport_data_errors:1 of msgid "" -"Use this method to edit only the reply markup of messages. 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." +"Informs a user that some of the Telegram Passport elements they provided " +"contains errors. The user will not be able to re-submit their Passport to" +" you until the errors are fixed (the contents of the field for which you " +"returned the error must change). Returns :code:`True` on success. Use " +"this if the data submitted by the user doesn't satisfy the standards your" +" service requires for any reason. For example, if a birthday date seems " +"invalid, a submitted document is blurry, a scan shows evidence of " +"tampering, etc. Supply some details in the error message to make sure the" +" user knows how to correct the issues." msgstr "" -#: aiogram.client.bot.Bot.edit_message_reply_markup:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagereplymarkup" +#: aiogram.client.bot.Bot.set_passport_data_errors:5 of +msgid "A JSON-serialized array describing the errors" msgstr "" -#: aiogram.client.bot.Bot.stop_poll:1 of +#: aiogram.client.bot.Bot.set_passport_data_errors:7 of msgid "" -"Use this method to stop a poll which was sent by the bot. On success, the" -" stopped :class:`aiogram.types.poll.Poll` is returned." +"Supply some details in the error message to make sure the user knows how " +"to correct the issues." msgstr "" -#: aiogram.client.bot.Bot.stop_poll:3 of -msgid "Source: https://core.telegram.org/bots/api#stoppoll" +#: aiogram.client.bot.Bot.set_sticker_position_in_set:1 of +msgid "" +"Use this method to move a sticker in a set created by the bot to a " +"specific position. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.stop_poll:6 of -msgid "Identifier of the original message with the poll" +#: aiogram.client.bot.Bot.set_sticker_position_in_set:4 of +msgid "New sticker position in the set, zero-based" msgstr "" -#: aiogram.client.bot.Bot.stop_poll:7 of +#: aiogram.client.bot.Bot.set_sticker_set_thumb:1 of msgid "" -"A JSON-serialized object for a new message `inline keyboard " -"`_." +"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.client.bot.Bot.stop_poll:9 of -msgid "On success, the stopped Poll is returned." +#: aiogram.client.bot.Bot.set_sticker_set_thumb:4 of +msgid "User identifier of the sticker set owner" msgstr "" -#: aiogram.client.bot.Bot.delete_message:1 of +#: aiogram.client.bot.Bot.set_sticker_set_thumb:5 of msgid "" -"Use this method to delete a message, including service messages, with the" -" following limitations:" -msgstr "" - -#: aiogram.client.bot.Bot.delete_message:3 of -msgid "A message can only be deleted if it was sent less than 48 hours ago." +"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 "" -#: aiogram.client.bot.Bot.delete_message:5 of +#: aiogram.client.bot.Bot.set_webhook:1 of msgid "" -"Service messages about a supergroup, channel, or forum topic creation " -"can't be deleted." +"Use this method to specify a URL and receive incoming updates via an " +"outgoing webhook. Whenever there is an update for the bot, we will send " +"an HTTPS POST request to the specified URL, containing a JSON-serialized " +":class:`aiogram.types.update.Update`. In case of an unsuccessful request," +" we will give up after a reasonable amount of attempts. Returns " +":code:`True` on success. If you'd like to make sure that the webhook was " +"set by you, you can specify secret data in the parameter *secret_token*. " +"If specified, the request will contain a header 'X-Telegram-Bot-Api-" +"Secret-Token' with the secret token as content." msgstr "" -#: aiogram.client.bot.Bot.delete_message:7 of +#: aiogram.client.bot.Bot.set_webhook:6 of msgid "" -"A dice message in a private chat can only be deleted if it was sent more " -"than 24 hours ago." +"**1.** You will not be able to receive updates using " +":class:`aiogram.methods.get_updates.GetUpdates` for as long as an " +"outgoing webhook is set up." msgstr "" -#: aiogram.client.bot.Bot.delete_message:9 of +#: aiogram.client.bot.Bot.set_webhook:8 of msgid "" -"Bots can delete outgoing messages in private chats, groups, and " -"supergroups." +"**2.** To use a self-signed certificate, you need to upload your `public " +"key certificate `_ using " +"*certificate* parameter. Please upload as InputFile, sending a String " +"will not work." msgstr "" -#: aiogram.client.bot.Bot.delete_message:11 of -msgid "Bots can delete incoming messages in private chats." +#: aiogram.client.bot.Bot.set_webhook:10 of +msgid "" +"**3.** Ports currently supported *for webhooks*: **443, 80, 88, 8443**. " +"If you're having any trouble setting up webhooks, please check out this " +"`amazing guide to webhooks `_." msgstr "" -#: aiogram.client.bot.Bot.delete_message:13 of +#: aiogram.client.bot.Bot.set_webhook:13 of msgid "" -"Bots granted *can_post_messages* permissions can delete outgoing messages" -" in channels." +"HTTPS URL to send updates to. Use an empty string to remove webhook " +"integration" msgstr "" -#: aiogram.client.bot.Bot.delete_message:15 of +#: aiogram.client.bot.Bot.set_webhook:14 of msgid "" -"If the bot is an administrator of a group, it can delete any message " -"there." +"Upload your public key certificate so that the root certificate in use " +"can be checked. See our `self-signed guide " +"`_ for details." msgstr "" -#: aiogram.client.bot.Bot.delete_message:17 of +#: aiogram.client.bot.Bot.set_webhook:15 of msgid "" -"If the bot has *can_delete_messages* permission in a supergroup or a " -"channel, it can delete any message there." +"The fixed IP address which will be used to send webhook requests instead " +"of the IP address resolved through DNS" msgstr "" -#: aiogram.client.bot.Bot.delete_message:19 of -msgid "Returns :code:`True` on success." +#: aiogram.client.bot.Bot.set_webhook:16 of +msgid "" +"The maximum allowed number of simultaneous HTTPS connections to the " +"webhook for update delivery, 1-100. Defaults to *40*. Use lower values to" +" limit the load on your bot's server, and higher values to increase your " +"bot's throughput." msgstr "" -#: aiogram.client.bot.Bot.delete_message:21 of -msgid "Source: https://core.telegram.org/bots/api#deletemessage" +#: aiogram.client.bot.Bot.set_webhook:19 of +msgid "" +"A secret token to be sent in a header 'X-Telegram-Bot-Api-Secret-Token' " +"in every webhook request, 1-256 characters. Only characters :code:`A-Z`, " +":code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. The header" +" is useful to ensure that the request comes from a webhook set by you." msgstr "" -#: aiogram.client.bot.Bot.delete_message:24 of -msgid "Identifier of the message to delete" +#: aiogram.client.bot.Bot.set_webhook:21 of +msgid "Please upload as InputFile, sending a String will not work." msgstr "" -#: aiogram.client.bot.Bot.send_sticker:1 of +#: aiogram.client.bot.Bot.stop_message_live_location:1 of msgid "" -"Use this method to send static .WEBP, `animated " -"`_ .TGS, or `video " -"`_ .WEBM " -"stickers. On success, the sent :class:`aiogram.types.message.Message` is " -"returned." +"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." msgstr "" -#: aiogram.client.bot.Bot.send_sticker:3 of -msgid "Source: https://core.telegram.org/bots/api#sendsticker" +#: aiogram.client.bot.Bot.stop_message_live_location:4 of +msgid "" +"Required if *inline_message_id* is not specified. Identifier of the " +"message with live location to stop" msgstr "" -#: aiogram.client.bot.Bot.send_sticker:6 of +#: aiogram.client.bot.Bot.stop_message_live_location:8 of 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 » `" +"On success, if the message is not an inline message, the edited " +":class:`aiogram.types.message.Message` is returned, otherwise " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:1 of +#: aiogram.client.bot.Bot.stop_poll:1 of msgid "" -"Use this method to get a sticker set. On success, a " -":class:`aiogram.types.sticker_set.StickerSet` object is returned." +"Use this method to stop a poll which was sent by the bot. On success, the" +" stopped :class:`aiogram.types.poll.Poll` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#getstickerset" +#: aiogram.client.bot.Bot.stop_poll:4 of +msgid "Identifier of the original message with the poll" msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:5 of -msgid "Name of the sticker set" +#: aiogram.client.bot.Bot.stop_poll:5 of +msgid "" +"A JSON-serialized object for a new message `inline keyboard " +"`_." msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:7 of -msgid "On success, a StickerSet object is returned." +#: aiogram.client.bot.Bot.stop_poll:7 of +msgid "On success, the stopped :class:`aiogram.types.poll.Poll` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:1 of +#: aiogram.client.bot.Bot.unban_chat_member:1 of msgid "" -"Use this method to get information about custom emoji stickers by their " -"identifiers. Returns an Array of :class:`aiogram.types.sticker.Sticker` " -"objects." +"Use this method to unban a previously banned user in a supergroup or " +"channel. The user will **not** return to the group or channel " +"automatically, but will be able to join via link, etc. The bot must be an" +" administrator for this to work. By default, this method guarantees that " +"after the call the user is not a member of the chat, but will be able to " +"join it. So if the user is a member of the chat they will also be " +"**removed** from the chat. If you don't want this, use the parameter " +"*only_if_banned*. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:3 of -msgid "Source: https://core.telegram.org/bots/api#getcustomemojistickers" +#: aiogram.client.bot.Bot.unban_chat_member:5 of +msgid "Do nothing if the user is not banned" msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:5 of +#: aiogram.client.bot.Bot.unban_chat_sender_chat:1 of msgid "" -"List of custom emoji identifiers. At most 200 custom emoji identifiers " -"can be specified." +"Use this method to unban a previously banned channel chat in a supergroup" +" or channel. The bot must be an administrator for this to work and must " +"have the appropriate administrator rights. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_all_chat_messages:1 of +msgid "" +"Use this method to clear the list of pinned messages in a chat. If the " +"chat is not a private chat, the bot must be an administrator in the chat " +"for this to work and must have the 'can_pin_messages' administrator right" +" in a supergroup or 'can_edit_messages' administrator right in a channel." +" Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:1 of +msgid "" +"Use this method to clear the list of pinned messages in a forum topic. " +"The bot must be an administrator in the chat for this to work and must " +"have the *can_pin_messages* administrator right in the supergroup. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_chat_message:1 of +msgid "" +"Use this method to remove a message from the list of pinned messages in a" +" chat. If the chat is not a private chat, the bot must be an " +"administrator in the chat for this to work and must have the " +"'can_pin_messages' administrator right in a supergroup or " +"'can_edit_messages' administrator right in a channel. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_chat_message:4 of +msgid "" +"Identifier of a message to unpin. If not specified, the most recent " +"pinned message (by sending date) will be unpinned." msgstr "" #: aiogram.client.bot.Bot.upload_sticker_file:1 of @@ -2909,774 +3213,590 @@ msgid "" msgstr "" #: aiogram.client.bot.Bot.upload_sticker_file:3 of -msgid "Source: https://core.telegram.org/bots/api#uploadstickerfile" -msgstr "" - -#: aiogram.client.bot.Bot.upload_sticker_file:5 of msgid "User identifier of sticker file owner" msgstr "" -#: aiogram.client.bot.Bot.upload_sticker_file:6 of +#: aiogram.client.bot.Bot.upload_sticker_file:4 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 » `" msgstr "" -#: aiogram.client.bot.Bot.upload_sticker_file:8 of -msgid "Returns the uploaded File on success." +#: aiogram.client.bot.Bot.upload_sticker_file:6 of +msgid "Returns the uploaded :class:`aiogram.types.file.File` on success." msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set: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." -msgstr "" +#~ msgid "" +#~ "Additional interface options. A JSON-" +#~ "serialized object for an `inline " +#~ "keyboard `_, " +#~ "`custom reply keyboard " +#~ "`_, instructions " +#~ "to remove reply keyboard or to " +#~ "force a reply from the user." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#createnewstickerset" -msgstr "" +#~ msgid "" +#~ "A JSON-serialized object for a new" +#~ " `inline keyboard `_." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:5 of -msgid "User identifier of created sticker set owner" -msgstr "" +#~ msgid "" +#~ "Additional interface options. A JSON-" +#~ "serialized object for an `inline " +#~ "keyboard `_, " +#~ "`custom reply keyboard " +#~ "`_, instructions " +#~ "to remove keyboard or to force a" +#~ " reply from the user." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:6 of -msgid "" -"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." -msgstr "" +#~ msgid "New chat title, 1-255 characters" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:7 of -msgid "Sticker set title, 1-64 characters" -msgstr "" +#~ msgid "" +#~ "Use this method to send answers to" +#~ " callback queries sent from `inline " +#~ "keyboards `_. " +#~ "The answer will be displayed to " +#~ "the user as a notification at the" +#~ " top of the chat screen or as" +#~ " an alert. On success, :code:`True` " +#~ "is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:7 -#: aiogram.client.bot.Bot.create_new_sticker_set:8 of -msgid "One or more emoji corresponding to the sticker" -msgstr "" +#~ msgid "" +#~ "Use this method to change the list" +#~ " of the bot's commands. See " +#~ "`https://core.telegram.org/bots#commands " +#~ "`_`https://core.telegram.org/bots#commands" +#~ " `_ for more" +#~ " details about bot commands. Returns " +#~ ":code:`True` on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:8 -#: aiogram.client.bot.Bot.create_new_sticker_set:9 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 "" +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:9 -#: aiogram.client.bot.Bot.create_new_sticker_set:10 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 "" +#~ msgid "" +#~ "A JSON-serialized object for a new" +#~ " message `inline keyboard " +#~ "`_." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:10 -#: aiogram.client.bot.Bot.create_new_sticker_set:11 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 "" +#~ msgid "" +#~ "`Deep-linking `_ parameter for the /start " +#~ "message sent to the bot when user" +#~ " presses the switch button. 1-64 " +#~ "characters, only :code:`A-Z`, :code:`a-z`, " +#~ ":code:`0-9`, :code:`_` and :code:`-` are " +#~ "allowed." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:12 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." -msgstr "" +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_. If empty, one 'Pay " +#~ ":code:`total price`' button will be " +#~ "shown. If not empty, the first " +#~ "button must be a Pay button." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:11 -#: aiogram.client.bot.Bot.create_new_sticker_set:13 of -msgid "" -"A JSON-serialized object for position where the mask should be placed on " -"faces" -msgstr "" +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_. If empty, one 'Play " +#~ "game_title' button will be shown. If " +#~ "not empty, the first button must " +#~ "launch the game." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set: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." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getupdates" +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:3 of -msgid "Source: https://core.telegram.org/bots/api#addstickertoset" -msgstr "" +#~ msgid "Returns an Array of Update objects." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:5 of -msgid "User identifier of sticker set owner" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setwebhook" +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:6 -#: aiogram.client.bot.Bot.set_sticker_set_thumb:5 of -msgid "Sticker set name" -msgstr "" +#~ msgid "Returns True on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_position_in_set:1 of -msgid "" -"Use this method to move a sticker in a set created by the bot to a " -"specific position. Returns :code:`True` on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletewebhook" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_position_in_set:3 of -msgid "Source: https://core.telegram.org/bots/api#setstickerpositioninset" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getwebhookinfo" +#~ msgstr "" -#: aiogram.client.bot.Bot.delete_sticker_from_set:5 -#: aiogram.client.bot.Bot.set_sticker_position_in_set:5 of -msgid "File identifier of the sticker" -msgstr "" +#~ msgid "" +#~ "On success, returns a WebhookInfo " +#~ "object. If the bot is using " +#~ "getUpdates, will return an object with" +#~ " the url field empty." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_position_in_set:6 of -msgid "New sticker position in the set, zero-based" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getme" +#~ msgstr "" -#: aiogram.client.bot.Bot.delete_sticker_from_set:1 of -msgid "" -"Use this method to delete a sticker from a set created by the bot. " -"Returns :code:`True` on success." -msgstr "" +#~ msgid "Returns basic information about the bot in form of a User object." +#~ msgstr "" -#: aiogram.client.bot.Bot.delete_sticker_from_set:3 of -msgid "Source: https://core.telegram.org/bots/api#deletestickerfromset" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#logout" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb: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 "" +#~ msgid "Source: https://core.telegram.org/bots/api#close" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb:3 of -msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" -msgstr "" +#~ msgid "" +#~ "The method will return error 429 " +#~ "in the first 10 minutes after the" +#~ " bot is launched. Returns True on " +#~ "success." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb:6 of -msgid "User identifier of the sticker set owner" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendmessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb:7 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 "" +#~ msgid "On success, the sent Message is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:1 of -msgid "" -"Use this method to send answers to an inline query. On success, " -":code:`True` is returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#forwardmessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:3 of -msgid "No more than **50** results per query are allowed." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#copymessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:5 of -msgid "Source: https://core.telegram.org/bots/api#answerinlinequery" -msgstr "" +#~ msgid "Returns the MessageId of the sent message on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:7 of -msgid "Unique identifier for the answered query" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendphoto" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:8 of -msgid "A JSON-serialized array of results for the inline query" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendaudio" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:9 of -msgid "" -"The maximum amount of time in seconds that the result of the inline query" -" may be cached on the server. Defaults to 300." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#senddocument" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:10 of -msgid "" -"Pass :code:`True` if results may be cached on the server side only for " -"the user that sent the query. By default, results may be returned to any " -"user who sends the same query" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvideo" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:11 of -msgid "" -"Pass the offset that a client should send in the next query with the same" -" text to receive more results. Pass an empty string if there are no more " -"results or if you don't support pagination. Offset length can't exceed 64" -" bytes." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendanimation" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:12 of -msgid "" -"If passed, clients will display a button with specified text that " -"switches the user to a private chat with the bot and sends the bot a " -"start message with the parameter *switch_pm_parameter*" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvoice" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:13 of -msgid "" -"`Deep-linking `_ " -"parameter for the /start message sent to the bot when user presses the " -"switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, " -":code:`0-9`, :code:`_` and :code:`-` are allowed." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvideonote" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:1 of -msgid "" -"Use this method to set the result of an interaction with a `Web App " -"`_ and send a corresponding " -"message on behalf of the user to the chat from which the query " -"originated. On success, a " -":class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is " -"returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendmediagroup" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:3 of -msgid "Source: https://core.telegram.org/bots/api#answerwebappquery" -msgstr "" +#~ msgid "On success, an array of Messages that were sent is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:6 of -msgid "A JSON-serialized object describing the message to be sent" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendlocation" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:8 of -msgid "On success, a SentWebAppMessage object is returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagelivelocation" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:1 of -msgid "" -"Use this method to send invoices. On success, the sent " -":class:`aiogram.types.message.Message` is returned." -msgstr "" +#~ msgid "" +#~ "On success, if the edited message " +#~ "is not an inline message, the " +#~ "edited Message is returned, otherwise " +#~ "True is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:3 of -msgid "Source: https://core.telegram.org/bots/api#sendinvoice" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#stopmessagelivelocation" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:5 -#: aiogram.client.bot.Bot.send_invoice:6 of -msgid "Product name, 1-32 characters" -msgstr "" +#~ msgid "" +#~ "On success, if the message is not" +#~ " an inline message, the edited " +#~ "Message is returned, otherwise True is" +#~ " returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:6 -#: aiogram.client.bot.Bot.send_invoice:7 of -msgid "Product description, 1-255 characters" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvenue" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:7 -#: aiogram.client.bot.Bot.send_invoice:8 of -msgid "" -"Bot-defined invoice payload, 1-128 bytes. This will not be displayed to " -"the user, use for your internal processes." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendcontact" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:9 of -msgid "" -"Payment provider token, obtained via `@BotFather " -"`_" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendpoll" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:9 -#: aiogram.client.bot.Bot.send_invoice:10 of -msgid "" -"Three-letter ISO 4217 currency code, see `more on currencies " -"`_" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#senddice" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:10 -#: aiogram.client.bot.Bot.send_invoice:11 of -msgid "" -"Price breakdown, a JSON-serialized list of components (e.g. product " -"price, tax, discount, delivery cost, delivery tax, bonus, etc.)" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendchataction" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:11 -#: aiogram.client.bot.Bot.send_invoice:13 of -msgid "" -"The maximum accepted amount for tips in the *smallest units* of the " -"currency (integer, **not** float/double). For example, for a maximum tip " -"of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* " -"parameter in `currencies.json " -"`_, it shows the" -" number of digits past the decimal point for each currency (2 for the " -"majority of currencies). Defaults to 0" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getuserprofilephotos" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:12 -#: aiogram.client.bot.Bot.send_invoice:14 of -msgid "" -"A JSON-serialized array of suggested amounts of tips in the *smallest " -"units* of the currency (integer, **not** float/double). At most 4 " -"suggested tip amounts can be specified. The suggested tip amounts must be" -" positive, passed in a strictly increased order and must not exceed " -"*max_tip_amount*." -msgstr "" +#~ msgid "Returns a UserProfilePhotos object." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:15 of -msgid "" -"Unique deep-linking parameter. If left empty, **forwarded copies** of the" -" sent message will have a *Pay* button, allowing multiple users to pay " -"directly from the forwarded message, using the same invoice. If non-" -"empty, forwarded copies of the sent message will have a *URL* button with" -" a deep link to the bot (instead of a *Pay* button), with the value used " -"as the start parameter" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getfile" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:13 -#: aiogram.client.bot.Bot.send_invoice:16 of -msgid "" -"JSON-serialized data about the invoice, which will be shared with the " -"payment provider. A detailed description of required fields should be " -"provided by the payment provider." -msgstr "" +#~ msgid "On success, a File object is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:17 of -msgid "" -"URL of the product photo for the invoice. Can be a photo of the goods or " -"a marketing image for a service. People like it better when they see what" -" they are paying for." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#banchatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:15 -#: aiogram.client.bot.Bot.send_invoice:18 of -msgid "Photo size in bytes" -msgstr "" +#~ msgid "" +#~ "In the case of supergroups and " +#~ "channels, the user will not be " +#~ "able to return to the chat on " +#~ "their own using invite links, etc. " +#~ "Returns True on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:16 -#: aiogram.client.bot.Bot.send_invoice:19 of -msgid "Photo width" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#unbanchatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:17 -#: aiogram.client.bot.Bot.send_invoice:20 of -msgid "Photo height" -msgstr "" +#~ msgid "" +#~ "The user will not return to the" +#~ " group or channel automatically, but " +#~ "will be able to join via link, " +#~ "etc. Returns True on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:18 -#: aiogram.client.bot.Bot.send_invoice:21 of -msgid "" -"Pass :code:`True` if you require the user's full name to complete the " -"order" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#restrictchatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:19 -#: aiogram.client.bot.Bot.send_invoice:22 of -msgid "" -"Pass :code:`True` if you require the user's phone number to complete the " -"order" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#promotechatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:20 -#: aiogram.client.bot.Bot.send_invoice:23 of -msgid "" -"Pass :code:`True` if you require the user's email address to complete the" -" order" -msgstr "" +#~ msgid "" +#~ "Source: " +#~ "https://core.telegram.org/bots/api#setchatadministratorcustomtitle" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:21 -#: aiogram.client.bot.Bot.send_invoice:24 of -msgid "" -"Pass :code:`True` if you require the user's shipping address to complete " -"the order" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#banchatsenderchat" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:25 of -msgid "Pass :code:`True` if the user's phone number should be sent to provider" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#unbanchatsenderchat" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:26 of -msgid "Pass :code:`True` if the user's email address should be sent to provider" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setchatpermissions" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:24 -#: aiogram.client.bot.Bot.send_invoice:27 of -msgid "Pass :code:`True` if the final price depends on the shipping method" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#exportchatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:32 of -msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_. If empty, " -"one 'Pay :code:`total price`' button will be shown. If not empty, the " -"first button must be a Pay button." -msgstr "" +#~ msgid "Returns the new invite link as String on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:1 of -msgid "" -"Use this method to create a link for an invoice. Returns the created " -"invoice link as *String* on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#createchatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:3 of -msgid "Source: https://core.telegram.org/bots/api#createinvoicelink" -msgstr "" +#~ msgid "Returns the new invite link as ChatInviteLink object." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:8 of -msgid "Payment provider token, obtained via `BotFather `_" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editchatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:14 of -msgid "" -"URL of the product photo for the invoice. Can be a photo of the goods or " -"a marketing image for a service." -msgstr "" +#~ msgid "Returns the edited invite link as a ChatInviteLink object." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:22 of -msgid "" -"Pass :code:`True` if the user's phone number should be sent to the " -"provider" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#revokechatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:23 of -msgid "" -"Pass :code:`True` if the user's email address should be sent to the " -"provider" -msgstr "" +#~ msgid "Returns the revoked invite link as ChatInviteLink object." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#approvechatjoinrequest" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#declinechatjoinrequest" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchatphoto" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#deletechatphoto" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchattitle" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchatdescription" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#unpinallchatmessages" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#leavechat" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchat" +#~ msgstr "" + +#~ msgid "Returns a Chat object on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatadministrators" +#~ msgstr "" + +#~ msgid "Returns an Array of ChatMember objects." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +#~ msgstr "" + +#~ msgid "Returns Int on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmember" +#~ msgstr "" + +#~ msgid "Returns a ChatMember object on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchatstickerset" +#~ msgstr "" + +#~ msgid "" +#~ "Use the field can_set_sticker_set optionally" +#~ " returned in getChat requests to " +#~ "check if the bot can use this " +#~ "method. Returns True on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#deletechatstickerset" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getforumtopiciconstickers" +#~ msgstr "" + +#~ msgid "Returns an Array of Sticker objects." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#createforumtopic" +#~ msgstr "" + +#~ msgid "" +#~ "Color of the topic icon in RGB " +#~ "format. Currently, must be one of " +#~ "0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, " +#~ "0xFF93B2, or 0xFB6F5F" +#~ msgstr "" + +#~ msgid "Returns information about the created topic as a ForumTopic object." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#editforumtopic" +#~ msgstr "" + +#~ msgid "" +#~ "New unique identifier of the custom " +#~ "emoji shown as the topic icon. Use" +#~ " " +#~ ":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +#~ " to get all allowed custom emoji " +#~ "identifiers" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#closeforumtopic" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#reopenforumtopic" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#deleteforumtopic" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#unpinallforumtopicmessages" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:26 of -msgid "Returns the created invoice link as String on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#answercallbackquery" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:1 of -msgid "" -"If you sent an invoice requesting a shipping address and the parameter " -"*is_flexible* was specified, the Bot API will send an " -":class:`aiogram.types.update.Update` with a *shipping_query* field to the" -" bot. Use this method to reply to shipping queries. On success, " -":code:`True` is returned." -msgstr "" +#~ msgid "On success, True is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:3 of -msgid "Source: https://core.telegram.org/bots/api#answershippingquery" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setmycommands" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:6 of -msgid "" -"Pass :code:`True` if delivery to the specified address is possible and " -":code:`False` if there are any problems (for example, if delivery to the " -"specified address is not possible)" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletemycommands" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:7 of -msgid "" -"Required if *ok* is :code:`True`. A JSON-serialized array of available " -"shipping options." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getmycommands" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:8 of -msgid "" -"Required if *ok* is :code:`False`. Error message in human readable form " -"that explains why it is impossible to complete the order (e.g. \"Sorry, " -"delivery to your desired address is unavailable'). Telegram will display " -"this message to the user." -msgstr "" +#~ msgid "" +#~ "Returns an Array of BotCommand objects." +#~ " If commands aren't set, an empty " +#~ "list is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:1 of -msgid "" -"Once the user has confirmed their payment and shipping details, the Bot " -"API sends the final confirmation in the form of an " -":class:`aiogram.types.update.Update` with the field *pre_checkout_query*." -" Use this method to respond to such pre-checkout queries. On success, " -":code:`True` is returned. **Note:** The Bot API must receive an answer " -"within 10 seconds after the pre-checkout query was sent." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setchatmenubutton" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:3 of -msgid "Source: https://core.telegram.org/bots/api#answerprecheckoutquery" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmenubutton" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:6 of -msgid "" -"Specify :code:`True` if everything is alright (goods are available, etc.)" -" and the bot is ready to proceed with the order. Use :code:`False` if " -"there are any problems." -msgstr "" +#~ msgid "Returns MenuButton on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:7 of -msgid "" -"Required if *ok* is :code:`False`. Error message in human readable form " -"that explains the reason for failure to proceed with the checkout (e.g. " -"\"Sorry, somebody just bought the last of our amazing black T-shirts " -"while you were busy filling out your payment details. Please choose a " -"different color or garment!\"). Telegram will display this message to the" -" user." -msgstr "" +#~ msgid "" +#~ "Source: " +#~ "https://core.telegram.org/bots/api#setmydefaultadministratorrights" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:1 of -msgid "" -"Informs a user that some of the Telegram Passport elements they provided " -"contains errors. The user will not be able to re-submit their Passport to" -" you until the errors are fixed (the contents of the field for which you " -"returned the error must change). Returns :code:`True` on success. Use " -"this if the data submitted by the user doesn't satisfy the standards your" -" service requires for any reason. For example, if a birthday date seems " -"invalid, a submitted document is blurry, a scan shows evidence of " -"tampering, etc. Supply some details in the error message to make sure the" -" user knows how to correct the issues." -msgstr "" +#~ msgid "" +#~ "Source: " +#~ "https://core.telegram.org/bots/api#getmydefaultadministratorrights" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:4 of -msgid "Source: https://core.telegram.org/bots/api#setpassportdataerrors" -msgstr "" +#~ msgid "Returns ChatAdministratorRights on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:5 -#: aiogram.client.bot.Bot.set_passport_data_errors:6 of -msgid "User identifier" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagetext" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:7 of -msgid "A JSON-serialized array describing the errors" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagecaption" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:9 of -msgid "" -"The user will not be able to re-submit their Passport to you until the " -"errors are fixed (the contents of the field for which you returned the " -"error must change). Returns True on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagemedia" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:1 of -msgid "" -"Use this method to send a game. On success, the sent " -":class:`aiogram.types.message.Message` is returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagereplymarkup" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:3 of -msgid "Source: https://core.telegram.org/bots/api#sendgame" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#stoppoll" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:5 of -msgid "Unique identifier for the target chat" -msgstr "" +#~ msgid "On success, the stopped Poll is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:6 of -msgid "" -"Short name of the game, serves as the unique identifier for the game. Set" -" up your games via `@BotFather `_." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletemessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:12 of -msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_. If empty, " -"one 'Play game_title' button will be shown. If not empty, the first " -"button must launch the game." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendsticker" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:1 of -msgid "" -"Use this method to set the score of the specified user in a game message." -" On success, if the message is not an inline message, the " -":class:`aiogram.types.message.Message` is returned, otherwise " -":code:`True` is returned. Returns an error, if the new score is not " -"greater than the user's current score in the chat and *force* is " -":code:`False`." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getstickerset" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:3 of -msgid "Source: https://core.telegram.org/bots/api#setgamescore" -msgstr "" +#~ msgid "On success, a StickerSet object is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:6 of -msgid "New score, must be non-negative" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getcustomemojistickers" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:7 of -msgid "" -"Pass :code:`True` if the high score is allowed to decrease. This can be " -"useful when fixing mistakes or banning cheaters" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#uploadstickerfile" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:8 of -msgid "" -"Pass :code:`True` if the game message should not be automatically edited " -"to include the current scoreboard" -msgstr "" +#~ msgid "Returns the uploaded File on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:8 -#: aiogram.client.bot.Bot.set_game_score:9 of -msgid "" -"Required if *inline_message_id* is not specified. Unique identifier for " -"the target chat" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#createnewstickerset" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:9 -#: aiogram.client.bot.Bot.set_game_score:10 of -msgid "" -"Required if *inline_message_id* is not specified. Identifier of the sent " -"message" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#addstickertoset" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:13 of -msgid "" -"On success, if the message is not an inline message, the Message is " -"returned, otherwise True is returned. Returns an error, if the new score " -"is not greater than the user's current score in the chat and force is " -"False." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setstickerpositioninset" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:1 of -msgid "" -"Use this method to get data for high score tables. Will return the score " -"of the specified user and several of their neighbors in a game. Returns " -"an Array of :class:`aiogram.types.game_high_score.GameHighScore` objects." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletestickerfromset" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:3 of -msgid "" -"This method will currently return scores for the target user, plus two of" -" their closest neighbors on each side. Will also return the top three " -"users if the user and their neighbors are not among them. Please note " -"that this behavior is subject to change." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:5 of -msgid "Source: https://core.telegram.org/bots/api#getgamehighscores" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#answerinlinequery" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:7 of -msgid "Target user id" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#answerwebappquery" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:12 of -msgid "" -"Will return the score of the specified user and several of their " -"neighbors in a game. Returns an Array of GameHighScore objects. This " -"method will currently return scores for the target user, plus two of " -"their closest neighbors on each side. Will also return the top three " -"users if the user and their neighbors are not among them." -msgstr "" +#~ msgid "On success, a SentWebAppMessage object is returned." +#~ msgstr "" -#~ msgid "" -#~ "Additional interface options. A JSON-" -#~ "serialized object for an `inline " -#~ "keyboard `_, " -#~ "`custom reply keyboard " -#~ "`_, instructions " -#~ "to remove reply keyboard or to " -#~ "force a reply from the user." +#~ msgid "Source: https://core.telegram.org/bots/api#sendinvoice" #~ msgstr "" -#~ msgid "" -#~ "A JSON-serialized object for a new" -#~ " `inline keyboard `_." +#~ msgid "Source: https://core.telegram.org/bots/api#createinvoicelink" #~ msgstr "" -#~ msgid "" -#~ "Additional interface options. A JSON-" -#~ "serialized object for an `inline " -#~ "keyboard `_, " -#~ "`custom reply keyboard " -#~ "`_, instructions " -#~ "to remove keyboard or to force a" -#~ " reply from the user." +#~ msgid "Returns the created invoice link as String on success." #~ msgstr "" -#~ msgid "New chat title, 1-255 characters" +#~ msgid "Source: https://core.telegram.org/bots/api#answershippingquery" #~ msgstr "" -#~ msgid "" -#~ "Use this method to send answers to" -#~ " callback queries sent from `inline " -#~ "keyboards `_. " -#~ "The answer will be displayed to " -#~ "the user as a notification at the" -#~ " top of the chat screen or as" -#~ " an alert. On success, :code:`True` " -#~ "is returned." +#~ msgid "Source: https://core.telegram.org/bots/api#answerprecheckoutquery" #~ msgstr "" -#~ msgid "" -#~ "Use this method to change the list" -#~ " of the bot's commands. See " -#~ "`https://core.telegram.org/bots#commands " -#~ "`_`https://core.telegram.org/bots#commands" -#~ " `_ for more" -#~ " details about bot commands. Returns " -#~ ":code:`True` on success." +#~ msgid "Source: https://core.telegram.org/bots/api#setpassportdataerrors" #~ msgstr "" #~ msgid "" -#~ "A JSON-serialized object for an " -#~ "`inline keyboard `_." +#~ "The user will not be able to " +#~ "re-submit their Passport to you " +#~ "until the errors are fixed (the " +#~ "contents of the field for which " +#~ "you returned the error must change). " +#~ "Returns True on success." #~ msgstr "" -#~ msgid "" -#~ "A JSON-serialized object for a new" -#~ " message `inline keyboard " -#~ "`_." +#~ msgid "Source: https://core.telegram.org/bots/api#sendgame" #~ msgstr "" -#~ msgid "" -#~ "`Deep-linking `_ parameter for the /start " -#~ "message sent to the bot when user" -#~ " presses the switch button. 1-64 " -#~ "characters, only :code:`A-Z`, :code:`a-z`, " -#~ ":code:`0-9`, :code:`_` and :code:`-` are " -#~ "allowed." +#~ msgid "Source: https://core.telegram.org/bots/api#setgamescore" #~ msgstr "" #~ msgid "" -#~ "A JSON-serialized object for an " -#~ "`inline keyboard `_. If empty, one 'Pay " -#~ ":code:`total price`' button will be " -#~ "shown. If not empty, the first " -#~ "button must be a Pay button." +#~ "On success, if the message is not" +#~ " an inline message, the Message is" +#~ " returned, otherwise True is returned. " +#~ "Returns an error, if the new score" +#~ " is not greater than the user's " +#~ "current score in the chat and " +#~ "force is False." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getgamehighscores" #~ msgstr "" #~ msgid "" -#~ "A JSON-serialized object for an " -#~ "`inline keyboard `_. If empty, one 'Play " -#~ "game_title' button will be shown. If " -#~ "not empty, the first button must " -#~ "launch the game." +#~ "Will return the score of the " +#~ "specified user and several of their " +#~ "neighbors in a game. Returns an " +#~ "Array of GameHighScore objects. This " +#~ "method will currently return scores for" +#~ " the target user, plus two of " +#~ "their closest neighbors on each side." +#~ " Will also return the top three " +#~ "users if the user and their " +#~ "neighbors are not among them." #~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/bot_command_scope_type.po b/docs/locale/en/LC_MESSAGES/api/enums/bot_command_scope_type.po new file mode 100644 index 0000000000..2d7153f4f3 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/bot_command_scope_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/bot_command_scope_type.rst:3 +msgid "BotCommandScopeType" +msgstr "" + +#: aiogram.enums.bot_command_scope_type.BotCommandScopeType:1 of +msgid "This object represents the scope to which bot commands are applied." +msgstr "" + +#: aiogram.enums.bot_command_scope_type.BotCommandScopeType:3 of +msgid "Source: https://core.telegram.org/bots/api#botcommandscope" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/chat_action.po b/docs/locale/en/LC_MESSAGES/api/enums/chat_action.po new file mode 100644 index 0000000000..0ba8fec171 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/chat_action.po @@ -0,0 +1,66 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/chat_action.rst:3 +msgid "ChatAction" +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:1 of +msgid "This object represents bot actions." +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:3 of +msgid "Choose one, depending on what the user is about to receive:" +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:5 of +msgid "typing for text messages," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:6 of +msgid "upload_photo for photos," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:7 of +msgid "record_video or upload_video for videos," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:8 of +msgid "record_voice or upload_voice for voice notes," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:9 of +msgid "upload_document for general files," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:10 of +msgid "choose_sticker for stickers," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:11 of +msgid "find_location for location data," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:12 of +msgid "record_video_note or upload_video_note for video notes." +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:14 of +msgid "Source: https://core.telegram.org/bots/api#sendchataction" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/chat_member_status.po b/docs/locale/en/LC_MESSAGES/api/enums/chat_member_status.po new file mode 100644 index 0000000000..d5455e578f --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/chat_member_status.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/chat_member_status.rst:3 +msgid "ChatMemberStatus" +msgstr "" + +#: aiogram.enums.chat_member_status.ChatMemberStatus:1 of +msgid "This object represents chat member status." +msgstr "" + +#: aiogram.enums.chat_member_status.ChatMemberStatus:3 of +msgid "Source: https://core.telegram.org/bots/api#chatmember" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/chat_type.po b/docs/locale/en/LC_MESSAGES/api/enums/chat_type.po new file mode 100644 index 0000000000..daa1509244 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/chat_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/chat_type.rst:3 +msgid "ChatType" +msgstr "" + +#: aiogram.enums.chat_type.ChatType:1 of +msgid "This object represents a chat type" +msgstr "" + +#: aiogram.enums.chat_type.ChatType:3 of +msgid "Source: https://core.telegram.org/bots/api#chat" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/content_type.po b/docs/locale/en/LC_MESSAGES/api/enums/content_type.po new file mode 100644 index 0000000000..b8d27ec9b8 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/content_type.po @@ -0,0 +1,26 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/content_type.rst:3 +msgid "ContentType" +msgstr "" + +#: aiogram.enums.content_type.ContentType:1 of +msgid "This object represents a type of content in message" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/dice_emoji.po b/docs/locale/en/LC_MESSAGES/api/enums/dice_emoji.po new file mode 100644 index 0000000000..eacb9567ed --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/dice_emoji.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/dice_emoji.rst:3 +msgid "DiceEmoji" +msgstr "" + +#: aiogram.enums.dice_emoji.DiceEmoji:1 of +msgid "Emoji on which the dice throw animation is based" +msgstr "" + +#: aiogram.enums.dice_emoji.DiceEmoji:3 of +msgid "Source: https://core.telegram.org/bots/api#dice" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/index.po b/docs/locale/en/LC_MESSAGES/api/enums/index.po new file mode 100644 index 0000000000..04fcc63737 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/index.po @@ -0,0 +1,26 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/index.rst:3 +msgid "Types" +msgstr "" + +#: ../../api/enums/index.rst:5 +msgid "Here is list of all available enums:" +msgstr "" 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 new file mode 100644 index 0000000000..27a5da7ec0 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/inline_query_result_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../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 "" + +#: aiogram.enums.inline_query_result_type.InlineQueryResultType:3 of +msgid "Source: https://core.telegram.org/bots/api#maskposition" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/input_media_type.po b/docs/locale/en/LC_MESSAGES/api/enums/input_media_type.po new file mode 100644 index 0000000000..2115e5925f --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/input_media_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/input_media_type.rst:3 +msgid "InputMediaType" +msgstr "" + +#: aiogram.enums.input_media_type.InputMediaType:1 of +msgid "This object represents input media type" +msgstr "" + +#: aiogram.enums.input_media_type.InputMediaType:3 of +msgid "Source: https://core.telegram.org/bots/api#inputmedia" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/mask_position_point.po b/docs/locale/en/LC_MESSAGES/api/enums/mask_position_point.po new file mode 100644 index 0000000000..fde3a7715a --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/mask_position_point.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/mask_position_point.rst:3 +msgid "MaskPositionPoint" +msgstr "" + +#: aiogram.enums.mask_position_point.MaskPositionPoint:1 of +msgid "The part of the face relative to which the mask should be placed." +msgstr "" + +#: aiogram.enums.mask_position_point.MaskPositionPoint:3 of +msgid "Source: https://core.telegram.org/bots/api#maskposition" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/menu_button_type.po b/docs/locale/en/LC_MESSAGES/api/enums/menu_button_type.po new file mode 100644 index 0000000000..d7c0adc881 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/menu_button_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/menu_button_type.rst:3 +msgid "MenuButtonType" +msgstr "" + +#: aiogram.enums.menu_button_type.MenuButtonType:1 of +msgid "This object represents an type of Menu button" +msgstr "" + +#: aiogram.enums.menu_button_type.MenuButtonType:3 of +msgid "Source: https://core.telegram.org/bots/api#menubuttondefault" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/message_entity_type.po b/docs/locale/en/LC_MESSAGES/api/enums/message_entity_type.po new file mode 100644 index 0000000000..3704373b05 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/message_entity_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/message_entity_type.rst:3 +msgid "MessageEntityType" +msgstr "" + +#: aiogram.enums.message_entity_type.MessageEntityType:1 of +msgid "This object represents type of message entity" +msgstr "" + +#: aiogram.enums.message_entity_type.MessageEntityType:3 of +msgid "Source: https://core.telegram.org/bots/api#messageentity" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/parse_mode.po b/docs/locale/en/LC_MESSAGES/api/enums/parse_mode.po new file mode 100644 index 0000000000..cc565d5d81 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/parse_mode.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/parse_mode.rst:3 +msgid "ParseMode" +msgstr "" + +#: aiogram.enums.parse_mode.ParseMode:1 of +msgid "Formatting options" +msgstr "" + +#: aiogram.enums.parse_mode.ParseMode:3 of +msgid "Source: https://core.telegram.org/bots/api#formatting-options" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/poll_type.po b/docs/locale/en/LC_MESSAGES/api/enums/poll_type.po new file mode 100644 index 0000000000..42d2ab1571 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/poll_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/poll_type.rst:3 +msgid "PollType" +msgstr "" + +#: aiogram.enums.poll_type.PollType:1 of +msgid "This object represents poll type" +msgstr "" + +#: aiogram.enums.poll_type.PollType:3 of +msgid "Source: https://core.telegram.org/bots/api#poll" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/topic_icon_color.po b/docs/locale/en/LC_MESSAGES/api/enums/topic_icon_color.po new file mode 100644 index 0000000000..f1a6c28887 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/topic_icon_color.po @@ -0,0 +1,32 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/topic_icon_color.rst:3 +msgid "TopicIconColor" +msgstr "" + +#: aiogram.enums.topic_icon_color.TopicIconColor:1 of +msgid "Color of the topic icon in RGB format." +msgstr "" + +#: aiogram.enums.topic_icon_color.TopicIconColor:3 of +msgid "" +"Source: " +"https://github.com/telegramdesktop/tdesktop/blob/991fe491c5ae62705d77aa8fdd44a79caf639c45/Telegram/SourceFiles/data/data_forum_topic.cpp#L51-L56" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/enums/update_type.po b/docs/locale/en/LC_MESSAGES/api/enums/update_type.po new file mode 100644 index 0000000000..1a19127625 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/enums/update_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/update_type.rst:3 +msgid "UpdateType" +msgstr "" + +#: aiogram.enums.update_type.UpdateType:1 of +msgid "This object represents the complete list of allowed update types" +msgstr "" + +#: aiogram.enums.update_type.UpdateType:3 of +msgid "Source: https://core.telegram.org/bots/api#update" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/answer_callback_query.po b/docs/locale/en/LC_MESSAGES/api/methods/answer_callback_query.po index 8b8535edbc..2370aa3c74 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/answer_callback_query.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/answer_callback_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -120,6 +120,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/answer_callback_query.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/answer_callback_query.rst:50 +msgid ":meth:`aiogram.types.callback_query.CallbackQuery.answer`" +msgstr "" + #~ msgid "" #~ "Use this method to send answers to" #~ " callback queries sent from `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/answer_inline_query.po b/docs/locale/en/LC_MESSAGES/api/methods/answer_inline_query.po index 80a46ddd7d..22834a6704 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/answer_inline_query.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/answer_inline_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -123,6 +123,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/answer_inline_query.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/answer_inline_query.rst:50 +msgid ":meth:`aiogram.types.inline_query.InlineQuery.answer`" +msgstr "" + #~ msgid "" #~ "`Deep-linking `_ parameter for the /start " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/approve_chat_join_request.po b/docs/locale/en/LC_MESSAGES/api/methods/approve_chat_join_request.po index dcc8324c42..9350431976 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/approve_chat_join_request.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/approve_chat_join_request.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/approve_chat_join_request.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/approve_chat_join_request.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/approve_chat_join_request.rst:50 +msgid ":meth:`aiogram.types.chat_join_request.ChatJoinRequest.approve`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_member.po b/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_member.po index cd25abd1b6..487b0d38af 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_member.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -98,3 +98,11 @@ msgstr "" #: ../../api/methods/ban_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/ban_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/ban_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.ban`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_sender_chat.po b/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_sender_chat.po index 16e088231c..410a0c8ebf 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_sender_chat.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/ban_chat_sender_chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/ban_chat_sender_chat.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/ban_chat_sender_chat.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/ban_chat_sender_chat.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.ban_sender_chat`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/copy_message.po b/docs/locale/en/LC_MESSAGES/api/methods/copy_message.po index 93a1ae1aa6..f30e9b73f9 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/copy_message.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/copy_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -149,6 +149,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/copy_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/copy_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.copy_to`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/create_chat_invite_link.po b/docs/locale/en/LC_MESSAGES/api/methods/create_chat_invite_link.po index 0d13a53b25..7099e1d325 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/create_chat_invite_link.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/create_chat_invite_link.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -108,3 +108,11 @@ msgstr "" #: ../../api/methods/create_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/create_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/create_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.create_invite_link`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/create_forum_topic.po b/docs/locale/en/LC_MESSAGES/api/methods/create_forum_topic.po index 0baca81133..20e71139f3 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/create_forum_topic.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/create_forum_topic.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -52,8 +52,9 @@ msgstr "" #: ../../docstring #: aiogram.methods.create_forum_topic.CreateForumTopic.icon_color:1 of msgid "" -"Color of the topic icon in RGB format. Currently, must be one of " -"0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F" +"Color of the topic icon in RGB format. Currently, must be one of 7322096 " +"(0x6FB9F0), 16766590 (0xFFD67E), 13338331 (0xCB86DB), 9367192 (0x8EEE98)," +" 16749490 (0xFF93B2), or 16478047 (0xFB6F5F)" msgstr "" #: ../../docstring @@ -96,3 +97,10 @@ msgstr "" #: ../../api/methods/create_forum_topic.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Color of the topic icon in RGB " +#~ "format. Currently, must be one of " +#~ "0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, " +#~ "0xFF93B2, or 0xFB6F5F" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/decline_chat_join_request.po b/docs/locale/en/LC_MESSAGES/api/methods/decline_chat_join_request.po index 2aaaf0d017..9d632f5d82 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/decline_chat_join_request.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/decline_chat_join_request.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/decline_chat_join_request.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/decline_chat_join_request.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/decline_chat_join_request.rst:50 +msgid ":meth:`aiogram.types.chat_join_request.ChatJoinRequest.decline`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_photo.po b/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_photo.po index 724ea63fd3..758102ab98 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_photo.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_photo.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -75,3 +75,11 @@ msgstr "" #: ../../api/methods/delete_chat_photo.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_chat_photo.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_chat_photo.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.delete_photo`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_sticker_set.po b/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_sticker_set.po index 7c513e23be..3b5e83323a 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_sticker_set.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/delete_chat_sticker_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -79,3 +79,11 @@ msgstr "" #: ../../api/methods/delete_chat_sticker_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_chat_sticker_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_chat_sticker_set.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.delete_sticker_set`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/delete_message.po b/docs/locale/en/LC_MESSAGES/api/methods/delete_message.po index 6b3c136b42..d2a793d3b4 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/delete_message.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/delete_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -124,3 +124,15 @@ msgstr "" #: ../../api/methods/delete_message.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.delete`" +msgstr "" + +#: ../../api/methods/delete_message.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.delete_message`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_from_set.po b/docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_from_set.po index d88640deaf..e14f908164 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_from_set.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/delete_sticker_from_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -73,3 +73,11 @@ msgstr "" #: ../../api/methods/delete_sticker_from_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_sticker_from_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_sticker_from_set.rst:50 +msgid ":meth:`aiogram.types.sticker.Sticker.delete_from_set`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/edit_chat_invite_link.po b/docs/locale/en/LC_MESSAGES/api/methods/edit_chat_invite_link.po index a55d344e7b..6efd01b123 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/edit_chat_invite_link.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/edit_chat_invite_link.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -108,3 +108,11 @@ msgstr "" #: ../../api/methods/edit_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/edit_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.edit_invite_link`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/edit_forum_topic.po b/docs/locale/en/LC_MESSAGES/api/methods/edit_forum_topic.po index 7c2214cbee..b79ff4c79f 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/edit_forum_topic.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/edit_forum_topic.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -57,7 +57,7 @@ msgstr "" msgid "" "New unique identifier of the custom emoji shown as the topic icon. Use " ":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" -" to get all allowed custom emoji identifiers" +" to get all allowed custom emoji identifiers." msgstr "" #: ../../api/methods/edit_forum_topic.rst:14 @@ -91,3 +91,12 @@ msgstr "" #: ../../api/methods/edit_forum_topic.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "New unique identifier of the custom " +#~ "emoji shown as the topic icon. Use" +#~ " " +#~ ":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +#~ " to get all allowed custom emoji " +#~ "identifiers" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/edit_message_caption.po b/docs/locale/en/LC_MESSAGES/api/methods/edit_message_caption.po index 65c26608a2..a566ee5e41 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/edit_message_caption.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/edit_message_caption.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -122,6 +122,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_caption.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_caption.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_caption`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -141,6 +141,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_live_location.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_live_location.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_live_location`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for a new" #~ " `inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -107,6 +107,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_media.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_media.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_media`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for a new" #~ " `inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -104,6 +104,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_reply_markup.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_reply_markup.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_reply_markup`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -124,6 +124,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_text.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_text.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_text`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -91,3 +91,11 @@ msgstr "" #: ../../api/methods/export_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/export_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/export_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.export_invite_link`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/forward_message.po b/docs/locale/en/LC_MESSAGES/api/methods/forward_message.po index db6dd82513..43f90fbf08 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/forward_message.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/forward_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -105,5 +105,13 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/forward_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/forward_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.forward`" +msgstr "" + #~ msgid "As message method" #~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_administrators.po b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_administrators.po index a840dc464b..7700abdce7 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_administrators.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_administrators.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -75,3 +75,11 @@ msgstr "" #: ../../api/methods/get_chat_administrators.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_chat_administrators.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_chat_administrators.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.get_administrators`" +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 953ea21918..56aedd8364 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,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -75,3 +75,11 @@ msgstr "" #: ../../api/methods/get_chat_member.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_chat_member.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_chat_member.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.get_member`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member_count.po b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member_count.po index 7ad69e4a6d..6fc48c9fc7 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member_count.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_member_count.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -71,3 +71,11 @@ msgstr "" #: ../../api/methods/get_chat_member_count.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_chat_member_count.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_chat_member_count.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.get_member_count`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_members_count.po b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_members_count.po index c3c623ae12..e747a5f44a 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/get_chat_members_count.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/get_chat_members_count.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -25,23 +25,6 @@ msgstr "" msgid "Returns: :obj:`int`" msgstr "" -#: aiogram.methods.get_chat_members_count.GetChatMembersCount:5 of -msgid "" -"Use this method to get the number of members in a chat. Returns *Int* on " -"success." -msgstr "" - -#: aiogram.methods.get_chat_members_count.GetChatMembersCount:7 of -msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" -msgstr "" - -#: ../../docstring -#: aiogram.methods.get_chat_members_count.GetChatMembersCount.chat_id:1 of -msgid "" -"Unique identifier for the target chat or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" -msgstr "" - #: ../../api/methods/get_chat_members_count.rst:14 msgid "Usage" msgstr "" @@ -71,3 +54,19 @@ msgstr "" #: ../../api/methods/get_chat_members_count.rst:33 msgid "With specific bot" msgstr "" + +#~ msgid "" +#~ "Use this method to get the number" +#~ " of members in a chat. Returns " +#~ "*Int* on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +#~ msgstr "" + +#~ msgid "" +#~ "Unique identifier for the target chat" +#~ " or username of the target supergroup" +#~ " or channel (in the format " +#~ ":code:`@channelusername`)" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/get_user_profile_photos.po b/docs/locale/en/LC_MESSAGES/api/methods/get_user_profile_photos.po index c9b43d0b90..bbbeffbce9 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/get_user_profile_photos.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/get_user_profile_photos.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/get_user_profile_photos.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_user_profile_photos.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_user_profile_photos.rst:45 +msgid ":meth:`aiogram.types.user.User.get_profile_photos`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/kick_chat_member.po b/docs/locale/en/LC_MESSAGES/api/methods/kick_chat_member.po index 2d1dde8831..d61507e420 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/kick_chat_member.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/kick_chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -25,48 +25,6 @@ msgstr "" msgid "Returns: :obj:`bool`" msgstr "" -#: aiogram.methods.kick_chat_member.KickChatMember:5 of -msgid "" -"Use this method to ban a user in a group, a supergroup or a channel. In " -"the case of supergroups and channels, the user will not be able to return" -" to the chat on their own using invite links, etc., unless `unbanned " -"`_ first. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Returns :code:`True` on success." -msgstr "" - -#: aiogram.methods.kick_chat_member.KickChatMember:7 of -msgid "Source: https://core.telegram.org/bots/api#banchatmember" -msgstr "" - -#: ../../docstring aiogram.methods.kick_chat_member.KickChatMember.chat_id:1 of -msgid "" -"Unique identifier for the target group or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" -msgstr "" - -#: ../../docstring aiogram.methods.kick_chat_member.KickChatMember.user_id:1 of -msgid "Unique identifier of the target user" -msgstr "" - -#: ../../docstring aiogram.methods.kick_chat_member.KickChatMember.until_date:1 -#: of -msgid "" -"Date when the user will be unbanned, unix time. If user is banned for " -"more than 366 days or less than 30 seconds from the current time they are" -" considered to be banned forever. Applied for supergroups and channels " -"only." -msgstr "" - -#: ../../docstring -#: aiogram.methods.kick_chat_member.KickChatMember.revoke_messages:1 of -msgid "" -"Pass :code:`True` to delete all messages from the chat for the user that " -"is being removed. If :code:`False`, the user will be able to see messages" -" in the group that were sent before the user was removed. Always " -":code:`True` for supergroups and channels." -msgstr "" - #: ../../api/methods/kick_chat_member.rst:14 msgid "Usage" msgstr "" @@ -98,3 +56,53 @@ msgstr "" #: ../../api/methods/kick_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to ban a user " +#~ "in a group, a supergroup or a " +#~ "channel. In the case of supergroups " +#~ "and channels, the user will not be" +#~ " able to return to the chat on" +#~ " their own using invite links, etc.," +#~ " unless `unbanned " +#~ "`_ first." +#~ " The bot must be an administrator " +#~ "in the chat for this to work " +#~ "and must have the appropriate " +#~ "administrator rights. Returns :code:`True` on" +#~ " success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#banchatmember" +#~ msgstr "" + +#~ msgid "" +#~ "Unique identifier for the target group" +#~ " or username of the target supergroup" +#~ " or channel (in the format " +#~ ":code:`@channelusername`)" +#~ msgstr "" + +#~ msgid "Unique identifier of the target user" +#~ msgstr "" + +#~ msgid "" +#~ "Date when the user will be " +#~ "unbanned, unix time. If user is " +#~ "banned for more than 366 days or" +#~ " less than 30 seconds from the " +#~ "current time they are considered to " +#~ "be banned forever. Applied for " +#~ "supergroups and channels only." +#~ msgstr "" + +#~ msgid "" +#~ "Pass :code:`True` to delete all messages" +#~ " from the chat for the user " +#~ "that is being removed. If :code:`False`," +#~ " the user will be able to see" +#~ " messages in the group that were " +#~ "sent before the user was removed. " +#~ "Always :code:`True` for supergroups and " +#~ "channels." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/leave_chat.po b/docs/locale/en/LC_MESSAGES/api/methods/leave_chat.po index bb193089d3..bef135f1ef 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/leave_chat.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/leave_chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -72,3 +72,11 @@ msgstr "" #: ../../api/methods/leave_chat.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/leave_chat.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/leave_chat.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.leave`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/pin_chat_message.po b/docs/locale/en/LC_MESSAGES/api/methods/pin_chat_message.po index 5e2232a366..9a1e84e463 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/pin_chat_message.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/pin_chat_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -89,5 +89,17 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/pin_chat_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/pin_chat_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.pin`" +msgstr "" + +#: ../../api/methods/pin_chat_message.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.pin_message`" +msgstr "" + #~ msgid "As message method" #~ 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 202cbbe427..2d9c09785a 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,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -162,3 +162,11 @@ msgstr "" #: ../../api/methods/promote_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/promote_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/promote_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.promote`" +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 7a65a99fe0..9c0755b7c6 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,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -95,3 +95,11 @@ msgstr "" #: ../../api/methods/restrict_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/restrict_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/restrict_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.restrict`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/revoke_chat_invite_link.po b/docs/locale/en/LC_MESSAGES/api/methods/revoke_chat_invite_link.po index e2fecea0ec..b7fee507f8 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/revoke_chat_invite_link.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/revoke_chat_invite_link.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -84,3 +84,11 @@ msgstr "" #: ../../api/methods/revoke_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/revoke_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/revoke_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.revoke_invite_link`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_animation.po b/docs/locale/en/LC_MESSAGES/api/methods/send_animation.po index 2aefc24d3c..d84eff4261 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_animation.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_animation.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -171,6 +171,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_animation.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_animation.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_animation`" +msgstr "" + +#: ../../api/methods/send_animation.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_animation`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_audio.po b/docs/locale/en/LC_MESSAGES/api/methods/send_audio.po index b423d293f3..46d0618159 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_audio.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_audio.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -165,6 +165,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_audio.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_audio.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_audio`" +msgstr "" + +#: ../../api/methods/send_audio.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_audio`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_chat_action.po b/docs/locale/en/LC_MESSAGES/api/methods/send_chat_action.po index a8b2e8be78..e69951eb07 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_chat_action.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_chat_action.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -107,3 +107,11 @@ msgstr "" #: ../../api/methods/send_chat_action.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/send_chat_action.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_chat_action.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.do`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_contact.po b/docs/locale/en/LC_MESSAGES/api/methods/send_contact.po index a6bb3db852..8ada4c7b8e 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_contact.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_contact.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -131,6 +131,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_contact.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_contact.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_contact`" +msgstr "" + +#: ../../api/methods/send_contact.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_contact`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_dice.po b/docs/locale/en/LC_MESSAGES/api/methods/send_dice.po index 19cf0438ec..19a52d2f22 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_dice.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_dice.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -118,6 +118,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_dice.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_dice.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_dice`" +msgstr "" + +#: ../../api/methods/send_dice.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_dice`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_document.po b/docs/locale/en/LC_MESSAGES/api/methods/send_document.po index 334ffbd62e..2b2e658ffc 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_document.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_document.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -163,6 +163,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_document.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_document.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_document`" +msgstr "" + +#: ../../api/methods/send_document.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_document`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_game.po b/docs/locale/en/LC_MESSAGES/api/methods/send_game.po index 63aa45a7e7..a46e72a023 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_game.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_game.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -112,6 +112,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_game.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_game.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_game`" +msgstr "" + +#: ../../api/methods/send_game.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_game`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -242,6 +242,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_invoice.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_invoice.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_invoice`" +msgstr "" + +#: ../../api/methods/send_invoice.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_invoice`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -147,6 +147,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_location.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_location.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_location`" +msgstr "" + +#: ../../api/methods/send_location.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_location`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_media_group.po b/docs/locale/en/LC_MESSAGES/api/methods/send_media_group.po index a325955742..e3d5b3db6e 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_media_group.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_media_group.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -113,3 +113,15 @@ msgstr "" #: ../../api/methods/send_media_group.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/send_media_group.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_media_group.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_media_group`" +msgstr "" + +#: ../../api/methods/send_media_group.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_media_group`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_message.po b/docs/locale/en/LC_MESSAGES/api/methods/send_message.po index 63c7ac2c9e..e0a83b6d22 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_message.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -135,6 +135,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer`" +msgstr "" + +#: ../../api/methods/send_message.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_photo.po b/docs/locale/en/LC_MESSAGES/api/methods/send_photo.po index 6c58b959f8..496a13a53e 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_photo.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_photo.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -141,6 +141,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_photo.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_photo.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_photo`" +msgstr "" + +#: ../../api/methods/send_photo.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_photo`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_poll.po b/docs/locale/en/LC_MESSAGES/api/methods/send_poll.po index 9b2d23c2ba..9222d2c3c8 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_poll.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_poll.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -180,6 +180,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_poll.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_poll.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_poll`" +msgstr "" + +#: ../../api/methods/send_poll.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_poll`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " 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 c06c0d6efb..b1e8bcb018 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_sticker.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_sticker.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -125,6 +125,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_sticker.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_sticker.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_sticker`" +msgstr "" + +#: ../../api/methods/send_sticker.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_sticker`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_venue.po b/docs/locale/en/LC_MESSAGES/api/methods/send_venue.po index fe7d74d99c..848d689831 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_venue.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_venue.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -148,6 +148,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_venue.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_venue.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_venue`" +msgstr "" + +#: ../../api/methods/send_venue.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_venue`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_video.po b/docs/locale/en/LC_MESSAGES/api/methods/send_video.po index c57d36ce6f..55651775ee 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_video.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_video.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -171,6 +171,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_video.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_video.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_video`" +msgstr "" + +#: ../../api/methods/send_video.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_video`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_video_note.po b/docs/locale/en/LC_MESSAGES/api/methods/send_video_note.po index ee7920ea2c..959a0407eb 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_video_note.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_video_note.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -146,6 +146,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_video_note.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_video_note.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_video_note`" +msgstr "" + +#: ../../api/methods/send_video_note.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_video_note`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/send_voice.po b/docs/locale/en/LC_MESSAGES/api/methods/send_voice.po index 3e572b26b2..553a326511 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/send_voice.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/send_voice.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -147,6 +147,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_voice.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_voice.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_voice`" +msgstr "" + +#: ../../api/methods/send_voice.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_voice`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po index 72f3802c45..ee28db9b93 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -92,3 +92,11 @@ msgstr "" #: ../../api/methods/set_chat_administrator_custom_title.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_administrator_custom_title.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_administrator_custom_title.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_administrator_custom_title`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_description.po b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_description.po index e1a0a86a46..3c42aceee2 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_description.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_description.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -82,3 +82,11 @@ msgstr "" #: ../../api/methods/set_chat_description.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_description.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_description.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_description`" +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 d4e19be637..d27d787881 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,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -82,3 +82,11 @@ msgstr "" #: ../../api/methods/set_chat_permissions.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_permissions.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_permissions.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_permissions`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_photo.po b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_photo.po index c94845dc2f..ab0cc9a798 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_photo.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_photo.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -74,3 +74,11 @@ msgstr "" #: ../../api/methods/set_chat_photo.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/set_chat_photo.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_photo.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.set_photo`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_sticker_set.po b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_sticker_set.po index cf289c2a92..b5441109b1 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_sticker_set.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_sticker_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -82,3 +82,11 @@ msgstr "" #: ../../api/methods/set_chat_sticker_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_sticker_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_sticker_set.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_sticker_set`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_title.po b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_title.po index 90e78ed63f..da3c936e6f 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_chat_title.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_chat_title.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -79,5 +79,13 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/set_chat_title.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_title.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_title`" +msgstr "" + #~ msgid "New chat title, 1-255 characters" #~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_position_in_set.po b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_position_in_set.po index 977b6e0c06..c7ef9e7ef6 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_position_in_set.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/set_sticker_position_in_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -80,3 +80,11 @@ msgstr "" #: ../../api/methods/set_sticker_position_in_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_sticker_position_in_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_sticker_position_in_set.rst:50 +msgid ":meth:`aiogram.types.sticker.Sticker.set_position_in_set`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/stop_message_live_location.po b/docs/locale/en/LC_MESSAGES/api/methods/stop_message_live_location.po index 5676516050..e15b616d51 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/stop_message_live_location.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/stop_message_live_location.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -104,6 +104,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/stop_message_live_location.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/stop_message_live_location.rst:50 +msgid ":meth:`aiogram.types.message.Message.stop_live_location`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for a new" #~ " `inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -89,3 +89,11 @@ msgstr "" #: ../../api/methods/unban_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/unban_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unban_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.unban`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/unban_chat_sender_chat.po b/docs/locale/en/LC_MESSAGES/api/methods/unban_chat_sender_chat.po index 333a8e9365..093786e831 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/unban_chat_sender_chat.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/unban_chat_sender_chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/unban_chat_sender_chat.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/unban_chat_sender_chat.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unban_chat_sender_chat.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.unban_sender_chat`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/unpin_all_chat_messages.po b/docs/locale/en/LC_MESSAGES/api/methods/unpin_all_chat_messages.po index b983221403..879d0ae4e8 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/unpin_all_chat_messages.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/unpin_all_chat_messages.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -78,3 +78,11 @@ msgstr "" #: ../../api/methods/unpin_all_chat_messages.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/unpin_all_chat_messages.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unpin_all_chat_messages.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.unpin_all_messages`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/methods/unpin_chat_message.po b/docs/locale/en/LC_MESSAGES/api/methods/unpin_chat_message.po index 5f08d05427..e184084b7d 100644 --- a/docs/locale/en/LC_MESSAGES/api/methods/unpin_chat_message.po +++ b/docs/locale/en/LC_MESSAGES/api/methods/unpin_chat_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -85,5 +85,17 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/unpin_chat_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unpin_chat_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.unpin`" +msgstr "" + +#: ../../api/methods/unpin_chat_message.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.unpin_message`" +msgstr "" + #~ msgid "As message method" #~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/callback_query.po b/docs/locale/en/LC_MESSAGES/api/types/callback_query.po index e70f9d0232..cb74a99398 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/callback_query.po +++ b/docs/locale/en/LC_MESSAGES/api/types/callback_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -94,17 +94,81 @@ msgid "" msgstr "" #: aiogram.types.callback_query.CallbackQuery.answer:1 of -msgid "Answer to callback query" +msgid "" +"Shortcut for method " +":class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:4 of +msgid ":code:`callback_query_id`" +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:6 of +msgid "" +"Use this method to send answers to callback queries sent from `inline " +"keyboards `_. " +"The answer will be displayed to the user as a notification at the top of " +"the chat screen or as an alert. On success, :code:`True` is returned." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:8 of +msgid "" +"Alternatively, the user can be redirected to the specified Game URL. For " +"this option to work, you must first create a game for your bot via " +"`@BotFather `_ and accept the terms. Otherwise, " +"you may use links like :code:`t.me/your_bot?start=XXXX` that open your " +"bot with a parameter." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:10 of +msgid "Source: https://core.telegram.org/bots/api#answercallbackquery" msgstr "" #: aiogram.types.callback_query.CallbackQuery.answer of msgid "Parameters" msgstr "" +#: aiogram.types.callback_query.CallbackQuery.answer:12 of +msgid "" +"Text of the notification. If not specified, nothing will be shown to the " +"user, 0-200 characters" +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:13 of +msgid "" +"If :code:`True`, an alert will be shown by the client instead of a " +"notification at the top of the chat screen. Defaults to *false*." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:14 of +msgid "" +"URL that will be opened by the user's client. If you have created a " +":class:`aiogram.types.game.Game` and accepted the conditions via " +"`@BotFather `_, specify the URL that opens your " +"game - note that this will only work if the query comes from a " +"`https://core.telegram.org/bots/api#inlinekeyboardbutton " +"`_ " +"*callback_game* button." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:15 of +msgid "" +"The maximum amount of time in seconds that the result of the callback " +"query may be cached client-side. Telegram apps will support caching " +"starting in version 3.14. Defaults to 0." +msgstr "" + #: aiogram.types.callback_query.CallbackQuery.answer of msgid "Returns" msgstr "" +#: aiogram.types.callback_query.CallbackQuery.answer:16 of +msgid "" +"instance of method " +":class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery`" +msgstr "" + #~ msgid "" #~ "This object represents an incoming " #~ "callback query from a callback button" @@ -122,3 +186,6 @@ msgstr "" #~ "the fields *data* or *game_short_name* " #~ "will be present." #~ msgstr "" + +#~ msgid "Answer to callback query" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat.po b/docs/locale/en/LC_MESSAGES/api/types/chat.po index 882d5c3036..802289d36a 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -221,3 +221,1017 @@ msgid "" "For private chat it is first_name + last_name. For other chat types it is" " title." msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.ban:4 aiogram.types.chat.Chat.ban_sender_chat:4 +#: aiogram.types.chat.Chat.create_invite_link:4 +#: aiogram.types.chat.Chat.delete_message:4 +#: aiogram.types.chat.Chat.delete_photo:4 +#: aiogram.types.chat.Chat.delete_sticker_set:4 aiogram.types.chat.Chat.do:4 +#: aiogram.types.chat.Chat.edit_invite_link:4 +#: aiogram.types.chat.Chat.export_invite_link:4 +#: aiogram.types.chat.Chat.get_administrators:4 +#: aiogram.types.chat.Chat.get_member:4 +#: aiogram.types.chat.Chat.get_member_count:4 aiogram.types.chat.Chat.leave:4 +#: aiogram.types.chat.Chat.pin_message:4 aiogram.types.chat.Chat.promote:4 +#: aiogram.types.chat.Chat.restrict:4 +#: aiogram.types.chat.Chat.revoke_invite_link:4 +#: aiogram.types.chat.Chat.set_administrator_custom_title:4 +#: aiogram.types.chat.Chat.set_description:4 +#: aiogram.types.chat.Chat.set_permissions:4 +#: aiogram.types.chat.Chat.set_photo:4 +#: aiogram.types.chat.Chat.set_sticker_set:4 +#: aiogram.types.chat.Chat.set_title:4 aiogram.types.chat.Chat.unban:4 +#: aiogram.types.chat.Chat.unban_sender_chat:4 +#: aiogram.types.chat.Chat.unpin_all_messages:4 +#: aiogram.types.chat.Chat.unpin_message:4 of +msgid ":code:`chat_id`" +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:6 of +msgid "" +"Use this method to ban a channel chat in a supergroup or a channel. Until" +" the chat is `unbanned " +"`_, the owner of " +"the banned chat won't be able to send messages on behalf of **any of " +"their channels**. The bot must be an administrator in the supergroup or " +"channel for this to work and must have the appropriate administrator " +"rights. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:8 of +msgid "Source: https://core.telegram.org/bots/api#banchatsenderchat" +msgstr "" + +#: aiogram.types.chat.Chat.ban aiogram.types.chat.Chat.ban_sender_chat +#: aiogram.types.chat.Chat.create_invite_link +#: aiogram.types.chat.Chat.delete_message aiogram.types.chat.Chat.do +#: aiogram.types.chat.Chat.edit_invite_link aiogram.types.chat.Chat.get_member +#: aiogram.types.chat.Chat.pin_message aiogram.types.chat.Chat.promote +#: aiogram.types.chat.Chat.restrict aiogram.types.chat.Chat.revoke_invite_link +#: aiogram.types.chat.Chat.set_administrator_custom_title +#: aiogram.types.chat.Chat.set_description +#: aiogram.types.chat.Chat.set_permissions aiogram.types.chat.Chat.set_photo +#: aiogram.types.chat.Chat.set_sticker_set aiogram.types.chat.Chat.set_title +#: aiogram.types.chat.Chat.unban aiogram.types.chat.Chat.unban_sender_chat +#: aiogram.types.chat.Chat.unpin_message of +msgid "Parameters" +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:10 +#: aiogram.types.chat.Chat.unban_sender_chat:10 of +msgid "Unique identifier of the target sender chat" +msgstr "" + +#: aiogram.types.chat.Chat.ban aiogram.types.chat.Chat.ban_sender_chat +#: aiogram.types.chat.Chat.create_invite_link +#: aiogram.types.chat.Chat.delete_message aiogram.types.chat.Chat.delete_photo +#: aiogram.types.chat.Chat.delete_sticker_set aiogram.types.chat.Chat.do +#: aiogram.types.chat.Chat.edit_invite_link +#: aiogram.types.chat.Chat.export_invite_link +#: aiogram.types.chat.Chat.get_administrators +#: aiogram.types.chat.Chat.get_member aiogram.types.chat.Chat.get_member_count +#: aiogram.types.chat.Chat.leave aiogram.types.chat.Chat.pin_message +#: aiogram.types.chat.Chat.promote aiogram.types.chat.Chat.restrict +#: aiogram.types.chat.Chat.revoke_invite_link +#: aiogram.types.chat.Chat.set_administrator_custom_title +#: aiogram.types.chat.Chat.set_description +#: aiogram.types.chat.Chat.set_permissions aiogram.types.chat.Chat.set_photo +#: aiogram.types.chat.Chat.set_sticker_set aiogram.types.chat.Chat.set_title +#: aiogram.types.chat.Chat.unban aiogram.types.chat.Chat.unban_sender_chat +#: aiogram.types.chat.Chat.unpin_all_messages +#: aiogram.types.chat.Chat.unpin_message of +msgid "Returns" +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat`" +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:6 of +msgid "" +"Use this method to unban a previously banned channel chat in a supergroup" +" or channel. The bot must be an administrator for this to work and must " +"have the appropriate administrator rights. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:8 of +msgid "Source: https://core.telegram.org/bots/api#unbanchatsenderchat" +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat`" +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_chat_administrators.GetChatAdministrators` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:6 of +msgid "" +"Use this method to get a list of administrators in a chat, which aren't " +"bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` " +"objects." +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:8 of +msgid "Source: https://core.telegram.org/bots/api#getchatadministrators" +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.get_chat_administrators.GetChatAdministrators`" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:6 of +msgid "" +"Use this method to delete a message, including service messages, with the" +" following limitations:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:8 of +msgid "A message can only be deleted if it was sent less than 48 hours ago." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:10 of +msgid "" +"Service messages about a supergroup, channel, or forum topic creation " +"can't be deleted." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:12 of +msgid "" +"A dice message in a private chat can only be deleted if it was sent more " +"than 24 hours ago." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:14 of +msgid "" +"Bots can delete outgoing messages in private chats, groups, and " +"supergroups." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:16 of +msgid "Bots can delete incoming messages in private chats." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:18 of +msgid "" +"Bots granted *can_post_messages* permissions can delete outgoing messages" +" in channels." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:20 of +msgid "" +"If the bot is an administrator of a group, it can delete any message " +"there." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:22 of +msgid "" +"If the bot has *can_delete_messages* permission in a supergroup or a " +"channel, it can delete any message there." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:24 of +msgid "Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:26 of +msgid "Source: https://core.telegram.org/bots/api#deletemessage" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:28 of +msgid "Identifier of the message to delete" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:29 of +msgid "instance of method :class:`aiogram.methods.delete_message.DeleteMessage`" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:6 of +msgid "" +"Use this method to revoke an invite link created by the bot. If the " +"primary link is revoked, a new link is automatically generated. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns the revoked invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:8 of +msgid "Source: https://core.telegram.org/bots/api#revokechatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:10 of +msgid "The invite link to revoke" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:6 of +msgid "" +"Use this method to edit a non-primary invite link created by the bot. The" +" bot must be an administrator in the chat for this to work and must have " +"the appropriate administrator rights. Returns the edited invite link as a" +" :class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:8 of +msgid "Source: https://core.telegram.org/bots/api#editchatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:10 of +msgid "The invite link to edit" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:10 +#: aiogram.types.chat.Chat.edit_invite_link:11 of +msgid "Invite link name; 0-32 characters" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:11 +#: aiogram.types.chat.Chat.edit_invite_link:12 of +msgid "Point in time (Unix timestamp) when the link will expire" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:12 +#: aiogram.types.chat.Chat.edit_invite_link:13 of +msgid "" +"The maximum number of users that can be members of the chat " +"simultaneously after joining the chat via this invite link; 1-99999" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:13 +#: aiogram.types.chat.Chat.edit_invite_link:14 of +msgid "" +":code:`True`, if users joining the chat via the link need to be approved " +"by chat administrators. If :code:`True`, *member_limit* can't be " +"specified" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:15 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:6 of +msgid "" +"Use this method to create an additional invite link for a chat. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. The link can be revoked using the " +"method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. " +"Returns the new invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:8 of +msgid "Source: https://core.telegram.org/bots/api#createchatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:14 of +msgid "" +"instance of method " +":class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:6 of +msgid "" +"Use this method to generate a new primary invite link for a chat; any " +"previously generated primary link is revoked. The bot must be an " +"administrator in the chat for this to work and must have the appropriate " +"administrator rights. Returns the new invite link as *String* on success." +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:8 of +msgid "" +"Note: Each administrator in a chat generates their own invite links. Bots" +" can't use invite links generated by other administrators. If you want " +"your bot to work with invite links, it will need to generate its own link" +" using " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or " +"by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your " +"bot needs to generate a new primary invite link replacing its previous " +"one, use " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"again." +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:10 of +msgid "Source: https://core.telegram.org/bots/api#exportchatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.do:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.send_chat_action.SendChatAction` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.do:6 of +msgid "" +"Use this method when you need to tell the user that something is " +"happening on the bot's side. The status is set for 5 seconds or less " +"(when a message arrives from your bot, Telegram clients clear its typing " +"status). Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.do:8 of +msgid "" +"Example: The `ImageBot `_ needs some time to " +"process a request and upload the image. Instead of sending a text message" +" along the lines of 'Retrieving image, please wait…', the bot may use " +":class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = " +"*upload_photo*. The user will see a 'sending photo' status for the bot." +msgstr "" + +#: aiogram.types.chat.Chat.do:10 of +msgid "" +"We only recommend using this method when a response from the bot will " +"take a **noticeable** amount of time to arrive." +msgstr "" + +#: aiogram.types.chat.Chat.do:12 of +msgid "Source: https://core.telegram.org/bots/api#sendchataction" +msgstr "" + +#: aiogram.types.chat.Chat.do:14 of +msgid "" +"Type of action to broadcast. Choose one, depending on what the user is " +"about to receive: *typing* for `text messages " +"`_, *upload_photo* for " +"`photos `_, *record_video* " +"or *upload_video* for `videos " +"`_, *record_voice* or " +"*upload_voice* for `voice notes " +"`_, *upload_document* for " +"`general files `_, " +"*choose_sticker* for `stickers " +"`_, *find_location* for " +"`location data `_, " +"*record_video_note* or *upload_video_note* for `video notes " +"`_." +msgstr "" + +#: aiogram.types.chat.Chat.do:15 of +msgid "" +"instance of method " +":class:`aiogram.methods.send_chat_action.SendChatAction`" +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:6 of +msgid "" +"Use this method to delete a group sticker set from a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:8 of +msgid "Source: https://core.telegram.org/bots/api#deletechatstickerset" +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet`" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:6 of +msgid "" +"Use this method to set a new group sticker set for a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatstickerset" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:10 of +msgid "Name of the sticker set to be set as the group sticker set" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet`" +msgstr "" + +#: aiogram.types.chat.Chat.get_member:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_chat_member.GetChatMember` will automatically" +" fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.get_member:6 of +msgid "" +"Use this method to get information about a member of a chat. Returns a " +":class:`aiogram.types.chat_member.ChatMember` object on success." +msgstr "" + +#: aiogram.types.chat.Chat.get_member:8 of +msgid "Source: https://core.telegram.org/bots/api#getchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.ban:10 aiogram.types.chat.Chat.get_member:10 +#: aiogram.types.chat.Chat.promote:10 aiogram.types.chat.Chat.restrict:10 +#: aiogram.types.chat.Chat.set_administrator_custom_title:10 +#: aiogram.types.chat.Chat.unban:10 of +msgid "Unique identifier of the target user" +msgstr "" + +#: aiogram.types.chat.Chat.get_member:11 of +msgid "instance of method :class:`aiogram.methods.get_chat_member.GetChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_chat_member_count.GetChatMemberCount` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:6 of +msgid "" +"Use this method to get the number of members in a chat. Returns *Int* on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:8 of +msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.get_chat_member_count.GetChatMemberCount`" +msgstr "" + +#: aiogram.types.chat.Chat.leave:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.leave_chat.LeaveChat` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.leave:6 of +msgid "" +"Use this method for your bot to leave a group, supergroup or channel. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.leave:8 of +msgid "Source: https://core.telegram.org/bots/api#leavechat" +msgstr "" + +#: aiogram.types.chat.Chat.leave:10 of +msgid "instance of method :class:`aiogram.methods.leave_chat.LeaveChat`" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:6 of +msgid "" +"Use this method to clear the list of pinned messages in a chat. If the " +"chat is not a private chat, the bot must be an administrator in the chat " +"for this to work and must have the 'can_pin_messages' administrator right" +" in a supergroup or 'can_edit_messages' administrator right in a channel." +" Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:8 of +msgid "Source: https://core.telegram.org/bots/api#unpinallchatmessages" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages`" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:6 of +msgid "" +"Use this method to remove a message from the list of pinned messages in a" +" chat. If the chat is not a private chat, the bot must be an " +"administrator in the chat for this to work and must have the " +"'can_pin_messages' administrator right in a supergroup or " +"'can_edit_messages' administrator right in a channel. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:8 of +msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:10 of +msgid "" +"Identifier of a message to unpin. If not specified, the most recent " +"pinned message (by sending date) will be unpinned." +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage`" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:6 of +msgid "" +"Use this method to add a message to the list of pinned messages in a " +"chat. If the chat is not a private chat, the bot must be an administrator" +" in the chat for this to work and must have the 'can_pin_messages' " +"administrator right in a supergroup or 'can_edit_messages' administrator " +"right in a channel. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:8 of +msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:10 of +msgid "Identifier of a message to pin" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:11 of +msgid "" +"Pass :code:`True` if it is not necessary to send a notification to all " +"chat members about the new pinned message. Notifications are always " +"disabled in channels and private chats." +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage`" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:6 of +msgid "" +"Use this method to set a custom title for an administrator in a " +"supergroup promoted by the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:11 of +msgid "" +"New custom title for the administrator; 0-16 characters, emoji are not " +"allowed" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle`" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_permissions.SetChatPermissions` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:6 of +msgid "" +"Use this method to set default chat permissions for all members. The bot " +"must be an administrator in the group or a supergroup for this to work " +"and must have the *can_restrict_members* administrator rights. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatpermissions" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:10 of +msgid "A JSON-serialized object for new default chat permissions" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_permissions.SetChatPermissions`" +msgstr "" + +#: aiogram.types.chat.Chat.promote:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.promote_chat_member.PromoteChatMember` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.promote:6 of +msgid "" +"Use this method to promote or demote a user in a supergroup or a channel." +" The bot must be an administrator in the chat for this to work and must " +"have the appropriate administrator rights. Pass :code:`False` for all " +"boolean parameters to demote a user. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.promote:8 of +msgid "Source: https://core.telegram.org/bots/api#promotechatmember" +msgstr "" + +#: aiogram.types.chat.Chat.promote:11 of +msgid "Pass :code:`True` if the administrator's presence in the chat is hidden" +msgstr "" + +#: aiogram.types.chat.Chat.promote:12 of +msgid "" +"Pass :code:`True` if the administrator can access the chat event log, " +"chat statistics, message statistics in channels, see channel members, see" +" anonymous administrators in supergroups and ignore slow mode. Implied by" +" any other administrator privilege" +msgstr "" + +#: aiogram.types.chat.Chat.promote:13 of +msgid "" +"Pass :code:`True` if the administrator can create channel posts, channels" +" only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:14 of +msgid "" +"Pass :code:`True` if the administrator can edit messages of other users " +"and can pin messages, channels only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:15 of +msgid "Pass :code:`True` if the administrator can delete messages of other users" +msgstr "" + +#: aiogram.types.chat.Chat.promote:16 of +msgid "Pass :code:`True` if the administrator can manage video chats" +msgstr "" + +#: aiogram.types.chat.Chat.promote:17 of +msgid "" +"Pass :code:`True` if the administrator can restrict, ban or unban chat " +"members" +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 " +"promoted, directly or indirectly (promoted by administrators that were " +"appointed by him)" +msgstr "" + +#: aiogram.types.chat.Chat.promote:19 of +msgid "" +"Pass :code:`True` if the administrator can change chat title, photo and " +"other settings" +msgstr "" + +#: aiogram.types.chat.Chat.promote:20 of +msgid "Pass :code:`True` if the administrator can invite new users to the chat" +msgstr "" + +#: aiogram.types.chat.Chat.promote:21 of +msgid "Pass :code:`True` if the administrator can pin messages, supergroups only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:22 of +msgid "" +"Pass :code:`True` if the user is allowed to create, rename, close, and " +"reopen forum topics, supergroups only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:23 of +msgid "" +"instance of method " +":class:`aiogram.methods.promote_chat_member.PromoteChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.restrict_chat_member.RestrictChatMember` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:6 of +msgid "" +"Use this method to restrict a user in a supergroup. The bot must be an " +"administrator in the supergroup for this to work and must have the " +"appropriate administrator rights. Pass :code:`True` for all permissions " +"to lift restrictions from a user. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.restrict:8 of +msgid "Source: https://core.telegram.org/bots/api#restrictchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:11 of +msgid "A JSON-serialized object for new user permissions" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:12 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 +msgid "" +"instance of method " +":class:`aiogram.methods.restrict_chat_member.RestrictChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.unban:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unban_chat_member.UnbanChatMember` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unban:6 of +msgid "" +"Use this method to unban a previously banned user in a supergroup or " +"channel. The user will **not** return to the group or channel " +"automatically, but will be able to join via link, etc. The bot must be an" +" administrator for this to work. By default, this method guarantees that " +"after the call the user is not a member of the chat, but will be able to " +"join it. So if the user is a member of the chat they will also be " +"**removed** from the chat. If you don't want this, use the parameter " +"*only_if_banned*. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.unban:8 of +msgid "Source: https://core.telegram.org/bots/api#unbanchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.unban:11 of +msgid "Do nothing if the user is not banned" +msgstr "" + +#: aiogram.types.chat.Chat.unban:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.unban_chat_member.UnbanChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.ban:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.ban_chat_member.BanChatMember` will automatically" +" fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.ban:6 of +msgid "" +"Use this method to ban a user in a group, a supergroup or a channel. In " +"the case of supergroups and channels, the user will not be able to return" +" to the chat on their own using invite links, etc., unless `unbanned " +"`_ first. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.ban:8 of +msgid "Source: https://core.telegram.org/bots/api#banchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.ban:11 of +msgid "" +"Date when the user will be unbanned, unix time. If user is banned for " +"more than 366 days or less than 30 seconds from the current time they are" +" considered to be banned forever. Applied for supergroups and channels " +"only." +msgstr "" + +#: aiogram.types.chat.Chat.ban:12 of +msgid "" +"Pass :code:`True` to delete all messages from the chat for the user that " +"is being removed. If :code:`False`, the user will be able to see messages" +" in the group that were sent before the user was removed. Always " +":code:`True` for supergroups and channels." +msgstr "" + +#: aiogram.types.chat.Chat.ban:13 of +msgid "instance of method :class:`aiogram.methods.ban_chat_member.BanChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_description.SetChatDescription` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:6 of +msgid "" +"Use this method to change the description of a group, a supergroup or a " +"channel. The bot must be an administrator in the chat for this to work " +"and must have the appropriate administrator rights. Returns :code:`True` " +"on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_description:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatdescription" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:10 of +msgid "New chat description, 0-255 characters" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_description.SetChatDescription`" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.set_chat_title.SetChatTitle` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:6 of +msgid "" +"Use this method to change the title of a chat. Titles can't be changed " +"for private chats. The bot must be an administrator in the chat for this " +"to work and must have the appropriate administrator rights. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_title:8 of +msgid "Source: https://core.telegram.org/bots/api#setchattitle" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:10 of +msgid "New chat title, 1-128 characters" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:11 of +msgid "instance of method :class:`aiogram.methods.set_chat_title.SetChatTitle`" +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:6 of +msgid "" +"Use this method to delete a chat photo. Photos can't be changed for " +"private chats. The bot must be an administrator in the chat for this to " +"work and must have the appropriate administrator rights. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:8 of +msgid "Source: https://core.telegram.org/bots/api#deletechatphoto" +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto`" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.set_chat_photo.SetChatPhoto` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:6 of +msgid "" +"Use this method to set a new profile photo for the chat. Photos can't be " +"changed for private chats. The bot must be an administrator in the chat " +"for this to work and must have the appropriate administrator rights. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatphoto" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:10 of +msgid "New chat photo, uploaded using multipart/form-data" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:11 of +msgid "instance of method :class:`aiogram.methods.set_chat_photo.SetChatPhoto`" +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 41ec1522e8..0349c899ec 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,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -54,9 +54,70 @@ msgid "" msgstr "" #: aiogram.types.chat_join_request.ChatJoinRequest.approve:1 of -msgid "Use this method to approve a chat join request." +msgid "" +"Shortcut for method " +":class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:4 +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:4 of +msgid ":code:`chat_id`" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:5 +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:5 of +msgid ":code:`user_id`" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:7 of +msgid "" +"Use this method to approve a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:9 of +msgid "Source: https://core.telegram.org/bots/api#approvechatjoinrequest" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve +#: aiogram.types.chat_join_request.ChatJoinRequest.decline of +msgid "Returns" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest`" msgstr "" #: aiogram.types.chat_join_request.ChatJoinRequest.decline:1 of -msgid "Use this method to decline a chat join request." +msgid "" +"Shortcut for method " +":class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest`" +" will automatically fill method attributes:" msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:7 of +msgid "" +"Use this method to decline a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:9 of +msgid "Source: https://core.telegram.org/bots/api#declinechatjoinrequest" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest`" +msgstr "" + +#~ msgid "Use this method to approve a chat join request." +#~ msgstr "" + +#~ msgid "Use this method to decline a chat join request." +#~ 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 2ac6bbc4f7..87fe233103 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat_member.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -56,7 +56,7 @@ msgid "Source: https://core.telegram.org/bots/api#chatmember" msgstr "" #: ../../docstring aiogram.types.chat_member.ChatMember.status:1 of -msgid "..." +msgid "The member's status in the chat" msgstr "" #: ../../docstring aiogram.types.chat_member.ChatMember.user:1 of @@ -191,3 +191,6 @@ msgid "" "*Optional*. Date when restrictions will be lifted for this user; unix " "time. If 0, then the user is restricted forever" msgstr "" + +#~ msgid "..." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/index.po b/docs/locale/en/LC_MESSAGES/api/types/index.po index e0e624ee84..c749306843 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/index.po +++ b/docs/locale/en/LC_MESSAGES/api/types/index.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -25,34 +25,33 @@ msgstr "" msgid "Here is list of all available API types:" msgstr "" -#: ../../api/types/index.rst:10 -msgid "Getting updates" +#: ../../api/types/index.rst:9 +msgid "Inline mode" msgstr "" -#: ../../api/types/index.rst:19 +#: ../../api/types/index.rst:46 msgid "Available types" msgstr "" -#: ../../api/types/index.rst:101 -msgid "Stickers" +#: ../../api/types/index.rst:130 +msgid "Telegram Passport" msgstr "" -#: ../../api/types/index.rst:111 -msgid "Inline mode" +#: ../../api/types/index.rst:151 +msgid "Getting updates" msgstr "" -#: ../../api/types/index.rst:148 -msgid "Payments" +#: ../../api/types/index.rst:160 +msgid "Stickers" msgstr "" -#: ../../api/types/index.rst:163 -msgid "Telegram Passport" +#: ../../api/types/index.rst:170 +msgid "Payments" msgstr "" -#: ../../api/types/index.rst:184 +#: ../../api/types/index.rst:185 msgid "Games" msgstr "" -#: ../../api/types/index.rst:195 -msgid "Internal events" -msgstr "" +#~ msgid "Internal events" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/inline_query.po b/docs/locale/en/LC_MESSAGES/api/types/inline_query.po index 286303363e..4146b04946 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/inline_query.po +++ b/docs/locale/en/LC_MESSAGES/api/types/inline_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -60,10 +60,81 @@ msgstr "" msgid "*Optional*. Sender location, only for bots that request user location" msgstr "" +#: aiogram.types.inline_query.InlineQuery.answer:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.answer_inline_query.AnswerInlineQuery` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:4 of +msgid ":code:`inline_query_id`" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:6 of +msgid "" +"Use this method to send answers to an inline query. On success, " +":code:`True` is returned." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:8 of +msgid "No more than **50** results per query are allowed." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:10 of +msgid "Source: https://core.telegram.org/bots/api#answerinlinequery" +msgstr "" + #: aiogram.types.inline_query.InlineQuery.answer of msgid "Parameters" msgstr "" +#: aiogram.types.inline_query.InlineQuery.answer:12 of +msgid "A JSON-serialized array of results for the inline query" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:13 of +msgid "" +"The maximum amount of time in seconds that the result of the inline query" +" may be cached on the server. Defaults to 300." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:14 of +msgid "" +"Pass :code:`True` if results may be cached on the server side only for " +"the user that sent the query. By default, results may be returned to any " +"user who sends the same query" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:15 of +msgid "" +"Pass the offset that a client should send in the next query with the same" +" text to receive more results. Pass an empty string if there are no more " +"results or if you don't support pagination. Offset length can't exceed 64" +" bytes." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:16 of +msgid "" +"If passed, clients will display a button with specified text that " +"switches the user to a private chat with the bot and sends the bot a " +"start message with the parameter *switch_pm_parameter*" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:17 of +msgid "" +"`Deep-linking `_ " +"parameter for the /start message sent to the bot when user presses the " +"switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, " +":code:`0-9`, :code:`_` and :code:`-` are allowed." +msgstr "" + #: aiogram.types.inline_query.InlineQuery.answer of msgid "Returns" msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:18 of +msgid "" +"instance of method " +":class:`aiogram.methods.answer_inline_query.AnswerInlineQuery`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/menu_button.po b/docs/locale/en/LC_MESSAGES/api/types/menu_button.po index 09b5fabd66..ad862f2255 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/menu_button.po +++ b/docs/locale/en/LC_MESSAGES/api/types/menu_button.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -53,7 +53,7 @@ msgid "Source: https://core.telegram.org/bots/api#menubutton" msgstr "" #: ../../docstring aiogram.types.menu_button.MenuButton.type:1 of -msgid "..." +msgid "Type of the button" msgstr "" #: ../../docstring aiogram.types.menu_button.MenuButton.text:1 of @@ -67,3 +67,6 @@ msgid "" "message on behalf of the user using the method " ":class:`aiogram.methods.answer_web_app_query.AnswerWebAppQuery`." msgstr "" + +#~ msgid "..." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/message.po b/docs/locale/en/LC_MESSAGES/api/types/message.po index bab449e028..b51e09c80d 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/message.po +++ b/docs/locale/en/LC_MESSAGES/api/types/message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -378,8 +378,128 @@ msgid "" "buttons are represented as ordinary :code:`url` buttons." msgstr "" +#: aiogram.types.message.Message.answer_animation:1 #: aiogram.types.message.Message.reply_animation:1 of -msgid "Reply with animation" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer:4 +#: aiogram.types.message.Message.answer_animation:4 +#: aiogram.types.message.Message.answer_audio:4 +#: aiogram.types.message.Message.answer_contact:4 +#: aiogram.types.message.Message.answer_dice:4 +#: aiogram.types.message.Message.answer_document:4 +#: aiogram.types.message.Message.answer_game:4 +#: aiogram.types.message.Message.answer_invoice:4 +#: aiogram.types.message.Message.answer_location:4 +#: aiogram.types.message.Message.answer_media_group:4 +#: aiogram.types.message.Message.answer_photo:4 +#: aiogram.types.message.Message.answer_poll:4 +#: aiogram.types.message.Message.answer_sticker:4 +#: aiogram.types.message.Message.answer_venue:4 +#: aiogram.types.message.Message.answer_video:4 +#: aiogram.types.message.Message.answer_video_note:4 +#: aiogram.types.message.Message.answer_voice:4 +#: aiogram.types.message.Message.delete:4 +#: aiogram.types.message.Message.edit_caption:4 +#: aiogram.types.message.Message.edit_live_location:4 +#: aiogram.types.message.Message.edit_media:4 +#: aiogram.types.message.Message.edit_reply_markup:4 +#: aiogram.types.message.Message.edit_text:4 +#: aiogram.types.message.Message.pin:4 aiogram.types.message.Message.reply:4 +#: aiogram.types.message.Message.reply_animation:4 +#: aiogram.types.message.Message.reply_audio:4 +#: aiogram.types.message.Message.reply_contact:4 +#: aiogram.types.message.Message.reply_dice:4 +#: aiogram.types.message.Message.reply_document:4 +#: aiogram.types.message.Message.reply_game:4 +#: aiogram.types.message.Message.reply_invoice:4 +#: aiogram.types.message.Message.reply_location:4 +#: aiogram.types.message.Message.reply_media_group:4 +#: aiogram.types.message.Message.reply_photo:4 +#: aiogram.types.message.Message.reply_poll:4 +#: aiogram.types.message.Message.reply_sticker:4 +#: aiogram.types.message.Message.reply_venue:4 +#: aiogram.types.message.Message.reply_video:4 +#: aiogram.types.message.Message.reply_video_note:4 +#: aiogram.types.message.Message.reply_voice:4 +#: aiogram.types.message.Message.stop_live_location:4 +#: aiogram.types.message.Message.unpin:4 of +msgid ":code:`chat_id`" +msgstr "" + +#: aiogram.types.message.Message.answer:5 +#: aiogram.types.message.Message.answer_animation:5 +#: aiogram.types.message.Message.answer_audio:5 +#: aiogram.types.message.Message.answer_contact:5 +#: aiogram.types.message.Message.answer_dice:5 +#: aiogram.types.message.Message.answer_document:5 +#: aiogram.types.message.Message.answer_game:5 +#: aiogram.types.message.Message.answer_invoice:5 +#: aiogram.types.message.Message.answer_location:5 +#: aiogram.types.message.Message.answer_media_group:5 +#: aiogram.types.message.Message.answer_photo:5 +#: aiogram.types.message.Message.answer_poll:5 +#: aiogram.types.message.Message.answer_sticker:5 +#: aiogram.types.message.Message.answer_venue:5 +#: aiogram.types.message.Message.answer_video:5 +#: aiogram.types.message.Message.answer_video_note:5 +#: aiogram.types.message.Message.answer_voice:5 +#: aiogram.types.message.Message.reply:5 +#: aiogram.types.message.Message.reply_animation:5 +#: aiogram.types.message.Message.reply_audio:5 +#: aiogram.types.message.Message.reply_contact:5 +#: aiogram.types.message.Message.reply_dice:5 +#: aiogram.types.message.Message.reply_document:5 +#: aiogram.types.message.Message.reply_game:5 +#: aiogram.types.message.Message.reply_invoice:5 +#: aiogram.types.message.Message.reply_location:5 +#: aiogram.types.message.Message.reply_media_group:5 +#: aiogram.types.message.Message.reply_photo:5 +#: aiogram.types.message.Message.reply_poll:5 +#: aiogram.types.message.Message.reply_sticker:5 +#: aiogram.types.message.Message.reply_venue:5 +#: aiogram.types.message.Message.reply_video:5 +#: aiogram.types.message.Message.reply_video_note:5 +#: aiogram.types.message.Message.reply_voice:5 of +msgid ":code:`message_thread_id`" +msgstr "" + +#: aiogram.types.message.Message.reply:6 +#: aiogram.types.message.Message.reply_animation:6 +#: aiogram.types.message.Message.reply_audio:6 +#: aiogram.types.message.Message.reply_contact:6 +#: aiogram.types.message.Message.reply_dice:6 +#: aiogram.types.message.Message.reply_document:6 +#: aiogram.types.message.Message.reply_game:6 +#: aiogram.types.message.Message.reply_invoice:6 +#: aiogram.types.message.Message.reply_location:6 +#: aiogram.types.message.Message.reply_media_group:6 +#: aiogram.types.message.Message.reply_photo:6 +#: aiogram.types.message.Message.reply_poll:6 +#: aiogram.types.message.Message.reply_sticker:6 +#: aiogram.types.message.Message.reply_venue:6 +#: aiogram.types.message.Message.reply_video:6 +#: aiogram.types.message.Message.reply_video_note:6 +#: aiogram.types.message.Message.reply_voice:6 of +msgid ":code:`reply_to_message_id`" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:7 +#: aiogram.types.message.Message.reply_animation:8 of +msgid "" +"Use this method to send animation files (GIF or H.264/MPEG-4 AVC video " +"without sound). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send animation files of up to 50 MB in size, this limit may be changed in" +" the future." +msgstr "" + +#: aiogram.types.message.Message.answer_animation:9 +#: aiogram.types.message.Message.reply_animation:10 of +msgid "Source: https://core.telegram.org/bots/api#sendanimation" msgstr "" #: aiogram.types.message.Message.answer @@ -399,8 +519,14 @@ msgstr "" #: aiogram.types.message.Message.answer_video #: aiogram.types.message.Message.answer_video_note #: aiogram.types.message.Message.answer_voice -#: aiogram.types.message.Message.copy_to aiogram.types.message.Message.get_url -#: aiogram.types.message.Message.reply +#: aiogram.types.message.Message.copy_to +#: aiogram.types.message.Message.edit_caption +#: aiogram.types.message.Message.edit_live_location +#: aiogram.types.message.Message.edit_media +#: aiogram.types.message.Message.edit_reply_markup +#: aiogram.types.message.Message.edit_text +#: aiogram.types.message.Message.forward aiogram.types.message.Message.get_url +#: aiogram.types.message.Message.pin aiogram.types.message.Message.reply #: aiogram.types.message.Message.reply_animation #: aiogram.types.message.Message.reply_audio #: aiogram.types.message.Message.reply_contact @@ -417,10 +543,240 @@ msgstr "" #: aiogram.types.message.Message.reply_video #: aiogram.types.message.Message.reply_video_note #: aiogram.types.message.Message.reply_voice -#: aiogram.types.message.Message.send_copy of +#: aiogram.types.message.Message.send_copy +#: aiogram.types.message.Message.stop_live_location of msgid "Parameters" msgstr "" +#: aiogram.types.message.Message.answer_animation:11 +#: aiogram.types.message.Message.reply_animation:12 of +msgid "" +"Animation to send. Pass a file_id as String to send an animation that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an animation from the Internet, or upload a " +"new animation using multipart/form-data. :ref:`More information on " +"Sending Files » `" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:12 +#: aiogram.types.message.Message.reply_animation:13 of +msgid "Duration of sent animation in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:13 +#: aiogram.types.message.Message.reply_animation:14 of +msgid "Animation width" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:14 +#: aiogram.types.message.Message.reply_animation:15 of +msgid "Animation height" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:15 +#: aiogram.types.message.Message.answer_audio:19 +#: aiogram.types.message.Message.answer_document:12 +#: aiogram.types.message.Message.answer_video:15 +#: aiogram.types.message.Message.answer_video_note:14 +#: aiogram.types.message.Message.reply_animation:16 +#: aiogram.types.message.Message.reply_audio:20 +#: aiogram.types.message.Message.reply_document:13 +#: aiogram.types.message.Message.reply_video:16 +#: aiogram.types.message.Message.reply_video_note:15 of +msgid "" +"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 » `" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:16 +#: aiogram.types.message.Message.reply_animation:17 of +msgid "" +"Animation caption (may also be used when resending animation by " +"*file_id*), 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:17 +#: aiogram.types.message.Message.reply_animation:18 of +msgid "" +"Mode for parsing entities in the animation caption. See `formatting " +"options `_ for " +"more details." +msgstr "" + +#: aiogram.types.message.Message.answer_animation:18 +#: aiogram.types.message.Message.answer_audio:15 +#: aiogram.types.message.Message.answer_document:15 +#: aiogram.types.message.Message.answer_photo:14 +#: aiogram.types.message.Message.answer_video:18 +#: aiogram.types.message.Message.answer_voice:14 +#: aiogram.types.message.Message.edit_caption:14 +#: aiogram.types.message.Message.reply_animation:19 +#: aiogram.types.message.Message.reply_audio:16 +#: aiogram.types.message.Message.reply_document:16 +#: aiogram.types.message.Message.reply_photo:15 +#: aiogram.types.message.Message.reply_video:19 +#: aiogram.types.message.Message.reply_voice:15 of +msgid "" +"A JSON-serialized list of special entities that appear in the caption, " +"which can be specified instead of *parse_mode*" +msgstr "" + +#: aiogram.types.message.Message.answer:15 +#: aiogram.types.message.Message.answer_animation:19 +#: aiogram.types.message.Message.answer_audio:20 +#: aiogram.types.message.Message.answer_contact:15 +#: aiogram.types.message.Message.answer_dice:12 +#: aiogram.types.message.Message.answer_document:17 +#: aiogram.types.message.Message.answer_game:12 +#: aiogram.types.message.Message.answer_invoice:32 +#: aiogram.types.message.Message.answer_location:17 +#: aiogram.types.message.Message.answer_photo:15 +#: aiogram.types.message.Message.answer_poll:23 +#: aiogram.types.message.Message.answer_sticker:12 +#: aiogram.types.message.Message.answer_venue:19 +#: aiogram.types.message.Message.answer_video:20 +#: aiogram.types.message.Message.answer_video_note:15 +#: aiogram.types.message.Message.answer_voice:16 +#: aiogram.types.message.Message.copy_to:16 +#: aiogram.types.message.Message.forward:13 +#: aiogram.types.message.Message.reply:16 +#: aiogram.types.message.Message.reply_animation:20 +#: aiogram.types.message.Message.reply_audio:21 +#: aiogram.types.message.Message.reply_contact:16 +#: aiogram.types.message.Message.reply_dice:13 +#: aiogram.types.message.Message.reply_document:18 +#: aiogram.types.message.Message.reply_game:13 +#: aiogram.types.message.Message.reply_invoice:33 +#: aiogram.types.message.Message.reply_location:18 +#: aiogram.types.message.Message.reply_photo:16 +#: aiogram.types.message.Message.reply_poll:24 +#: aiogram.types.message.Message.reply_sticker:13 +#: aiogram.types.message.Message.reply_venue:20 +#: aiogram.types.message.Message.reply_video:21 +#: aiogram.types.message.Message.reply_video_note:16 +#: aiogram.types.message.Message.reply_voice:17 of +msgid "" +"Sends the message `silently `_. Users will receive a notification with no sound." +msgstr "" + +#: aiogram.types.message.Message.answer:16 +#: aiogram.types.message.Message.answer_animation:20 +#: aiogram.types.message.Message.answer_audio:21 +#: aiogram.types.message.Message.answer_contact:16 +#: aiogram.types.message.Message.answer_document:18 +#: aiogram.types.message.Message.answer_game:13 +#: aiogram.types.message.Message.answer_invoice:33 +#: aiogram.types.message.Message.answer_location:18 +#: aiogram.types.message.Message.answer_photo:16 +#: aiogram.types.message.Message.answer_poll:24 +#: aiogram.types.message.Message.answer_sticker:13 +#: aiogram.types.message.Message.answer_venue:20 +#: aiogram.types.message.Message.answer_video:21 +#: aiogram.types.message.Message.answer_video_note:16 +#: aiogram.types.message.Message.answer_voice:17 +#: aiogram.types.message.Message.copy_to:17 +#: aiogram.types.message.Message.reply:17 +#: aiogram.types.message.Message.reply_animation:21 +#: aiogram.types.message.Message.reply_audio:22 +#: aiogram.types.message.Message.reply_contact:17 +#: aiogram.types.message.Message.reply_document:19 +#: aiogram.types.message.Message.reply_game:14 +#: aiogram.types.message.Message.reply_invoice:34 +#: aiogram.types.message.Message.reply_location:19 +#: aiogram.types.message.Message.reply_photo:17 +#: aiogram.types.message.Message.reply_poll:25 +#: aiogram.types.message.Message.reply_sticker:14 +#: aiogram.types.message.Message.reply_venue:21 +#: aiogram.types.message.Message.reply_video:22 +#: aiogram.types.message.Message.reply_video_note:17 +#: aiogram.types.message.Message.reply_voice:18 of +msgid "Protects the contents of the sent message from forwarding and saving" +msgstr "" + +#: aiogram.types.message.Message.answer:18 +#: aiogram.types.message.Message.answer_animation:22 +#: aiogram.types.message.Message.answer_audio:23 +#: aiogram.types.message.Message.answer_contact:18 +#: aiogram.types.message.Message.answer_dice:15 +#: aiogram.types.message.Message.answer_document:20 +#: aiogram.types.message.Message.answer_game:15 +#: aiogram.types.message.Message.answer_invoice:35 +#: aiogram.types.message.Message.answer_location:20 +#: aiogram.types.message.Message.answer_media_group:15 +#: aiogram.types.message.Message.answer_photo:18 +#: aiogram.types.message.Message.answer_poll:26 +#: aiogram.types.message.Message.answer_sticker:15 +#: aiogram.types.message.Message.answer_venue:22 +#: aiogram.types.message.Message.answer_video:23 +#: aiogram.types.message.Message.answer_video_note:18 +#: aiogram.types.message.Message.answer_voice:19 +#: aiogram.types.message.Message.copy_to:19 +#: aiogram.types.message.Message.reply:18 +#: aiogram.types.message.Message.reply_animation:22 +#: aiogram.types.message.Message.reply_audio:23 +#: aiogram.types.message.Message.reply_contact:18 +#: aiogram.types.message.Message.reply_dice:15 +#: aiogram.types.message.Message.reply_document:20 +#: aiogram.types.message.Message.reply_game:15 +#: aiogram.types.message.Message.reply_invoice:35 +#: aiogram.types.message.Message.reply_location:20 +#: aiogram.types.message.Message.reply_media_group:15 +#: aiogram.types.message.Message.reply_photo:18 +#: aiogram.types.message.Message.reply_poll:26 +#: aiogram.types.message.Message.reply_sticker:15 +#: aiogram.types.message.Message.reply_venue:22 +#: aiogram.types.message.Message.reply_video:23 +#: aiogram.types.message.Message.reply_video_note:18 +#: aiogram.types.message.Message.reply_voice:19 of +msgid "" +"Pass :code:`True` if the message should be sent even if the specified " +"replied-to message is not found" +msgstr "" + +#: aiogram.types.message.Message.answer:19 +#: aiogram.types.message.Message.answer_animation:23 +#: aiogram.types.message.Message.answer_audio:24 +#: aiogram.types.message.Message.answer_contact:19 +#: aiogram.types.message.Message.answer_dice:16 +#: aiogram.types.message.Message.answer_document:21 +#: aiogram.types.message.Message.answer_location:21 +#: aiogram.types.message.Message.answer_photo:19 +#: aiogram.types.message.Message.answer_poll:27 +#: aiogram.types.message.Message.answer_sticker:16 +#: aiogram.types.message.Message.answer_venue:23 +#: aiogram.types.message.Message.answer_video:24 +#: aiogram.types.message.Message.answer_video_note:19 +#: aiogram.types.message.Message.answer_voice:20 +#: aiogram.types.message.Message.copy_to:20 +#: aiogram.types.message.Message.reply:19 +#: aiogram.types.message.Message.reply_animation:23 +#: aiogram.types.message.Message.reply_audio:24 +#: aiogram.types.message.Message.reply_contact:19 +#: aiogram.types.message.Message.reply_dice:16 +#: aiogram.types.message.Message.reply_document:21 +#: aiogram.types.message.Message.reply_location:21 +#: aiogram.types.message.Message.reply_photo:19 +#: aiogram.types.message.Message.reply_poll:27 +#: aiogram.types.message.Message.reply_sticker:16 +#: aiogram.types.message.Message.reply_venue:23 +#: aiogram.types.message.Message.reply_video:24 +#: aiogram.types.message.Message.reply_video_note:19 +#: aiogram.types.message.Message.reply_voice:20 of +msgid "" +"Additional interface options. A JSON-serialized object for an `inline " +"keyboard `_, " +"`custom reply keyboard " +"`_, instructions to " +"remove reply keyboard or to force a reply from the user." +msgstr "" + #: aiogram.types.message.Message.answer #: aiogram.types.message.Message.answer_animation #: aiogram.types.message.Message.answer_audio @@ -438,8 +794,14 @@ msgstr "" #: aiogram.types.message.Message.answer_video #: aiogram.types.message.Message.answer_video_note #: aiogram.types.message.Message.answer_voice -#: aiogram.types.message.Message.copy_to aiogram.types.message.Message.get_url -#: aiogram.types.message.Message.reply +#: aiogram.types.message.Message.copy_to aiogram.types.message.Message.delete +#: aiogram.types.message.Message.edit_caption +#: aiogram.types.message.Message.edit_live_location +#: aiogram.types.message.Message.edit_media +#: aiogram.types.message.Message.edit_reply_markup +#: aiogram.types.message.Message.edit_text +#: aiogram.types.message.Message.forward aiogram.types.message.Message.get_url +#: aiogram.types.message.Message.pin aiogram.types.message.Message.reply #: aiogram.types.message.Message.reply_animation #: aiogram.types.message.Message.reply_audio #: aiogram.types.message.Message.reply_contact @@ -456,90 +818,305 @@ msgstr "" #: aiogram.types.message.Message.reply_video #: aiogram.types.message.Message.reply_video_note #: aiogram.types.message.Message.reply_voice -#: aiogram.types.message.Message.send_copy of +#: aiogram.types.message.Message.send_copy +#: aiogram.types.message.Message.stop_live_location +#: aiogram.types.message.Message.unpin of msgid "Returns" msgstr "" -#: aiogram.types.message.Message.answer_animation:1 of -msgid "Answer with animation" +#: aiogram.types.message.Message.answer_animation:24 +#: aiogram.types.message.Message.reply_animation:24 of +msgid "instance of method :class:`aiogram.methods.send_animation.SendAnimation`" +msgstr "" + +#: aiogram.types.message.Message.answer:17 +#: aiogram.types.message.Message.answer_animation:21 +#: aiogram.types.message.Message.answer_audio:22 +#: aiogram.types.message.Message.answer_contact:17 +#: aiogram.types.message.Message.answer_dice:14 +#: aiogram.types.message.Message.answer_document:19 +#: aiogram.types.message.Message.answer_game:14 +#: aiogram.types.message.Message.answer_invoice:34 +#: aiogram.types.message.Message.answer_location:19 +#: aiogram.types.message.Message.answer_photo:17 +#: aiogram.types.message.Message.answer_poll:25 +#: aiogram.types.message.Message.answer_sticker:14 +#: aiogram.types.message.Message.answer_venue:21 +#: aiogram.types.message.Message.answer_video:22 +#: aiogram.types.message.Message.answer_video_note:17 +#: aiogram.types.message.Message.answer_voice:18 +#: aiogram.types.message.Message.copy_to:18 of +msgid "If the message is a reply, ID of the original message" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:1 +#: aiogram.types.message.Message.reply_audio:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:7 +#: aiogram.types.message.Message.reply_audio:8 of +msgid "" +"Use this method to send audio files, if you want Telegram clients to " +"display them in the music player. Your audio must be in the .MP3 or .M4A " +"format. On success, the sent :class:`aiogram.types.message.Message` is " +"returned. Bots can currently send audio files of up to 50 MB in size, " +"this limit may be changed in the future. For sending voice messages, use " +"the :class:`aiogram.methods.send_voice.SendVoice` method instead." +msgstr "" + +#: aiogram.types.message.Message.answer_audio:10 +#: aiogram.types.message.Message.reply_audio:11 of +msgid "Source: https://core.telegram.org/bots/api#sendaudio" msgstr "" -#: aiogram.types.message.Message.reply_audio:1 of -msgid "Reply with audio" +#: aiogram.types.message.Message.answer_audio:12 +#: aiogram.types.message.Message.reply_audio:13 of +msgid "" +"Audio file to send. Pass a file_id as String to send an audio file that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an audio file from the Internet, or upload a " +"new one using multipart/form-data. :ref:`More information on Sending " +"Files » `" msgstr "" -#: aiogram.types.message.Message.answer_audio:1 of -msgid "Answer with audio" +#: aiogram.types.message.Message.answer_audio:13 +#: aiogram.types.message.Message.reply_audio:14 of +msgid "Audio caption, 0-1024 characters after entities parsing" msgstr "" +#: aiogram.types.message.Message.answer_audio:14 +#: aiogram.types.message.Message.reply_audio:15 of +msgid "" +"Mode for parsing entities in the audio caption. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.answer_audio:16 +#: aiogram.types.message.Message.reply_audio:17 of +msgid "Duration of the audio in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:17 +#: aiogram.types.message.Message.reply_audio:18 of +msgid "Performer" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:18 +#: aiogram.types.message.Message.reply_audio:19 of +msgid "Track name" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:25 +#: aiogram.types.message.Message.reply_audio:25 of +msgid "instance of method :class:`aiogram.methods.send_audio.SendAudio`" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:1 #: aiogram.types.message.Message.reply_contact:1 of -msgid "Reply with contact" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_contact.SendContact` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:7 +#: aiogram.types.message.Message.reply_contact:8 of +msgid "" +"Use this method to send phone contacts. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_contact:9 +#: aiogram.types.message.Message.reply_contact:10 of +msgid "Source: https://core.telegram.org/bots/api#sendcontact" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:11 +#: aiogram.types.message.Message.reply_contact:12 of +msgid "Contact's phone number" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:12 +#: aiogram.types.message.Message.reply_contact:13 of +msgid "Contact's first name" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:13 +#: aiogram.types.message.Message.reply_contact:14 of +msgid "Contact's last name" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:14 +#: aiogram.types.message.Message.reply_contact:15 of +msgid "" +"Additional data about the contact in the form of a `vCard " +"`_, 0-2048 bytes" msgstr "" -#: aiogram.types.message.Message.answer_contact:1 of -msgid "Answer with contact" +#: aiogram.types.message.Message.answer_contact:20 +#: aiogram.types.message.Message.reply_contact:20 of +msgid "instance of method :class:`aiogram.methods.send_contact.SendContact`" msgstr "" +#: aiogram.types.message.Message.answer_document:1 #: aiogram.types.message.Message.reply_document:1 of -msgid "Reply with document" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_document.SendDocument` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_document:7 +#: aiogram.types.message.Message.reply_document:8 of +msgid "" +"Use this method to send general files. On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send files of any type of up to 50 MB in size, this limit may be changed " +"in the future." +msgstr "" + +#: aiogram.types.message.Message.answer_document:9 +#: aiogram.types.message.Message.reply_document:10 of +msgid "Source: https://core.telegram.org/bots/api#senddocument" msgstr "" -#: aiogram.types.message.Message.answer_document:1 of -msgid "Answer with document" +#: aiogram.types.message.Message.answer_document:11 +#: aiogram.types.message.Message.reply_document:12 of +msgid "" +"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 » `" +msgstr "" + +#: aiogram.types.message.Message.answer_document:13 +#: aiogram.types.message.Message.reply_document:14 of +msgid "" +"Document caption (may also be used when resending documents by " +"*file_id*), 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_document:14 +#: aiogram.types.message.Message.reply_document:15 of +msgid "" +"Mode for parsing entities in the document caption. See `formatting " +"options `_ for " +"more details." +msgstr "" + +#: aiogram.types.message.Message.answer_document:16 +#: aiogram.types.message.Message.reply_document:17 of +msgid "" +"Disables automatic server-side content type detection for files uploaded " +"using multipart/form-data" +msgstr "" + +#: aiogram.types.message.Message.answer_document:22 +#: aiogram.types.message.Message.reply_document:22 of +msgid "instance of method :class:`aiogram.methods.send_document.SendDocument`" msgstr "" +#: aiogram.types.message.Message.answer_game:1 #: aiogram.types.message.Message.reply_game:1 of -msgid "Reply with game" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_game.SendGame` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_game:7 +#: aiogram.types.message.Message.reply_game:8 of +msgid "" +"Use this method to send a game. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.answer_game:1 of -msgid "Answer with game" +#: aiogram.types.message.Message.answer_game:9 +#: aiogram.types.message.Message.reply_game:10 of +msgid "Source: https://core.telegram.org/bots/api#sendgame" msgstr "" +#: aiogram.types.message.Message.answer_game:11 +#: aiogram.types.message.Message.reply_game:12 of +msgid "" +"Short name of the game, serves as the unique identifier for the game. Set" +" up your games via `@BotFather `_." +msgstr "" + +#: aiogram.types.message.Message.answer_game:16 +#: aiogram.types.message.Message.reply_game:16 of +msgid "" +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Play game_title' button will be shown. If not empty, the first " +"button must launch the game." +msgstr "" + +#: aiogram.types.message.Message.answer_game:17 +#: aiogram.types.message.Message.reply_game:17 of +msgid "instance of method :class:`aiogram.methods.send_game.SendGame`" +msgstr "" + +#: aiogram.types.message.Message.answer_invoice:1 #: aiogram.types.message.Message.reply_invoice:1 of -msgid "Reply with invoice" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_invoice:7 +#: aiogram.types.message.Message.reply_invoice:8 of +msgid "" +"Use this method to send invoices. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_invoice:9 +#: aiogram.types.message.Message.reply_invoice:10 of +msgid "Source: https://core.telegram.org/bots/api#sendinvoice" msgstr "" -#: aiogram.types.message.Message.answer_invoice:3 -#: aiogram.types.message.Message.reply_invoice:3 of +#: aiogram.types.message.Message.answer_invoice:11 +#: aiogram.types.message.Message.reply_invoice:12 of msgid "Product name, 1-32 characters" msgstr "" -#: aiogram.types.message.Message.answer_invoice:4 -#: aiogram.types.message.Message.reply_invoice:4 of +#: aiogram.types.message.Message.answer_invoice:12 +#: aiogram.types.message.Message.reply_invoice:13 of msgid "Product description, 1-255 characters" msgstr "" -#: aiogram.types.message.Message.answer_invoice:5 -#: aiogram.types.message.Message.reply_invoice:5 of +#: aiogram.types.message.Message.answer_invoice:13 +#: aiogram.types.message.Message.reply_invoice:14 of msgid "" "Bot-defined invoice payload, 1-128 bytes. This will not be displayed to " "the user, use for your internal processes." msgstr "" -#: aiogram.types.message.Message.answer_invoice:6 -#: aiogram.types.message.Message.reply_invoice:6 of +#: aiogram.types.message.Message.answer_invoice:14 +#: aiogram.types.message.Message.reply_invoice:15 of msgid "" "Payment provider token, obtained via `@BotFather " "`_" msgstr "" -#: aiogram.types.message.Message.answer_invoice:7 -#: aiogram.types.message.Message.reply_invoice:7 of +#: aiogram.types.message.Message.answer_invoice:15 +#: aiogram.types.message.Message.reply_invoice:16 of msgid "" "Three-letter ISO 4217 currency code, see `more on currencies " "`_" msgstr "" -#: aiogram.types.message.Message.answer_invoice:8 -#: aiogram.types.message.Message.reply_invoice:8 of +#: aiogram.types.message.Message.answer_invoice:16 +#: aiogram.types.message.Message.reply_invoice:17 of msgid "" "Price breakdown, a JSON-serialized list of components (e.g. product " "price, tax, discount, delivery cost, delivery tax, bonus, etc.)" msgstr "" -#: aiogram.types.message.Message.answer_invoice:9 -#: aiogram.types.message.Message.reply_invoice:9 of +#: aiogram.types.message.Message.answer_invoice:17 +#: aiogram.types.message.Message.reply_invoice:18 of msgid "" "The maximum accepted amount for tips in the *smallest units* of the " "currency (integer, **not** float/double). For example, for a maximum tip " @@ -550,8 +1127,8 @@ msgid "" "majority of currencies). Defaults to 0" msgstr "" -#: aiogram.types.message.Message.answer_invoice:10 -#: aiogram.types.message.Message.reply_invoice:10 of +#: aiogram.types.message.Message.answer_invoice:18 +#: aiogram.types.message.Message.reply_invoice:19 of msgid "" "A JSON-serialized array of suggested amounts of tips in the *smallest " "units* of the currency (integer, **not** float/double). At most 4 " @@ -560,8 +1137,8 @@ msgid "" "*max_tip_amount*." msgstr "" -#: aiogram.types.message.Message.answer_invoice:11 -#: aiogram.types.message.Message.reply_invoice:11 of +#: aiogram.types.message.Message.answer_invoice:19 +#: aiogram.types.message.Message.reply_invoice:20 of msgid "" "Unique deep-linking parameter. If left empty, **forwarded copies** of the" " sent message will have a *Pay* button, allowing multiple users to pay " @@ -571,244 +1148,1344 @@ msgid "" "as the start parameter" msgstr "" -#: aiogram.types.message.Message.answer_invoice:12 -#: aiogram.types.message.Message.reply_invoice:12 of +#: aiogram.types.message.Message.answer_invoice:20 +#: aiogram.types.message.Message.reply_invoice:21 of msgid "" "JSON-serialized data about the invoice, which will be shared with the " "payment provider. A detailed description of required fields should be " "provided by the payment provider." msgstr "" -#: aiogram.types.message.Message.answer_invoice:13 -#: aiogram.types.message.Message.reply_invoice:13 of +#: aiogram.types.message.Message.answer_invoice:21 +#: aiogram.types.message.Message.reply_invoice:22 of msgid "" "URL of the product photo for the invoice. Can be a photo of the goods or " "a marketing image for a service. People like it better when they see what" " they are paying for." msgstr "" -#: aiogram.types.message.Message.answer_invoice:14 -#: aiogram.types.message.Message.reply_invoice:14 of +#: aiogram.types.message.Message.answer_invoice:22 +#: aiogram.types.message.Message.reply_invoice:23 of msgid "Photo size in bytes" msgstr "" -#: aiogram.types.message.Message.answer_invoice:15 -#: aiogram.types.message.Message.reply_invoice:15 of +#: aiogram.types.message.Message.answer_invoice:23 +#: aiogram.types.message.Message.reply_invoice:24 of msgid "Photo width" msgstr "" -#: aiogram.types.message.Message.answer_invoice:16 -#: aiogram.types.message.Message.reply_invoice:16 of +#: aiogram.types.message.Message.answer_invoice:24 +#: aiogram.types.message.Message.reply_invoice:25 of msgid "Photo height" msgstr "" -#: aiogram.types.message.Message.answer_invoice:17 -#: aiogram.types.message.Message.reply_invoice:17 of +#: aiogram.types.message.Message.answer_invoice:25 +#: aiogram.types.message.Message.reply_invoice:26 of msgid "" "Pass :code:`True` if you require the user's full name to complete the " "order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:18 -#: aiogram.types.message.Message.reply_invoice:18 of +#: aiogram.types.message.Message.answer_invoice:26 +#: aiogram.types.message.Message.reply_invoice:27 of msgid "" "Pass :code:`True` if you require the user's phone number to complete the " "order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:19 -#: aiogram.types.message.Message.reply_invoice:19 of +#: aiogram.types.message.Message.answer_invoice:27 +#: aiogram.types.message.Message.reply_invoice:28 of msgid "" "Pass :code:`True` if you require the user's email address to complete the" " order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:20 -#: aiogram.types.message.Message.reply_invoice:20 of +#: aiogram.types.message.Message.answer_invoice:28 +#: aiogram.types.message.Message.reply_invoice:29 of msgid "" "Pass :code:`True` if you require the user's shipping address to complete " "the order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:21 -#: aiogram.types.message.Message.reply_invoice:21 of +#: aiogram.types.message.Message.answer_invoice:29 +#: aiogram.types.message.Message.reply_invoice:30 of msgid "Pass :code:`True` if the user's phone number should be sent to provider" msgstr "" -#: aiogram.types.message.Message.answer_invoice:22 -#: aiogram.types.message.Message.reply_invoice:22 of +#: aiogram.types.message.Message.answer_invoice:30 +#: aiogram.types.message.Message.reply_invoice:31 of msgid "Pass :code:`True` if the user's email address should be sent to provider" msgstr "" -#: aiogram.types.message.Message.answer_invoice:23 -#: aiogram.types.message.Message.reply_invoice:23 of +#: aiogram.types.message.Message.answer_invoice:31 +#: aiogram.types.message.Message.reply_invoice:32 of msgid "Pass :code:`True` if the final price depends on the shipping method" msgstr "" -#: aiogram.types.message.Message.answer_invoice:24 -#: aiogram.types.message.Message.reply_invoice:24 of +#: aiogram.types.message.Message.answer_invoice:36 +#: aiogram.types.message.Message.reply_invoice:36 of msgid "" -"Sends the message `silently `_. Users will receive a notification with no sound." +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Pay :code:`total price`' button will be shown. If not empty, the " +"first button must be a Pay button." msgstr "" -#: aiogram.types.message.Message.answer_invoice:25 -#: aiogram.types.message.Message.reply_invoice:25 of -msgid "Protects the contents of the sent message from forwarding and saving" +#: aiogram.types.message.Message.answer_invoice:37 +#: aiogram.types.message.Message.reply_invoice:37 of +msgid "instance of method :class:`aiogram.methods.send_invoice.SendInvoice`" msgstr "" -#: aiogram.types.message.Message.reply_invoice:26 of +#: aiogram.types.message.Message.answer_location:1 +#: aiogram.types.message.Message.reply_location:1 of msgid "" -"Pass :code:`True` if the message should be sent even if the specified " -"replied-to message is not found" +"Shortcut for method :class:`aiogram.methods.send_location.SendLocation` " +"will automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_invoice:26 -#: aiogram.types.message.Message.reply_invoice:27 of +#: aiogram.types.message.Message.answer_location:7 +#: aiogram.types.message.Message.reply_location:8 of msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_. If empty, one 'Pay :code:`total price`' button will be " -"shown. If not empty, the first button must be a Pay button." +"Use this method to send point on the map. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.answer_invoice:27 -#: aiogram.types.message.Message.reply_invoice:28 of -msgid "On success, the sent Message is returned." +#: aiogram.types.message.Message.answer_location:9 +#: aiogram.types.message.Message.reply_location:10 of +msgid "Source: https://core.telegram.org/bots/api#sendlocation" msgstr "" -#: aiogram.types.message.Message.answer_invoice:1 of -msgid "Answer with invoice" +#: aiogram.types.message.Message.answer_location:11 +#: aiogram.types.message.Message.reply_location:12 of +msgid "Latitude of the location" msgstr "" -#: aiogram.types.message.Message.reply_location:1 of -msgid "Reply with location" +#: aiogram.types.message.Message.answer_location:12 +#: aiogram.types.message.Message.reply_location:13 of +msgid "Longitude of the location" +msgstr "" + +#: aiogram.types.message.Message.answer_location:13 +#: aiogram.types.message.Message.edit_live_location:14 +#: aiogram.types.message.Message.reply_location:14 of +msgid "The radius of uncertainty for the location, measured in meters; 0-1500" +msgstr "" + +#: aiogram.types.message.Message.answer_location:14 +#: aiogram.types.message.Message.reply_location:15 of +msgid "" +"Period in seconds for which the location will be updated (see `Live " +"Locations `_, should be between" +" 60 and 86400." +msgstr "" + +#: aiogram.types.message.Message.answer_location:15 +#: aiogram.types.message.Message.reply_location:16 of +msgid "" +"For live locations, a direction in which the user is moving, in degrees. " +"Must be between 1 and 360 if specified." +msgstr "" + +#: aiogram.types.message.Message.answer_location:16 +#: aiogram.types.message.Message.reply_location:17 of +msgid "" +"For live locations, a maximum distance for proximity alerts about " +"approaching another chat member, in meters. Must be between 1 and 100000 " +"if specified." msgstr "" -#: aiogram.types.message.Message.answer_location:1 of -msgid "Answer with location" +#: aiogram.types.message.Message.answer_location:22 +#: aiogram.types.message.Message.reply_location:22 of +msgid "instance of method :class:`aiogram.methods.send_location.SendLocation`" msgstr "" +#: aiogram.types.message.Message.answer_media_group:1 #: aiogram.types.message.Message.reply_media_group:1 of -msgid "Reply with media group" +msgid "" +"Shortcut for method " +":class:`aiogram.methods.send_media_group.SendMediaGroup` will " +"automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_media_group:1 of -msgid "Answer with media group" +#: aiogram.types.message.Message.answer_media_group:7 +#: aiogram.types.message.Message.reply_media_group:8 of +msgid "" +"Use this method to send a group of photos, videos, documents or audios as" +" an album. Documents and audio files can be only grouped in an album with" +" messages of the same type. On success, an array of `Messages " +"`_ that were sent is " +"returned." msgstr "" -#: aiogram.types.message.Message.reply:1 of -msgid "Reply with text message" +#: aiogram.types.message.Message.answer_media_group:9 +#: aiogram.types.message.Message.reply_media_group:10 of +msgid "Source: https://core.telegram.org/bots/api#sendmediagroup" msgstr "" -#: aiogram.types.message.Message.answer:1 of -msgid "Answer with text message" +#: aiogram.types.message.Message.answer_media_group:11 +#: aiogram.types.message.Message.reply_media_group:12 of +msgid "" +"A JSON-serialized array describing messages to be sent, must include 2-10" +" items" msgstr "" -#: aiogram.types.message.Message.reply_photo:1 of -msgid "Reply with photo" +#: aiogram.types.message.Message.answer_media_group:12 +#: aiogram.types.message.Message.reply_media_group:13 of +msgid "" +"Sends messages `silently `_. Users will receive a notification with no sound." msgstr "" -#: aiogram.types.message.Message.answer_photo:1 of -msgid "Answer with photo" +#: aiogram.types.message.Message.answer_media_group:13 +#: aiogram.types.message.Message.reply_media_group:14 of +msgid "Protects the contents of the sent messages from forwarding and saving" msgstr "" -#: aiogram.types.message.Message.reply_poll:1 of -msgid "Reply with poll" +#: aiogram.types.message.Message.answer_media_group:16 +#: aiogram.types.message.Message.reply_media_group:16 of +msgid "" +"instance of method " +":class:`aiogram.methods.send_media_group.SendMediaGroup`" msgstr "" -#: aiogram.types.message.Message.answer_poll:1 of -msgid "Answer with poll" +#: aiogram.types.message.Message.answer_media_group:14 of +msgid "If the messages are a reply, ID of the original message" msgstr "" -#: aiogram.types.message.Message.answer_poll:8 of -msgid ":param explanation:" +#: aiogram.types.message.Message.answer:1 aiogram.types.message.Message.reply:1 +#: of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_message.SendMessage` " +"will automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_poll of -msgid "param explanation" +#: aiogram.types.message.Message.answer:7 aiogram.types.message.Message.reply:8 +#: of +msgid "" +"Use this method to send text messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.reply_dice:1 of -msgid "Reply with dice" +#: aiogram.types.message.Message.answer:9 +#: aiogram.types.message.Message.reply:10 of +msgid "Source: https://core.telegram.org/bots/api#sendmessage" msgstr "" -#: aiogram.types.message.Message.answer_dice:1 of -msgid "Answer with dice" +#: aiogram.types.message.Message.answer:11 +#: aiogram.types.message.Message.reply:12 of +msgid "Text of the message to be sent, 1-4096 characters after entities parsing" msgstr "" -#: aiogram.types.message.Message.reply_sticker:1 of -msgid "Reply with sticker" +#: aiogram.types.message.Message.answer:12 +#: aiogram.types.message.Message.edit_text:13 +#: aiogram.types.message.Message.reply:13 of +msgid "" +"Mode for parsing entities in the message text. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.types.message.Message.answer_sticker:1 of -msgid "Answer with sticker" +#: aiogram.types.message.Message.answer:13 +#: aiogram.types.message.Message.edit_text:14 +#: aiogram.types.message.Message.reply:14 of +msgid "" +"A JSON-serialized list of special entities that appear in message text, " +"which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.types.message.Message.reply_venue:1 of -msgid "Reply with venue" +#: aiogram.types.message.Message.answer:14 +#: aiogram.types.message.Message.edit_text:15 +#: aiogram.types.message.Message.reply:15 of +msgid "Disables link previews for links in this message" msgstr "" -#: aiogram.types.message.Message.answer_venue:1 of -msgid "Answer with venue" +#: aiogram.types.message.Message.answer:20 +#: aiogram.types.message.Message.reply:20 of +msgid "instance of method :class:`aiogram.methods.send_message.SendMessage`" msgstr "" -#: aiogram.types.message.Message.reply_video:1 of -msgid "Reply with video" +#: aiogram.types.message.Message.answer_photo:1 +#: aiogram.types.message.Message.reply_photo:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` will " +"automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_video:1 of -msgid "Answer with video" +#: aiogram.types.message.Message.answer_photo:7 +#: aiogram.types.message.Message.reply_photo:8 of +msgid "" +"Use this method to send photos. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.reply_video_note:1 of -msgid "Reply wit video note" +#: aiogram.types.message.Message.answer_photo:9 +#: aiogram.types.message.Message.reply_photo:10 of +msgid "Source: https://core.telegram.org/bots/api#sendphoto" msgstr "" -#: aiogram.types.message.Message.answer_video_note:1 of -msgid "Answer wit video note" +#: aiogram.types.message.Message.answer_photo:11 +#: aiogram.types.message.Message.reply_photo:12 of +msgid "" +"Photo to send. Pass a file_id as String to send a photo that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a photo from the Internet, or upload a new photo using " +"multipart/form-data. The photo must be at most 10 MB in size. The photo's" +" width and height must not exceed 10000 in total. Width and height ratio " +"must be at most 20. :ref:`More information on Sending Files » `" msgstr "" -#: aiogram.types.message.Message.reply_voice:1 of -msgid "Reply with voice" +#: aiogram.types.message.Message.answer_photo:12 +#: aiogram.types.message.Message.reply_photo:13 of +msgid "" +"Photo caption (may also be used when resending photos by *file_id*), " +"0-1024 characters after entities parsing" msgstr "" -#: aiogram.types.message.Message.answer_voice:1 of -msgid "Answer with voice" +#: aiogram.types.message.Message.answer_photo:13 +#: aiogram.types.message.Message.reply_photo:14 of +msgid "" +"Mode for parsing entities in the photo caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.types.message.Message.send_copy:1 of -msgid "Send copy of message." +#: aiogram.types.message.Message.answer_photo:20 +#: aiogram.types.message.Message.reply_photo:20 of +msgid "instance of method :class:`aiogram.methods.send_photo.SendPhoto`" msgstr "" -#: aiogram.types.message.Message.send_copy:3 of +#: aiogram.types.message.Message.answer_poll:1 +#: aiogram.types.message.Message.reply_poll:1 of msgid "" -"Is similar to :meth:`aiogram.client.bot.Bot.copy_message` but returning " -"the sent message instead of :class:`aiogram.types.message_id.MessageId`" +"Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` will " +"automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.send_copy:8 of +#: aiogram.types.message.Message.answer_poll:7 +#: aiogram.types.message.Message.reply_poll:8 of msgid "" -"This method don't use the API method named `copyMessage` and historically" -" implemented before the similar method is added to API" +"Use this method to send a native poll. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.copy_to:1 of -msgid "Copy message" +#: aiogram.types.message.Message.answer_poll:9 +#: aiogram.types.message.Message.reply_poll:10 of +msgid "Source: https://core.telegram.org/bots/api#sendpoll" msgstr "" -#: aiogram.types.message.Message.get_url:1 of +#: aiogram.types.message.Message.answer_poll:11 +#: aiogram.types.message.Message.reply_poll:12 of +msgid "Poll question, 1-300 characters" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:12 +#: aiogram.types.message.Message.reply_poll:13 of msgid "" -"Returns message URL. Cannot be used in private (one-to-one) chats. If " -"chat has a username, returns URL like https://t.me/username/message_id " -"Otherwise (or if {force_private} flag is set), returns " -"https://t.me/c/shifted_chat_id/message_id" +"A JSON-serialized list of answer options, 2-10 strings 1-100 characters " +"each" msgstr "" -#: aiogram.types.message.Message.get_url:5 of -msgid "if set, a private URL is returned even for a public chat" +#: aiogram.types.message.Message.answer_poll:13 +#: aiogram.types.message.Message.reply_poll:14 of +msgid ":code:`True`, if the poll needs to be anonymous, defaults to :code:`True`" msgstr "" -#: aiogram.types.message.Message.get_url:6 of -msgid "string with full message URL" +#: aiogram.types.message.Message.answer_poll:14 +#: aiogram.types.message.Message.reply_poll:15 of +msgid "Poll type, 'quiz' or 'regular', defaults to 'regular'" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:15 +#: aiogram.types.message.Message.reply_poll:16 of +msgid "" +":code:`True`, if the poll allows multiple answers, ignored for polls in " +"quiz mode, defaults to :code:`False`" msgstr "" + +#: aiogram.types.message.Message.answer_poll:16 +#: aiogram.types.message.Message.reply_poll:17 of +msgid "" +"0-based identifier of the correct answer option, required for polls in " +"quiz mode" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:17 +#: aiogram.types.message.Message.reply_poll:18 of +msgid "" +"Text that is shown when a user chooses an incorrect answer or taps on the" +" lamp icon in a quiz-style poll, 0-200 characters with at most 2 line " +"feeds after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:18 +#: aiogram.types.message.Message.reply_poll:19 of +msgid "" +"Mode for parsing entities in the explanation. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:19 +#: aiogram.types.message.Message.reply_poll:20 of +msgid "" +"A JSON-serialized list of special entities that appear in the poll " +"explanation, which can be specified instead of *parse_mode*" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:20 +#: aiogram.types.message.Message.reply_poll:21 of +msgid "" +"Amount of time in seconds the poll will be active after creation, 5-600. " +"Can't be used together with *close_date*." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:21 +#: aiogram.types.message.Message.reply_poll:22 of +msgid "" +"Point in time (Unix timestamp) when the poll will be automatically " +"closed. Must be at least 5 and no more than 600 seconds in the future. " +"Can't be used together with *open_period*." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:22 +#: aiogram.types.message.Message.reply_poll:23 of +msgid "" +"Pass :code:`True` if the poll needs to be immediately closed. This can be" +" useful for poll preview." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:28 +#: aiogram.types.message.Message.reply_poll:28 of +msgid "instance of method :class:`aiogram.methods.send_poll.SendPoll`" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:1 +#: aiogram.types.message.Message.reply_dice:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_dice.SendDice` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:7 +#: aiogram.types.message.Message.reply_dice:8 of +msgid "" +"Use this method to send an animated emoji that will display a random " +"value. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." +msgstr "" + +#: aiogram.types.message.Message.answer_dice:9 +#: aiogram.types.message.Message.reply_dice:10 of +msgid "Source: https://core.telegram.org/bots/api#senddice" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:11 +#: aiogram.types.message.Message.reply_dice:12 of +msgid "" +"Emoji on which the dice throw animation is based. Currently, must be one " +"of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯'" +" and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults " +"to '🎲'" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:13 +#: aiogram.types.message.Message.reply_dice:14 of +msgid "Protects the contents of the sent message from forwarding" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:17 +#: aiogram.types.message.Message.reply_dice:17 of +msgid "instance of method :class:`aiogram.methods.send_dice.SendDice`" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:1 +#: aiogram.types.message.Message.reply_sticker:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:7 +#: aiogram.types.message.Message.reply_sticker:8 of +msgid "" +"Use this method to send static .WEBP, `animated " +"`_ .TGS, or `video " +"`_ .WEBM " +"stickers. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:9 +#: aiogram.types.message.Message.reply_sticker:10 of +msgid "Source: https://core.telegram.org/bots/api#sendsticker" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:11 +#: aiogram.types.message.Message.reply_sticker:12 of +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 "" + +#: aiogram.types.message.Message.answer_sticker:17 +#: aiogram.types.message.Message.reply_sticker:17 of +msgid "instance of method :class:`aiogram.methods.send_sticker.SendSticker`" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:1 +#: aiogram.types.message.Message.reply_venue:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:7 +#: aiogram.types.message.Message.reply_venue:8 of +msgid "" +"Use this method to send information about a venue. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_venue:9 +#: aiogram.types.message.Message.reply_venue:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvenue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:11 +#: aiogram.types.message.Message.reply_venue:12 of +msgid "Latitude of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:12 +#: aiogram.types.message.Message.reply_venue:13 of +msgid "Longitude of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:13 +#: aiogram.types.message.Message.reply_venue:14 of +msgid "Name of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:14 +#: aiogram.types.message.Message.reply_venue:15 of +msgid "Address of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:15 +#: aiogram.types.message.Message.reply_venue:16 of +msgid "Foursquare identifier of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:16 +#: aiogram.types.message.Message.reply_venue:17 of +msgid "" +"Foursquare type of the venue, if known. (For example, " +"'arts_entertainment/default', 'arts_entertainment/aquarium' or " +"'food/icecream'.)" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:17 +#: aiogram.types.message.Message.reply_venue:18 of +msgid "Google Places identifier of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:18 +#: aiogram.types.message.Message.reply_venue:19 of +msgid "" +"Google Places type of the venue. (See `supported types " +"`_.)" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:24 +#: aiogram.types.message.Message.reply_venue:24 of +msgid "instance of method :class:`aiogram.methods.send_venue.SendVenue`" +msgstr "" + +#: aiogram.types.message.Message.answer_video:1 +#: aiogram.types.message.Message.reply_video:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_video.SendVideo` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_video:7 +#: aiogram.types.message.Message.reply_video:8 of +msgid "" +"Use this method to send video files, Telegram clients support MPEG4 " +"videos (other formats may be sent as " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send video files of up to 50 MB in size, this limit may be changed in the" +" future." +msgstr "" + +#: aiogram.types.message.Message.answer_video:9 +#: aiogram.types.message.Message.reply_video:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvideo" +msgstr "" + +#: aiogram.types.message.Message.answer_video:11 +#: aiogram.types.message.Message.reply_video:12 of +msgid "" +"Video to send. Pass a file_id as String to send a video that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a video from the Internet, or upload a new video using " +"multipart/form-data. :ref:`More information on Sending Files » `" +msgstr "" + +#: aiogram.types.message.Message.answer_video:12 +#: aiogram.types.message.Message.answer_video_note:12 +#: aiogram.types.message.Message.reply_video:13 +#: aiogram.types.message.Message.reply_video_note:13 of +msgid "Duration of sent video in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_video:13 +#: aiogram.types.message.Message.reply_video:14 of +msgid "Video width" +msgstr "" + +#: aiogram.types.message.Message.answer_video:14 +#: aiogram.types.message.Message.reply_video:15 of +msgid "Video height" +msgstr "" + +#: aiogram.types.message.Message.answer_video:16 +#: aiogram.types.message.Message.reply_video:17 of +msgid "" +"Video caption (may also be used when resending videos by *file_id*), " +"0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_video:17 +#: aiogram.types.message.Message.reply_video:18 of +msgid "" +"Mode for parsing entities in the video caption. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.answer_video:19 +#: aiogram.types.message.Message.reply_video:20 of +msgid "Pass :code:`True` if the uploaded video is suitable for streaming" +msgstr "" + +#: aiogram.types.message.Message.answer_video:25 +#: aiogram.types.message.Message.reply_video:25 of +msgid "instance of method :class:`aiogram.methods.send_video.SendVideo`" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:1 +#: aiogram.types.message.Message.reply_video_note:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.send_video_note.SendVideoNote` will automatically" +" fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:7 +#: aiogram.types.message.Message.reply_video_note:8 of +msgid "" +"As of `v.4.0 `_, " +"Telegram clients support rounded square MPEG4 videos of up to 1 minute " +"long. Use this method to send video messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:9 +#: aiogram.types.message.Message.reply_video_note:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvideonote" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:11 +#: aiogram.types.message.Message.reply_video_note:12 of +msgid "" +"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" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:13 +#: aiogram.types.message.Message.reply_video_note:14 of +msgid "Video width and height, i.e. diameter of the video message" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:20 +#: aiogram.types.message.Message.reply_video_note:20 of +msgid "instance of method :class:`aiogram.methods.send_video_note.SendVideoNote`" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:1 +#: aiogram.types.message.Message.reply_voice:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:7 +#: aiogram.types.message.Message.reply_voice:8 of +msgid "" +"Use this method to send audio files, if you want Telegram clients to " +"display the file as a playable voice message. For this to work, your " +"audio must be in an .OGG file encoded with OPUS (other formats may be " +"sent as :class:`aiogram.types.audio.Audio` or " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send voice messages of up to 50 MB in size, this limit may be changed in " +"the future." +msgstr "" + +#: aiogram.types.message.Message.answer_voice:9 +#: aiogram.types.message.Message.reply_voice:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvoice" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:11 +#: aiogram.types.message.Message.reply_voice:12 of +msgid "" +"Audio 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 » `" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:12 +#: aiogram.types.message.Message.reply_voice:13 of +msgid "Voice message caption, 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:13 +#: aiogram.types.message.Message.reply_voice:14 of +msgid "" +"Mode for parsing entities in the voice message caption. See `formatting " +"options `_ for " +"more details." +msgstr "" + +#: aiogram.types.message.Message.answer_voice:15 +#: aiogram.types.message.Message.reply_voice:16 of +msgid "Duration of the voice message in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:21 +#: aiogram.types.message.Message.reply_voice:21 of +msgid "instance of method :class:`aiogram.methods.send_voice.SendVoice`" +msgstr "" + +#: aiogram.types.message.Message.send_copy:1 of +msgid "Send copy of message." +msgstr "" + +#: aiogram.types.message.Message.send_copy:3 of +msgid "" +"Is similar to :meth:`aiogram.client.bot.Bot.copy_message` but returning " +"the sent message instead of :class:`aiogram.types.message_id.MessageId`" +msgstr "" + +#: aiogram.types.message.Message.send_copy:8 of +msgid "" +"This method don't use the API method named `copyMessage` and historically" +" implemented before the similar method is added to API" +msgstr "" + +#: aiogram.types.message.Message.copy_to:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.copy_message.CopyMessage` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.copy_to:4 +#: aiogram.types.message.Message.forward:4 of +msgid ":code:`from_chat_id`" +msgstr "" + +#: aiogram.types.message.Message.copy_to:5 +#: aiogram.types.message.Message.delete:5 +#: aiogram.types.message.Message.edit_caption:5 +#: aiogram.types.message.Message.edit_live_location:5 +#: aiogram.types.message.Message.edit_media:5 +#: aiogram.types.message.Message.edit_reply_markup:5 +#: aiogram.types.message.Message.edit_text:5 +#: aiogram.types.message.Message.forward:5 aiogram.types.message.Message.pin:5 +#: aiogram.types.message.Message.stop_live_location:5 +#: aiogram.types.message.Message.unpin:5 of +msgid ":code:`message_id`" +msgstr "" + +#: aiogram.types.message.Message.copy_to:7 of +msgid "" +"Use this method to copy messages of any kind. Service messages and " +"invoice messages can't be copied. A quiz " +":class:`aiogram.methods.poll.Poll` can be copied only if the value of the" +" field *correct_option_id* is known to the bot. The method is analogous " +"to the method :class:`aiogram.methods.forward_message.ForwardMessage`, " +"but the copied message doesn't have a link to the original message. " +"Returns the :class:`aiogram.types.message_id.MessageId` of the sent " +"message on success." +msgstr "" + +#: aiogram.types.message.Message.copy_to:9 of +msgid "Source: https://core.telegram.org/bots/api#copymessage" +msgstr "" + +#: aiogram.types.message.Message.copy_to:11 +#: aiogram.types.message.Message.forward:11 of +msgid "" +"Unique identifier for the target chat or username of the target channel " +"(in the format :code:`@channelusername`)" +msgstr "" + +#: aiogram.types.message.Message.copy_to:12 +#: aiogram.types.message.Message.forward:12 of +msgid "" +"Unique identifier for the target message thread (topic) of the forum; for" +" forum supergroups only" +msgstr "" + +#: aiogram.types.message.Message.copy_to:13 of +msgid "" +"New caption for media, 0-1024 characters after entities parsing. If not " +"specified, the original caption is kept" +msgstr "" + +#: aiogram.types.message.Message.copy_to:14 of +msgid "" +"Mode for parsing entities in the new caption. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.copy_to:15 of +msgid "" +"A JSON-serialized list of special entities that appear in the new " +"caption, which can be specified instead of *parse_mode*" +msgstr "" + +#: aiogram.types.message.Message.copy_to:21 of +msgid "instance of method :class:`aiogram.methods.copy_message.CopyMessage`" +msgstr "" + +#: aiogram.types.message.Message.edit_text:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_text.EditMessageText` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_text:7 of +msgid "" +"Use this method to edit text and `game " +"`_ messages. 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." +msgstr "" + +#: aiogram.types.message.Message.edit_text:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagetext" +msgstr "" + +#: aiogram.types.message.Message.edit_text:11 of +msgid "New text of the message, 1-4096 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:11 +#: aiogram.types.message.Message.edit_live_location:13 +#: aiogram.types.message.Message.edit_media:12 +#: aiogram.types.message.Message.edit_reply_markup:11 +#: aiogram.types.message.Message.edit_text:12 +#: aiogram.types.message.Message.stop_live_location:11 of +msgid "" +"Required if *chat_id* and *message_id* are not specified. Identifier of " +"the inline message" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:15 +#: aiogram.types.message.Message.edit_reply_markup:12 +#: aiogram.types.message.Message.edit_text:16 of +msgid "" +"A JSON-serialized object for an `inline keyboard " +"`_." +msgstr "" + +#: aiogram.types.message.Message.edit_text:17 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_text.EditMessageText`" +msgstr "" + +#: aiogram.types.message.Message.forward:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.forward_message.ForwardMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.forward:7 of +msgid "" +"Use this method to forward messages of any kind. Service messages can't " +"be forwarded. On success, the sent :class:`aiogram.types.message.Message`" +" is returned." +msgstr "" + +#: aiogram.types.message.Message.forward:9 of +msgid "Source: https://core.telegram.org/bots/api#forwardmessage" +msgstr "" + +#: aiogram.types.message.Message.forward:14 of +msgid "Protects the contents of the forwarded message from forwarding and saving" +msgstr "" + +#: aiogram.types.message.Message.forward:15 of +msgid "instance of method :class:`aiogram.methods.forward_message.ForwardMessage`" +msgstr "" + +#: aiogram.types.message.Message.edit_media:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_media.EditMessageMedia` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_media:7 of +msgid "" +"Use this method to edit animation, audio, document, photo, or video " +"messages. If a message is part of a message album, then it can be edited " +"only to an audio for audio albums, only to a document for document albums" +" and to a photo or a video otherwise. When an inline message is edited, a" +" new file can't be uploaded; use a previously uploaded file via its " +"file_id or specify a URL. On success, if the edited message is not an " +"inline message, the edited :class:`aiogram.types.message.Message` is " +"returned, otherwise :code:`True` is returned." +msgstr "" + +#: aiogram.types.message.Message.edit_media:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagemedia" +msgstr "" + +#: aiogram.types.message.Message.edit_media:11 of +msgid "A JSON-serialized object for a new media content of the message" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:17 +#: aiogram.types.message.Message.edit_media:13 +#: aiogram.types.message.Message.stop_live_location:12 of +msgid "" +"A JSON-serialized object for a new `inline keyboard " +"`_." +msgstr "" + +#: aiogram.types.message.Message.edit_media:14 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_media.EditMessageMedia`" +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:7 of +msgid "" +"Use this method to edit only the reply markup of messages. 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." +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagereplymarkup" +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:13 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup`" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:7 of +msgid "" +"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." +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagelivelocation" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:11 of +msgid "Latitude of new location" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:12 of +msgid "Longitude of new location" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:15 of +msgid "" +"Direction in which the user is moving, in degrees. Must be between 1 and " +"360 if specified." +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:16 of +msgid "" +"The maximum distance for proximity alerts about approaching another chat " +"member, in meters. Must be between 1 and 100000 if specified." +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:18 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation`" +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:7 of +msgid "" +"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." +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:9 of +msgid "Source: https://core.telegram.org/bots/api#stopmessagelivelocation" +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:13 of +msgid "" +"instance of method " +":class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_caption.EditMessageCaption` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:7 of +msgid "" +"Use this method to edit captions of messages. 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." +msgstr "" + +#: aiogram.types.message.Message.edit_caption:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagecaption" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:12 of +msgid "New caption of the message, 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:13 of +msgid "" +"Mode for parsing entities in the message caption. See `formatting options" +" `_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.edit_caption:16 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_caption.EditMessageCaption`" +msgstr "" + +#: aiogram.types.message.Message.delete:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.delete:7 of +msgid "" +"Use this method to delete a message, including service messages, with the" +" following limitations:" +msgstr "" + +#: aiogram.types.message.Message.delete:9 of +msgid "A message can only be deleted if it was sent less than 48 hours ago." +msgstr "" + +#: aiogram.types.message.Message.delete:11 of +msgid "" +"Service messages about a supergroup, channel, or forum topic creation " +"can't be deleted." +msgstr "" + +#: aiogram.types.message.Message.delete:13 of +msgid "" +"A dice message in a private chat can only be deleted if it was sent more " +"than 24 hours ago." +msgstr "" + +#: aiogram.types.message.Message.delete:15 of +msgid "" +"Bots can delete outgoing messages in private chats, groups, and " +"supergroups." +msgstr "" + +#: aiogram.types.message.Message.delete:17 of +msgid "Bots can delete incoming messages in private chats." +msgstr "" + +#: aiogram.types.message.Message.delete:19 of +msgid "" +"Bots granted *can_post_messages* permissions can delete outgoing messages" +" in channels." +msgstr "" + +#: aiogram.types.message.Message.delete:21 of +msgid "" +"If the bot is an administrator of a group, it can delete any message " +"there." +msgstr "" + +#: aiogram.types.message.Message.delete:23 of +msgid "" +"If the bot has *can_delete_messages* permission in a supergroup or a " +"channel, it can delete any message there." +msgstr "" + +#: aiogram.types.message.Message.delete:25 of +msgid "Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.message.Message.delete:27 of +msgid "Source: https://core.telegram.org/bots/api#deletemessage" +msgstr "" + +#: aiogram.types.message.Message.delete:29 of +msgid "instance of method :class:`aiogram.methods.delete_message.DeleteMessage`" +msgstr "" + +#: aiogram.types.message.Message.pin:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.pin:7 of +msgid "" +"Use this method to add a message to the list of pinned messages in a " +"chat. If the chat is not a private chat, the bot must be an administrator" +" in the chat for this to work and must have the 'can_pin_messages' " +"administrator right in a supergroup or 'can_edit_messages' administrator " +"right in a channel. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.message.Message.pin:9 of +msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +msgstr "" + +#: aiogram.types.message.Message.pin:11 of +msgid "" +"Pass :code:`True` if it is not necessary to send a notification to all " +"chat members about the new pinned message. Notifications are always " +"disabled in channels and private chats." +msgstr "" + +#: aiogram.types.message.Message.pin:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage`" +msgstr "" + +#: aiogram.types.message.Message.unpin:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.unpin:7 of +msgid "" +"Use this method to remove a message from the list of pinned messages in a" +" chat. If the chat is not a private chat, the bot must be an " +"administrator in the chat for this to work and must have the " +"'can_pin_messages' administrator right in a supergroup or " +"'can_edit_messages' administrator right in a channel. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.message.Message.unpin:9 of +msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +msgstr "" + +#: aiogram.types.message.Message.unpin:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage`" +msgstr "" + +#: aiogram.types.message.Message.get_url:1 of +msgid "" +"Returns message URL. Cannot be used in private (one-to-one) chats. If " +"chat has a username, returns URL like https://t.me/username/message_id " +"Otherwise (or if {force_private} flag is set), returns " +"https://t.me/c/shifted_chat_id/message_id" +msgstr "" + +#: aiogram.types.message.Message.get_url:5 of +msgid "if set, a private URL is returned even for a public chat" +msgstr "" + +#: aiogram.types.message.Message.get_url:6 of +msgid "string with full message URL" +msgstr "" + +#~ msgid "Reply with animation" +#~ msgstr "" + +#~ msgid "Answer with animation" +#~ msgstr "" + +#~ msgid "Reply with audio" +#~ msgstr "" + +#~ msgid "Answer with audio" +#~ msgstr "" + +#~ msgid "Reply with contact" +#~ msgstr "" + +#~ msgid "Answer with contact" +#~ msgstr "" + +#~ msgid "Reply with document" +#~ msgstr "" + +#~ msgid "Answer with document" +#~ msgstr "" + +#~ msgid "Reply with game" +#~ msgstr "" + +#~ msgid "Answer with game" +#~ msgstr "" + +#~ msgid "Reply with invoice" +#~ msgstr "" + +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_. If empty, one 'Pay " +#~ ":code:`total price`' button will be " +#~ "shown. If not empty, the first " +#~ "button must be a Pay button." +#~ msgstr "" + +#~ msgid "On success, the sent Message is returned." +#~ msgstr "" + +#~ msgid "Answer with invoice" +#~ msgstr "" + +#~ msgid "Reply with location" +#~ msgstr "" + +#~ msgid "Answer with location" +#~ msgstr "" + +#~ msgid "Reply with media group" +#~ msgstr "" + +#~ msgid "Answer with media group" +#~ msgstr "" + +#~ msgid "Reply with text message" +#~ msgstr "" + +#~ msgid "Answer with text message" +#~ msgstr "" + +#~ msgid "Reply with photo" +#~ msgstr "" + +#~ msgid "Answer with photo" +#~ msgstr "" + +#~ msgid "Reply with poll" +#~ msgstr "" + +#~ msgid "Answer with poll" +#~ msgstr "" + +#~ msgid ":param explanation:" +#~ msgstr "" + +#~ msgid "param explanation" +#~ msgstr "" + +#~ msgid "Reply with dice" +#~ msgstr "" + +#~ msgid "Answer with dice" +#~ msgstr "" + +#~ msgid "Reply with sticker" +#~ msgstr "" + +#~ msgid "Answer with sticker" +#~ msgstr "" + +#~ msgid "Reply with venue" +#~ msgstr "" + +#~ msgid "Answer with venue" +#~ msgstr "" + +#~ msgid "Reply with video" +#~ msgstr "" + +#~ msgid "Answer with video" +#~ msgstr "" + +#~ msgid "Reply wit video note" +#~ msgstr "" + +#~ msgid "Answer wit video note" +#~ msgstr "" + +#~ msgid "Reply with voice" +#~ msgstr "" + +#~ msgid "Answer with voice" +#~ msgstr "" + +#~ msgid "Copy message" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/message_entity.po b/docs/locale/en/LC_MESSAGES/api/types/message_entity.po index e295f9d287..806b3cd098 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/message_entity.po +++ b/docs/locale/en/LC_MESSAGES/api/types/message_entity.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -46,11 +46,15 @@ msgid "" msgstr "" #: ../../docstring aiogram.types.message_entity.MessageEntity.offset:1 of -msgid "Offset in UTF-16 code units to the start of the entity" +msgid "" +"Offset in `UTF-16 code units `_ to the start of the entity" msgstr "" #: ../../docstring aiogram.types.message_entity.MessageEntity.length:1 of -msgid "Length of the entity in UTF-16 code units" +msgid "" +"Length of the entity in `UTF-16 code units " +"`_" msgstr "" #: ../../docstring aiogram.types.message_entity.MessageEntity.url:1 of @@ -75,3 +79,9 @@ msgid "" ":class:`aiogram.methods.get_custom_emoji_stickers.GetCustomEmojiStickers`" " to get full information about the sticker" msgstr "" + +#~ msgid "Offset in UTF-16 code units to the start of the entity" +#~ msgstr "" + +#~ msgid "Length of the entity in UTF-16 code units" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/reply_keyboard_markup.po b/docs/locale/en/LC_MESSAGES/api/types/reply_keyboard_markup.po index 3628893b1e..43841e57ba 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/reply_keyboard_markup.po +++ b/docs/locale/en/LC_MESSAGES/api/types/reply_keyboard_markup.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -24,9 +24,10 @@ msgstr "" #: aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup:1 of msgid "" "This object represents a `custom keyboard " -"`_ with reply options (see " -"`Introduction to bots `_ for " -"details and examples)." +"`_ with reply options " +"(see `Introduction to bots " +"`_ for details and " +"examples)." msgstr "" #: aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup:3 of @@ -77,3 +78,11 @@ msgid "" "message is a reply (has *reply_to_message_id*), sender of the original " "message." msgstr "" + +#~ msgid "" +#~ "This object represents a `custom " +#~ "keyboard `_ with" +#~ " reply options (see `Introduction to " +#~ "bots `_ for " +#~ "details and examples)." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/sticker.po b/docs/locale/en/LC_MESSAGES/api/types/sticker.po index 9a27d3aa22..4f8fc38b7f 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/sticker.po +++ b/docs/locale/en/LC_MESSAGES/api/types/sticker.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -99,3 +99,67 @@ msgstr "" #: ../../docstring aiogram.types.sticker.Sticker.file_size:1 of msgid "*Optional*. File size in bytes" msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:4 +#: aiogram.types.sticker.Sticker.set_position_in_set:4 of +msgid ":code:`sticker`" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:6 of +msgid "" +"Use this method to move a sticker in a set created by the bot to a " +"specific position. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:8 of +msgid "Source: https://core.telegram.org/bots/api#setstickerpositioninset" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set of +msgid "Parameters" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:10 of +msgid "New sticker position in the set, zero-based" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set +#: aiogram.types.sticker.Sticker.set_position_in_set of +msgid "Returns" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet`" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:6 of +msgid "" +"Use this method to delete a sticker from a set created by the bot. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:8 of +msgid "Source: https://core.telegram.org/bots/api#deletestickerfromset" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/user.po b/docs/locale/en/LC_MESSAGES/api/types/user.po index d2ffb3dca6..b7e590b305 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/user.po +++ b/docs/locale/en/LC_MESSAGES/api/types/user.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -90,6 +90,53 @@ msgid "" "only in :class:`aiogram.methods.get_me.GetMe`." msgstr "" +#: aiogram.types.user.User.get_profile_photos:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:4 of +msgid ":code:`user_id`" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:6 of +msgid "" +"Use this method to get a list of profile pictures for a user. Returns a " +":class:`aiogram.types.user_profile_photos.UserProfilePhotos` object." +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:8 of +msgid "Source: https://core.telegram.org/bots/api#getuserprofilephotos" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos of +msgid "Parameters" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:10 of +msgid "" +"Sequential number of the first photo to be returned. By default, all " +"photos are returned." +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:11 of +msgid "" +"Limits the number of photos to be retrieved. Values between 1-100 are " +"accepted. Defaults to 100." +msgstr "" + +#: aiogram.types.user.User.get_profile_photos of +msgid "Returns" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos`" +msgstr "" + #~ msgid "This object represents a Telegram user or bot." #~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/changelog.po b/docs/locale/en/LC_MESSAGES/changelog.po index 4b0fb64390..7aa019906b 100644 --- a/docs/locale/en/LC_MESSAGES/changelog.po +++ b/docs/locale/en/LC_MESSAGES/changelog.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -21,29 +21,194 @@ msgstr "" msgid "Changelog" msgstr "" -#: ../../../CHANGES.rst:18 -msgid "3.0.0b5 (2022-10-02)" +#: ../../[towncrier-fragments]:2 +msgid "\\ |release| [UNRELEASED DRAFT] (2022-11-23)" msgstr "" -#: ../../../CHANGES.rst:21 ../../../CHANGES.rst:72 ../../../CHANGES.rst:145 -#: ../../../CHANGES.rst:186 ../../../CHANGES.rst:224 ../../../CHANGES.rst:272 -#: ../../../CHANGES.rst:348 ../../../CHANGES.rst:381 ../../../CHANGES.rst:412 +#: ../../../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" msgstr "" -#: ../../../CHANGES.rst:23 +#: ../../[towncrier-fragments]:7 +msgid "" +"Added missing shortcuts, new enums, reworked old stuff `#952 " +"`_" +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]:12 +msgid "Misc" +msgstr "" + +#: ../../[towncrier-fragments]:14 +msgid "" +"Added integration with new code-generator named `Butcher " +"`_ `#1069 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:20 +msgid "3.0.0b6 (2022-11-18)" +msgstr "" + +#: ../../../CHANGES.rst:25 +msgid "" +"(again) Added possibility to combine filters with an *and*/*or* " +"operations." +msgstr "" + +#: ../../../CHANGES.rst:27 +msgid "" +"Read more in \":ref:`Combining filters `\" " +"documentation section `#1018 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:29 +msgid "Added following methods to ``Message`` class:" +msgstr "" + +#: ../../../CHANGES.rst:31 +msgid ":code:`Message.forward(...)`" +msgstr "" + +#: ../../../CHANGES.rst:32 +msgid ":code:`Message.edit_media(...)`" +msgstr "" + +#: ../../../CHANGES.rst:33 +msgid ":code:`Message.edit_live_location(...)`" +msgstr "" + +#: ../../../CHANGES.rst:34 +msgid ":code:`Message.stop_live_location(...)`" +msgstr "" + +#: ../../../CHANGES.rst:35 +msgid ":code:`Message.pin(...)`" +msgstr "" + +#: ../../../CHANGES.rst:36 +msgid ":code:`Message.unpin()`" +msgstr "" + +#: ../../../CHANGES.rst:37 +msgid "`#1030 `_" +msgstr "" + +#: ../../../CHANGES.rst:38 +msgid "Added following methods to :code:`User` class:" +msgstr "" + +#: ../../../CHANGES.rst:40 +msgid ":code:`User.mention_markdown(...)`" +msgstr "" + +#: ../../../CHANGES.rst:41 +msgid ":code:`User.mention_html(...)`" +msgstr "" + +#: ../../../CHANGES.rst:42 +msgid "`#1049 `_" +msgstr "" + +#: ../../../CHANGES.rst:43 +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 +msgid "" +"Fixed :code:`Message.send_invoice` and :code:`Message.reply_invoice`, " +"added missing arguments `#1047 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:52 +msgid "Fixed copy and forward in:" +msgstr "" + +#: ../../../CHANGES.rst:54 +msgid ":code:`Message.answer(...)`" +msgstr "" + +#: ../../../CHANGES.rst:55 +msgid ":code:`Message.copy_to(...)`" +msgstr "" + +#: ../../../CHANGES.rst:56 +msgid "`#1064 `_" +msgstr "" + +#: ../../../CHANGES.rst:60 ../../../CHANGES.rst:110 ../../../CHANGES.rst:490 +msgid "Improved Documentation" +msgstr "" + +#: ../../../CHANGES.rst:62 +msgid "" +"Fixed UA translations in index.po `#1017 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:64 +msgid "" +"Fix typehints for :code:`Message`, :code:`reply_media_group` and " +":code:`answer_media_group` methods `#1029 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:66 +msgid "" +"Removed an old now non-working feature `#1060 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:73 +msgid "" +"Enabled testing on Python 3.11 `#1044 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:75 +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" +" fails with reason :code:`[SSL: CERTIFICATE_VERIFY_FAILED] certificate " +"verify failed: self signed certificate in certificate chain` `#1066 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:80 +msgid "3.0.0b5 (2022-10-02)" +msgstr "" + +#: ../../../CHANGES.rst:85 msgid "" "Add PyPy support and run tests under PyPy `#985 " "`_" msgstr "" -#: ../../../CHANGES.rst:25 +#: ../../../CHANGES.rst:87 msgid "" "Added message text to aiogram exceptions representation `#988 " "`_" msgstr "" -#: ../../../CHANGES.rst:27 +#: ../../../CHANGES.rst:89 msgid "" "Added warning about using magic filter from `magic_filter` instead of " "`aiogram`'s ones. Is recommended to use `from aiogram import F` instead " @@ -51,82 +216,65 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:30 +#: ../../../CHANGES.rst:92 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:35 ../../../CHANGES.rst:96 ../../../CHANGES.rst:154 -#: ../../../CHANGES.rst:200 ../../../CHANGES.rst:248 ../../../CHANGES.rst:304 -#: ../../../CHANGES.rst:389 ../../../CHANGES.rst:421 -msgid "Bugfixes" -msgstr "" - -#: ../../../CHANGES.rst:37 +#: ../../../CHANGES.rst:99 msgid "" "Reworked error event, introduced " ":class:`aiogram.types.error_event.ErrorEvent` object. `#898 " "`_" msgstr "" -#: ../../../CHANGES.rst:39 +#: ../../../CHANGES.rst:101 msgid "" "Fixed escaping markdown in `aiogram.utils.markdown` module `#903 " "`_" msgstr "" -#: ../../../CHANGES.rst:41 +#: ../../../CHANGES.rst:103 msgid "" "Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. " "`#995 `_" msgstr "" -#: ../../../CHANGES.rst:43 +#: ../../../CHANGES.rst:105 msgid "" "Fixed empty mention in command parsing, now it will be None instead of an" " empty string `#1013 `_" msgstr "" -#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:428 -msgid "Improved Documentation" -msgstr "" - -#: ../../../CHANGES.rst:50 +#: ../../../CHANGES.rst:112 msgid "" "Initialized Docs translation (added Ukrainian language) `#925 " "`_" msgstr "" -#: ../../../CHANGES.rst:55 +#: ../../../CHANGES.rst:117 msgid "Deprecations and Removals" msgstr "" -#: ../../../CHANGES.rst:57 +#: ../../../CHANGES.rst:119 msgid "" "Removed filters factory as described in corresponding issue. `#942 " "`_" msgstr "" -#: ../../../CHANGES.rst:62 ../../../CHANGES.rst:113 ../../../CHANGES.rst:167 -#: ../../../CHANGES.rst:209 ../../../CHANGES.rst:255 ../../../CHANGES.rst:315 -#: ../../../CHANGES.rst:336 ../../../CHANGES.rst:359 ../../../CHANGES.rst:396 -#: ../../../CHANGES.rst:435 -msgid "Misc" -msgstr "" - -#: ../../../CHANGES.rst:64 +#: ../../../CHANGES.rst:126 msgid "" "Now Router/Dispatcher accepts only keyword arguments. `#982 " "`_" msgstr "" -#: ../../../CHANGES.rst:69 +#: ../../../CHANGES.rst:131 msgid "3.0.0b4 (2022-08-14)" msgstr "" -#: ../../../CHANGES.rst:74 +#: ../../../CHANGES.rst:136 msgid "" "Add class helper ChatAction for constants that Telegram BotAPI uses in " "sendChatAction request. In my opinion, this will help users and will also" @@ -134,198 +282,198 @@ msgid "" "\"ChatActions\". `#803 `_" msgstr "" -#: ../../../CHANGES.rst:78 +#: ../../../CHANGES.rst:140 msgid "Added possibility to combine filters or invert result" msgstr "" -#: ../../../CHANGES.rst:80 +#: ../../../CHANGES.rst:142 msgid "Example:" msgstr "" -#: ../../../CHANGES.rst:88 +#: ../../../CHANGES.rst:150 msgid "`#894 `_" msgstr "" -#: ../../../CHANGES.rst:89 +#: ../../../CHANGES.rst:151 msgid "" "Fixed type hints for redis TTL params. `#922 " "`_" msgstr "" -#: ../../../CHANGES.rst:91 +#: ../../../CHANGES.rst:153 msgid "" "Added `full_name` shortcut for `Chat` object `#929 " "`_" msgstr "" -#: ../../../CHANGES.rst:98 +#: ../../../CHANGES.rst:160 msgid "" "Fixed false-positive coercing of Union types in API methods `#901 " "`_" msgstr "" -#: ../../../CHANGES.rst:100 +#: ../../../CHANGES.rst:162 msgid "Added 3 missing content types:" msgstr "" -#: ../../../CHANGES.rst:102 +#: ../../../CHANGES.rst:164 msgid "proximity_alert_triggered" msgstr "" -#: ../../../CHANGES.rst:103 +#: ../../../CHANGES.rst:165 msgid "supergroup_chat_created" msgstr "" -#: ../../../CHANGES.rst:104 +#: ../../../CHANGES.rst:166 msgid "channel_chat_created" msgstr "" -#: ../../../CHANGES.rst:105 +#: ../../../CHANGES.rst:167 msgid "`#906 `_" msgstr "" -#: ../../../CHANGES.rst:106 +#: ../../../CHANGES.rst:168 msgid "" "Fixed the ability to compare the state, now comparison to copy of the " "state will return `True`. `#927 " "`_" msgstr "" -#: ../../../CHANGES.rst:108 +#: ../../../CHANGES.rst:170 msgid "" "Fixed default lock kwargs in RedisEventIsolation. `#972 " "`_" msgstr "" -#: ../../../CHANGES.rst:115 +#: ../../../CHANGES.rst:177 msgid "" "Restrict including routers with strings `#896 " "`_" msgstr "" -#: ../../../CHANGES.rst:117 +#: ../../../CHANGES.rst:179 msgid "" "Changed CommandPatterType to CommandPatternType in " "`aiogram/dispatcher/filters/command.py` `#907 " "`_" msgstr "" -#: ../../../CHANGES.rst:119 +#: ../../../CHANGES.rst:181 msgid "" "Added full support of `Bot API 6.1 `_ `#936 " "`_" msgstr "" -#: ../../../CHANGES.rst:121 +#: ../../../CHANGES.rst:183 msgid "**Breaking!** More flat project structure" msgstr "" -#: ../../../CHANGES.rst:123 +#: ../../../CHANGES.rst:185 msgid "These packages was moved, imports in your code should be fixed:" msgstr "" -#: ../../../CHANGES.rst:125 +#: ../../../CHANGES.rst:187 msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`" msgstr "" -#: ../../../CHANGES.rst:126 +#: ../../../CHANGES.rst:188 msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`" msgstr "" -#: ../../../CHANGES.rst:127 +#: ../../../CHANGES.rst:189 msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`" msgstr "" -#: ../../../CHANGES.rst:128 +#: ../../../CHANGES.rst:190 msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`" msgstr "" -#: ../../../CHANGES.rst:129 +#: ../../../CHANGES.rst:191 msgid "" ":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` " "(single module instead of package)" msgstr "" -#: ../../../CHANGES.rst:130 +#: ../../../CHANGES.rst:192 msgid "`#938 `_" msgstr "" -#: ../../../CHANGES.rst:131 +#: ../../../CHANGES.rst:193 msgid "" "Removed deprecated :code:`router._handler` and " ":code:`router.register__handler` methods. `#941 " "`_" msgstr "" -#: ../../../CHANGES.rst:133 +#: ../../../CHANGES.rst:195 msgid "" "Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942" " `_" msgstr "" -#: ../../../CHANGES.rst:135 +#: ../../../CHANGES.rst:197 msgid "" "`MessageEntity` method `get_text` was removed and `extract` was renamed " "to `extract_from` `#944 `_" msgstr "" -#: ../../../CHANGES.rst:137 +#: ../../../CHANGES.rst:199 msgid "" "Added full support of `Bot API 6.2 `_ `#975 " "`_" msgstr "" -#: ../../../CHANGES.rst:142 +#: ../../../CHANGES.rst:204 msgid "3.0.0b3 (2022-04-19)" msgstr "" -#: ../../../CHANGES.rst:147 +#: ../../../CHANGES.rst:209 msgid "" "Added possibility to get command magic result as handler argument `#889 " "`_" msgstr "" -#: ../../../CHANGES.rst:149 +#: ../../../CHANGES.rst:211 msgid "" "Added full support of `Telegram Bot API 6.0 " "`_ `#890 " "`_" msgstr "" -#: ../../../CHANGES.rst:156 +#: ../../../CHANGES.rst:218 msgid "" "Fixed I18n lazy-proxy. Disabled caching. `#839 " "`_" msgstr "" -#: ../../../CHANGES.rst:158 +#: ../../../CHANGES.rst:220 msgid "" "Added parsing of spoiler message entity `#865 " "`_" msgstr "" -#: ../../../CHANGES.rst:160 +#: ../../../CHANGES.rst:222 msgid "" "Fixed default `parse_mode` for `Message.copy_to()` method. `#876 " "`_" msgstr "" -#: ../../../CHANGES.rst:162 +#: ../../../CHANGES.rst:224 msgid "" "Fixed CallbackData factory parsing IntEnum's `#885 " "`_" msgstr "" -#: ../../../CHANGES.rst:169 +#: ../../../CHANGES.rst:231 msgid "" "Added automated check that pull-request adds a changes description to " "**CHANGES** directory `#873 " "`_" msgstr "" -#: ../../../CHANGES.rst:171 +#: ../../../CHANGES.rst:233 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" @@ -333,14 +481,14 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:174 +#: ../../../CHANGES.rst:236 msgid "" "Used `redis-py` instead of `aioredis` package in due to this packages was" " merged into single one `#882 " "`_" msgstr "" -#: ../../../CHANGES.rst:176 +#: ../../../CHANGES.rst:238 msgid "" "Solved common naming problem with middlewares that confusing too much " "developers - now you can't see the `middleware` and `middlewares` " @@ -349,113 +497,113 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:183 +#: ../../../CHANGES.rst:245 msgid "3.0.0b2 (2022-02-19)" msgstr "" -#: ../../../CHANGES.rst:188 +#: ../../../CHANGES.rst:250 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:191 +#: ../../../CHANGES.rst:253 msgid "" "Added possibility to add handler flags via decorator (like `pytest.mark` " "decorator but `aiogram.flags`) `#836 " "`_" msgstr "" -#: ../../../CHANGES.rst:193 +#: ../../../CHANGES.rst:255 msgid "" "Added :code:`ChatActionSender` utility to automatically sends chat action" " while long process is running." msgstr "" -#: ../../../CHANGES.rst:195 +#: ../../../CHANGES.rst:257 msgid "" "It also can be used as message middleware and can be customized via " ":code:`chat_action` flag. `#837 " "`_" msgstr "" -#: ../../../CHANGES.rst:202 +#: ../../../CHANGES.rst:264 msgid "" "Fixed unexpected behavior of sequences in the StateFilter. `#791 " "`_" msgstr "" -#: ../../../CHANGES.rst:204 +#: ../../../CHANGES.rst:266 msgid "" "Fixed exceptions filters `#827 " "`_" msgstr "" -#: ../../../CHANGES.rst:211 +#: ../../../CHANGES.rst:273 msgid "" "Logger name for processing events is changed to :code:`aiogram.events`. " "`#830 `_" msgstr "" -#: ../../../CHANGES.rst:213 +#: ../../../CHANGES.rst:275 msgid "" "Added full support of Telegram Bot API 5.6 and 5.7 `#835 " "`_" msgstr "" -#: ../../../CHANGES.rst:215 +#: ../../../CHANGES.rst:277 msgid "" "**BREAKING** Events isolation mechanism is moved from FSM storages to " "standalone managers `#838 " "`_" msgstr "" -#: ../../../CHANGES.rst:221 +#: ../../../CHANGES.rst:283 msgid "3.0.0b1 (2021-12-12)" msgstr "" -#: ../../../CHANGES.rst:226 +#: ../../../CHANGES.rst:288 msgid "Added new custom operation for MagicFilter named :code:`as_`" msgstr "" -#: ../../../CHANGES.rst:228 +#: ../../../CHANGES.rst:290 msgid "Now you can use it to get magic filter result as handler argument" msgstr "" -#: ../../../CHANGES.rst:244 +#: ../../../CHANGES.rst:306 msgid "`#759 `_" msgstr "" -#: ../../../CHANGES.rst:250 +#: ../../../CHANGES.rst:312 msgid "" "Fixed: Missing :code:`ChatMemberHandler` import in " ":code:`aiogram/dispatcher/handler` `#751 " "`_" msgstr "" -#: ../../../CHANGES.rst:257 +#: ../../../CHANGES.rst:319 msgid "" "Check :code:`destiny` in case of no :code:`with_destiny` enabled in " "RedisStorage key builder `#776 " "`_" msgstr "" -#: ../../../CHANGES.rst:259 +#: ../../../CHANGES.rst:321 msgid "" "Added full support of `Bot API 5.5 `_ `#777 " "`_" msgstr "" -#: ../../../CHANGES.rst:261 +#: ../../../CHANGES.rst:323 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:263 +#: ../../../CHANGES.rst:325 msgid "" "Make TelegramAPIServer files wrapper in local mode bi-directional " "(server-client, client-server) Now you can convert local path to server " @@ -463,11 +611,11 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:269 +#: ../../../CHANGES.rst:331 msgid "3.0.0a18 (2021-11-10)" msgstr "" -#: ../../../CHANGES.rst:274 +#: ../../../CHANGES.rst:336 msgid "" "Breaking: Changed the signature of the session middlewares Breaking: " "Renamed AiohttpSession.make_request method parameter from call to method " @@ -475,258 +623,258 @@ msgid "" "outgoing requests `#716 `_" msgstr "" -#: ../../../CHANGES.rst:278 +#: ../../../CHANGES.rst:340 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:288 +#: ../../../CHANGES.rst:350 msgid "`#717 `_" msgstr "" -#: ../../../CHANGES.rst:289 +#: ../../../CHANGES.rst:351 msgid "" "**Breaking internal API change** Reworked FSM Storage record keys " "propagation `#723 `_" msgstr "" -#: ../../../CHANGES.rst:292 +#: ../../../CHANGES.rst:354 msgid "" "Implemented new filter named :code:`MagicData(magic_data)` that helps to " "filter event by data from middlewares or other filters" msgstr "" -#: ../../../CHANGES.rst:294 +#: ../../../CHANGES.rst:356 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:300 +#: ../../../CHANGES.rst:362 msgid "`#724 `_" msgstr "" -#: ../../../CHANGES.rst:306 +#: ../../../CHANGES.rst:368 msgid "" "Fixed I18n context inside error handlers `#726 " "`_" msgstr "" -#: ../../../CHANGES.rst:308 +#: ../../../CHANGES.rst:370 msgid "" "Fixed bot session closing before emit shutdown `#734 " "`_" msgstr "" -#: ../../../CHANGES.rst:310 +#: ../../../CHANGES.rst:372 msgid "" "Fixed: bound filter resolving does not require children routers `#736 " "`_" msgstr "" -#: ../../../CHANGES.rst:317 +#: ../../../CHANGES.rst:379 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:320 +#: ../../../CHANGES.rst:382 msgid "" "Converted README.md to README.rst and use it as base file for docs `#725 " "`_" msgstr "" -#: ../../../CHANGES.rst:322 +#: ../../../CHANGES.rst:384 msgid "Rework filters resolving:" msgstr "" -#: ../../../CHANGES.rst:324 +#: ../../../CHANGES.rst:386 msgid "Automatically apply Bound Filters with default values to handlers" msgstr "" -#: ../../../CHANGES.rst:325 +#: ../../../CHANGES.rst:387 msgid "Fix data transfer from parent to included routers filters" msgstr "" -#: ../../../CHANGES.rst:326 +#: ../../../CHANGES.rst:388 msgid "`#727 `_" msgstr "" -#: ../../../CHANGES.rst:327 +#: ../../../CHANGES.rst:389 msgid "" "Added full support of Bot API 5.4 https://core.telegram.org/bots/api-" "changelog#november-5-2021 `#744 " "`_" msgstr "" -#: ../../../CHANGES.rst:333 +#: ../../../CHANGES.rst:395 msgid "3.0.0a17 (2021-09-24)" msgstr "" -#: ../../../CHANGES.rst:338 +#: ../../../CHANGES.rst:400 msgid "" "Added :code:`html_text` and :code:`md_text` to Message object `#708 " "`_" msgstr "" -#: ../../../CHANGES.rst:340 +#: ../../../CHANGES.rst:402 msgid "" "Refactored I18n, added context managers for I18n engine and current " "locale `#709 `_" msgstr "" -#: ../../../CHANGES.rst:345 +#: ../../../CHANGES.rst:407 msgid "3.0.0a16 (2021-09-22)" msgstr "" -#: ../../../CHANGES.rst:350 +#: ../../../CHANGES.rst:412 msgid "Added support of local Bot API server files downloading" msgstr "" -#: ../../../CHANGES.rst:352 +#: ../../../CHANGES.rst:414 msgid "" "When Local API is enabled files can be downloaded via " "`bot.download`/`bot.download_file` methods. `#698 " "`_" msgstr "" -#: ../../../CHANGES.rst:354 +#: ../../../CHANGES.rst:416 msgid "" "Implemented I18n & L10n support `#701 " "`_" msgstr "" -#: ../../../CHANGES.rst:361 +#: ../../../CHANGES.rst:423 msgid "" "Covered by tests and docs KeyboardBuilder util `#699 " "`_" msgstr "" -#: ../../../CHANGES.rst:363 +#: ../../../CHANGES.rst:425 msgid "**Breaking!!!**. Refactored and renamed exceptions." msgstr "" -#: ../../../CHANGES.rst:365 +#: ../../../CHANGES.rst:427 msgid "" "Exceptions module was moved from :code:`aiogram.utils.exceptions` to " ":code:`aiogram.exceptions`" msgstr "" -#: ../../../CHANGES.rst:366 +#: ../../../CHANGES.rst:428 msgid "Added prefix `Telegram` for all error classes" msgstr "" -#: ../../../CHANGES.rst:367 +#: ../../../CHANGES.rst:429 msgid "`#700 `_" msgstr "" -#: ../../../CHANGES.rst:368 +#: ../../../CHANGES.rst:430 msgid "" "Replaced all :code:`pragma: no cover` marks via global " ":code:`.coveragerc` config `#702 " "`_" msgstr "" -#: ../../../CHANGES.rst:370 +#: ../../../CHANGES.rst:432 msgid "Updated dependencies." msgstr "" -#: ../../../CHANGES.rst:372 +#: ../../../CHANGES.rst:434 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:378 +#: ../../../CHANGES.rst:440 msgid "3.0.0a15 (2021-09-10)" msgstr "" -#: ../../../CHANGES.rst:383 +#: ../../../CHANGES.rst:445 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:391 +#: ../../../CHANGES.rst:453 msgid "" "Fixed incorrect type checking in the " ":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 " "`_" msgstr "" -#: ../../../CHANGES.rst:398 +#: ../../../CHANGES.rst:460 msgid "" "Disable ContentType filter by default `#668 " "`_" msgstr "" -#: ../../../CHANGES.rst:400 +#: ../../../CHANGES.rst:462 msgid "" "Moved update type detection from Dispatcher to Update object `#669 " "`_" msgstr "" -#: ../../../CHANGES.rst:402 +#: ../../../CHANGES.rst:464 msgid "" "Updated **pre-commit** config `#681 " "`_" msgstr "" -#: ../../../CHANGES.rst:404 +#: ../../../CHANGES.rst:466 msgid "" "Reworked **handlers_in_use** util. Function moved to Router as method " "**.resolve_used_update_types()** `#682 " "`_" msgstr "" -#: ../../../CHANGES.rst:409 +#: ../../../CHANGES.rst:471 msgid "3.0.0a14 (2021-08-17)" msgstr "" -#: ../../../CHANGES.rst:414 +#: ../../../CHANGES.rst:476 msgid "" "add aliases for edit/delete reply markup to Message `#662 " "`_" msgstr "" -#: ../../../CHANGES.rst:416 +#: ../../../CHANGES.rst:478 msgid "" "Reworked outer middleware chain. Prevent to call many times the outer " "middleware for each nested router `#664 " "`_" msgstr "" -#: ../../../CHANGES.rst:423 +#: ../../../CHANGES.rst:485 msgid "" "Prepare parse mode for InputMessageContent in AnswerInlineQuery method " "`#660 `_" msgstr "" -#: ../../../CHANGES.rst:430 +#: ../../../CHANGES.rst:492 msgid "" "Added integration with :code:`towncrier` `#602 " "`_" msgstr "" -#: ../../../CHANGES.rst:437 +#: ../../../CHANGES.rst:499 msgid "" "Added `.editorconfig` `#650 " "`_" msgstr "" -#: ../../../CHANGES.rst:439 +#: ../../../CHANGES.rst:501 msgid "" "Redis storage speedup globals `#651 " "`_" msgstr "" -#: ../../../CHANGES.rst:441 +#: ../../../CHANGES.rst:503 msgid "" "add allow_sending_without_reply param to Message reply aliases `#663 " "`_" @@ -2244,3 +2392,16 @@ msgstr "" #: ../../../HISTORY.rst:497 msgid "0.1 (2017-06-03)" msgstr "" + +#~ msgid "" +#~ "Added is_chat_creator method to " +#~ "ChatMemberStatus.yml (`#394 " +#~ "`_)" +#~ msgstr "" + +#~ msgid "" +#~ ":code:`is_member` and :code:`is_admin` methods " +#~ "of :code:`ChatMember` and " +#~ ":code:`ChatMemberStatus.yml` was renamed to " +#~ ":code:`is_chat_member` and :code:`is_chat_admin`" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/dispatcher/router.po b/docs/locale/en/LC_MESSAGES/dispatcher/router.po index 71534b0fd3..1d194ac3d0 100644 --- a/docs/locale/en/LC_MESSAGES/dispatcher/router.po +++ b/docs/locale/en/LC_MESSAGES/dispatcher/router.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -58,12 +58,6 @@ msgstr "" msgid "Attach another router." msgstr "" -#: aiogram.dispatcher.router.Router.include_router:3 of -msgid "" -"Can be attached directly or by import string in format " -"\":\"" -msgstr "" - #: aiogram.dispatcher.router.Router.include_router of msgid "Returns" msgstr "" @@ -220,3 +214,9 @@ msgstr "" #: ../../dispatcher/router.rst:190 msgid "In this case update propagation flow will have form:" msgstr "" + +#~ msgid "" +#~ "Can be attached directly or by " +#~ "import string in format " +#~ "\":\"" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/bot.po b/docs/locale/uk_UA/LC_MESSAGES/api/bot.po index 28acf6605c..8c5c3fc920 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/bot.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/bot.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -86,7 +86,6 @@ msgstr "" #: aiogram.client.bot.Bot.get_chat_administrators #: aiogram.client.bot.Bot.get_chat_member #: aiogram.client.bot.Bot.get_chat_member_count -#: aiogram.client.bot.Bot.get_chat_members_count #: aiogram.client.bot.Bot.get_chat_menu_button #: aiogram.client.bot.Bot.get_custom_emoji_stickers #: aiogram.client.bot.Bot.get_file @@ -96,8 +95,7 @@ msgstr "" #: aiogram.client.bot.Bot.get_my_default_administrator_rights #: aiogram.client.bot.Bot.get_sticker_set aiogram.client.bot.Bot.get_updates #: aiogram.client.bot.Bot.get_user_profile_photos -#: aiogram.client.bot.Bot.get_webhook_info -#: aiogram.client.bot.Bot.kick_chat_member aiogram.client.bot.Bot.leave_chat +#: aiogram.client.bot.Bot.get_webhook_info aiogram.client.bot.Bot.leave_chat #: aiogram.client.bot.Bot.log_out aiogram.client.bot.Bot.pin_chat_message #: aiogram.client.bot.Bot.promote_chat_member #: aiogram.client.bot.Bot.reopen_forum_topic @@ -198,7 +196,6 @@ msgstr "" #: aiogram.client.bot.Bot.get_chat_administrators #: aiogram.client.bot.Bot.get_chat_member #: aiogram.client.bot.Bot.get_chat_member_count -#: aiogram.client.bot.Bot.get_chat_members_count #: aiogram.client.bot.Bot.get_chat_menu_button #: aiogram.client.bot.Bot.get_custom_emoji_stickers #: aiogram.client.bot.Bot.get_file @@ -209,8 +206,8 @@ msgstr "" #: aiogram.client.bot.Bot.get_sticker_set aiogram.client.bot.Bot.get_updates #: aiogram.client.bot.Bot.get_user_profile_photos #: aiogram.client.bot.Bot.get_webhook_info aiogram.client.bot.Bot.id -#: aiogram.client.bot.Bot.kick_chat_member aiogram.client.bot.Bot.leave_chat -#: aiogram.client.bot.Bot.log_out aiogram.client.bot.Bot.pin_chat_message +#: aiogram.client.bot.Bot.leave_chat aiogram.client.bot.Bot.log_out +#: aiogram.client.bot.Bot.pin_chat_message #: aiogram.client.bot.Bot.promote_chat_member #: aiogram.client.bot.Bot.reopen_forum_topic #: aiogram.client.bot.Bot.restrict_chat_member @@ -296,562 +293,546 @@ msgstr "" msgid "file_id or Downloadable object" msgstr "" -#: aiogram.client.bot.Bot.get_updates:1 of +#: aiogram.client.bot.Bot.add_sticker_to_set:1 of msgid "" -"Use this method to receive incoming updates using long polling (`wiki " -"`_). Returns " -"an Array of :class:`aiogram.types.update.Update` objects." -msgstr "" - -#: aiogram.client.bot.Bot.get_updates:3 aiogram.client.bot.Bot.set_webhook:4 of -msgid "**Notes**" +"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 "" -#: aiogram.client.bot.Bot.get_updates:5 of -msgid "**1.** This method will not work if an outgoing webhook is set up." +#: aiogram.client.bot.Bot.add_sticker_to_set:3 of +msgid "User identifier of sticker set owner" msgstr "" -#: aiogram.client.bot.Bot.get_updates:7 of -msgid "" -"**2.** In order to avoid getting duplicate updates, recalculate *offset* " -"after each server response." +#: aiogram.client.bot.Bot.add_sticker_to_set:4 +#: aiogram.client.bot.Bot.set_sticker_set_thumb:3 of +msgid "Sticker set name" msgstr "" -#: aiogram.client.bot.Bot.get_updates:9 of -msgid "Source: https://core.telegram.org/bots/api#getupdates" +#: aiogram.client.bot.Bot.add_sticker_to_set:5 +#: aiogram.client.bot.Bot.create_new_sticker_set:6 of +msgid "One or more emoji corresponding to the sticker" msgstr "" -#: aiogram.client.bot.Bot.get_updates:11 of +#: aiogram.client.bot.Bot.add_sticker_to_set:6 +#: aiogram.client.bot.Bot.create_new_sticker_set:7 of msgid "" -"Identifier of the first update to be returned. Must be greater by one " -"than the highest among the identifiers of previously received updates. By" -" default, updates starting with the earliest unconfirmed update are " -"returned. An update is considered confirmed as soon as " -":class:`aiogram.methods.get_updates.GetUpdates` is called with an " -"*offset* higher than its *update_id*. The negative offset can be " -"specified to retrieve updates starting from *-offset* update from the end" -" of the updates queue. All previous updates will forgotten." +"**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 "" -#: aiogram.client.bot.Bot.get_updates:12 of +#: aiogram.client.bot.Bot.add_sticker_to_set:7 +#: aiogram.client.bot.Bot.create_new_sticker_set:8 of msgid "" -"Limits the number of updates to be retrieved. Values between 1-100 are " -"accepted. Defaults to 100." +"**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 "" -#: aiogram.client.bot.Bot.get_updates:13 of +#: aiogram.client.bot.Bot.add_sticker_to_set:8 +#: aiogram.client.bot.Bot.create_new_sticker_set:9 of msgid "" -"Timeout in seconds for long polling. Defaults to 0, i.e. usual short " -"polling. Should be positive, short polling should be used for testing " -"purposes only." +"**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 "" -#: aiogram.client.bot.Bot.get_updates:14 aiogram.client.bot.Bot.set_webhook:19 -#: of +#: aiogram.client.bot.Bot.add_sticker_to_set:9 +#: aiogram.client.bot.Bot.create_new_sticker_set:11 of msgid "" -"A JSON-serialized list of the update types you want your bot to receive. " -"For example, specify ['message', 'edited_channel_post', 'callback_query']" -" to only receive updates of these types. See " -":class:`aiogram.types.update.Update` for a complete list of available " -"update types. Specify an empty list to receive all update types except " -"*chat_member* (default). If not specified, the previous setting will be " -"used." +"A JSON-serialized object for position where the mask should be placed on " +"faces" msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:12 -#: aiogram.client.bot.Bot.answer_callback_query:12 -#: aiogram.client.bot.Bot.answer_inline_query:14 -#: aiogram.client.bot.Bot.answer_pre_checkout_query:8 -#: aiogram.client.bot.Bot.answer_shipping_query:9 -#: aiogram.client.bot.Bot.answer_web_app_query:7 -#: aiogram.client.bot.Bot.approve_chat_join_request:7 -#: aiogram.client.bot.Bot.ban_chat_member:9 -#: aiogram.client.bot.Bot.ban_chat_sender_chat:7 aiogram.client.bot.Bot.close:5 -#: aiogram.client.bot.Bot.close_forum_topic:7 -#: aiogram.client.bot.Bot.copy_message:17 -#: aiogram.client.bot.Bot.create_chat_invite_link:10 -#: aiogram.client.bot.Bot.create_forum_topic:9 -#: aiogram.client.bot.Bot.create_invoice_link:25 -#: aiogram.client.bot.Bot.create_new_sticker_set:14 -#: aiogram.client.bot.Bot.decline_chat_join_request:7 -#: aiogram.client.bot.Bot.delete_chat_photo:6 -#: aiogram.client.bot.Bot.delete_chat_sticker_set:6 -#: aiogram.client.bot.Bot.delete_forum_topic:7 -#: aiogram.client.bot.Bot.delete_message:25 -#: aiogram.client.bot.Bot.delete_my_commands:7 -#: aiogram.client.bot.Bot.delete_sticker_from_set:6 -#: aiogram.client.bot.Bot.delete_webhook:6 -#: aiogram.client.bot.Bot.edit_chat_invite_link:11 -#: aiogram.client.bot.Bot.edit_forum_topic:9 -#: aiogram.client.bot.Bot.edit_message_caption:12 -#: aiogram.client.bot.Bot.edit_message_live_location:14 -#: aiogram.client.bot.Bot.edit_message_media:10 -#: aiogram.client.bot.Bot.edit_message_reply_markup:9 -#: aiogram.client.bot.Bot.edit_message_text:13 -#: aiogram.client.bot.Bot.export_chat_invite_link:8 -#: aiogram.client.bot.Bot.forward_message:11 aiogram.client.bot.Bot.get_chat:6 -#: aiogram.client.bot.Bot.get_chat_administrators:6 -#: aiogram.client.bot.Bot.get_chat_member:7 -#: aiogram.client.bot.Bot.get_chat_member_count:6 -#: aiogram.client.bot.Bot.get_chat_members_count:10 -#: aiogram.client.bot.Bot.get_chat_menu_button:6 -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:6 -#: aiogram.client.bot.Bot.get_file:7 -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:5 -#: aiogram.client.bot.Bot.get_game_high_scores:11 -#: aiogram.client.bot.Bot.get_me:5 aiogram.client.bot.Bot.get_my_commands:7 -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:6 -#: aiogram.client.bot.Bot.get_sticker_set:6 -#: aiogram.client.bot.Bot.get_updates:15 -#: aiogram.client.bot.Bot.get_user_profile_photos:8 -#: aiogram.client.bot.Bot.get_webhook_info:5 -#: aiogram.client.bot.Bot.kick_chat_member:13 -#: aiogram.client.bot.Bot.leave_chat:6 aiogram.client.bot.Bot.log_out:5 -#: aiogram.client.bot.Bot.pin_chat_message:8 -#: aiogram.client.bot.Bot.promote_chat_member:19 -#: aiogram.client.bot.Bot.reopen_forum_topic:7 -#: aiogram.client.bot.Bot.restrict_chat_member:9 -#: aiogram.client.bot.Bot.revoke_chat_invite_link:7 -#: aiogram.client.bot.Bot.send_animation:20 -#: aiogram.client.bot.Bot.send_audio:21 -#: aiogram.client.bot.Bot.send_chat_action:11 -#: aiogram.client.bot.Bot.send_contact:16 aiogram.client.bot.Bot.send_dice:13 -#: aiogram.client.bot.Bot.send_document:18 aiogram.client.bot.Bot.send_game:13 -#: aiogram.client.bot.Bot.send_invoice:33 -#: aiogram.client.bot.Bot.send_location:18 -#: aiogram.client.bot.Bot.send_media_group:12 -#: aiogram.client.bot.Bot.send_message:16 aiogram.client.bot.Bot.send_photo:16 -#: aiogram.client.bot.Bot.send_poll:24 aiogram.client.bot.Bot.send_sticker:13 -#: aiogram.client.bot.Bot.send_venue:20 aiogram.client.bot.Bot.send_video:21 -#: aiogram.client.bot.Bot.send_video_note:16 -#: aiogram.client.bot.Bot.send_voice:17 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:8 -#: aiogram.client.bot.Bot.set_chat_description:7 -#: aiogram.client.bot.Bot.set_chat_menu_button:7 -#: aiogram.client.bot.Bot.set_chat_permissions:7 -#: aiogram.client.bot.Bot.set_chat_photo:7 -#: aiogram.client.bot.Bot.set_chat_sticker_set:7 -#: aiogram.client.bot.Bot.set_chat_title:7 -#: aiogram.client.bot.Bot.set_game_score:12 -#: aiogram.client.bot.Bot.set_my_commands:8 -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:7 -#: aiogram.client.bot.Bot.set_passport_data_errors:8 -#: aiogram.client.bot.Bot.set_sticker_position_in_set:7 -#: aiogram.client.bot.Bot.set_sticker_set_thumb:8 -#: aiogram.client.bot.Bot.set_webhook:22 -#: aiogram.client.bot.Bot.stop_message_live_location:9 -#: aiogram.client.bot.Bot.stop_poll:8 -#: aiogram.client.bot.Bot.unban_chat_member:8 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:7 -#: aiogram.client.bot.Bot.unpin_all_chat_messages:6 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:7 -#: aiogram.client.bot.Bot.unpin_chat_message:7 -#: aiogram.client.bot.Bot.upload_sticker_file:7 of +#: aiogram.client.bot.Bot.add_sticker_to_set:10 +#: aiogram.client.bot.Bot.answer_callback_query:10 +#: aiogram.client.bot.Bot.answer_inline_query:12 +#: aiogram.client.bot.Bot.answer_pre_checkout_query:6 +#: aiogram.client.bot.Bot.answer_shipping_query:7 +#: aiogram.client.bot.Bot.answer_web_app_query:5 +#: aiogram.client.bot.Bot.approve_chat_join_request:5 +#: aiogram.client.bot.Bot.ban_chat_member:7 +#: aiogram.client.bot.Bot.ban_chat_sender_chat:5 aiogram.client.bot.Bot.close:3 +#: aiogram.client.bot.Bot.close_forum_topic:5 +#: aiogram.client.bot.Bot.copy_message:15 +#: aiogram.client.bot.Bot.create_chat_invite_link:8 +#: aiogram.client.bot.Bot.create_forum_topic:7 +#: aiogram.client.bot.Bot.create_invoice_link:23 +#: aiogram.client.bot.Bot.create_new_sticker_set:12 +#: aiogram.client.bot.Bot.decline_chat_join_request:5 +#: aiogram.client.bot.Bot.delete_chat_photo:4 +#: aiogram.client.bot.Bot.delete_chat_sticker_set:4 +#: aiogram.client.bot.Bot.delete_forum_topic:5 +#: aiogram.client.bot.Bot.delete_message:23 +#: aiogram.client.bot.Bot.delete_my_commands:5 +#: aiogram.client.bot.Bot.delete_sticker_from_set:4 +#: aiogram.client.bot.Bot.delete_webhook:4 +#: aiogram.client.bot.Bot.edit_chat_invite_link:9 +#: aiogram.client.bot.Bot.edit_forum_topic:7 +#: aiogram.client.bot.Bot.edit_message_caption:10 +#: aiogram.client.bot.Bot.edit_message_live_location:12 +#: aiogram.client.bot.Bot.edit_message_media:8 +#: aiogram.client.bot.Bot.edit_message_reply_markup:7 +#: aiogram.client.bot.Bot.edit_message_text:11 +#: aiogram.client.bot.Bot.export_chat_invite_link:6 +#: aiogram.client.bot.Bot.forward_message:9 aiogram.client.bot.Bot.get_chat:4 +#: aiogram.client.bot.Bot.get_chat_administrators:4 +#: aiogram.client.bot.Bot.get_chat_member:5 +#: aiogram.client.bot.Bot.get_chat_member_count:4 +#: aiogram.client.bot.Bot.get_chat_menu_button:4 +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:4 +#: aiogram.client.bot.Bot.get_file:5 +#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:3 +#: aiogram.client.bot.Bot.get_game_high_scores:9 +#: aiogram.client.bot.Bot.get_me:3 aiogram.client.bot.Bot.get_my_commands:5 +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:4 +#: aiogram.client.bot.Bot.get_sticker_set:4 +#: aiogram.client.bot.Bot.get_updates:13 +#: aiogram.client.bot.Bot.get_user_profile_photos:6 +#: aiogram.client.bot.Bot.get_webhook_info:3 +#: aiogram.client.bot.Bot.leave_chat:4 aiogram.client.bot.Bot.log_out:3 +#: aiogram.client.bot.Bot.pin_chat_message:6 +#: aiogram.client.bot.Bot.promote_chat_member:17 +#: aiogram.client.bot.Bot.reopen_forum_topic:5 +#: aiogram.client.bot.Bot.restrict_chat_member:7 +#: aiogram.client.bot.Bot.revoke_chat_invite_link:5 +#: aiogram.client.bot.Bot.send_animation:18 +#: aiogram.client.bot.Bot.send_audio:19 +#: aiogram.client.bot.Bot.send_chat_action:9 +#: aiogram.client.bot.Bot.send_contact:14 aiogram.client.bot.Bot.send_dice:11 +#: aiogram.client.bot.Bot.send_document:16 aiogram.client.bot.Bot.send_game:11 +#: aiogram.client.bot.Bot.send_invoice:31 +#: aiogram.client.bot.Bot.send_location:16 +#: aiogram.client.bot.Bot.send_media_group:10 +#: aiogram.client.bot.Bot.send_message:14 aiogram.client.bot.Bot.send_photo:14 +#: aiogram.client.bot.Bot.send_poll:22 aiogram.client.bot.Bot.send_sticker:11 +#: aiogram.client.bot.Bot.send_venue:18 aiogram.client.bot.Bot.send_video:19 +#: aiogram.client.bot.Bot.send_video_note:14 +#: aiogram.client.bot.Bot.send_voice:15 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:6 +#: aiogram.client.bot.Bot.set_chat_description:5 +#: aiogram.client.bot.Bot.set_chat_menu_button:5 +#: aiogram.client.bot.Bot.set_chat_permissions:5 +#: aiogram.client.bot.Bot.set_chat_photo:5 +#: aiogram.client.bot.Bot.set_chat_sticker_set:5 +#: aiogram.client.bot.Bot.set_chat_title:5 +#: aiogram.client.bot.Bot.set_game_score:10 +#: aiogram.client.bot.Bot.set_my_commands:6 +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:5 +#: aiogram.client.bot.Bot.set_passport_data_errors:6 +#: aiogram.client.bot.Bot.set_sticker_position_in_set:5 +#: aiogram.client.bot.Bot.set_sticker_set_thumb:6 +#: aiogram.client.bot.Bot.set_webhook:20 +#: aiogram.client.bot.Bot.stop_message_live_location:7 +#: aiogram.client.bot.Bot.stop_poll:6 +#: aiogram.client.bot.Bot.unban_chat_member:6 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:5 +#: aiogram.client.bot.Bot.unpin_all_chat_messages:4 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:5 +#: aiogram.client.bot.Bot.unpin_chat_message:5 +#: aiogram.client.bot.Bot.upload_sticker_file:5 of msgid "Request timeout" msgstr "" -#: aiogram.client.bot.Bot.get_updates:16 of -msgid "Returns an Array of Update objects." +#: aiogram.client.bot.Bot.add_sticker_to_set:11 +#: aiogram.client.bot.Bot.approve_chat_join_request:6 +#: aiogram.client.bot.Bot.ban_chat_member:8 +#: aiogram.client.bot.Bot.ban_chat_sender_chat:6 +#: aiogram.client.bot.Bot.close_forum_topic:6 +#: aiogram.client.bot.Bot.create_new_sticker_set:13 +#: aiogram.client.bot.Bot.decline_chat_join_request:6 +#: aiogram.client.bot.Bot.delete_chat_photo:5 +#: aiogram.client.bot.Bot.delete_chat_sticker_set:5 +#: aiogram.client.bot.Bot.delete_forum_topic:6 +#: aiogram.client.bot.Bot.delete_message:19 +#: aiogram.client.bot.Bot.delete_my_commands:6 +#: aiogram.client.bot.Bot.delete_sticker_from_set:5 +#: aiogram.client.bot.Bot.delete_webhook:5 +#: aiogram.client.bot.Bot.edit_forum_topic:8 +#: aiogram.client.bot.Bot.leave_chat:5 +#: aiogram.client.bot.Bot.pin_chat_message:7 +#: aiogram.client.bot.Bot.promote_chat_member:18 +#: aiogram.client.bot.Bot.reopen_forum_topic:6 +#: aiogram.client.bot.Bot.restrict_chat_member:8 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:7 +#: aiogram.client.bot.Bot.set_chat_description:6 +#: aiogram.client.bot.Bot.set_chat_menu_button:6 +#: aiogram.client.bot.Bot.set_chat_permissions:6 +#: aiogram.client.bot.Bot.set_chat_photo:6 +#: aiogram.client.bot.Bot.set_chat_sticker_set:6 +#: aiogram.client.bot.Bot.set_chat_title:6 +#: aiogram.client.bot.Bot.set_my_commands:7 +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:6 +#: aiogram.client.bot.Bot.set_sticker_position_in_set:6 +#: aiogram.client.bot.Bot.set_sticker_set_thumb:7 +#: aiogram.client.bot.Bot.unban_chat_member:7 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:6 +#: aiogram.client.bot.Bot.unpin_all_chat_messages:5 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:6 +#: aiogram.client.bot.Bot.unpin_chat_message:6 of +msgid "Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:1 of +#: aiogram.client.bot.Bot.answer_callback_query:1 of msgid "" -"Use this method to specify a URL and receive incoming updates via an " -"outgoing webhook. Whenever there is an update for the bot, we will send " -"an HTTPS POST request to the specified URL, containing a JSON-serialized " -":class:`aiogram.types.update.Update`. In case of an unsuccessful request," -" we will give up after a reasonable amount of attempts. Returns " -":code:`True` on success. If you'd like to make sure that the webhook was " -"set by you, you can specify secret data in the parameter *secret_token*. " -"If specified, the request will contain a header 'X-Telegram-Bot-Api-" -"Secret-Token' with the secret token as content." +"Use this method to send answers to callback queries sent from `inline " +"keyboards `_. " +"The answer will be displayed to the user as a notification at the top of " +"the chat screen or as an alert. On success, :code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:6 of +#: aiogram.client.bot.Bot.answer_callback_query:3 of msgid "" -"**1.** You will not be able to receive updates using " -":class:`aiogram.methods.get_updates.GetUpdates` for as long as an " -"outgoing webhook is set up." +"Alternatively, the user can be redirected to the specified Game URL. For " +"this option to work, you must first create a game for your bot via " +"`@BotFather `_ and accept the terms. Otherwise, " +"you may use links like :code:`t.me/your_bot?start=XXXX` that open your " +"bot with a parameter." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:8 of -msgid "" -"**2.** To use a self-signed certificate, you need to upload your `public " -"key certificate `_ using " -"*certificate* parameter. Please upload as InputFile, sending a String " -"will not work." +#: aiogram.client.bot.Bot.answer_callback_query:5 +#: aiogram.client.bot.Bot.answer_pre_checkout_query:3 +#: aiogram.client.bot.Bot.answer_shipping_query:3 +#: aiogram.client.bot.Bot.answer_web_app_query:3 of +msgid "Unique identifier for the query to be answered" msgstr "" -#: aiogram.client.bot.Bot.set_webhook:10 of +#: aiogram.client.bot.Bot.answer_callback_query:6 of msgid "" -"**3.** Ports currently supported *for webhooks*: **443, 80, 88, 8443**. " -"If you're having any trouble setting up webhooks, please check out this " -"`amazing guide to webhooks `_." -msgstr "" - -#: aiogram.client.bot.Bot.set_webhook:13 of -msgid "Source: https://core.telegram.org/bots/api#setwebhook" +"Text of the notification. If not specified, nothing will be shown to the " +"user, 0-200 characters" msgstr "" -#: aiogram.client.bot.Bot.set_webhook:15 of +#: aiogram.client.bot.Bot.answer_callback_query:7 of msgid "" -"HTTPS URL to send updates to. Use an empty string to remove webhook " -"integration" +"If :code:`True`, an alert will be shown by the client instead of a " +"notification at the top of the chat screen. Defaults to *false*." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:16 of +#: aiogram.client.bot.Bot.answer_callback_query:8 of msgid "" -"Upload your public key certificate so that the root certificate in use " -"can be checked. See our `self-signed guide " -"`_ for details." +"URL that will be opened by the user's client. If you have created a " +":class:`aiogram.types.game.Game` and accepted the conditions via " +"`@BotFather `_, specify the URL that opens your " +"game - note that this will only work if the query comes from a " +"`https://core.telegram.org/bots/api#inlinekeyboardbutton " +"`_ " +"*callback_game* button." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:17 of +#: aiogram.client.bot.Bot.answer_callback_query:9 of msgid "" -"The fixed IP address which will be used to send webhook requests instead " -"of the IP address resolved through DNS" +"The maximum amount of time in seconds that the result of the callback " +"query may be cached client-side. Telegram apps will support caching " +"starting in version 3.14. Defaults to 0." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:18 of +#: aiogram.client.bot.Bot.answer_callback_query:11 of msgid "" -"The maximum allowed number of simultaneous HTTPS connections to the " -"webhook for update delivery, 1-100. Defaults to *40*. Use lower values to" -" limit the load on your bot's server, and higher values to increase your " -"bot's throughput." -msgstr "" - -#: aiogram.client.bot.Bot.delete_webhook:5 -#: aiogram.client.bot.Bot.set_webhook:20 of -msgid "Pass :code:`True` to drop all pending updates" +"Otherwise, you may use links like :code:`t.me/your_bot?start=XXXX` that " +"open your bot with a parameter." msgstr "" -#: aiogram.client.bot.Bot.set_webhook:21 of +#: aiogram.client.bot.Bot.answer_inline_query:1 of msgid "" -"A secret token to be sent in a header 'X-Telegram-Bot-Api-Secret-Token' " -"in every webhook request, 1-256 characters. Only characters :code:`A-Z`, " -":code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. The header" -" is useful to ensure that the request comes from a webhook set by you." +"Use this method to send answers to an inline query. On success, " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:13 -#: aiogram.client.bot.Bot.approve_chat_join_request:8 -#: aiogram.client.bot.Bot.ban_chat_sender_chat:8 -#: aiogram.client.bot.Bot.close_forum_topic:8 -#: aiogram.client.bot.Bot.create_new_sticker_set:15 -#: aiogram.client.bot.Bot.decline_chat_join_request:8 -#: aiogram.client.bot.Bot.delete_chat_photo:7 -#: aiogram.client.bot.Bot.delete_forum_topic:8 -#: aiogram.client.bot.Bot.delete_message:26 -#: aiogram.client.bot.Bot.delete_my_commands:8 -#: aiogram.client.bot.Bot.delete_sticker_from_set:7 -#: aiogram.client.bot.Bot.delete_webhook:7 -#: aiogram.client.bot.Bot.edit_forum_topic:10 -#: aiogram.client.bot.Bot.leave_chat:7 aiogram.client.bot.Bot.log_out:6 -#: aiogram.client.bot.Bot.pin_chat_message:9 -#: aiogram.client.bot.Bot.promote_chat_member:20 -#: aiogram.client.bot.Bot.reopen_forum_topic:8 -#: aiogram.client.bot.Bot.restrict_chat_member:10 -#: aiogram.client.bot.Bot.send_chat_action:12 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:9 -#: aiogram.client.bot.Bot.set_chat_description:8 -#: aiogram.client.bot.Bot.set_chat_menu_button:8 -#: aiogram.client.bot.Bot.set_chat_permissions:8 -#: aiogram.client.bot.Bot.set_chat_photo:8 -#: aiogram.client.bot.Bot.set_chat_title:8 -#: aiogram.client.bot.Bot.set_my_commands:9 -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:8 -#: aiogram.client.bot.Bot.set_sticker_position_in_set:8 -#: aiogram.client.bot.Bot.set_sticker_set_thumb:9 -#: aiogram.client.bot.Bot.set_webhook:23 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:8 -#: aiogram.client.bot.Bot.unpin_all_chat_messages:7 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:8 -#: aiogram.client.bot.Bot.unpin_chat_message:8 of -msgid "Returns True on success." +#: aiogram.client.bot.Bot.answer_inline_query:3 of +msgid "No more than **50** results per query are allowed." msgstr "" -#: aiogram.client.bot.Bot.delete_webhook:1 of -msgid "" -"Use this method to remove webhook integration if you decide to switch " -"back to :class:`aiogram.methods.get_updates.GetUpdates`. Returns " -":code:`True` on success." +#: aiogram.client.bot.Bot.answer_inline_query:5 of +msgid "Unique identifier for the answered query" msgstr "" -#: aiogram.client.bot.Bot.delete_webhook:3 of -msgid "Source: https://core.telegram.org/bots/api#deletewebhook" +#: aiogram.client.bot.Bot.answer_inline_query:6 of +msgid "A JSON-serialized array of results for the inline query" msgstr "" -#: aiogram.client.bot.Bot.get_webhook_info:1 of +#: aiogram.client.bot.Bot.answer_inline_query:7 of msgid "" -"Use this method to get current webhook status. Requires no parameters. On" -" success, returns a :class:`aiogram.types.webhook_info.WebhookInfo` " -"object. If the bot is using " -":class:`aiogram.methods.get_updates.GetUpdates`, will return an object " -"with the *url* field empty." +"The maximum amount of time in seconds that the result of the inline query" +" may be cached on the server. Defaults to 300." msgstr "" -#: aiogram.client.bot.Bot.get_webhook_info:3 of -msgid "Source: https://core.telegram.org/bots/api#getwebhookinfo" +#: aiogram.client.bot.Bot.answer_inline_query:8 of +msgid "" +"Pass :code:`True` if results may be cached on the server side only for " +"the user that sent the query. By default, results may be returned to any " +"user who sends the same query" msgstr "" -#: aiogram.client.bot.Bot.get_webhook_info:6 of +#: aiogram.client.bot.Bot.answer_inline_query:9 of msgid "" -"On success, returns a WebhookInfo object. If the bot is using getUpdates," -" will return an object with the url field empty." +"Pass the offset that a client should send in the next query with the same" +" text to receive more results. Pass an empty string if there are no more " +"results or if you don't support pagination. Offset length can't exceed 64" +" bytes." msgstr "" -#: aiogram.client.bot.Bot.get_me:1 of +#: aiogram.client.bot.Bot.answer_inline_query:10 of msgid "" -"A simple method for testing your bot's authentication token. Requires no " -"parameters. Returns basic information about the bot in form of a " -":class:`aiogram.types.user.User` object." +"If passed, clients will display a button with specified text that " +"switches the user to a private chat with the bot and sends the bot a " +"start message with the parameter *switch_pm_parameter*" msgstr "" -#: aiogram.client.bot.Bot.get_me:3 of -msgid "Source: https://core.telegram.org/bots/api#getme" +#: aiogram.client.bot.Bot.answer_inline_query:11 of +msgid "" +"`Deep-linking `_ " +"parameter for the /start message sent to the bot when user presses the " +"switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, " +":code:`0-9`, :code:`_` and :code:`-` are allowed." msgstr "" -#: aiogram.client.bot.Bot.get_me:6 of -msgid "Returns basic information about the bot in form of a User object." +#: aiogram.client.bot.Bot.answer_inline_query:13 +#: aiogram.client.bot.Bot.answer_shipping_query:8 of +msgid "On success, :code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.log_out:1 of +#: aiogram.client.bot.Bot.answer_pre_checkout_query:1 of msgid "" -"Use this method to log out from the cloud Bot API server before launching" -" the bot locally. You **must** log out the bot before running it locally," -" otherwise there is no guarantee that the bot will receive updates. After" -" a successful call, you can immediately log in on a local server, but " -"will not be able to log in back to the cloud Bot API server for 10 " -"minutes. Returns :code:`True` on success. Requires no parameters." +"Once the user has confirmed their payment and shipping details, the Bot " +"API sends the final confirmation in the form of an " +":class:`aiogram.types.update.Update` with the field *pre_checkout_query*." +" Use this method to respond to such pre-checkout queries. On success, " +":code:`True` is returned. **Note:** The Bot API must receive an answer " +"within 10 seconds after the pre-checkout query was sent." msgstr "" -#: aiogram.client.bot.Bot.log_out:3 of -msgid "Source: https://core.telegram.org/bots/api#logout" +#: aiogram.client.bot.Bot.answer_pre_checkout_query:4 of +msgid "" +"Specify :code:`True` if everything is alright (goods are available, etc.)" +" and the bot is ready to proceed with the order. Use :code:`False` if " +"there are any problems." msgstr "" -#: aiogram.client.bot.Bot.close:1 of +#: aiogram.client.bot.Bot.answer_pre_checkout_query:5 of msgid "" -"Use this method to close the bot instance before moving it from one local" -" server to another. You need to delete the webhook before calling this " -"method to ensure that the bot isn't launched again after server restart. " -"The method will return error 429 in the first 10 minutes after the bot is" -" launched. Returns :code:`True` on success. Requires no parameters." +"Required if *ok* is :code:`False`. Error message in human readable form " +"that explains the reason for failure to proceed with the checkout (e.g. " +"\"Sorry, somebody just bought the last of our amazing black T-shirts " +"while you were busy filling out your payment details. Please choose a " +"different color or garment!\"). Telegram will display this message to the" +" user." msgstr "" -#: aiogram.client.bot.Bot.close:3 of -msgid "Source: https://core.telegram.org/bots/api#close" +#: aiogram.client.bot.Bot.answer_pre_checkout_query:7 of +msgid "" +"**Note:** The Bot API must receive an answer within 10 seconds after the " +"pre-checkout query was sent." msgstr "" -#: aiogram.client.bot.Bot.close:6 of +#: aiogram.client.bot.Bot.answer_shipping_query:1 of msgid "" -"The method will return error 429 in the first 10 minutes after the bot is" -" launched. Returns True on success." +"If you sent an invoice requesting a shipping address and the parameter " +"*is_flexible* was specified, the Bot API will send an " +":class:`aiogram.types.update.Update` with a *shipping_query* field to the" +" bot. Use this method to reply to shipping queries. On success, " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.send_message:1 of +#: aiogram.client.bot.Bot.answer_shipping_query:4 of msgid "" -"Use this method to send text messages. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Pass :code:`True` if delivery to the specified address is possible and " +":code:`False` if there are any problems (for example, if delivery to the " +"specified address is not possible)" msgstr "" -#: aiogram.client.bot.Bot.send_message:3 of -msgid "Source: https://core.telegram.org/bots/api#sendmessage" +#: aiogram.client.bot.Bot.answer_shipping_query:5 of +msgid "" +"Required if *ok* is :code:`True`. A JSON-serialized array of available " +"shipping options." msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:5 -#: aiogram.client.bot.Bot.ban_chat_sender_chat:5 -#: aiogram.client.bot.Bot.copy_message:5 -#: aiogram.client.bot.Bot.create_chat_invite_link:5 -#: aiogram.client.bot.Bot.decline_chat_join_request:5 -#: aiogram.client.bot.Bot.delete_chat_photo:5 -#: aiogram.client.bot.Bot.delete_message:23 -#: aiogram.client.bot.Bot.edit_chat_invite_link:5 -#: aiogram.client.bot.Bot.export_chat_invite_link:7 -#: aiogram.client.bot.Bot.forward_message:5 -#: aiogram.client.bot.Bot.pin_chat_message:5 -#: aiogram.client.bot.Bot.promote_chat_member:5 -#: aiogram.client.bot.Bot.send_animation:5 aiogram.client.bot.Bot.send_audio:6 -#: aiogram.client.bot.Bot.send_chat_action:9 -#: aiogram.client.bot.Bot.send_contact:5 aiogram.client.bot.Bot.send_dice:5 -#: aiogram.client.bot.Bot.send_document:5 aiogram.client.bot.Bot.send_invoice:5 -#: aiogram.client.bot.Bot.send_location:5 -#: aiogram.client.bot.Bot.send_media_group:5 -#: aiogram.client.bot.Bot.send_message:5 aiogram.client.bot.Bot.send_photo:5 -#: aiogram.client.bot.Bot.send_poll:5 aiogram.client.bot.Bot.send_sticker:5 -#: aiogram.client.bot.Bot.send_venue:5 aiogram.client.bot.Bot.send_video:5 -#: aiogram.client.bot.Bot.send_video_note:5 aiogram.client.bot.Bot.send_voice:5 -#: aiogram.client.bot.Bot.set_chat_description:5 -#: aiogram.client.bot.Bot.set_chat_photo:5 -#: aiogram.client.bot.Bot.set_chat_title:5 aiogram.client.bot.Bot.stop_poll:5 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:5 -#: aiogram.client.bot.Bot.unpin_all_chat_messages:5 -#: aiogram.client.bot.Bot.unpin_chat_message:5 of +#: aiogram.client.bot.Bot.answer_shipping_query:6 of msgid "" -"Unique identifier for the target chat or username of the target channel " -"(in the format :code:`@channelusername`)" +"Required if *ok* is :code:`False`. Error message in human readable form " +"that explains why it is impossible to complete the order (e.g. \"Sorry, " +"delivery to your desired address is unavailable'). Telegram will display " +"this message to the user." msgstr "" -#: aiogram.client.bot.Bot.send_message:6 of -msgid "Text of the message to be sent, 1-4096 characters after entities parsing" +#: aiogram.client.bot.Bot.answer_web_app_query:1 of +msgid "" +"Use this method to set the result of an interaction with a `Web App " +"`_ and send a corresponding " +"message on behalf of the user to the chat from which the query " +"originated. On success, a " +":class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.copy_message:8 -#: aiogram.client.bot.Bot.forward_message:8 -#: aiogram.client.bot.Bot.send_animation:7 aiogram.client.bot.Bot.send_audio:8 -#: aiogram.client.bot.Bot.send_contact:8 aiogram.client.bot.Bot.send_dice:6 -#: aiogram.client.bot.Bot.send_document:7 aiogram.client.bot.Bot.send_game:7 -#: aiogram.client.bot.Bot.send_invoice:12 -#: aiogram.client.bot.Bot.send_location:8 -#: aiogram.client.bot.Bot.send_media_group:7 -#: aiogram.client.bot.Bot.send_message:7 aiogram.client.bot.Bot.send_photo:7 -#: aiogram.client.bot.Bot.send_poll:8 aiogram.client.bot.Bot.send_sticker:7 -#: aiogram.client.bot.Bot.send_venue:10 aiogram.client.bot.Bot.send_video:7 -#: aiogram.client.bot.Bot.send_video_note:7 aiogram.client.bot.Bot.send_voice:7 -#: of +#: aiogram.client.bot.Bot.answer_web_app_query:4 of +msgid "A JSON-serialized object describing the message to be sent" +msgstr "" + +#: aiogram.client.bot.Bot.answer_web_app_query:6 of msgid "" -"Unique identifier for the target message thread (topic) of the forum; for" -" forum supergroups only" +"On success, a " +":class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:9 -#: aiogram.client.bot.Bot.send_message:8 of +#: aiogram.client.bot.Bot.approve_chat_join_request:1 of msgid "" -"Mode for parsing entities in the message text. See `formatting options " -"`_ for more " -"details." +"Use this method to approve a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:10 -#: aiogram.client.bot.Bot.send_message:9 of +#: aiogram.client.bot.Bot.approve_chat_join_request:3 +#: aiogram.client.bot.Bot.ban_chat_sender_chat:3 +#: aiogram.client.bot.Bot.copy_message:3 +#: aiogram.client.bot.Bot.create_chat_invite_link:3 +#: aiogram.client.bot.Bot.decline_chat_join_request:3 +#: aiogram.client.bot.Bot.delete_chat_photo:3 +#: aiogram.client.bot.Bot.delete_message:21 +#: aiogram.client.bot.Bot.edit_chat_invite_link:3 +#: aiogram.client.bot.Bot.export_chat_invite_link:5 +#: aiogram.client.bot.Bot.forward_message:3 +#: aiogram.client.bot.Bot.pin_chat_message:3 +#: aiogram.client.bot.Bot.promote_chat_member:3 +#: aiogram.client.bot.Bot.send_animation:3 aiogram.client.bot.Bot.send_audio:4 +#: aiogram.client.bot.Bot.send_chat_action:7 +#: aiogram.client.bot.Bot.send_contact:3 aiogram.client.bot.Bot.send_dice:3 +#: aiogram.client.bot.Bot.send_document:3 aiogram.client.bot.Bot.send_invoice:3 +#: aiogram.client.bot.Bot.send_location:3 +#: aiogram.client.bot.Bot.send_media_group:3 +#: aiogram.client.bot.Bot.send_message:3 aiogram.client.bot.Bot.send_photo:3 +#: aiogram.client.bot.Bot.send_poll:3 aiogram.client.bot.Bot.send_sticker:3 +#: aiogram.client.bot.Bot.send_venue:3 aiogram.client.bot.Bot.send_video:3 +#: aiogram.client.bot.Bot.send_video_note:3 aiogram.client.bot.Bot.send_voice:3 +#: aiogram.client.bot.Bot.set_chat_description:3 +#: aiogram.client.bot.Bot.set_chat_photo:3 +#: aiogram.client.bot.Bot.set_chat_title:3 aiogram.client.bot.Bot.stop_poll:3 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:3 +#: aiogram.client.bot.Bot.unpin_all_chat_messages:3 +#: aiogram.client.bot.Bot.unpin_chat_message:3 of msgid "" -"A JSON-serialized list of special entities that appear in message text, " -"which can be specified instead of *parse_mode*" +"Unique identifier for the target chat or username of the target channel " +"(in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:11 -#: aiogram.client.bot.Bot.send_message:10 of -msgid "Disables link previews for links in this message" +#: aiogram.client.bot.Bot.approve_chat_join_request:4 +#: aiogram.client.bot.Bot.ban_chat_member:4 +#: aiogram.client.bot.Bot.decline_chat_join_request:4 +#: aiogram.client.bot.Bot.get_chat_member:4 +#: aiogram.client.bot.Bot.get_user_profile_photos:3 +#: aiogram.client.bot.Bot.promote_chat_member:4 +#: aiogram.client.bot.Bot.restrict_chat_member:4 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:4 +#: aiogram.client.bot.Bot.unban_chat_member:4 of +msgid "Unique identifier of the target user" msgstr "" -#: aiogram.client.bot.Bot.copy_message:12 -#: aiogram.client.bot.Bot.forward_message:9 -#: aiogram.client.bot.Bot.send_animation:15 -#: aiogram.client.bot.Bot.send_audio:16 aiogram.client.bot.Bot.send_contact:11 -#: aiogram.client.bot.Bot.send_dice:8 aiogram.client.bot.Bot.send_document:13 -#: aiogram.client.bot.Bot.send_game:8 aiogram.client.bot.Bot.send_invoice:28 -#: aiogram.client.bot.Bot.send_location:13 -#: aiogram.client.bot.Bot.send_message:11 aiogram.client.bot.Bot.send_photo:11 -#: aiogram.client.bot.Bot.send_poll:19 aiogram.client.bot.Bot.send_sticker:8 -#: aiogram.client.bot.Bot.send_venue:15 aiogram.client.bot.Bot.send_video:16 -#: aiogram.client.bot.Bot.send_video_note:11 -#: aiogram.client.bot.Bot.send_voice:12 of +#: aiogram.client.bot.Bot.ban_chat_member:1 of msgid "" -"Sends the message `silently `_. Users will receive a notification with no sound." +"Use this method to ban a user in a group, a supergroup or a channel. In " +"the case of supergroups and channels, the user will not be able to return" +" to the chat on their own using invite links, etc., unless `unbanned " +"`_ first. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.copy_message:13 -#: aiogram.client.bot.Bot.send_animation:16 -#: aiogram.client.bot.Bot.send_audio:17 aiogram.client.bot.Bot.send_contact:12 -#: aiogram.client.bot.Bot.send_document:14 aiogram.client.bot.Bot.send_game:9 -#: aiogram.client.bot.Bot.send_invoice:29 -#: aiogram.client.bot.Bot.send_location:14 -#: aiogram.client.bot.Bot.send_message:12 aiogram.client.bot.Bot.send_photo:12 -#: aiogram.client.bot.Bot.send_poll:20 aiogram.client.bot.Bot.send_sticker:9 -#: aiogram.client.bot.Bot.send_venue:16 aiogram.client.bot.Bot.send_video:17 -#: aiogram.client.bot.Bot.send_video_note:12 -#: aiogram.client.bot.Bot.send_voice:13 of -msgid "Protects the contents of the sent message from forwarding and saving" +#: aiogram.client.bot.Bot.ban_chat_member:3 +#: aiogram.client.bot.Bot.unban_chat_member:3 of +msgid "" +"Unique identifier for the target group or username of the target " +"supergroup or channel (in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.copy_message:14 -#: aiogram.client.bot.Bot.send_animation:17 -#: aiogram.client.bot.Bot.send_audio:18 aiogram.client.bot.Bot.send_contact:13 -#: aiogram.client.bot.Bot.send_dice:10 aiogram.client.bot.Bot.send_document:15 -#: aiogram.client.bot.Bot.send_game:10 aiogram.client.bot.Bot.send_invoice:30 -#: aiogram.client.bot.Bot.send_location:15 -#: aiogram.client.bot.Bot.send_message:13 aiogram.client.bot.Bot.send_photo:13 -#: aiogram.client.bot.Bot.send_poll:21 aiogram.client.bot.Bot.send_sticker:10 -#: aiogram.client.bot.Bot.send_venue:17 aiogram.client.bot.Bot.send_video:18 -#: aiogram.client.bot.Bot.send_video_note:13 -#: aiogram.client.bot.Bot.send_voice:14 of -msgid "If the message is a reply, ID of the original message" +#: aiogram.client.bot.Bot.ban_chat_member:5 of +msgid "" +"Date when the user will be unbanned, unix time. If user is banned for " +"more than 366 days or less than 30 seconds from the current time they are" +" considered to be banned forever. Applied for supergroups and channels " +"only." msgstr "" -#: aiogram.client.bot.Bot.copy_message:15 -#: aiogram.client.bot.Bot.send_animation:18 -#: aiogram.client.bot.Bot.send_audio:19 aiogram.client.bot.Bot.send_contact:14 -#: aiogram.client.bot.Bot.send_dice:11 aiogram.client.bot.Bot.send_document:16 -#: aiogram.client.bot.Bot.send_game:11 aiogram.client.bot.Bot.send_invoice:31 -#: aiogram.client.bot.Bot.send_location:16 -#: aiogram.client.bot.Bot.send_media_group:11 -#: aiogram.client.bot.Bot.send_message:14 aiogram.client.bot.Bot.send_photo:14 -#: aiogram.client.bot.Bot.send_poll:22 aiogram.client.bot.Bot.send_sticker:11 -#: aiogram.client.bot.Bot.send_venue:18 aiogram.client.bot.Bot.send_video:19 -#: aiogram.client.bot.Bot.send_video_note:14 -#: aiogram.client.bot.Bot.send_voice:15 of +#: aiogram.client.bot.Bot.ban_chat_member:6 of msgid "" -"Pass :code:`True` if the message should be sent even if the specified " -"replied-to message is not found" +"Pass :code:`True` to delete all messages from the chat for the user that " +"is being removed. If :code:`False`, the user will be able to see messages" +" in the group that were sent before the user was removed. Always " +":code:`True` for supergroups and channels." msgstr "" -#: aiogram.client.bot.Bot.copy_message:16 -#: aiogram.client.bot.Bot.send_animation:19 -#: aiogram.client.bot.Bot.send_audio:20 aiogram.client.bot.Bot.send_contact:15 -#: aiogram.client.bot.Bot.send_dice:12 aiogram.client.bot.Bot.send_document:17 -#: aiogram.client.bot.Bot.send_location:17 -#: aiogram.client.bot.Bot.send_message:15 aiogram.client.bot.Bot.send_photo:15 -#: aiogram.client.bot.Bot.send_poll:23 aiogram.client.bot.Bot.send_sticker:12 -#: aiogram.client.bot.Bot.send_venue:19 aiogram.client.bot.Bot.send_video:20 -#: aiogram.client.bot.Bot.send_video_note:15 -#: aiogram.client.bot.Bot.send_voice:16 of +#: aiogram.client.bot.Bot.ban_chat_sender_chat:1 of msgid "" -"Additional interface options. A JSON-serialized object for an `inline " -"keyboard `_, " -"`custom reply keyboard " -"`_, instructions to " -"remove reply keyboard or to force a reply from the user." +"Use this method to ban a channel chat in a supergroup or a channel. Until" +" the chat is `unbanned " +"`_, the owner of " +"the banned chat won't be able to send messages on behalf of **any of " +"their channels**. The bot must be an administrator in the supergroup or " +"channel for this to work and must have the appropriate administrator " +"rights. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.forward_message:12 -#: aiogram.client.bot.Bot.send_animation:21 -#: aiogram.client.bot.Bot.send_audio:22 aiogram.client.bot.Bot.send_contact:17 -#: aiogram.client.bot.Bot.send_dice:14 aiogram.client.bot.Bot.send_document:19 -#: aiogram.client.bot.Bot.send_game:14 aiogram.client.bot.Bot.send_invoice:34 -#: aiogram.client.bot.Bot.send_location:19 -#: aiogram.client.bot.Bot.send_message:17 aiogram.client.bot.Bot.send_photo:17 -#: aiogram.client.bot.Bot.send_poll:25 aiogram.client.bot.Bot.send_sticker:14 -#: aiogram.client.bot.Bot.send_venue:21 aiogram.client.bot.Bot.send_video:22 -#: aiogram.client.bot.Bot.send_video_note:17 -#: aiogram.client.bot.Bot.send_voice:18 of -msgid "On success, the sent Message is returned." +#: aiogram.client.bot.Bot.ban_chat_sender_chat:4 +#: aiogram.client.bot.Bot.unban_chat_sender_chat:4 of +msgid "Unique identifier of the target sender chat" msgstr "" -#: aiogram.client.bot.Bot.forward_message:1 of +#: aiogram.client.bot.Bot.close:1 of msgid "" -"Use this method to forward messages of any kind. Service messages can't " -"be forwarded. On success, the sent :class:`aiogram.types.message.Message`" -" is returned." +"Use this method to close the bot instance before moving it from one local" +" server to another. You need to delete the webhook before calling this " +"method to ensure that the bot isn't launched again after server restart. " +"The method will return error 429 in the first 10 minutes after the bot is" +" launched. Returns :code:`True` on success. Requires no parameters." msgstr "" -#: aiogram.client.bot.Bot.forward_message:3 of -msgid "Source: https://core.telegram.org/bots/api#forwardmessage" +#: aiogram.client.bot.Bot.close:4 aiogram.client.bot.Bot.log_out:4 of +msgid "Requires no parameters." msgstr "" -#: aiogram.client.bot.Bot.copy_message:6 -#: aiogram.client.bot.Bot.forward_message:6 of +#: aiogram.client.bot.Bot.close_forum_topic:1 of msgid "" -"Unique identifier for the chat where the original message was sent (or " -"channel username in the format :code:`@channelusername`)" +"Use this method to close an open topic in a forum supergroup chat. The " +"bot must be an administrator in the chat for this to work and must have " +"the *can_manage_topics* administrator rights, unless it is the creator of" +" the topic. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.copy_message:7 -#: aiogram.client.bot.Bot.forward_message:7 of -msgid "Message identifier in the chat specified in *from_chat_id*" +#: aiogram.client.bot.Bot.close_forum_topic:3 +#: aiogram.client.bot.Bot.create_forum_topic:3 +#: aiogram.client.bot.Bot.delete_chat_sticker_set:3 +#: aiogram.client.bot.Bot.delete_forum_topic:3 +#: aiogram.client.bot.Bot.edit_forum_topic:3 +#: aiogram.client.bot.Bot.reopen_forum_topic:3 +#: aiogram.client.bot.Bot.restrict_chat_member:3 +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:3 +#: aiogram.client.bot.Bot.set_chat_permissions:3 +#: aiogram.client.bot.Bot.set_chat_sticker_set:3 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:3 of +msgid "" +"Unique identifier for the target chat or username of the target " +"supergroup (in the format :code:`@supergroupusername`)" msgstr "" -#: aiogram.client.bot.Bot.forward_message:10 of -msgid "Protects the contents of the forwarded message from forwarding and saving" +#: aiogram.client.bot.Bot.close_forum_topic:4 +#: aiogram.client.bot.Bot.delete_forum_topic:4 +#: aiogram.client.bot.Bot.edit_forum_topic:4 +#: aiogram.client.bot.Bot.reopen_forum_topic:4 +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:4 of +msgid "Unique identifier for the target message thread of the forum topic" msgstr "" #: aiogram.client.bot.Bot.copy_message:1 of @@ -866,934 +847,1160 @@ msgid "" "message on success." msgstr "" -#: aiogram.client.bot.Bot.copy_message:3 of -msgid "Source: https://core.telegram.org/bots/api#copymessage" +#: aiogram.client.bot.Bot.copy_message:4 +#: aiogram.client.bot.Bot.forward_message:4 of +msgid "" +"Unique identifier for the chat where the original message was sent (or " +"channel username in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.copy_message:9 of +#: aiogram.client.bot.Bot.copy_message:5 +#: aiogram.client.bot.Bot.forward_message:5 of +msgid "Message identifier in the chat specified in *from_chat_id*" +msgstr "" + +#: aiogram.client.bot.Bot.copy_message:6 +#: aiogram.client.bot.Bot.forward_message:6 +#: aiogram.client.bot.Bot.send_animation:5 aiogram.client.bot.Bot.send_audio:6 +#: aiogram.client.bot.Bot.send_contact:6 aiogram.client.bot.Bot.send_dice:4 +#: aiogram.client.bot.Bot.send_document:5 aiogram.client.bot.Bot.send_game:5 +#: aiogram.client.bot.Bot.send_invoice:10 +#: aiogram.client.bot.Bot.send_location:6 +#: aiogram.client.bot.Bot.send_media_group:5 +#: aiogram.client.bot.Bot.send_message:5 aiogram.client.bot.Bot.send_photo:5 +#: aiogram.client.bot.Bot.send_poll:6 aiogram.client.bot.Bot.send_sticker:5 +#: aiogram.client.bot.Bot.send_venue:8 aiogram.client.bot.Bot.send_video:5 +#: aiogram.client.bot.Bot.send_video_note:5 aiogram.client.bot.Bot.send_voice:5 +#: of +msgid "" +"Unique identifier for the target message thread (topic) of the forum; for" +" forum supergroups only" +msgstr "" + +#: aiogram.client.bot.Bot.copy_message:7 of msgid "" "New caption for media, 0-1024 characters after entities parsing. If not " "specified, the original caption is kept" msgstr "" -#: aiogram.client.bot.Bot.copy_message:10 of +#: aiogram.client.bot.Bot.copy_message:8 of msgid "" "Mode for parsing entities in the new caption. See `formatting options " "`_ for more " "details." msgstr "" -#: aiogram.client.bot.Bot.copy_message:11 of +#: aiogram.client.bot.Bot.copy_message:9 of msgid "" "A JSON-serialized list of special entities that appear in the new " "caption, which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.copy_message:18 of -msgid "Returns the MessageId of the sent message on success." +#: aiogram.client.bot.Bot.copy_message:10 +#: aiogram.client.bot.Bot.forward_message:7 +#: aiogram.client.bot.Bot.send_animation:13 +#: aiogram.client.bot.Bot.send_audio:14 aiogram.client.bot.Bot.send_contact:9 +#: aiogram.client.bot.Bot.send_dice:6 aiogram.client.bot.Bot.send_document:11 +#: aiogram.client.bot.Bot.send_game:6 aiogram.client.bot.Bot.send_invoice:26 +#: aiogram.client.bot.Bot.send_location:11 +#: aiogram.client.bot.Bot.send_message:9 aiogram.client.bot.Bot.send_photo:9 +#: aiogram.client.bot.Bot.send_poll:17 aiogram.client.bot.Bot.send_sticker:6 +#: aiogram.client.bot.Bot.send_venue:13 aiogram.client.bot.Bot.send_video:14 +#: aiogram.client.bot.Bot.send_video_note:9 +#: aiogram.client.bot.Bot.send_voice:10 of +msgid "" +"Sends the message `silently `_. Users will receive a notification with no sound." msgstr "" -#: aiogram.client.bot.Bot.send_photo:1 of -msgid "" -"Use this method to send photos. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +#: aiogram.client.bot.Bot.copy_message:11 +#: aiogram.client.bot.Bot.send_animation:14 +#: aiogram.client.bot.Bot.send_audio:15 aiogram.client.bot.Bot.send_contact:10 +#: aiogram.client.bot.Bot.send_document:12 aiogram.client.bot.Bot.send_game:7 +#: aiogram.client.bot.Bot.send_invoice:27 +#: aiogram.client.bot.Bot.send_location:12 +#: aiogram.client.bot.Bot.send_message:10 aiogram.client.bot.Bot.send_photo:10 +#: aiogram.client.bot.Bot.send_poll:18 aiogram.client.bot.Bot.send_sticker:7 +#: aiogram.client.bot.Bot.send_venue:14 aiogram.client.bot.Bot.send_video:15 +#: aiogram.client.bot.Bot.send_video_note:10 +#: aiogram.client.bot.Bot.send_voice:11 of +msgid "Protects the contents of the sent message from forwarding and saving" msgstr "" -#: aiogram.client.bot.Bot.send_photo:3 of -msgid "Source: https://core.telegram.org/bots/api#sendphoto" +#: aiogram.client.bot.Bot.copy_message:12 +#: aiogram.client.bot.Bot.send_animation:15 +#: aiogram.client.bot.Bot.send_audio:16 aiogram.client.bot.Bot.send_contact:11 +#: aiogram.client.bot.Bot.send_dice:8 aiogram.client.bot.Bot.send_document:13 +#: aiogram.client.bot.Bot.send_game:8 aiogram.client.bot.Bot.send_invoice:28 +#: aiogram.client.bot.Bot.send_location:13 +#: aiogram.client.bot.Bot.send_message:11 aiogram.client.bot.Bot.send_photo:11 +#: aiogram.client.bot.Bot.send_poll:19 aiogram.client.bot.Bot.send_sticker:8 +#: aiogram.client.bot.Bot.send_venue:15 aiogram.client.bot.Bot.send_video:16 +#: aiogram.client.bot.Bot.send_video_note:11 +#: aiogram.client.bot.Bot.send_voice:12 of +msgid "If the message is a reply, ID of the original message" msgstr "" -#: aiogram.client.bot.Bot.send_photo:6 of -msgid "" -"Photo to send. Pass a file_id as String to send a photo that exists on " -"the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a photo from the Internet, or upload a new photo using " -"multipart/form-data. The photo must be at most 10 MB in size. The photo's" -" width and height must not exceed 10000 in total. Width and height ratio " -"must be at most 20. :ref:`More information on Sending Files » `" +#: aiogram.client.bot.Bot.copy_message:13 +#: aiogram.client.bot.Bot.send_animation:16 +#: aiogram.client.bot.Bot.send_audio:17 aiogram.client.bot.Bot.send_contact:12 +#: aiogram.client.bot.Bot.send_dice:9 aiogram.client.bot.Bot.send_document:14 +#: aiogram.client.bot.Bot.send_game:9 aiogram.client.bot.Bot.send_invoice:29 +#: aiogram.client.bot.Bot.send_location:14 +#: aiogram.client.bot.Bot.send_media_group:9 +#: aiogram.client.bot.Bot.send_message:12 aiogram.client.bot.Bot.send_photo:12 +#: aiogram.client.bot.Bot.send_poll:20 aiogram.client.bot.Bot.send_sticker:9 +#: aiogram.client.bot.Bot.send_venue:16 aiogram.client.bot.Bot.send_video:17 +#: aiogram.client.bot.Bot.send_video_note:12 +#: aiogram.client.bot.Bot.send_voice:13 of +msgid "" +"Pass :code:`True` if the message should be sent even if the specified " +"replied-to message is not found" msgstr "" -#: aiogram.client.bot.Bot.send_photo:8 of +#: aiogram.client.bot.Bot.copy_message:14 +#: aiogram.client.bot.Bot.send_animation:17 +#: aiogram.client.bot.Bot.send_audio:18 aiogram.client.bot.Bot.send_contact:13 +#: aiogram.client.bot.Bot.send_dice:10 aiogram.client.bot.Bot.send_document:15 +#: aiogram.client.bot.Bot.send_location:15 +#: aiogram.client.bot.Bot.send_message:13 aiogram.client.bot.Bot.send_photo:13 +#: aiogram.client.bot.Bot.send_poll:21 aiogram.client.bot.Bot.send_sticker:10 +#: aiogram.client.bot.Bot.send_venue:17 aiogram.client.bot.Bot.send_video:18 +#: aiogram.client.bot.Bot.send_video_note:13 +#: aiogram.client.bot.Bot.send_voice:14 of msgid "" -"Photo caption (may also be used when resending photos by *file_id*), " -"0-1024 characters after entities parsing" +"Additional interface options. A JSON-serialized object for an `inline " +"keyboard `_, " +"`custom reply keyboard " +"`_, instructions to " +"remove reply keyboard or to force a reply from the user." msgstr "" -#: aiogram.client.bot.Bot.send_photo:9 of +#: aiogram.client.bot.Bot.copy_message:16 of msgid "" -"Mode for parsing entities in the photo caption. See `formatting options " -"`_ for more " -"details." +"Returns the :class:`aiogram.types.message_id.MessageId` of the sent " +"message on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:10 -#: aiogram.client.bot.Bot.send_animation:14 -#: aiogram.client.bot.Bot.send_audio:11 aiogram.client.bot.Bot.send_document:11 -#: aiogram.client.bot.Bot.send_photo:10 aiogram.client.bot.Bot.send_video:14 -#: aiogram.client.bot.Bot.send_voice:10 of +#: aiogram.client.bot.Bot.create_chat_invite_link:1 of msgid "" -"A JSON-serialized list of special entities that appear in the caption, " -"which can be specified instead of *parse_mode*" +"Use this method to create an additional invite link for a chat. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. The link can be revoked using the " +"method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. " +"Returns the new invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.send_audio:1 of -msgid "" -"Use this method to send audio files, if you want Telegram clients to " -"display them in the music player. Your audio must be in the .MP3 or .M4A " -"format. On success, the sent :class:`aiogram.types.message.Message` is " -"returned. Bots can currently send audio files of up to 50 MB in size, " -"this limit may be changed in the future. For sending voice messages, use " -"the :class:`aiogram.methods.send_voice.SendVoice` method instead." +#: aiogram.client.bot.Bot.create_chat_invite_link:4 +#: aiogram.client.bot.Bot.edit_chat_invite_link:5 of +msgid "Invite link name; 0-32 characters" +msgstr "" + +#: aiogram.client.bot.Bot.create_chat_invite_link:5 +#: aiogram.client.bot.Bot.edit_chat_invite_link:6 of +msgid "Point in time (Unix timestamp) when the link will expire" msgstr "" -#: aiogram.client.bot.Bot.send_audio:4 of -msgid "Source: https://core.telegram.org/bots/api#sendaudio" +#: aiogram.client.bot.Bot.create_chat_invite_link:6 +#: aiogram.client.bot.Bot.edit_chat_invite_link:7 of +msgid "" +"The maximum number of users that can be members of the chat " +"simultaneously after joining the chat via this invite link; 1-99999" msgstr "" -#: aiogram.client.bot.Bot.send_audio:7 of +#: aiogram.client.bot.Bot.create_chat_invite_link:7 +#: aiogram.client.bot.Bot.edit_chat_invite_link:8 of msgid "" -"Audio file to send. Pass a file_id as String to send an audio file that " -"exists on the Telegram servers (recommended), pass an HTTP URL as a " -"String for Telegram to get an audio file from the Internet, or upload a " -"new one using multipart/form-data. :ref:`More information on Sending " -"Files » `" +":code:`True`, if users joining the chat via the link need to be approved " +"by chat administrators. If :code:`True`, *member_limit* can't be " +"specified" msgstr "" -#: aiogram.client.bot.Bot.send_audio:9 of -msgid "Audio caption, 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.create_chat_invite_link:9 of +msgid "" +"Returns the new invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.send_audio:10 of +#: aiogram.client.bot.Bot.create_forum_topic:1 of msgid "" -"Mode for parsing entities in the audio caption. See `formatting options " -"`_ for more " -"details." +"Use this method to create a topic in a forum supergroup chat. The bot " +"must be an administrator in the chat for this to work and must have the " +"*can_manage_topics* administrator rights. Returns information about the " +"created topic as a :class:`aiogram.types.forum_topic.ForumTopic` object." msgstr "" -#: aiogram.client.bot.Bot.send_audio:12 of -msgid "Duration of the audio in seconds" +#: aiogram.client.bot.Bot.create_forum_topic:4 of +msgid "Topic name, 1-128 characters" msgstr "" -#: aiogram.client.bot.Bot.send_audio:13 of -msgid "Performer" +#: aiogram.client.bot.Bot.create_forum_topic:5 of +msgid "" +"Color of the topic icon in RGB format. Currently, must be one of 7322096 " +"(0x6FB9F0), 16766590 (0xFFD67E), 13338331 (0xCB86DB), 9367192 (0x8EEE98)," +" 16749490 (0xFF93B2), or 16478047 (0xFB6F5F)" msgstr "" -#: aiogram.client.bot.Bot.send_audio:14 of -msgid "Track name" +#: aiogram.client.bot.Bot.create_forum_topic:6 of +msgid "" +"Unique identifier of the custom emoji shown as the topic icon. Use " +":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +" to get all allowed custom emoji identifiers." msgstr "" -#: aiogram.client.bot.Bot.send_animation:11 -#: aiogram.client.bot.Bot.send_audio:15 aiogram.client.bot.Bot.send_document:8 -#: aiogram.client.bot.Bot.send_video:11 -#: aiogram.client.bot.Bot.send_video_note:10 of +#: aiogram.client.bot.Bot.create_forum_topic:8 of msgid "" -"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 » `" +"Returns information about the created topic as a " +":class:`aiogram.types.forum_topic.ForumTopic` object." msgstr "" -#: aiogram.client.bot.Bot.send_document:1 of +#: aiogram.client.bot.Bot.create_invoice_link:1 of msgid "" -"Use this method to send general files. On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send files of any type of up to 50 MB in size, this limit may be changed " -"in the future." +"Use this method to create a link for an invoice. Returns the created " +"invoice link as *String* on success." +msgstr "" + +#: aiogram.client.bot.Bot.create_invoice_link:3 +#: aiogram.client.bot.Bot.send_invoice:4 of +msgid "Product name, 1-32 characters" msgstr "" -#: aiogram.client.bot.Bot.send_document:3 of -msgid "Source: https://core.telegram.org/bots/api#senddocument" +#: aiogram.client.bot.Bot.create_invoice_link:4 +#: aiogram.client.bot.Bot.send_invoice:5 of +msgid "Product description, 1-255 characters" msgstr "" -#: aiogram.client.bot.Bot.send_document:6 of +#: aiogram.client.bot.Bot.create_invoice_link:5 +#: aiogram.client.bot.Bot.send_invoice:6 of msgid "" -"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 » `" +"Bot-defined invoice payload, 1-128 bytes. This will not be displayed to " +"the user, use for your internal processes." +msgstr "" + +#: aiogram.client.bot.Bot.create_invoice_link:6 of +msgid "Payment provider token, obtained via `BotFather `_" msgstr "" -#: aiogram.client.bot.Bot.send_document:9 of +#: aiogram.client.bot.Bot.create_invoice_link:7 +#: aiogram.client.bot.Bot.send_invoice:8 of msgid "" -"Document caption (may also be used when resending documents by " -"*file_id*), 0-1024 characters after entities parsing" +"Three-letter ISO 4217 currency code, see `more on currencies " +"`_" msgstr "" -#: aiogram.client.bot.Bot.send_document:10 of +#: aiogram.client.bot.Bot.create_invoice_link:8 +#: aiogram.client.bot.Bot.send_invoice:9 of msgid "" -"Mode for parsing entities in the document caption. See `formatting " -"options `_ for " -"more details." +"Price breakdown, a JSON-serialized list of components (e.g. product " +"price, tax, discount, delivery cost, delivery tax, bonus, etc.)" msgstr "" -#: aiogram.client.bot.Bot.send_document:12 of +#: aiogram.client.bot.Bot.create_invoice_link:9 +#: aiogram.client.bot.Bot.send_invoice:11 of msgid "" -"Disables automatic server-side content type detection for files uploaded " -"using multipart/form-data" +"The maximum accepted amount for tips in the *smallest units* of the " +"currency (integer, **not** float/double). For example, for a maximum tip " +"of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* " +"parameter in `currencies.json " +"`_, it shows the" +" number of digits past the decimal point for each currency (2 for the " +"majority of currencies). Defaults to 0" msgstr "" -#: aiogram.client.bot.Bot.send_video:1 of +#: aiogram.client.bot.Bot.create_invoice_link:10 +#: aiogram.client.bot.Bot.send_invoice:12 of msgid "" -"Use this method to send video files, Telegram clients support MPEG4 " -"videos (other formats may be sent as " -":class:`aiogram.types.document.Document`). On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send video files of up to 50 MB in size, this limit may be changed in the" -" future." +"A JSON-serialized array of suggested amounts of tips in the *smallest " +"units* of the currency (integer, **not** float/double). At most 4 " +"suggested tip amounts can be specified. The suggested tip amounts must be" +" positive, passed in a strictly increased order and must not exceed " +"*max_tip_amount*." msgstr "" -#: aiogram.client.bot.Bot.send_video:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvideo" +#: aiogram.client.bot.Bot.create_invoice_link:11 +#: aiogram.client.bot.Bot.send_invoice:14 of +msgid "" +"JSON-serialized data about the invoice, which will be shared with the " +"payment provider. A detailed description of required fields should be " +"provided by the payment provider." msgstr "" -#: aiogram.client.bot.Bot.send_video:6 of +#: aiogram.client.bot.Bot.create_invoice_link:12 of msgid "" -"Video to send. Pass a file_id as String to send a video that exists on " -"the Telegram servers (recommended), pass an HTTP URL as a String for " -"Telegram to get a video from the Internet, or upload a new video using " -"multipart/form-data. :ref:`More information on Sending Files » `" +"URL of the product photo for the invoice. Can be a photo of the goods or " +"a marketing image for a service." msgstr "" -#: aiogram.client.bot.Bot.send_video:8 aiogram.client.bot.Bot.send_video_note:8 -#: of -msgid "Duration of sent video in seconds" +#: aiogram.client.bot.Bot.create_invoice_link:13 +#: aiogram.client.bot.Bot.send_invoice:16 of +msgid "Photo size in bytes" msgstr "" -#: aiogram.client.bot.Bot.send_video:9 of -msgid "Video width" +#: aiogram.client.bot.Bot.create_invoice_link:14 +#: aiogram.client.bot.Bot.send_invoice:17 of +msgid "Photo width" msgstr "" -#: aiogram.client.bot.Bot.send_video:10 of -msgid "Video height" +#: aiogram.client.bot.Bot.create_invoice_link:15 +#: aiogram.client.bot.Bot.send_invoice:18 of +msgid "Photo height" msgstr "" -#: aiogram.client.bot.Bot.send_video:12 of +#: aiogram.client.bot.Bot.create_invoice_link:16 +#: aiogram.client.bot.Bot.send_invoice:19 of msgid "" -"Video caption (may also be used when resending videos by *file_id*), " -"0-1024 characters after entities parsing" +"Pass :code:`True` if you require the user's full name to complete the " +"order" msgstr "" -#: aiogram.client.bot.Bot.send_video:13 of +#: aiogram.client.bot.Bot.create_invoice_link:17 +#: aiogram.client.bot.Bot.send_invoice:20 of msgid "" -"Mode for parsing entities in the video caption. See `formatting options " -"`_ for more " -"details." +"Pass :code:`True` if you require the user's phone number to complete the " +"order" msgstr "" -#: aiogram.client.bot.Bot.send_video:15 of -msgid "Pass :code:`True` if the uploaded video is suitable for streaming" +#: aiogram.client.bot.Bot.create_invoice_link:18 +#: aiogram.client.bot.Bot.send_invoice:21 of +msgid "" +"Pass :code:`True` if you require the user's email address to complete the" +" order" msgstr "" -#: aiogram.client.bot.Bot.send_animation:1 of +#: aiogram.client.bot.Bot.create_invoice_link:19 +#: aiogram.client.bot.Bot.send_invoice:22 of msgid "" -"Use this method to send animation files (GIF or H.264/MPEG-4 AVC video " -"without sound). On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send animation files of up to 50 MB in size, this limit may be changed in" -" the future." +"Pass :code:`True` if you require the user's shipping address to complete " +"the order" msgstr "" -#: aiogram.client.bot.Bot.send_animation:3 of -msgid "Source: https://core.telegram.org/bots/api#sendanimation" +#: aiogram.client.bot.Bot.create_invoice_link:20 of +msgid "" +"Pass :code:`True` if the user's phone number should be sent to the " +"provider" msgstr "" -#: aiogram.client.bot.Bot.send_animation:6 of +#: aiogram.client.bot.Bot.create_invoice_link:21 of msgid "" -"Animation to send. Pass a file_id as String to send an animation that " -"exists on the Telegram servers (recommended), pass an HTTP URL as a " -"String for Telegram to get an animation from the Internet, or upload a " -"new animation using multipart/form-data. :ref:`More information on " -"Sending Files » `" +"Pass :code:`True` if the user's email address should be sent to the " +"provider" msgstr "" -#: aiogram.client.bot.Bot.send_animation:8 of -msgid "Duration of sent animation in seconds" +#: aiogram.client.bot.Bot.create_invoice_link:22 +#: aiogram.client.bot.Bot.send_invoice:25 of +msgid "Pass :code:`True` if the final price depends on the shipping method" msgstr "" -#: aiogram.client.bot.Bot.send_animation:9 of -msgid "Animation width" +#: aiogram.client.bot.Bot.create_invoice_link:24 of +msgid "Returns the created invoice link as *String* on success." msgstr "" -#: aiogram.client.bot.Bot.send_animation:10 of -msgid "Animation height" +#: aiogram.client.bot.Bot.create_new_sticker_set: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." msgstr "" -#: aiogram.client.bot.Bot.send_animation:12 of -msgid "" -"Animation caption (may also be used when resending animation by " -"*file_id*), 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.create_new_sticker_set:3 of +msgid "User identifier of created sticker set owner" msgstr "" -#: aiogram.client.bot.Bot.send_animation:13 of +#: aiogram.client.bot.Bot.create_new_sticker_set:4 of msgid "" -"Mode for parsing entities in the animation caption. See `formatting " -"options `_ for " -"more details." +"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." msgstr "" -#: aiogram.client.bot.Bot.send_voice:1 of -msgid "" -"Use this method to send audio files, if you want Telegram clients to " -"display the file as a playable voice message. For this to work, your " -"audio must be in an .OGG file encoded with OPUS (other formats may be " -"sent as :class:`aiogram.types.audio.Audio` or " -":class:`aiogram.types.document.Document`). On success, the sent " -":class:`aiogram.types.message.Message` is returned. Bots can currently " -"send voice messages of up to 50 MB in size, this limit may be changed in " -"the future." +#: aiogram.client.bot.Bot.create_new_sticker_set:5 of +msgid "Sticker set title, 1-64 characters" msgstr "" -#: aiogram.client.bot.Bot.send_voice:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvoice" +#: aiogram.client.bot.Bot.create_new_sticker_set:10 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." msgstr "" -#: aiogram.client.bot.Bot.send_voice:6 of +#: aiogram.client.bot.Bot.decline_chat_join_request:1 of msgid "" -"Audio 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 » `" +"Use this method to decline a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_voice:8 of -msgid "Voice message caption, 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.delete_chat_photo:1 of +msgid "" +"Use this method to delete a chat photo. Photos can't be changed for " +"private chats. The bot must be an administrator in the chat for this to " +"work and must have the appropriate administrator rights. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_voice:9 of +#: aiogram.client.bot.Bot.delete_chat_sticker_set:1 of msgid "" -"Mode for parsing entities in the voice message caption. See `formatting " -"options `_ for " -"more details." +"Use this method to delete a group sticker set from a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." msgstr "" -#: aiogram.client.bot.Bot.send_voice:11 of -msgid "Duration of the voice message in seconds" +#: aiogram.client.bot.Bot.delete_forum_topic:1 of +msgid "" +"Use this method to delete a forum topic along with all its messages in a " +"forum supergroup chat. The bot must be an administrator in the chat for " +"this to work and must have the *can_delete_messages* administrator " +"rights. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_video_note:1 of +#: aiogram.client.bot.Bot.delete_message:1 +#: aiogram.client.bot.Bot.delete_message:24 of msgid "" -"As of `v.4.0 `_, " -"Telegram clients support rounded square MPEG4 videos of up to 1 minute " -"long. Use this method to send video messages. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Use this method to delete a message, including service messages, with the" +" following limitations:" msgstr "" -#: aiogram.client.bot.Bot.send_video_note:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvideonote" +#: aiogram.client.bot.Bot.delete_message:3 of +msgid "A message can only be deleted if it was sent less than 48 hours ago." msgstr "" -#: aiogram.client.bot.Bot.send_video_note:6 of +#: aiogram.client.bot.Bot.delete_message:5 of msgid "" -"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" +"Service messages about a supergroup, channel, or forum topic creation " +"can't be deleted." msgstr "" -#: aiogram.client.bot.Bot.send_video_note:9 of -msgid "Video width and height, i.e. diameter of the video message" +#: aiogram.client.bot.Bot.delete_message:7 of +msgid "" +"A dice message in a private chat can only be deleted if it was sent more " +"than 24 hours ago." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:1 of +#: aiogram.client.bot.Bot.delete_message:9 of msgid "" -"Use this method to send a group of photos, videos, documents or audios as" -" an album. Documents and audio files can be only grouped in an album with" -" messages of the same type. On success, an array of `Messages " -"`_ that were sent is " -"returned." +"Bots can delete outgoing messages in private chats, groups, and " +"supergroups." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:3 of -msgid "Source: https://core.telegram.org/bots/api#sendmediagroup" +#: aiogram.client.bot.Bot.delete_message:11 of +msgid "Bots can delete incoming messages in private chats." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:6 of +#: aiogram.client.bot.Bot.delete_message:13 of msgid "" -"A JSON-serialized array describing messages to be sent, must include 2-10" -" items" +"Bots granted *can_post_messages* permissions can delete outgoing messages" +" in channels." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:8 of +#: aiogram.client.bot.Bot.delete_message:15 of msgid "" -"Sends messages `silently `_. Users will receive a notification with no sound." +"If the bot is an administrator of a group, it can delete any message " +"there." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:9 of -msgid "Protects the contents of the sent messages from forwarding and saving" +#: aiogram.client.bot.Bot.delete_message:17 of +msgid "" +"If the bot has *can_delete_messages* permission in a supergroup or a " +"channel, it can delete any message there." msgstr "" -#: aiogram.client.bot.Bot.send_media_group:10 of -msgid "If the messages are a reply, ID of the original message" +#: aiogram.client.bot.Bot.delete_message:22 of +msgid "Identifier of the message to delete" msgstr "" -#: aiogram.client.bot.Bot.send_media_group:13 of -msgid "On success, an array of Messages that were sent is returned." +#: aiogram.client.bot.Bot.delete_my_commands:1 of +msgid "" +"Use this method to delete the list of the bot's commands for the given " +"scope and user language. After deletion, `higher level commands " +"`_ will " +"be shown to affected users. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_location:1 of +#: aiogram.client.bot.Bot.delete_my_commands:3 +#: aiogram.client.bot.Bot.set_my_commands:4 of msgid "" -"Use this method to send point on the map. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"A JSON-serialized object, describing scope of users for which the " +"commands are relevant. Defaults to " +":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." msgstr "" -#: aiogram.client.bot.Bot.send_location:3 of -msgid "Source: https://core.telegram.org/bots/api#sendlocation" +#: aiogram.client.bot.Bot.delete_my_commands:4 +#: aiogram.client.bot.Bot.set_my_commands:5 of +msgid "" +"A two-letter ISO 639-1 language code. If empty, commands will be applied " +"to all users from the given scope, for whose language there are no " +"dedicated commands" msgstr "" -#: aiogram.client.bot.Bot.send_location:6 of -msgid "Latitude of the location" +#: aiogram.client.bot.Bot.delete_sticker_from_set:1 of +msgid "" +"Use this method to delete a sticker from a set created by the bot. " +"Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_location:7 of -msgid "Longitude of the location" +#: aiogram.client.bot.Bot.delete_sticker_from_set:3 +#: aiogram.client.bot.Bot.set_sticker_position_in_set:3 of +msgid "File identifier of the sticker" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:10 -#: aiogram.client.bot.Bot.send_location:9 of -msgid "The radius of uncertainty for the location, measured in meters; 0-1500" +#: aiogram.client.bot.Bot.delete_webhook:1 of +msgid "" +"Use this method to remove webhook integration if you decide to switch " +"back to :class:`aiogram.methods.get_updates.GetUpdates`. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.send_location:10 of -msgid "" -"Period in seconds for which the location will be updated (see `Live " -"Locations `_, should be between" -" 60 and 86400." +#: aiogram.client.bot.Bot.delete_webhook:3 +#: aiogram.client.bot.Bot.set_webhook:18 of +msgid "Pass :code:`True` to drop all pending updates" msgstr "" -#: aiogram.client.bot.Bot.send_location:11 of +#: aiogram.client.bot.Bot.edit_chat_invite_link:1 of msgid "" -"For live locations, a direction in which the user is moving, in degrees. " -"Must be between 1 and 360 if specified." +"Use this method to edit a non-primary invite link created by the bot. The" +" bot must be an administrator in the chat for this to work and must have " +"the appropriate administrator rights. Returns the edited invite link as a" +" :class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.send_location:12 of +#: aiogram.client.bot.Bot.edit_chat_invite_link:4 of +msgid "The invite link to edit" +msgstr "" + +#: aiogram.client.bot.Bot.edit_chat_invite_link:10 of msgid "" -"For live locations, a maximum distance for proximity alerts about " -"approaching another chat member, in meters. Must be between 1 and 100000 " -"if specified." +"Returns the edited invite link as a " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:1 of +#: aiogram.client.bot.Bot.edit_forum_topic:1 of msgid "" -"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." +"Use this method to edit name and icon of a topic in a forum supergroup " +"chat. The bot must be an administrator in the chat for this to work and " +"must have *can_manage_topics* administrator rights, unless it is the " +"creator of the topic. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagelivelocation" +#: aiogram.client.bot.Bot.edit_forum_topic:5 of +msgid "New topic name, 1-128 characters" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:5 of -msgid "Latitude of new location" +#: aiogram.client.bot.Bot.edit_forum_topic:6 of +msgid "" +"New unique identifier of the custom emoji shown as the topic icon. Use " +":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +" to get all allowed custom emoji identifiers." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:6 of -msgid "Longitude of new location" +#: aiogram.client.bot.Bot.edit_message_caption:1 of +msgid "" +"Use this method to edit captions of messages. 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." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:5 -#: aiogram.client.bot.Bot.edit_message_live_location:7 -#: aiogram.client.bot.Bot.edit_message_media:6 -#: aiogram.client.bot.Bot.edit_message_reply_markup:5 -#: aiogram.client.bot.Bot.edit_message_text:6 -#: aiogram.client.bot.Bot.stop_message_live_location:5 of +#: aiogram.client.bot.Bot.edit_message_caption:3 +#: aiogram.client.bot.Bot.edit_message_live_location:5 +#: aiogram.client.bot.Bot.edit_message_media:4 +#: aiogram.client.bot.Bot.edit_message_reply_markup:3 +#: aiogram.client.bot.Bot.edit_message_text:4 +#: aiogram.client.bot.Bot.stop_message_live_location:3 of msgid "" "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`)" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:6 -#: aiogram.client.bot.Bot.edit_message_live_location:8 -#: aiogram.client.bot.Bot.edit_message_media:7 -#: aiogram.client.bot.Bot.edit_message_reply_markup:6 -#: aiogram.client.bot.Bot.edit_message_text:7 of +#: aiogram.client.bot.Bot.edit_message_caption:4 +#: aiogram.client.bot.Bot.edit_message_live_location:6 +#: aiogram.client.bot.Bot.edit_message_media:5 +#: aiogram.client.bot.Bot.edit_message_reply_markup:4 +#: aiogram.client.bot.Bot.edit_message_text:5 of msgid "" "Required if *inline_message_id* is not specified. Identifier of the " "message to edit" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:7 -#: aiogram.client.bot.Bot.edit_message_live_location:9 -#: aiogram.client.bot.Bot.edit_message_media:8 -#: aiogram.client.bot.Bot.edit_message_reply_markup:7 -#: aiogram.client.bot.Bot.edit_message_text:8 -#: aiogram.client.bot.Bot.get_game_high_scores:10 -#: aiogram.client.bot.Bot.set_game_score:11 -#: aiogram.client.bot.Bot.stop_message_live_location:7 of +#: aiogram.client.bot.Bot.edit_message_caption:5 +#: aiogram.client.bot.Bot.edit_message_live_location:7 +#: aiogram.client.bot.Bot.edit_message_media:6 +#: aiogram.client.bot.Bot.edit_message_reply_markup:5 +#: aiogram.client.bot.Bot.edit_message_text:6 +#: aiogram.client.bot.Bot.get_game_high_scores:8 +#: aiogram.client.bot.Bot.set_game_score:9 +#: aiogram.client.bot.Bot.stop_message_live_location:5 of msgid "" "Required if *chat_id* and *message_id* are not specified. Identifier of " "the inline message" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:11 of +#: aiogram.client.bot.Bot.edit_message_caption:6 of +msgid "New caption of the message, 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.client.bot.Bot.edit_message_caption:7 of msgid "" -"Direction in which the user is moving, in degrees. Must be between 1 and " -"360 if specified." +"Mode for parsing entities in the message caption. See `formatting options" +" `_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:12 of +#: aiogram.client.bot.Bot.edit_message_caption:8 +#: aiogram.client.bot.Bot.send_animation:12 aiogram.client.bot.Bot.send_audio:9 +#: aiogram.client.bot.Bot.send_document:9 aiogram.client.bot.Bot.send_photo:8 +#: aiogram.client.bot.Bot.send_video:12 aiogram.client.bot.Bot.send_voice:8 of msgid "" -"The maximum distance for proximity alerts about approaching another chat " -"member, in meters. Must be between 1 and 100000 if specified." +"A JSON-serialized list of special entities that appear in the caption, " +"which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.edit_message_live_location:13 -#: aiogram.client.bot.Bot.edit_message_media:9 -#: aiogram.client.bot.Bot.stop_message_live_location:8 of +#: aiogram.client.bot.Bot.edit_message_caption:9 +#: aiogram.client.bot.Bot.edit_message_reply_markup:6 +#: aiogram.client.bot.Bot.edit_message_text:10 of msgid "" -"A JSON-serialized object for a new `inline keyboard " +"A JSON-serialized object for an `inline keyboard " "`_." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:13 -#: aiogram.client.bot.Bot.edit_message_live_location:15 -#: aiogram.client.bot.Bot.edit_message_media:11 -#: aiogram.client.bot.Bot.edit_message_reply_markup:10 -#: aiogram.client.bot.Bot.edit_message_text:14 of +#: aiogram.client.bot.Bot.edit_message_caption:11 +#: aiogram.client.bot.Bot.edit_message_live_location:13 +#: aiogram.client.bot.Bot.edit_message_media:9 +#: aiogram.client.bot.Bot.edit_message_reply_markup:8 +#: aiogram.client.bot.Bot.edit_message_text:12 of msgid "" "On success, if the edited message is not an inline message, the edited " -"Message is returned, otherwise True is returned." +":class:`aiogram.types.message.Message` is returned, otherwise " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.stop_message_live_location:1 of +#: aiogram.client.bot.Bot.edit_message_live_location:1 of msgid "" -"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." -msgstr "" - -#: aiogram.client.bot.Bot.stop_message_live_location:3 of -msgid "Source: https://core.telegram.org/bots/api#stopmessagelivelocation" -msgstr "" - -#: aiogram.client.bot.Bot.stop_message_live_location:6 of -msgid "" -"Required if *inline_message_id* is not specified. Identifier of the " -"message with live location to stop" +"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." msgstr "" -#: aiogram.client.bot.Bot.stop_message_live_location:10 of -msgid "" -"On success, if the message is not an inline message, the edited Message " -"is returned, otherwise True is returned." +#: aiogram.client.bot.Bot.edit_message_live_location:3 of +msgid "Latitude of new location" msgstr "" -#: aiogram.client.bot.Bot.send_venue:1 of -msgid "" -"Use this method to send information about a venue. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +#: aiogram.client.bot.Bot.edit_message_live_location:4 of +msgid "Longitude of new location" msgstr "" -#: aiogram.client.bot.Bot.send_venue:3 of -msgid "Source: https://core.telegram.org/bots/api#sendvenue" +#: aiogram.client.bot.Bot.edit_message_live_location:8 +#: aiogram.client.bot.Bot.send_location:7 of +msgid "The radius of uncertainty for the location, measured in meters; 0-1500" msgstr "" -#: aiogram.client.bot.Bot.send_venue:6 of -msgid "Latitude of the venue" +#: aiogram.client.bot.Bot.edit_message_live_location:9 of +msgid "" +"Direction in which the user is moving, in degrees. Must be between 1 and " +"360 if specified." msgstr "" -#: aiogram.client.bot.Bot.send_venue:7 of -msgid "Longitude of the venue" +#: aiogram.client.bot.Bot.edit_message_live_location:10 of +msgid "" +"The maximum distance for proximity alerts about approaching another chat " +"member, in meters. Must be between 1 and 100000 if specified." msgstr "" -#: aiogram.client.bot.Bot.send_venue:8 of -msgid "Name of the venue" +#: aiogram.client.bot.Bot.edit_message_live_location:11 +#: aiogram.client.bot.Bot.edit_message_media:7 +#: aiogram.client.bot.Bot.stop_message_live_location:6 of +msgid "" +"A JSON-serialized object for a new `inline keyboard " +"`_." msgstr "" -#: aiogram.client.bot.Bot.send_venue:9 of -msgid "Address of the venue" +#: aiogram.client.bot.Bot.edit_message_media:1 of +msgid "" +"Use this method to edit animation, audio, document, photo, or video " +"messages. If a message is part of a message album, then it can be edited " +"only to an audio for audio albums, only to a document for document albums" +" and to a photo or a video otherwise. When an inline message is edited, a" +" new file can't be uploaded; use a previously uploaded file via its " +"file_id or specify a URL. On success, if the edited message is not an " +"inline message, the edited :class:`aiogram.types.message.Message` is " +"returned, otherwise :code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.send_venue:11 of -msgid "Foursquare identifier of the venue" +#: aiogram.client.bot.Bot.edit_message_media:3 of +msgid "A JSON-serialized object for a new media content of the message" msgstr "" -#: aiogram.client.bot.Bot.send_venue:12 of +#: aiogram.client.bot.Bot.edit_message_reply_markup:1 of msgid "" -"Foursquare type of the venue, if known. (For example, " -"'arts_entertainment/default', 'arts_entertainment/aquarium' or " -"'food/icecream'.)" +"Use this method to edit only the reply markup of messages. 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." msgstr "" -#: aiogram.client.bot.Bot.send_venue:13 of -msgid "Google Places identifier of the venue" +#: aiogram.client.bot.Bot.edit_message_text:1 of +msgid "" +"Use this method to edit text and `game " +"`_ messages. 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." msgstr "" -#: aiogram.client.bot.Bot.send_venue:14 of -msgid "" -"Google Places type of the venue. (See `supported types " -"`_.)" +#: aiogram.client.bot.Bot.edit_message_text:3 of +msgid "New text of the message, 1-4096 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.send_contact:1 of +#: aiogram.client.bot.Bot.edit_message_text:7 +#: aiogram.client.bot.Bot.send_message:6 of msgid "" -"Use this method to send phone contacts. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Mode for parsing entities in the message text. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.send_contact:3 of -msgid "Source: https://core.telegram.org/bots/api#sendcontact" +#: aiogram.client.bot.Bot.edit_message_text:8 +#: aiogram.client.bot.Bot.send_message:7 of +msgid "" +"A JSON-serialized list of special entities that appear in message text, " +"which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.send_contact:6 of -msgid "Contact's phone number" +#: aiogram.client.bot.Bot.edit_message_text:9 +#: aiogram.client.bot.Bot.send_message:8 of +msgid "Disables link previews for links in this message" msgstr "" -#: aiogram.client.bot.Bot.send_contact:7 of -msgid "Contact's first name" +#: aiogram.client.bot.Bot.export_chat_invite_link:1 of +msgid "" +"Use this method to generate a new primary invite link for a chat; any " +"previously generated primary link is revoked. The bot must be an " +"administrator in the chat for this to work and must have the appropriate " +"administrator rights. Returns the new invite link as *String* on success." msgstr "" -#: aiogram.client.bot.Bot.send_contact:9 of -msgid "Contact's last name" +#: aiogram.client.bot.Bot.export_chat_invite_link:3 of +msgid "" +"Note: Each administrator in a chat generates their own invite links. Bots" +" can't use invite links generated by other administrators. If you want " +"your bot to work with invite links, it will need to generate its own link" +" using " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or " +"by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your " +"bot needs to generate a new primary invite link replacing its previous " +"one, use " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"again." msgstr "" -#: aiogram.client.bot.Bot.send_contact:10 of +#: aiogram.client.bot.Bot.export_chat_invite_link:7 of msgid "" -"Additional data about the contact in the form of a `vCard " -"`_, 0-2048 bytes" +"If your bot needs to generate a new primary invite link replacing its " +"previous one, use " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"again." msgstr "" -#: aiogram.client.bot.Bot.send_poll:1 of +#: aiogram.client.bot.Bot.forward_message:1 of msgid "" -"Use this method to send a native poll. On success, the sent " -":class:`aiogram.types.message.Message` is returned." +"Use this method to forward messages of any kind. Service messages can't " +"be forwarded. On success, the sent :class:`aiogram.types.message.Message`" +" is returned." msgstr "" -#: aiogram.client.bot.Bot.send_poll:3 of -msgid "Source: https://core.telegram.org/bots/api#sendpoll" +#: aiogram.client.bot.Bot.forward_message:8 of +msgid "Protects the contents of the forwarded message from forwarding and saving" msgstr "" -#: aiogram.client.bot.Bot.send_poll:6 of -msgid "Poll question, 1-300 characters" +#: aiogram.client.bot.Bot.forward_message:10 +#: aiogram.client.bot.Bot.send_contact:15 aiogram.client.bot.Bot.send_dice:12 +#: aiogram.client.bot.Bot.send_game:12 aiogram.client.bot.Bot.send_invoice:32 +#: aiogram.client.bot.Bot.send_location:17 +#: aiogram.client.bot.Bot.send_message:15 aiogram.client.bot.Bot.send_photo:15 +#: aiogram.client.bot.Bot.send_poll:23 aiogram.client.bot.Bot.send_sticker:12 +#: aiogram.client.bot.Bot.send_venue:19 +#: aiogram.client.bot.Bot.send_video_note:15 of +msgid "On success, the sent :class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.send_poll:7 of +#: aiogram.client.bot.Bot.get_chat:1 of msgid "" -"A JSON-serialized list of answer options, 2-10 strings 1-100 characters " -"each" +"Use this method to get up to date information about the chat (current " +"name of the user for one-on-one conversations, current username of a " +"user, group or channel, etc.). Returns a :class:`aiogram.types.chat.Chat`" +" object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:9 of -msgid ":code:`True`, if the poll needs to be anonymous, defaults to :code:`True`" +#: aiogram.client.bot.Bot.get_chat:3 +#: aiogram.client.bot.Bot.get_chat_administrators:3 +#: aiogram.client.bot.Bot.get_chat_member:3 +#: aiogram.client.bot.Bot.get_chat_member_count:3 +#: aiogram.client.bot.Bot.leave_chat:3 of +msgid "" +"Unique identifier for the target chat or username of the target " +"supergroup or channel (in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.send_poll:10 of -msgid "Poll type, 'quiz' or 'regular', defaults to 'regular'" +#: aiogram.client.bot.Bot.get_chat:5 of +msgid "Returns a :class:`aiogram.types.chat.Chat` object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:11 of +#: aiogram.client.bot.Bot.get_chat_administrators:1 of msgid "" -":code:`True`, if the poll allows multiple answers, ignored for polls in " -"quiz mode, defaults to :code:`False`" +"Use this method to get a list of administrators in a chat, which aren't " +"bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` " +"objects." msgstr "" -#: aiogram.client.bot.Bot.send_poll:12 of -msgid "" -"0-based identifier of the correct answer option, required for polls in " -"quiz mode" +#: aiogram.client.bot.Bot.get_chat_administrators:5 of +msgid "Returns an Array of :class:`aiogram.types.chat_member.ChatMember` objects." msgstr "" -#: aiogram.client.bot.Bot.send_poll:13 of +#: aiogram.client.bot.Bot.get_chat_member:1 of msgid "" -"Text that is shown when a user chooses an incorrect answer or taps on the" -" lamp icon in a quiz-style poll, 0-200 characters with at most 2 line " -"feeds after entities parsing" +"Use this method to get information about a member of a chat. Returns a " +":class:`aiogram.types.chat_member.ChatMember` object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:14 of -msgid "" -"Mode for parsing entities in the explanation. See `formatting options " -"`_ for more " -"details." +#: aiogram.client.bot.Bot.get_chat_member:6 of +msgid "Returns a :class:`aiogram.types.chat_member.ChatMember` object on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:15 of +#: aiogram.client.bot.Bot.get_chat_member_count:1 of msgid "" -"A JSON-serialized list of special entities that appear in the poll " -"explanation, which can be specified instead of *parse_mode*" +"Use this method to get the number of members in a chat. Returns *Int* on " +"success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:16 of +#: aiogram.client.bot.Bot.get_chat_member_count:5 of +msgid "Returns *Int* on success." +msgstr "" + +#: aiogram.client.bot.Bot.get_chat_menu_button:1 of msgid "" -"Amount of time in seconds the poll will be active after creation, 5-600. " -"Can't be used together with *close_date*." +"Use this method to get the current value of the bot's menu button in a " +"private chat, or the default menu button. Returns " +":class:`aiogram.types.menu_button.MenuButton` on success." msgstr "" -#: aiogram.client.bot.Bot.send_poll:17 of +#: aiogram.client.bot.Bot.get_chat_menu_button:3 of msgid "" -"Point in time (Unix timestamp) when the poll will be automatically " -"closed. Must be at least 5 and no more than 600 seconds in the future. " -"Can't be used together with *open_period*." +"Unique identifier for the target private chat. If not specified, default " +"bot's menu button will be returned" msgstr "" -#: aiogram.client.bot.Bot.send_poll:18 of +#: aiogram.client.bot.Bot.get_chat_menu_button:5 of +msgid "Returns :class:`aiogram.types.menu_button.MenuButton` on success." +msgstr "" + +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:1 of msgid "" -"Pass :code:`True` if the poll needs to be immediately closed. This can be" -" useful for poll preview." +"Use this method to get information about custom emoji stickers by their " +"identifiers. Returns an Array of :class:`aiogram.types.sticker.Sticker` " +"objects." msgstr "" -#: aiogram.client.bot.Bot.send_dice:1 of +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:3 of msgid "" -"Use this method to send an animated emoji that will display a random " -"value. On success, the sent :class:`aiogram.types.message.Message` is " -"returned." +"List of custom emoji identifiers. At most 200 custom emoji identifiers " +"can be specified." msgstr "" -#: aiogram.client.bot.Bot.send_dice:3 of -msgid "Source: https://core.telegram.org/bots/api#senddice" +#: aiogram.client.bot.Bot.get_custom_emoji_stickers:5 +#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:4 of +msgid "Returns an Array of :class:`aiogram.types.sticker.Sticker` objects." msgstr "" -#: aiogram.client.bot.Bot.send_dice:7 of +#: aiogram.client.bot.Bot.get_file:1 of msgid "" -"Emoji on which the dice throw animation is based. Currently, must be one " -"of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯'" -" and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults " -"to '🎲'" +"Use this method to get basic information about a file and prepare it for " +"downloading. For the moment, bots can download files of up to 20MB in " +"size. On success, a :class:`aiogram.types.file.File` object is returned. " +"The file can then be downloaded via the link " +":code:`https://api.telegram.org/file/bot/`, where " +":code:`` is taken from the response. It is guaranteed that the" +" link will be valid for at least 1 hour. When the link expires, a new one" +" can be requested by calling :class:`aiogram.methods.get_file.GetFile` " +"again. **Note:** This function may not preserve the original file name " +"and MIME type. You should save the file's MIME type and name (if " +"available) when the File object is received." msgstr "" -#: aiogram.client.bot.Bot.send_dice:9 of -msgid "Protects the contents of the sent message from forwarding" +#: aiogram.client.bot.Bot.get_file:4 of +msgid "File identifier to get information about" msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:1 of +#: aiogram.client.bot.Bot.get_file:6 of msgid "" -"Use this method when you need to tell the user that something is " -"happening on the bot's side. The status is set for 5 seconds or less " -"(when a message arrives from your bot, Telegram clients clear its typing " -"status). Returns :code:`True` on success." +"You should save the file's MIME type and name (if available) when the " +"File object is received." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:3 of +#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:1 of msgid "" -"Example: The `ImageBot `_ needs some time to " -"process a request and upload the image. Instead of sending a text message" -" along the lines of 'Retrieving image, please wait…', the bot may use " -":class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = " -"*upload_photo*. The user will see a 'sending photo' status for the bot." +"Use this method to get custom emoji stickers, which can be used as a " +"forum topic icon by any user. Requires no parameters. Returns an Array of" +" :class:`aiogram.types.sticker.Sticker` objects." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:5 of +#: aiogram.client.bot.Bot.get_game_high_scores:1 of msgid "" -"We only recommend using this method when a response from the bot will " -"take a **noticeable** amount of time to arrive." +"Use this method to get data for high score tables. Will return the score " +"of the specified user and several of their neighbors in a game. Returns " +"an Array of :class:`aiogram.types.game_high_score.GameHighScore` objects." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:7 of -msgid "Source: https://core.telegram.org/bots/api#sendchataction" +#: aiogram.client.bot.Bot.get_game_high_scores:3 of +msgid "" +"This method will currently return scores for the target user, plus two of" +" their closest neighbors on each side. Will also return the top three " +"users if the user and their neighbors are not among them. Please note " +"that this behavior is subject to change." msgstr "" -#: aiogram.client.bot.Bot.send_chat_action:10 of -msgid "" -"Type of action to broadcast. Choose one, depending on what the user is " -"about to receive: *typing* for `text messages " -"`_, *upload_photo* for " -"`photos `_, *record_video* " -"or *upload_video* for `videos " -"`_, *record_voice* or " -"*upload_voice* for `voice notes " -"`_, *upload_document* for " -"`general files `_, " -"*choose_sticker* for `stickers " -"`_, *find_location* for " -"`location data `_, " -"*record_video_note* or *upload_video_note* for `video notes " -"`_." +#: aiogram.client.bot.Bot.get_game_high_scores:5 of +msgid "Target user id" msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:1 of +#: aiogram.client.bot.Bot.get_game_high_scores:6 +#: aiogram.client.bot.Bot.set_game_score:7 of msgid "" -"Use this method to get a list of profile pictures for a user. Returns a " -":class:`aiogram.types.user_profile_photos.UserProfilePhotos` object." +"Required if *inline_message_id* is not specified. Unique identifier for " +"the target chat" msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:3 of -msgid "Source: https://core.telegram.org/bots/api#getuserprofilephotos" +#: aiogram.client.bot.Bot.get_game_high_scores:7 +#: aiogram.client.bot.Bot.set_game_score:8 of +msgid "" +"Required if *inline_message_id* is not specified. Identifier of the sent " +"message" msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:6 -#: aiogram.client.bot.Bot.ban_chat_member:6 -#: aiogram.client.bot.Bot.decline_chat_join_request:6 -#: aiogram.client.bot.Bot.get_chat_member:6 -#: aiogram.client.bot.Bot.get_user_profile_photos:5 -#: aiogram.client.bot.Bot.kick_chat_member:10 -#: aiogram.client.bot.Bot.promote_chat_member:6 -#: aiogram.client.bot.Bot.restrict_chat_member:6 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:6 -#: aiogram.client.bot.Bot.unban_chat_member:6 of -msgid "Unique identifier of the target user" +#: aiogram.client.bot.Bot.get_game_high_scores:10 of +msgid "Please note that this behavior is subject to change." msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:6 of +#: aiogram.client.bot.Bot.get_me:1 of msgid "" -"Sequential number of the first photo to be returned. By default, all " -"photos are returned." +"A simple method for testing your bot's authentication token. Requires no " +"parameters. Returns basic information about the bot in form of a " +":class:`aiogram.types.user.User` object." msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:7 of +#: aiogram.client.bot.Bot.get_me:4 of msgid "" -"Limits the number of photos to be retrieved. Values between 1-100 are " -"accepted. Defaults to 100." +"Returns basic information about the bot in form of a " +":class:`aiogram.types.user.User` object." msgstr "" -#: aiogram.client.bot.Bot.get_user_profile_photos:9 of -msgid "Returns a UserProfilePhotos object." +#: aiogram.client.bot.Bot.get_my_commands:1 of +msgid "" +"Use this method to get the current list of the bot's commands for the " +"given scope and user language. Returns an Array of " +":class:`aiogram.types.bot_command.BotCommand` objects. If commands aren't" +" set, an empty list is returned." msgstr "" -#: aiogram.client.bot.Bot.get_file:1 of +#: aiogram.client.bot.Bot.get_my_commands:3 of msgid "" -"Use this method to get basic information about a file and prepare it for " -"downloading. For the moment, bots can download files of up to 20MB in " -"size. On success, a :class:`aiogram.types.file.File` object is returned. " -"The file can then be downloaded via the link " -":code:`https://api.telegram.org/file/bot/`, where " -":code:`` is taken from the response. It is guaranteed that the" -" link will be valid for at least 1 hour. When the link expires, a new one" -" can be requested by calling :class:`aiogram.methods.get_file.GetFile` " -"again. **Note:** This function may not preserve the original file name " -"and MIME type. You should save the file's MIME type and name (if " -"available) when the File object is received." +"A JSON-serialized object, describing scope of users. Defaults to " +":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." msgstr "" -#: aiogram.client.bot.Bot.get_file:4 of -msgid "Source: https://core.telegram.org/bots/api#getfile" +#: aiogram.client.bot.Bot.get_my_commands:4 of +msgid "A two-letter ISO 639-1 language code or an empty string" msgstr "" -#: aiogram.client.bot.Bot.get_file:6 of -msgid "File identifier to get information about" +#: aiogram.client.bot.Bot.get_my_commands:6 of +msgid "If commands aren't set, an empty list is returned." msgstr "" -#: aiogram.client.bot.Bot.get_file:8 of -msgid "On success, a File object is returned." +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:1 of +msgid "" +"Use this method to get the current default administrator rights of the " +"bot. Returns " +":class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` " +"on success." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:1 -#: aiogram.client.bot.Bot.kick_chat_member:5 of +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:3 of msgid "" -"Use this method to ban a user in a group, a supergroup or a channel. In " -"the case of supergroups and channels, the user will not be able to return" -" to the chat on their own using invite links, etc., unless `unbanned " -"`_ first. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Returns :code:`True` on success." +"Pass :code:`True` to get default administrator rights of the bot in " +"channels. Otherwise, default administrator rights of the bot for groups " +"and supergroups will be returned." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:3 -#: aiogram.client.bot.Bot.kick_chat_member:7 of -msgid "Source: https://core.telegram.org/bots/api#banchatmember" +#: aiogram.client.bot.Bot.get_my_default_administrator_rights:5 of +msgid "" +"Returns " +":class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` " +"on success." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:5 -#: aiogram.client.bot.Bot.kick_chat_member:9 -#: aiogram.client.bot.Bot.unban_chat_member:5 of +#: aiogram.client.bot.Bot.get_sticker_set:1 of msgid "" -"Unique identifier for the target group or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" +"Use this method to get a sticker set. On success, a " +":class:`aiogram.types.sticker_set.StickerSet` object is returned." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:7 -#: aiogram.client.bot.Bot.kick_chat_member:11 of +#: aiogram.client.bot.Bot.get_sticker_set:3 of +msgid "Name of the sticker set" +msgstr "" + +#: aiogram.client.bot.Bot.get_sticker_set:5 of msgid "" -"Date when the user will be unbanned, unix time. If user is banned for " -"more than 366 days or less than 30 seconds from the current time they are" -" considered to be banned forever. Applied for supergroups and channels " -"only." +"On success, a :class:`aiogram.types.sticker_set.StickerSet` object is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:8 -#: aiogram.client.bot.Bot.kick_chat_member:12 of +#: aiogram.client.bot.Bot.get_updates:1 of msgid "" -"Pass :code:`True` to delete all messages from the chat for the user that " -"is being removed. If :code:`False`, the user will be able to see messages" -" in the group that were sent before the user was removed. Always " -":code:`True` for supergroups and channels." +"Use this method to receive incoming updates using long polling (`wiki " +"`_). Returns " +"an Array of :class:`aiogram.types.update.Update` objects." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_member:10 -#: aiogram.client.bot.Bot.kick_chat_member:14 of +#: aiogram.client.bot.Bot.get_updates:3 aiogram.client.bot.Bot.set_webhook:4 of +msgid "**Notes**" +msgstr "" + +#: aiogram.client.bot.Bot.get_updates:5 of +msgid "**1.** This method will not work if an outgoing webhook is set up." +msgstr "" + +#: aiogram.client.bot.Bot.get_updates:7 of msgid "" -"In the case of supergroups and channels, the user will not be able to " -"return to the chat on their own using invite links, etc. Returns True on " -"success." +"**2.** In order to avoid getting duplicate updates, recalculate *offset* " +"after each server response." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:1 of +#: aiogram.client.bot.Bot.get_updates:9 of msgid "" -"Use this method to unban a previously banned user in a supergroup or " -"channel. The user will **not** return to the group or channel " -"automatically, but will be able to join via link, etc. The bot must be an" -" administrator for this to work. By default, this method guarantees that " -"after the call the user is not a member of the chat, but will be able to " -"join it. So if the user is a member of the chat they will also be " -"**removed** from the chat. If you don't want this, use the parameter " -"*only_if_banned*. Returns :code:`True` on success." +"Identifier of the first update to be returned. Must be greater by one " +"than the highest among the identifiers of previously received updates. By" +" default, updates starting with the earliest unconfirmed update are " +"returned. An update is considered confirmed as soon as " +":class:`aiogram.methods.get_updates.GetUpdates` is called with an " +"*offset* higher than its *update_id*. The negative offset can be " +"specified to retrieve updates starting from *-offset* update from the end" +" of the updates queue. All previous updates will forgotten." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#unbanchatmember" +#: aiogram.client.bot.Bot.get_updates:10 of +msgid "" +"Limits the number of updates to be retrieved. Values between 1-100 are " +"accepted. Defaults to 100." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:7 of -msgid "Do nothing if the user is not banned" +#: aiogram.client.bot.Bot.get_updates:11 of +msgid "" +"Timeout in seconds for long polling. Defaults to 0, i.e. usual short " +"polling. Should be positive, short polling should be used for testing " +"purposes only." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_member:9 of +#: aiogram.client.bot.Bot.get_updates:12 aiogram.client.bot.Bot.set_webhook:17 +#: of msgid "" -"The user will not return to the group or channel automatically, but will " -"be able to join via link, etc. Returns True on success." +"A JSON-serialized list of the update types you want your bot to receive. " +"For example, specify ['message', 'edited_channel_post', 'callback_query']" +" to only receive updates of these types. See " +":class:`aiogram.types.update.Update` for a complete list of available " +"update types. Specify an empty list to receive all update types except " +"*chat_member* (default). If not specified, the previous setting will be " +"used." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:1 of +#: aiogram.client.bot.Bot.get_updates:14 of +msgid "Returns an Array of :class:`aiogram.types.update.Update` objects." +msgstr "" + +#: aiogram.client.bot.Bot.get_user_profile_photos:1 of msgid "" -"Use this method to restrict a user in a supergroup. The bot must be an " -"administrator in the supergroup for this to work and must have the " -"appropriate administrator rights. Pass :code:`True` for all permissions " -"to lift restrictions from a user. Returns :code:`True` on success." +"Use this method to get a list of profile pictures for a user. Returns a " +":class:`aiogram.types.user_profile_photos.UserProfilePhotos` object." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#restrictchatmember" +#: aiogram.client.bot.Bot.get_user_profile_photos:4 of +msgid "" +"Sequential number of the first photo to be returned. By default, all " +"photos are returned." msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:5 -#: aiogram.client.bot.Bot.create_forum_topic:5 -#: aiogram.client.bot.Bot.delete_chat_sticker_set:5 -#: aiogram.client.bot.Bot.delete_forum_topic:5 -#: aiogram.client.bot.Bot.edit_forum_topic:5 -#: aiogram.client.bot.Bot.reopen_forum_topic:5 -#: aiogram.client.bot.Bot.restrict_chat_member:5 -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:5 -#: aiogram.client.bot.Bot.set_chat_permissions:5 -#: aiogram.client.bot.Bot.set_chat_sticker_set:5 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:5 of +#: aiogram.client.bot.Bot.get_user_profile_photos:5 of msgid "" -"Unique identifier for the target chat or username of the target " -"supergroup (in the format :code:`@supergroupusername`)" +"Limits the number of photos to be retrieved. Values between 1-100 are " +"accepted. Defaults to 100." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:7 of -msgid "A JSON-serialized object for new user permissions" +#: aiogram.client.bot.Bot.get_user_profile_photos:7 of +msgid "" +"Returns a :class:`aiogram.types.user_profile_photos.UserProfilePhotos` " +"object." msgstr "" -#: aiogram.client.bot.Bot.restrict_chat_member:8 of +#: aiogram.client.bot.Bot.get_webhook_info:1 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" +"Use this method to get current webhook status. Requires no parameters. On" +" success, returns a :class:`aiogram.types.webhook_info.WebhookInfo` " +"object. If the bot is using " +":class:`aiogram.methods.get_updates.GetUpdates`, will return an object " +"with the *url* field empty." +msgstr "" + +#: aiogram.client.bot.Bot.get_webhook_info:4 of +msgid "" +"If the bot is using :class:`aiogram.methods.get_updates.GetUpdates`, will" +" return an object with the *url* field empty." +msgstr "" + +#: aiogram.client.bot.Bot.leave_chat:1 of +msgid "" +"Use this method for your bot to leave a group, supergroup or channel. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.log_out:1 of +msgid "" +"Use this method to log out from the cloud Bot API server before launching" +" the bot locally. You **must** log out the bot before running it locally," +" otherwise there is no guarantee that the bot will receive updates. After" +" a successful call, you can immediately log in on a local server, but " +"will not be able to log in back to the cloud Bot API server for 10 " +"minutes. Returns :code:`True` on success. Requires no parameters." +msgstr "" + +#: aiogram.client.bot.Bot.pin_chat_message:1 of +msgid "" +"Use this method to add a message to the list of pinned messages in a " +"chat. If the chat is not a private chat, the bot must be an administrator" +" in the chat for this to work and must have the 'can_pin_messages' " +"administrator right in a supergroup or 'can_edit_messages' administrator " +"right in a channel. Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.pin_chat_message:4 of +msgid "Identifier of a message to pin" +msgstr "" + +#: aiogram.client.bot.Bot.pin_chat_message:5 of +msgid "" +"Pass :code:`True` if it is not necessary to send a notification to all " +"chat members about the new pinned message. Notifications are always " +"disabled in channels and private chats." msgstr "" #: aiogram.client.bot.Bot.promote_chat_member:1 of @@ -1804,15 +2011,11 @@ msgid "" "boolean parameters to demote a user. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#promotechatmember" -msgstr "" - -#: aiogram.client.bot.Bot.promote_chat_member:7 of +#: aiogram.client.bot.Bot.promote_chat_member:5 of msgid "Pass :code:`True` if the administrator's presence in the chat is hidden" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:8 of +#: aiogram.client.bot.Bot.promote_chat_member:6 of msgid "" "Pass :code:`True` if the administrator can access the chat event log, " "chat statistics, message statistics in channels, see channel members, see" @@ -1820,33 +2023,33 @@ msgid "" " any other administrator privilege" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:9 of +#: aiogram.client.bot.Bot.promote_chat_member:7 of msgid "" "Pass :code:`True` if the administrator can create channel posts, channels" " only" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:10 of +#: aiogram.client.bot.Bot.promote_chat_member:8 of msgid "" "Pass :code:`True` if the administrator can edit messages of other users " "and can pin messages, channels only" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:11 of +#: aiogram.client.bot.Bot.promote_chat_member:9 of msgid "Pass :code:`True` if the administrator can delete messages of other users" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:12 of +#: aiogram.client.bot.Bot.promote_chat_member:10 of msgid "Pass :code:`True` if the administrator can manage video chats" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:13 of +#: aiogram.client.bot.Bot.promote_chat_member:11 of msgid "" "Pass :code:`True` if the administrator can restrict, ban or unban chat " "members" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:14 of +#: aiogram.client.bot.Bot.promote_chat_member:12 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 " @@ -1854,736 +2057,772 @@ msgid "" "appointed by him)" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:15 of +#: aiogram.client.bot.Bot.promote_chat_member:13 of msgid "" "Pass :code:`True` if the administrator can change chat title, photo and " "other settings" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:16 of +#: aiogram.client.bot.Bot.promote_chat_member:14 of msgid "Pass :code:`True` if the administrator can invite new users to the chat" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:17 of +#: aiogram.client.bot.Bot.promote_chat_member:15 of msgid "Pass :code:`True` if the administrator can pin messages, supergroups only" msgstr "" -#: aiogram.client.bot.Bot.promote_chat_member:18 of +#: aiogram.client.bot.Bot.promote_chat_member:16 of msgid "" "Pass :code:`True` if the user is allowed to create, rename, close, and " "reopen forum topics, supergroups only" msgstr "" -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:1 of +#: aiogram.client.bot.Bot.reopen_forum_topic:1 of msgid "" -"Use this method to set a custom title for an administrator in a " -"supergroup promoted by the bot. Returns :code:`True` on success." -msgstr "" - -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle" +"Use this method to reopen a closed topic in a forum supergroup chat. The " +"bot must be an administrator in the chat for this to work and must have " +"the *can_manage_topics* administrator rights, unless it is the creator of" +" the topic. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:7 of +#: aiogram.client.bot.Bot.restrict_chat_member:1 of msgid "" -"New custom title for the administrator; 0-16 characters, emoji are not " -"allowed" +"Use this method to restrict a user in a supergroup. The bot must be an " +"administrator in the supergroup for this to work and must have the " +"appropriate administrator rights. Pass :code:`True` for all permissions " +"to lift restrictions from a user. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.ban_chat_sender_chat:1 of -msgid "" -"Use this method to ban a channel chat in a supergroup or a channel. Until" -" the chat is `unbanned " -"`_, the owner of " -"the banned chat won't be able to send messages on behalf of **any of " -"their channels**. The bot must be an administrator in the supergroup or " -"channel for this to work and must have the appropriate administrator " -"rights. Returns :code:`True` on success." +#: aiogram.client.bot.Bot.restrict_chat_member:5 of +msgid "A JSON-serialized object for new user permissions" msgstr "" -#: aiogram.client.bot.Bot.ban_chat_sender_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#banchatsenderchat" +#: aiogram.client.bot.Bot.restrict_chat_member:6 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.client.bot.Bot.ban_chat_sender_chat:6 -#: aiogram.client.bot.Bot.unban_chat_sender_chat:6 of -msgid "Unique identifier of the target sender chat" +#: aiogram.client.bot.Bot.revoke_chat_invite_link:1 of +msgid "" +"Use this method to revoke an invite link created by the bot. If the " +"primary link is revoked, a new link is automatically generated. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns the revoked invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.unban_chat_sender_chat:1 of +#: aiogram.client.bot.Bot.revoke_chat_invite_link:3 of msgid "" -"Use this method to unban a previously banned channel chat in a supergroup" -" or channel. The bot must be an administrator for this to work and must " -"have the appropriate administrator rights. Returns :code:`True` on " -"success." +"Unique identifier of the target chat or username of the target channel " +"(in the format :code:`@channelusername`)" msgstr "" -#: aiogram.client.bot.Bot.unban_chat_sender_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#unbanchatsenderchat" +#: aiogram.client.bot.Bot.revoke_chat_invite_link:4 of +msgid "The invite link to revoke" msgstr "" -#: aiogram.client.bot.Bot.set_chat_permissions:1 of +#: aiogram.client.bot.Bot.revoke_chat_invite_link:6 of msgid "" -"Use this method to set default chat permissions for all members. The bot " -"must be an administrator in the group or a supergroup for this to work " -"and must have the *can_restrict_members* administrator rights. Returns " -":code:`True` on success." -msgstr "" - -#: aiogram.client.bot.Bot.set_chat_permissions:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatpermissions" +"Returns the revoked invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." msgstr "" -#: aiogram.client.bot.Bot.set_chat_permissions:6 of -msgid "A JSON-serialized object for new default chat permissions" +#: aiogram.client.bot.Bot.send_animation:1 of +msgid "" +"Use this method to send animation files (GIF or H.264/MPEG-4 AVC video " +"without sound). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send animation files of up to 50 MB in size, this limit may be changed in" +" the future." msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_animation:4 of msgid "" -"Use this method to generate a new primary invite link for a chat; any " -"previously generated primary link is revoked. The bot must be an " -"administrator in the chat for this to work and must have the appropriate " -"administrator rights. Returns the new invite link as *String* on success." +"Animation to send. Pass a file_id as String to send an animation that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an animation from the Internet, or upload a " +"new animation using multipart/form-data. :ref:`More information on " +"Sending Files » `" msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:3 of -msgid "" -"Note: Each administrator in a chat generates their own invite links. Bots" -" can't use invite links generated by other administrators. If you want " -"your bot to work with invite links, it will need to generate its own link" -" using " -":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or " -"by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your " -"bot needs to generate a new primary invite link replacing its previous " -"one, use " -":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " -"again." +#: aiogram.client.bot.Bot.send_animation:6 of +msgid "Duration of sent animation in seconds" msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:5 of -msgid "Source: https://core.telegram.org/bots/api#exportchatinvitelink" +#: aiogram.client.bot.Bot.send_animation:7 of +msgid "Animation width" msgstr "" -#: aiogram.client.bot.Bot.export_chat_invite_link:9 of -msgid "Returns the new invite link as String on success." +#: aiogram.client.bot.Bot.send_animation:8 of +msgid "Animation height" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_animation:9 aiogram.client.bot.Bot.send_audio:13 +#: aiogram.client.bot.Bot.send_document:6 aiogram.client.bot.Bot.send_video:9 +#: aiogram.client.bot.Bot.send_video_note:8 of msgid "" -"Use this method to create an additional invite link for a chat. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. The link can be revoked using the " -"method " -":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. " -"Returns the new invite link as " -":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +"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 » `" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:3 of -msgid "Source: https://core.telegram.org/bots/api#createchatinvitelink" +#: aiogram.client.bot.Bot.send_animation:10 of +msgid "" +"Animation caption (may also be used when resending animation by " +"*file_id*), 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:6 -#: aiogram.client.bot.Bot.edit_chat_invite_link:7 of -msgid "Invite link name; 0-32 characters" +#: aiogram.client.bot.Bot.send_animation:11 of +msgid "" +"Mode for parsing entities in the animation caption. See `formatting " +"options `_ for " +"more details." msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:7 -#: aiogram.client.bot.Bot.edit_chat_invite_link:8 of -msgid "Point in time (Unix timestamp) when the link will expire" +#: aiogram.client.bot.Bot.send_animation:19 of +msgid "" +"Bots can currently send animation files of up to 50 MB in size, this " +"limit may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:8 -#: aiogram.client.bot.Bot.edit_chat_invite_link:9 of +#: aiogram.client.bot.Bot.send_audio:1 of msgid "" -"The maximum number of users that can be members of the chat " -"simultaneously after joining the chat via this invite link; 1-99999" +"Use this method to send audio files, if you want Telegram clients to " +"display them in the music player. Your audio must be in the .MP3 or .M4A " +"format. On success, the sent :class:`aiogram.types.message.Message` is " +"returned. Bots can currently send audio files of up to 50 MB in size, " +"this limit may be changed in the future. For sending voice messages, use " +"the :class:`aiogram.methods.send_voice.SendVoice` method instead." msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:9 -#: aiogram.client.bot.Bot.edit_chat_invite_link:10 of +#: aiogram.client.bot.Bot.send_audio:5 of msgid "" -":code:`True`, if users joining the chat via the link need to be approved " -"by chat administrators. If :code:`True`, *member_limit* can't be " -"specified" +"Audio file to send. Pass a file_id as String to send an audio file that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an audio file from the Internet, or upload a " +"new one using multipart/form-data. :ref:`More information on Sending " +"Files » `" msgstr "" -#: aiogram.client.bot.Bot.create_chat_invite_link:11 of -msgid "Returns the new invite link as ChatInviteLink object." +#: aiogram.client.bot.Bot.send_audio:7 of +msgid "Audio caption, 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_audio:8 of msgid "" -"Use this method to edit a non-primary invite link created by the bot. The" -" bot must be an administrator in the chat for this to work and must have " -"the appropriate administrator rights. Returns the edited invite link as a" -" :class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +"Mode for parsing entities in the audio caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:3 of -msgid "Source: https://core.telegram.org/bots/api#editchatinvitelink" +#: aiogram.client.bot.Bot.send_audio:10 of +msgid "Duration of the audio in seconds" msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:6 of -msgid "The invite link to edit" +#: aiogram.client.bot.Bot.send_audio:11 of +msgid "Performer" msgstr "" -#: aiogram.client.bot.Bot.edit_chat_invite_link:12 of -msgid "Returns the edited invite link as a ChatInviteLink object." +#: aiogram.client.bot.Bot.send_audio:12 of +msgid "Track name" msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:1 of +#: aiogram.client.bot.Bot.send_audio:20 of msgid "" -"Use this method to revoke an invite link created by the bot. If the " -"primary link is revoked, a new link is automatically generated. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Returns the revoked invite link as " -":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +"Bots can currently send audio files of up to 50 MB in size, this limit " +"may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:3 of -msgid "Source: https://core.telegram.org/bots/api#revokechatinvitelink" -msgstr "" - -#: aiogram.client.bot.Bot.revoke_chat_invite_link:5 of +#: aiogram.client.bot.Bot.send_chat_action:1 of msgid "" -"Unique identifier of the target chat or username of the target channel " -"(in the format :code:`@channelusername`)" +"Use this method when you need to tell the user that something is " +"happening on the bot's side. The status is set for 5 seconds or less " +"(when a message arrives from your bot, Telegram clients clear its typing " +"status). Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:6 of -msgid "The invite link to revoke" +#: aiogram.client.bot.Bot.send_chat_action:3 of +msgid "" +"Example: The `ImageBot `_ needs some time to " +"process a request and upload the image. Instead of sending a text message" +" along the lines of 'Retrieving image, please wait…', the bot may use " +":class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = " +"*upload_photo*. The user will see a 'sending photo' status for the bot." msgstr "" -#: aiogram.client.bot.Bot.revoke_chat_invite_link:8 of -msgid "Returns the revoked invite link as ChatInviteLink object." +#: aiogram.client.bot.Bot.send_chat_action:5 of +msgid "" +"We only recommend using this method when a response from the bot will " +"take a **noticeable** amount of time to arrive." msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:1 of +#: aiogram.client.bot.Bot.send_chat_action:8 of msgid "" -"Use this method to approve a chat join request. The bot must be an " -"administrator in the chat for this to work and must have the " -"*can_invite_users* administrator right. Returns :code:`True` on success." +"Type of action to broadcast. Choose one, depending on what the user is " +"about to receive: *typing* for `text messages " +"`_, *upload_photo* for " +"`photos `_, *record_video* " +"or *upload_video* for `videos " +"`_, *record_voice* or " +"*upload_voice* for `voice notes " +"`_, *upload_document* for " +"`general files `_, " +"*choose_sticker* for `stickers " +"`_, *find_location* for " +"`location data `_, " +"*record_video_note* or *upload_video_note* for `video notes " +"`_." msgstr "" -#: aiogram.client.bot.Bot.approve_chat_join_request:3 of -msgid "Source: https://core.telegram.org/bots/api#approvechatjoinrequest" +#: aiogram.client.bot.Bot.send_chat_action:10 of +msgid "The user will see a 'sending photo' status for the bot." msgstr "" -#: aiogram.client.bot.Bot.decline_chat_join_request:1 of +#: aiogram.client.bot.Bot.send_contact:1 of msgid "" -"Use this method to decline a chat join request. The bot must be an " -"administrator in the chat for this to work and must have the " -"*can_invite_users* administrator right. Returns :code:`True` on success." -msgstr "" - -#: aiogram.client.bot.Bot.decline_chat_join_request:3 of -msgid "Source: https://core.telegram.org/bots/api#declinechatjoinrequest" +"Use this method to send phone contacts. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_photo:1 of -msgid "" -"Use this method to set a new profile photo for the chat. Photos can't be " -"changed for private chats. The bot must be an administrator in the chat " -"for this to work and must have the appropriate administrator rights. " -"Returns :code:`True` on success." +#: aiogram.client.bot.Bot.send_contact:4 of +msgid "Contact's phone number" msgstr "" -#: aiogram.client.bot.Bot.set_chat_photo:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatphoto" +#: aiogram.client.bot.Bot.send_contact:5 of +msgid "Contact's first name" msgstr "" -#: aiogram.client.bot.Bot.set_chat_photo:6 of -msgid "New chat photo, uploaded using multipart/form-data" +#: aiogram.client.bot.Bot.send_contact:7 of +msgid "Contact's last name" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_photo:1 of +#: aiogram.client.bot.Bot.send_contact:8 of msgid "" -"Use this method to delete a chat photo. Photos can't be changed for " -"private chats. The bot must be an administrator in the chat for this to " -"work and must have the appropriate administrator rights. Returns " -":code:`True` on success." +"Additional data about the contact in the form of a `vCard " +"`_, 0-2048 bytes" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_photo:3 of -msgid "Source: https://core.telegram.org/bots/api#deletechatphoto" +#: aiogram.client.bot.Bot.send_dice:1 of +msgid "" +"Use this method to send an animated emoji that will display a random " +"value. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_title:1 of +#: aiogram.client.bot.Bot.send_dice:5 of msgid "" -"Use this method to change the title of a chat. Titles can't be changed " -"for private chats. The bot must be an administrator in the chat for this " -"to work and must have the appropriate administrator rights. Returns " -":code:`True` on success." +"Emoji on which the dice throw animation is based. Currently, must be one " +"of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯'" +" and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults " +"to '🎲'" msgstr "" -#: aiogram.client.bot.Bot.set_chat_title:3 of -msgid "Source: https://core.telegram.org/bots/api#setchattitle" +#: aiogram.client.bot.Bot.send_dice:7 of +msgid "Protects the contents of the sent message from forwarding" msgstr "" -#: aiogram.client.bot.Bot.set_chat_title:6 of -msgid "New chat title, 1-128 characters" +#: aiogram.client.bot.Bot.send_document:1 of +msgid "" +"Use this method to send general files. On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send files of any type of up to 50 MB in size, this limit may be changed " +"in the future." msgstr "" -#: aiogram.client.bot.Bot.set_chat_description:1 of +#: aiogram.client.bot.Bot.send_document:4 of msgid "" -"Use this method to change the description of a group, a supergroup or a " -"channel. The bot must be an administrator in the chat for this to work " -"and must have the appropriate administrator rights. Returns :code:`True` " -"on success." +"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 » `" msgstr "" -#: aiogram.client.bot.Bot.set_chat_description:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatdescription" +#: aiogram.client.bot.Bot.send_document:7 of +msgid "" +"Document caption (may also be used when resending documents by " +"*file_id*), 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.set_chat_description:6 of -msgid "New chat description, 0-255 characters" +#: aiogram.client.bot.Bot.send_document:8 of +msgid "" +"Mode for parsing entities in the document caption. See `formatting " +"options `_ for " +"more details." msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:1 of +#: aiogram.client.bot.Bot.send_document:10 of msgid "" -"Use this method to add a message to the list of pinned messages in a " -"chat. If the chat is not a private chat, the bot must be an administrator" -" in the chat for this to work and must have the 'can_pin_messages' " -"administrator right in a supergroup or 'can_edit_messages' administrator " -"right in a channel. Returns :code:`True` on success." +"Disables automatic server-side content type detection for files uploaded " +"using multipart/form-data" msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:3 of -msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +#: aiogram.client.bot.Bot.send_document:17 of +msgid "" +"Bots can currently send files of any type of up to 50 MB in size, this " +"limit may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:6 of -msgid "Identifier of a message to pin" +#: aiogram.client.bot.Bot.send_game:1 of +msgid "" +"Use this method to send a game. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.pin_chat_message:7 of -msgid "" -"Pass :code:`True` if it is not necessary to send a notification to all " -"chat members about the new pinned message. Notifications are always " -"disabled in channels and private chats." +#: aiogram.client.bot.Bot.send_game:3 of +msgid "Unique identifier for the target chat" msgstr "" -#: aiogram.client.bot.Bot.unpin_chat_message:1 of +#: aiogram.client.bot.Bot.send_game:4 of msgid "" -"Use this method to remove a message from the list of pinned messages in a" -" chat. If the chat is not a private chat, the bot must be an " -"administrator in the chat for this to work and must have the " -"'can_pin_messages' administrator right in a supergroup or " -"'can_edit_messages' administrator right in a channel. Returns " -":code:`True` on success." +"Short name of the game, serves as the unique identifier for the game. Set" +" up your games via `@BotFather `_." msgstr "" -#: aiogram.client.bot.Bot.unpin_chat_message:3 of -msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +#: aiogram.client.bot.Bot.send_game:10 of +msgid "" +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Play game_title' button will be shown. If not empty, the first " +"button must launch the game." msgstr "" -#: aiogram.client.bot.Bot.unpin_chat_message:6 of +#: aiogram.client.bot.Bot.send_invoice:1 of msgid "" -"Identifier of a message to unpin. If not specified, the most recent " -"pinned message (by sending date) will be unpinned." +"Use this method to send invoices. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.unpin_all_chat_messages:1 of +#: aiogram.client.bot.Bot.send_invoice:7 of msgid "" -"Use this method to clear the list of pinned messages in a chat. If the " -"chat is not a private chat, the bot must be an administrator in the chat " -"for this to work and must have the 'can_pin_messages' administrator right" -" in a supergroup or 'can_edit_messages' administrator right in a channel." -" Returns :code:`True` on success." +"Payment provider token, obtained via `@BotFather " +"`_" msgstr "" -#: aiogram.client.bot.Bot.unpin_all_chat_messages:3 of -msgid "Source: https://core.telegram.org/bots/api#unpinallchatmessages" +#: aiogram.client.bot.Bot.send_invoice:13 of +msgid "" +"Unique deep-linking parameter. If left empty, **forwarded copies** of the" +" sent message will have a *Pay* button, allowing multiple users to pay " +"directly from the forwarded message, using the same invoice. If non-" +"empty, forwarded copies of the sent message will have a *URL* button with" +" a deep link to the bot (instead of a *Pay* button), with the value used " +"as the start parameter" msgstr "" -#: aiogram.client.bot.Bot.leave_chat:1 of +#: aiogram.client.bot.Bot.send_invoice:15 of msgid "" -"Use this method for your bot to leave a group, supergroup or channel. " -"Returns :code:`True` on success." +"URL of the product photo for the invoice. Can be a photo of the goods or " +"a marketing image for a service. People like it better when they see what" +" they are paying for." msgstr "" -#: aiogram.client.bot.Bot.leave_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#leavechat" +#: aiogram.client.bot.Bot.send_invoice:23 of +msgid "Pass :code:`True` if the user's phone number should be sent to provider" msgstr "" -#: aiogram.client.bot.Bot.get_chat:5 -#: aiogram.client.bot.Bot.get_chat_administrators:5 -#: aiogram.client.bot.Bot.get_chat_member:5 -#: aiogram.client.bot.Bot.get_chat_member_count:5 -#: aiogram.client.bot.Bot.get_chat_members_count:9 -#: aiogram.client.bot.Bot.leave_chat:5 of -msgid "" -"Unique identifier for the target chat or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" +#: aiogram.client.bot.Bot.send_invoice:24 of +msgid "Pass :code:`True` if the user's email address should be sent to provider" msgstr "" -#: aiogram.client.bot.Bot.get_chat:1 of +#: aiogram.client.bot.Bot.send_invoice:30 of msgid "" -"Use this method to get up to date information about the chat (current " -"name of the user for one-on-one conversations, current username of a " -"user, group or channel, etc.). Returns a :class:`aiogram.types.chat.Chat`" -" object on success." +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Pay :code:`total price`' button will be shown. If not empty, the " +"first button must be a Pay button." msgstr "" -#: aiogram.client.bot.Bot.get_chat:3 of -msgid "Source: https://core.telegram.org/bots/api#getchat" +#: aiogram.client.bot.Bot.send_location:1 of +msgid "" +"Use this method to send point on the map. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_chat:7 of -msgid "Returns a Chat object on success." +#: aiogram.client.bot.Bot.send_location:4 of +msgid "Latitude of the location" msgstr "" -#: aiogram.client.bot.Bot.get_chat_administrators:1 of -msgid "" -"Use this method to get a list of administrators in a chat, which aren't " -"bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` " -"objects." +#: aiogram.client.bot.Bot.send_location:5 of +msgid "Longitude of the location" msgstr "" -#: aiogram.client.bot.Bot.get_chat_administrators:3 of -msgid "Source: https://core.telegram.org/bots/api#getchatadministrators" +#: aiogram.client.bot.Bot.send_location:8 of +msgid "" +"Period in seconds for which the location will be updated (see `Live " +"Locations `_, should be between" +" 60 and 86400." msgstr "" -#: aiogram.client.bot.Bot.get_chat_administrators:7 of -msgid "Returns an Array of ChatMember objects." +#: aiogram.client.bot.Bot.send_location:9 of +msgid "" +"For live locations, a direction in which the user is moving, in degrees. " +"Must be between 1 and 360 if specified." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member_count:1 -#: aiogram.client.bot.Bot.get_chat_members_count:5 of +#: aiogram.client.bot.Bot.send_location:10 of msgid "" -"Use this method to get the number of members in a chat. Returns *Int* on " -"success." +"For live locations, a maximum distance for proximity alerts about " +"approaching another chat member, in meters. Must be between 1 and 100000 " +"if specified." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member_count:3 -#: aiogram.client.bot.Bot.get_chat_members_count:7 of -msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +#: aiogram.client.bot.Bot.send_media_group:1 of +msgid "" +"Use this method to send a group of photos, videos, documents or audios as" +" an album. Documents and audio files can be only grouped in an album with" +" messages of the same type. On success, an array of `Messages " +"`_ that were sent is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member_count:7 -#: aiogram.client.bot.Bot.get_chat_members_count:11 of -msgid "Returns Int on success." +#: aiogram.client.bot.Bot.send_media_group:4 of +msgid "" +"A JSON-serialized array describing messages to be sent, must include 2-10" +" items" msgstr "" -#: aiogram.client.bot.Bot.get_chat_member:1 of +#: aiogram.client.bot.Bot.send_media_group:6 of msgid "" -"Use this method to get information about a member of a chat. Returns a " -":class:`aiogram.types.chat_member.ChatMember` object on success." +"Sends messages `silently `_. Users will receive a notification with no sound." msgstr "" -#: aiogram.client.bot.Bot.get_chat_member:3 of -msgid "Source: https://core.telegram.org/bots/api#getchatmember" +#: aiogram.client.bot.Bot.send_media_group:7 of +msgid "Protects the contents of the sent messages from forwarding and saving" msgstr "" -#: aiogram.client.bot.Bot.get_chat_member:8 of -msgid "Returns a ChatMember object on success." +#: aiogram.client.bot.Bot.send_media_group:8 of +msgid "If the messages are a reply, ID of the original message" msgstr "" -#: aiogram.client.bot.Bot.set_chat_sticker_set:1 of +#: aiogram.client.bot.Bot.send_media_group:11 of msgid "" -"Use this method to set a new group sticker set for a supergroup. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Use the field *can_set_sticker_set* " -"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" -" to check if the bot can use this method. Returns :code:`True` on " -"success." +"On success, an array of `Messages " +"`_ that were sent is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatstickerset" +#: aiogram.client.bot.Bot.send_message:1 of +msgid "" +"Use this method to send text messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_chat_sticker_set:6 of -msgid "Name of the sticker set to be set as the group sticker set" +#: aiogram.client.bot.Bot.send_message:4 of +msgid "Text of the message to be sent, 1-4096 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_sticker_set:7 -#: aiogram.client.bot.Bot.set_chat_sticker_set:8 of +#: aiogram.client.bot.Bot.send_photo:1 of msgid "" -"Use the field can_set_sticker_set optionally returned in getChat requests" -" to check if the bot can use this method. Returns True on success." +"Use this method to send photos. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.delete_chat_sticker_set:1 of +#: aiogram.client.bot.Bot.send_photo:4 of msgid "" -"Use this method to delete a group sticker set from a supergroup. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Use the field *can_set_sticker_set* " -"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" -" to check if the bot can use this method. Returns :code:`True` on " -"success." +"Photo to send. Pass a file_id as String to send a photo that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a photo from the Internet, or upload a new photo using " +"multipart/form-data. The photo must be at most 10 MB in size. The photo's" +" width and height must not exceed 10000 in total. Width and height ratio " +"must be at most 20. :ref:`More information on Sending Files » `" msgstr "" -#: aiogram.client.bot.Bot.delete_chat_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#deletechatstickerset" +#: aiogram.client.bot.Bot.send_photo:6 of +msgid "" +"Photo caption (may also be used when resending photos by *file_id*), " +"0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:1 of +#: aiogram.client.bot.Bot.send_photo:7 of msgid "" -"Use this method to get custom emoji stickers, which can be used as a " -"forum topic icon by any user. Requires no parameters. Returns an Array of" -" :class:`aiogram.types.sticker.Sticker` objects." +"Mode for parsing entities in the photo caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:3 of -msgid "Source: https://core.telegram.org/bots/api#getforumtopiciconstickers" +#: aiogram.client.bot.Bot.send_poll:1 of +msgid "" +"Use this method to send a native poll. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:7 -#: aiogram.client.bot.Bot.get_forum_topic_icon_stickers:6 of -msgid "Returns an Array of Sticker objects." +#: aiogram.client.bot.Bot.send_poll:4 of +msgid "Poll question, 1-300 characters" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:1 of +#: aiogram.client.bot.Bot.send_poll:5 of msgid "" -"Use this method to create a topic in a forum supergroup chat. The bot " -"must be an administrator in the chat for this to work and must have the " -"*can_manage_topics* administrator rights. Returns information about the " -"created topic as a :class:`aiogram.types.forum_topic.ForumTopic` object." +"A JSON-serialized list of answer options, 2-10 strings 1-100 characters " +"each" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#createforumtopic" +#: aiogram.client.bot.Bot.send_poll:7 of +msgid ":code:`True`, if the poll needs to be anonymous, defaults to :code:`True`" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:6 of -msgid "Topic name, 1-128 characters" +#: aiogram.client.bot.Bot.send_poll:8 of +msgid "Poll type, 'quiz' or 'regular', defaults to 'regular'" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:7 of +#: aiogram.client.bot.Bot.send_poll:9 of msgid "" -"Color of the topic icon in RGB format. Currently, must be one of " -"0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F" +":code:`True`, if the poll allows multiple answers, ignored for polls in " +"quiz mode, defaults to :code:`False`" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:8 of +#: aiogram.client.bot.Bot.send_poll:10 of msgid "" -"Unique identifier of the custom emoji shown as the topic icon. Use " -":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" -" to get all allowed custom emoji identifiers." +"0-based identifier of the correct answer option, required for polls in " +"quiz mode" msgstr "" -#: aiogram.client.bot.Bot.create_forum_topic:10 of -msgid "Returns information about the created topic as a ForumTopic object." +#: aiogram.client.bot.Bot.send_poll:11 of +msgid "" +"Text that is shown when a user chooses an incorrect answer or taps on the" +" lamp icon in a quiz-style poll, 0-200 characters with at most 2 line " +"feeds after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:1 of +#: aiogram.client.bot.Bot.send_poll:12 of msgid "" -"Use this method to edit name and icon of a topic in a forum supergroup " -"chat. The bot must be an administrator in the chat for this to work and " -"must have *can_manage_topics* administrator rights, unless it is the " -"creator of the topic. Returns :code:`True` on success." +"Mode for parsing entities in the explanation. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#editforumtopic" +#: aiogram.client.bot.Bot.send_poll:13 of +msgid "" +"A JSON-serialized list of special entities that appear in the poll " +"explanation, which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:6 -#: aiogram.client.bot.Bot.delete_forum_topic:6 -#: aiogram.client.bot.Bot.edit_forum_topic:6 -#: aiogram.client.bot.Bot.reopen_forum_topic:6 -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:6 of -msgid "Unique identifier for the target message thread of the forum topic" +#: aiogram.client.bot.Bot.send_poll:14 of +msgid "" +"Amount of time in seconds the poll will be active after creation, 5-600. " +"Can't be used together with *close_date*." msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:7 of -msgid "New topic name, 1-128 characters" +#: aiogram.client.bot.Bot.send_poll:15 of +msgid "" +"Point in time (Unix timestamp) when the poll will be automatically " +"closed. Must be at least 5 and no more than 600 seconds in the future. " +"Can't be used together with *open_period*." msgstr "" -#: aiogram.client.bot.Bot.edit_forum_topic:8 of +#: aiogram.client.bot.Bot.send_poll:16 of msgid "" -"New unique identifier of the custom emoji shown as the topic icon. Use " -":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" -" to get all allowed custom emoji identifiers" +"Pass :code:`True` if the poll needs to be immediately closed. This can be" +" useful for poll preview." msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:1 of +#: aiogram.client.bot.Bot.send_sticker:1 of msgid "" -"Use this method to close an open topic in a forum supergroup chat. The " -"bot must be an administrator in the chat for this to work and must have " -"the *can_manage_topics* administrator rights, unless it is the creator of" -" the topic. Returns :code:`True` on success." +"Use this method to send static .WEBP, `animated " +"`_ .TGS, or `video " +"`_ .WEBM " +"stickers. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." msgstr "" -#: aiogram.client.bot.Bot.close_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#closeforumtopic" +#: aiogram.client.bot.Bot.send_sticker:4 of +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 "" -#: aiogram.client.bot.Bot.reopen_forum_topic:1 of +#: aiogram.client.bot.Bot.send_venue:1 of msgid "" -"Use this method to reopen a closed topic in a forum supergroup chat. The " -"bot must be an administrator in the chat for this to work and must have " -"the *can_manage_topics* administrator rights, unless it is the creator of" -" the topic. Returns :code:`True` on success." +"Use this method to send information about a venue. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.reopen_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#reopenforumtopic" +#: aiogram.client.bot.Bot.send_venue:4 of +msgid "Latitude of the venue" msgstr "" -#: aiogram.client.bot.Bot.delete_forum_topic:1 of -msgid "" -"Use this method to delete a forum topic along with all its messages in a " -"forum supergroup chat. The bot must be an administrator in the chat for " -"this to work and must have the *can_delete_messages* administrator " -"rights. Returns :code:`True` on success." +#: aiogram.client.bot.Bot.send_venue:5 of +msgid "Longitude of the venue" +msgstr "" + +#: aiogram.client.bot.Bot.send_venue:6 of +msgid "Name of the venue" msgstr "" -#: aiogram.client.bot.Bot.delete_forum_topic:3 of -msgid "Source: https://core.telegram.org/bots/api#deleteforumtopic" +#: aiogram.client.bot.Bot.send_venue:7 of +msgid "Address of the venue" msgstr "" -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:1 of +#: aiogram.client.bot.Bot.send_venue:9 of +msgid "Foursquare identifier of the venue" +msgstr "" + +#: aiogram.client.bot.Bot.send_venue:10 of msgid "" -"Use this method to clear the list of pinned messages in a forum topic. " -"The bot must be an administrator in the chat for this to work and must " -"have the *can_pin_messages* administrator right in the supergroup. " -"Returns :code:`True` on success." +"Foursquare type of the venue, if known. (For example, " +"'arts_entertainment/default', 'arts_entertainment/aquarium' or " +"'food/icecream'.)" msgstr "" -#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:3 of -msgid "Source: https://core.telegram.org/bots/api#unpinallforumtopicmessages" +#: aiogram.client.bot.Bot.send_venue:11 of +msgid "Google Places identifier of the venue" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:1 of +#: aiogram.client.bot.Bot.send_venue:12 of msgid "" -"Use this method to send answers to callback queries sent from `inline " -"keyboards `_. " -"The answer will be displayed to the user as a notification at the top of " -"the chat screen or as an alert. On success, :code:`True` is returned." +"Google Places type of the venue. (See `supported types " +"`_.)" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:3 of +#: aiogram.client.bot.Bot.send_video:1 of msgid "" -"Alternatively, the user can be redirected to the specified Game URL. For " -"this option to work, you must first create a game for your bot via " -"`@BotFather `_ and accept the terms. Otherwise, " -"you may use links like :code:`t.me/your_bot?start=XXXX` that open your " -"bot with a parameter." +"Use this method to send video files, Telegram clients support MPEG4 " +"videos (other formats may be sent as " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send video files of up to 50 MB in size, this limit may be changed in the" +" future." msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:5 of -msgid "Source: https://core.telegram.org/bots/api#answercallbackquery" +#: aiogram.client.bot.Bot.send_video:4 of +msgid "" +"Video to send. Pass a file_id as String to send a video that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a video from the Internet, or upload a new video using " +"multipart/form-data. :ref:`More information on Sending Files » `" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:7 -#: aiogram.client.bot.Bot.answer_pre_checkout_query:5 -#: aiogram.client.bot.Bot.answer_shipping_query:5 -#: aiogram.client.bot.Bot.answer_web_app_query:5 of -msgid "Unique identifier for the query to be answered" +#: aiogram.client.bot.Bot.send_video:6 aiogram.client.bot.Bot.send_video_note:6 +#: of +msgid "Duration of sent video in seconds" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:8 of -msgid "" -"Text of the notification. If not specified, nothing will be shown to the " -"user, 0-200 characters" +#: aiogram.client.bot.Bot.send_video:7 of +msgid "Video width" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:9 of -msgid "" -"If :code:`True`, an alert will be shown by the client instead of a " -"notification at the top of the chat screen. Defaults to *false*." +#: aiogram.client.bot.Bot.send_video:8 of +msgid "Video height" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:10 of +#: aiogram.client.bot.Bot.send_video:10 of msgid "" -"URL that will be opened by the user's client. If you have created a " -":class:`aiogram.types.game.Game` and accepted the conditions via " -"`@BotFather `_, specify the URL that opens your " -"game - note that this will only work if the query comes from a " -"`https://core.telegram.org/bots/api#inlinekeyboardbutton " -"`_ " -"*callback_game* button." +"Video caption (may also be used when resending videos by *file_id*), " +"0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:11 of +#: aiogram.client.bot.Bot.send_video:11 of msgid "" -"The maximum amount of time in seconds that the result of the callback " -"query may be cached client-side. Telegram apps will support caching " -"starting in version 3.14. Defaults to 0." +"Mode for parsing entities in the video caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.client.bot.Bot.answer_callback_query:13 -#: aiogram.client.bot.Bot.answer_inline_query:15 -#: aiogram.client.bot.Bot.answer_pre_checkout_query:9 -#: aiogram.client.bot.Bot.answer_shipping_query:10 of -msgid "On success, True is returned." +#: aiogram.client.bot.Bot.send_video:13 of +msgid "Pass :code:`True` if the uploaded video is suitable for streaming" msgstr "" -#: aiogram.client.bot.Bot.set_my_commands:1 of +#: aiogram.client.bot.Bot.send_video:20 of msgid "" -"Use this method to change the list of the bot's commands. See `this " -"manual `_ for more " -"details about bot commands. Returns :code:`True` on success." +"Bots can currently send video files of up to 50 MB in size, this limit " +"may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.set_my_commands:3 of -msgid "Source: https://core.telegram.org/bots/api#setmycommands" +#: aiogram.client.bot.Bot.send_video_note:1 of +msgid "" +"As of `v.4.0 `_, " +"Telegram clients support rounded square MPEG4 videos of up to 1 minute " +"long. Use this method to send video messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.client.bot.Bot.set_my_commands:5 of +#: aiogram.client.bot.Bot.send_video_note:4 of msgid "" -"A JSON-serialized list of bot commands to be set as the list of the bot's" -" commands. At most 100 commands can be specified." +"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" msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:5 -#: aiogram.client.bot.Bot.set_my_commands:6 of -msgid "" -"A JSON-serialized object, describing scope of users for which the " -"commands are relevant. Defaults to " -":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." +#: aiogram.client.bot.Bot.send_video_note:7 of +msgid "Video width and height, i.e. diameter of the video message" msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:6 -#: aiogram.client.bot.Bot.set_my_commands:7 of +#: aiogram.client.bot.Bot.send_voice:1 of msgid "" -"A two-letter ISO 639-1 language code. If empty, commands will be applied " -"to all users from the given scope, for whose language there are no " -"dedicated commands" +"Use this method to send audio files, if you want Telegram clients to " +"display the file as a playable voice message. For this to work, your " +"audio must be in an .OGG file encoded with OPUS (other formats may be " +"sent as :class:`aiogram.types.audio.Audio` or " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send voice messages of up to 50 MB in size, this limit may be changed in " +"the future." msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:1 of +#: aiogram.client.bot.Bot.send_voice:4 of msgid "" -"Use this method to delete the list of the bot's commands for the given " -"scope and user language. After deletion, `higher level commands " -"`_ will " -"be shown to affected users. Returns :code:`True` on success." +"Audio 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 » `" msgstr "" -#: aiogram.client.bot.Bot.delete_my_commands:3 of -msgid "Source: https://core.telegram.org/bots/api#deletemycommands" +#: aiogram.client.bot.Bot.send_voice:6 of +msgid "Voice message caption, 0-1024 characters after entities parsing" msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:1 of +#: aiogram.client.bot.Bot.send_voice:7 of msgid "" -"Use this method to get the current list of the bot's commands for the " -"given scope and user language. Returns an Array of " -":class:`aiogram.types.bot_command.BotCommand` objects. If commands aren't" -" set, an empty list is returned." +"Mode for parsing entities in the voice message caption. See `formatting " +"options `_ for " +"more details." msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:3 of -msgid "Source: https://core.telegram.org/bots/api#getmycommands" +#: aiogram.client.bot.Bot.send_voice:9 of +msgid "Duration of the voice message in seconds" msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:5 of +#: aiogram.client.bot.Bot.send_voice:16 of msgid "" -"A JSON-serialized object, describing scope of users. Defaults to " -":class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`." +"Bots can currently send voice messages of up to 50 MB in size, this limit" +" may be changed in the future." msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:6 of -msgid "A two-letter ISO 639-1 language code or an empty string" +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:1 of +msgid "" +"Use this method to set a custom title for an administrator in a " +"supergroup promoted by the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.set_chat_administrator_custom_title:5 of +msgid "" +"New custom title for the administrator; 0-16 characters, emoji are not " +"allowed" msgstr "" -#: aiogram.client.bot.Bot.get_my_commands:8 of +#: aiogram.client.bot.Bot.set_chat_description:1 of msgid "" -"Returns an Array of BotCommand objects. If commands aren't set, an empty " -"list is returned." +"Use this method to change the description of a group, a supergroup or a " +"channel. The bot must be an administrator in the chat for this to work " +"and must have the appropriate administrator rights. Returns :code:`True` " +"on success." +msgstr "" + +#: aiogram.client.bot.Bot.set_chat_description:4 of +msgid "New chat description, 0-255 characters" msgstr "" #: aiogram.client.bot.Bot.set_chat_menu_button:1 of @@ -2593,311 +2832,376 @@ msgid "" msgstr "" #: aiogram.client.bot.Bot.set_chat_menu_button:3 of -msgid "Source: https://core.telegram.org/bots/api#setchatmenubutton" -msgstr "" - -#: aiogram.client.bot.Bot.set_chat_menu_button:5 of msgid "" "Unique identifier for the target private chat. If not specified, default " "bot's menu button will be changed" msgstr "" -#: aiogram.client.bot.Bot.set_chat_menu_button:6 of +#: aiogram.client.bot.Bot.set_chat_menu_button:4 of msgid "" "A JSON-serialized object for the bot's new menu button. Defaults to " ":class:`aiogram.types.menu_button_default.MenuButtonDefault`" msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:1 of +#: aiogram.client.bot.Bot.set_chat_permissions:1 of msgid "" -"Use this method to get the current value of the bot's menu button in a " -"private chat, or the default menu button. Returns " -":class:`aiogram.types.menu_button.MenuButton` on success." +"Use this method to set default chat permissions for all members. The bot " +"must be an administrator in the group or a supergroup for this to work " +"and must have the *can_restrict_members* administrator rights. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:3 of -msgid "Source: https://core.telegram.org/bots/api#getchatmenubutton" +#: aiogram.client.bot.Bot.set_chat_permissions:4 of +msgid "A JSON-serialized object for new default chat permissions" msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:5 of +#: aiogram.client.bot.Bot.set_chat_photo:1 of msgid "" -"Unique identifier for the target private chat. If not specified, default " -"bot's menu button will be returned" +"Use this method to set a new profile photo for the chat. Photos can't be " +"changed for private chats. The bot must be an administrator in the chat " +"for this to work and must have the appropriate administrator rights. " +"Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.get_chat_menu_button:7 of -msgid "Returns MenuButton on success." +#: aiogram.client.bot.Bot.set_chat_photo:4 of +msgid "New chat photo, uploaded using multipart/form-data" msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:1 of +#: aiogram.client.bot.Bot.set_chat_sticker_set:1 of 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." +"Use this method to set a new group sticker set for a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:3 of -msgid "Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights" +#: aiogram.client.bot.Bot.set_chat_sticker_set:4 of +msgid "Name of the sticker set to be set as the group sticker set" msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:5 of +#: aiogram.client.bot.Bot.set_chat_title:1 of msgid "" -"A JSON-serialized object describing new default administrator rights. If " -"not specified, the default administrator rights will be cleared." +"Use this method to change the title of a chat. Titles can't be changed " +"for private chats. The bot must be an administrator in the chat for this " +"to work and must have the appropriate administrator rights. Returns " +":code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.set_my_default_administrator_rights:6 of -msgid "" -"Pass :code:`True` to change the default administrator rights of the bot " -"in channels. Otherwise, the default administrator rights of the bot for " -"groups and supergroups will be changed." +#: aiogram.client.bot.Bot.set_chat_title:4 of +msgid "New chat title, 1-128 characters" msgstr "" -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:1 of +#: aiogram.client.bot.Bot.set_game_score:1 of msgid "" -"Use this method to get the current default administrator rights of the " -"bot. Returns " -":class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` " -"on success." +"Use this method to set the score of the specified user in a game message." +" On success, if the message is not an inline message, the " +":class:`aiogram.types.message.Message` is returned, otherwise " +":code:`True` is returned. Returns an error, if the new score is not " +"greater than the user's current score in the chat and *force* is " +":code:`False`." msgstr "" -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:3 of -msgid "Source: https://core.telegram.org/bots/api#getmydefaultadministratorrights" +#: aiogram.client.bot.Bot.set_game_score:3 +#: aiogram.client.bot.Bot.set_passport_data_errors:4 of +msgid "User identifier" msgstr "" -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:5 of -msgid "" -"Pass :code:`True` to get default administrator rights of the bot in " -"channels. Otherwise, default administrator rights of the bot for groups " -"and supergroups will be returned." -msgstr "" - -#: aiogram.client.bot.Bot.get_my_default_administrator_rights:7 of -msgid "Returns ChatAdministratorRights on success." +#: aiogram.client.bot.Bot.set_game_score:4 of +msgid "New score, must be non-negative" msgstr "" -#: aiogram.client.bot.Bot.edit_message_text:1 of +#: aiogram.client.bot.Bot.set_game_score:5 of msgid "" -"Use this method to edit text and `game " -"`_ messages. 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." -msgstr "" - -#: aiogram.client.bot.Bot.edit_message_text:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagetext" -msgstr "" - -#: aiogram.client.bot.Bot.edit_message_text:5 of -msgid "New text of the message, 1-4096 characters after entities parsing" +"Pass :code:`True` if the high score is allowed to decrease. This can be " +"useful when fixing mistakes or banning cheaters" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:11 -#: aiogram.client.bot.Bot.edit_message_reply_markup:8 -#: aiogram.client.bot.Bot.edit_message_text:12 of +#: aiogram.client.bot.Bot.set_game_score:6 of msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_." +"Pass :code:`True` if the game message should not be automatically edited " +"to include the current scoreboard" msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:1 of +#: aiogram.client.bot.Bot.set_game_score:11 of msgid "" -"Use this method to edit captions of messages. 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." -msgstr "" - -#: aiogram.client.bot.Bot.edit_message_caption:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagecaption" +"Returns an error, if the new score is not greater than the user's current" +" score in the chat and *force* is :code:`False`." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:8 of -msgid "New caption of the message, 0-1024 characters after entities parsing" +#: aiogram.client.bot.Bot.set_my_commands:1 of +msgid "" +"Use this method to change the list of the bot's commands. See `this " +"manual `_ for more " +"details about bot commands. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.edit_message_caption:9 of +#: aiogram.client.bot.Bot.set_my_commands:3 of msgid "" -"Mode for parsing entities in the message caption. See `formatting options" -" `_ for more " -"details." +"A JSON-serialized list of bot commands to be set as the list of the bot's" +" commands. At most 100 commands can be specified." msgstr "" -#: aiogram.client.bot.Bot.edit_message_media:1 of +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:1 of msgid "" -"Use this method to edit animation, audio, document, photo, or video " -"messages. If a message is part of a message album, then it can be edited " -"only to an audio for audio albums, only to a document for document albums" -" and to a photo or a video otherwise. When an inline message is edited, a" -" new file can't be uploaded; use a previously uploaded file via its " -"file_id or specify a URL. On success, if the edited message is not an " -"inline message, the edited :class:`aiogram.types.message.Message` is " -"returned, otherwise :code:`True` is returned." +"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 "" -#: aiogram.client.bot.Bot.edit_message_media:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagemedia" +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:3 of +msgid "" +"A JSON-serialized object describing new default administrator rights. If " +"not specified, the default administrator rights will be cleared." msgstr "" -#: aiogram.client.bot.Bot.edit_message_media:5 of -msgid "A JSON-serialized object for a new media content of the message" +#: aiogram.client.bot.Bot.set_my_default_administrator_rights:4 of +msgid "" +"Pass :code:`True` to change the default administrator rights of the bot " +"in channels. Otherwise, the default administrator rights of the bot for " +"groups and supergroups will be changed." msgstr "" -#: aiogram.client.bot.Bot.edit_message_reply_markup:1 of +#: aiogram.client.bot.Bot.set_passport_data_errors:1 of msgid "" -"Use this method to edit only the reply markup of messages. 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." +"Informs a user that some of the Telegram Passport elements they provided " +"contains errors. The user will not be able to re-submit their Passport to" +" you until the errors are fixed (the contents of the field for which you " +"returned the error must change). Returns :code:`True` on success. Use " +"this if the data submitted by the user doesn't satisfy the standards your" +" service requires for any reason. For example, if a birthday date seems " +"invalid, a submitted document is blurry, a scan shows evidence of " +"tampering, etc. Supply some details in the error message to make sure the" +" user knows how to correct the issues." msgstr "" -#: aiogram.client.bot.Bot.edit_message_reply_markup:3 of -msgid "Source: https://core.telegram.org/bots/api#editmessagereplymarkup" +#: aiogram.client.bot.Bot.set_passport_data_errors:5 of +msgid "A JSON-serialized array describing the errors" msgstr "" -#: aiogram.client.bot.Bot.stop_poll:1 of +#: aiogram.client.bot.Bot.set_passport_data_errors:7 of msgid "" -"Use this method to stop a poll which was sent by the bot. On success, the" -" stopped :class:`aiogram.types.poll.Poll` is returned." +"Supply some details in the error message to make sure the user knows how " +"to correct the issues." msgstr "" -#: aiogram.client.bot.Bot.stop_poll:3 of -msgid "Source: https://core.telegram.org/bots/api#stoppoll" +#: aiogram.client.bot.Bot.set_sticker_position_in_set:1 of +msgid "" +"Use this method to move a sticker in a set created by the bot to a " +"specific position. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.stop_poll:6 of -msgid "Identifier of the original message with the poll" +#: aiogram.client.bot.Bot.set_sticker_position_in_set:4 of +msgid "New sticker position in the set, zero-based" msgstr "" -#: aiogram.client.bot.Bot.stop_poll:7 of +#: aiogram.client.bot.Bot.set_sticker_set_thumb:1 of msgid "" -"A JSON-serialized object for a new message `inline keyboard " -"`_." +"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.client.bot.Bot.stop_poll:9 of -msgid "On success, the stopped Poll is returned." +#: aiogram.client.bot.Bot.set_sticker_set_thumb:4 of +msgid "User identifier of the sticker set owner" msgstr "" -#: aiogram.client.bot.Bot.delete_message:1 of +#: aiogram.client.bot.Bot.set_sticker_set_thumb:5 of msgid "" -"Use this method to delete a message, including service messages, with the" -" following limitations:" -msgstr "" - -#: aiogram.client.bot.Bot.delete_message:3 of -msgid "A message can only be deleted if it was sent less than 48 hours ago." +"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 "" -#: aiogram.client.bot.Bot.delete_message:5 of +#: aiogram.client.bot.Bot.set_webhook:1 of msgid "" -"Service messages about a supergroup, channel, or forum topic creation " -"can't be deleted." +"Use this method to specify a URL and receive incoming updates via an " +"outgoing webhook. Whenever there is an update for the bot, we will send " +"an HTTPS POST request to the specified URL, containing a JSON-serialized " +":class:`aiogram.types.update.Update`. In case of an unsuccessful request," +" we will give up after a reasonable amount of attempts. Returns " +":code:`True` on success. If you'd like to make sure that the webhook was " +"set by you, you can specify secret data in the parameter *secret_token*. " +"If specified, the request will contain a header 'X-Telegram-Bot-Api-" +"Secret-Token' with the secret token as content." msgstr "" -#: aiogram.client.bot.Bot.delete_message:7 of +#: aiogram.client.bot.Bot.set_webhook:6 of msgid "" -"A dice message in a private chat can only be deleted if it was sent more " -"than 24 hours ago." +"**1.** You will not be able to receive updates using " +":class:`aiogram.methods.get_updates.GetUpdates` for as long as an " +"outgoing webhook is set up." msgstr "" -#: aiogram.client.bot.Bot.delete_message:9 of +#: aiogram.client.bot.Bot.set_webhook:8 of msgid "" -"Bots can delete outgoing messages in private chats, groups, and " -"supergroups." +"**2.** To use a self-signed certificate, you need to upload your `public " +"key certificate `_ using " +"*certificate* parameter. Please upload as InputFile, sending a String " +"will not work." msgstr "" -#: aiogram.client.bot.Bot.delete_message:11 of -msgid "Bots can delete incoming messages in private chats." +#: aiogram.client.bot.Bot.set_webhook:10 of +msgid "" +"**3.** Ports currently supported *for webhooks*: **443, 80, 88, 8443**. " +"If you're having any trouble setting up webhooks, please check out this " +"`amazing guide to webhooks `_." msgstr "" -#: aiogram.client.bot.Bot.delete_message:13 of +#: aiogram.client.bot.Bot.set_webhook:13 of msgid "" -"Bots granted *can_post_messages* permissions can delete outgoing messages" -" in channels." +"HTTPS URL to send updates to. Use an empty string to remove webhook " +"integration" msgstr "" -#: aiogram.client.bot.Bot.delete_message:15 of +#: aiogram.client.bot.Bot.set_webhook:14 of msgid "" -"If the bot is an administrator of a group, it can delete any message " -"there." +"Upload your public key certificate so that the root certificate in use " +"can be checked. See our `self-signed guide " +"`_ for details." msgstr "" -#: aiogram.client.bot.Bot.delete_message:17 of +#: aiogram.client.bot.Bot.set_webhook:15 of msgid "" -"If the bot has *can_delete_messages* permission in a supergroup or a " -"channel, it can delete any message there." +"The fixed IP address which will be used to send webhook requests instead " +"of the IP address resolved through DNS" msgstr "" -#: aiogram.client.bot.Bot.delete_message:19 of -msgid "Returns :code:`True` on success." +#: aiogram.client.bot.Bot.set_webhook:16 of +msgid "" +"The maximum allowed number of simultaneous HTTPS connections to the " +"webhook for update delivery, 1-100. Defaults to *40*. Use lower values to" +" limit the load on your bot's server, and higher values to increase your " +"bot's throughput." msgstr "" -#: aiogram.client.bot.Bot.delete_message:21 of -msgid "Source: https://core.telegram.org/bots/api#deletemessage" +#: aiogram.client.bot.Bot.set_webhook:19 of +msgid "" +"A secret token to be sent in a header 'X-Telegram-Bot-Api-Secret-Token' " +"in every webhook request, 1-256 characters. Only characters :code:`A-Z`, " +":code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. The header" +" is useful to ensure that the request comes from a webhook set by you." msgstr "" -#: aiogram.client.bot.Bot.delete_message:24 of -msgid "Identifier of the message to delete" +#: aiogram.client.bot.Bot.set_webhook:21 of +msgid "Please upload as InputFile, sending a String will not work." msgstr "" -#: aiogram.client.bot.Bot.send_sticker:1 of +#: aiogram.client.bot.Bot.stop_message_live_location:1 of msgid "" -"Use this method to send static .WEBP, `animated " -"`_ .TGS, or `video " -"`_ .WEBM " -"stickers. On success, the sent :class:`aiogram.types.message.Message` is " -"returned." +"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." msgstr "" -#: aiogram.client.bot.Bot.send_sticker:3 of -msgid "Source: https://core.telegram.org/bots/api#sendsticker" +#: aiogram.client.bot.Bot.stop_message_live_location:4 of +msgid "" +"Required if *inline_message_id* is not specified. Identifier of the " +"message with live location to stop" msgstr "" -#: aiogram.client.bot.Bot.send_sticker:6 of +#: aiogram.client.bot.Bot.stop_message_live_location:8 of 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 » `" +"On success, if the message is not an inline message, the edited " +":class:`aiogram.types.message.Message` is returned, otherwise " +":code:`True` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:1 of +#: aiogram.client.bot.Bot.stop_poll:1 of msgid "" -"Use this method to get a sticker set. On success, a " -":class:`aiogram.types.sticker_set.StickerSet` object is returned." +"Use this method to stop a poll which was sent by the bot. On success, the" +" stopped :class:`aiogram.types.poll.Poll` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#getstickerset" +#: aiogram.client.bot.Bot.stop_poll:4 of +msgid "Identifier of the original message with the poll" msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:5 of -msgid "Name of the sticker set" +#: aiogram.client.bot.Bot.stop_poll:5 of +msgid "" +"A JSON-serialized object for a new message `inline keyboard " +"`_." msgstr "" -#: aiogram.client.bot.Bot.get_sticker_set:7 of -msgid "On success, a StickerSet object is returned." +#: aiogram.client.bot.Bot.stop_poll:7 of +msgid "On success, the stopped :class:`aiogram.types.poll.Poll` is returned." msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:1 of +#: aiogram.client.bot.Bot.unban_chat_member:1 of msgid "" -"Use this method to get information about custom emoji stickers by their " -"identifiers. Returns an Array of :class:`aiogram.types.sticker.Sticker` " -"objects." +"Use this method to unban a previously banned user in a supergroup or " +"channel. The user will **not** return to the group or channel " +"automatically, but will be able to join via link, etc. The bot must be an" +" administrator for this to work. By default, this method guarantees that " +"after the call the user is not a member of the chat, but will be able to " +"join it. So if the user is a member of the chat they will also be " +"**removed** from the chat. If you don't want this, use the parameter " +"*only_if_banned*. Returns :code:`True` on success." msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:3 of -msgid "Source: https://core.telegram.org/bots/api#getcustomemojistickers" +#: aiogram.client.bot.Bot.unban_chat_member:5 of +msgid "Do nothing if the user is not banned" msgstr "" -#: aiogram.client.bot.Bot.get_custom_emoji_stickers:5 of +#: aiogram.client.bot.Bot.unban_chat_sender_chat:1 of msgid "" -"List of custom emoji identifiers. At most 200 custom emoji identifiers " -"can be specified." +"Use this method to unban a previously banned channel chat in a supergroup" +" or channel. The bot must be an administrator for this to work and must " +"have the appropriate administrator rights. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_all_chat_messages:1 of +msgid "" +"Use this method to clear the list of pinned messages in a chat. If the " +"chat is not a private chat, the bot must be an administrator in the chat " +"for this to work and must have the 'can_pin_messages' administrator right" +" in a supergroup or 'can_edit_messages' administrator right in a channel." +" Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_all_forum_topic_messages:1 of +msgid "" +"Use this method to clear the list of pinned messages in a forum topic. " +"The bot must be an administrator in the chat for this to work and must " +"have the *can_pin_messages* administrator right in the supergroup. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_chat_message:1 of +msgid "" +"Use this method to remove a message from the list of pinned messages in a" +" chat. If the chat is not a private chat, the bot must be an " +"administrator in the chat for this to work and must have the " +"'can_pin_messages' administrator right in a supergroup or " +"'can_edit_messages' administrator right in a channel. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.client.bot.Bot.unpin_chat_message:4 of +msgid "" +"Identifier of a message to unpin. If not specified, the most recent " +"pinned message (by sending date) will be unpinned." msgstr "" #: aiogram.client.bot.Bot.upload_sticker_file:1 of @@ -2909,774 +3213,590 @@ msgid "" msgstr "" #: aiogram.client.bot.Bot.upload_sticker_file:3 of -msgid "Source: https://core.telegram.org/bots/api#uploadstickerfile" -msgstr "" - -#: aiogram.client.bot.Bot.upload_sticker_file:5 of msgid "User identifier of sticker file owner" msgstr "" -#: aiogram.client.bot.Bot.upload_sticker_file:6 of +#: aiogram.client.bot.Bot.upload_sticker_file:4 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 » `" msgstr "" -#: aiogram.client.bot.Bot.upload_sticker_file:8 of -msgid "Returns the uploaded File on success." +#: aiogram.client.bot.Bot.upload_sticker_file:6 of +msgid "Returns the uploaded :class:`aiogram.types.file.File` on success." msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set: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." -msgstr "" +#~ msgid "" +#~ "Additional interface options. A JSON-" +#~ "serialized object for an `inline " +#~ "keyboard `_, " +#~ "`custom reply keyboard " +#~ "`_, instructions " +#~ "to remove reply keyboard or to " +#~ "force a reply from the user." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:3 of -msgid "Source: https://core.telegram.org/bots/api#createnewstickerset" -msgstr "" +#~ msgid "" +#~ "A JSON-serialized object for a new" +#~ " `inline keyboard `_." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:5 of -msgid "User identifier of created sticker set owner" -msgstr "" +#~ msgid "" +#~ "Additional interface options. A JSON-" +#~ "serialized object for an `inline " +#~ "keyboard `_, " +#~ "`custom reply keyboard " +#~ "`_, instructions " +#~ "to remove keyboard or to force a" +#~ " reply from the user." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:6 of -msgid "" -"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." -msgstr "" +#~ msgid "New chat title, 1-255 characters" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:7 of -msgid "Sticker set title, 1-64 characters" -msgstr "" +#~ msgid "" +#~ "Use this method to send answers to" +#~ " callback queries sent from `inline " +#~ "keyboards `_. " +#~ "The answer will be displayed to " +#~ "the user as a notification at the" +#~ " top of the chat screen or as" +#~ " an alert. On success, :code:`True` " +#~ "is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:7 -#: aiogram.client.bot.Bot.create_new_sticker_set:8 of -msgid "One or more emoji corresponding to the sticker" -msgstr "" +#~ msgid "" +#~ "Use this method to change the list" +#~ " of the bot's commands. See " +#~ "`https://core.telegram.org/bots#commands " +#~ "`_`https://core.telegram.org/bots#commands" +#~ " `_ for more" +#~ " details about bot commands. Returns " +#~ ":code:`True` on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:8 -#: aiogram.client.bot.Bot.create_new_sticker_set:9 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 "" +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:9 -#: aiogram.client.bot.Bot.create_new_sticker_set:10 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 "" +#~ msgid "" +#~ "A JSON-serialized object for a new" +#~ " message `inline keyboard " +#~ "`_." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:10 -#: aiogram.client.bot.Bot.create_new_sticker_set:11 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 "" +#~ msgid "" +#~ "`Deep-linking `_ parameter for the /start " +#~ "message sent to the bot when user" +#~ " presses the switch button. 1-64 " +#~ "characters, only :code:`A-Z`, :code:`a-z`, " +#~ ":code:`0-9`, :code:`_` and :code:`-` are " +#~ "allowed." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_new_sticker_set:12 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." -msgstr "" +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_. If empty, one 'Pay " +#~ ":code:`total price`' button will be " +#~ "shown. If not empty, the first " +#~ "button must be a Pay button." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:11 -#: aiogram.client.bot.Bot.create_new_sticker_set:13 of -msgid "" -"A JSON-serialized object for position where the mask should be placed on " -"faces" -msgstr "" +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_. If empty, one 'Play " +#~ "game_title' button will be shown. If " +#~ "not empty, the first button must " +#~ "launch the game." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set: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." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getupdates" +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:3 of -msgid "Source: https://core.telegram.org/bots/api#addstickertoset" -msgstr "" +#~ msgid "Returns an Array of Update objects." +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:5 of -msgid "User identifier of sticker set owner" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setwebhook" +#~ msgstr "" -#: aiogram.client.bot.Bot.add_sticker_to_set:6 -#: aiogram.client.bot.Bot.set_sticker_set_thumb:5 of -msgid "Sticker set name" -msgstr "" +#~ msgid "Returns True on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_position_in_set:1 of -msgid "" -"Use this method to move a sticker in a set created by the bot to a " -"specific position. Returns :code:`True` on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletewebhook" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_position_in_set:3 of -msgid "Source: https://core.telegram.org/bots/api#setstickerpositioninset" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getwebhookinfo" +#~ msgstr "" -#: aiogram.client.bot.Bot.delete_sticker_from_set:5 -#: aiogram.client.bot.Bot.set_sticker_position_in_set:5 of -msgid "File identifier of the sticker" -msgstr "" +#~ msgid "" +#~ "On success, returns a WebhookInfo " +#~ "object. If the bot is using " +#~ "getUpdates, will return an object with" +#~ " the url field empty." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_position_in_set:6 of -msgid "New sticker position in the set, zero-based" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getme" +#~ msgstr "" -#: aiogram.client.bot.Bot.delete_sticker_from_set:1 of -msgid "" -"Use this method to delete a sticker from a set created by the bot. " -"Returns :code:`True` on success." -msgstr "" +#~ msgid "Returns basic information about the bot in form of a User object." +#~ msgstr "" -#: aiogram.client.bot.Bot.delete_sticker_from_set:3 of -msgid "Source: https://core.telegram.org/bots/api#deletestickerfromset" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#logout" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb: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 "" +#~ msgid "Source: https://core.telegram.org/bots/api#close" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb:3 of -msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" -msgstr "" +#~ msgid "" +#~ "The method will return error 429 " +#~ "in the first 10 minutes after the" +#~ " bot is launched. Returns True on " +#~ "success." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb:6 of -msgid "User identifier of the sticker set owner" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendmessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_sticker_set_thumb:7 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 "" +#~ msgid "On success, the sent Message is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:1 of -msgid "" -"Use this method to send answers to an inline query. On success, " -":code:`True` is returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#forwardmessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:3 of -msgid "No more than **50** results per query are allowed." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#copymessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:5 of -msgid "Source: https://core.telegram.org/bots/api#answerinlinequery" -msgstr "" +#~ msgid "Returns the MessageId of the sent message on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:7 of -msgid "Unique identifier for the answered query" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendphoto" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:8 of -msgid "A JSON-serialized array of results for the inline query" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendaudio" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:9 of -msgid "" -"The maximum amount of time in seconds that the result of the inline query" -" may be cached on the server. Defaults to 300." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#senddocument" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:10 of -msgid "" -"Pass :code:`True` if results may be cached on the server side only for " -"the user that sent the query. By default, results may be returned to any " -"user who sends the same query" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvideo" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:11 of -msgid "" -"Pass the offset that a client should send in the next query with the same" -" text to receive more results. Pass an empty string if there are no more " -"results or if you don't support pagination. Offset length can't exceed 64" -" bytes." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendanimation" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:12 of -msgid "" -"If passed, clients will display a button with specified text that " -"switches the user to a private chat with the bot and sends the bot a " -"start message with the parameter *switch_pm_parameter*" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvoice" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_inline_query:13 of -msgid "" -"`Deep-linking `_ " -"parameter for the /start message sent to the bot when user presses the " -"switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, " -":code:`0-9`, :code:`_` and :code:`-` are allowed." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvideonote" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:1 of -msgid "" -"Use this method to set the result of an interaction with a `Web App " -"`_ and send a corresponding " -"message on behalf of the user to the chat from which the query " -"originated. On success, a " -":class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is " -"returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendmediagroup" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:3 of -msgid "Source: https://core.telegram.org/bots/api#answerwebappquery" -msgstr "" +#~ msgid "On success, an array of Messages that were sent is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:6 of -msgid "A JSON-serialized object describing the message to be sent" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendlocation" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_web_app_query:8 of -msgid "On success, a SentWebAppMessage object is returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagelivelocation" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:1 of -msgid "" -"Use this method to send invoices. On success, the sent " -":class:`aiogram.types.message.Message` is returned." -msgstr "" +#~ msgid "" +#~ "On success, if the edited message " +#~ "is not an inline message, the " +#~ "edited Message is returned, otherwise " +#~ "True is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:3 of -msgid "Source: https://core.telegram.org/bots/api#sendinvoice" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#stopmessagelivelocation" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:5 -#: aiogram.client.bot.Bot.send_invoice:6 of -msgid "Product name, 1-32 characters" -msgstr "" +#~ msgid "" +#~ "On success, if the message is not" +#~ " an inline message, the edited " +#~ "Message is returned, otherwise True is" +#~ " returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:6 -#: aiogram.client.bot.Bot.send_invoice:7 of -msgid "Product description, 1-255 characters" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendvenue" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:7 -#: aiogram.client.bot.Bot.send_invoice:8 of -msgid "" -"Bot-defined invoice payload, 1-128 bytes. This will not be displayed to " -"the user, use for your internal processes." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendcontact" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:9 of -msgid "" -"Payment provider token, obtained via `@BotFather " -"`_" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendpoll" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:9 -#: aiogram.client.bot.Bot.send_invoice:10 of -msgid "" -"Three-letter ISO 4217 currency code, see `more on currencies " -"`_" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#senddice" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:10 -#: aiogram.client.bot.Bot.send_invoice:11 of -msgid "" -"Price breakdown, a JSON-serialized list of components (e.g. product " -"price, tax, discount, delivery cost, delivery tax, bonus, etc.)" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendchataction" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:11 -#: aiogram.client.bot.Bot.send_invoice:13 of -msgid "" -"The maximum accepted amount for tips in the *smallest units* of the " -"currency (integer, **not** float/double). For example, for a maximum tip " -"of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* " -"parameter in `currencies.json " -"`_, it shows the" -" number of digits past the decimal point for each currency (2 for the " -"majority of currencies). Defaults to 0" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getuserprofilephotos" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:12 -#: aiogram.client.bot.Bot.send_invoice:14 of -msgid "" -"A JSON-serialized array of suggested amounts of tips in the *smallest " -"units* of the currency (integer, **not** float/double). At most 4 " -"suggested tip amounts can be specified. The suggested tip amounts must be" -" positive, passed in a strictly increased order and must not exceed " -"*max_tip_amount*." -msgstr "" +#~ msgid "Returns a UserProfilePhotos object." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:15 of -msgid "" -"Unique deep-linking parameter. If left empty, **forwarded copies** of the" -" sent message will have a *Pay* button, allowing multiple users to pay " -"directly from the forwarded message, using the same invoice. If non-" -"empty, forwarded copies of the sent message will have a *URL* button with" -" a deep link to the bot (instead of a *Pay* button), with the value used " -"as the start parameter" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getfile" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:13 -#: aiogram.client.bot.Bot.send_invoice:16 of -msgid "" -"JSON-serialized data about the invoice, which will be shared with the " -"payment provider. A detailed description of required fields should be " -"provided by the payment provider." -msgstr "" +#~ msgid "On success, a File object is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:17 of -msgid "" -"URL of the product photo for the invoice. Can be a photo of the goods or " -"a marketing image for a service. People like it better when they see what" -" they are paying for." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#banchatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:15 -#: aiogram.client.bot.Bot.send_invoice:18 of -msgid "Photo size in bytes" -msgstr "" +#~ msgid "" +#~ "In the case of supergroups and " +#~ "channels, the user will not be " +#~ "able to return to the chat on " +#~ "their own using invite links, etc. " +#~ "Returns True on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:16 -#: aiogram.client.bot.Bot.send_invoice:19 of -msgid "Photo width" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#unbanchatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:17 -#: aiogram.client.bot.Bot.send_invoice:20 of -msgid "Photo height" -msgstr "" +#~ msgid "" +#~ "The user will not return to the" +#~ " group or channel automatically, but " +#~ "will be able to join via link, " +#~ "etc. Returns True on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:18 -#: aiogram.client.bot.Bot.send_invoice:21 of -msgid "" -"Pass :code:`True` if you require the user's full name to complete the " -"order" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#restrictchatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:19 -#: aiogram.client.bot.Bot.send_invoice:22 of -msgid "" -"Pass :code:`True` if you require the user's phone number to complete the " -"order" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#promotechatmember" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:20 -#: aiogram.client.bot.Bot.send_invoice:23 of -msgid "" -"Pass :code:`True` if you require the user's email address to complete the" -" order" -msgstr "" +#~ msgid "" +#~ "Source: " +#~ "https://core.telegram.org/bots/api#setchatadministratorcustomtitle" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:21 -#: aiogram.client.bot.Bot.send_invoice:24 of -msgid "" -"Pass :code:`True` if you require the user's shipping address to complete " -"the order" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#banchatsenderchat" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:25 of -msgid "Pass :code:`True` if the user's phone number should be sent to provider" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#unbanchatsenderchat" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:26 of -msgid "Pass :code:`True` if the user's email address should be sent to provider" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setchatpermissions" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:24 -#: aiogram.client.bot.Bot.send_invoice:27 of -msgid "Pass :code:`True` if the final price depends on the shipping method" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#exportchatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_invoice:32 of -msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_. If empty, " -"one 'Pay :code:`total price`' button will be shown. If not empty, the " -"first button must be a Pay button." -msgstr "" +#~ msgid "Returns the new invite link as String on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:1 of -msgid "" -"Use this method to create a link for an invoice. Returns the created " -"invoice link as *String* on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#createchatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:3 of -msgid "Source: https://core.telegram.org/bots/api#createinvoicelink" -msgstr "" +#~ msgid "Returns the new invite link as ChatInviteLink object." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:8 of -msgid "Payment provider token, obtained via `BotFather `_" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editchatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:14 of -msgid "" -"URL of the product photo for the invoice. Can be a photo of the goods or " -"a marketing image for a service." -msgstr "" +#~ msgid "Returns the edited invite link as a ChatInviteLink object." +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:22 of -msgid "" -"Pass :code:`True` if the user's phone number should be sent to the " -"provider" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#revokechatinvitelink" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:23 of -msgid "" -"Pass :code:`True` if the user's email address should be sent to the " -"provider" -msgstr "" +#~ msgid "Returns the revoked invite link as ChatInviteLink object." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#approvechatjoinrequest" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#declinechatjoinrequest" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchatphoto" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#deletechatphoto" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchattitle" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchatdescription" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#unpinallchatmessages" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#leavechat" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchat" +#~ msgstr "" + +#~ msgid "Returns a Chat object on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatadministrators" +#~ msgstr "" + +#~ msgid "Returns an Array of ChatMember objects." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +#~ msgstr "" + +#~ msgid "Returns Int on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmember" +#~ msgstr "" + +#~ msgid "Returns a ChatMember object on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#setchatstickerset" +#~ msgstr "" + +#~ msgid "" +#~ "Use the field can_set_sticker_set optionally" +#~ " returned in getChat requests to " +#~ "check if the bot can use this " +#~ "method. Returns True on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#deletechatstickerset" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getforumtopiciconstickers" +#~ msgstr "" + +#~ msgid "Returns an Array of Sticker objects." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#createforumtopic" +#~ msgstr "" + +#~ msgid "" +#~ "Color of the topic icon in RGB " +#~ "format. Currently, must be one of " +#~ "0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, " +#~ "0xFF93B2, or 0xFB6F5F" +#~ msgstr "" + +#~ msgid "Returns information about the created topic as a ForumTopic object." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#editforumtopic" +#~ msgstr "" + +#~ msgid "" +#~ "New unique identifier of the custom " +#~ "emoji shown as the topic icon. Use" +#~ " " +#~ ":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +#~ " to get all allowed custom emoji " +#~ "identifiers" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#closeforumtopic" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#reopenforumtopic" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#deleteforumtopic" +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#unpinallforumtopicmessages" +#~ msgstr "" -#: aiogram.client.bot.Bot.create_invoice_link:26 of -msgid "Returns the created invoice link as String on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#answercallbackquery" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:1 of -msgid "" -"If you sent an invoice requesting a shipping address and the parameter " -"*is_flexible* was specified, the Bot API will send an " -":class:`aiogram.types.update.Update` with a *shipping_query* field to the" -" bot. Use this method to reply to shipping queries. On success, " -":code:`True` is returned." -msgstr "" +#~ msgid "On success, True is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:3 of -msgid "Source: https://core.telegram.org/bots/api#answershippingquery" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setmycommands" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:6 of -msgid "" -"Pass :code:`True` if delivery to the specified address is possible and " -":code:`False` if there are any problems (for example, if delivery to the " -"specified address is not possible)" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletemycommands" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:7 of -msgid "" -"Required if *ok* is :code:`True`. A JSON-serialized array of available " -"shipping options." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getmycommands" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_shipping_query:8 of -msgid "" -"Required if *ok* is :code:`False`. Error message in human readable form " -"that explains why it is impossible to complete the order (e.g. \"Sorry, " -"delivery to your desired address is unavailable'). Telegram will display " -"this message to the user." -msgstr "" +#~ msgid "" +#~ "Returns an Array of BotCommand objects." +#~ " If commands aren't set, an empty " +#~ "list is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:1 of -msgid "" -"Once the user has confirmed their payment and shipping details, the Bot " -"API sends the final confirmation in the form of an " -":class:`aiogram.types.update.Update` with the field *pre_checkout_query*." -" Use this method to respond to such pre-checkout queries. On success, " -":code:`True` is returned. **Note:** The Bot API must receive an answer " -"within 10 seconds after the pre-checkout query was sent." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setchatmenubutton" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:3 of -msgid "Source: https://core.telegram.org/bots/api#answerprecheckoutquery" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmenubutton" +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:6 of -msgid "" -"Specify :code:`True` if everything is alright (goods are available, etc.)" -" and the bot is ready to proceed with the order. Use :code:`False` if " -"there are any problems." -msgstr "" +#~ msgid "Returns MenuButton on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.answer_pre_checkout_query:7 of -msgid "" -"Required if *ok* is :code:`False`. Error message in human readable form " -"that explains the reason for failure to proceed with the checkout (e.g. " -"\"Sorry, somebody just bought the last of our amazing black T-shirts " -"while you were busy filling out your payment details. Please choose a " -"different color or garment!\"). Telegram will display this message to the" -" user." -msgstr "" +#~ msgid "" +#~ "Source: " +#~ "https://core.telegram.org/bots/api#setmydefaultadministratorrights" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:1 of -msgid "" -"Informs a user that some of the Telegram Passport elements they provided " -"contains errors. The user will not be able to re-submit their Passport to" -" you until the errors are fixed (the contents of the field for which you " -"returned the error must change). Returns :code:`True` on success. Use " -"this if the data submitted by the user doesn't satisfy the standards your" -" service requires for any reason. For example, if a birthday date seems " -"invalid, a submitted document is blurry, a scan shows evidence of " -"tampering, etc. Supply some details in the error message to make sure the" -" user knows how to correct the issues." -msgstr "" +#~ msgid "" +#~ "Source: " +#~ "https://core.telegram.org/bots/api#getmydefaultadministratorrights" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:4 of -msgid "Source: https://core.telegram.org/bots/api#setpassportdataerrors" -msgstr "" +#~ msgid "Returns ChatAdministratorRights on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:5 -#: aiogram.client.bot.Bot.set_passport_data_errors:6 of -msgid "User identifier" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagetext" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:7 of -msgid "A JSON-serialized array describing the errors" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagecaption" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_passport_data_errors:9 of -msgid "" -"The user will not be able to re-submit their Passport to you until the " -"errors are fixed (the contents of the field for which you returned the " -"error must change). Returns True on success." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagemedia" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:1 of -msgid "" -"Use this method to send a game. On success, the sent " -":class:`aiogram.types.message.Message` is returned." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#editmessagereplymarkup" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:3 of -msgid "Source: https://core.telegram.org/bots/api#sendgame" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#stoppoll" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:5 of -msgid "Unique identifier for the target chat" -msgstr "" +#~ msgid "On success, the stopped Poll is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:6 of -msgid "" -"Short name of the game, serves as the unique identifier for the game. Set" -" up your games via `@BotFather `_." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletemessage" +#~ msgstr "" -#: aiogram.client.bot.Bot.send_game:12 of -msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_. If empty, " -"one 'Play game_title' button will be shown. If not empty, the first " -"button must launch the game." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#sendsticker" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:1 of -msgid "" -"Use this method to set the score of the specified user in a game message." -" On success, if the message is not an inline message, the " -":class:`aiogram.types.message.Message` is returned, otherwise " -":code:`True` is returned. Returns an error, if the new score is not " -"greater than the user's current score in the chat and *force* is " -":code:`False`." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getstickerset" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:3 of -msgid "Source: https://core.telegram.org/bots/api#setgamescore" -msgstr "" +#~ msgid "On success, a StickerSet object is returned." +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:6 of -msgid "New score, must be non-negative" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#getcustomemojistickers" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:7 of -msgid "" -"Pass :code:`True` if the high score is allowed to decrease. This can be " -"useful when fixing mistakes or banning cheaters" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#uploadstickerfile" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:8 of -msgid "" -"Pass :code:`True` if the game message should not be automatically edited " -"to include the current scoreboard" -msgstr "" +#~ msgid "Returns the uploaded File on success." +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:8 -#: aiogram.client.bot.Bot.set_game_score:9 of -msgid "" -"Required if *inline_message_id* is not specified. Unique identifier for " -"the target chat" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#createnewstickerset" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:9 -#: aiogram.client.bot.Bot.set_game_score:10 of -msgid "" -"Required if *inline_message_id* is not specified. Identifier of the sent " -"message" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#addstickertoset" +#~ msgstr "" -#: aiogram.client.bot.Bot.set_game_score:13 of -msgid "" -"On success, if the message is not an inline message, the Message is " -"returned, otherwise True is returned. Returns an error, if the new score " -"is not greater than the user's current score in the chat and force is " -"False." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setstickerpositioninset" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:1 of -msgid "" -"Use this method to get data for high score tables. Will return the score " -"of the specified user and several of their neighbors in a game. Returns " -"an Array of :class:`aiogram.types.game_high_score.GameHighScore` objects." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#deletestickerfromset" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:3 of -msgid "" -"This method will currently return scores for the target user, plus two of" -" their closest neighbors on each side. Will also return the top three " -"users if the user and their neighbors are not among them. Please note " -"that this behavior is subject to change." -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#setstickersetthumb" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:5 of -msgid "Source: https://core.telegram.org/bots/api#getgamehighscores" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#answerinlinequery" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:7 of -msgid "Target user id" -msgstr "" +#~ msgid "Source: https://core.telegram.org/bots/api#answerwebappquery" +#~ msgstr "" -#: aiogram.client.bot.Bot.get_game_high_scores:12 of -msgid "" -"Will return the score of the specified user and several of their " -"neighbors in a game. Returns an Array of GameHighScore objects. This " -"method will currently return scores for the target user, plus two of " -"their closest neighbors on each side. Will also return the top three " -"users if the user and their neighbors are not among them." -msgstr "" +#~ msgid "On success, a SentWebAppMessage object is returned." +#~ msgstr "" -#~ msgid "" -#~ "Additional interface options. A JSON-" -#~ "serialized object for an `inline " -#~ "keyboard `_, " -#~ "`custom reply keyboard " -#~ "`_, instructions " -#~ "to remove reply keyboard or to " -#~ "force a reply from the user." +#~ msgid "Source: https://core.telegram.org/bots/api#sendinvoice" #~ msgstr "" -#~ msgid "" -#~ "A JSON-serialized object for a new" -#~ " `inline keyboard `_." +#~ msgid "Source: https://core.telegram.org/bots/api#createinvoicelink" #~ msgstr "" -#~ msgid "" -#~ "Additional interface options. A JSON-" -#~ "serialized object for an `inline " -#~ "keyboard `_, " -#~ "`custom reply keyboard " -#~ "`_, instructions " -#~ "to remove keyboard or to force a" -#~ " reply from the user." +#~ msgid "Returns the created invoice link as String on success." #~ msgstr "" -#~ msgid "New chat title, 1-255 characters" +#~ msgid "Source: https://core.telegram.org/bots/api#answershippingquery" #~ msgstr "" -#~ msgid "" -#~ "Use this method to send answers to" -#~ " callback queries sent from `inline " -#~ "keyboards `_. " -#~ "The answer will be displayed to " -#~ "the user as a notification at the" -#~ " top of the chat screen or as" -#~ " an alert. On success, :code:`True` " -#~ "is returned." +#~ msgid "Source: https://core.telegram.org/bots/api#answerprecheckoutquery" #~ msgstr "" -#~ msgid "" -#~ "Use this method to change the list" -#~ " of the bot's commands. See " -#~ "`https://core.telegram.org/bots#commands " -#~ "`_`https://core.telegram.org/bots#commands" -#~ " `_ for more" -#~ " details about bot commands. Returns " -#~ ":code:`True` on success." +#~ msgid "Source: https://core.telegram.org/bots/api#setpassportdataerrors" #~ msgstr "" #~ msgid "" -#~ "A JSON-serialized object for an " -#~ "`inline keyboard `_." +#~ "The user will not be able to " +#~ "re-submit their Passport to you " +#~ "until the errors are fixed (the " +#~ "contents of the field for which " +#~ "you returned the error must change). " +#~ "Returns True on success." #~ msgstr "" -#~ msgid "" -#~ "A JSON-serialized object for a new" -#~ " message `inline keyboard " -#~ "`_." +#~ msgid "Source: https://core.telegram.org/bots/api#sendgame" #~ msgstr "" -#~ msgid "" -#~ "`Deep-linking `_ parameter for the /start " -#~ "message sent to the bot when user" -#~ " presses the switch button. 1-64 " -#~ "characters, only :code:`A-Z`, :code:`a-z`, " -#~ ":code:`0-9`, :code:`_` and :code:`-` are " -#~ "allowed." +#~ msgid "Source: https://core.telegram.org/bots/api#setgamescore" #~ msgstr "" #~ msgid "" -#~ "A JSON-serialized object for an " -#~ "`inline keyboard `_. If empty, one 'Pay " -#~ ":code:`total price`' button will be " -#~ "shown. If not empty, the first " -#~ "button must be a Pay button." +#~ "On success, if the message is not" +#~ " an inline message, the Message is" +#~ " returned, otherwise True is returned. " +#~ "Returns an error, if the new score" +#~ " is not greater than the user's " +#~ "current score in the chat and " +#~ "force is False." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getgamehighscores" #~ msgstr "" #~ msgid "" -#~ "A JSON-serialized object for an " -#~ "`inline keyboard `_. If empty, one 'Play " -#~ "game_title' button will be shown. If " -#~ "not empty, the first button must " -#~ "launch the game." +#~ "Will return the score of the " +#~ "specified user and several of their " +#~ "neighbors in a game. Returns an " +#~ "Array of GameHighScore objects. This " +#~ "method will currently return scores for" +#~ " the target user, plus two of " +#~ "their closest neighbors on each side." +#~ " Will also return the top three " +#~ "users if the user and their " +#~ "neighbors are not among them." #~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/bot_command_scope_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/bot_command_scope_type.po new file mode 100644 index 0000000000..2d7153f4f3 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/bot_command_scope_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/bot_command_scope_type.rst:3 +msgid "BotCommandScopeType" +msgstr "" + +#: aiogram.enums.bot_command_scope_type.BotCommandScopeType:1 of +msgid "This object represents the scope to which bot commands are applied." +msgstr "" + +#: aiogram.enums.bot_command_scope_type.BotCommandScopeType:3 of +msgid "Source: https://core.telegram.org/bots/api#botcommandscope" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_action.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_action.po new file mode 100644 index 0000000000..0ba8fec171 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_action.po @@ -0,0 +1,66 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/chat_action.rst:3 +msgid "ChatAction" +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:1 of +msgid "This object represents bot actions." +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:3 of +msgid "Choose one, depending on what the user is about to receive:" +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:5 of +msgid "typing for text messages," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:6 of +msgid "upload_photo for photos," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:7 of +msgid "record_video or upload_video for videos," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:8 of +msgid "record_voice or upload_voice for voice notes," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:9 of +msgid "upload_document for general files," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:10 of +msgid "choose_sticker for stickers," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:11 of +msgid "find_location for location data," +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:12 of +msgid "record_video_note or upload_video_note for video notes." +msgstr "" + +#: aiogram.enums.chat_action.ChatAction:14 of +msgid "Source: https://core.telegram.org/bots/api#sendchataction" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_member_status.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_member_status.po new file mode 100644 index 0000000000..d5455e578f --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_member_status.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/chat_member_status.rst:3 +msgid "ChatMemberStatus" +msgstr "" + +#: aiogram.enums.chat_member_status.ChatMemberStatus:1 of +msgid "This object represents chat member status." +msgstr "" + +#: aiogram.enums.chat_member_status.ChatMemberStatus:3 of +msgid "Source: https://core.telegram.org/bots/api#chatmember" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_type.po new file mode 100644 index 0000000000..daa1509244 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/chat_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/chat_type.rst:3 +msgid "ChatType" +msgstr "" + +#: aiogram.enums.chat_type.ChatType:1 of +msgid "This object represents a chat type" +msgstr "" + +#: aiogram.enums.chat_type.ChatType:3 of +msgid "Source: https://core.telegram.org/bots/api#chat" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/content_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/content_type.po new file mode 100644 index 0000000000..b8d27ec9b8 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/content_type.po @@ -0,0 +1,26 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/content_type.rst:3 +msgid "ContentType" +msgstr "" + +#: aiogram.enums.content_type.ContentType:1 of +msgid "This object represents a type of content in message" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/dice_emoji.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/dice_emoji.po new file mode 100644 index 0000000000..eacb9567ed --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/dice_emoji.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/dice_emoji.rst:3 +msgid "DiceEmoji" +msgstr "" + +#: aiogram.enums.dice_emoji.DiceEmoji:1 of +msgid "Emoji on which the dice throw animation is based" +msgstr "" + +#: aiogram.enums.dice_emoji.DiceEmoji:3 of +msgid "Source: https://core.telegram.org/bots/api#dice" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/index.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/index.po new file mode 100644 index 0000000000..04fcc63737 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/index.po @@ -0,0 +1,26 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/index.rst:3 +msgid "Types" +msgstr "" + +#: ../../api/enums/index.rst:5 +msgid "Here is list of all available enums:" +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 new file mode 100644 index 0000000000..27a5da7ec0 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/inline_query_result_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../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 "" + +#: aiogram.enums.inline_query_result_type.InlineQueryResultType:3 of +msgid "Source: https://core.telegram.org/bots/api#maskposition" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/input_media_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/input_media_type.po new file mode 100644 index 0000000000..2115e5925f --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/input_media_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/input_media_type.rst:3 +msgid "InputMediaType" +msgstr "" + +#: aiogram.enums.input_media_type.InputMediaType:1 of +msgid "This object represents input media type" +msgstr "" + +#: aiogram.enums.input_media_type.InputMediaType:3 of +msgid "Source: https://core.telegram.org/bots/api#inputmedia" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/mask_position_point.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/mask_position_point.po new file mode 100644 index 0000000000..fde3a7715a --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/mask_position_point.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/mask_position_point.rst:3 +msgid "MaskPositionPoint" +msgstr "" + +#: aiogram.enums.mask_position_point.MaskPositionPoint:1 of +msgid "The part of the face relative to which the mask should be placed." +msgstr "" + +#: aiogram.enums.mask_position_point.MaskPositionPoint:3 of +msgid "Source: https://core.telegram.org/bots/api#maskposition" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/menu_button_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/menu_button_type.po new file mode 100644 index 0000000000..d7c0adc881 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/menu_button_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/menu_button_type.rst:3 +msgid "MenuButtonType" +msgstr "" + +#: aiogram.enums.menu_button_type.MenuButtonType:1 of +msgid "This object represents an type of Menu button" +msgstr "" + +#: aiogram.enums.menu_button_type.MenuButtonType:3 of +msgid "Source: https://core.telegram.org/bots/api#menubuttondefault" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/message_entity_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/message_entity_type.po new file mode 100644 index 0000000000..3704373b05 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/message_entity_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/message_entity_type.rst:3 +msgid "MessageEntityType" +msgstr "" + +#: aiogram.enums.message_entity_type.MessageEntityType:1 of +msgid "This object represents type of message entity" +msgstr "" + +#: aiogram.enums.message_entity_type.MessageEntityType:3 of +msgid "Source: https://core.telegram.org/bots/api#messageentity" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/parse_mode.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/parse_mode.po new file mode 100644 index 0000000000..cc565d5d81 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/parse_mode.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/parse_mode.rst:3 +msgid "ParseMode" +msgstr "" + +#: aiogram.enums.parse_mode.ParseMode:1 of +msgid "Formatting options" +msgstr "" + +#: aiogram.enums.parse_mode.ParseMode:3 of +msgid "Source: https://core.telegram.org/bots/api#formatting-options" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/poll_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/poll_type.po new file mode 100644 index 0000000000..42d2ab1571 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/poll_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/poll_type.rst:3 +msgid "PollType" +msgstr "" + +#: aiogram.enums.poll_type.PollType:1 of +msgid "This object represents poll type" +msgstr "" + +#: aiogram.enums.poll_type.PollType:3 of +msgid "Source: https://core.telegram.org/bots/api#poll" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/topic_icon_color.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/topic_icon_color.po new file mode 100644 index 0000000000..f1a6c28887 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/topic_icon_color.po @@ -0,0 +1,32 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/topic_icon_color.rst:3 +msgid "TopicIconColor" +msgstr "" + +#: aiogram.enums.topic_icon_color.TopicIconColor:1 of +msgid "Color of the topic icon in RGB format." +msgstr "" + +#: aiogram.enums.topic_icon_color.TopicIconColor:3 of +msgid "" +"Source: " +"https://github.com/telegramdesktop/tdesktop/blob/991fe491c5ae62705d77aa8fdd44a79caf639c45/Telegram/SourceFiles/data/data_forum_topic.cpp#L51-L56" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/enums/update_type.po b/docs/locale/uk_UA/LC_MESSAGES/api/enums/update_type.po new file mode 100644 index 0000000000..1a19127625 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/enums/update_type.po @@ -0,0 +1,30 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-11-23 00:47+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" + +#: ../../api/enums/update_type.rst:3 +msgid "UpdateType" +msgstr "" + +#: aiogram.enums.update_type.UpdateType:1 of +msgid "This object represents the complete list of allowed update types" +msgstr "" + +#: aiogram.enums.update_type.UpdateType:3 of +msgid "Source: https://core.telegram.org/bots/api#update" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_callback_query.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_callback_query.po index 8b8535edbc..2370aa3c74 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_callback_query.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_callback_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -120,6 +120,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/answer_callback_query.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/answer_callback_query.rst:50 +msgid ":meth:`aiogram.types.callback_query.CallbackQuery.answer`" +msgstr "" + #~ msgid "" #~ "Use this method to send answers to" #~ " callback queries sent from `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_inline_query.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_inline_query.po index 80a46ddd7d..22834a6704 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_inline_query.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/answer_inline_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -123,6 +123,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/answer_inline_query.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/answer_inline_query.rst:50 +msgid ":meth:`aiogram.types.inline_query.InlineQuery.answer`" +msgstr "" + #~ msgid "" #~ "`Deep-linking `_ parameter for the /start " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/approve_chat_join_request.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/approve_chat_join_request.po index dcc8324c42..9350431976 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/approve_chat_join_request.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/approve_chat_join_request.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/approve_chat_join_request.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/approve_chat_join_request.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/approve_chat_join_request.rst:50 +msgid ":meth:`aiogram.types.chat_join_request.ChatJoinRequest.approve`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_member.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_member.po index cd25abd1b6..487b0d38af 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_member.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -98,3 +98,11 @@ msgstr "" #: ../../api/methods/ban_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/ban_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/ban_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.ban`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_sender_chat.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_sender_chat.po index 16e088231c..410a0c8ebf 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_sender_chat.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/ban_chat_sender_chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/ban_chat_sender_chat.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/ban_chat_sender_chat.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/ban_chat_sender_chat.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.ban_sender_chat`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/copy_message.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/copy_message.po index 93a1ae1aa6..f30e9b73f9 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/copy_message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/copy_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -149,6 +149,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/copy_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/copy_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.copy_to`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_chat_invite_link.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_chat_invite_link.po index 0d13a53b25..7099e1d325 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_chat_invite_link.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_chat_invite_link.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -108,3 +108,11 @@ msgstr "" #: ../../api/methods/create_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/create_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/create_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.create_invite_link`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_forum_topic.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_forum_topic.po index 0baca81133..20e71139f3 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_forum_topic.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/create_forum_topic.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -52,8 +52,9 @@ msgstr "" #: ../../docstring #: aiogram.methods.create_forum_topic.CreateForumTopic.icon_color:1 of msgid "" -"Color of the topic icon in RGB format. Currently, must be one of " -"0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F" +"Color of the topic icon in RGB format. Currently, must be one of 7322096 " +"(0x6FB9F0), 16766590 (0xFFD67E), 13338331 (0xCB86DB), 9367192 (0x8EEE98)," +" 16749490 (0xFF93B2), or 16478047 (0xFB6F5F)" msgstr "" #: ../../docstring @@ -96,3 +97,10 @@ msgstr "" #: ../../api/methods/create_forum_topic.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Color of the topic icon in RGB " +#~ "format. Currently, must be one of " +#~ "0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, " +#~ "0xFF93B2, or 0xFB6F5F" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/decline_chat_join_request.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/decline_chat_join_request.po index 2aaaf0d017..9d632f5d82 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/decline_chat_join_request.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/decline_chat_join_request.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/decline_chat_join_request.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/decline_chat_join_request.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/decline_chat_join_request.rst:50 +msgid ":meth:`aiogram.types.chat_join_request.ChatJoinRequest.decline`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_photo.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_photo.po index 724ea63fd3..758102ab98 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_photo.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_photo.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -75,3 +75,11 @@ msgstr "" #: ../../api/methods/delete_chat_photo.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_chat_photo.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_chat_photo.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.delete_photo`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_sticker_set.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_sticker_set.po index 7c513e23be..3b5e83323a 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_sticker_set.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_chat_sticker_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -79,3 +79,11 @@ msgstr "" #: ../../api/methods/delete_chat_sticker_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_chat_sticker_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_chat_sticker_set.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.delete_sticker_set`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_message.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_message.po index 6b3c136b42..d2a793d3b4 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -124,3 +124,15 @@ msgstr "" #: ../../api/methods/delete_message.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.delete`" +msgstr "" + +#: ../../api/methods/delete_message.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.delete_message`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_from_set.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_from_set.po index d88640deaf..e14f908164 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_from_set.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/delete_sticker_from_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -73,3 +73,11 @@ msgstr "" #: ../../api/methods/delete_sticker_from_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/delete_sticker_from_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/delete_sticker_from_set.rst:50 +msgid ":meth:`aiogram.types.sticker.Sticker.delete_from_set`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_chat_invite_link.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_chat_invite_link.po index a55d344e7b..6efd01b123 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_chat_invite_link.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_chat_invite_link.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -108,3 +108,11 @@ msgstr "" #: ../../api/methods/edit_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/edit_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.edit_invite_link`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_forum_topic.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_forum_topic.po index 7c2214cbee..b79ff4c79f 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_forum_topic.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_forum_topic.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -57,7 +57,7 @@ msgstr "" msgid "" "New unique identifier of the custom emoji shown as the topic icon. Use " ":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" -" to get all allowed custom emoji identifiers" +" to get all allowed custom emoji identifiers." msgstr "" #: ../../api/methods/edit_forum_topic.rst:14 @@ -91,3 +91,12 @@ msgstr "" #: ../../api/methods/edit_forum_topic.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "New unique identifier of the custom " +#~ "emoji shown as the topic icon. Use" +#~ " " +#~ ":class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers`" +#~ " to get all allowed custom emoji " +#~ "identifiers" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_message_caption.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_message_caption.po index 65c26608a2..a566ee5e41 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_message_caption.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/edit_message_caption.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -122,6 +122,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_caption.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_caption.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_caption`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -141,6 +141,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_live_location.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_live_location.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_live_location`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for a new" #~ " `inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -107,6 +107,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_media.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_media.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_media`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for a new" #~ " `inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -104,6 +104,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_reply_markup.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_reply_markup.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_reply_markup`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -124,6 +124,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/edit_message_text.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/edit_message_text.rst:50 +msgid ":meth:`aiogram.types.message.Message.edit_text`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -91,3 +91,11 @@ msgstr "" #: ../../api/methods/export_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/export_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/export_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.export_invite_link`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/forward_message.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/forward_message.po index db6dd82513..43f90fbf08 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/forward_message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/forward_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -105,5 +105,13 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/forward_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/forward_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.forward`" +msgstr "" + #~ msgid "As message method" #~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_administrators.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_administrators.po index a840dc464b..7700abdce7 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_administrators.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_administrators.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -75,3 +75,11 @@ msgstr "" #: ../../api/methods/get_chat_administrators.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_chat_administrators.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_chat_administrators.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.get_administrators`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member.po index 953ea21918..56aedd8364 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -75,3 +75,11 @@ msgstr "" #: ../../api/methods/get_chat_member.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_chat_member.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_chat_member.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.get_member`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member_count.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member_count.po index 7ad69e4a6d..6fc48c9fc7 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member_count.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_member_count.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -71,3 +71,11 @@ msgstr "" #: ../../api/methods/get_chat_member_count.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_chat_member_count.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_chat_member_count.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.get_member_count`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_members_count.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_members_count.po index c3c623ae12..e747a5f44a 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_members_count.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_chat_members_count.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -25,23 +25,6 @@ msgstr "" msgid "Returns: :obj:`int`" msgstr "" -#: aiogram.methods.get_chat_members_count.GetChatMembersCount:5 of -msgid "" -"Use this method to get the number of members in a chat. Returns *Int* on " -"success." -msgstr "" - -#: aiogram.methods.get_chat_members_count.GetChatMembersCount:7 of -msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" -msgstr "" - -#: ../../docstring -#: aiogram.methods.get_chat_members_count.GetChatMembersCount.chat_id:1 of -msgid "" -"Unique identifier for the target chat or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" -msgstr "" - #: ../../api/methods/get_chat_members_count.rst:14 msgid "Usage" msgstr "" @@ -71,3 +54,19 @@ msgstr "" #: ../../api/methods/get_chat_members_count.rst:33 msgid "With specific bot" msgstr "" + +#~ msgid "" +#~ "Use this method to get the number" +#~ " of members in a chat. Returns " +#~ "*Int* on success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +#~ msgstr "" + +#~ msgid "" +#~ "Unique identifier for the target chat" +#~ " or username of the target supergroup" +#~ " or channel (in the format " +#~ ":code:`@channelusername`)" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_user_profile_photos.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_user_profile_photos.po index c9b43d0b90..bbbeffbce9 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_user_profile_photos.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/get_user_profile_photos.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/get_user_profile_photos.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/get_user_profile_photos.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/get_user_profile_photos.rst:45 +msgid ":meth:`aiogram.types.user.User.get_profile_photos`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/kick_chat_member.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/kick_chat_member.po index 2d1dde8831..d61507e420 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/kick_chat_member.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/kick_chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -25,48 +25,6 @@ msgstr "" msgid "Returns: :obj:`bool`" msgstr "" -#: aiogram.methods.kick_chat_member.KickChatMember:5 of -msgid "" -"Use this method to ban a user in a group, a supergroup or a channel. In " -"the case of supergroups and channels, the user will not be able to return" -" to the chat on their own using invite links, etc., unless `unbanned " -"`_ first. The bot " -"must be an administrator in the chat for this to work and must have the " -"appropriate administrator rights. Returns :code:`True` on success." -msgstr "" - -#: aiogram.methods.kick_chat_member.KickChatMember:7 of -msgid "Source: https://core.telegram.org/bots/api#banchatmember" -msgstr "" - -#: ../../docstring aiogram.methods.kick_chat_member.KickChatMember.chat_id:1 of -msgid "" -"Unique identifier for the target group or username of the target " -"supergroup or channel (in the format :code:`@channelusername`)" -msgstr "" - -#: ../../docstring aiogram.methods.kick_chat_member.KickChatMember.user_id:1 of -msgid "Unique identifier of the target user" -msgstr "" - -#: ../../docstring aiogram.methods.kick_chat_member.KickChatMember.until_date:1 -#: of -msgid "" -"Date when the user will be unbanned, unix time. If user is banned for " -"more than 366 days or less than 30 seconds from the current time they are" -" considered to be banned forever. Applied for supergroups and channels " -"only." -msgstr "" - -#: ../../docstring -#: aiogram.methods.kick_chat_member.KickChatMember.revoke_messages:1 of -msgid "" -"Pass :code:`True` to delete all messages from the chat for the user that " -"is being removed. If :code:`False`, the user will be able to see messages" -" in the group that were sent before the user was removed. Always " -":code:`True` for supergroups and channels." -msgstr "" - #: ../../api/methods/kick_chat_member.rst:14 msgid "Usage" msgstr "" @@ -98,3 +56,53 @@ msgstr "" #: ../../api/methods/kick_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#~ msgid "" +#~ "Use this method to ban a user " +#~ "in a group, a supergroup or a " +#~ "channel. In the case of supergroups " +#~ "and channels, the user will not be" +#~ " able to return to the chat on" +#~ " their own using invite links, etc.," +#~ " unless `unbanned " +#~ "`_ first." +#~ " The bot must be an administrator " +#~ "in the chat for this to work " +#~ "and must have the appropriate " +#~ "administrator rights. Returns :code:`True` on" +#~ " success." +#~ msgstr "" + +#~ msgid "Source: https://core.telegram.org/bots/api#banchatmember" +#~ msgstr "" + +#~ msgid "" +#~ "Unique identifier for the target group" +#~ " or username of the target supergroup" +#~ " or channel (in the format " +#~ ":code:`@channelusername`)" +#~ msgstr "" + +#~ msgid "Unique identifier of the target user" +#~ msgstr "" + +#~ msgid "" +#~ "Date when the user will be " +#~ "unbanned, unix time. If user is " +#~ "banned for more than 366 days or" +#~ " less than 30 seconds from the " +#~ "current time they are considered to " +#~ "be banned forever. Applied for " +#~ "supergroups and channels only." +#~ msgstr "" + +#~ msgid "" +#~ "Pass :code:`True` to delete all messages" +#~ " from the chat for the user " +#~ "that is being removed. If :code:`False`," +#~ " the user will be able to see" +#~ " messages in the group that were " +#~ "sent before the user was removed. " +#~ "Always :code:`True` for supergroups and " +#~ "channels." +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/leave_chat.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/leave_chat.po index bb193089d3..bef135f1ef 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/leave_chat.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/leave_chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -72,3 +72,11 @@ msgstr "" #: ../../api/methods/leave_chat.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/leave_chat.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/leave_chat.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.leave`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/pin_chat_message.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/pin_chat_message.po index 5e2232a366..9a1e84e463 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/pin_chat_message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/pin_chat_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -89,5 +89,17 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/pin_chat_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/pin_chat_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.pin`" +msgstr "" + +#: ../../api/methods/pin_chat_message.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.pin_message`" +msgstr "" + #~ msgid "As message method" #~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/promote_chat_member.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/promote_chat_member.po index 202cbbe427..2d9c09785a 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/promote_chat_member.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/promote_chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -162,3 +162,11 @@ msgstr "" #: ../../api/methods/promote_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/promote_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/promote_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.promote`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/restrict_chat_member.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/restrict_chat_member.po index 7a65a99fe0..9c0755b7c6 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/restrict_chat_member.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/restrict_chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -95,3 +95,11 @@ msgstr "" #: ../../api/methods/restrict_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/restrict_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/restrict_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.restrict`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/revoke_chat_invite_link.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/revoke_chat_invite_link.po index e2fecea0ec..b7fee507f8 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/revoke_chat_invite_link.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/revoke_chat_invite_link.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -84,3 +84,11 @@ msgstr "" #: ../../api/methods/revoke_chat_invite_link.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/revoke_chat_invite_link.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/revoke_chat_invite_link.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.revoke_invite_link`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_animation.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_animation.po index 2aefc24d3c..d84eff4261 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_animation.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_animation.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -171,6 +171,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_animation.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_animation.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_animation`" +msgstr "" + +#: ../../api/methods/send_animation.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_animation`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_audio.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_audio.po index b423d293f3..46d0618159 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_audio.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_audio.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -165,6 +165,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_audio.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_audio.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_audio`" +msgstr "" + +#: ../../api/methods/send_audio.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_audio`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_chat_action.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_chat_action.po index a8b2e8be78..e69951eb07 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_chat_action.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_chat_action.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -107,3 +107,11 @@ msgstr "" #: ../../api/methods/send_chat_action.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/send_chat_action.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_chat_action.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.do`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_contact.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_contact.po index a6bb3db852..8ada4c7b8e 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_contact.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_contact.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -131,6 +131,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_contact.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_contact.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_contact`" +msgstr "" + +#: ../../api/methods/send_contact.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_contact`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_dice.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_dice.po index 19cf0438ec..19a52d2f22 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_dice.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_dice.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -118,6 +118,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_dice.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_dice.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_dice`" +msgstr "" + +#: ../../api/methods/send_dice.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_dice`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_document.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_document.po index 334ffbd62e..2b2e658ffc 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_document.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_document.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -163,6 +163,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_document.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_document.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_document`" +msgstr "" + +#: ../../api/methods/send_document.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_document`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_game.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_game.po index 63aa45a7e7..a46e72a023 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_game.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_game.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -112,6 +112,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_game.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_game.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_game`" +msgstr "" + +#: ../../api/methods/send_game.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_game`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -242,6 +242,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_invoice.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_invoice.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_invoice`" +msgstr "" + +#: ../../api/methods/send_invoice.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_invoice`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for an " #~ "`inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -147,6 +147,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_location.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_location.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_location`" +msgstr "" + +#: ../../api/methods/send_location.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_location`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_media_group.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_media_group.po index a325955742..e3d5b3db6e 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_media_group.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_media_group.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -113,3 +113,15 @@ msgstr "" #: ../../api/methods/send_media_group.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/send_media_group.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_media_group.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_media_group`" +msgstr "" + +#: ../../api/methods/send_media_group.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_media_group`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_message.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_message.po index 63c7ac2c9e..e0a83b6d22 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -135,6 +135,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer`" +msgstr "" + +#: ../../api/methods/send_message.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_photo.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_photo.po index 6c58b959f8..496a13a53e 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_photo.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_photo.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -141,6 +141,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_photo.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_photo.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_photo`" +msgstr "" + +#: ../../api/methods/send_photo.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_photo`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_poll.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_poll.po index 9b2d23c2ba..9222d2c3c8 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_poll.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_poll.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -180,6 +180,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_poll.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_poll.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_poll`" +msgstr "" + +#: ../../api/methods/send_poll.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_poll`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " 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 c06c0d6efb..b1e8bcb018 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,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -125,6 +125,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_sticker.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_sticker.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_sticker`" +msgstr "" + +#: ../../api/methods/send_sticker.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_sticker`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_venue.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_venue.po index fe7d74d99c..848d689831 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_venue.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_venue.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -148,6 +148,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_venue.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_venue.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_venue`" +msgstr "" + +#: ../../api/methods/send_venue.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_venue`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video.po index c57d36ce6f..55651775ee 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -171,6 +171,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_video.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_video.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_video`" +msgstr "" + +#: ../../api/methods/send_video.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_video`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video_note.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video_note.po index ee7920ea2c..959a0407eb 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video_note.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_video_note.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -146,6 +146,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_video_note.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_video_note.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_video_note`" +msgstr "" + +#: ../../api/methods/send_video_note.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_video_note`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_voice.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_voice.po index 3e572b26b2..553a326511 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_voice.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/send_voice.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -147,6 +147,18 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/send_voice.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/send_voice.rst:50 +msgid ":meth:`aiogram.types.message.Message.answer_voice`" +msgstr "" + +#: ../../api/methods/send_voice.rst:51 +msgid ":meth:`aiogram.types.message.Message.reply_voice`" +msgstr "" + #~ msgid "" #~ "Additional interface options. A JSON-" #~ "serialized object for an `inline " diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po index 72f3802c45..ee28db9b93 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_administrator_custom_title.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -92,3 +92,11 @@ msgstr "" #: ../../api/methods/set_chat_administrator_custom_title.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_administrator_custom_title.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_administrator_custom_title.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_administrator_custom_title`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_description.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_description.po index e1a0a86a46..3c42aceee2 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_description.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_description.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -82,3 +82,11 @@ msgstr "" #: ../../api/methods/set_chat_description.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_description.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_description.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_description`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_permissions.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_permissions.po index d4e19be637..d27d787881 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_permissions.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_permissions.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -82,3 +82,11 @@ msgstr "" #: ../../api/methods/set_chat_permissions.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_permissions.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_permissions.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_permissions`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_photo.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_photo.po index c94845dc2f..ab0cc9a798 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_photo.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_photo.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -74,3 +74,11 @@ msgstr "" #: ../../api/methods/set_chat_photo.rst:33 msgid "With specific bot" msgstr "" + +#: ../../api/methods/set_chat_photo.rst:43 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_photo.rst:45 +msgid ":meth:`aiogram.types.chat.Chat.set_photo`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_sticker_set.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_sticker_set.po index cf289c2a92..b5441109b1 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_sticker_set.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_sticker_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -82,3 +82,11 @@ msgstr "" #: ../../api/methods/set_chat_sticker_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_chat_sticker_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_sticker_set.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_sticker_set`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_title.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_title.po index 90e78ed63f..da3c936e6f 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_title.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_chat_title.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -79,5 +79,13 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/set_chat_title.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_chat_title.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.set_title`" +msgstr "" + #~ msgid "New chat title, 1-255 characters" #~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_position_in_set.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_position_in_set.po index 977b6e0c06..c7ef9e7ef6 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_position_in_set.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/set_sticker_position_in_set.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -80,3 +80,11 @@ msgstr "" #: ../../api/methods/set_sticker_position_in_set.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/set_sticker_position_in_set.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/set_sticker_position_in_set.rst:50 +msgid ":meth:`aiogram.types.sticker.Sticker.set_position_in_set`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/stop_message_live_location.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/stop_message_live_location.po index 5676516050..e15b616d51 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/stop_message_live_location.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/stop_message_live_location.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -104,6 +104,14 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/stop_message_live_location.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/stop_message_live_location.rst:50 +msgid ":meth:`aiogram.types.message.Message.stop_live_location`" +msgstr "" + #~ msgid "" #~ "A JSON-serialized object for a new" #~ " `inline keyboard \n" "Language-Team: LANGUAGE \n" @@ -89,3 +89,11 @@ msgstr "" #: ../../api/methods/unban_chat_member.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/unban_chat_member.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unban_chat_member.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.unban`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/unban_chat_sender_chat.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unban_chat_sender_chat.po index 333a8e9365..093786e831 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/unban_chat_sender_chat.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unban_chat_sender_chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -83,3 +83,11 @@ msgstr "" #: ../../api/methods/unban_chat_sender_chat.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/unban_chat_sender_chat.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unban_chat_sender_chat.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.unban_sender_chat`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_all_chat_messages.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_all_chat_messages.po index b983221403..879d0ae4e8 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_all_chat_messages.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_all_chat_messages.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -78,3 +78,11 @@ msgstr "" #: ../../api/methods/unpin_all_chat_messages.rst:40 msgid "As reply into Webhook in handler" msgstr "" + +#: ../../api/methods/unpin_all_chat_messages.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unpin_all_chat_messages.rst:50 +msgid ":meth:`aiogram.types.chat.Chat.unpin_all_messages`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_chat_message.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_chat_message.po index 5f08d05427..e184084b7d 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_chat_message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_chat_message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -85,5 +85,17 @@ msgstr "" msgid "As reply into Webhook in handler" msgstr "" +#: ../../api/methods/unpin_chat_message.rst:48 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unpin_chat_message.rst:50 +msgid ":meth:`aiogram.types.message.Message.unpin`" +msgstr "" + +#: ../../api/methods/unpin_chat_message.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.unpin_message`" +msgstr "" + #~ msgid "As message method" #~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/callback_query.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/callback_query.po index e70f9d0232..cb74a99398 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/callback_query.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/callback_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -94,17 +94,81 @@ msgid "" msgstr "" #: aiogram.types.callback_query.CallbackQuery.answer:1 of -msgid "Answer to callback query" +msgid "" +"Shortcut for method " +":class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:4 of +msgid ":code:`callback_query_id`" +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:6 of +msgid "" +"Use this method to send answers to callback queries sent from `inline " +"keyboards `_. " +"The answer will be displayed to the user as a notification at the top of " +"the chat screen or as an alert. On success, :code:`True` is returned." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:8 of +msgid "" +"Alternatively, the user can be redirected to the specified Game URL. For " +"this option to work, you must first create a game for your bot via " +"`@BotFather `_ and accept the terms. Otherwise, " +"you may use links like :code:`t.me/your_bot?start=XXXX` that open your " +"bot with a parameter." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:10 of +msgid "Source: https://core.telegram.org/bots/api#answercallbackquery" msgstr "" #: aiogram.types.callback_query.CallbackQuery.answer of msgid "Parameters" msgstr "" +#: aiogram.types.callback_query.CallbackQuery.answer:12 of +msgid "" +"Text of the notification. If not specified, nothing will be shown to the " +"user, 0-200 characters" +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:13 of +msgid "" +"If :code:`True`, an alert will be shown by the client instead of a " +"notification at the top of the chat screen. Defaults to *false*." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:14 of +msgid "" +"URL that will be opened by the user's client. If you have created a " +":class:`aiogram.types.game.Game` and accepted the conditions via " +"`@BotFather `_, specify the URL that opens your " +"game - note that this will only work if the query comes from a " +"`https://core.telegram.org/bots/api#inlinekeyboardbutton " +"`_ " +"*callback_game* button." +msgstr "" + +#: aiogram.types.callback_query.CallbackQuery.answer:15 of +msgid "" +"The maximum amount of time in seconds that the result of the callback " +"query may be cached client-side. Telegram apps will support caching " +"starting in version 3.14. Defaults to 0." +msgstr "" + #: aiogram.types.callback_query.CallbackQuery.answer of msgid "Returns" msgstr "" +#: aiogram.types.callback_query.CallbackQuery.answer:16 of +msgid "" +"instance of method " +":class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery`" +msgstr "" + #~ msgid "" #~ "This object represents an incoming " #~ "callback query from a callback button" @@ -122,3 +186,6 @@ msgstr "" #~ "the fields *data* or *game_short_name* " #~ "will be present." #~ msgstr "" + +#~ msgid "Answer to callback query" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/chat.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/chat.po index 882d5c3036..802289d36a 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/chat.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/chat.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -221,3 +221,1017 @@ msgid "" "For private chat it is first_name + last_name. For other chat types it is" " title." msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.ban:4 aiogram.types.chat.Chat.ban_sender_chat:4 +#: aiogram.types.chat.Chat.create_invite_link:4 +#: aiogram.types.chat.Chat.delete_message:4 +#: aiogram.types.chat.Chat.delete_photo:4 +#: aiogram.types.chat.Chat.delete_sticker_set:4 aiogram.types.chat.Chat.do:4 +#: aiogram.types.chat.Chat.edit_invite_link:4 +#: aiogram.types.chat.Chat.export_invite_link:4 +#: aiogram.types.chat.Chat.get_administrators:4 +#: aiogram.types.chat.Chat.get_member:4 +#: aiogram.types.chat.Chat.get_member_count:4 aiogram.types.chat.Chat.leave:4 +#: aiogram.types.chat.Chat.pin_message:4 aiogram.types.chat.Chat.promote:4 +#: aiogram.types.chat.Chat.restrict:4 +#: aiogram.types.chat.Chat.revoke_invite_link:4 +#: aiogram.types.chat.Chat.set_administrator_custom_title:4 +#: aiogram.types.chat.Chat.set_description:4 +#: aiogram.types.chat.Chat.set_permissions:4 +#: aiogram.types.chat.Chat.set_photo:4 +#: aiogram.types.chat.Chat.set_sticker_set:4 +#: aiogram.types.chat.Chat.set_title:4 aiogram.types.chat.Chat.unban:4 +#: aiogram.types.chat.Chat.unban_sender_chat:4 +#: aiogram.types.chat.Chat.unpin_all_messages:4 +#: aiogram.types.chat.Chat.unpin_message:4 of +msgid ":code:`chat_id`" +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:6 of +msgid "" +"Use this method to ban a channel chat in a supergroup or a channel. Until" +" the chat is `unbanned " +"`_, the owner of " +"the banned chat won't be able to send messages on behalf of **any of " +"their channels**. The bot must be an administrator in the supergroup or " +"channel for this to work and must have the appropriate administrator " +"rights. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:8 of +msgid "Source: https://core.telegram.org/bots/api#banchatsenderchat" +msgstr "" + +#: aiogram.types.chat.Chat.ban aiogram.types.chat.Chat.ban_sender_chat +#: aiogram.types.chat.Chat.create_invite_link +#: aiogram.types.chat.Chat.delete_message aiogram.types.chat.Chat.do +#: aiogram.types.chat.Chat.edit_invite_link aiogram.types.chat.Chat.get_member +#: aiogram.types.chat.Chat.pin_message aiogram.types.chat.Chat.promote +#: aiogram.types.chat.Chat.restrict aiogram.types.chat.Chat.revoke_invite_link +#: aiogram.types.chat.Chat.set_administrator_custom_title +#: aiogram.types.chat.Chat.set_description +#: aiogram.types.chat.Chat.set_permissions aiogram.types.chat.Chat.set_photo +#: aiogram.types.chat.Chat.set_sticker_set aiogram.types.chat.Chat.set_title +#: aiogram.types.chat.Chat.unban aiogram.types.chat.Chat.unban_sender_chat +#: aiogram.types.chat.Chat.unpin_message of +msgid "Parameters" +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:10 +#: aiogram.types.chat.Chat.unban_sender_chat:10 of +msgid "Unique identifier of the target sender chat" +msgstr "" + +#: aiogram.types.chat.Chat.ban aiogram.types.chat.Chat.ban_sender_chat +#: aiogram.types.chat.Chat.create_invite_link +#: aiogram.types.chat.Chat.delete_message aiogram.types.chat.Chat.delete_photo +#: aiogram.types.chat.Chat.delete_sticker_set aiogram.types.chat.Chat.do +#: aiogram.types.chat.Chat.edit_invite_link +#: aiogram.types.chat.Chat.export_invite_link +#: aiogram.types.chat.Chat.get_administrators +#: aiogram.types.chat.Chat.get_member aiogram.types.chat.Chat.get_member_count +#: aiogram.types.chat.Chat.leave aiogram.types.chat.Chat.pin_message +#: aiogram.types.chat.Chat.promote aiogram.types.chat.Chat.restrict +#: aiogram.types.chat.Chat.revoke_invite_link +#: aiogram.types.chat.Chat.set_administrator_custom_title +#: aiogram.types.chat.Chat.set_description +#: aiogram.types.chat.Chat.set_permissions aiogram.types.chat.Chat.set_photo +#: aiogram.types.chat.Chat.set_sticker_set aiogram.types.chat.Chat.set_title +#: aiogram.types.chat.Chat.unban aiogram.types.chat.Chat.unban_sender_chat +#: aiogram.types.chat.Chat.unpin_all_messages +#: aiogram.types.chat.Chat.unpin_message of +msgid "Returns" +msgstr "" + +#: aiogram.types.chat.Chat.ban_sender_chat:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat`" +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:6 of +msgid "" +"Use this method to unban a previously banned channel chat in a supergroup" +" or channel. The bot must be an administrator for this to work and must " +"have the appropriate administrator rights. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:8 of +msgid "Source: https://core.telegram.org/bots/api#unbanchatsenderchat" +msgstr "" + +#: aiogram.types.chat.Chat.unban_sender_chat:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat`" +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_chat_administrators.GetChatAdministrators` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:6 of +msgid "" +"Use this method to get a list of administrators in a chat, which aren't " +"bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` " +"objects." +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:8 of +msgid "Source: https://core.telegram.org/bots/api#getchatadministrators" +msgstr "" + +#: aiogram.types.chat.Chat.get_administrators:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.get_chat_administrators.GetChatAdministrators`" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:6 of +msgid "" +"Use this method to delete a message, including service messages, with the" +" following limitations:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:8 of +msgid "A message can only be deleted if it was sent less than 48 hours ago." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:10 of +msgid "" +"Service messages about a supergroup, channel, or forum topic creation " +"can't be deleted." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:12 of +msgid "" +"A dice message in a private chat can only be deleted if it was sent more " +"than 24 hours ago." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:14 of +msgid "" +"Bots can delete outgoing messages in private chats, groups, and " +"supergroups." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:16 of +msgid "Bots can delete incoming messages in private chats." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:18 of +msgid "" +"Bots granted *can_post_messages* permissions can delete outgoing messages" +" in channels." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:20 of +msgid "" +"If the bot is an administrator of a group, it can delete any message " +"there." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:22 of +msgid "" +"If the bot has *can_delete_messages* permission in a supergroup or a " +"channel, it can delete any message there." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:24 of +msgid "Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:26 of +msgid "Source: https://core.telegram.org/bots/api#deletemessage" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:28 of +msgid "Identifier of the message to delete" +msgstr "" + +#: aiogram.types.chat.Chat.delete_message:29 of +msgid "instance of method :class:`aiogram.methods.delete_message.DeleteMessage`" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:6 of +msgid "" +"Use this method to revoke an invite link created by the bot. If the " +"primary link is revoked, a new link is automatically generated. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns the revoked invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:8 of +msgid "Source: https://core.telegram.org/bots/api#revokechatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:10 of +msgid "The invite link to revoke" +msgstr "" + +#: aiogram.types.chat.Chat.revoke_invite_link:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:6 of +msgid "" +"Use this method to edit a non-primary invite link created by the bot. The" +" bot must be an administrator in the chat for this to work and must have " +"the appropriate administrator rights. Returns the edited invite link as a" +" :class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:8 of +msgid "Source: https://core.telegram.org/bots/api#editchatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:10 of +msgid "The invite link to edit" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:10 +#: aiogram.types.chat.Chat.edit_invite_link:11 of +msgid "Invite link name; 0-32 characters" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:11 +#: aiogram.types.chat.Chat.edit_invite_link:12 of +msgid "Point in time (Unix timestamp) when the link will expire" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:12 +#: aiogram.types.chat.Chat.edit_invite_link:13 of +msgid "" +"The maximum number of users that can be members of the chat " +"simultaneously after joining the chat via this invite link; 1-99999" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:13 +#: aiogram.types.chat.Chat.edit_invite_link:14 of +msgid "" +":code:`True`, if users joining the chat via the link need to be approved " +"by chat administrators. If :code:`True`, *member_limit* can't be " +"specified" +msgstr "" + +#: aiogram.types.chat.Chat.edit_invite_link:15 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:6 of +msgid "" +"Use this method to create an additional invite link for a chat. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. The link can be revoked using the " +"method " +":class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. " +"Returns the new invite link as " +":class:`aiogram.types.chat_invite_link.ChatInviteLink` object." +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:8 of +msgid "Source: https://core.telegram.org/bots/api#createchatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.create_invite_link:14 of +msgid "" +"instance of method " +":class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:6 of +msgid "" +"Use this method to generate a new primary invite link for a chat; any " +"previously generated primary link is revoked. The bot must be an " +"administrator in the chat for this to work and must have the appropriate " +"administrator rights. Returns the new invite link as *String* on success." +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:8 of +msgid "" +"Note: Each administrator in a chat generates their own invite links. Bots" +" can't use invite links generated by other administrators. If you want " +"your bot to work with invite links, it will need to generate its own link" +" using " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or " +"by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your " +"bot needs to generate a new primary invite link replacing its previous " +"one, use " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` " +"again." +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:10 of +msgid "Source: https://core.telegram.org/bots/api#exportchatinvitelink" +msgstr "" + +#: aiogram.types.chat.Chat.export_invite_link:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink`" +msgstr "" + +#: aiogram.types.chat.Chat.do:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.send_chat_action.SendChatAction` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.do:6 of +msgid "" +"Use this method when you need to tell the user that something is " +"happening on the bot's side. The status is set for 5 seconds or less " +"(when a message arrives from your bot, Telegram clients clear its typing " +"status). Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.do:8 of +msgid "" +"Example: The `ImageBot `_ needs some time to " +"process a request and upload the image. Instead of sending a text message" +" along the lines of 'Retrieving image, please wait…', the bot may use " +":class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = " +"*upload_photo*. The user will see a 'sending photo' status for the bot." +msgstr "" + +#: aiogram.types.chat.Chat.do:10 of +msgid "" +"We only recommend using this method when a response from the bot will " +"take a **noticeable** amount of time to arrive." +msgstr "" + +#: aiogram.types.chat.Chat.do:12 of +msgid "Source: https://core.telegram.org/bots/api#sendchataction" +msgstr "" + +#: aiogram.types.chat.Chat.do:14 of +msgid "" +"Type of action to broadcast. Choose one, depending on what the user is " +"about to receive: *typing* for `text messages " +"`_, *upload_photo* for " +"`photos `_, *record_video* " +"or *upload_video* for `videos " +"`_, *record_voice* or " +"*upload_voice* for `voice notes " +"`_, *upload_document* for " +"`general files `_, " +"*choose_sticker* for `stickers " +"`_, *find_location* for " +"`location data `_, " +"*record_video_note* or *upload_video_note* for `video notes " +"`_." +msgstr "" + +#: aiogram.types.chat.Chat.do:15 of +msgid "" +"instance of method " +":class:`aiogram.methods.send_chat_action.SendChatAction`" +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:6 of +msgid "" +"Use this method to delete a group sticker set from a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:8 of +msgid "Source: https://core.telegram.org/bots/api#deletechatstickerset" +msgstr "" + +#: aiogram.types.chat.Chat.delete_sticker_set:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet`" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:6 of +msgid "" +"Use this method to set a new group sticker set for a supergroup. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Use the field *can_set_sticker_set* " +"optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests" +" to check if the bot can use this method. Returns :code:`True` on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatstickerset" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:10 of +msgid "Name of the sticker set to be set as the group sticker set" +msgstr "" + +#: aiogram.types.chat.Chat.set_sticker_set:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet`" +msgstr "" + +#: aiogram.types.chat.Chat.get_member:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_chat_member.GetChatMember` will automatically" +" fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.get_member:6 of +msgid "" +"Use this method to get information about a member of a chat. Returns a " +":class:`aiogram.types.chat_member.ChatMember` object on success." +msgstr "" + +#: aiogram.types.chat.Chat.get_member:8 of +msgid "Source: https://core.telegram.org/bots/api#getchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.ban:10 aiogram.types.chat.Chat.get_member:10 +#: aiogram.types.chat.Chat.promote:10 aiogram.types.chat.Chat.restrict:10 +#: aiogram.types.chat.Chat.set_administrator_custom_title:10 +#: aiogram.types.chat.Chat.unban:10 of +msgid "Unique identifier of the target user" +msgstr "" + +#: aiogram.types.chat.Chat.get_member:11 of +msgid "instance of method :class:`aiogram.methods.get_chat_member.GetChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_chat_member_count.GetChatMemberCount` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:6 of +msgid "" +"Use this method to get the number of members in a chat. Returns *Int* on " +"success." +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:8 of +msgid "Source: https://core.telegram.org/bots/api#getchatmembercount" +msgstr "" + +#: aiogram.types.chat.Chat.get_member_count:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.get_chat_member_count.GetChatMemberCount`" +msgstr "" + +#: aiogram.types.chat.Chat.leave:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.leave_chat.LeaveChat` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.leave:6 of +msgid "" +"Use this method for your bot to leave a group, supergroup or channel. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.leave:8 of +msgid "Source: https://core.telegram.org/bots/api#leavechat" +msgstr "" + +#: aiogram.types.chat.Chat.leave:10 of +msgid "instance of method :class:`aiogram.methods.leave_chat.LeaveChat`" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:6 of +msgid "" +"Use this method to clear the list of pinned messages in a chat. If the " +"chat is not a private chat, the bot must be an administrator in the chat " +"for this to work and must have the 'can_pin_messages' administrator right" +" in a supergroup or 'can_edit_messages' administrator right in a channel." +" Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:8 of +msgid "Source: https://core.telegram.org/bots/api#unpinallchatmessages" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_messages:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages`" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:6 of +msgid "" +"Use this method to remove a message from the list of pinned messages in a" +" chat. If the chat is not a private chat, the bot must be an " +"administrator in the chat for this to work and must have the " +"'can_pin_messages' administrator right in a supergroup or " +"'can_edit_messages' administrator right in a channel. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:8 of +msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:10 of +msgid "" +"Identifier of a message to unpin. If not specified, the most recent " +"pinned message (by sending date) will be unpinned." +msgstr "" + +#: aiogram.types.chat.Chat.unpin_message:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage`" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:6 of +msgid "" +"Use this method to add a message to the list of pinned messages in a " +"chat. If the chat is not a private chat, the bot must be an administrator" +" in the chat for this to work and must have the 'can_pin_messages' " +"administrator right in a supergroup or 'can_edit_messages' administrator " +"right in a channel. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:8 of +msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:10 of +msgid "Identifier of a message to pin" +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:11 of +msgid "" +"Pass :code:`True` if it is not necessary to send a notification to all " +"chat members about the new pinned message. Notifications are always " +"disabled in channels and private chats." +msgstr "" + +#: aiogram.types.chat.Chat.pin_message:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage`" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:6 of +msgid "" +"Use this method to set a custom title for an administrator in a " +"supergroup promoted by the bot. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:11 of +msgid "" +"New custom title for the administrator; 0-16 characters, emoji are not " +"allowed" +msgstr "" + +#: aiogram.types.chat.Chat.set_administrator_custom_title:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle`" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_permissions.SetChatPermissions` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:6 of +msgid "" +"Use this method to set default chat permissions for all members. The bot " +"must be an administrator in the group or a supergroup for this to work " +"and must have the *can_restrict_members* administrator rights. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatpermissions" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:10 of +msgid "A JSON-serialized object for new default chat permissions" +msgstr "" + +#: aiogram.types.chat.Chat.set_permissions:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_permissions.SetChatPermissions`" +msgstr "" + +#: aiogram.types.chat.Chat.promote:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.promote_chat_member.PromoteChatMember` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.promote:6 of +msgid "" +"Use this method to promote or demote a user in a supergroup or a channel." +" The bot must be an administrator in the chat for this to work and must " +"have the appropriate administrator rights. Pass :code:`False` for all " +"boolean parameters to demote a user. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.promote:8 of +msgid "Source: https://core.telegram.org/bots/api#promotechatmember" +msgstr "" + +#: aiogram.types.chat.Chat.promote:11 of +msgid "Pass :code:`True` if the administrator's presence in the chat is hidden" +msgstr "" + +#: aiogram.types.chat.Chat.promote:12 of +msgid "" +"Pass :code:`True` if the administrator can access the chat event log, " +"chat statistics, message statistics in channels, see channel members, see" +" anonymous administrators in supergroups and ignore slow mode. Implied by" +" any other administrator privilege" +msgstr "" + +#: aiogram.types.chat.Chat.promote:13 of +msgid "" +"Pass :code:`True` if the administrator can create channel posts, channels" +" only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:14 of +msgid "" +"Pass :code:`True` if the administrator can edit messages of other users " +"and can pin messages, channels only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:15 of +msgid "Pass :code:`True` if the administrator can delete messages of other users" +msgstr "" + +#: aiogram.types.chat.Chat.promote:16 of +msgid "Pass :code:`True` if the administrator can manage video chats" +msgstr "" + +#: aiogram.types.chat.Chat.promote:17 of +msgid "" +"Pass :code:`True` if the administrator can restrict, ban or unban chat " +"members" +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 " +"promoted, directly or indirectly (promoted by administrators that were " +"appointed by him)" +msgstr "" + +#: aiogram.types.chat.Chat.promote:19 of +msgid "" +"Pass :code:`True` if the administrator can change chat title, photo and " +"other settings" +msgstr "" + +#: aiogram.types.chat.Chat.promote:20 of +msgid "Pass :code:`True` if the administrator can invite new users to the chat" +msgstr "" + +#: aiogram.types.chat.Chat.promote:21 of +msgid "Pass :code:`True` if the administrator can pin messages, supergroups only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:22 of +msgid "" +"Pass :code:`True` if the user is allowed to create, rename, close, and " +"reopen forum topics, supergroups only" +msgstr "" + +#: aiogram.types.chat.Chat.promote:23 of +msgid "" +"instance of method " +":class:`aiogram.methods.promote_chat_member.PromoteChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.restrict_chat_member.RestrictChatMember` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:6 of +msgid "" +"Use this method to restrict a user in a supergroup. The bot must be an " +"administrator in the supergroup for this to work and must have the " +"appropriate administrator rights. Pass :code:`True` for all permissions " +"to lift restrictions from a user. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.restrict:8 of +msgid "Source: https://core.telegram.org/bots/api#restrictchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:11 of +msgid "A JSON-serialized object for new user permissions" +msgstr "" + +#: aiogram.types.chat.Chat.restrict:12 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 +msgid "" +"instance of method " +":class:`aiogram.methods.restrict_chat_member.RestrictChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.unban:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unban_chat_member.UnbanChatMember` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unban:6 of +msgid "" +"Use this method to unban a previously banned user in a supergroup or " +"channel. The user will **not** return to the group or channel " +"automatically, but will be able to join via link, etc. The bot must be an" +" administrator for this to work. By default, this method guarantees that " +"after the call the user is not a member of the chat, but will be able to " +"join it. So if the user is a member of the chat they will also be " +"**removed** from the chat. If you don't want this, use the parameter " +"*only_if_banned*. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.unban:8 of +msgid "Source: https://core.telegram.org/bots/api#unbanchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.unban:11 of +msgid "Do nothing if the user is not banned" +msgstr "" + +#: aiogram.types.chat.Chat.unban:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.unban_chat_member.UnbanChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.ban:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.ban_chat_member.BanChatMember` will automatically" +" fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.ban:6 of +msgid "" +"Use this method to ban a user in a group, a supergroup or a channel. In " +"the case of supergroups and channels, the user will not be able to return" +" to the chat on their own using invite links, etc., unless `unbanned " +"`_ first. The bot " +"must be an administrator in the chat for this to work and must have the " +"appropriate administrator rights. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.ban:8 of +msgid "Source: https://core.telegram.org/bots/api#banchatmember" +msgstr "" + +#: aiogram.types.chat.Chat.ban:11 of +msgid "" +"Date when the user will be unbanned, unix time. If user is banned for " +"more than 366 days or less than 30 seconds from the current time they are" +" considered to be banned forever. Applied for supergroups and channels " +"only." +msgstr "" + +#: aiogram.types.chat.Chat.ban:12 of +msgid "" +"Pass :code:`True` to delete all messages from the chat for the user that " +"is being removed. If :code:`False`, the user will be able to see messages" +" in the group that were sent before the user was removed. Always " +":code:`True` for supergroups and channels." +msgstr "" + +#: aiogram.types.chat.Chat.ban:13 of +msgid "instance of method :class:`aiogram.methods.ban_chat_member.BanChatMember`" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_chat_description.SetChatDescription` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:6 of +msgid "" +"Use this method to change the description of a group, a supergroup or a " +"channel. The bot must be an administrator in the chat for this to work " +"and must have the appropriate administrator rights. Returns :code:`True` " +"on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_description:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatdescription" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:10 of +msgid "New chat description, 0-255 characters" +msgstr "" + +#: aiogram.types.chat.Chat.set_description:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_chat_description.SetChatDescription`" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.set_chat_title.SetChatTitle` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:6 of +msgid "" +"Use this method to change the title of a chat. Titles can't be changed " +"for private chats. The bot must be an administrator in the chat for this " +"to work and must have the appropriate administrator rights. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_title:8 of +msgid "Source: https://core.telegram.org/bots/api#setchattitle" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:10 of +msgid "New chat title, 1-128 characters" +msgstr "" + +#: aiogram.types.chat.Chat.set_title:11 of +msgid "instance of method :class:`aiogram.methods.set_chat_title.SetChatTitle`" +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:6 of +msgid "" +"Use this method to delete a chat photo. Photos can't be changed for " +"private chats. The bot must be an administrator in the chat for this to " +"work and must have the appropriate administrator rights. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:8 of +msgid "Source: https://core.telegram.org/bots/api#deletechatphoto" +msgstr "" + +#: aiogram.types.chat.Chat.delete_photo:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto`" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.set_chat_photo.SetChatPhoto` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:6 of +msgid "" +"Use this method to set a new profile photo for the chat. Photos can't be " +"changed for private chats. The bot must be an administrator in the chat " +"for this to work and must have the appropriate administrator rights. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:8 of +msgid "Source: https://core.telegram.org/bots/api#setchatphoto" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:10 of +msgid "New chat photo, uploaded using multipart/form-data" +msgstr "" + +#: aiogram.types.chat.Chat.set_photo:11 of +msgid "instance of method :class:`aiogram.methods.set_chat_photo.SetChatPhoto`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_join_request.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_join_request.po index 41ec1522e8..0349c899ec 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_join_request.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_join_request.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -54,9 +54,70 @@ msgid "" msgstr "" #: aiogram.types.chat_join_request.ChatJoinRequest.approve:1 of -msgid "Use this method to approve a chat join request." +msgid "" +"Shortcut for method " +":class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:4 +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:4 of +msgid ":code:`chat_id`" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:5 +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:5 of +msgid ":code:`user_id`" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:7 of +msgid "" +"Use this method to approve a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:9 of +msgid "Source: https://core.telegram.org/bots/api#approvechatjoinrequest" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve +#: aiogram.types.chat_join_request.ChatJoinRequest.decline of +msgid "Returns" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.approve:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest`" msgstr "" #: aiogram.types.chat_join_request.ChatJoinRequest.decline:1 of -msgid "Use this method to decline a chat join request." +msgid "" +"Shortcut for method " +":class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest`" +" will automatically fill method attributes:" msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:7 of +msgid "" +"Use this method to decline a chat join request. The bot must be an " +"administrator in the chat for this to work and must have the " +"*can_invite_users* administrator right. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:9 of +msgid "Source: https://core.telegram.org/bots/api#declinechatjoinrequest" +msgstr "" + +#: aiogram.types.chat_join_request.ChatJoinRequest.decline:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest`" +msgstr "" + +#~ msgid "Use this method to approve a chat join request." +#~ msgstr "" + +#~ msgid "Use this method to decline a chat join request." +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_member.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_member.po index 2ac6bbc4f7..87fe233103 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_member.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/chat_member.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -56,7 +56,7 @@ msgid "Source: https://core.telegram.org/bots/api#chatmember" msgstr "" #: ../../docstring aiogram.types.chat_member.ChatMember.status:1 of -msgid "..." +msgid "The member's status in the chat" msgstr "" #: ../../docstring aiogram.types.chat_member.ChatMember.user:1 of @@ -191,3 +191,6 @@ msgid "" "*Optional*. Date when restrictions will be lifted for this user; unix " "time. If 0, then the user is restricted forever" msgstr "" + +#~ msgid "..." +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/index.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/index.po index e0e624ee84..c749306843 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/index.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/index.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -25,34 +25,33 @@ msgstr "" msgid "Here is list of all available API types:" msgstr "" -#: ../../api/types/index.rst:10 -msgid "Getting updates" +#: ../../api/types/index.rst:9 +msgid "Inline mode" msgstr "" -#: ../../api/types/index.rst:19 +#: ../../api/types/index.rst:46 msgid "Available types" msgstr "" -#: ../../api/types/index.rst:101 -msgid "Stickers" +#: ../../api/types/index.rst:130 +msgid "Telegram Passport" msgstr "" -#: ../../api/types/index.rst:111 -msgid "Inline mode" +#: ../../api/types/index.rst:151 +msgid "Getting updates" msgstr "" -#: ../../api/types/index.rst:148 -msgid "Payments" +#: ../../api/types/index.rst:160 +msgid "Stickers" msgstr "" -#: ../../api/types/index.rst:163 -msgid "Telegram Passport" +#: ../../api/types/index.rst:170 +msgid "Payments" msgstr "" -#: ../../api/types/index.rst:184 +#: ../../api/types/index.rst:185 msgid "Games" msgstr "" -#: ../../api/types/index.rst:195 -msgid "Internal events" -msgstr "" +#~ msgid "Internal events" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/inline_query.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/inline_query.po index 286303363e..4146b04946 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/inline_query.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/inline_query.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -60,10 +60,81 @@ msgstr "" msgid "*Optional*. Sender location, only for bots that request user location" msgstr "" +#: aiogram.types.inline_query.InlineQuery.answer:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.answer_inline_query.AnswerInlineQuery` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:4 of +msgid ":code:`inline_query_id`" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:6 of +msgid "" +"Use this method to send answers to an inline query. On success, " +":code:`True` is returned." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:8 of +msgid "No more than **50** results per query are allowed." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:10 of +msgid "Source: https://core.telegram.org/bots/api#answerinlinequery" +msgstr "" + #: aiogram.types.inline_query.InlineQuery.answer of msgid "Parameters" msgstr "" +#: aiogram.types.inline_query.InlineQuery.answer:12 of +msgid "A JSON-serialized array of results for the inline query" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:13 of +msgid "" +"The maximum amount of time in seconds that the result of the inline query" +" may be cached on the server. Defaults to 300." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:14 of +msgid "" +"Pass :code:`True` if results may be cached on the server side only for " +"the user that sent the query. By default, results may be returned to any " +"user who sends the same query" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:15 of +msgid "" +"Pass the offset that a client should send in the next query with the same" +" text to receive more results. Pass an empty string if there are no more " +"results or if you don't support pagination. Offset length can't exceed 64" +" bytes." +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:16 of +msgid "" +"If passed, clients will display a button with specified text that " +"switches the user to a private chat with the bot and sends the bot a " +"start message with the parameter *switch_pm_parameter*" +msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:17 of +msgid "" +"`Deep-linking `_ " +"parameter for the /start message sent to the bot when user presses the " +"switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, " +":code:`0-9`, :code:`_` and :code:`-` are allowed." +msgstr "" + #: aiogram.types.inline_query.InlineQuery.answer of msgid "Returns" msgstr "" + +#: aiogram.types.inline_query.InlineQuery.answer:18 of +msgid "" +"instance of method " +":class:`aiogram.methods.answer_inline_query.AnswerInlineQuery`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/menu_button.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/menu_button.po index 09b5fabd66..ad862f2255 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/menu_button.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/menu_button.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -53,7 +53,7 @@ msgid "Source: https://core.telegram.org/bots/api#menubutton" msgstr "" #: ../../docstring aiogram.types.menu_button.MenuButton.type:1 of -msgid "..." +msgid "Type of the button" msgstr "" #: ../../docstring aiogram.types.menu_button.MenuButton.text:1 of @@ -67,3 +67,6 @@ msgid "" "message on behalf of the user using the method " ":class:`aiogram.methods.answer_web_app_query.AnswerWebAppQuery`." msgstr "" + +#~ msgid "..." +#~ 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 bab449e028..b51e09c80d 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/message.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/message.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -378,8 +378,128 @@ msgid "" "buttons are represented as ordinary :code:`url` buttons." msgstr "" +#: aiogram.types.message.Message.answer_animation:1 #: aiogram.types.message.Message.reply_animation:1 of -msgid "Reply with animation" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer:4 +#: aiogram.types.message.Message.answer_animation:4 +#: aiogram.types.message.Message.answer_audio:4 +#: aiogram.types.message.Message.answer_contact:4 +#: aiogram.types.message.Message.answer_dice:4 +#: aiogram.types.message.Message.answer_document:4 +#: aiogram.types.message.Message.answer_game:4 +#: aiogram.types.message.Message.answer_invoice:4 +#: aiogram.types.message.Message.answer_location:4 +#: aiogram.types.message.Message.answer_media_group:4 +#: aiogram.types.message.Message.answer_photo:4 +#: aiogram.types.message.Message.answer_poll:4 +#: aiogram.types.message.Message.answer_sticker:4 +#: aiogram.types.message.Message.answer_venue:4 +#: aiogram.types.message.Message.answer_video:4 +#: aiogram.types.message.Message.answer_video_note:4 +#: aiogram.types.message.Message.answer_voice:4 +#: aiogram.types.message.Message.delete:4 +#: aiogram.types.message.Message.edit_caption:4 +#: aiogram.types.message.Message.edit_live_location:4 +#: aiogram.types.message.Message.edit_media:4 +#: aiogram.types.message.Message.edit_reply_markup:4 +#: aiogram.types.message.Message.edit_text:4 +#: aiogram.types.message.Message.pin:4 aiogram.types.message.Message.reply:4 +#: aiogram.types.message.Message.reply_animation:4 +#: aiogram.types.message.Message.reply_audio:4 +#: aiogram.types.message.Message.reply_contact:4 +#: aiogram.types.message.Message.reply_dice:4 +#: aiogram.types.message.Message.reply_document:4 +#: aiogram.types.message.Message.reply_game:4 +#: aiogram.types.message.Message.reply_invoice:4 +#: aiogram.types.message.Message.reply_location:4 +#: aiogram.types.message.Message.reply_media_group:4 +#: aiogram.types.message.Message.reply_photo:4 +#: aiogram.types.message.Message.reply_poll:4 +#: aiogram.types.message.Message.reply_sticker:4 +#: aiogram.types.message.Message.reply_venue:4 +#: aiogram.types.message.Message.reply_video:4 +#: aiogram.types.message.Message.reply_video_note:4 +#: aiogram.types.message.Message.reply_voice:4 +#: aiogram.types.message.Message.stop_live_location:4 +#: aiogram.types.message.Message.unpin:4 of +msgid ":code:`chat_id`" +msgstr "" + +#: aiogram.types.message.Message.answer:5 +#: aiogram.types.message.Message.answer_animation:5 +#: aiogram.types.message.Message.answer_audio:5 +#: aiogram.types.message.Message.answer_contact:5 +#: aiogram.types.message.Message.answer_dice:5 +#: aiogram.types.message.Message.answer_document:5 +#: aiogram.types.message.Message.answer_game:5 +#: aiogram.types.message.Message.answer_invoice:5 +#: aiogram.types.message.Message.answer_location:5 +#: aiogram.types.message.Message.answer_media_group:5 +#: aiogram.types.message.Message.answer_photo:5 +#: aiogram.types.message.Message.answer_poll:5 +#: aiogram.types.message.Message.answer_sticker:5 +#: aiogram.types.message.Message.answer_venue:5 +#: aiogram.types.message.Message.answer_video:5 +#: aiogram.types.message.Message.answer_video_note:5 +#: aiogram.types.message.Message.answer_voice:5 +#: aiogram.types.message.Message.reply:5 +#: aiogram.types.message.Message.reply_animation:5 +#: aiogram.types.message.Message.reply_audio:5 +#: aiogram.types.message.Message.reply_contact:5 +#: aiogram.types.message.Message.reply_dice:5 +#: aiogram.types.message.Message.reply_document:5 +#: aiogram.types.message.Message.reply_game:5 +#: aiogram.types.message.Message.reply_invoice:5 +#: aiogram.types.message.Message.reply_location:5 +#: aiogram.types.message.Message.reply_media_group:5 +#: aiogram.types.message.Message.reply_photo:5 +#: aiogram.types.message.Message.reply_poll:5 +#: aiogram.types.message.Message.reply_sticker:5 +#: aiogram.types.message.Message.reply_venue:5 +#: aiogram.types.message.Message.reply_video:5 +#: aiogram.types.message.Message.reply_video_note:5 +#: aiogram.types.message.Message.reply_voice:5 of +msgid ":code:`message_thread_id`" +msgstr "" + +#: aiogram.types.message.Message.reply:6 +#: aiogram.types.message.Message.reply_animation:6 +#: aiogram.types.message.Message.reply_audio:6 +#: aiogram.types.message.Message.reply_contact:6 +#: aiogram.types.message.Message.reply_dice:6 +#: aiogram.types.message.Message.reply_document:6 +#: aiogram.types.message.Message.reply_game:6 +#: aiogram.types.message.Message.reply_invoice:6 +#: aiogram.types.message.Message.reply_location:6 +#: aiogram.types.message.Message.reply_media_group:6 +#: aiogram.types.message.Message.reply_photo:6 +#: aiogram.types.message.Message.reply_poll:6 +#: aiogram.types.message.Message.reply_sticker:6 +#: aiogram.types.message.Message.reply_venue:6 +#: aiogram.types.message.Message.reply_video:6 +#: aiogram.types.message.Message.reply_video_note:6 +#: aiogram.types.message.Message.reply_voice:6 of +msgid ":code:`reply_to_message_id`" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:7 +#: aiogram.types.message.Message.reply_animation:8 of +msgid "" +"Use this method to send animation files (GIF or H.264/MPEG-4 AVC video " +"without sound). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send animation files of up to 50 MB in size, this limit may be changed in" +" the future." +msgstr "" + +#: aiogram.types.message.Message.answer_animation:9 +#: aiogram.types.message.Message.reply_animation:10 of +msgid "Source: https://core.telegram.org/bots/api#sendanimation" msgstr "" #: aiogram.types.message.Message.answer @@ -399,8 +519,14 @@ msgstr "" #: aiogram.types.message.Message.answer_video #: aiogram.types.message.Message.answer_video_note #: aiogram.types.message.Message.answer_voice -#: aiogram.types.message.Message.copy_to aiogram.types.message.Message.get_url -#: aiogram.types.message.Message.reply +#: aiogram.types.message.Message.copy_to +#: aiogram.types.message.Message.edit_caption +#: aiogram.types.message.Message.edit_live_location +#: aiogram.types.message.Message.edit_media +#: aiogram.types.message.Message.edit_reply_markup +#: aiogram.types.message.Message.edit_text +#: aiogram.types.message.Message.forward aiogram.types.message.Message.get_url +#: aiogram.types.message.Message.pin aiogram.types.message.Message.reply #: aiogram.types.message.Message.reply_animation #: aiogram.types.message.Message.reply_audio #: aiogram.types.message.Message.reply_contact @@ -417,10 +543,240 @@ msgstr "" #: aiogram.types.message.Message.reply_video #: aiogram.types.message.Message.reply_video_note #: aiogram.types.message.Message.reply_voice -#: aiogram.types.message.Message.send_copy of +#: aiogram.types.message.Message.send_copy +#: aiogram.types.message.Message.stop_live_location of msgid "Parameters" msgstr "" +#: aiogram.types.message.Message.answer_animation:11 +#: aiogram.types.message.Message.reply_animation:12 of +msgid "" +"Animation to send. Pass a file_id as String to send an animation that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an animation from the Internet, or upload a " +"new animation using multipart/form-data. :ref:`More information on " +"Sending Files » `" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:12 +#: aiogram.types.message.Message.reply_animation:13 of +msgid "Duration of sent animation in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:13 +#: aiogram.types.message.Message.reply_animation:14 of +msgid "Animation width" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:14 +#: aiogram.types.message.Message.reply_animation:15 of +msgid "Animation height" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:15 +#: aiogram.types.message.Message.answer_audio:19 +#: aiogram.types.message.Message.answer_document:12 +#: aiogram.types.message.Message.answer_video:15 +#: aiogram.types.message.Message.answer_video_note:14 +#: aiogram.types.message.Message.reply_animation:16 +#: aiogram.types.message.Message.reply_audio:20 +#: aiogram.types.message.Message.reply_document:13 +#: aiogram.types.message.Message.reply_video:16 +#: aiogram.types.message.Message.reply_video_note:15 of +msgid "" +"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 » `" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:16 +#: aiogram.types.message.Message.reply_animation:17 of +msgid "" +"Animation caption (may also be used when resending animation by " +"*file_id*), 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_animation:17 +#: aiogram.types.message.Message.reply_animation:18 of +msgid "" +"Mode for parsing entities in the animation caption. See `formatting " +"options `_ for " +"more details." +msgstr "" + +#: aiogram.types.message.Message.answer_animation:18 +#: aiogram.types.message.Message.answer_audio:15 +#: aiogram.types.message.Message.answer_document:15 +#: aiogram.types.message.Message.answer_photo:14 +#: aiogram.types.message.Message.answer_video:18 +#: aiogram.types.message.Message.answer_voice:14 +#: aiogram.types.message.Message.edit_caption:14 +#: aiogram.types.message.Message.reply_animation:19 +#: aiogram.types.message.Message.reply_audio:16 +#: aiogram.types.message.Message.reply_document:16 +#: aiogram.types.message.Message.reply_photo:15 +#: aiogram.types.message.Message.reply_video:19 +#: aiogram.types.message.Message.reply_voice:15 of +msgid "" +"A JSON-serialized list of special entities that appear in the caption, " +"which can be specified instead of *parse_mode*" +msgstr "" + +#: aiogram.types.message.Message.answer:15 +#: aiogram.types.message.Message.answer_animation:19 +#: aiogram.types.message.Message.answer_audio:20 +#: aiogram.types.message.Message.answer_contact:15 +#: aiogram.types.message.Message.answer_dice:12 +#: aiogram.types.message.Message.answer_document:17 +#: aiogram.types.message.Message.answer_game:12 +#: aiogram.types.message.Message.answer_invoice:32 +#: aiogram.types.message.Message.answer_location:17 +#: aiogram.types.message.Message.answer_photo:15 +#: aiogram.types.message.Message.answer_poll:23 +#: aiogram.types.message.Message.answer_sticker:12 +#: aiogram.types.message.Message.answer_venue:19 +#: aiogram.types.message.Message.answer_video:20 +#: aiogram.types.message.Message.answer_video_note:15 +#: aiogram.types.message.Message.answer_voice:16 +#: aiogram.types.message.Message.copy_to:16 +#: aiogram.types.message.Message.forward:13 +#: aiogram.types.message.Message.reply:16 +#: aiogram.types.message.Message.reply_animation:20 +#: aiogram.types.message.Message.reply_audio:21 +#: aiogram.types.message.Message.reply_contact:16 +#: aiogram.types.message.Message.reply_dice:13 +#: aiogram.types.message.Message.reply_document:18 +#: aiogram.types.message.Message.reply_game:13 +#: aiogram.types.message.Message.reply_invoice:33 +#: aiogram.types.message.Message.reply_location:18 +#: aiogram.types.message.Message.reply_photo:16 +#: aiogram.types.message.Message.reply_poll:24 +#: aiogram.types.message.Message.reply_sticker:13 +#: aiogram.types.message.Message.reply_venue:20 +#: aiogram.types.message.Message.reply_video:21 +#: aiogram.types.message.Message.reply_video_note:16 +#: aiogram.types.message.Message.reply_voice:17 of +msgid "" +"Sends the message `silently `_. Users will receive a notification with no sound." +msgstr "" + +#: aiogram.types.message.Message.answer:16 +#: aiogram.types.message.Message.answer_animation:20 +#: aiogram.types.message.Message.answer_audio:21 +#: aiogram.types.message.Message.answer_contact:16 +#: aiogram.types.message.Message.answer_document:18 +#: aiogram.types.message.Message.answer_game:13 +#: aiogram.types.message.Message.answer_invoice:33 +#: aiogram.types.message.Message.answer_location:18 +#: aiogram.types.message.Message.answer_photo:16 +#: aiogram.types.message.Message.answer_poll:24 +#: aiogram.types.message.Message.answer_sticker:13 +#: aiogram.types.message.Message.answer_venue:20 +#: aiogram.types.message.Message.answer_video:21 +#: aiogram.types.message.Message.answer_video_note:16 +#: aiogram.types.message.Message.answer_voice:17 +#: aiogram.types.message.Message.copy_to:17 +#: aiogram.types.message.Message.reply:17 +#: aiogram.types.message.Message.reply_animation:21 +#: aiogram.types.message.Message.reply_audio:22 +#: aiogram.types.message.Message.reply_contact:17 +#: aiogram.types.message.Message.reply_document:19 +#: aiogram.types.message.Message.reply_game:14 +#: aiogram.types.message.Message.reply_invoice:34 +#: aiogram.types.message.Message.reply_location:19 +#: aiogram.types.message.Message.reply_photo:17 +#: aiogram.types.message.Message.reply_poll:25 +#: aiogram.types.message.Message.reply_sticker:14 +#: aiogram.types.message.Message.reply_venue:21 +#: aiogram.types.message.Message.reply_video:22 +#: aiogram.types.message.Message.reply_video_note:17 +#: aiogram.types.message.Message.reply_voice:18 of +msgid "Protects the contents of the sent message from forwarding and saving" +msgstr "" + +#: aiogram.types.message.Message.answer:18 +#: aiogram.types.message.Message.answer_animation:22 +#: aiogram.types.message.Message.answer_audio:23 +#: aiogram.types.message.Message.answer_contact:18 +#: aiogram.types.message.Message.answer_dice:15 +#: aiogram.types.message.Message.answer_document:20 +#: aiogram.types.message.Message.answer_game:15 +#: aiogram.types.message.Message.answer_invoice:35 +#: aiogram.types.message.Message.answer_location:20 +#: aiogram.types.message.Message.answer_media_group:15 +#: aiogram.types.message.Message.answer_photo:18 +#: aiogram.types.message.Message.answer_poll:26 +#: aiogram.types.message.Message.answer_sticker:15 +#: aiogram.types.message.Message.answer_venue:22 +#: aiogram.types.message.Message.answer_video:23 +#: aiogram.types.message.Message.answer_video_note:18 +#: aiogram.types.message.Message.answer_voice:19 +#: aiogram.types.message.Message.copy_to:19 +#: aiogram.types.message.Message.reply:18 +#: aiogram.types.message.Message.reply_animation:22 +#: aiogram.types.message.Message.reply_audio:23 +#: aiogram.types.message.Message.reply_contact:18 +#: aiogram.types.message.Message.reply_dice:15 +#: aiogram.types.message.Message.reply_document:20 +#: aiogram.types.message.Message.reply_game:15 +#: aiogram.types.message.Message.reply_invoice:35 +#: aiogram.types.message.Message.reply_location:20 +#: aiogram.types.message.Message.reply_media_group:15 +#: aiogram.types.message.Message.reply_photo:18 +#: aiogram.types.message.Message.reply_poll:26 +#: aiogram.types.message.Message.reply_sticker:15 +#: aiogram.types.message.Message.reply_venue:22 +#: aiogram.types.message.Message.reply_video:23 +#: aiogram.types.message.Message.reply_video_note:18 +#: aiogram.types.message.Message.reply_voice:19 of +msgid "" +"Pass :code:`True` if the message should be sent even if the specified " +"replied-to message is not found" +msgstr "" + +#: aiogram.types.message.Message.answer:19 +#: aiogram.types.message.Message.answer_animation:23 +#: aiogram.types.message.Message.answer_audio:24 +#: aiogram.types.message.Message.answer_contact:19 +#: aiogram.types.message.Message.answer_dice:16 +#: aiogram.types.message.Message.answer_document:21 +#: aiogram.types.message.Message.answer_location:21 +#: aiogram.types.message.Message.answer_photo:19 +#: aiogram.types.message.Message.answer_poll:27 +#: aiogram.types.message.Message.answer_sticker:16 +#: aiogram.types.message.Message.answer_venue:23 +#: aiogram.types.message.Message.answer_video:24 +#: aiogram.types.message.Message.answer_video_note:19 +#: aiogram.types.message.Message.answer_voice:20 +#: aiogram.types.message.Message.copy_to:20 +#: aiogram.types.message.Message.reply:19 +#: aiogram.types.message.Message.reply_animation:23 +#: aiogram.types.message.Message.reply_audio:24 +#: aiogram.types.message.Message.reply_contact:19 +#: aiogram.types.message.Message.reply_dice:16 +#: aiogram.types.message.Message.reply_document:21 +#: aiogram.types.message.Message.reply_location:21 +#: aiogram.types.message.Message.reply_photo:19 +#: aiogram.types.message.Message.reply_poll:27 +#: aiogram.types.message.Message.reply_sticker:16 +#: aiogram.types.message.Message.reply_venue:23 +#: aiogram.types.message.Message.reply_video:24 +#: aiogram.types.message.Message.reply_video_note:19 +#: aiogram.types.message.Message.reply_voice:20 of +msgid "" +"Additional interface options. A JSON-serialized object for an `inline " +"keyboard `_, " +"`custom reply keyboard " +"`_, instructions to " +"remove reply keyboard or to force a reply from the user." +msgstr "" + #: aiogram.types.message.Message.answer #: aiogram.types.message.Message.answer_animation #: aiogram.types.message.Message.answer_audio @@ -438,8 +794,14 @@ msgstr "" #: aiogram.types.message.Message.answer_video #: aiogram.types.message.Message.answer_video_note #: aiogram.types.message.Message.answer_voice -#: aiogram.types.message.Message.copy_to aiogram.types.message.Message.get_url -#: aiogram.types.message.Message.reply +#: aiogram.types.message.Message.copy_to aiogram.types.message.Message.delete +#: aiogram.types.message.Message.edit_caption +#: aiogram.types.message.Message.edit_live_location +#: aiogram.types.message.Message.edit_media +#: aiogram.types.message.Message.edit_reply_markup +#: aiogram.types.message.Message.edit_text +#: aiogram.types.message.Message.forward aiogram.types.message.Message.get_url +#: aiogram.types.message.Message.pin aiogram.types.message.Message.reply #: aiogram.types.message.Message.reply_animation #: aiogram.types.message.Message.reply_audio #: aiogram.types.message.Message.reply_contact @@ -456,90 +818,305 @@ msgstr "" #: aiogram.types.message.Message.reply_video #: aiogram.types.message.Message.reply_video_note #: aiogram.types.message.Message.reply_voice -#: aiogram.types.message.Message.send_copy of +#: aiogram.types.message.Message.send_copy +#: aiogram.types.message.Message.stop_live_location +#: aiogram.types.message.Message.unpin of msgid "Returns" msgstr "" -#: aiogram.types.message.Message.answer_animation:1 of -msgid "Answer with animation" +#: aiogram.types.message.Message.answer_animation:24 +#: aiogram.types.message.Message.reply_animation:24 of +msgid "instance of method :class:`aiogram.methods.send_animation.SendAnimation`" +msgstr "" + +#: aiogram.types.message.Message.answer:17 +#: aiogram.types.message.Message.answer_animation:21 +#: aiogram.types.message.Message.answer_audio:22 +#: aiogram.types.message.Message.answer_contact:17 +#: aiogram.types.message.Message.answer_dice:14 +#: aiogram.types.message.Message.answer_document:19 +#: aiogram.types.message.Message.answer_game:14 +#: aiogram.types.message.Message.answer_invoice:34 +#: aiogram.types.message.Message.answer_location:19 +#: aiogram.types.message.Message.answer_photo:17 +#: aiogram.types.message.Message.answer_poll:25 +#: aiogram.types.message.Message.answer_sticker:14 +#: aiogram.types.message.Message.answer_venue:21 +#: aiogram.types.message.Message.answer_video:22 +#: aiogram.types.message.Message.answer_video_note:17 +#: aiogram.types.message.Message.answer_voice:18 +#: aiogram.types.message.Message.copy_to:18 of +msgid "If the message is a reply, ID of the original message" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:1 +#: aiogram.types.message.Message.reply_audio:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:7 +#: aiogram.types.message.Message.reply_audio:8 of +msgid "" +"Use this method to send audio files, if you want Telegram clients to " +"display them in the music player. Your audio must be in the .MP3 or .M4A " +"format. On success, the sent :class:`aiogram.types.message.Message` is " +"returned. Bots can currently send audio files of up to 50 MB in size, " +"this limit may be changed in the future. For sending voice messages, use " +"the :class:`aiogram.methods.send_voice.SendVoice` method instead." +msgstr "" + +#: aiogram.types.message.Message.answer_audio:10 +#: aiogram.types.message.Message.reply_audio:11 of +msgid "Source: https://core.telegram.org/bots/api#sendaudio" msgstr "" -#: aiogram.types.message.Message.reply_audio:1 of -msgid "Reply with audio" +#: aiogram.types.message.Message.answer_audio:12 +#: aiogram.types.message.Message.reply_audio:13 of +msgid "" +"Audio file to send. Pass a file_id as String to send an audio file that " +"exists on the Telegram servers (recommended), pass an HTTP URL as a " +"String for Telegram to get an audio file from the Internet, or upload a " +"new one using multipart/form-data. :ref:`More information on Sending " +"Files » `" msgstr "" -#: aiogram.types.message.Message.answer_audio:1 of -msgid "Answer with audio" +#: aiogram.types.message.Message.answer_audio:13 +#: aiogram.types.message.Message.reply_audio:14 of +msgid "Audio caption, 0-1024 characters after entities parsing" msgstr "" +#: aiogram.types.message.Message.answer_audio:14 +#: aiogram.types.message.Message.reply_audio:15 of +msgid "" +"Mode for parsing entities in the audio caption. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.answer_audio:16 +#: aiogram.types.message.Message.reply_audio:17 of +msgid "Duration of the audio in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:17 +#: aiogram.types.message.Message.reply_audio:18 of +msgid "Performer" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:18 +#: aiogram.types.message.Message.reply_audio:19 of +msgid "Track name" +msgstr "" + +#: aiogram.types.message.Message.answer_audio:25 +#: aiogram.types.message.Message.reply_audio:25 of +msgid "instance of method :class:`aiogram.methods.send_audio.SendAudio`" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:1 #: aiogram.types.message.Message.reply_contact:1 of -msgid "Reply with contact" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_contact.SendContact` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:7 +#: aiogram.types.message.Message.reply_contact:8 of +msgid "" +"Use this method to send phone contacts. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_contact:9 +#: aiogram.types.message.Message.reply_contact:10 of +msgid "Source: https://core.telegram.org/bots/api#sendcontact" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:11 +#: aiogram.types.message.Message.reply_contact:12 of +msgid "Contact's phone number" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:12 +#: aiogram.types.message.Message.reply_contact:13 of +msgid "Contact's first name" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:13 +#: aiogram.types.message.Message.reply_contact:14 of +msgid "Contact's last name" +msgstr "" + +#: aiogram.types.message.Message.answer_contact:14 +#: aiogram.types.message.Message.reply_contact:15 of +msgid "" +"Additional data about the contact in the form of a `vCard " +"`_, 0-2048 bytes" msgstr "" -#: aiogram.types.message.Message.answer_contact:1 of -msgid "Answer with contact" +#: aiogram.types.message.Message.answer_contact:20 +#: aiogram.types.message.Message.reply_contact:20 of +msgid "instance of method :class:`aiogram.methods.send_contact.SendContact`" msgstr "" +#: aiogram.types.message.Message.answer_document:1 #: aiogram.types.message.Message.reply_document:1 of -msgid "Reply with document" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_document.SendDocument` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_document:7 +#: aiogram.types.message.Message.reply_document:8 of +msgid "" +"Use this method to send general files. On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send files of any type of up to 50 MB in size, this limit may be changed " +"in the future." +msgstr "" + +#: aiogram.types.message.Message.answer_document:9 +#: aiogram.types.message.Message.reply_document:10 of +msgid "Source: https://core.telegram.org/bots/api#senddocument" msgstr "" -#: aiogram.types.message.Message.answer_document:1 of -msgid "Answer with document" +#: aiogram.types.message.Message.answer_document:11 +#: aiogram.types.message.Message.reply_document:12 of +msgid "" +"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 » `" +msgstr "" + +#: aiogram.types.message.Message.answer_document:13 +#: aiogram.types.message.Message.reply_document:14 of +msgid "" +"Document caption (may also be used when resending documents by " +"*file_id*), 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_document:14 +#: aiogram.types.message.Message.reply_document:15 of +msgid "" +"Mode for parsing entities in the document caption. See `formatting " +"options `_ for " +"more details." +msgstr "" + +#: aiogram.types.message.Message.answer_document:16 +#: aiogram.types.message.Message.reply_document:17 of +msgid "" +"Disables automatic server-side content type detection for files uploaded " +"using multipart/form-data" +msgstr "" + +#: aiogram.types.message.Message.answer_document:22 +#: aiogram.types.message.Message.reply_document:22 of +msgid "instance of method :class:`aiogram.methods.send_document.SendDocument`" msgstr "" +#: aiogram.types.message.Message.answer_game:1 #: aiogram.types.message.Message.reply_game:1 of -msgid "Reply with game" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_game.SendGame` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_game:7 +#: aiogram.types.message.Message.reply_game:8 of +msgid "" +"Use this method to send a game. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.answer_game:1 of -msgid "Answer with game" +#: aiogram.types.message.Message.answer_game:9 +#: aiogram.types.message.Message.reply_game:10 of +msgid "Source: https://core.telegram.org/bots/api#sendgame" msgstr "" +#: aiogram.types.message.Message.answer_game:11 +#: aiogram.types.message.Message.reply_game:12 of +msgid "" +"Short name of the game, serves as the unique identifier for the game. Set" +" up your games via `@BotFather `_." +msgstr "" + +#: aiogram.types.message.Message.answer_game:16 +#: aiogram.types.message.Message.reply_game:16 of +msgid "" +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Play game_title' button will be shown. If not empty, the first " +"button must launch the game." +msgstr "" + +#: aiogram.types.message.Message.answer_game:17 +#: aiogram.types.message.Message.reply_game:17 of +msgid "instance of method :class:`aiogram.methods.send_game.SendGame`" +msgstr "" + +#: aiogram.types.message.Message.answer_invoice:1 #: aiogram.types.message.Message.reply_invoice:1 of -msgid "Reply with invoice" +msgid "" +"Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_invoice:7 +#: aiogram.types.message.Message.reply_invoice:8 of +msgid "" +"Use this method to send invoices. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_invoice:9 +#: aiogram.types.message.Message.reply_invoice:10 of +msgid "Source: https://core.telegram.org/bots/api#sendinvoice" msgstr "" -#: aiogram.types.message.Message.answer_invoice:3 -#: aiogram.types.message.Message.reply_invoice:3 of +#: aiogram.types.message.Message.answer_invoice:11 +#: aiogram.types.message.Message.reply_invoice:12 of msgid "Product name, 1-32 characters" msgstr "" -#: aiogram.types.message.Message.answer_invoice:4 -#: aiogram.types.message.Message.reply_invoice:4 of +#: aiogram.types.message.Message.answer_invoice:12 +#: aiogram.types.message.Message.reply_invoice:13 of msgid "Product description, 1-255 characters" msgstr "" -#: aiogram.types.message.Message.answer_invoice:5 -#: aiogram.types.message.Message.reply_invoice:5 of +#: aiogram.types.message.Message.answer_invoice:13 +#: aiogram.types.message.Message.reply_invoice:14 of msgid "" "Bot-defined invoice payload, 1-128 bytes. This will not be displayed to " "the user, use for your internal processes." msgstr "" -#: aiogram.types.message.Message.answer_invoice:6 -#: aiogram.types.message.Message.reply_invoice:6 of +#: aiogram.types.message.Message.answer_invoice:14 +#: aiogram.types.message.Message.reply_invoice:15 of msgid "" "Payment provider token, obtained via `@BotFather " "`_" msgstr "" -#: aiogram.types.message.Message.answer_invoice:7 -#: aiogram.types.message.Message.reply_invoice:7 of +#: aiogram.types.message.Message.answer_invoice:15 +#: aiogram.types.message.Message.reply_invoice:16 of msgid "" "Three-letter ISO 4217 currency code, see `more on currencies " "`_" msgstr "" -#: aiogram.types.message.Message.answer_invoice:8 -#: aiogram.types.message.Message.reply_invoice:8 of +#: aiogram.types.message.Message.answer_invoice:16 +#: aiogram.types.message.Message.reply_invoice:17 of msgid "" "Price breakdown, a JSON-serialized list of components (e.g. product " "price, tax, discount, delivery cost, delivery tax, bonus, etc.)" msgstr "" -#: aiogram.types.message.Message.answer_invoice:9 -#: aiogram.types.message.Message.reply_invoice:9 of +#: aiogram.types.message.Message.answer_invoice:17 +#: aiogram.types.message.Message.reply_invoice:18 of msgid "" "The maximum accepted amount for tips in the *smallest units* of the " "currency (integer, **not** float/double). For example, for a maximum tip " @@ -550,8 +1127,8 @@ msgid "" "majority of currencies). Defaults to 0" msgstr "" -#: aiogram.types.message.Message.answer_invoice:10 -#: aiogram.types.message.Message.reply_invoice:10 of +#: aiogram.types.message.Message.answer_invoice:18 +#: aiogram.types.message.Message.reply_invoice:19 of msgid "" "A JSON-serialized array of suggested amounts of tips in the *smallest " "units* of the currency (integer, **not** float/double). At most 4 " @@ -560,8 +1137,8 @@ msgid "" "*max_tip_amount*." msgstr "" -#: aiogram.types.message.Message.answer_invoice:11 -#: aiogram.types.message.Message.reply_invoice:11 of +#: aiogram.types.message.Message.answer_invoice:19 +#: aiogram.types.message.Message.reply_invoice:20 of msgid "" "Unique deep-linking parameter. If left empty, **forwarded copies** of the" " sent message will have a *Pay* button, allowing multiple users to pay " @@ -571,244 +1148,1344 @@ msgid "" "as the start parameter" msgstr "" -#: aiogram.types.message.Message.answer_invoice:12 -#: aiogram.types.message.Message.reply_invoice:12 of +#: aiogram.types.message.Message.answer_invoice:20 +#: aiogram.types.message.Message.reply_invoice:21 of msgid "" "JSON-serialized data about the invoice, which will be shared with the " "payment provider. A detailed description of required fields should be " "provided by the payment provider." msgstr "" -#: aiogram.types.message.Message.answer_invoice:13 -#: aiogram.types.message.Message.reply_invoice:13 of +#: aiogram.types.message.Message.answer_invoice:21 +#: aiogram.types.message.Message.reply_invoice:22 of msgid "" "URL of the product photo for the invoice. Can be a photo of the goods or " "a marketing image for a service. People like it better when they see what" " they are paying for." msgstr "" -#: aiogram.types.message.Message.answer_invoice:14 -#: aiogram.types.message.Message.reply_invoice:14 of +#: aiogram.types.message.Message.answer_invoice:22 +#: aiogram.types.message.Message.reply_invoice:23 of msgid "Photo size in bytes" msgstr "" -#: aiogram.types.message.Message.answer_invoice:15 -#: aiogram.types.message.Message.reply_invoice:15 of +#: aiogram.types.message.Message.answer_invoice:23 +#: aiogram.types.message.Message.reply_invoice:24 of msgid "Photo width" msgstr "" -#: aiogram.types.message.Message.answer_invoice:16 -#: aiogram.types.message.Message.reply_invoice:16 of +#: aiogram.types.message.Message.answer_invoice:24 +#: aiogram.types.message.Message.reply_invoice:25 of msgid "Photo height" msgstr "" -#: aiogram.types.message.Message.answer_invoice:17 -#: aiogram.types.message.Message.reply_invoice:17 of +#: aiogram.types.message.Message.answer_invoice:25 +#: aiogram.types.message.Message.reply_invoice:26 of msgid "" "Pass :code:`True` if you require the user's full name to complete the " "order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:18 -#: aiogram.types.message.Message.reply_invoice:18 of +#: aiogram.types.message.Message.answer_invoice:26 +#: aiogram.types.message.Message.reply_invoice:27 of msgid "" "Pass :code:`True` if you require the user's phone number to complete the " "order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:19 -#: aiogram.types.message.Message.reply_invoice:19 of +#: aiogram.types.message.Message.answer_invoice:27 +#: aiogram.types.message.Message.reply_invoice:28 of msgid "" "Pass :code:`True` if you require the user's email address to complete the" " order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:20 -#: aiogram.types.message.Message.reply_invoice:20 of +#: aiogram.types.message.Message.answer_invoice:28 +#: aiogram.types.message.Message.reply_invoice:29 of msgid "" "Pass :code:`True` if you require the user's shipping address to complete " "the order" msgstr "" -#: aiogram.types.message.Message.answer_invoice:21 -#: aiogram.types.message.Message.reply_invoice:21 of +#: aiogram.types.message.Message.answer_invoice:29 +#: aiogram.types.message.Message.reply_invoice:30 of msgid "Pass :code:`True` if the user's phone number should be sent to provider" msgstr "" -#: aiogram.types.message.Message.answer_invoice:22 -#: aiogram.types.message.Message.reply_invoice:22 of +#: aiogram.types.message.Message.answer_invoice:30 +#: aiogram.types.message.Message.reply_invoice:31 of msgid "Pass :code:`True` if the user's email address should be sent to provider" msgstr "" -#: aiogram.types.message.Message.answer_invoice:23 -#: aiogram.types.message.Message.reply_invoice:23 of +#: aiogram.types.message.Message.answer_invoice:31 +#: aiogram.types.message.Message.reply_invoice:32 of msgid "Pass :code:`True` if the final price depends on the shipping method" msgstr "" -#: aiogram.types.message.Message.answer_invoice:24 -#: aiogram.types.message.Message.reply_invoice:24 of +#: aiogram.types.message.Message.answer_invoice:36 +#: aiogram.types.message.Message.reply_invoice:36 of msgid "" -"Sends the message `silently `_. Users will receive a notification with no sound." +"A JSON-serialized object for an `inline keyboard " +"`_. If empty, " +"one 'Pay :code:`total price`' button will be shown. If not empty, the " +"first button must be a Pay button." msgstr "" -#: aiogram.types.message.Message.answer_invoice:25 -#: aiogram.types.message.Message.reply_invoice:25 of -msgid "Protects the contents of the sent message from forwarding and saving" +#: aiogram.types.message.Message.answer_invoice:37 +#: aiogram.types.message.Message.reply_invoice:37 of +msgid "instance of method :class:`aiogram.methods.send_invoice.SendInvoice`" msgstr "" -#: aiogram.types.message.Message.reply_invoice:26 of +#: aiogram.types.message.Message.answer_location:1 +#: aiogram.types.message.Message.reply_location:1 of msgid "" -"Pass :code:`True` if the message should be sent even if the specified " -"replied-to message is not found" +"Shortcut for method :class:`aiogram.methods.send_location.SendLocation` " +"will automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_invoice:26 -#: aiogram.types.message.Message.reply_invoice:27 of +#: aiogram.types.message.Message.answer_location:7 +#: aiogram.types.message.Message.reply_location:8 of msgid "" -"A JSON-serialized object for an `inline keyboard " -"`_. If empty, one 'Pay :code:`total price`' button will be " -"shown. If not empty, the first button must be a Pay button." +"Use this method to send point on the map. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.answer_invoice:27 -#: aiogram.types.message.Message.reply_invoice:28 of -msgid "On success, the sent Message is returned." +#: aiogram.types.message.Message.answer_location:9 +#: aiogram.types.message.Message.reply_location:10 of +msgid "Source: https://core.telegram.org/bots/api#sendlocation" msgstr "" -#: aiogram.types.message.Message.answer_invoice:1 of -msgid "Answer with invoice" +#: aiogram.types.message.Message.answer_location:11 +#: aiogram.types.message.Message.reply_location:12 of +msgid "Latitude of the location" msgstr "" -#: aiogram.types.message.Message.reply_location:1 of -msgid "Reply with location" +#: aiogram.types.message.Message.answer_location:12 +#: aiogram.types.message.Message.reply_location:13 of +msgid "Longitude of the location" +msgstr "" + +#: aiogram.types.message.Message.answer_location:13 +#: aiogram.types.message.Message.edit_live_location:14 +#: aiogram.types.message.Message.reply_location:14 of +msgid "The radius of uncertainty for the location, measured in meters; 0-1500" +msgstr "" + +#: aiogram.types.message.Message.answer_location:14 +#: aiogram.types.message.Message.reply_location:15 of +msgid "" +"Period in seconds for which the location will be updated (see `Live " +"Locations `_, should be between" +" 60 and 86400." +msgstr "" + +#: aiogram.types.message.Message.answer_location:15 +#: aiogram.types.message.Message.reply_location:16 of +msgid "" +"For live locations, a direction in which the user is moving, in degrees. " +"Must be between 1 and 360 if specified." +msgstr "" + +#: aiogram.types.message.Message.answer_location:16 +#: aiogram.types.message.Message.reply_location:17 of +msgid "" +"For live locations, a maximum distance for proximity alerts about " +"approaching another chat member, in meters. Must be between 1 and 100000 " +"if specified." msgstr "" -#: aiogram.types.message.Message.answer_location:1 of -msgid "Answer with location" +#: aiogram.types.message.Message.answer_location:22 +#: aiogram.types.message.Message.reply_location:22 of +msgid "instance of method :class:`aiogram.methods.send_location.SendLocation`" msgstr "" +#: aiogram.types.message.Message.answer_media_group:1 #: aiogram.types.message.Message.reply_media_group:1 of -msgid "Reply with media group" +msgid "" +"Shortcut for method " +":class:`aiogram.methods.send_media_group.SendMediaGroup` will " +"automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_media_group:1 of -msgid "Answer with media group" +#: aiogram.types.message.Message.answer_media_group:7 +#: aiogram.types.message.Message.reply_media_group:8 of +msgid "" +"Use this method to send a group of photos, videos, documents or audios as" +" an album. Documents and audio files can be only grouped in an album with" +" messages of the same type. On success, an array of `Messages " +"`_ that were sent is " +"returned." msgstr "" -#: aiogram.types.message.Message.reply:1 of -msgid "Reply with text message" +#: aiogram.types.message.Message.answer_media_group:9 +#: aiogram.types.message.Message.reply_media_group:10 of +msgid "Source: https://core.telegram.org/bots/api#sendmediagroup" msgstr "" -#: aiogram.types.message.Message.answer:1 of -msgid "Answer with text message" +#: aiogram.types.message.Message.answer_media_group:11 +#: aiogram.types.message.Message.reply_media_group:12 of +msgid "" +"A JSON-serialized array describing messages to be sent, must include 2-10" +" items" msgstr "" -#: aiogram.types.message.Message.reply_photo:1 of -msgid "Reply with photo" +#: aiogram.types.message.Message.answer_media_group:12 +#: aiogram.types.message.Message.reply_media_group:13 of +msgid "" +"Sends messages `silently `_. Users will receive a notification with no sound." msgstr "" -#: aiogram.types.message.Message.answer_photo:1 of -msgid "Answer with photo" +#: aiogram.types.message.Message.answer_media_group:13 +#: aiogram.types.message.Message.reply_media_group:14 of +msgid "Protects the contents of the sent messages from forwarding and saving" msgstr "" -#: aiogram.types.message.Message.reply_poll:1 of -msgid "Reply with poll" +#: aiogram.types.message.Message.answer_media_group:16 +#: aiogram.types.message.Message.reply_media_group:16 of +msgid "" +"instance of method " +":class:`aiogram.methods.send_media_group.SendMediaGroup`" msgstr "" -#: aiogram.types.message.Message.answer_poll:1 of -msgid "Answer with poll" +#: aiogram.types.message.Message.answer_media_group:14 of +msgid "If the messages are a reply, ID of the original message" msgstr "" -#: aiogram.types.message.Message.answer_poll:8 of -msgid ":param explanation:" +#: aiogram.types.message.Message.answer:1 aiogram.types.message.Message.reply:1 +#: of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_message.SendMessage` " +"will automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_poll of -msgid "param explanation" +#: aiogram.types.message.Message.answer:7 aiogram.types.message.Message.reply:8 +#: of +msgid "" +"Use this method to send text messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.reply_dice:1 of -msgid "Reply with dice" +#: aiogram.types.message.Message.answer:9 +#: aiogram.types.message.Message.reply:10 of +msgid "Source: https://core.telegram.org/bots/api#sendmessage" msgstr "" -#: aiogram.types.message.Message.answer_dice:1 of -msgid "Answer with dice" +#: aiogram.types.message.Message.answer:11 +#: aiogram.types.message.Message.reply:12 of +msgid "Text of the message to be sent, 1-4096 characters after entities parsing" msgstr "" -#: aiogram.types.message.Message.reply_sticker:1 of -msgid "Reply with sticker" +#: aiogram.types.message.Message.answer:12 +#: aiogram.types.message.Message.edit_text:13 +#: aiogram.types.message.Message.reply:13 of +msgid "" +"Mode for parsing entities in the message text. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.types.message.Message.answer_sticker:1 of -msgid "Answer with sticker" +#: aiogram.types.message.Message.answer:13 +#: aiogram.types.message.Message.edit_text:14 +#: aiogram.types.message.Message.reply:14 of +msgid "" +"A JSON-serialized list of special entities that appear in message text, " +"which can be specified instead of *parse_mode*" msgstr "" -#: aiogram.types.message.Message.reply_venue:1 of -msgid "Reply with venue" +#: aiogram.types.message.Message.answer:14 +#: aiogram.types.message.Message.edit_text:15 +#: aiogram.types.message.Message.reply:15 of +msgid "Disables link previews for links in this message" msgstr "" -#: aiogram.types.message.Message.answer_venue:1 of -msgid "Answer with venue" +#: aiogram.types.message.Message.answer:20 +#: aiogram.types.message.Message.reply:20 of +msgid "instance of method :class:`aiogram.methods.send_message.SendMessage`" msgstr "" -#: aiogram.types.message.Message.reply_video:1 of -msgid "Reply with video" +#: aiogram.types.message.Message.answer_photo:1 +#: aiogram.types.message.Message.reply_photo:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` will " +"automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.answer_video:1 of -msgid "Answer with video" +#: aiogram.types.message.Message.answer_photo:7 +#: aiogram.types.message.Message.reply_photo:8 of +msgid "" +"Use this method to send photos. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.reply_video_note:1 of -msgid "Reply wit video note" +#: aiogram.types.message.Message.answer_photo:9 +#: aiogram.types.message.Message.reply_photo:10 of +msgid "Source: https://core.telegram.org/bots/api#sendphoto" msgstr "" -#: aiogram.types.message.Message.answer_video_note:1 of -msgid "Answer wit video note" +#: aiogram.types.message.Message.answer_photo:11 +#: aiogram.types.message.Message.reply_photo:12 of +msgid "" +"Photo to send. Pass a file_id as String to send a photo that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a photo from the Internet, or upload a new photo using " +"multipart/form-data. The photo must be at most 10 MB in size. The photo's" +" width and height must not exceed 10000 in total. Width and height ratio " +"must be at most 20. :ref:`More information on Sending Files » `" msgstr "" -#: aiogram.types.message.Message.reply_voice:1 of -msgid "Reply with voice" +#: aiogram.types.message.Message.answer_photo:12 +#: aiogram.types.message.Message.reply_photo:13 of +msgid "" +"Photo caption (may also be used when resending photos by *file_id*), " +"0-1024 characters after entities parsing" msgstr "" -#: aiogram.types.message.Message.answer_voice:1 of -msgid "Answer with voice" +#: aiogram.types.message.Message.answer_photo:13 +#: aiogram.types.message.Message.reply_photo:14 of +msgid "" +"Mode for parsing entities in the photo caption. See `formatting options " +"`_ for more " +"details." msgstr "" -#: aiogram.types.message.Message.send_copy:1 of -msgid "Send copy of message." +#: aiogram.types.message.Message.answer_photo:20 +#: aiogram.types.message.Message.reply_photo:20 of +msgid "instance of method :class:`aiogram.methods.send_photo.SendPhoto`" msgstr "" -#: aiogram.types.message.Message.send_copy:3 of +#: aiogram.types.message.Message.answer_poll:1 +#: aiogram.types.message.Message.reply_poll:1 of msgid "" -"Is similar to :meth:`aiogram.client.bot.Bot.copy_message` but returning " -"the sent message instead of :class:`aiogram.types.message_id.MessageId`" +"Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` will " +"automatically fill method attributes:" msgstr "" -#: aiogram.types.message.Message.send_copy:8 of +#: aiogram.types.message.Message.answer_poll:7 +#: aiogram.types.message.Message.reply_poll:8 of msgid "" -"This method don't use the API method named `copyMessage` and historically" -" implemented before the similar method is added to API" +"Use this method to send a native poll. On success, the sent " +":class:`aiogram.types.message.Message` is returned." msgstr "" -#: aiogram.types.message.Message.copy_to:1 of -msgid "Copy message" +#: aiogram.types.message.Message.answer_poll:9 +#: aiogram.types.message.Message.reply_poll:10 of +msgid "Source: https://core.telegram.org/bots/api#sendpoll" msgstr "" -#: aiogram.types.message.Message.get_url:1 of +#: aiogram.types.message.Message.answer_poll:11 +#: aiogram.types.message.Message.reply_poll:12 of +msgid "Poll question, 1-300 characters" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:12 +#: aiogram.types.message.Message.reply_poll:13 of msgid "" -"Returns message URL. Cannot be used in private (one-to-one) chats. If " -"chat has a username, returns URL like https://t.me/username/message_id " -"Otherwise (or if {force_private} flag is set), returns " -"https://t.me/c/shifted_chat_id/message_id" +"A JSON-serialized list of answer options, 2-10 strings 1-100 characters " +"each" msgstr "" -#: aiogram.types.message.Message.get_url:5 of -msgid "if set, a private URL is returned even for a public chat" +#: aiogram.types.message.Message.answer_poll:13 +#: aiogram.types.message.Message.reply_poll:14 of +msgid ":code:`True`, if the poll needs to be anonymous, defaults to :code:`True`" msgstr "" -#: aiogram.types.message.Message.get_url:6 of -msgid "string with full message URL" +#: aiogram.types.message.Message.answer_poll:14 +#: aiogram.types.message.Message.reply_poll:15 of +msgid "Poll type, 'quiz' or 'regular', defaults to 'regular'" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:15 +#: aiogram.types.message.Message.reply_poll:16 of +msgid "" +":code:`True`, if the poll allows multiple answers, ignored for polls in " +"quiz mode, defaults to :code:`False`" msgstr "" + +#: aiogram.types.message.Message.answer_poll:16 +#: aiogram.types.message.Message.reply_poll:17 of +msgid "" +"0-based identifier of the correct answer option, required for polls in " +"quiz mode" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:17 +#: aiogram.types.message.Message.reply_poll:18 of +msgid "" +"Text that is shown when a user chooses an incorrect answer or taps on the" +" lamp icon in a quiz-style poll, 0-200 characters with at most 2 line " +"feeds after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:18 +#: aiogram.types.message.Message.reply_poll:19 of +msgid "" +"Mode for parsing entities in the explanation. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:19 +#: aiogram.types.message.Message.reply_poll:20 of +msgid "" +"A JSON-serialized list of special entities that appear in the poll " +"explanation, which can be specified instead of *parse_mode*" +msgstr "" + +#: aiogram.types.message.Message.answer_poll:20 +#: aiogram.types.message.Message.reply_poll:21 of +msgid "" +"Amount of time in seconds the poll will be active after creation, 5-600. " +"Can't be used together with *close_date*." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:21 +#: aiogram.types.message.Message.reply_poll:22 of +msgid "" +"Point in time (Unix timestamp) when the poll will be automatically " +"closed. Must be at least 5 and no more than 600 seconds in the future. " +"Can't be used together with *open_period*." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:22 +#: aiogram.types.message.Message.reply_poll:23 of +msgid "" +"Pass :code:`True` if the poll needs to be immediately closed. This can be" +" useful for poll preview." +msgstr "" + +#: aiogram.types.message.Message.answer_poll:28 +#: aiogram.types.message.Message.reply_poll:28 of +msgid "instance of method :class:`aiogram.methods.send_poll.SendPoll`" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:1 +#: aiogram.types.message.Message.reply_dice:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_dice.SendDice` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:7 +#: aiogram.types.message.Message.reply_dice:8 of +msgid "" +"Use this method to send an animated emoji that will display a random " +"value. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." +msgstr "" + +#: aiogram.types.message.Message.answer_dice:9 +#: aiogram.types.message.Message.reply_dice:10 of +msgid "Source: https://core.telegram.org/bots/api#senddice" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:11 +#: aiogram.types.message.Message.reply_dice:12 of +msgid "" +"Emoji on which the dice throw animation is based. Currently, must be one " +"of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯'" +" and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults " +"to '🎲'" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:13 +#: aiogram.types.message.Message.reply_dice:14 of +msgid "Protects the contents of the sent message from forwarding" +msgstr "" + +#: aiogram.types.message.Message.answer_dice:17 +#: aiogram.types.message.Message.reply_dice:17 of +msgid "instance of method :class:`aiogram.methods.send_dice.SendDice`" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:1 +#: aiogram.types.message.Message.reply_sticker:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:7 +#: aiogram.types.message.Message.reply_sticker:8 of +msgid "" +"Use this method to send static .WEBP, `animated " +"`_ .TGS, or `video " +"`_ .WEBM " +"stickers. On success, the sent :class:`aiogram.types.message.Message` is " +"returned." +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:9 +#: aiogram.types.message.Message.reply_sticker:10 of +msgid "Source: https://core.telegram.org/bots/api#sendsticker" +msgstr "" + +#: aiogram.types.message.Message.answer_sticker:11 +#: aiogram.types.message.Message.reply_sticker:12 of +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 "" + +#: aiogram.types.message.Message.answer_sticker:17 +#: aiogram.types.message.Message.reply_sticker:17 of +msgid "instance of method :class:`aiogram.methods.send_sticker.SendSticker`" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:1 +#: aiogram.types.message.Message.reply_venue:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:7 +#: aiogram.types.message.Message.reply_venue:8 of +msgid "" +"Use this method to send information about a venue. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_venue:9 +#: aiogram.types.message.Message.reply_venue:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvenue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:11 +#: aiogram.types.message.Message.reply_venue:12 of +msgid "Latitude of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:12 +#: aiogram.types.message.Message.reply_venue:13 of +msgid "Longitude of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:13 +#: aiogram.types.message.Message.reply_venue:14 of +msgid "Name of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:14 +#: aiogram.types.message.Message.reply_venue:15 of +msgid "Address of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:15 +#: aiogram.types.message.Message.reply_venue:16 of +msgid "Foursquare identifier of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:16 +#: aiogram.types.message.Message.reply_venue:17 of +msgid "" +"Foursquare type of the venue, if known. (For example, " +"'arts_entertainment/default', 'arts_entertainment/aquarium' or " +"'food/icecream'.)" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:17 +#: aiogram.types.message.Message.reply_venue:18 of +msgid "Google Places identifier of the venue" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:18 +#: aiogram.types.message.Message.reply_venue:19 of +msgid "" +"Google Places type of the venue. (See `supported types " +"`_.)" +msgstr "" + +#: aiogram.types.message.Message.answer_venue:24 +#: aiogram.types.message.Message.reply_venue:24 of +msgid "instance of method :class:`aiogram.methods.send_venue.SendVenue`" +msgstr "" + +#: aiogram.types.message.Message.answer_video:1 +#: aiogram.types.message.Message.reply_video:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_video.SendVideo` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_video:7 +#: aiogram.types.message.Message.reply_video:8 of +msgid "" +"Use this method to send video files, Telegram clients support MPEG4 " +"videos (other formats may be sent as " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send video files of up to 50 MB in size, this limit may be changed in the" +" future." +msgstr "" + +#: aiogram.types.message.Message.answer_video:9 +#: aiogram.types.message.Message.reply_video:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvideo" +msgstr "" + +#: aiogram.types.message.Message.answer_video:11 +#: aiogram.types.message.Message.reply_video:12 of +msgid "" +"Video to send. Pass a file_id as String to send a video that exists on " +"the Telegram servers (recommended), pass an HTTP URL as a String for " +"Telegram to get a video from the Internet, or upload a new video using " +"multipart/form-data. :ref:`More information on Sending Files » `" +msgstr "" + +#: aiogram.types.message.Message.answer_video:12 +#: aiogram.types.message.Message.answer_video_note:12 +#: aiogram.types.message.Message.reply_video:13 +#: aiogram.types.message.Message.reply_video_note:13 of +msgid "Duration of sent video in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_video:13 +#: aiogram.types.message.Message.reply_video:14 of +msgid "Video width" +msgstr "" + +#: aiogram.types.message.Message.answer_video:14 +#: aiogram.types.message.Message.reply_video:15 of +msgid "Video height" +msgstr "" + +#: aiogram.types.message.Message.answer_video:16 +#: aiogram.types.message.Message.reply_video:17 of +msgid "" +"Video caption (may also be used when resending videos by *file_id*), " +"0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_video:17 +#: aiogram.types.message.Message.reply_video:18 of +msgid "" +"Mode for parsing entities in the video caption. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.answer_video:19 +#: aiogram.types.message.Message.reply_video:20 of +msgid "Pass :code:`True` if the uploaded video is suitable for streaming" +msgstr "" + +#: aiogram.types.message.Message.answer_video:25 +#: aiogram.types.message.Message.reply_video:25 of +msgid "instance of method :class:`aiogram.methods.send_video.SendVideo`" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:1 +#: aiogram.types.message.Message.reply_video_note:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.send_video_note.SendVideoNote` will automatically" +" fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:7 +#: aiogram.types.message.Message.reply_video_note:8 of +msgid "" +"As of `v.4.0 `_, " +"Telegram clients support rounded square MPEG4 videos of up to 1 minute " +"long. Use this method to send video messages. On success, the sent " +":class:`aiogram.types.message.Message` is returned." +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:9 +#: aiogram.types.message.Message.reply_video_note:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvideonote" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:11 +#: aiogram.types.message.Message.reply_video_note:12 of +msgid "" +"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" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:13 +#: aiogram.types.message.Message.reply_video_note:14 of +msgid "Video width and height, i.e. diameter of the video message" +msgstr "" + +#: aiogram.types.message.Message.answer_video_note:20 +#: aiogram.types.message.Message.reply_video_note:20 of +msgid "instance of method :class:`aiogram.methods.send_video_note.SendVideoNote`" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:1 +#: aiogram.types.message.Message.reply_voice:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:7 +#: aiogram.types.message.Message.reply_voice:8 of +msgid "" +"Use this method to send audio files, if you want Telegram clients to " +"display the file as a playable voice message. For this to work, your " +"audio must be in an .OGG file encoded with OPUS (other formats may be " +"sent as :class:`aiogram.types.audio.Audio` or " +":class:`aiogram.types.document.Document`). On success, the sent " +":class:`aiogram.types.message.Message` is returned. Bots can currently " +"send voice messages of up to 50 MB in size, this limit may be changed in " +"the future." +msgstr "" + +#: aiogram.types.message.Message.answer_voice:9 +#: aiogram.types.message.Message.reply_voice:10 of +msgid "Source: https://core.telegram.org/bots/api#sendvoice" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:11 +#: aiogram.types.message.Message.reply_voice:12 of +msgid "" +"Audio 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 » `" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:12 +#: aiogram.types.message.Message.reply_voice:13 of +msgid "Voice message caption, 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:13 +#: aiogram.types.message.Message.reply_voice:14 of +msgid "" +"Mode for parsing entities in the voice message caption. See `formatting " +"options `_ for " +"more details." +msgstr "" + +#: aiogram.types.message.Message.answer_voice:15 +#: aiogram.types.message.Message.reply_voice:16 of +msgid "Duration of the voice message in seconds" +msgstr "" + +#: aiogram.types.message.Message.answer_voice:21 +#: aiogram.types.message.Message.reply_voice:21 of +msgid "instance of method :class:`aiogram.methods.send_voice.SendVoice`" +msgstr "" + +#: aiogram.types.message.Message.send_copy:1 of +msgid "Send copy of message." +msgstr "" + +#: aiogram.types.message.Message.send_copy:3 of +msgid "" +"Is similar to :meth:`aiogram.client.bot.Bot.copy_message` but returning " +"the sent message instead of :class:`aiogram.types.message_id.MessageId`" +msgstr "" + +#: aiogram.types.message.Message.send_copy:8 of +msgid "" +"This method don't use the API method named `copyMessage` and historically" +" implemented before the similar method is added to API" +msgstr "" + +#: aiogram.types.message.Message.copy_to:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.copy_message.CopyMessage` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.copy_to:4 +#: aiogram.types.message.Message.forward:4 of +msgid ":code:`from_chat_id`" +msgstr "" + +#: aiogram.types.message.Message.copy_to:5 +#: aiogram.types.message.Message.delete:5 +#: aiogram.types.message.Message.edit_caption:5 +#: aiogram.types.message.Message.edit_live_location:5 +#: aiogram.types.message.Message.edit_media:5 +#: aiogram.types.message.Message.edit_reply_markup:5 +#: aiogram.types.message.Message.edit_text:5 +#: aiogram.types.message.Message.forward:5 aiogram.types.message.Message.pin:5 +#: aiogram.types.message.Message.stop_live_location:5 +#: aiogram.types.message.Message.unpin:5 of +msgid ":code:`message_id`" +msgstr "" + +#: aiogram.types.message.Message.copy_to:7 of +msgid "" +"Use this method to copy messages of any kind. Service messages and " +"invoice messages can't be copied. A quiz " +":class:`aiogram.methods.poll.Poll` can be copied only if the value of the" +" field *correct_option_id* is known to the bot. The method is analogous " +"to the method :class:`aiogram.methods.forward_message.ForwardMessage`, " +"but the copied message doesn't have a link to the original message. " +"Returns the :class:`aiogram.types.message_id.MessageId` of the sent " +"message on success." +msgstr "" + +#: aiogram.types.message.Message.copy_to:9 of +msgid "Source: https://core.telegram.org/bots/api#copymessage" +msgstr "" + +#: aiogram.types.message.Message.copy_to:11 +#: aiogram.types.message.Message.forward:11 of +msgid "" +"Unique identifier for the target chat or username of the target channel " +"(in the format :code:`@channelusername`)" +msgstr "" + +#: aiogram.types.message.Message.copy_to:12 +#: aiogram.types.message.Message.forward:12 of +msgid "" +"Unique identifier for the target message thread (topic) of the forum; for" +" forum supergroups only" +msgstr "" + +#: aiogram.types.message.Message.copy_to:13 of +msgid "" +"New caption for media, 0-1024 characters after entities parsing. If not " +"specified, the original caption is kept" +msgstr "" + +#: aiogram.types.message.Message.copy_to:14 of +msgid "" +"Mode for parsing entities in the new caption. See `formatting options " +"`_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.copy_to:15 of +msgid "" +"A JSON-serialized list of special entities that appear in the new " +"caption, which can be specified instead of *parse_mode*" +msgstr "" + +#: aiogram.types.message.Message.copy_to:21 of +msgid "instance of method :class:`aiogram.methods.copy_message.CopyMessage`" +msgstr "" + +#: aiogram.types.message.Message.edit_text:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_text.EditMessageText` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_text:7 of +msgid "" +"Use this method to edit text and `game " +"`_ messages. 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." +msgstr "" + +#: aiogram.types.message.Message.edit_text:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagetext" +msgstr "" + +#: aiogram.types.message.Message.edit_text:11 of +msgid "New text of the message, 1-4096 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:11 +#: aiogram.types.message.Message.edit_live_location:13 +#: aiogram.types.message.Message.edit_media:12 +#: aiogram.types.message.Message.edit_reply_markup:11 +#: aiogram.types.message.Message.edit_text:12 +#: aiogram.types.message.Message.stop_live_location:11 of +msgid "" +"Required if *chat_id* and *message_id* are not specified. Identifier of " +"the inline message" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:15 +#: aiogram.types.message.Message.edit_reply_markup:12 +#: aiogram.types.message.Message.edit_text:16 of +msgid "" +"A JSON-serialized object for an `inline keyboard " +"`_." +msgstr "" + +#: aiogram.types.message.Message.edit_text:17 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_text.EditMessageText`" +msgstr "" + +#: aiogram.types.message.Message.forward:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.forward_message.ForwardMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.forward:7 of +msgid "" +"Use this method to forward messages of any kind. Service messages can't " +"be forwarded. On success, the sent :class:`aiogram.types.message.Message`" +" is returned." +msgstr "" + +#: aiogram.types.message.Message.forward:9 of +msgid "Source: https://core.telegram.org/bots/api#forwardmessage" +msgstr "" + +#: aiogram.types.message.Message.forward:14 of +msgid "Protects the contents of the forwarded message from forwarding and saving" +msgstr "" + +#: aiogram.types.message.Message.forward:15 of +msgid "instance of method :class:`aiogram.methods.forward_message.ForwardMessage`" +msgstr "" + +#: aiogram.types.message.Message.edit_media:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_media.EditMessageMedia` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_media:7 of +msgid "" +"Use this method to edit animation, audio, document, photo, or video " +"messages. If a message is part of a message album, then it can be edited " +"only to an audio for audio albums, only to a document for document albums" +" and to a photo or a video otherwise. When an inline message is edited, a" +" new file can't be uploaded; use a previously uploaded file via its " +"file_id or specify a URL. On success, if the edited message is not an " +"inline message, the edited :class:`aiogram.types.message.Message` is " +"returned, otherwise :code:`True` is returned." +msgstr "" + +#: aiogram.types.message.Message.edit_media:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagemedia" +msgstr "" + +#: aiogram.types.message.Message.edit_media:11 of +msgid "A JSON-serialized object for a new media content of the message" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:17 +#: aiogram.types.message.Message.edit_media:13 +#: aiogram.types.message.Message.stop_live_location:12 of +msgid "" +"A JSON-serialized object for a new `inline keyboard " +"`_." +msgstr "" + +#: aiogram.types.message.Message.edit_media:14 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_media.EditMessageMedia`" +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:7 of +msgid "" +"Use this method to edit only the reply markup of messages. 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." +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagereplymarkup" +msgstr "" + +#: aiogram.types.message.Message.edit_reply_markup:13 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup`" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:7 of +msgid "" +"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." +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagelivelocation" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:11 of +msgid "Latitude of new location" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:12 of +msgid "Longitude of new location" +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:15 of +msgid "" +"Direction in which the user is moving, in degrees. Must be between 1 and " +"360 if specified." +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:16 of +msgid "" +"The maximum distance for proximity alerts about approaching another chat " +"member, in meters. Must be between 1 and 100000 if specified." +msgstr "" + +#: aiogram.types.message.Message.edit_live_location:18 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation`" +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:7 of +msgid "" +"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." +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:9 of +msgid "Source: https://core.telegram.org/bots/api#stopmessagelivelocation" +msgstr "" + +#: aiogram.types.message.Message.stop_live_location:13 of +msgid "" +"instance of method " +":class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.edit_message_caption.EditMessageCaption` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:7 of +msgid "" +"Use this method to edit captions of messages. 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." +msgstr "" + +#: aiogram.types.message.Message.edit_caption:9 of +msgid "Source: https://core.telegram.org/bots/api#editmessagecaption" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:12 of +msgid "New caption of the message, 0-1024 characters after entities parsing" +msgstr "" + +#: aiogram.types.message.Message.edit_caption:13 of +msgid "" +"Mode for parsing entities in the message caption. See `formatting options" +" `_ for more " +"details." +msgstr "" + +#: aiogram.types.message.Message.edit_caption:16 of +msgid "" +"instance of method " +":class:`aiogram.methods.edit_message_caption.EditMessageCaption`" +msgstr "" + +#: aiogram.types.message.Message.delete:1 of +msgid "" +"Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.delete:7 of +msgid "" +"Use this method to delete a message, including service messages, with the" +" following limitations:" +msgstr "" + +#: aiogram.types.message.Message.delete:9 of +msgid "A message can only be deleted if it was sent less than 48 hours ago." +msgstr "" + +#: aiogram.types.message.Message.delete:11 of +msgid "" +"Service messages about a supergroup, channel, or forum topic creation " +"can't be deleted." +msgstr "" + +#: aiogram.types.message.Message.delete:13 of +msgid "" +"A dice message in a private chat can only be deleted if it was sent more " +"than 24 hours ago." +msgstr "" + +#: aiogram.types.message.Message.delete:15 of +msgid "" +"Bots can delete outgoing messages in private chats, groups, and " +"supergroups." +msgstr "" + +#: aiogram.types.message.Message.delete:17 of +msgid "Bots can delete incoming messages in private chats." +msgstr "" + +#: aiogram.types.message.Message.delete:19 of +msgid "" +"Bots granted *can_post_messages* permissions can delete outgoing messages" +" in channels." +msgstr "" + +#: aiogram.types.message.Message.delete:21 of +msgid "" +"If the bot is an administrator of a group, it can delete any message " +"there." +msgstr "" + +#: aiogram.types.message.Message.delete:23 of +msgid "" +"If the bot has *can_delete_messages* permission in a supergroup or a " +"channel, it can delete any message there." +msgstr "" + +#: aiogram.types.message.Message.delete:25 of +msgid "Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.message.Message.delete:27 of +msgid "Source: https://core.telegram.org/bots/api#deletemessage" +msgstr "" + +#: aiogram.types.message.Message.delete:29 of +msgid "instance of method :class:`aiogram.methods.delete_message.DeleteMessage`" +msgstr "" + +#: aiogram.types.message.Message.pin:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.pin:7 of +msgid "" +"Use this method to add a message to the list of pinned messages in a " +"chat. If the chat is not a private chat, the bot must be an administrator" +" in the chat for this to work and must have the 'can_pin_messages' " +"administrator right in a supergroup or 'can_edit_messages' administrator " +"right in a channel. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.message.Message.pin:9 of +msgid "Source: https://core.telegram.org/bots/api#pinchatmessage" +msgstr "" + +#: aiogram.types.message.Message.pin:11 of +msgid "" +"Pass :code:`True` if it is not necessary to send a notification to all " +"chat members about the new pinned message. Notifications are always " +"disabled in channels and private chats." +msgstr "" + +#: aiogram.types.message.Message.pin:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.pin_chat_message.PinChatMessage`" +msgstr "" + +#: aiogram.types.message.Message.unpin:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` will " +"automatically fill method attributes:" +msgstr "" + +#: aiogram.types.message.Message.unpin:7 of +msgid "" +"Use this method to remove a message from the list of pinned messages in a" +" chat. If the chat is not a private chat, the bot must be an " +"administrator in the chat for this to work and must have the " +"'can_pin_messages' administrator right in a supergroup or " +"'can_edit_messages' administrator right in a channel. Returns " +":code:`True` on success." +msgstr "" + +#: aiogram.types.message.Message.unpin:9 of +msgid "Source: https://core.telegram.org/bots/api#unpinchatmessage" +msgstr "" + +#: aiogram.types.message.Message.unpin:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_chat_message.UnpinChatMessage`" +msgstr "" + +#: aiogram.types.message.Message.get_url:1 of +msgid "" +"Returns message URL. Cannot be used in private (one-to-one) chats. If " +"chat has a username, returns URL like https://t.me/username/message_id " +"Otherwise (or if {force_private} flag is set), returns " +"https://t.me/c/shifted_chat_id/message_id" +msgstr "" + +#: aiogram.types.message.Message.get_url:5 of +msgid "if set, a private URL is returned even for a public chat" +msgstr "" + +#: aiogram.types.message.Message.get_url:6 of +msgid "string with full message URL" +msgstr "" + +#~ msgid "Reply with animation" +#~ msgstr "" + +#~ msgid "Answer with animation" +#~ msgstr "" + +#~ msgid "Reply with audio" +#~ msgstr "" + +#~ msgid "Answer with audio" +#~ msgstr "" + +#~ msgid "Reply with contact" +#~ msgstr "" + +#~ msgid "Answer with contact" +#~ msgstr "" + +#~ msgid "Reply with document" +#~ msgstr "" + +#~ msgid "Answer with document" +#~ msgstr "" + +#~ msgid "Reply with game" +#~ msgstr "" + +#~ msgid "Answer with game" +#~ msgstr "" + +#~ msgid "Reply with invoice" +#~ msgstr "" + +#~ msgid "" +#~ "A JSON-serialized object for an " +#~ "`inline keyboard `_. If empty, one 'Pay " +#~ ":code:`total price`' button will be " +#~ "shown. If not empty, the first " +#~ "button must be a Pay button." +#~ msgstr "" + +#~ msgid "On success, the sent Message is returned." +#~ msgstr "" + +#~ msgid "Answer with invoice" +#~ msgstr "" + +#~ msgid "Reply with location" +#~ msgstr "" + +#~ msgid "Answer with location" +#~ msgstr "" + +#~ msgid "Reply with media group" +#~ msgstr "" + +#~ msgid "Answer with media group" +#~ msgstr "" + +#~ msgid "Reply with text message" +#~ msgstr "" + +#~ msgid "Answer with text message" +#~ msgstr "" + +#~ msgid "Reply with photo" +#~ msgstr "" + +#~ msgid "Answer with photo" +#~ msgstr "" + +#~ msgid "Reply with poll" +#~ msgstr "" + +#~ msgid "Answer with poll" +#~ msgstr "" + +#~ msgid ":param explanation:" +#~ msgstr "" + +#~ msgid "param explanation" +#~ msgstr "" + +#~ msgid "Reply with dice" +#~ msgstr "" + +#~ msgid "Answer with dice" +#~ msgstr "" + +#~ msgid "Reply with sticker" +#~ msgstr "" + +#~ msgid "Answer with sticker" +#~ msgstr "" + +#~ msgid "Reply with venue" +#~ msgstr "" + +#~ msgid "Answer with venue" +#~ msgstr "" + +#~ msgid "Reply with video" +#~ msgstr "" + +#~ msgid "Answer with video" +#~ msgstr "" + +#~ msgid "Reply wit video note" +#~ msgstr "" + +#~ msgid "Answer wit video note" +#~ msgstr "" + +#~ msgid "Reply with voice" +#~ msgstr "" + +#~ msgid "Answer with voice" +#~ msgstr "" + +#~ msgid "Copy message" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/message_entity.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/message_entity.po index e295f9d287..806b3cd098 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/message_entity.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/message_entity.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -46,11 +46,15 @@ msgid "" msgstr "" #: ../../docstring aiogram.types.message_entity.MessageEntity.offset:1 of -msgid "Offset in UTF-16 code units to the start of the entity" +msgid "" +"Offset in `UTF-16 code units `_ to the start of the entity" msgstr "" #: ../../docstring aiogram.types.message_entity.MessageEntity.length:1 of -msgid "Length of the entity in UTF-16 code units" +msgid "" +"Length of the entity in `UTF-16 code units " +"`_" msgstr "" #: ../../docstring aiogram.types.message_entity.MessageEntity.url:1 of @@ -75,3 +79,9 @@ msgid "" ":class:`aiogram.methods.get_custom_emoji_stickers.GetCustomEmojiStickers`" " to get full information about the sticker" msgstr "" + +#~ msgid "Offset in UTF-16 code units to the start of the entity" +#~ msgstr "" + +#~ msgid "Length of the entity in UTF-16 code units" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/reply_keyboard_markup.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/reply_keyboard_markup.po index 3628893b1e..43841e57ba 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/reply_keyboard_markup.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/reply_keyboard_markup.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -24,9 +24,10 @@ msgstr "" #: aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup:1 of msgid "" "This object represents a `custom keyboard " -"`_ with reply options (see " -"`Introduction to bots `_ for " -"details and examples)." +"`_ with reply options " +"(see `Introduction to bots " +"`_ for details and " +"examples)." msgstr "" #: aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup:3 of @@ -77,3 +78,11 @@ msgid "" "message is a reply (has *reply_to_message_id*), sender of the original " "message." msgstr "" + +#~ msgid "" +#~ "This object represents a `custom " +#~ "keyboard `_ with" +#~ " reply options (see `Introduction to " +#~ "bots `_ for " +#~ "details and examples)." +#~ 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 9a27d3aa22..4f8fc38b7f 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/sticker.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/sticker.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -99,3 +99,67 @@ msgstr "" #: ../../docstring aiogram.types.sticker.Sticker.file_size:1 of msgid "*Optional*. File size in bytes" msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:4 +#: aiogram.types.sticker.Sticker.set_position_in_set:4 of +msgid ":code:`sticker`" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:6 of +msgid "" +"Use this method to move a sticker in a set created by the bot to a " +"specific position. Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:8 of +msgid "Source: https://core.telegram.org/bots/api#setstickerpositioninset" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set of +msgid "Parameters" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:10 of +msgid "New sticker position in the set, zero-based" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set +#: aiogram.types.sticker.Sticker.set_position_in_set of +msgid "Returns" +msgstr "" + +#: aiogram.types.sticker.Sticker.set_position_in_set:11 of +msgid "" +"instance of method " +":class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet`" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:6 of +msgid "" +"Use this method to delete a sticker from a set created by the bot. " +"Returns :code:`True` on success." +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:8 of +msgid "Source: https://core.telegram.org/bots/api#deletestickerfromset" +msgstr "" + +#: aiogram.types.sticker.Sticker.delete_from_set:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet`" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/user.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/user.po index d2ffb3dca6..b7e590b305 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/user.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/user.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -90,6 +90,53 @@ msgid "" "only in :class:`aiogram.methods.get_me.GetMe`." msgstr "" +#: aiogram.types.user.User.get_profile_photos:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos` " +"will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:4 of +msgid ":code:`user_id`" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:6 of +msgid "" +"Use this method to get a list of profile pictures for a user. Returns a " +":class:`aiogram.types.user_profile_photos.UserProfilePhotos` object." +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:8 of +msgid "Source: https://core.telegram.org/bots/api#getuserprofilephotos" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos of +msgid "Parameters" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:10 of +msgid "" +"Sequential number of the first photo to be returned. By default, all " +"photos are returned." +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:11 of +msgid "" +"Limits the number of photos to be retrieved. Values between 1-100 are " +"accepted. Defaults to 100." +msgstr "" + +#: aiogram.types.user.User.get_profile_photos of +msgid "Returns" +msgstr "" + +#: aiogram.types.user.User.get_profile_photos:12 of +msgid "" +"instance of method " +":class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos`" +msgstr "" + #~ msgid "This object represents a Telegram user or bot." #~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/changelog.po b/docs/locale/uk_UA/LC_MESSAGES/changelog.po index 4b0fb64390..7aa019906b 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/changelog.po +++ b/docs/locale/uk_UA/LC_MESSAGES/changelog.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -21,29 +21,194 @@ msgstr "" msgid "Changelog" msgstr "" -#: ../../../CHANGES.rst:18 -msgid "3.0.0b5 (2022-10-02)" +#: ../../[towncrier-fragments]:2 +msgid "\\ |release| [UNRELEASED DRAFT] (2022-11-23)" msgstr "" -#: ../../../CHANGES.rst:21 ../../../CHANGES.rst:72 ../../../CHANGES.rst:145 -#: ../../../CHANGES.rst:186 ../../../CHANGES.rst:224 ../../../CHANGES.rst:272 -#: ../../../CHANGES.rst:348 ../../../CHANGES.rst:381 ../../../CHANGES.rst:412 +#: ../../../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" msgstr "" -#: ../../../CHANGES.rst:23 +#: ../../[towncrier-fragments]:7 +msgid "" +"Added missing shortcuts, new enums, reworked old stuff `#952 " +"`_" +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]:12 +msgid "Misc" +msgstr "" + +#: ../../[towncrier-fragments]:14 +msgid "" +"Added integration with new code-generator named `Butcher " +"`_ `#1069 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:20 +msgid "3.0.0b6 (2022-11-18)" +msgstr "" + +#: ../../../CHANGES.rst:25 +msgid "" +"(again) Added possibility to combine filters with an *and*/*or* " +"operations." +msgstr "" + +#: ../../../CHANGES.rst:27 +msgid "" +"Read more in \":ref:`Combining filters `\" " +"documentation section `#1018 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:29 +msgid "Added following methods to ``Message`` class:" +msgstr "" + +#: ../../../CHANGES.rst:31 +msgid ":code:`Message.forward(...)`" +msgstr "" + +#: ../../../CHANGES.rst:32 +msgid ":code:`Message.edit_media(...)`" +msgstr "" + +#: ../../../CHANGES.rst:33 +msgid ":code:`Message.edit_live_location(...)`" +msgstr "" + +#: ../../../CHANGES.rst:34 +msgid ":code:`Message.stop_live_location(...)`" +msgstr "" + +#: ../../../CHANGES.rst:35 +msgid ":code:`Message.pin(...)`" +msgstr "" + +#: ../../../CHANGES.rst:36 +msgid ":code:`Message.unpin()`" +msgstr "" + +#: ../../../CHANGES.rst:37 +msgid "`#1030 `_" +msgstr "" + +#: ../../../CHANGES.rst:38 +msgid "Added following methods to :code:`User` class:" +msgstr "" + +#: ../../../CHANGES.rst:40 +msgid ":code:`User.mention_markdown(...)`" +msgstr "" + +#: ../../../CHANGES.rst:41 +msgid ":code:`User.mention_html(...)`" +msgstr "" + +#: ../../../CHANGES.rst:42 +msgid "`#1049 `_" +msgstr "" + +#: ../../../CHANGES.rst:43 +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 +msgid "" +"Fixed :code:`Message.send_invoice` and :code:`Message.reply_invoice`, " +"added missing arguments `#1047 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:52 +msgid "Fixed copy and forward in:" +msgstr "" + +#: ../../../CHANGES.rst:54 +msgid ":code:`Message.answer(...)`" +msgstr "" + +#: ../../../CHANGES.rst:55 +msgid ":code:`Message.copy_to(...)`" +msgstr "" + +#: ../../../CHANGES.rst:56 +msgid "`#1064 `_" +msgstr "" + +#: ../../../CHANGES.rst:60 ../../../CHANGES.rst:110 ../../../CHANGES.rst:490 +msgid "Improved Documentation" +msgstr "" + +#: ../../../CHANGES.rst:62 +msgid "" +"Fixed UA translations in index.po `#1017 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:64 +msgid "" +"Fix typehints for :code:`Message`, :code:`reply_media_group` and " +":code:`answer_media_group` methods `#1029 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:66 +msgid "" +"Removed an old now non-working feature `#1060 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:73 +msgid "" +"Enabled testing on Python 3.11 `#1044 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:75 +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" +" fails with reason :code:`[SSL: CERTIFICATE_VERIFY_FAILED] certificate " +"verify failed: self signed certificate in certificate chain` `#1066 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:80 +msgid "3.0.0b5 (2022-10-02)" +msgstr "" + +#: ../../../CHANGES.rst:85 msgid "" "Add PyPy support and run tests under PyPy `#985 " "`_" msgstr "" -#: ../../../CHANGES.rst:25 +#: ../../../CHANGES.rst:87 msgid "" "Added message text to aiogram exceptions representation `#988 " "`_" msgstr "" -#: ../../../CHANGES.rst:27 +#: ../../../CHANGES.rst:89 msgid "" "Added warning about using magic filter from `magic_filter` instead of " "`aiogram`'s ones. Is recommended to use `from aiogram import F` instead " @@ -51,82 +216,65 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:30 +#: ../../../CHANGES.rst:92 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:35 ../../../CHANGES.rst:96 ../../../CHANGES.rst:154 -#: ../../../CHANGES.rst:200 ../../../CHANGES.rst:248 ../../../CHANGES.rst:304 -#: ../../../CHANGES.rst:389 ../../../CHANGES.rst:421 -msgid "Bugfixes" -msgstr "" - -#: ../../../CHANGES.rst:37 +#: ../../../CHANGES.rst:99 msgid "" "Reworked error event, introduced " ":class:`aiogram.types.error_event.ErrorEvent` object. `#898 " "`_" msgstr "" -#: ../../../CHANGES.rst:39 +#: ../../../CHANGES.rst:101 msgid "" "Fixed escaping markdown in `aiogram.utils.markdown` module `#903 " "`_" msgstr "" -#: ../../../CHANGES.rst:41 +#: ../../../CHANGES.rst:103 msgid "" "Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. " "`#995 `_" msgstr "" -#: ../../../CHANGES.rst:43 +#: ../../../CHANGES.rst:105 msgid "" "Fixed empty mention in command parsing, now it will be None instead of an" " empty string `#1013 `_" msgstr "" -#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:428 -msgid "Improved Documentation" -msgstr "" - -#: ../../../CHANGES.rst:50 +#: ../../../CHANGES.rst:112 msgid "" "Initialized Docs translation (added Ukrainian language) `#925 " "`_" msgstr "" -#: ../../../CHANGES.rst:55 +#: ../../../CHANGES.rst:117 msgid "Deprecations and Removals" msgstr "" -#: ../../../CHANGES.rst:57 +#: ../../../CHANGES.rst:119 msgid "" "Removed filters factory as described in corresponding issue. `#942 " "`_" msgstr "" -#: ../../../CHANGES.rst:62 ../../../CHANGES.rst:113 ../../../CHANGES.rst:167 -#: ../../../CHANGES.rst:209 ../../../CHANGES.rst:255 ../../../CHANGES.rst:315 -#: ../../../CHANGES.rst:336 ../../../CHANGES.rst:359 ../../../CHANGES.rst:396 -#: ../../../CHANGES.rst:435 -msgid "Misc" -msgstr "" - -#: ../../../CHANGES.rst:64 +#: ../../../CHANGES.rst:126 msgid "" "Now Router/Dispatcher accepts only keyword arguments. `#982 " "`_" msgstr "" -#: ../../../CHANGES.rst:69 +#: ../../../CHANGES.rst:131 msgid "3.0.0b4 (2022-08-14)" msgstr "" -#: ../../../CHANGES.rst:74 +#: ../../../CHANGES.rst:136 msgid "" "Add class helper ChatAction for constants that Telegram BotAPI uses in " "sendChatAction request. In my opinion, this will help users and will also" @@ -134,198 +282,198 @@ msgid "" "\"ChatActions\". `#803 `_" msgstr "" -#: ../../../CHANGES.rst:78 +#: ../../../CHANGES.rst:140 msgid "Added possibility to combine filters or invert result" msgstr "" -#: ../../../CHANGES.rst:80 +#: ../../../CHANGES.rst:142 msgid "Example:" msgstr "" -#: ../../../CHANGES.rst:88 +#: ../../../CHANGES.rst:150 msgid "`#894 `_" msgstr "" -#: ../../../CHANGES.rst:89 +#: ../../../CHANGES.rst:151 msgid "" "Fixed type hints for redis TTL params. `#922 " "`_" msgstr "" -#: ../../../CHANGES.rst:91 +#: ../../../CHANGES.rst:153 msgid "" "Added `full_name` shortcut for `Chat` object `#929 " "`_" msgstr "" -#: ../../../CHANGES.rst:98 +#: ../../../CHANGES.rst:160 msgid "" "Fixed false-positive coercing of Union types in API methods `#901 " "`_" msgstr "" -#: ../../../CHANGES.rst:100 +#: ../../../CHANGES.rst:162 msgid "Added 3 missing content types:" msgstr "" -#: ../../../CHANGES.rst:102 +#: ../../../CHANGES.rst:164 msgid "proximity_alert_triggered" msgstr "" -#: ../../../CHANGES.rst:103 +#: ../../../CHANGES.rst:165 msgid "supergroup_chat_created" msgstr "" -#: ../../../CHANGES.rst:104 +#: ../../../CHANGES.rst:166 msgid "channel_chat_created" msgstr "" -#: ../../../CHANGES.rst:105 +#: ../../../CHANGES.rst:167 msgid "`#906 `_" msgstr "" -#: ../../../CHANGES.rst:106 +#: ../../../CHANGES.rst:168 msgid "" "Fixed the ability to compare the state, now comparison to copy of the " "state will return `True`. `#927 " "`_" msgstr "" -#: ../../../CHANGES.rst:108 +#: ../../../CHANGES.rst:170 msgid "" "Fixed default lock kwargs in RedisEventIsolation. `#972 " "`_" msgstr "" -#: ../../../CHANGES.rst:115 +#: ../../../CHANGES.rst:177 msgid "" "Restrict including routers with strings `#896 " "`_" msgstr "" -#: ../../../CHANGES.rst:117 +#: ../../../CHANGES.rst:179 msgid "" "Changed CommandPatterType to CommandPatternType in " "`aiogram/dispatcher/filters/command.py` `#907 " "`_" msgstr "" -#: ../../../CHANGES.rst:119 +#: ../../../CHANGES.rst:181 msgid "" "Added full support of `Bot API 6.1 `_ `#936 " "`_" msgstr "" -#: ../../../CHANGES.rst:121 +#: ../../../CHANGES.rst:183 msgid "**Breaking!** More flat project structure" msgstr "" -#: ../../../CHANGES.rst:123 +#: ../../../CHANGES.rst:185 msgid "These packages was moved, imports in your code should be fixed:" msgstr "" -#: ../../../CHANGES.rst:125 +#: ../../../CHANGES.rst:187 msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`" msgstr "" -#: ../../../CHANGES.rst:126 +#: ../../../CHANGES.rst:188 msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`" msgstr "" -#: ../../../CHANGES.rst:127 +#: ../../../CHANGES.rst:189 msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`" msgstr "" -#: ../../../CHANGES.rst:128 +#: ../../../CHANGES.rst:190 msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`" msgstr "" -#: ../../../CHANGES.rst:129 +#: ../../../CHANGES.rst:191 msgid "" ":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` " "(single module instead of package)" msgstr "" -#: ../../../CHANGES.rst:130 +#: ../../../CHANGES.rst:192 msgid "`#938 `_" msgstr "" -#: ../../../CHANGES.rst:131 +#: ../../../CHANGES.rst:193 msgid "" "Removed deprecated :code:`router._handler` and " ":code:`router.register__handler` methods. `#941 " "`_" msgstr "" -#: ../../../CHANGES.rst:133 +#: ../../../CHANGES.rst:195 msgid "" "Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942" " `_" msgstr "" -#: ../../../CHANGES.rst:135 +#: ../../../CHANGES.rst:197 msgid "" "`MessageEntity` method `get_text` was removed and `extract` was renamed " "to `extract_from` `#944 `_" msgstr "" -#: ../../../CHANGES.rst:137 +#: ../../../CHANGES.rst:199 msgid "" "Added full support of `Bot API 6.2 `_ `#975 " "`_" msgstr "" -#: ../../../CHANGES.rst:142 +#: ../../../CHANGES.rst:204 msgid "3.0.0b3 (2022-04-19)" msgstr "" -#: ../../../CHANGES.rst:147 +#: ../../../CHANGES.rst:209 msgid "" "Added possibility to get command magic result as handler argument `#889 " "`_" msgstr "" -#: ../../../CHANGES.rst:149 +#: ../../../CHANGES.rst:211 msgid "" "Added full support of `Telegram Bot API 6.0 " "`_ `#890 " "`_" msgstr "" -#: ../../../CHANGES.rst:156 +#: ../../../CHANGES.rst:218 msgid "" "Fixed I18n lazy-proxy. Disabled caching. `#839 " "`_" msgstr "" -#: ../../../CHANGES.rst:158 +#: ../../../CHANGES.rst:220 msgid "" "Added parsing of spoiler message entity `#865 " "`_" msgstr "" -#: ../../../CHANGES.rst:160 +#: ../../../CHANGES.rst:222 msgid "" "Fixed default `parse_mode` for `Message.copy_to()` method. `#876 " "`_" msgstr "" -#: ../../../CHANGES.rst:162 +#: ../../../CHANGES.rst:224 msgid "" "Fixed CallbackData factory parsing IntEnum's `#885 " "`_" msgstr "" -#: ../../../CHANGES.rst:169 +#: ../../../CHANGES.rst:231 msgid "" "Added automated check that pull-request adds a changes description to " "**CHANGES** directory `#873 " "`_" msgstr "" -#: ../../../CHANGES.rst:171 +#: ../../../CHANGES.rst:233 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" @@ -333,14 +481,14 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:174 +#: ../../../CHANGES.rst:236 msgid "" "Used `redis-py` instead of `aioredis` package in due to this packages was" " merged into single one `#882 " "`_" msgstr "" -#: ../../../CHANGES.rst:176 +#: ../../../CHANGES.rst:238 msgid "" "Solved common naming problem with middlewares that confusing too much " "developers - now you can't see the `middleware` and `middlewares` " @@ -349,113 +497,113 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:183 +#: ../../../CHANGES.rst:245 msgid "3.0.0b2 (2022-02-19)" msgstr "" -#: ../../../CHANGES.rst:188 +#: ../../../CHANGES.rst:250 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:191 +#: ../../../CHANGES.rst:253 msgid "" "Added possibility to add handler flags via decorator (like `pytest.mark` " "decorator but `aiogram.flags`) `#836 " "`_" msgstr "" -#: ../../../CHANGES.rst:193 +#: ../../../CHANGES.rst:255 msgid "" "Added :code:`ChatActionSender` utility to automatically sends chat action" " while long process is running." msgstr "" -#: ../../../CHANGES.rst:195 +#: ../../../CHANGES.rst:257 msgid "" "It also can be used as message middleware and can be customized via " ":code:`chat_action` flag. `#837 " "`_" msgstr "" -#: ../../../CHANGES.rst:202 +#: ../../../CHANGES.rst:264 msgid "" "Fixed unexpected behavior of sequences in the StateFilter. `#791 " "`_" msgstr "" -#: ../../../CHANGES.rst:204 +#: ../../../CHANGES.rst:266 msgid "" "Fixed exceptions filters `#827 " "`_" msgstr "" -#: ../../../CHANGES.rst:211 +#: ../../../CHANGES.rst:273 msgid "" "Logger name for processing events is changed to :code:`aiogram.events`. " "`#830 `_" msgstr "" -#: ../../../CHANGES.rst:213 +#: ../../../CHANGES.rst:275 msgid "" "Added full support of Telegram Bot API 5.6 and 5.7 `#835 " "`_" msgstr "" -#: ../../../CHANGES.rst:215 +#: ../../../CHANGES.rst:277 msgid "" "**BREAKING** Events isolation mechanism is moved from FSM storages to " "standalone managers `#838 " "`_" msgstr "" -#: ../../../CHANGES.rst:221 +#: ../../../CHANGES.rst:283 msgid "3.0.0b1 (2021-12-12)" msgstr "" -#: ../../../CHANGES.rst:226 +#: ../../../CHANGES.rst:288 msgid "Added new custom operation for MagicFilter named :code:`as_`" msgstr "" -#: ../../../CHANGES.rst:228 +#: ../../../CHANGES.rst:290 msgid "Now you can use it to get magic filter result as handler argument" msgstr "" -#: ../../../CHANGES.rst:244 +#: ../../../CHANGES.rst:306 msgid "`#759 `_" msgstr "" -#: ../../../CHANGES.rst:250 +#: ../../../CHANGES.rst:312 msgid "" "Fixed: Missing :code:`ChatMemberHandler` import in " ":code:`aiogram/dispatcher/handler` `#751 " "`_" msgstr "" -#: ../../../CHANGES.rst:257 +#: ../../../CHANGES.rst:319 msgid "" "Check :code:`destiny` in case of no :code:`with_destiny` enabled in " "RedisStorage key builder `#776 " "`_" msgstr "" -#: ../../../CHANGES.rst:259 +#: ../../../CHANGES.rst:321 msgid "" "Added full support of `Bot API 5.5 `_ `#777 " "`_" msgstr "" -#: ../../../CHANGES.rst:261 +#: ../../../CHANGES.rst:323 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:263 +#: ../../../CHANGES.rst:325 msgid "" "Make TelegramAPIServer files wrapper in local mode bi-directional " "(server-client, client-server) Now you can convert local path to server " @@ -463,11 +611,11 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:269 +#: ../../../CHANGES.rst:331 msgid "3.0.0a18 (2021-11-10)" msgstr "" -#: ../../../CHANGES.rst:274 +#: ../../../CHANGES.rst:336 msgid "" "Breaking: Changed the signature of the session middlewares Breaking: " "Renamed AiohttpSession.make_request method parameter from call to method " @@ -475,258 +623,258 @@ msgid "" "outgoing requests `#716 `_" msgstr "" -#: ../../../CHANGES.rst:278 +#: ../../../CHANGES.rst:340 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:288 +#: ../../../CHANGES.rst:350 msgid "`#717 `_" msgstr "" -#: ../../../CHANGES.rst:289 +#: ../../../CHANGES.rst:351 msgid "" "**Breaking internal API change** Reworked FSM Storage record keys " "propagation `#723 `_" msgstr "" -#: ../../../CHANGES.rst:292 +#: ../../../CHANGES.rst:354 msgid "" "Implemented new filter named :code:`MagicData(magic_data)` that helps to " "filter event by data from middlewares or other filters" msgstr "" -#: ../../../CHANGES.rst:294 +#: ../../../CHANGES.rst:356 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:300 +#: ../../../CHANGES.rst:362 msgid "`#724 `_" msgstr "" -#: ../../../CHANGES.rst:306 +#: ../../../CHANGES.rst:368 msgid "" "Fixed I18n context inside error handlers `#726 " "`_" msgstr "" -#: ../../../CHANGES.rst:308 +#: ../../../CHANGES.rst:370 msgid "" "Fixed bot session closing before emit shutdown `#734 " "`_" msgstr "" -#: ../../../CHANGES.rst:310 +#: ../../../CHANGES.rst:372 msgid "" "Fixed: bound filter resolving does not require children routers `#736 " "`_" msgstr "" -#: ../../../CHANGES.rst:317 +#: ../../../CHANGES.rst:379 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:320 +#: ../../../CHANGES.rst:382 msgid "" "Converted README.md to README.rst and use it as base file for docs `#725 " "`_" msgstr "" -#: ../../../CHANGES.rst:322 +#: ../../../CHANGES.rst:384 msgid "Rework filters resolving:" msgstr "" -#: ../../../CHANGES.rst:324 +#: ../../../CHANGES.rst:386 msgid "Automatically apply Bound Filters with default values to handlers" msgstr "" -#: ../../../CHANGES.rst:325 +#: ../../../CHANGES.rst:387 msgid "Fix data transfer from parent to included routers filters" msgstr "" -#: ../../../CHANGES.rst:326 +#: ../../../CHANGES.rst:388 msgid "`#727 `_" msgstr "" -#: ../../../CHANGES.rst:327 +#: ../../../CHANGES.rst:389 msgid "" "Added full support of Bot API 5.4 https://core.telegram.org/bots/api-" "changelog#november-5-2021 `#744 " "`_" msgstr "" -#: ../../../CHANGES.rst:333 +#: ../../../CHANGES.rst:395 msgid "3.0.0a17 (2021-09-24)" msgstr "" -#: ../../../CHANGES.rst:338 +#: ../../../CHANGES.rst:400 msgid "" "Added :code:`html_text` and :code:`md_text` to Message object `#708 " "`_" msgstr "" -#: ../../../CHANGES.rst:340 +#: ../../../CHANGES.rst:402 msgid "" "Refactored I18n, added context managers for I18n engine and current " "locale `#709 `_" msgstr "" -#: ../../../CHANGES.rst:345 +#: ../../../CHANGES.rst:407 msgid "3.0.0a16 (2021-09-22)" msgstr "" -#: ../../../CHANGES.rst:350 +#: ../../../CHANGES.rst:412 msgid "Added support of local Bot API server files downloading" msgstr "" -#: ../../../CHANGES.rst:352 +#: ../../../CHANGES.rst:414 msgid "" "When Local API is enabled files can be downloaded via " "`bot.download`/`bot.download_file` methods. `#698 " "`_" msgstr "" -#: ../../../CHANGES.rst:354 +#: ../../../CHANGES.rst:416 msgid "" "Implemented I18n & L10n support `#701 " "`_" msgstr "" -#: ../../../CHANGES.rst:361 +#: ../../../CHANGES.rst:423 msgid "" "Covered by tests and docs KeyboardBuilder util `#699 " "`_" msgstr "" -#: ../../../CHANGES.rst:363 +#: ../../../CHANGES.rst:425 msgid "**Breaking!!!**. Refactored and renamed exceptions." msgstr "" -#: ../../../CHANGES.rst:365 +#: ../../../CHANGES.rst:427 msgid "" "Exceptions module was moved from :code:`aiogram.utils.exceptions` to " ":code:`aiogram.exceptions`" msgstr "" -#: ../../../CHANGES.rst:366 +#: ../../../CHANGES.rst:428 msgid "Added prefix `Telegram` for all error classes" msgstr "" -#: ../../../CHANGES.rst:367 +#: ../../../CHANGES.rst:429 msgid "`#700 `_" msgstr "" -#: ../../../CHANGES.rst:368 +#: ../../../CHANGES.rst:430 msgid "" "Replaced all :code:`pragma: no cover` marks via global " ":code:`.coveragerc` config `#702 " "`_" msgstr "" -#: ../../../CHANGES.rst:370 +#: ../../../CHANGES.rst:432 msgid "Updated dependencies." msgstr "" -#: ../../../CHANGES.rst:372 +#: ../../../CHANGES.rst:434 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:378 +#: ../../../CHANGES.rst:440 msgid "3.0.0a15 (2021-09-10)" msgstr "" -#: ../../../CHANGES.rst:383 +#: ../../../CHANGES.rst:445 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:391 +#: ../../../CHANGES.rst:453 msgid "" "Fixed incorrect type checking in the " ":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 " "`_" msgstr "" -#: ../../../CHANGES.rst:398 +#: ../../../CHANGES.rst:460 msgid "" "Disable ContentType filter by default `#668 " "`_" msgstr "" -#: ../../../CHANGES.rst:400 +#: ../../../CHANGES.rst:462 msgid "" "Moved update type detection from Dispatcher to Update object `#669 " "`_" msgstr "" -#: ../../../CHANGES.rst:402 +#: ../../../CHANGES.rst:464 msgid "" "Updated **pre-commit** config `#681 " "`_" msgstr "" -#: ../../../CHANGES.rst:404 +#: ../../../CHANGES.rst:466 msgid "" "Reworked **handlers_in_use** util. Function moved to Router as method " "**.resolve_used_update_types()** `#682 " "`_" msgstr "" -#: ../../../CHANGES.rst:409 +#: ../../../CHANGES.rst:471 msgid "3.0.0a14 (2021-08-17)" msgstr "" -#: ../../../CHANGES.rst:414 +#: ../../../CHANGES.rst:476 msgid "" "add aliases for edit/delete reply markup to Message `#662 " "`_" msgstr "" -#: ../../../CHANGES.rst:416 +#: ../../../CHANGES.rst:478 msgid "" "Reworked outer middleware chain. Prevent to call many times the outer " "middleware for each nested router `#664 " "`_" msgstr "" -#: ../../../CHANGES.rst:423 +#: ../../../CHANGES.rst:485 msgid "" "Prepare parse mode for InputMessageContent in AnswerInlineQuery method " "`#660 `_" msgstr "" -#: ../../../CHANGES.rst:430 +#: ../../../CHANGES.rst:492 msgid "" "Added integration with :code:`towncrier` `#602 " "`_" msgstr "" -#: ../../../CHANGES.rst:437 +#: ../../../CHANGES.rst:499 msgid "" "Added `.editorconfig` `#650 " "`_" msgstr "" -#: ../../../CHANGES.rst:439 +#: ../../../CHANGES.rst:501 msgid "" "Redis storage speedup globals `#651 " "`_" msgstr "" -#: ../../../CHANGES.rst:441 +#: ../../../CHANGES.rst:503 msgid "" "add allow_sending_without_reply param to Message reply aliases `#663 " "`_" @@ -2244,3 +2392,16 @@ msgstr "" #: ../../../HISTORY.rst:497 msgid "0.1 (2017-06-03)" msgstr "" + +#~ msgid "" +#~ "Added is_chat_creator method to " +#~ "ChatMemberStatus.yml (`#394 " +#~ "`_)" +#~ msgstr "" + +#~ msgid "" +#~ ":code:`is_member` and :code:`is_admin` methods " +#~ "of :code:`ChatMember` and " +#~ ":code:`ChatMemberStatus.yml` was renamed to " +#~ ":code:`is_chat_member` and :code:`is_chat_admin`" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po index 71534b0fd3..1d194ac3d0 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po +++ b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po @@ -8,7 +8,7 @@ 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: 2022-11-23 00:47+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -58,12 +58,6 @@ msgstr "" msgid "Attach another router." msgstr "" -#: aiogram.dispatcher.router.Router.include_router:3 of -msgid "" -"Can be attached directly or by import string in format " -"\":\"" -msgstr "" - #: aiogram.dispatcher.router.Router.include_router of msgid "Returns" msgstr "" @@ -220,3 +214,9 @@ msgstr "" #: ../../dispatcher/router.rst:190 msgid "In this case update propagation flow will have form:" msgstr "" + +#~ msgid "" +#~ "Can be attached directly or by " +#~ "import string in format " +#~ "\":\"" +#~ msgstr "" diff --git a/poetry.lock b/poetry.lock index a88c4acf97..b7dd6f4b39 100644 --- a/poetry.lock +++ b/poetry.lock @@ -176,7 +176,7 @@ uvloop = ["uvloop (>=0.15.2)"] [[package]] name = "butcher" -version = "0.1.6" +version = "0.1.8" description = "Code-generation utility for aiogram v3 core developers" category = "dev" optional = false @@ -199,8 +199,8 @@ requests = "^2.28.1" [package.source] type = "git" url = "https://github.com/aiogram/butcher.git" -reference = "v0.1.6" -resolved_reference = "2316321fa0fb07ddc7ba9061948419811a90ab7f" +reference = "v0.1.8" +resolved_reference = "88a9e90742190e962877d475cbfeb1d66be699b7" [[package]] name = "certifi" @@ -1353,7 +1353,7 @@ redis = ["redis"] [metadata] lock-version = "1.1" python-versions = "^3.8" -content-hash = "c26eabd7eabaeef760323a44c63ab811cde9d0fc47500c19ec3e02c0314ee561" +content-hash = "475ca0c579e3997fe16a79826e94f7a4f7bc99a98edbd33fc6579580af0582d0" [metadata.files] about-time = [ diff --git a/pyproject.toml b/pyproject.toml index 9a86edd341..06cc85a6bf 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -97,7 +97,7 @@ toml = "^0.10.2" pre-commit = "^2.20.0" packaging = "^21.3" typing-extensions = "^4.3.0" -butcher = { git = "https://github.com/aiogram/butcher.git", rev = "v0.1.6", python = "3.10" } +butcher = { git = "https://github.com/aiogram/butcher.git", rev = "v0.1.8", python = "3.10" } [tool.poetry.extras] diff --git a/tests/test_api/test_methods/test_send_chat_action.py b/tests/test_api/test_methods/test_send_chat_action.py index 98c9d016e6..41f9e3e491 100644 --- a/tests/test_api/test_methods/test_send_chat_action.py +++ b/tests/test_api/test_methods/test_send_chat_action.py @@ -1,7 +1,7 @@ import pytest +from aiogram.enums import ChatAction from aiogram.methods import Request, SendChatAction -from aiogram.types import ChatAction from tests.mocked_bot import MockedBot pytestmark = pytest.mark.asyncio diff --git a/tests/test_api/test_types/test_chat.py b/tests/test_api/test_types/test_chat.py index e2f6bdca06..03cb896324 100644 --- a/tests/test_api/test_types/test_chat.py +++ b/tests/test_api/test_types/test_chat.py @@ -2,7 +2,8 @@ from pytest import mark, param -from aiogram.types import Chat +from aiogram.enums import ChatAction +from aiogram.types import BufferedInputFile, Chat, ChatPermissions class TestChat: @@ -20,6 +21,172 @@ def test_unban_sender_chat(self): assert method.chat_id == chat.id assert method.sender_chat_id == -1337 + def test_get_administrators(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.get_administrators() + assert method.chat_id == chat.id + + def test_delete_message(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.delete_message(message_id=1) + assert method.chat_id == chat.id + + def test_revoke_invite_link(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.revoke_invite_link(invite_link="test") + assert method.chat_id == chat.id + + def test_edit_invite_link(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.edit_invite_link(invite_link="test", name="test") + assert method.chat_id == chat.id + + def test_create_invite_link(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.create_invite_link(name="test") + assert method.chat_id == chat.id + + def test_export_invite_link(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.export_invite_link() + assert method.chat_id == chat.id + + def test_do(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.do(ChatAction.TYPING) + assert method.chat_id == chat.id + + def test_delete_sticker_set(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.delete_sticker_set() + assert method.chat_id == chat.id + + def test_set_sticker_set(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.set_sticker_set(sticker_set_name="test") + assert method.chat_id == chat.id + + def test_get_member(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.get_member(user_id=42) + assert method.chat_id == chat.id + + def test_get_member_count(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.get_member_count() + assert method.chat_id == chat.id + + def test_leave(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.leave() + assert method.chat_id == chat.id + + def test_unpin_all_messages(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.unpin_all_messages() + assert method.chat_id == chat.id + + def test_unpin_message(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.unpin_message() + assert method.chat_id == chat.id + + def test_pin_message(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.pin_message(message_id=1) + assert method.chat_id == chat.id + + def test_set_administrator_custom_title(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.set_administrator_custom_title(user_id=1, custom_title="test") + assert method.chat_id == chat.id + + def test_set_permissions(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.set_permissions( + permissions=ChatPermissions( + can_send_messages=True, + ) + ) + assert method.chat_id == chat.id + + def test_promote(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.promote( + user_id=42, + can_manage_chat=True, + ) + assert method.chat_id == chat.id + + def test_restrict(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.restrict( + user_id=42, + permissions=ChatPermissions( + can_send_messages=True, + ), + ) + assert method.chat_id == chat.id + + def test_unban(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.unban( + user_id=42, + ) + assert method.chat_id == chat.id + + def test_ban(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.ban( + user_id=42, + ) + assert method.chat_id == chat.id + + def test_set_description(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.set_description(description="test") + assert method.chat_id == chat.id + + def test_set_title(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.set_title(title="test") + assert method.chat_id == chat.id + + def test_delete_photo(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.delete_photo(description="test") + assert method.chat_id == chat.id + + def test_set_photo(self): + chat = Chat(id=-42, type="supergroup") + + method = chat.set_photo(photo=BufferedInputFile(b"PNG", filename="photo.png")) + assert method.chat_id == chat.id + @mark.parametrize( "first,last,title,chat_type,result", [ diff --git a/tests/test_api/test_types/test_sticker.py b/tests/test_api/test_types/test_sticker.py new file mode 100644 index 0000000000..6adce4eaeb --- /dev/null +++ b/tests/test_api/test_types/test_sticker.py @@ -0,0 +1,32 @@ +from aiogram.enums import StickerType +from aiogram.types import Sticker + + +class TestSticker: + def test_get_profile_photos(self): + sticker = Sticker( + file_id="test", + file_unique_id="test", + type=StickerType.REGULAR, + width=100, + height=100, + is_animated=False, + is_video=False, + ) + + method = sticker.set_position_in_set(position=1) + assert method.sticker == sticker.file_id + + def test_delete_from_set(self): + sticker = Sticker( + file_id="test", + file_unique_id="test", + type=StickerType.REGULAR, + width=100, + height=100, + is_animated=False, + is_video=False, + ) + + method = sticker.delete_from_set() + assert method.sticker == sticker.file_id diff --git a/tests/test_api/test_types/test_user.py b/tests/test_api/test_types/test_user.py index c57c0704c2..9f28175bbc 100644 --- a/tests/test_api/test_types/test_user.py +++ b/tests/test_api/test_types/test_user.py @@ -50,3 +50,9 @@ def test_get_mention_html(self, first: str, last: str, name: str): user = User(id=42, is_bot=False, first_name=first, last_name=last) assert user.mention_html() == f'{user.full_name}' assert user.mention_html(name=name) == f'{name}' + + def test_get_profile_photos(self): + user = User(id=42, is_bot=False, first_name="Test", last_name="User") + + method = user.get_profile_photos(description="test") + assert method.user_id == user.id diff --git a/tests/test_utils/test_helper.py b/tests/test_utils/test_helper.py deleted file mode 100644 index 466db4efdd..0000000000 --- a/tests/test_utils/test_helper.py +++ /dev/null @@ -1,181 +0,0 @@ -import pytest - -from aiogram.utils.helper import Default, Helper, HelperMode, Item, ListItem, OrderedHelper - - -class TestHelper: - def test_items_all(self): - class MyHelper(Helper): - A = Item() - B = Item() - C = Item() - D = Item() - - assert set(MyHelper.all()) == {"A", "B", "C", "D"} - - def test_listed_items_all(self): - class MyHelper(Helper): - A = ListItem() - B = ListItem() - C = ListItem() - D = ListItem() - - assert set(MyHelper.all()) == {"A", "B", "C", "D"} - - def test_listed_items_combinations(self): - class MyHelper(Helper): - A = ListItem() - B = ListItem() - C = ListItem() - D = ListItem() - - assert (MyHelper.A | MyHelper.B) == ["A", "B"] - assert (MyHelper.C & MyHelper.D) == ["C", "D"] - assert MyHelper.A.add(MyHelper.D) == ["A", "D"] - assert MyHelper.B + MyHelper.D == ["B", "D"] - - def test_wrong_name(self): - with pytest.raises(RuntimeError): - - class MyHelper(Helper): - kaboom = Item() - - def test_not_a_helper_subclass(self): - with pytest.raises(RuntimeError): - - class NotAHelperSubclass: - A = Item() - - -class TestHelperMode: - def test_helper_mode_all(self): - assert set(HelperMode.all()) == { - "SCREAMING_SNAKE_CASE", - "lowerCamelCase", - "CamelCase", - "snake_case", - "lowercase", - } - - def test_screaming_snake_case(self): - class MyHelper(Helper): - mode = HelperMode.SCREAMING_SNAKE_CASE - - FOO = Item() - BAR_BAZ = Item() - - assert MyHelper.FOO == "FOO" - assert MyHelper.BAR_BAZ == "BAR_BAZ" - - def test_lower_camel_case(self): - class MyHelper(Helper): - mode = HelperMode.lowerCamelCase - - FOO = Item() - BAR_BAZ = Item() - - assert MyHelper.FOO == "foo" - assert MyHelper.BAR_BAZ == "barBaz" - - def test_camel_case(self): - class MyHelper(Helper): - mode = HelperMode.CamelCase - - FOO = Item() - BAR_BAZ = Item() - - assert MyHelper.FOO == "Foo" - assert MyHelper.BAR_BAZ == "BarBaz" - - def test_snake_case(self): - class MyHelper(Helper): - mode = HelperMode.snake_case - - FOO = Item() - BAR_BAZ = Item() - - assert MyHelper.FOO == "foo" - assert MyHelper.BAR_BAZ == "bar_baz" - - def test_lowercase(self): - class MyHelper(Helper): - mode = HelperMode.lowercase - - FOO = Item() - BAR_BAZ = Item() - - assert MyHelper.FOO == "foo" - assert MyHelper.BAR_BAZ == "barbaz" - - def test_extended_converters(self): - assert HelperMode.apply("test_text", mode=HelperMode.SCREAMING_SNAKE_CASE) == "TEST_TEXT" - assert HelperMode.apply("TestText", mode=HelperMode.SCREAMING_SNAKE_CASE) == "TEST_TEXT" - assert HelperMode.apply("test_text", mode=HelperMode.snake_case) == "test_text" - assert HelperMode.apply("foo", mode=lambda m: m.upper()) == "FOO" - - -class TestOrderedHelper: - def test_items_are_ordered(self): - class MyOrderedHelper(OrderedHelper): - A = Item() - D = Item() - C = Item() - B = Item() - - assert MyOrderedHelper.all() == ["A", "D", "C", "B"] - - def test_list_items_are_ordered(self): - class MyOrderedHelper(OrderedHelper): - A = ListItem() - D = ListItem() - C = ListItem() - B = ListItem() - - assert MyOrderedHelper.all() == ["A", "D", "C", "B"] - - -class TestDefaultDescriptor: - def test_descriptor_fs(self): - obj = type("ClassA", (), {})() - default_x_val = "some_x" - x = Default(default_x_val) - - # we can omit owner, usually it's just obj.__class__ - assert x.__get__(instance=obj, owner=None) == default_x_val - assert x.__get__(instance=obj, owner=obj.__class__) == default_x_val - - new_x_val = "new_x" - assert x.__set__(instance=obj, value=new_x_val) is None - - with pytest.raises(AttributeError) as exc: - x.__set__(instance=obj.__class__, value="will never be set") - assert "Instance cannot be class or None" in str(exc.value) - - assert x.__get__(instance=obj, owner=obj.__class__) == new_x_val - - with pytest.raises(AttributeError) as exc: - x.__delete__(instance=obj.__class__) - assert "Instance cannot be class or None" in str(exc.value) - - x.__delete__(instance=obj) - assert x.__get__(instance=obj, owner=obj.__class__) == default_x_val - - def test_init(self): - class A: - x = Default(fget=lambda a_inst: "nothing") - - assert isinstance(A.__dict__["x"], Default) - - a = A() - assert a.x == "nothing" - - x = Default("x") - assert x.__get__(None, None) == "x" - assert x.fget(None) == x.__get__(None, None) - - def test_nullability(self): - class A: - x = Default(default=None, fget=None) - - assert A.x is None - assert A().x is None