diff --git a/README.rst b/README.rst index b4668d30..af494848 100644 --- a/README.rst +++ b/README.rst @@ -56,7 +56,7 @@ Features - Telegram Bot API integration code was `autogenerated `_ and can be easily re-generated when API gets updated - Updates router (Blueprints) - Has Finite State Machine -- Uses powerful `magic filters ` +- Uses powerful `magic filters `_ - Middlewares (incoming updates and API calls) - Provides `Replies into Webhook `_ - Integrated I18n/L10n support with GNU Gettext (or Fluent) diff --git a/docs/dispatcher/dispatcher.rst b/docs/dispatcher/dispatcher.rst index d7403a66..502422c0 100644 --- a/docs/dispatcher/dispatcher.rst +++ b/docs/dispatcher/dispatcher.rst @@ -6,8 +6,8 @@ Dispatcher is root :obj:`Router` and in code Dispatcher can be used directly for Here is only listed base information about Dispatcher. All about writing handlers, filters and etc. you can found in next pages: -- `Router `__ -- `Observer `__ +- :ref:`Router ` +- :ref:`Filtering events` .. autoclass:: aiogram.dispatcher.dispatcher.Dispatcher diff --git a/docs/dispatcher/filters/callback_data.rst b/docs/dispatcher/filters/callback_data.rst index 61d7a40a..a16848fe 100644 --- a/docs/dispatcher/filters/callback_data.rst +++ b/docs/dispatcher/filters/callback_data.rst @@ -1,4 +1,4 @@ -.. _callback-data-factory +.. _Callback data factory: ============================== Callback Data Factory & Filter diff --git a/docs/dispatcher/filters/chat_member_updated.rst b/docs/dispatcher/filters/chat_member_updated.rst index 6b2fff00..356fba1d 100644 --- a/docs/dispatcher/filters/chat_member_updated.rst +++ b/docs/dispatcher/filters/chat_member_updated.rst @@ -2,6 +2,27 @@ ChatMemberUpdated ================= +Usage +===== + +Handle user leave or join events + +.. code-block:: python + + from aiogram.filters import IS_MEMBER, IS_NOT_MEMBER + + @router.chat_member(ChatMemberUpdatedFilter(IS_MEMBER >> IS_NOT_MEMBER)) + async def on_user_leave(event: ChatMemberUpdated): ... + + @router.chat_member(ChatMemberUpdatedFilter(IS_NOT_MEMBER >> IS_MEMBER)) + async def on_user_join(event: ChatMemberUpdated): ... + +Or construct your own terms via using pre-defined set of statuses and transitions. + + +Explanation +=========== + .. autoclass:: aiogram.filters.chat_member_updated.ChatMemberUpdatedFilter :members: :member-order: bysource @@ -77,22 +98,6 @@ will produce swap of old and new statuses. Note that if you define the status unions (via :code:`|`) you will need to add brackets for the statement before use shift operator in due to operator priorities. -Usage -===== - -Handle user leave or join events - -.. code-block:: python - - from aiogram.filters import IS_MEMBER, IS_NOT_MEMBER - - @router.chat_member(ChatMemberUpdatedFilter(IS_MEMBER >> IS_NOT_MEMBER)) - async def on_user_leave(event: ChatMemberUpdated): ... - - @router.chat_member(ChatMemberUpdatedFilter(IS_NOT_MEMBER >> IS_MEMBER)) - async def on_user_join(event: ChatMemberUpdated): ... - -Or construct your own terms via using pre-defined set of statuses and transitions. Allowed handlers ================ diff --git a/docs/dispatcher/filters/command.rst b/docs/dispatcher/filters/command.rst index e926c081..00fe83c3 100644 --- a/docs/dispatcher/filters/command.rst +++ b/docs/dispatcher/filters/command.rst @@ -2,19 +2,6 @@ Command ======= -.. autoclass:: aiogram.filters.command.Command - :members: __init__ - :member-order: bysource - :undoc-members: False - -When filter is passed the :class:`aiogram.filters.command.CommandObject` will be passed to the handler argument :code:`command` - -.. autoclass:: aiogram.filters.command.CommandObject - :members: - :member-order: bysource - :undoc-members: False - - Usage ===== @@ -28,6 +15,19 @@ Usage Command cannot include spaces or any whitespace + +.. autoclass:: aiogram.filters.command.Command + :members: __init__ + :member-order: bysource + :undoc-members: False + +When filter is passed the :class:`aiogram.filters.command.CommandObject` will be passed to the handler argument :code:`command` + +.. autoclass:: aiogram.filters.command.CommandObject + :members: + :member-order: bysource + :undoc-members: False + Allowed handlers ================ diff --git a/docs/dispatcher/filters/index.rst b/docs/dispatcher/filters/index.rst index 9ac14213..33442ec8 100644 --- a/docs/dispatcher/filters/index.rst +++ b/docs/dispatcher/filters/index.rst @@ -1,3 +1,5 @@ +.. _Filtering events: + ================ Filtering events ================ diff --git a/docs/dispatcher/filters/magic_data.rst b/docs/dispatcher/filters/magic_data.rst index 55255e5c..68637e06 100644 --- a/docs/dispatcher/filters/magic_data.rst +++ b/docs/dispatcher/filters/magic_data.rst @@ -2,6 +2,14 @@ MagicData ========= +Usage +===== + +#. :code:`MagicData(F.event.from_user.id == F.config.admin_id)` (Note that :code:`config` should be passed from middleware) + +Explanation +=========== + .. autoclass:: aiogram.filters.magic_data.MagicData :members: :member-order: bysource @@ -11,11 +19,6 @@ Can be imported: - :code:`from aiogram.filters import MagicData` -Usage -===== - -#. :code:`MagicData(F.event.from_user.id == F.config.admin_id)` (Note that :code:`config` should be passed from middleware) - Allowed handlers ================ diff --git a/docs/dispatcher/finite_state_machine/index.rst b/docs/dispatcher/finite_state_machine/index.rst index 353d5f75..afa62bff 100644 --- a/docs/dispatcher/finite_state_machine/index.rst +++ b/docs/dispatcher/finite_state_machine/index.rst @@ -1,3 +1,5 @@ +.. _Finite State Machine: + ==================== Finite State Machine ==================== diff --git a/docs/dispatcher/index.rst b/docs/dispatcher/index.rst index 614721ef..daf7e1e5 100644 --- a/docs/dispatcher/index.rst +++ b/docs/dispatcher/index.rst @@ -26,12 +26,12 @@ So, you can use both of them with *aiogram*. router dispatcher - class_based_handlers/index + dependency_injection filters/index - middlewares - finite_state_machine/index - flags - errors long_polling webhook - dependency_injection + finite_state_machine/index + middlewares + errors + flags + class_based_handlers/index diff --git a/docs/dispatcher/router.rst b/docs/dispatcher/router.rst index 13555ec9..44eb748e 100644 --- a/docs/dispatcher/router.rst +++ b/docs/dispatcher/router.rst @@ -1,7 +1,23 @@ +.. _Router: + ###### Router ###### +Usage: + +.. code-block:: python + + from aiogram import Router + from aiogram.types import Message + + my_router = Router(name=__name__) + + @my_router.message() + async def message_handler(message: Message) -> Any: + await message.answer('Hello from my router!') + + .. autoclass:: aiogram.dispatcher.router.Router :members: __init__, include_router, include_routers, resolve_used_update_types :show-inheritance: diff --git a/docs/install.rst b/docs/install.rst index 7a3b8218..71a71705 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -24,7 +24,7 @@ From PyPI .. code-block:: bash - pip install -U --pre aiogram + pip install -U aiogram From GitHub ----------- diff --git a/docs/locale/en/LC_MESSAGES/api/methods/unpin_all_general_forum_topic_messages.po b/docs/locale/en/LC_MESSAGES/api/methods/unpin_all_general_forum_topic_messages.po new file mode 100644 index 00000000..b4154aa5 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/methods/unpin_all_general_forum_topic_messages.po @@ -0,0 +1,94 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-08-26 23:17+0300\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.12.1\n" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:3 +msgid "unpinAllGeneralForumTopicMessages" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages:1 +#: of +msgid "" +"Use this method to clear the list of pinned messages in a General 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.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages:3 +#: of +msgid "" +"Source: " +"https://core.telegram.org/bots/api#unpinallgeneralforumtopicmessages" +msgstr "" + +#: ../../docstring +#: aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages.chat_id:1 +#: of +msgid "" +"Unique identifier for the target chat or username of the target " +"supergroup (in the format :code:`@supergroupusername`)" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:15 +msgid "Usage" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:18 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:26 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:28 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:30 +msgid "" +":code:`from aiogram.methods.unpin_all_general_forum_topic_messages import" +" UnpinAllGeneralForumTopicMessages`" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:31 +msgid "" +"alias: :code:`from aiogram.methods import " +"UnpinAllGeneralForumTopicMessages`" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:34 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:41 +msgid "As reply into Webhook in handler" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:49 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages`" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/chat.po b/docs/locale/en/LC_MESSAGES/api/types/chat.po index 05363683..9628f5ea 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/chat.po +++ b/docs/locale/en/LC_MESSAGES/api/types/chat.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-03-11 01:52+0200\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.11.0\n" +"Generated-By: Babel 2.12.1\n" #: ../../api/types/chat.rst:3 msgid "Chat" @@ -88,6 +88,13 @@ msgid "" ":class:`aiogram.methods.get_chat.GetChat`." msgstr "" +#: ../../docstring aiogram.types.chat.Chat.emoji_status_expiration_date:1 of +msgid "" +"*Optional*. Expiration date of the emoji status of the other party in a " +"private chat, if any. Returned only in " +":class:`aiogram.methods.get_chat.GetChat`." +msgstr "" + #: ../../docstring aiogram.types.chat.Chat.bio:1 of msgid "" "*Optional*. Bio of the other party in a private chat. Returned only in " @@ -264,6 +271,7 @@ msgstr "" #: 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_general_forum_topic_messages:4 #: aiogram.types.chat.Chat.unpin_all_messages:4 #: aiogram.types.chat.Chat.unpin_message:4 of msgid ":code:`chat_id`" @@ -320,6 +328,7 @@ msgstr "" #: 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_general_forum_topic_messages #: aiogram.types.chat.Chat.unpin_all_messages #: aiogram.types.chat.Chat.unpin_message of msgid "Returns" @@ -1269,6 +1278,33 @@ msgstr "" msgid "instance of method :class:`aiogram.methods.set_chat_photo.SetChatPhoto`" msgstr "" +#: aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages:6 of +msgid "" +"Use this method to clear the list of pinned messages in a General 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.types.chat.Chat.unpin_all_general_forum_topic_messages:8 of +msgid "" +"Source: " +"https://core.telegram.org/bots/api#unpinallgeneralforumtopicmessages" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages`" +msgstr "" + #~ msgid "" #~ "Use this method to get information " #~ "about a member of a chat. The " diff --git a/docs/locale/en/LC_MESSAGES/api/types/message.po b/docs/locale/en/LC_MESSAGES/api/types/message.po index e04a77e4..8c20ee62 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: 2023-08-06 16:52+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -173,6 +173,10 @@ msgstr "" msgid "*Optional*. Message is a sticker, information about the sticker" msgstr "" +#: ../../docstring aiogram.types.message.Message.story:1 of +msgid "*Optional*. Message is a forwarded story" +msgstr "" + #: ../../docstring aiogram.types.message.Message.video:1 of msgid "*Optional*. Message is a video, information about the video" msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/poll_answer.po b/docs/locale/en/LC_MESSAGES/api/types/poll_answer.po index 627b292c..63fb9b5d 100644 --- a/docs/locale/en/LC_MESSAGES/api/types/poll_answer.po +++ b/docs/locale/en/LC_MESSAGES/api/types/poll_answer.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.12.1\n" #: ../../api/types/poll_answer.rst:3 msgid "PollAnswer" @@ -33,12 +33,29 @@ msgstr "" msgid "Unique poll identifier" msgstr "" -#: ../../docstring aiogram.types.poll_answer.PollAnswer.user:1 of -msgid "The user, who changed the answer to the poll" -msgstr "" - #: ../../docstring aiogram.types.poll_answer.PollAnswer.option_ids:1 of msgid "" -"0-based identifiers of answer options, chosen by the user. May be empty " -"if the user retracted their vote." +"0-based identifiers of chosen answer options. May be empty if the vote " +"was retracted." msgstr "" + +#: ../../docstring aiogram.types.poll_answer.PollAnswer.voter_chat:1 of +msgid "" +"*Optional*. The chat that changed the answer to the poll, if the voter is" +" anonymous" +msgstr "" + +#: ../../docstring aiogram.types.poll_answer.PollAnswer.user:1 of +msgid "" +"*Optional*. The user that changed the answer to the poll, if the voter " +"isn't anonymous" +msgstr "" + +#~ msgid "The user, who changed the answer to the poll" +#~ msgstr "" + +#~ msgid "" +#~ "0-based identifiers of answer options, " +#~ "chosen by the user. May be empty" +#~ " if the user retracted their vote." +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/api/types/story.po b/docs/locale/en/LC_MESSAGES/api/types/story.po new file mode 100644 index 00000000..92bf0e3a --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/api/types/story.po @@ -0,0 +1,32 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-08-26 23:17+0300\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.12.1\n" + +#: ../../api/types/story.rst:3 +msgid "Story" +msgstr "" + +#: aiogram.types.story.Story:1 of +msgid "" +"This object represents a message about a forwarded story in the chat. " +"Currently holds no information." +msgstr "" + +#: aiogram.types.story.Story:3 of +msgid "Source: https://core.telegram.org/bots/api#story" +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/changelog.po b/docs/locale/en/LC_MESSAGES/changelog.po index 92abec62..ff98abc8 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: 2023-08-06 16:52+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -22,26 +22,149 @@ msgid "Changelog" msgstr "" #: ../../[towncrier-fragments]:2 -msgid "\\ |release| [UNRELEASED DRAFT] (2023-08-06)" +msgid "\\ |release| [UNRELEASED DRAFT] (2023-08-26)" msgstr "" -#: ../../../CHANGES.rst:24 ../../../CHANGES.rst:66 ../../../CHANGES.rst:229 -#: ../../../CHANGES.rst:329 ../../../CHANGES.rst:389 ../../../CHANGES.rst:440 -#: ../../../CHANGES.rst:513 ../../../CHANGES.rst:554 ../../../CHANGES.rst:592 -#: ../../../CHANGES.rst:640 ../../../CHANGES.rst:716 ../../../CHANGES.rst:749 -#: ../../../CHANGES.rst:780 ../../[towncrier-fragments]:5 -msgid "Features" +#: ../../../CHANGES.rst:23 ../../../CHANGES.rst:92 ../../../CHANGES.rst:137 +#: ../../../CHANGES.rst:207 ../../../CHANGES.rst:393 ../../../CHANGES.rst:456 +#: ../../../CHANGES.rst:505 ../../../CHANGES.rst:566 ../../../CHANGES.rst:624 +#: ../../../CHANGES.rst:670 ../../../CHANGES.rst:718 ../../../CHANGES.rst:774 +#: ../../../CHANGES.rst:859 ../../../CHANGES.rst:891 +#: ../../[towncrier-fragments]:5 +msgid "Bugfixes" msgstr "" #: ../../[towncrier-fragments]:7 +msgid "" +"Fixed magic :code:`.as_(...)` operation for values that can be " +"interpreted as `False` (e.g. `0`). `#1281 " +"`_" +msgstr "" + +#: ../../[towncrier-fragments]:9 +msgid "" +"Italic markdown from utils now uses correct decorators `#1282 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:20 +msgid "3.0.0rc2 (2023-08-18)" +msgstr "" + +#: ../../../CHANGES.rst:25 +msgid "" +"Fixed missing message content types (:code:`ContentType.USER_SHARED`, " +":code:`ContentType.CHAT_SHARED`) `#1252 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:27 +msgid "" +"Fixed nested hashtag, cashtag and email message entities not being parsed" +" correctly when these entities are inside another entity. `#1259 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:29 +msgid "" +"Moved global filters check placement into router to add chance to pass " +"context from global filters into handlers in the same way as it possible " +"in other places `#1266 `_" +msgstr "" + +#: ../../../CHANGES.rst:35 ../../../CHANGES.rst:105 ../../../CHANGES.rst:150 +#: ../../../CHANGES.rst:235 ../../../CHANGES.rst:468 ../../../CHANGES.rst:518 +#: ../../../CHANGES.rst:898 +msgid "Improved Documentation" +msgstr "" + +#: ../../../CHANGES.rst:37 +msgid "" +"Added error handling example `examples/error_handling.py` `#1099 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:39 +msgid "" +"Added a few words about skipping pending updates `#1251 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:41 +msgid "" +"Added a section on Dependency Injection technology `#1253 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:43 +msgid "" +"This update includes the addition of a multi-file bot example to the " +"repository. `#1254 `_" +msgstr "" + +#: ../../../CHANGES.rst:45 +msgid "" +"Refactored examples code to use aiogram enumerations and enhanced chat " +"messages with markdown beautification's for a more user-friendly display." +" `#1256 `_" +msgstr "" + +#: ../../../CHANGES.rst:48 +msgid "" +"Supplemented \"Finite State Machine\" section in Migration FAQ `#1264 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:50 +msgid "" +"Removed extra param in docstring of TelegramEventObserver's filter method" +" and fixed typo in I18n documentation. `#1268 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:56 ../../../CHANGES.rst:112 ../../../CHANGES.rst:251 +#: ../../../CHANGES.rst:402 ../../../CHANGES.rst:479 ../../../CHANGES.rst:532 +#: ../../../CHANGES.rst:583 ../../../CHANGES.rst:637 ../../../CHANGES.rst:679 +#: ../../../CHANGES.rst:725 ../../../CHANGES.rst:785 ../../../CHANGES.rst:806 +#: ../../../CHANGES.rst:829 ../../../CHANGES.rst:866 ../../../CHANGES.rst:905 +msgid "Misc" +msgstr "" + +#: ../../../CHANGES.rst:58 +msgid "" +"Enhanced the warning message in dispatcher to include a JSON dump of the " +"update when update type is not known. `#1269 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:60 +msgid "" +"Added support for `Bot API 6.8 `_ `#1275 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:65 +msgid "3.0.0rc1 (2023-08-06)" +msgstr "" + +#: ../../../CHANGES.rst:68 ../../../CHANGES.rst:126 ../../../CHANGES.rst:168 +#: ../../../CHANGES.rst:331 ../../../CHANGES.rst:431 ../../../CHANGES.rst:491 +#: ../../../CHANGES.rst:542 ../../../CHANGES.rst:615 ../../../CHANGES.rst:656 +#: ../../../CHANGES.rst:694 ../../../CHANGES.rst:742 ../../../CHANGES.rst:818 +#: ../../../CHANGES.rst:851 ../../../CHANGES.rst:882 +msgid "Features" +msgstr "" + +#: ../../../CHANGES.rst:70 msgid "Added Currency enum. You can use it like this:" msgstr "" -#: ../../[towncrier-fragments]:19 +#: ../../../CHANGES.rst:82 msgid "`#1194 `_" msgstr "" -#: ../../[towncrier-fragments]:20 +#: ../../../CHANGES.rst:83 msgid "" "Updated keyboard builders with new methods for integrating buttons and " "keyboard creation more seamlessly. Added functionality to create buttons " @@ -50,49 +173,45 @@ msgid "" "`#1236 `_" msgstr "" -#: ../../../CHANGES.rst:35 ../../../CHANGES.rst:105 ../../../CHANGES.rst:291 -#: ../../../CHANGES.rst:354 ../../../CHANGES.rst:403 ../../../CHANGES.rst:464 -#: ../../../CHANGES.rst:522 ../../../CHANGES.rst:568 ../../../CHANGES.rst:616 -#: ../../../CHANGES.rst:672 ../../../CHANGES.rst:757 ../../../CHANGES.rst:789 -#: ../../[towncrier-fragments]:27 -msgid "Bugfixes" +#: ../../../CHANGES.rst:87 +msgid "" +"Added support for message_thread_id in ChatActionSender `#1249 " +"`_" msgstr "" -#: ../../[towncrier-fragments]:29 +#: ../../../CHANGES.rst:94 msgid "" "Fixed polling startup when \"bot\" key is passed manually into dispatcher" " workflow data `#1242 `_" msgstr "" -#: ../../[towncrier-fragments]:31 +#: ../../../CHANGES.rst:96 msgid "Added codegen configuration for lost shortcuts:" msgstr "" -#: ../../[towncrier-fragments]:33 +#: ../../../CHANGES.rst:98 msgid "ShippingQuery.answer" msgstr "" -#: ../../[towncrier-fragments]:34 +#: ../../../CHANGES.rst:99 msgid "PreCheckoutQuery.answer" msgstr "" -#: ../../[towncrier-fragments]:35 +#: ../../../CHANGES.rst:100 msgid "Message.delete_reply_markup" msgstr "" -#: ../../[towncrier-fragments]:36 +#: ../../../CHANGES.rst:101 msgid "`#1244 `_" msgstr "" -#: ../../../CHANGES.rst:149 ../../../CHANGES.rst:300 ../../../CHANGES.rst:377 -#: ../../../CHANGES.rst:430 ../../../CHANGES.rst:481 ../../../CHANGES.rst:535 -#: ../../../CHANGES.rst:577 ../../../CHANGES.rst:623 ../../../CHANGES.rst:683 -#: ../../../CHANGES.rst:704 ../../../CHANGES.rst:727 ../../../CHANGES.rst:764 -#: ../../../CHANGES.rst:803 ../../[towncrier-fragments]:40 -msgid "Misc" +#: ../../../CHANGES.rst:107 +msgid "" +"Added documentation for webhook and polling modes. `#1241 " +"`_" msgstr "" -#: ../../[towncrier-fragments]:42 +#: ../../../CHANGES.rst:114 msgid "" "Reworked InputFile reading, removed :code:`__aiter__` method, added `bot:" " Bot` argument to the :code:`.read(...)` method, so, from now " @@ -100,18 +219,18 @@ msgid "" "`_" msgstr "" -#: ../../[towncrier-fragments]:46 +#: ../../../CHANGES.rst:118 msgid "" "Code-generated :code:`__init__` typehints in types and methods to make " "IDE happy without additional pydantic plugin `#1245 " "`_" msgstr "" -#: ../../../CHANGES.rst:21 +#: ../../../CHANGES.rst:123 msgid "3.0.0b9 (2023-07-30)" msgstr "" -#: ../../../CHANGES.rst:26 +#: ../../../CHANGES.rst:128 msgid "" "Added new shortcuts for " ":class:`aiogram.types.chat_member_updated.ChatMemberUpdated` to send " @@ -119,7 +238,7 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:29 +#: ../../../CHANGES.rst:131 msgid "" "Added new shortcuts for " ":class:`aiogram.types.chat_join_request.ChatJoinRequest` to make easier " @@ -127,13 +246,13 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:37 +#: ../../../CHANGES.rst:139 msgid "" "Fixed bot assignment in the :code:`Message.send_copy` shortcut `#1232 " "`_" msgstr "" -#: ../../../CHANGES.rst:39 +#: ../../../CHANGES.rst:141 msgid "" "Added model validation to remove UNSET before field validation. This " "change was necessary to correctly handle parse_mode where 'UNSET' is used" @@ -143,26 +262,21 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:44 +#: ../../../CHANGES.rst:146 msgid "Updated pydantic to 2.1 with few bugfixes" msgstr "" -#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:133 ../../../CHANGES.rst:366 -#: ../../../CHANGES.rst:416 ../../../CHANGES.rst:796 -msgid "Improved Documentation" -msgstr "" - -#: ../../../CHANGES.rst:50 +#: ../../../CHANGES.rst:152 msgid "" "Improved docs, added basic migration guide (will be expanded later) " "`#1143 `_" msgstr "" -#: ../../../CHANGES.rst:55 ../../../CHANGES.rst:140 ../../../CHANGES.rst:423 +#: ../../../CHANGES.rst:157 ../../../CHANGES.rst:242 ../../../CHANGES.rst:525 msgid "Deprecations and Removals" msgstr "" -#: ../../../CHANGES.rst:57 +#: ../../../CHANGES.rst:159 msgid "" "Removed the use of the context instance (Bot.get_current) from all " "placements that were used previously. This is to avoid the use of the " @@ -170,78 +284,78 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:63 +#: ../../../CHANGES.rst:165 msgid "3.0.0b8 (2023-07-17)" msgstr "" -#: ../../../CHANGES.rst:68 +#: ../../../CHANGES.rst:170 msgid "" "Added possibility to use custom events in routers (If router does not " "support custom event it does not break and passes it to included " "routers). `#1147 `_" msgstr "" -#: ../../../CHANGES.rst:70 +#: ../../../CHANGES.rst:172 msgid "Added support for FSM in Forum topics." msgstr "" -#: ../../../CHANGES.rst:72 +#: ../../../CHANGES.rst:174 msgid "The strategy can be changed in dispatcher:" msgstr "" -#: ../../../CHANGES.rst:85 +#: ../../../CHANGES.rst:187 msgid "" "If you have implemented you own storages you should extend record key " "generation with new one attribute - :code:`thread_id`" msgstr "" -#: ../../../CHANGES.rst:87 +#: ../../../CHANGES.rst:189 msgid "`#1161 `_" msgstr "" -#: ../../../CHANGES.rst:88 +#: ../../../CHANGES.rst:190 msgid "Improved CallbackData serialization." msgstr "" -#: ../../../CHANGES.rst:90 +#: ../../../CHANGES.rst:192 msgid "Minimized UUID (hex without dashes)" msgstr "" -#: ../../../CHANGES.rst:91 +#: ../../../CHANGES.rst:193 msgid "Replaced bool values with int (true=1, false=0)" msgstr "" -#: ../../../CHANGES.rst:92 +#: ../../../CHANGES.rst:194 msgid "`#1163 `_" msgstr "" -#: ../../../CHANGES.rst:93 +#: ../../../CHANGES.rst:195 msgid "" "Added a tool to make text formatting flexible and easy. More details on " "the :ref:`corresponding documentation page ` `#1172 " "`_" msgstr "" -#: ../../../CHANGES.rst:96 +#: ../../../CHANGES.rst:198 msgid "" "Added :code:`X-Telegram-Bot-Api-Secret-Token` header check `#1173 " "`_" msgstr "" -#: ../../../CHANGES.rst:98 +#: ../../../CHANGES.rst:200 msgid "" "Made :code:`allowed_updates` list to revolve automatically in " "start_polling method if not set explicitly. `#1178 " "`_" msgstr "" -#: ../../../CHANGES.rst:100 +#: ../../../CHANGES.rst:202 msgid "" "Added possibility to pass custom headers to :class:`URLInputFile` object " "`#1191 `_" msgstr "" -#: ../../../CHANGES.rst:107 +#: ../../../CHANGES.rst:209 msgid "" "Change type of result in InlineQueryResult enum for " ":code:`InlineQueryResultCachedMpeg4Gif` and " @@ -249,51 +363,51 @@ msgid "" "documentation." msgstr "" -#: ../../../CHANGES.rst:110 +#: ../../../CHANGES.rst:212 msgid "" "Change regexp for entities parsing to more correct " "(:code:`InlineQueryResultType.yml`). `#1146 " "`_" msgstr "" -#: ../../../CHANGES.rst:112 +#: ../../../CHANGES.rst:214 msgid "" "Fixed signature of startup/shutdown events to include the " ":code:`**dispatcher.workflow_data` as the handler arguments. `#1155 " "`_" msgstr "" -#: ../../../CHANGES.rst:114 +#: ../../../CHANGES.rst:216 msgid "" "Added missing :code:`FORUM_TOPIC_EDITED` value to content_type property " "`#1160 `_" msgstr "" -#: ../../../CHANGES.rst:116 +#: ../../../CHANGES.rst:218 msgid "" "Fixed compatibility with Python 3.8-3.9 (from previous release) `#1162 " "`_" msgstr "" -#: ../../../CHANGES.rst:118 +#: ../../../CHANGES.rst:220 msgid "" "Fixed the markdown spoiler parser. `#1176 " "`_" msgstr "" -#: ../../../CHANGES.rst:120 +#: ../../../CHANGES.rst:222 msgid "" "Fixed workflow data propagation `#1196 " "`_" msgstr "" -#: ../../../CHANGES.rst:122 +#: ../../../CHANGES.rst:224 msgid "" "Fixed the serialization error associated with nested subtypes like " "InputMedia, ChatMember, etc." msgstr "" -#: ../../../CHANGES.rst:125 +#: ../../../CHANGES.rst:227 msgid "" "The previously generated code resulted in an invalid schema under " "pydantic v2, which has stricter type parsing. Hence, subtypes without the" @@ -302,71 +416,71 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:135 +#: ../../../CHANGES.rst:237 msgid "" "Changed small grammar typos for :code:`upload_file` `#1133 " "`_" msgstr "" -#: ../../../CHANGES.rst:142 +#: ../../../CHANGES.rst:244 msgid "" "Removed text filter in due to is planned to remove this filter few " "versions ago." msgstr "" -#: ../../../CHANGES.rst:144 +#: ../../../CHANGES.rst:246 msgid "" "Use :code:`F.text` instead `#1170 " "`_" msgstr "" -#: ../../../CHANGES.rst:151 +#: ../../../CHANGES.rst:253 msgid "" "Added full support of `Bot API 6.6 `_" msgstr "" -#: ../../../CHANGES.rst:155 +#: ../../../CHANGES.rst:257 msgid "" "Note that this issue has breaking changes described in in the Bot API " "changelog, this changes is not breaking in the API but breaking inside " "aiogram because Beta stage is not finished." msgstr "" -#: ../../../CHANGES.rst:158 +#: ../../../CHANGES.rst:260 msgid "`#1139 `_" msgstr "" -#: ../../../CHANGES.rst:159 +#: ../../../CHANGES.rst:261 msgid "" "Added full support of `Bot API 6.7 `_" msgstr "" -#: ../../../CHANGES.rst:163 +#: ../../../CHANGES.rst:265 msgid "" "Note that arguments *switch_pm_parameter* and *switch_pm_text* was " "deprecated and should be changed to *button* argument as described in API" " docs." msgstr "" -#: ../../../CHANGES.rst:165 +#: ../../../CHANGES.rst:267 msgid "`#1168 `_" msgstr "" -#: ../../../CHANGES.rst:166 +#: ../../../CHANGES.rst:268 msgid "Updated `Pydantic to V2 `_" msgstr "" -#: ../../../CHANGES.rst:170 +#: ../../../CHANGES.rst:272 msgid "Be careful, not all libraries is already updated to using V2" msgstr "" -#: ../../../CHANGES.rst:171 +#: ../../../CHANGES.rst:273 msgid "`#1202 `_" msgstr "" -#: ../../../CHANGES.rst:172 +#: ../../../CHANGES.rst:274 msgid "" "Added global defaults :code:`disable_web_page_preview` and " ":code:`protect_content` in addition to :code:`parse_mode` to the Bot " @@ -374,13 +488,13 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:175 +#: ../../../CHANGES.rst:277 msgid "" "Removed bot parameters from storages `#1144 " "`_" msgstr "" -#: ../../../CHANGES.rst:178 +#: ../../../CHANGES.rst:280 msgid "" "Replaced ContextVar's with a new feature called `Validation Context " "`_" @@ -388,69 +502,69 @@ msgid "" "handling the Bot instance within method shortcuts." msgstr "" -#: ../../../CHANGES.rst:183 +#: ../../../CHANGES.rst:285 msgid "**Breaking**: The 'bot' argument now is required in `URLInputFile`" msgstr "" -#: ../../../CHANGES.rst:184 +#: ../../../CHANGES.rst:286 msgid "`#1210 `_" msgstr "" -#: ../../../CHANGES.rst:185 +#: ../../../CHANGES.rst:287 msgid "Updated magic-filter with new features" msgstr "" -#: ../../../CHANGES.rst:187 +#: ../../../CHANGES.rst:289 msgid "Added hint for :code:`len(F)` error" msgstr "" -#: ../../../CHANGES.rst:188 +#: ../../../CHANGES.rst:290 msgid "Added not in operation" msgstr "" -#: ../../../CHANGES.rst:189 +#: ../../../CHANGES.rst:291 msgid "`#1221 `_" msgstr "" -#: ../../../CHANGES.rst:193 +#: ../../../CHANGES.rst:295 msgid "3.0.0b7 (2023-02-18)" msgstr "" -#: ../../../CHANGES.rst:197 +#: ../../../CHANGES.rst:299 msgid "" "Note that this version has incompatibility with Python 3.8-3.9 in case " "when you create an instance of Dispatcher outside of the any coroutine." msgstr "" -#: ../../../CHANGES.rst:199 +#: ../../../CHANGES.rst:301 msgid "Sorry for the inconvenience, it will be fixed in the next version." msgstr "" -#: ../../../CHANGES.rst:201 +#: ../../../CHANGES.rst:303 msgid "This code will not work:" msgstr "" -#: ../../../CHANGES.rst:213 +#: ../../../CHANGES.rst:315 msgid "But if you change it like this it should works as well:" msgstr "" -#: ../../../CHANGES.rst:231 +#: ../../../CHANGES.rst:333 msgid "Added missing shortcuts, new enums, reworked old stuff" msgstr "" -#: ../../../CHANGES.rst:233 +#: ../../../CHANGES.rst:335 msgid "" "**Breaking** All previously added enums is re-generated in new place - " "`aiogram.enums` instead of `aiogram.types`" msgstr "" -#: ../../../CHANGES.rst:251 +#: ../../../CHANGES.rst:353 msgid "" "**Added enums:** " ":class:`aiogram.enums.bot_command_scope_type.BotCommandScopeType`," msgstr "" -#: ../../../CHANGES.rst:237 +#: ../../../CHANGES.rst:339 msgid "" ":class:`aiogram.enums.chat_action.ChatAction`, " ":class:`aiogram.enums.chat_member_status.ChatMemberStatus`, " @@ -469,15 +583,15 @@ msgid "" ":class:`aiogram.enums.update_type.UpdateType`," msgstr "" -#: ../../../CHANGES.rst:253 +#: ../../../CHANGES.rst:355 msgid "**Added shortcuts**:" msgstr "" -#: ../../../CHANGES.rst:278 +#: ../../../CHANGES.rst:380 msgid "*Chat* :meth:`aiogram.types.chat.Chat.get_administrators`," msgstr "" -#: ../../../CHANGES.rst:256 +#: ../../../CHANGES.rst:358 msgid "" ":meth:`aiogram.types.chat.Chat.delete_message`, " ":meth:`aiogram.types.chat.Chat.revoke_invite_link`, " @@ -505,85 +619,85 @@ msgid "" ":meth:`aiogram.types.chat.Chat.set_photo`," msgstr "" -#: ../../../CHANGES.rst:280 +#: ../../../CHANGES.rst:382 msgid "*Sticker*: :meth:`aiogram.types.sticker.Sticker.set_position_in_set`," msgstr "" -#: ../../../CHANGES.rst:281 +#: ../../../CHANGES.rst:383 msgid ":meth:`aiogram.types.sticker.Sticker.delete_from_set`," msgstr "" -#: ../../../CHANGES.rst:282 +#: ../../../CHANGES.rst:384 msgid "*User*: :meth:`aiogram.types.user.User.get_profile_photos`" msgstr "" -#: ../../../CHANGES.rst:283 +#: ../../../CHANGES.rst:385 msgid "`#952 `_" msgstr "" -#: ../../../CHANGES.rst:284 +#: ../../../CHANGES.rst:386 msgid "" "Added :ref:`callback answer ` feature `#1091 " "`_" msgstr "" -#: ../../../CHANGES.rst:286 +#: ../../../CHANGES.rst:388 msgid "" "Added a method that allows you to compactly register routers `#1117 " "`_" msgstr "" -#: ../../../CHANGES.rst:293 +#: ../../../CHANGES.rst:395 msgid "" "Check status code when downloading file `#816 " "`_" msgstr "" -#: ../../../CHANGES.rst:295 +#: ../../../CHANGES.rst:397 msgid "" "Fixed `ignore_case` parameter in :obj:`aiogram.filters.command.Command` " "filter `#1106 `_" msgstr "" -#: ../../../CHANGES.rst:302 +#: ../../../CHANGES.rst:404 msgid "" "Added integration with new code-generator named `Butcher " "`_ `#1069 " "`_" msgstr "" -#: ../../../CHANGES.rst:304 +#: ../../../CHANGES.rst:406 msgid "" "Added full support of `Bot API 6.4 `_ `#1088 " "`_" msgstr "" -#: ../../../CHANGES.rst:306 +#: ../../../CHANGES.rst:408 msgid "" "Updated package metadata, moved build internals from Poetry to Hatch, " "added contributing guides. `#1095 " "`_" msgstr "" -#: ../../../CHANGES.rst:308 +#: ../../../CHANGES.rst:410 msgid "" "Added full support of `Bot API 6.5 `_" msgstr "" -#: ../../../CHANGES.rst:312 +#: ../../../CHANGES.rst:414 msgid "" "Note that :obj:`aiogram.types.chat_permissions.ChatPermissions` is " "updated without backward compatibility, so now this object has no " ":code:`can_send_media_messages` attribute" msgstr "" -#: ../../../CHANGES.rst:314 +#: ../../../CHANGES.rst:416 msgid "`#1112 `_" msgstr "" -#: ../../../CHANGES.rst:315 +#: ../../../CHANGES.rst:417 msgid "" "Replaced error :code:`TypeError: TelegramEventObserver.__call__() got an " "unexpected keyword argument ''` with a more understandable one for " @@ -591,13 +705,13 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:318 +#: ../../../CHANGES.rst:420 msgid "" "Added possibility to reply into webhook with files `#1120 " "`_" msgstr "" -#: ../../../CHANGES.rst:320 +#: ../../../CHANGES.rst:422 msgid "" "Reworked graceful shutdown. Added method to stop polling. Now polling " "started from dispatcher can be stopped by signals gracefully without " @@ -605,127 +719,127 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:326 +#: ../../../CHANGES.rst:428 msgid "3.0.0b6 (2022-11-18)" msgstr "" -#: ../../../CHANGES.rst:331 +#: ../../../CHANGES.rst:433 msgid "" "(again) Added possibility to combine filters with an *and*/*or* " "operations." msgstr "" -#: ../../../CHANGES.rst:333 +#: ../../../CHANGES.rst:435 msgid "" "Read more in \":ref:`Combining filters `\" " "documentation section `#1018 " "`_" msgstr "" -#: ../../../CHANGES.rst:335 +#: ../../../CHANGES.rst:437 msgid "Added following methods to ``Message`` class:" msgstr "" -#: ../../../CHANGES.rst:337 +#: ../../../CHANGES.rst:439 msgid ":code:`Message.forward(...)`" msgstr "" -#: ../../../CHANGES.rst:338 +#: ../../../CHANGES.rst:440 msgid ":code:`Message.edit_media(...)`" msgstr "" -#: ../../../CHANGES.rst:339 +#: ../../../CHANGES.rst:441 msgid ":code:`Message.edit_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:340 +#: ../../../CHANGES.rst:442 msgid ":code:`Message.stop_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:341 +#: ../../../CHANGES.rst:443 msgid ":code:`Message.pin(...)`" msgstr "" -#: ../../../CHANGES.rst:342 +#: ../../../CHANGES.rst:444 msgid ":code:`Message.unpin()`" msgstr "" -#: ../../../CHANGES.rst:343 +#: ../../../CHANGES.rst:445 msgid "`#1030 `_" msgstr "" -#: ../../../CHANGES.rst:344 +#: ../../../CHANGES.rst:446 msgid "Added following methods to :code:`User` class:" msgstr "" -#: ../../../CHANGES.rst:346 +#: ../../../CHANGES.rst:448 msgid ":code:`User.mention_markdown(...)`" msgstr "" -#: ../../../CHANGES.rst:347 +#: ../../../CHANGES.rst:449 msgid ":code:`User.mention_html(...)`" msgstr "" -#: ../../../CHANGES.rst:348 +#: ../../../CHANGES.rst:450 msgid "`#1049 `_" msgstr "" -#: ../../../CHANGES.rst:349 +#: ../../../CHANGES.rst:451 msgid "" "Added full support of `Bot API 6.3 `_ `#1057 " "`_" msgstr "" -#: ../../../CHANGES.rst:356 +#: ../../../CHANGES.rst:458 msgid "" "Fixed :code:`Message.send_invoice` and :code:`Message.reply_invoice`, " "added missing arguments `#1047 " "`_" msgstr "" -#: ../../../CHANGES.rst:358 +#: ../../../CHANGES.rst:460 msgid "Fixed copy and forward in:" msgstr "" -#: ../../../CHANGES.rst:360 +#: ../../../CHANGES.rst:462 msgid ":code:`Message.answer(...)`" msgstr "" -#: ../../../CHANGES.rst:361 +#: ../../../CHANGES.rst:463 msgid ":code:`Message.copy_to(...)`" msgstr "" -#: ../../../CHANGES.rst:362 +#: ../../../CHANGES.rst:464 msgid "`#1064 `_" msgstr "" -#: ../../../CHANGES.rst:368 +#: ../../../CHANGES.rst:470 msgid "" "Fixed UA translations in index.po `#1017 " "`_" msgstr "" -#: ../../../CHANGES.rst:370 +#: ../../../CHANGES.rst:472 msgid "" "Fix typehints for :code:`Message`, :code:`reply_media_group` and " ":code:`answer_media_group` methods `#1029 " "`_" msgstr "" -#: ../../../CHANGES.rst:372 +#: ../../../CHANGES.rst:474 msgid "" "Removed an old now non-working feature `#1060 " "`_" msgstr "" -#: ../../../CHANGES.rst:379 +#: ../../../CHANGES.rst:481 msgid "" "Enabled testing on Python 3.11 `#1044 " "`_" msgstr "" -#: ../../../CHANGES.rst:381 +#: ../../../CHANGES.rst:483 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" @@ -734,23 +848,23 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:386 +#: ../../../CHANGES.rst:488 msgid "3.0.0b5 (2022-10-02)" msgstr "" -#: ../../../CHANGES.rst:391 +#: ../../../CHANGES.rst:493 msgid "" "Add PyPy support and run tests under PyPy `#985 " "`_" msgstr "" -#: ../../../CHANGES.rst:393 +#: ../../../CHANGES.rst:495 msgid "" "Added message text to aiogram exceptions representation `#988 " "`_" msgstr "" -#: ../../../CHANGES.rst:395 +#: ../../../CHANGES.rst:497 msgid "" "Added warning about using magic filter from `magic_filter` instead of " "`aiogram`'s ones. Is recommended to use `from aiogram import F` instead " @@ -758,61 +872,61 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:398 +#: ../../../CHANGES.rst:500 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:405 +#: ../../../CHANGES.rst:507 msgid "" "Reworked error event, introduced " ":class:`aiogram.types.error_event.ErrorEvent` object. `#898 " "`_" msgstr "" -#: ../../../CHANGES.rst:407 +#: ../../../CHANGES.rst:509 msgid "" "Fixed escaping markdown in `aiogram.utils.markdown` module `#903 " "`_" msgstr "" -#: ../../../CHANGES.rst:409 +#: ../../../CHANGES.rst:511 msgid "" "Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. " "`#995 `_" msgstr "" -#: ../../../CHANGES.rst:411 +#: ../../../CHANGES.rst:513 msgid "" "Fixed empty mention in command parsing, now it will be None instead of an" " empty string `#1013 `_" msgstr "" -#: ../../../CHANGES.rst:418 +#: ../../../CHANGES.rst:520 msgid "" "Initialized Docs translation (added Ukrainian language) `#925 " "`_" msgstr "" -#: ../../../CHANGES.rst:425 +#: ../../../CHANGES.rst:527 msgid "" "Removed filters factory as described in corresponding issue. `#942 " "`_" msgstr "" -#: ../../../CHANGES.rst:432 +#: ../../../CHANGES.rst:534 msgid "" "Now Router/Dispatcher accepts only keyword arguments. `#982 " "`_" msgstr "" -#: ../../../CHANGES.rst:437 +#: ../../../CHANGES.rst:539 msgid "3.0.0b4 (2022-08-14)" msgstr "" -#: ../../../CHANGES.rst:442 +#: ../../../CHANGES.rst:544 msgid "" "Add class helper ChatAction for constants that Telegram BotAPI uses in " "sendChatAction request. In my opinion, this will help users and will also" @@ -820,198 +934,198 @@ msgid "" "\"ChatActions\". `#803 `_" msgstr "" -#: ../../../CHANGES.rst:446 +#: ../../../CHANGES.rst:548 msgid "Added possibility to combine filters or invert result" msgstr "" -#: ../../../CHANGES.rst:448 +#: ../../../CHANGES.rst:550 msgid "Example:" msgstr "" -#: ../../../CHANGES.rst:456 +#: ../../../CHANGES.rst:558 msgid "`#894 `_" msgstr "" -#: ../../../CHANGES.rst:457 +#: ../../../CHANGES.rst:559 msgid "" "Fixed type hints for redis TTL params. `#922 " "`_" msgstr "" -#: ../../../CHANGES.rst:459 +#: ../../../CHANGES.rst:561 msgid "" "Added `full_name` shortcut for `Chat` object `#929 " "`_" msgstr "" -#: ../../../CHANGES.rst:466 +#: ../../../CHANGES.rst:568 msgid "" "Fixed false-positive coercing of Union types in API methods `#901 " "`_" msgstr "" -#: ../../../CHANGES.rst:468 +#: ../../../CHANGES.rst:570 msgid "Added 3 missing content types:" msgstr "" -#: ../../../CHANGES.rst:470 +#: ../../../CHANGES.rst:572 msgid "proximity_alert_triggered" msgstr "" -#: ../../../CHANGES.rst:471 +#: ../../../CHANGES.rst:573 msgid "supergroup_chat_created" msgstr "" -#: ../../../CHANGES.rst:472 +#: ../../../CHANGES.rst:574 msgid "channel_chat_created" msgstr "" -#: ../../../CHANGES.rst:473 +#: ../../../CHANGES.rst:575 msgid "`#906 `_" msgstr "" -#: ../../../CHANGES.rst:474 +#: ../../../CHANGES.rst:576 msgid "" "Fixed the ability to compare the state, now comparison to copy of the " "state will return `True`. `#927 " "`_" msgstr "" -#: ../../../CHANGES.rst:476 +#: ../../../CHANGES.rst:578 msgid "" "Fixed default lock kwargs in RedisEventIsolation. `#972 " "`_" msgstr "" -#: ../../../CHANGES.rst:483 +#: ../../../CHANGES.rst:585 msgid "" "Restrict including routers with strings `#896 " "`_" msgstr "" -#: ../../../CHANGES.rst:485 +#: ../../../CHANGES.rst:587 msgid "" "Changed CommandPatterType to CommandPatternType in " "`aiogram/dispatcher/filters/command.py` `#907 " "`_" msgstr "" -#: ../../../CHANGES.rst:487 +#: ../../../CHANGES.rst:589 msgid "" "Added full support of `Bot API 6.1 `_ `#936 " "`_" msgstr "" -#: ../../../CHANGES.rst:489 +#: ../../../CHANGES.rst:591 msgid "**Breaking!** More flat project structure" msgstr "" -#: ../../../CHANGES.rst:491 +#: ../../../CHANGES.rst:593 msgid "These packages was moved, imports in your code should be fixed:" msgstr "" -#: ../../../CHANGES.rst:493 +#: ../../../CHANGES.rst:595 msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`" msgstr "" -#: ../../../CHANGES.rst:494 +#: ../../../CHANGES.rst:596 msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`" msgstr "" -#: ../../../CHANGES.rst:495 +#: ../../../CHANGES.rst:597 msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`" msgstr "" -#: ../../../CHANGES.rst:496 +#: ../../../CHANGES.rst:598 msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`" msgstr "" -#: ../../../CHANGES.rst:497 +#: ../../../CHANGES.rst:599 msgid "" ":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` " "(single module instead of package)" msgstr "" -#: ../../../CHANGES.rst:498 +#: ../../../CHANGES.rst:600 msgid "`#938 `_" msgstr "" -#: ../../../CHANGES.rst:499 +#: ../../../CHANGES.rst:601 msgid "" "Removed deprecated :code:`router._handler` and " ":code:`router.register__handler` methods. `#941 " "`_" msgstr "" -#: ../../../CHANGES.rst:501 +#: ../../../CHANGES.rst:603 msgid "" "Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942" " `_" msgstr "" -#: ../../../CHANGES.rst:503 +#: ../../../CHANGES.rst:605 msgid "" "`MessageEntity` method `get_text` was removed and `extract` was renamed " "to `extract_from` `#944 `_" msgstr "" -#: ../../../CHANGES.rst:505 +#: ../../../CHANGES.rst:607 msgid "" "Added full support of `Bot API 6.2 `_ `#975 " "`_" msgstr "" -#: ../../../CHANGES.rst:510 +#: ../../../CHANGES.rst:612 msgid "3.0.0b3 (2022-04-19)" msgstr "" -#: ../../../CHANGES.rst:515 +#: ../../../CHANGES.rst:617 msgid "" "Added possibility to get command magic result as handler argument `#889 " "`_" msgstr "" -#: ../../../CHANGES.rst:517 +#: ../../../CHANGES.rst:619 msgid "" "Added full support of `Telegram Bot API 6.0 " "`_ `#890 " "`_" msgstr "" -#: ../../../CHANGES.rst:524 +#: ../../../CHANGES.rst:626 msgid "" "Fixed I18n lazy-proxy. Disabled caching. `#839 " "`_" msgstr "" -#: ../../../CHANGES.rst:526 +#: ../../../CHANGES.rst:628 msgid "" "Added parsing of spoiler message entity `#865 " "`_" msgstr "" -#: ../../../CHANGES.rst:528 +#: ../../../CHANGES.rst:630 msgid "" "Fixed default `parse_mode` for `Message.copy_to()` method. `#876 " "`_" msgstr "" -#: ../../../CHANGES.rst:530 +#: ../../../CHANGES.rst:632 msgid "" "Fixed CallbackData factory parsing IntEnum's `#885 " "`_" msgstr "" -#: ../../../CHANGES.rst:537 +#: ../../../CHANGES.rst:639 msgid "" "Added automated check that pull-request adds a changes description to " "**CHANGES** directory `#873 " "`_" msgstr "" -#: ../../../CHANGES.rst:539 +#: ../../../CHANGES.rst:641 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" @@ -1019,14 +1133,14 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:542 +#: ../../../CHANGES.rst:644 msgid "" "Used `redis-py` instead of `aioredis` package in due to this packages was" " merged into single one `#882 " "`_" msgstr "" -#: ../../../CHANGES.rst:544 +#: ../../../CHANGES.rst:646 msgid "" "Solved common naming problem with middlewares that confusing too much " "developers - now you can't see the `middleware` and `middlewares` " @@ -1035,113 +1149,113 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:551 +#: ../../../CHANGES.rst:653 msgid "3.0.0b2 (2022-02-19)" msgstr "" -#: ../../../CHANGES.rst:556 +#: ../../../CHANGES.rst:658 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:559 +#: ../../../CHANGES.rst:661 msgid "" "Added possibility to add handler flags via decorator (like `pytest.mark` " "decorator but `aiogram.flags`) `#836 " "`_" msgstr "" -#: ../../../CHANGES.rst:561 +#: ../../../CHANGES.rst:663 msgid "" "Added :code:`ChatActionSender` utility to automatically sends chat action" " while long process is running." msgstr "" -#: ../../../CHANGES.rst:563 +#: ../../../CHANGES.rst:665 msgid "" "It also can be used as message middleware and can be customized via " ":code:`chat_action` flag. `#837 " "`_" msgstr "" -#: ../../../CHANGES.rst:570 +#: ../../../CHANGES.rst:672 msgid "" "Fixed unexpected behavior of sequences in the StateFilter. `#791 " "`_" msgstr "" -#: ../../../CHANGES.rst:572 +#: ../../../CHANGES.rst:674 msgid "" "Fixed exceptions filters `#827 " "`_" msgstr "" -#: ../../../CHANGES.rst:579 +#: ../../../CHANGES.rst:681 msgid "" "Logger name for processing events is changed to :code:`aiogram.events`. " "`#830 `_" msgstr "" -#: ../../../CHANGES.rst:581 +#: ../../../CHANGES.rst:683 msgid "" "Added full support of Telegram Bot API 5.6 and 5.7 `#835 " "`_" msgstr "" -#: ../../../CHANGES.rst:583 +#: ../../../CHANGES.rst:685 msgid "" "**BREAKING** Events isolation mechanism is moved from FSM storages to " "standalone managers `#838 " "`_" msgstr "" -#: ../../../CHANGES.rst:589 +#: ../../../CHANGES.rst:691 msgid "3.0.0b1 (2021-12-12)" msgstr "" -#: ../../../CHANGES.rst:594 +#: ../../../CHANGES.rst:696 msgid "Added new custom operation for MagicFilter named :code:`as_`" msgstr "" -#: ../../../CHANGES.rst:596 +#: ../../../CHANGES.rst:698 msgid "Now you can use it to get magic filter result as handler argument" msgstr "" -#: ../../../CHANGES.rst:612 +#: ../../../CHANGES.rst:714 msgid "`#759 `_" msgstr "" -#: ../../../CHANGES.rst:618 +#: ../../../CHANGES.rst:720 msgid "" "Fixed: Missing :code:`ChatMemberHandler` import in " ":code:`aiogram/dispatcher/handler` `#751 " "`_" msgstr "" -#: ../../../CHANGES.rst:625 +#: ../../../CHANGES.rst:727 msgid "" "Check :code:`destiny` in case of no :code:`with_destiny` enabled in " "RedisStorage key builder `#776 " "`_" msgstr "" -#: ../../../CHANGES.rst:627 +#: ../../../CHANGES.rst:729 msgid "" "Added full support of `Bot API 5.5 `_ `#777 " "`_" msgstr "" -#: ../../../CHANGES.rst:629 +#: ../../../CHANGES.rst:731 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:631 +#: ../../../CHANGES.rst:733 msgid "" "Make TelegramAPIServer files wrapper in local mode bi-directional " "(server-client, client-server) Now you can convert local path to server " @@ -1149,11 +1263,11 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:637 +#: ../../../CHANGES.rst:739 msgid "3.0.0a18 (2021-11-10)" msgstr "" -#: ../../../CHANGES.rst:642 +#: ../../../CHANGES.rst:744 msgid "" "Breaking: Changed the signature of the session middlewares Breaking: " "Renamed AiohttpSession.make_request method parameter from call to method " @@ -1161,258 +1275,258 @@ msgid "" "outgoing requests `#716 `_" msgstr "" -#: ../../../CHANGES.rst:646 +#: ../../../CHANGES.rst:748 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:656 +#: ../../../CHANGES.rst:758 msgid "`#717 `_" msgstr "" -#: ../../../CHANGES.rst:657 +#: ../../../CHANGES.rst:759 msgid "" "**Breaking internal API change** Reworked FSM Storage record keys " "propagation `#723 `_" msgstr "" -#: ../../../CHANGES.rst:660 +#: ../../../CHANGES.rst:762 msgid "" "Implemented new filter named :code:`MagicData(magic_data)` that helps to " "filter event by data from middlewares or other filters" msgstr "" -#: ../../../CHANGES.rst:662 +#: ../../../CHANGES.rst:764 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:668 +#: ../../../CHANGES.rst:770 msgid "`#724 `_" msgstr "" -#: ../../../CHANGES.rst:674 +#: ../../../CHANGES.rst:776 msgid "" "Fixed I18n context inside error handlers `#726 " "`_" msgstr "" -#: ../../../CHANGES.rst:676 +#: ../../../CHANGES.rst:778 msgid "" "Fixed bot session closing before emit shutdown `#734 " "`_" msgstr "" -#: ../../../CHANGES.rst:678 +#: ../../../CHANGES.rst:780 msgid "" "Fixed: bound filter resolving does not require children routers `#736 " "`_" msgstr "" -#: ../../../CHANGES.rst:685 +#: ../../../CHANGES.rst:787 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:688 +#: ../../../CHANGES.rst:790 msgid "" "Converted README.md to README.rst and use it as base file for docs `#725 " "`_" msgstr "" -#: ../../../CHANGES.rst:690 +#: ../../../CHANGES.rst:792 msgid "Rework filters resolving:" msgstr "" -#: ../../../CHANGES.rst:692 +#: ../../../CHANGES.rst:794 msgid "Automatically apply Bound Filters with default values to handlers" msgstr "" -#: ../../../CHANGES.rst:693 +#: ../../../CHANGES.rst:795 msgid "Fix data transfer from parent to included routers filters" msgstr "" -#: ../../../CHANGES.rst:694 +#: ../../../CHANGES.rst:796 msgid "`#727 `_" msgstr "" -#: ../../../CHANGES.rst:695 +#: ../../../CHANGES.rst:797 msgid "" "Added full support of Bot API 5.4 https://core.telegram.org/bots/api-" "changelog#november-5-2021 `#744 " "`_" msgstr "" -#: ../../../CHANGES.rst:701 +#: ../../../CHANGES.rst:803 msgid "3.0.0a17 (2021-09-24)" msgstr "" -#: ../../../CHANGES.rst:706 +#: ../../../CHANGES.rst:808 msgid "" "Added :code:`html_text` and :code:`md_text` to Message object `#708 " "`_" msgstr "" -#: ../../../CHANGES.rst:708 +#: ../../../CHANGES.rst:810 msgid "" "Refactored I18n, added context managers for I18n engine and current " "locale `#709 `_" msgstr "" -#: ../../../CHANGES.rst:713 +#: ../../../CHANGES.rst:815 msgid "3.0.0a16 (2021-09-22)" msgstr "" -#: ../../../CHANGES.rst:718 +#: ../../../CHANGES.rst:820 msgid "Added support of local Bot API server files downloading" msgstr "" -#: ../../../CHANGES.rst:720 +#: ../../../CHANGES.rst:822 msgid "" "When Local API is enabled files can be downloaded via " "`bot.download`/`bot.download_file` methods. `#698 " "`_" msgstr "" -#: ../../../CHANGES.rst:722 +#: ../../../CHANGES.rst:824 msgid "" "Implemented I18n & L10n support `#701 " "`_" msgstr "" -#: ../../../CHANGES.rst:729 +#: ../../../CHANGES.rst:831 msgid "" "Covered by tests and docs KeyboardBuilder util `#699 " "`_" msgstr "" -#: ../../../CHANGES.rst:731 +#: ../../../CHANGES.rst:833 msgid "**Breaking!!!**. Refactored and renamed exceptions." msgstr "" -#: ../../../CHANGES.rst:733 +#: ../../../CHANGES.rst:835 msgid "" "Exceptions module was moved from :code:`aiogram.utils.exceptions` to " ":code:`aiogram.exceptions`" msgstr "" -#: ../../../CHANGES.rst:734 +#: ../../../CHANGES.rst:836 msgid "Added prefix `Telegram` for all error classes" msgstr "" -#: ../../../CHANGES.rst:735 +#: ../../../CHANGES.rst:837 msgid "`#700 `_" msgstr "" -#: ../../../CHANGES.rst:736 +#: ../../../CHANGES.rst:838 msgid "" "Replaced all :code:`pragma: no cover` marks via global " ":code:`.coveragerc` config `#702 " "`_" msgstr "" -#: ../../../CHANGES.rst:738 +#: ../../../CHANGES.rst:840 msgid "Updated dependencies." msgstr "" -#: ../../../CHANGES.rst:740 +#: ../../../CHANGES.rst:842 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:746 +#: ../../../CHANGES.rst:848 msgid "3.0.0a15 (2021-09-10)" msgstr "" -#: ../../../CHANGES.rst:751 +#: ../../../CHANGES.rst:853 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:759 +#: ../../../CHANGES.rst:861 msgid "" "Fixed incorrect type checking in the " ":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 " "`_" msgstr "" -#: ../../../CHANGES.rst:766 +#: ../../../CHANGES.rst:868 msgid "" "Disable ContentType filter by default `#668 " "`_" msgstr "" -#: ../../../CHANGES.rst:768 +#: ../../../CHANGES.rst:870 msgid "" "Moved update type detection from Dispatcher to Update object `#669 " "`_" msgstr "" -#: ../../../CHANGES.rst:770 +#: ../../../CHANGES.rst:872 msgid "" "Updated **pre-commit** config `#681 " "`_" msgstr "" -#: ../../../CHANGES.rst:772 +#: ../../../CHANGES.rst:874 msgid "" "Reworked **handlers_in_use** util. Function moved to Router as method " "**.resolve_used_update_types()** `#682 " "`_" msgstr "" -#: ../../../CHANGES.rst:777 +#: ../../../CHANGES.rst:879 msgid "3.0.0a14 (2021-08-17)" msgstr "" -#: ../../../CHANGES.rst:782 +#: ../../../CHANGES.rst:884 msgid "" "add aliases for edit/delete reply markup to Message `#662 " "`_" msgstr "" -#: ../../../CHANGES.rst:784 +#: ../../../CHANGES.rst:886 msgid "" "Reworked outer middleware chain. Prevent to call many times the outer " "middleware for each nested router `#664 " "`_" msgstr "" -#: ../../../CHANGES.rst:791 +#: ../../../CHANGES.rst:893 msgid "" "Prepare parse mode for InputMessageContent in AnswerInlineQuery method " "`#660 `_" msgstr "" -#: ../../../CHANGES.rst:798 +#: ../../../CHANGES.rst:900 msgid "" "Added integration with :code:`towncrier` `#602 " "`_" msgstr "" -#: ../../../CHANGES.rst:805 +#: ../../../CHANGES.rst:907 msgid "" "Added `.editorconfig` `#650 " "`_" msgstr "" -#: ../../../CHANGES.rst:807 +#: ../../../CHANGES.rst:909 msgid "" "Redis storage speedup globals `#651 " "`_" msgstr "" -#: ../../../CHANGES.rst:809 +#: ../../../CHANGES.rst:911 msgid "" "add allow_sending_without_reply param to Message reply aliases `#663 " "`_" @@ -3040,3 +3154,6 @@ msgstr "" #~ msgid "\\ |release| [UNRELEASED DRAFT] (2023-07-30)" #~ msgstr "" + +#~ msgid "\\ |release| [UNRELEASED DRAFT] (2023-08-06)" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/contributing.po b/docs/locale/en/LC_MESSAGES/contributing.po index 40354edd..7cf1b5d8 100644 --- a/docs/locale/en/LC_MESSAGES/contributing.po +++ b/docs/locale/en/LC_MESSAGES/contributing.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -78,112 +78,112 @@ msgstr "" msgid "Activate the environment" msgstr "" -#: ../../contributing.rst:38 -msgid "Linux/ macOS:" +#: ../../contributing.rst:38 ../../contributing.rst:77 +msgid "Linux / macOS:" msgstr "" #: ../../contributing.rst:44 -msgid "Windows PoweShell" +msgid "Windows cmd" msgstr "" #: ../../contributing.rst:50 -msgid "" -"To check it worked, use described command, it should show the :code:`pip`" -" location inside the isolated environment" -msgstr "" - -#: ../../contributing.rst:53 -msgid "Linux, macOS:" -msgstr "" - -#: ../../contributing.rst:59 msgid "Windows PowerShell" msgstr "" -#: ../../contributing.rst:65 +#: ../../contributing.rst:56 msgid "" -"Also make you shure you have the latest pip version in your virtual " +"To check it worked, use described command, it should show the :code:`pip`" +" version and location inside the isolated environment" +msgstr "" + +#: ../../contributing.rst:64 +msgid "" +"Also make sure you have the latest pip version in your virtual " "environment to avoid errors on next steps:" msgstr "" -#: ../../contributing.rst:74 +#: ../../contributing.rst:73 msgid "Setup project" msgstr "" -#: ../../contributing.rst:76 +#: ../../contributing.rst:75 msgid "" "After activating the environment install `aiogram` from sources and their" -" dependencies:" +" dependencies." msgstr "" -#: ../../contributing.rst:82 +#: ../../contributing.rst:83 +msgid "Windows:" +msgstr "" + +#: ../../contributing.rst:89 msgid "" "It will install :code:`aiogram` in editable mode into your virtual " "environment and all dependencies." msgstr "" -#: ../../contributing.rst:85 +#: ../../contributing.rst:92 msgid "Making changes in code" msgstr "" -#: ../../contributing.rst:87 +#: ../../contributing.rst:94 msgid "" "At this point you can make any changes in the code that you want, it can " "be any fixes, implementing new features or experimenting." msgstr "" -#: ../../contributing.rst:92 +#: ../../contributing.rst:99 msgid "Format the code (code-style)" msgstr "" -#: ../../contributing.rst:94 +#: ../../contributing.rst:101 msgid "" "Note that this project is Black-formatted, so you should follow that " "code-style, too be sure You're correctly doing this let's reformat the " "code automatically:" msgstr "" -#: ../../contributing.rst:104 +#: ../../contributing.rst:111 msgid "Run tests" msgstr "" -#: ../../contributing.rst:106 +#: ../../contributing.rst:113 msgid "All changes should be tested:" msgstr "" -#: ../../contributing.rst:112 +#: ../../contributing.rst:119 msgid "" "Also if you are doing something with Redis-storage, you will need to test" " everything works with Redis:" msgstr "" -#: ../../contributing.rst:119 +#: ../../contributing.rst:126 msgid "Docs" msgstr "" -#: ../../contributing.rst:121 +#: ../../contributing.rst:128 msgid "" "We are using `Sphinx` to render docs in different languages, all sources " "located in `docs` directory, you can change the sources and to test it " "you can start live-preview server and look what you are doing:" msgstr "" -#: ../../contributing.rst:130 +#: ../../contributing.rst:137 msgid "Docs translations" msgstr "" -#: ../../contributing.rst:132 +#: ../../contributing.rst:139 msgid "" "Translation of the documentation is very necessary and cannot be done " "without the help of the community from all over the world, so you are " "welcome to translate the documentation into different languages." msgstr "" -#: ../../contributing.rst:136 +#: ../../contributing.rst:143 msgid "Before start, let's up to date all texts:" msgstr "" -#: ../../contributing.rst:144 +#: ../../contributing.rst:151 msgid "" "Change the :code:`` in example below to the target " "language code, after that you can modify texts inside " @@ -192,120 +192,120 @@ msgid "" "example via `poedit `_." msgstr "" -#: ../../contributing.rst:149 +#: ../../contributing.rst:156 msgid "To view results:" msgstr "" -#: ../../contributing.rst:157 +#: ../../contributing.rst:164 msgid "Describe changes" msgstr "" -#: ../../contributing.rst:159 +#: ../../contributing.rst:166 msgid "" "Describe your changes in one or more sentences so that bot developers " "know what's changed in their favorite framework - create " "`..rst` file and write the description." msgstr "" -#: ../../contributing.rst:162 +#: ../../contributing.rst:169 msgid "" ":code:`` is Issue or Pull-request number, after release link to " "this issue will be published to the *Changelog* page." msgstr "" -#: ../../contributing.rst:165 +#: ../../contributing.rst:172 msgid ":code:`` is a changes category marker, it can be one of:" msgstr "" -#: ../../contributing.rst:167 +#: ../../contributing.rst:174 msgid ":code:`feature` - when you are implementing new feature" msgstr "" -#: ../../contributing.rst:168 +#: ../../contributing.rst:175 msgid ":code:`bugfix` - when you fix a bug" msgstr "" -#: ../../contributing.rst:169 +#: ../../contributing.rst:176 msgid ":code:`doc` - when you improve the docs" msgstr "" -#: ../../contributing.rst:170 +#: ../../contributing.rst:177 msgid ":code:`removal` - when you remove something from the framework" msgstr "" -#: ../../contributing.rst:171 +#: ../../contributing.rst:178 msgid "" ":code:`misc` - when changed something inside the Core or project " "configuration" msgstr "" -#: ../../contributing.rst:173 +#: ../../contributing.rst:180 msgid "" "If you have troubles with changing category feel free to ask Core-" "contributors to help with choosing it." msgstr "" -#: ../../contributing.rst:176 +#: ../../contributing.rst:183 msgid "Complete" msgstr "" -#: ../../contributing.rst:178 +#: ../../contributing.rst:185 msgid "" "After you have made all your changes, publish them to the repository and " "create a pull request as mentioned at the beginning of the article and " "wait for a review of these changes." msgstr "" -#: ../../contributing.rst:183 +#: ../../contributing.rst:190 msgid "Star on GitHub" msgstr "" -#: ../../contributing.rst:185 +#: ../../contributing.rst:192 msgid "" "You can \"star\" repository on GitHub - " "https://github.com/aiogram/aiogram (click the star button at the top " "right)" msgstr "" -#: ../../contributing.rst:187 +#: ../../contributing.rst:194 msgid "" "Adding stars makes it easier for other people to find this project and " "understand how useful it is." msgstr "" -#: ../../contributing.rst:190 +#: ../../contributing.rst:197 msgid "Guides" msgstr "" -#: ../../contributing.rst:192 +#: ../../contributing.rst:199 msgid "" "You can write guides how to develop Bots on top of aiogram and publish it" " into YouTube, Medium, GitHub Books, any Courses platform or any other " "platform that you know." msgstr "" -#: ../../contributing.rst:195 +#: ../../contributing.rst:202 msgid "" "This will help more people learn about the framework and learn how to use" " it" msgstr "" -#: ../../contributing.rst:199 +#: ../../contributing.rst:206 msgid "Take answers" msgstr "" -#: ../../contributing.rst:201 +#: ../../contributing.rst:208 msgid "" "The developers is always asks for any question in our chats or any other " "platforms like GitHub Discussions, StackOverflow and others, feel free to" " answer to this questions." msgstr "" -#: ../../contributing.rst:205 +#: ../../contributing.rst:212 msgid "Funding" msgstr "" -#: ../../contributing.rst:207 +#: ../../contributing.rst:214 msgid "" "The development of the project is free and not financed by commercial " "organizations, it is my personal initiative (`@JRootJunior " @@ -313,7 +313,7 @@ msgid "" "project in my free time." msgstr "" -#: ../../contributing.rst:211 +#: ../../contributing.rst:218 msgid "" "So, if you want to financially support the project, or, for example, give" " me a pizza or a beer, you can do it on `OpenCollective " @@ -328,3 +328,31 @@ msgstr "" #~ "`_ or `Patreon " #~ "`_." #~ msgstr "" + +#~ msgid "Linux/ macOS:" +#~ msgstr "" + +#~ msgid "Windows PoweShell" +#~ msgstr "" + +#~ msgid "" +#~ "To check it worked, use described " +#~ "command, it should show the :code:`pip`" +#~ " location inside the isolated environment" +#~ msgstr "" + +#~ msgid "Linux, macOS:" +#~ msgstr "" + +#~ msgid "" +#~ "Also make you shure you have the" +#~ " latest pip version in your virtual" +#~ " environment to avoid errors on next" +#~ " steps:" +#~ msgstr "" + +#~ msgid "" +#~ "After activating the environment install " +#~ "`aiogram` from sources and their " +#~ "dependencies:" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/dispatcher/dependency_injection.po b/docs/locale/en/LC_MESSAGES/dispatcher/dependency_injection.po new file mode 100644 index 00000000..b3e158d8 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/dispatcher/dependency_injection.po @@ -0,0 +1,96 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-08-26 23:17+0300\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.12.1\n" + +#: ../../dispatcher/dependency_injection.rst:3 +msgid "Dependency injection" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:5 +msgid "" +"Dependency injection is a programming technique that makes a class " +"independent of its dependencies. It achieves that by decoupling the usage" +" of an object from its creation. This helps you to follow `SOLID's " +"`_ dependency inversion and single " +"responsibility principles." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:12 +msgid "How it works in aiogram" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:14 +msgid "" +"For each update :class:`aiogram.dispatcher.dispatcher.Dispatcher` passes " +"handling context data. Filters and middleware can also make changes to " +"the context." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:17 +msgid "" +"To access contextual data you should specify corresponding keyword " +"parameter in handler or filter. For example, to get " +":class:`aiogram.fsm.context.FSMContext` we do it like that:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:30 +msgid "Injecting own dependencies" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:32 +msgid "Aiogram provides several ways to complement / modify contextual data." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:34 +msgid "" +"The first and easiest way is to simply specify the named arguments in " +":class:`aiogram.dispatcher.dispatcher.Dispatcher` initialization, polling" +" start methods or " +":class:`aiogram.webhook.aiohttp_server.SimpleRequestHandler` " +"initialization if you use webhooks." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:46 +msgid "Analogy for webhook:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:55 +msgid "" +":class:`aiogram.dispatcher.dispatcher.Dispatcher`'s workflow data also " +"can be supplemented by setting values as in a dictionary:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:63 +msgid "" +"The middlewares updates the context quite often. You can read more about " +"them on this page:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:66 +msgid ":ref:`Middlewares `" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:68 +msgid "The last way is to return a dictionary from the filter:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:72 +msgid "" +"...or using :ref:`MagicFilter ` with :code:`.as_(...)` " +"method." +msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po b/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po index 51222dc3..e5a8a9f2 100644 --- a/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po +++ b/docs/locale/en/LC_MESSAGES/dispatcher/dispatcher.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -34,11 +34,11 @@ msgid "" msgstr "" #: ../../dispatcher/dispatcher.rst:9 -msgid "`Router `__" +msgid ":ref:`Router `" msgstr "" #: ../../dispatcher/dispatcher.rst:10 -msgid "`Observer `__" +msgid ":ref:`Filtering events`" msgstr "" #: aiogram.dispatcher.dispatcher.Dispatcher:1 @@ -176,3 +176,9 @@ msgstr "" #~ msgid "Poling timeout" #~ msgstr "" + +#~ msgid "`Router `__" +#~ msgstr "" + +#~ msgid "`Observer `__" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/dispatcher/filters/chat_member_updated.po b/docs/locale/en/LC_MESSAGES/dispatcher/filters/chat_member_updated.po index dcf0c9c6..f20ee663 100644 --- a/docs/locale/en/LC_MESSAGES/dispatcher/filters/chat_member_updated.po +++ b/docs/locale/en/LC_MESSAGES/dispatcher/filters/chat_member_updated.po @@ -8,90 +8,108 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.12.1\n" #: ../../dispatcher/filters/chat_member_updated.rst:3 msgid "ChatMemberUpdated" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:10 +#: ../../dispatcher/filters/chat_member_updated.rst:6 +msgid "Usage" +msgstr "" + +#: ../../dispatcher/filters/chat_member_updated.rst:8 +msgid "Handle user leave or join events" +msgstr "" + +#: ../../dispatcher/filters/chat_member_updated.rst:20 +msgid "" +"Or construct your own terms via using pre-defined set of statuses and " +"transitions." +msgstr "" + +#: ../../dispatcher/filters/chat_member_updated.rst:24 +msgid "Explanation" +msgstr "" + +#: ../../dispatcher/filters/chat_member_updated.rst:31 msgid "" "You can import from :code:`aiogram.filters` all available variants of " "`statuses`_, `status groups`_ or `transitions`_:" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:14 +#: ../../dispatcher/filters/chat_member_updated.rst:35 msgid "Statuses" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:17 -#: ../../dispatcher/filters/chat_member_updated.rst:42 -#: ../../dispatcher/filters/chat_member_updated.rst:62 +#: ../../dispatcher/filters/chat_member_updated.rst:38 +#: ../../dispatcher/filters/chat_member_updated.rst:63 +#: ../../dispatcher/filters/chat_member_updated.rst:83 msgid "name" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:17 -#: ../../dispatcher/filters/chat_member_updated.rst:42 -#: ../../dispatcher/filters/chat_member_updated.rst:62 +#: ../../dispatcher/filters/chat_member_updated.rst:38 +#: ../../dispatcher/filters/chat_member_updated.rst:63 +#: ../../dispatcher/filters/chat_member_updated.rst:83 msgid "Description" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:19 +#: ../../dispatcher/filters/chat_member_updated.rst:40 msgid ":code:`CREATOR`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:19 +#: ../../dispatcher/filters/chat_member_updated.rst:40 msgid "Chat owner" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:21 +#: ../../dispatcher/filters/chat_member_updated.rst:42 msgid ":code:`ADMINISTRATOR`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:21 +#: ../../dispatcher/filters/chat_member_updated.rst:42 msgid "Chat administrator" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:23 +#: ../../dispatcher/filters/chat_member_updated.rst:44 msgid ":code:`MEMBER`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:23 +#: ../../dispatcher/filters/chat_member_updated.rst:44 msgid "Member of the chat" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:25 +#: ../../dispatcher/filters/chat_member_updated.rst:46 msgid ":code:`RESTRICTED`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:25 +#: ../../dispatcher/filters/chat_member_updated.rst:46 msgid "Restricted user (can be not member)" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:27 +#: ../../dispatcher/filters/chat_member_updated.rst:48 msgid ":code:`LEFT`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:27 +#: ../../dispatcher/filters/chat_member_updated.rst:48 msgid "Isn't member of the chat" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:29 +#: ../../dispatcher/filters/chat_member_updated.rst:50 msgid ":code:`KICKED`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:29 +#: ../../dispatcher/filters/chat_member_updated.rst:50 msgid "Kicked member by administrators" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:32 +#: ../../dispatcher/filters/chat_member_updated.rst:53 msgid "" "Statuses can be extended with `is_member` flag by prefixing with " ":code:`+` (for :code:`is_member == True)` or :code:`-` (for " @@ -99,47 +117,47 @@ msgid "" ":code:`-RESTRICTED`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:37 +#: ../../dispatcher/filters/chat_member_updated.rst:58 msgid "Status groups" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:39 +#: ../../dispatcher/filters/chat_member_updated.rst:60 msgid "" "The particular statuses can be combined via bitwise :code:`or` operator, " "like :code:`CREATOR | ADMINISTRATOR`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:44 +#: ../../dispatcher/filters/chat_member_updated.rst:65 msgid ":code:`IS_MEMBER`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:44 +#: ../../dispatcher/filters/chat_member_updated.rst:65 msgid "" "Combination of :code:`(CREATOR | ADMINISTRATOR | MEMBER | +RESTRICTED)` " "statuses." msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:46 +#: ../../dispatcher/filters/chat_member_updated.rst:67 msgid ":code:`IS_ADMIN`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:46 +#: ../../dispatcher/filters/chat_member_updated.rst:67 msgid "Combination of :code:`(CREATOR | ADMINISTRATOR)` statuses." msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:48 +#: ../../dispatcher/filters/chat_member_updated.rst:69 msgid ":code:`IS_NOT_MEMBER`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:48 +#: ../../dispatcher/filters/chat_member_updated.rst:69 msgid "Combination of :code:`(LEFT | KICKED | -RESTRICTED)` statuses." msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:52 +#: ../../dispatcher/filters/chat_member_updated.rst:73 msgid "Transitions" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:54 +#: ../../dispatcher/filters/chat_member_updated.rst:75 msgid "" "Transitions can be defined via bitwise shift operators :code:`>>` and " ":code:`<<`. Old chat member status should be defined in the left side for" @@ -148,77 +166,63 @@ msgid "" ":code:`<<`)" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:58 +#: ../../dispatcher/filters/chat_member_updated.rst:79 msgid "" "The direction of transition can be changed via bitwise inversion " "operator: :code:`~JOIN_TRANSITION` will produce swap of old and new " "statuses." msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:64 +#: ../../dispatcher/filters/chat_member_updated.rst:85 msgid ":code:`JOIN_TRANSITION`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:64 +#: ../../dispatcher/filters/chat_member_updated.rst:85 msgid "" "Means status changed from :code:`IS_NOT_MEMBER` to :code:`IS_MEMBER` " "(:code:`IS_NOT_MEMBER >> IS_MEMBER`)" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:67 +#: ../../dispatcher/filters/chat_member_updated.rst:88 msgid ":code:`LEAVE_TRANSITION`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:67 +#: ../../dispatcher/filters/chat_member_updated.rst:88 msgid "" "Means status changed from :code:`IS_MEMBER` to :code:`IS_NOT_MEMBER` " "(:code:`~JOIN_TRANSITION`)" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:70 +#: ../../dispatcher/filters/chat_member_updated.rst:91 msgid ":code:`PROMOTED_TRANSITION`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:70 +#: ../../dispatcher/filters/chat_member_updated.rst:91 msgid "" "Means status changed from :code:`(MEMBER | RESTRICTED | LEFT | KICKED) >>" " ADMINISTRATOR` (:code:`(MEMBER | RESTRICTED | LEFT | KICKED) >> " "ADMINISTRATOR`)" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:77 +#: ../../dispatcher/filters/chat_member_updated.rst:98 msgid "" "Note that if you define the status unions (via :code:`|`) you will need " "to add brackets for the statement before use shift operator in due to " "operator priorities." msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:81 -msgid "Usage" -msgstr "" - -#: ../../dispatcher/filters/chat_member_updated.rst:83 -msgid "Handle user leave or join events" -msgstr "" - -#: ../../dispatcher/filters/chat_member_updated.rst:95 -msgid "" -"Or construct your own terms via using pre-defined set of statuses and " -"transitions." -msgstr "" - -#: ../../dispatcher/filters/chat_member_updated.rst:98 +#: ../../dispatcher/filters/chat_member_updated.rst:103 msgid "Allowed handlers" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:100 +#: ../../dispatcher/filters/chat_member_updated.rst:105 msgid "Allowed update types for this filter:" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:102 +#: ../../dispatcher/filters/chat_member_updated.rst:107 msgid "`my_chat_member`" msgstr "" -#: ../../dispatcher/filters/chat_member_updated.rst:103 +#: ../../dispatcher/filters/chat_member_updated.rst:108 msgid "`chat_member`" msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/dispatcher/filters/magic_data.po b/docs/locale/en/LC_MESSAGES/dispatcher/filters/magic_data.po index 57280bd2..5a39eaf0 100644 --- a/docs/locale/en/LC_MESSAGES/dispatcher/filters/magic_data.po +++ b/docs/locale/en/LC_MESSAGES/dispatcher/filters/magic_data.po @@ -8,106 +8,110 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-25 22:10+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.12.1\n" #: ../../dispatcher/filters/magic_data.rst:3 msgid "MagicData" msgstr "" +#: ../../dispatcher/filters/magic_data.rst:6 +msgid "Usage" +msgstr "" + +#: ../../dispatcher/filters/magic_data.rst:8 +msgid "" +":code:`MagicData(F.event.from_user.id == F.config.admin_id)` (Note that " +":code:`config` should be passed from middleware)" +msgstr "" + +#: ../../dispatcher/filters/magic_data.rst:11 +msgid "Explanation" +msgstr "" + #: aiogram.filters.magic_data.MagicData:1 of msgid "This filter helps to filter event with contextual data" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:10 +#: ../../dispatcher/filters/magic_data.rst:18 msgid "Can be imported:" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:12 +#: ../../dispatcher/filters/magic_data.rst:20 msgid ":code:`from aiogram.filters import MagicData`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:15 -msgid "Usage" -msgstr "" - -#: ../../dispatcher/filters/magic_data.rst:17 -msgid "" -":code:`MagicData(F.event.from_user.id == F.config.admin_id)` (Note that " -":code:`config` should be passed from middleware)" -msgstr "" - -#: ../../dispatcher/filters/magic_data.rst:21 +#: ../../dispatcher/filters/magic_data.rst:24 msgid "Allowed handlers" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:23 +#: ../../dispatcher/filters/magic_data.rst:26 msgid "Allowed update types for this filter:" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:25 +#: ../../dispatcher/filters/magic_data.rst:28 msgid ":code:`message`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:26 +#: ../../dispatcher/filters/magic_data.rst:29 msgid ":code:`edited_message`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:27 +#: ../../dispatcher/filters/magic_data.rst:30 msgid ":code:`channel_post`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:28 +#: ../../dispatcher/filters/magic_data.rst:31 msgid ":code:`edited_channel_post`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:29 +#: ../../dispatcher/filters/magic_data.rst:32 msgid ":code:`inline_query`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:30 +#: ../../dispatcher/filters/magic_data.rst:33 msgid ":code:`chosen_inline_result`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:31 +#: ../../dispatcher/filters/magic_data.rst:34 msgid ":code:`callback_query`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:32 +#: ../../dispatcher/filters/magic_data.rst:35 msgid ":code:`shipping_query`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:33 +#: ../../dispatcher/filters/magic_data.rst:36 msgid ":code:`pre_checkout_query`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:34 +#: ../../dispatcher/filters/magic_data.rst:37 msgid ":code:`poll`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:35 +#: ../../dispatcher/filters/magic_data.rst:38 msgid ":code:`poll_answer`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:36 +#: ../../dispatcher/filters/magic_data.rst:39 msgid ":code:`my_chat_member`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:37 +#: ../../dispatcher/filters/magic_data.rst:40 msgid ":code:`chat_member`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:38 +#: ../../dispatcher/filters/magic_data.rst:41 msgid ":code:`chat_join_request`" msgstr "" -#: ../../dispatcher/filters/magic_data.rst:39 +#: ../../dispatcher/filters/magic_data.rst:42 msgid ":code:`error`" msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/dispatcher/router.po b/docs/locale/en/LC_MESSAGES/dispatcher/router.po index 450b5360..8e88e944 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: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,10 +17,14 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.12.1\n" -#: ../../dispatcher/router.rst:3 +#: ../../dispatcher/router.rst:5 msgid "Router" msgstr "" +#: ../../dispatcher/router.rst:7 +msgid "Usage:" +msgstr "" + #: aiogram.dispatcher.router.Router:1 of msgid "Bases: :py:class:`object`" msgstr "" @@ -86,11 +90,11 @@ msgstr "" msgid "set of registered names" msgstr "" -#: ../../dispatcher/router.rst:13 +#: ../../dispatcher/router.rst:29 msgid "Event observers" msgstr "" -#: ../../dispatcher/router.rst:17 +#: ../../dispatcher/router.rst:33 msgid "" "All handlers always should be asynchronous. The name of the handler " "function is not important. The event argument name is also not important " @@ -98,145 +102,145 @@ msgid "" " to function can not accept two arguments with the same name." msgstr "" -#: ../../dispatcher/router.rst:20 +#: ../../dispatcher/router.rst:36 msgid "" "Here is the list of available observers and examples of how to register " "handlers" msgstr "" -#: ../../dispatcher/router.rst:22 +#: ../../dispatcher/router.rst:38 msgid "" "In these examples only decorator-style registering handlers are used, but" " if you don't like @decorators just use :obj:`.register(...)`" " method instead." msgstr "" -#: ../../dispatcher/router.rst:25 +#: ../../dispatcher/router.rst:41 msgid "Message" msgstr "" -#: ../../dispatcher/router.rst:30 +#: ../../dispatcher/router.rst:46 msgid "Be attentive with filtering this event" msgstr "" -#: ../../dispatcher/router.rst:32 +#: ../../dispatcher/router.rst:48 msgid "" "You should expect that this event can be with different sets of " "attributes in different cases" msgstr "" -#: ../../dispatcher/router.rst:34 +#: ../../dispatcher/router.rst:50 msgid "" "(For example text, sticker and document are always of different content " "types of message)" msgstr "" -#: ../../dispatcher/router.rst:36 +#: ../../dispatcher/router.rst:52 msgid "" "Recommended way to check field availability before usage, for example via" " :ref:`magic filter `: :code:`F.text` to handle text, " ":code:`F.sticker` to handle stickers only and etc." msgstr "" -#: ../../dispatcher/router.rst:47 +#: ../../dispatcher/router.rst:63 msgid "Edited message" msgstr "" -#: ../../dispatcher/router.rst:55 +#: ../../dispatcher/router.rst:71 msgid "Channel post" msgstr "" -#: ../../dispatcher/router.rst:63 +#: ../../dispatcher/router.rst:79 msgid "Edited channel post" msgstr "" -#: ../../dispatcher/router.rst:72 +#: ../../dispatcher/router.rst:88 msgid "Inline query" msgstr "" -#: ../../dispatcher/router.rst:80 +#: ../../dispatcher/router.rst:96 msgid "Chosen inline query" msgstr "" -#: ../../dispatcher/router.rst:88 +#: ../../dispatcher/router.rst:104 msgid "Callback query" msgstr "" -#: ../../dispatcher/router.rst:96 +#: ../../dispatcher/router.rst:112 msgid "Shipping query" msgstr "" -#: ../../dispatcher/router.rst:104 +#: ../../dispatcher/router.rst:120 msgid "Pre checkout query" msgstr "" -#: ../../dispatcher/router.rst:112 +#: ../../dispatcher/router.rst:128 msgid "Poll" msgstr "" -#: ../../dispatcher/router.rst:120 +#: ../../dispatcher/router.rst:136 msgid "Poll answer" msgstr "" -#: ../../dispatcher/router.rst:128 +#: ../../dispatcher/router.rst:144 msgid "Errors" msgstr "" -#: ../../dispatcher/router.rst:135 +#: ../../dispatcher/router.rst:151 msgid "" "Is useful for handling errors from other handlers, error event described " ":ref:`here `" msgstr "" -#: ../../dispatcher/router.rst:142 +#: ../../dispatcher/router.rst:158 msgid "Nested routers" msgstr "" -#: ../../dispatcher/router.rst:147 +#: ../../dispatcher/router.rst:163 msgid "" "Routers by the way can be nested to an another routers with some " "limitations:" msgstr "" -#: ../../dispatcher/router.rst:147 +#: ../../dispatcher/router.rst:163 msgid "" "1. Router **CAN NOT** include itself 1. Routers **CAN NOT** be used for " "circular including (router 1 include router 2, router 2 include router 3," " router 3 include router 1)" msgstr "" -#: ../../dispatcher/router.rst:151 +#: ../../dispatcher/router.rst:167 msgid "Example:" msgstr "" -#: ../../dispatcher/router.rst:153 +#: ../../dispatcher/router.rst:169 msgid "module_1.py" msgstr "" -#: ../../dispatcher/router.rst:163 +#: ../../dispatcher/router.rst:179 msgid "module_2.py" msgstr "" -#: ../../dispatcher/router.rst:175 +#: ../../dispatcher/router.rst:191 msgid "Update" msgstr "" -#: ../../dispatcher/router.rst:184 +#: ../../dispatcher/router.rst:200 msgid "The only root Router (Dispatcher) can handle this type of event." msgstr "" -#: ../../dispatcher/router.rst:188 +#: ../../dispatcher/router.rst:204 msgid "" "Dispatcher already has default handler for this event type, so you can " "use it for handling all updates that are not handled by any other " "handlers." msgstr "" -#: ../../dispatcher/router.rst:191 +#: ../../dispatcher/router.rst:207 msgid "How it works?" msgstr "" -#: ../../dispatcher/router.rst:193 +#: ../../dispatcher/router.rst:209 msgid "" "For example, dispatcher has 2 routers, the last router also has one " "nested router:" @@ -246,7 +250,7 @@ msgstr "" msgid "Nested routers example" msgstr "" -#: ../../dispatcher/router.rst:198 +#: ../../dispatcher/router.rst:214 msgid "In this case update propagation flow will have form:" msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/index.po b/docs/locale/en/LC_MESSAGES/index.po index 37f8acde..6e7d2a46 100644 --- a/docs/locale/en/LC_MESSAGES/index.po +++ b/docs/locale/en/LC_MESSAGES/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,15 +18,7 @@ msgstr "" "Generated-By: Babel 2.12.1\n" #: ../../../README.rst:3 -msgid "aiogram |beta badge|" -msgstr "" - -#: ../../../README.rst:94 -msgid "Beta badge" -msgstr "" - -#: ../../../README.rst:6 -msgid "This version is still in development!" +msgid "aiogram" msgstr "" #: ../../../README.rst:-1 @@ -61,7 +53,7 @@ msgstr "" msgid "Codecov" msgstr "" -#: ../../../README.rst:40 +#: ../../../README.rst:37 msgid "" "**aiogram** is a modern and fully asynchronous framework for `Telegram " "Bot API `_ written in Python 3.8 " @@ -69,136 +61,124 @@ msgid "" "`aiohttp `_." msgstr "" -#: ../../../README.rst:45 +#: ../../../README.rst:42 msgid "Make your bots faster and more powerful!" msgstr "" -#: ../../../README.rst:50 +#: ../../../README.rst:47 msgid "Documentation:" msgstr "" -#: ../../../README.rst:48 +#: ../../../README.rst:45 msgid "🇺🇸 `English `_" msgstr "" -#: ../../../README.rst:49 +#: ../../../README.rst:46 msgid "🇺🇦 `Ukrainian `_" msgstr "" -#: ../../../README.rst:54 -msgid "**Breaking News:**" -msgstr "" - -#: ../../../README.rst:56 -msgid "*aiogram* 3.0 has breaking changes." -msgstr "" - -#: ../../../README.rst:58 -msgid "It breaks backward compatibility by introducing new breaking changes!" -msgstr "" - -#: ../../../README.rst:61 +#: ../../../README.rst:50 msgid "Features" msgstr "" -#: ../../../README.rst:63 +#: ../../../README.rst:52 msgid "" "Asynchronous (`asyncio docs " "`_, :pep:`492`)" msgstr "" -#: ../../../README.rst:64 +#: ../../../README.rst:53 msgid "" "Has type hints (:pep:`484`) and can be used with `mypy `_" msgstr "" -#: ../../../README.rst:65 +#: ../../../README.rst:54 msgid "Supports `PyPy `_" msgstr "" -#: ../../../README.rst:66 +#: ../../../README.rst:55 msgid "" -"Supports `Telegram Bot API 6.7 `_ and" +"Supports `Telegram Bot API 6.8 `_ and" " gets fast updates to the latest versions of the Bot API" msgstr "" -#: ../../../README.rst:67 +#: ../../../README.rst:56 msgid "" "Telegram Bot API integration code was `autogenerated " "`_ and can be easily re-generated " "when API gets updated" msgstr "" -#: ../../../README.rst:68 +#: ../../../README.rst:57 msgid "Updates router (Blueprints)" msgstr "" -#: ../../../README.rst:69 +#: ../../../README.rst:58 msgid "Has Finite State Machine" msgstr "" -#: ../../../README.rst:70 +#: ../../../README.rst:59 msgid "" "Uses powerful `magic filters " -"`" +"`_" msgstr "" -#: ../../../README.rst:71 +#: ../../../README.rst:60 msgid "Middlewares (incoming updates and API calls)" msgstr "" -#: ../../../README.rst:72 +#: ../../../README.rst:61 msgid "" "Provides `Replies into Webhook `_" msgstr "" -#: ../../../README.rst:73 +#: ../../../README.rst:62 msgid "Integrated I18n/L10n support with GNU Gettext (or Fluent)" msgstr "" -#: ../../../README.rst:78 +#: ../../../README.rst:67 msgid "" "It is strongly advised that you have prior experience working with " "`asyncio `_ before " "beginning to use **aiogram**." msgstr "" -#: ../../../README.rst:82 +#: ../../../README.rst:71 msgid "If you have any questions, you can visit our community chats on Telegram:" msgstr "" -#: ../../../README.rst:84 +#: ../../../README.rst:73 msgid "🇺🇸 `@aiogram `_" msgstr "" -#: ../../../README.rst:85 +#: ../../../README.rst:74 msgid "🇺🇦 `@aiogramua `_" msgstr "" -#: ../../../README.rst:86 +#: ../../../README.rst:75 msgid "🇺🇿 `@aiogram_uz `_" msgstr "" -#: ../../../README.rst:87 +#: ../../../README.rst:76 msgid "🇰🇿 `@aiogram_kz `_" msgstr "" -#: ../../../README.rst:88 +#: ../../../README.rst:77 msgid "🇷🇺 `@aiogram_ru `_" msgstr "" -#: ../../../README.rst:89 +#: ../../../README.rst:78 msgid "🇮🇷 `@aiogram_fa `_" msgstr "" -#: ../../../README.rst:90 +#: ../../../README.rst:79 msgid "🇮🇹 `@aiogram_it `_" msgstr "" -#: ../../../README.rst:91 +#: ../../../README.rst:80 msgid "🇧🇷 `@aiogram_br `_" msgstr "" @@ -236,3 +216,34 @@ msgstr "" #~ " updates to the latest versions of" #~ " the Bot API" #~ msgstr "" + +#~ msgid "aiogram |beta badge|" +#~ msgstr "" + +#~ msgid "Beta badge" +#~ msgstr "" + +#~ msgid "This version is still in development!" +#~ msgstr "" + +#~ msgid "**Breaking News:**" +#~ msgstr "" + +#~ msgid "*aiogram* 3.0 has breaking changes." +#~ msgstr "" + +#~ msgid "It breaks backward compatibility by introducing new breaking changes!" +#~ msgstr "" + +#~ msgid "" +#~ "Supports `Telegram Bot API 6.7 " +#~ "`_ and gets fast" +#~ " updates to the latest versions of" +#~ " the Bot API" +#~ msgstr "" + +#~ msgid "" +#~ "Uses powerful `magic filters " +#~ "`" +#~ msgstr "" diff --git a/docs/locale/en/LC_MESSAGES/migration_2_to_3.po b/docs/locale/en/LC_MESSAGES/migration_2_to_3.po index 9035b8b8..3541ffff 100644 --- a/docs/locale/en/LC_MESSAGES/migration_2_to_3.po +++ b/docs/locale/en/LC_MESSAGES/migration_2_to_3.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -99,17 +99,24 @@ msgid "" "accessed via :code:`data[\"bot\"]`." msgstr "" -#: ../../migration_2_to_3.rst:46 +#: ../../migration_2_to_3.rst:43 +msgid "" +"Now to skip pending updates, you should call the " +":class:`aiogram.methods.delete_webhook.DeleteWebhook` method directly " +"instead of passing :code:`skip_updates=True` to start polling method." +msgstr "" + +#: ../../migration_2_to_3.rst:47 msgid "Filtering events" msgstr "" -#: ../../migration_2_to_3.rst:48 +#: ../../migration_2_to_3.rst:49 msgid "" "Keyword filters can no more be used, use filters explicitly. (`Read more " "» `_)" msgstr "" -#: ../../migration_2_to_3.rst:49 +#: ../../migration_2_to_3.rst:50 msgid "" "In due to keyword filters was removed all enabled by default filters " "(state and content_type now is not enabled), so you should specify them " @@ -118,19 +125,19 @@ msgid "" "use :code:`@router.message(F.photo)`" msgstr "" -#: ../../migration_2_to_3.rst:53 +#: ../../migration_2_to_3.rst:54 msgid "" "Most of common filters is replaced by \"magic filter\". (:ref:`Read more " "» `)" msgstr "" -#: ../../migration_2_to_3.rst:54 +#: ../../migration_2_to_3.rst:55 msgid "" "Now by default message handler receives any content type, if you want " "specific one just add the filters (Magic or any other)" msgstr "" -#: ../../migration_2_to_3.rst:56 +#: ../../migration_2_to_3.rst:57 msgid "" "State filter now is not enabled by default, that's mean if you using " ":code:`state=\"*\"` in v2 then you should not pass any state filter in " @@ -138,38 +145,38 @@ msgid "" "specify the state." msgstr "" -#: ../../migration_2_to_3.rst:59 +#: ../../migration_2_to_3.rst:60 msgid "" "Added possibility to register per-router global filters, that helps to " "reduces the number of repetitions in the code and makes easily way to " "control for what each router will be used." msgstr "" -#: ../../migration_2_to_3.rst:65 +#: ../../migration_2_to_3.rst:66 msgid "Bot API" msgstr "" -#: ../../migration_2_to_3.rst:67 +#: ../../migration_2_to_3.rst:68 msgid "" "Now all API methods is classes with validation (via `pydantic " "`_) (all API calls is also available as " "methods in the Bot class)." msgstr "" -#: ../../migration_2_to_3.rst:69 +#: ../../migration_2_to_3.rst:70 msgid "" "Added more pre-defined Enums and moved into `aiogram.enums` sub-package. " "For example chat type enum now is :class:`aiogram.enums.ChatType` instead" " of :class:`aiogram.types.chat.ChatType`. (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:72 +#: ../../migration_2_to_3.rst:73 msgid "" "Separated HTTP client session into container that can be reused between " "different Bot instances in the application." msgstr "" -#: ../../migration_2_to_3.rst:74 +#: ../../migration_2_to_3.rst:75 msgid "" "API Exceptions is no more classified by specific message in due to " "Telegram has no documented error codes. But all errors is classified by " @@ -179,17 +186,17 @@ msgid "" "types>`)" msgstr "" -#: ../../migration_2_to_3.rst:81 +#: ../../migration_2_to_3.rst:82 msgid "Middlewares" msgstr "" -#: ../../migration_2_to_3.rst:83 +#: ../../migration_2_to_3.rst:84 msgid "" "Middlewares can now control a execution context, e.g. using context " "managers (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:84 +#: ../../migration_2_to_3.rst:85 msgid "" "All contextual data now is shared between middlewares, filters and " "handlers to end-to-end use. For example now you can easily pass some data" @@ -197,75 +204,102 @@ msgid "" "same way as in the handlers via keyword arguments." msgstr "" -#: ../../migration_2_to_3.rst:87 +#: ../../migration_2_to_3.rst:88 msgid "" "Added mechanism named **flags**, that helps to customize handler behavior" " in conjunction with middlewares. (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:92 +#: ../../migration_2_to_3.rst:93 msgid "Keyboard Markup" msgstr "" -#: ../../migration_2_to_3.rst:94 +#: ../../migration_2_to_3.rst:95 msgid "" "Now :class:`aiogram.types.inline_keyboard_markup.InlineKeyboardMarkup` " "and :class:`aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup` has " "no methods to extend it, instead you have to use markup builders " ":class:`aiogram.utils.keyboard.ReplyKeyboardBuilder` and " ":class:`aiogram.utils.keyboard.KeyboardBuilder` respectively (:ref:`Read " -"more » `)" +"more » `)" msgstr "" -#: ../../migration_2_to_3.rst:102 +#: ../../migration_2_to_3.rst:103 msgid "Callbacks data" msgstr "" -#: ../../migration_2_to_3.rst:104 +#: ../../migration_2_to_3.rst:105 msgid "" "Callback data factory now is strictly typed via `pydantic " -"`_ models (:ref:`Read more » `_ models (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:109 +#: ../../migration_2_to_3.rst:110 msgid "Finite State machine" msgstr "" -#: ../../migration_2_to_3.rst:111 +#: ../../migration_2_to_3.rst:112 msgid "" "State filter will no more added to all handlers, you will need to specify" " state if you want" msgstr "" -#: ../../migration_2_to_3.rst:112 +#: ../../migration_2_to_3.rst:113 msgid "" "Added possibility to change FSM strategy, for example if you want to " "control state for each user in chat topics instead of user in chat you " "can specify it in the Dispatcher." msgstr "" -#: ../../migration_2_to_3.rst:117 +#: ../../migration_2_to_3.rst:115 +msgid "" +"Now :class:`aiogram.fsm.state.State` and " +":class:`aiogram.fsm.state.StateGroup` don't have helper methods like " +":code:`.set()`, :code:`.next()`, etc." +msgstr "" + +#: ../../migration_2_to_3.rst:118 +msgid "" +"Instead of this you should set states by passing them directly to " +":class:`aiogram.fsm.context.FSMContext` (:ref:`Read more » `)" +msgstr "" + +#: ../../migration_2_to_3.rst:120 +msgid "" +"State proxy is deprecated, you should update the state data by calling " +":code:`state.set_data(...)` and :code:`state.get_data()` respectively." +msgstr "" + +#: ../../migration_2_to_3.rst:125 msgid "Sending Files" msgstr "" -#: ../../migration_2_to_3.rst:119 +#: ../../migration_2_to_3.rst:127 msgid "" "From now you should wrap sending files into InputFile object before send " "instead of passing IO object directly to the API method. (:ref:`Read more" " » `)" msgstr "" -#: ../../migration_2_to_3.rst:124 +#: ../../migration_2_to_3.rst:132 msgid "Webhook" msgstr "" -#: ../../migration_2_to_3.rst:126 +#: ../../migration_2_to_3.rst:134 msgid "Simplified aiohttp web app configuration" msgstr "" -#: ../../migration_2_to_3.rst:127 +#: ../../migration_2_to_3.rst:135 msgid "" "By default added possibility to upload files when you use reply into " "webhook" msgstr "" + +#~ msgid "" +#~ "Callback data factory now is strictly" +#~ " typed via `pydantic " +#~ "`_ models (:ref:`Read " +#~ "more » `)" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_all_general_forum_topic_messages.po b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_all_general_forum_topic_messages.po new file mode 100644 index 00000000..b4154aa5 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/methods/unpin_all_general_forum_topic_messages.po @@ -0,0 +1,94 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-08-26 23:17+0300\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.12.1\n" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:3 +msgid "unpinAllGeneralForumTopicMessages" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:5 +msgid "Returns: :obj:`bool`" +msgstr "" + +#: aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages:1 +#: of +msgid "" +"Use this method to clear the list of pinned messages in a General 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.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages:3 +#: of +msgid "" +"Source: " +"https://core.telegram.org/bots/api#unpinallgeneralforumtopicmessages" +msgstr "" + +#: ../../docstring +#: aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages.chat_id:1 +#: of +msgid "" +"Unique identifier for the target chat or username of the target " +"supergroup (in the format :code:`@supergroupusername`)" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:15 +msgid "Usage" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:18 +msgid "As bot method" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:26 +msgid "Method as object" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:28 +msgid "Imports:" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:30 +msgid "" +":code:`from aiogram.methods.unpin_all_general_forum_topic_messages import" +" UnpinAllGeneralForumTopicMessages`" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:31 +msgid "" +"alias: :code:`from aiogram.methods import " +"UnpinAllGeneralForumTopicMessages`" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:34 +msgid "With specific bot" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:41 +msgid "As reply into Webhook in handler" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:49 +msgid "As shortcut from received object" +msgstr "" + +#: ../../api/methods/unpin_all_general_forum_topic_messages.rst:51 +msgid ":meth:`aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages`" +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 df76afc2..9628f5ea 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/chat.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/chat.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-12 00:22+0200\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.12.1\n" #: ../../api/types/chat.rst:3 msgid "Chat" @@ -88,6 +88,13 @@ msgid "" ":class:`aiogram.methods.get_chat.GetChat`." msgstr "" +#: ../../docstring aiogram.types.chat.Chat.emoji_status_expiration_date:1 of +msgid "" +"*Optional*. Expiration date of the emoji status of the other party in a " +"private chat, if any. Returned only in " +":class:`aiogram.methods.get_chat.GetChat`." +msgstr "" + #: ../../docstring aiogram.types.chat.Chat.bio:1 of msgid "" "*Optional*. Bio of the other party in a private chat. Returned only in " @@ -264,6 +271,7 @@ msgstr "" #: 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_general_forum_topic_messages:4 #: aiogram.types.chat.Chat.unpin_all_messages:4 #: aiogram.types.chat.Chat.unpin_message:4 of msgid ":code:`chat_id`" @@ -320,6 +328,7 @@ msgstr "" #: 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_general_forum_topic_messages #: aiogram.types.chat.Chat.unpin_all_messages #: aiogram.types.chat.Chat.unpin_message of msgid "Returns" @@ -1269,6 +1278,33 @@ msgstr "" msgid "instance of method :class:`aiogram.methods.set_chat_photo.SetChatPhoto`" msgstr "" +#: aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages:1 of +msgid "" +"Shortcut for method " +":class:`aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages`" +" will automatically fill method attributes:" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages:6 of +msgid "" +"Use this method to clear the list of pinned messages in a General 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.types.chat.Chat.unpin_all_general_forum_topic_messages:8 of +msgid "" +"Source: " +"https://core.telegram.org/bots/api#unpinallgeneralforumtopicmessages" +msgstr "" + +#: aiogram.types.chat.Chat.unpin_all_general_forum_topic_messages:10 of +msgid "" +"instance of method " +":class:`aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages`" +msgstr "" + #~ msgid "" #~ "Use this method to get information " #~ "about a member of a chat. The " @@ -1288,4 +1324,3 @@ msgstr "" #~ "by administrators that were appointed by" #~ " him)" #~ 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 e04a77e4..8c20ee62 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: 2023-08-06 16:52+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -173,6 +173,10 @@ msgstr "" msgid "*Optional*. Message is a sticker, information about the sticker" msgstr "" +#: ../../docstring aiogram.types.message.Message.story:1 of +msgid "*Optional*. Message is a forwarded story" +msgstr "" + #: ../../docstring aiogram.types.message.Message.video:1 of msgid "*Optional*. Message is a video, information about the video" msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/poll_answer.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/poll_answer.po index 627b292c..63fb9b5d 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/api/types/poll_answer.po +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/poll_answer.po @@ -8,14 +8,14 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.12.1\n" #: ../../api/types/poll_answer.rst:3 msgid "PollAnswer" @@ -33,12 +33,29 @@ msgstr "" msgid "Unique poll identifier" msgstr "" -#: ../../docstring aiogram.types.poll_answer.PollAnswer.user:1 of -msgid "The user, who changed the answer to the poll" -msgstr "" - #: ../../docstring aiogram.types.poll_answer.PollAnswer.option_ids:1 of msgid "" -"0-based identifiers of answer options, chosen by the user. May be empty " -"if the user retracted their vote." +"0-based identifiers of chosen answer options. May be empty if the vote " +"was retracted." msgstr "" + +#: ../../docstring aiogram.types.poll_answer.PollAnswer.voter_chat:1 of +msgid "" +"*Optional*. The chat that changed the answer to the poll, if the voter is" +" anonymous" +msgstr "" + +#: ../../docstring aiogram.types.poll_answer.PollAnswer.user:1 of +msgid "" +"*Optional*. The user that changed the answer to the poll, if the voter " +"isn't anonymous" +msgstr "" + +#~ msgid "The user, who changed the answer to the poll" +#~ msgstr "" + +#~ msgid "" +#~ "0-based identifiers of answer options, " +#~ "chosen by the user. May be empty" +#~ " if the user retracted their vote." +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/api/types/story.po b/docs/locale/uk_UA/LC_MESSAGES/api/types/story.po new file mode 100644 index 00000000..92bf0e3a --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/api/types/story.po @@ -0,0 +1,32 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-08-26 23:17+0300\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.12.1\n" + +#: ../../api/types/story.rst:3 +msgid "Story" +msgstr "" + +#: aiogram.types.story.Story:1 of +msgid "" +"This object represents a message about a forwarded story in the chat. " +"Currently holds no information." +msgstr "" + +#: aiogram.types.story.Story:3 of +msgid "Source: https://core.telegram.org/bots/api#story" +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/changelog.po b/docs/locale/uk_UA/LC_MESSAGES/changelog.po index 2e084a69..e22fe009 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: 2023-08-06 16:52+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -22,26 +22,149 @@ msgid "Changelog" msgstr "" #: ../../[towncrier-fragments]:2 -msgid "\\ |release| [UNRELEASED DRAFT] (2023-08-06)" +msgid "\\ |release| [UNRELEASED DRAFT] (2023-08-26)" msgstr "" -#: ../../../CHANGES.rst:24 ../../../CHANGES.rst:66 ../../../CHANGES.rst:229 -#: ../../../CHANGES.rst:329 ../../../CHANGES.rst:389 ../../../CHANGES.rst:440 -#: ../../../CHANGES.rst:513 ../../../CHANGES.rst:554 ../../../CHANGES.rst:592 -#: ../../../CHANGES.rst:640 ../../../CHANGES.rst:716 ../../../CHANGES.rst:749 -#: ../../../CHANGES.rst:780 ../../[towncrier-fragments]:5 -msgid "Features" +#: ../../../CHANGES.rst:23 ../../../CHANGES.rst:92 ../../../CHANGES.rst:137 +#: ../../../CHANGES.rst:207 ../../../CHANGES.rst:393 ../../../CHANGES.rst:456 +#: ../../../CHANGES.rst:505 ../../../CHANGES.rst:566 ../../../CHANGES.rst:624 +#: ../../../CHANGES.rst:670 ../../../CHANGES.rst:718 ../../../CHANGES.rst:774 +#: ../../../CHANGES.rst:859 ../../../CHANGES.rst:891 +#: ../../[towncrier-fragments]:5 +msgid "Bugfixes" msgstr "" #: ../../[towncrier-fragments]:7 +msgid "" +"Fixed magic :code:`.as_(...)` operation for values that can be " +"interpreted as `False` (e.g. `0`). `#1281 " +"`_" +msgstr "" + +#: ../../[towncrier-fragments]:9 +msgid "" +"Italic markdown from utils now uses correct decorators `#1282 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:20 +msgid "3.0.0rc2 (2023-08-18)" +msgstr "" + +#: ../../../CHANGES.rst:25 +msgid "" +"Fixed missing message content types (:code:`ContentType.USER_SHARED`, " +":code:`ContentType.CHAT_SHARED`) `#1252 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:27 +msgid "" +"Fixed nested hashtag, cashtag and email message entities not being parsed" +" correctly when these entities are inside another entity. `#1259 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:29 +msgid "" +"Moved global filters check placement into router to add chance to pass " +"context from global filters into handlers in the same way as it possible " +"in other places `#1266 `_" +msgstr "" + +#: ../../../CHANGES.rst:35 ../../../CHANGES.rst:105 ../../../CHANGES.rst:150 +#: ../../../CHANGES.rst:235 ../../../CHANGES.rst:468 ../../../CHANGES.rst:518 +#: ../../../CHANGES.rst:898 +msgid "Improved Documentation" +msgstr "" + +#: ../../../CHANGES.rst:37 +msgid "" +"Added error handling example `examples/error_handling.py` `#1099 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:39 +msgid "" +"Added a few words about skipping pending updates `#1251 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:41 +msgid "" +"Added a section on Dependency Injection technology `#1253 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:43 +msgid "" +"This update includes the addition of a multi-file bot example to the " +"repository. `#1254 `_" +msgstr "" + +#: ../../../CHANGES.rst:45 +msgid "" +"Refactored examples code to use aiogram enumerations and enhanced chat " +"messages with markdown beautification's for a more user-friendly display." +" `#1256 `_" +msgstr "" + +#: ../../../CHANGES.rst:48 +msgid "" +"Supplemented \"Finite State Machine\" section in Migration FAQ `#1264 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:50 +msgid "" +"Removed extra param in docstring of TelegramEventObserver's filter method" +" and fixed typo in I18n documentation. `#1268 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:56 ../../../CHANGES.rst:112 ../../../CHANGES.rst:251 +#: ../../../CHANGES.rst:402 ../../../CHANGES.rst:479 ../../../CHANGES.rst:532 +#: ../../../CHANGES.rst:583 ../../../CHANGES.rst:637 ../../../CHANGES.rst:679 +#: ../../../CHANGES.rst:725 ../../../CHANGES.rst:785 ../../../CHANGES.rst:806 +#: ../../../CHANGES.rst:829 ../../../CHANGES.rst:866 ../../../CHANGES.rst:905 +msgid "Misc" +msgstr "" + +#: ../../../CHANGES.rst:58 +msgid "" +"Enhanced the warning message in dispatcher to include a JSON dump of the " +"update when update type is not known. `#1269 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:60 +msgid "" +"Added support for `Bot API 6.8 `_ `#1275 " +"`_" +msgstr "" + +#: ../../../CHANGES.rst:65 +msgid "3.0.0rc1 (2023-08-06)" +msgstr "" + +#: ../../../CHANGES.rst:68 ../../../CHANGES.rst:126 ../../../CHANGES.rst:168 +#: ../../../CHANGES.rst:331 ../../../CHANGES.rst:431 ../../../CHANGES.rst:491 +#: ../../../CHANGES.rst:542 ../../../CHANGES.rst:615 ../../../CHANGES.rst:656 +#: ../../../CHANGES.rst:694 ../../../CHANGES.rst:742 ../../../CHANGES.rst:818 +#: ../../../CHANGES.rst:851 ../../../CHANGES.rst:882 +msgid "Features" +msgstr "" + +#: ../../../CHANGES.rst:70 msgid "Added Currency enum. You can use it like this:" msgstr "" -#: ../../[towncrier-fragments]:19 +#: ../../../CHANGES.rst:82 msgid "`#1194 `_" msgstr "" -#: ../../[towncrier-fragments]:20 +#: ../../../CHANGES.rst:83 msgid "" "Updated keyboard builders with new methods for integrating buttons and " "keyboard creation more seamlessly. Added functionality to create buttons " @@ -50,49 +173,45 @@ msgid "" "`#1236 `_" msgstr "" -#: ../../../CHANGES.rst:35 ../../../CHANGES.rst:105 ../../../CHANGES.rst:291 -#: ../../../CHANGES.rst:354 ../../../CHANGES.rst:403 ../../../CHANGES.rst:464 -#: ../../../CHANGES.rst:522 ../../../CHANGES.rst:568 ../../../CHANGES.rst:616 -#: ../../../CHANGES.rst:672 ../../../CHANGES.rst:757 ../../../CHANGES.rst:789 -#: ../../[towncrier-fragments]:27 -msgid "Bugfixes" +#: ../../../CHANGES.rst:87 +msgid "" +"Added support for message_thread_id in ChatActionSender `#1249 " +"`_" msgstr "" -#: ../../[towncrier-fragments]:29 +#: ../../../CHANGES.rst:94 msgid "" "Fixed polling startup when \"bot\" key is passed manually into dispatcher" " workflow data `#1242 `_" msgstr "" -#: ../../[towncrier-fragments]:31 +#: ../../../CHANGES.rst:96 msgid "Added codegen configuration for lost shortcuts:" msgstr "" -#: ../../[towncrier-fragments]:33 +#: ../../../CHANGES.rst:98 msgid "ShippingQuery.answer" msgstr "" -#: ../../[towncrier-fragments]:34 +#: ../../../CHANGES.rst:99 msgid "PreCheckoutQuery.answer" msgstr "" -#: ../../[towncrier-fragments]:35 +#: ../../../CHANGES.rst:100 msgid "Message.delete_reply_markup" msgstr "" -#: ../../[towncrier-fragments]:36 +#: ../../../CHANGES.rst:101 msgid "`#1244 `_" msgstr "" -#: ../../../CHANGES.rst:149 ../../../CHANGES.rst:300 ../../../CHANGES.rst:377 -#: ../../../CHANGES.rst:430 ../../../CHANGES.rst:481 ../../../CHANGES.rst:535 -#: ../../../CHANGES.rst:577 ../../../CHANGES.rst:623 ../../../CHANGES.rst:683 -#: ../../../CHANGES.rst:704 ../../../CHANGES.rst:727 ../../../CHANGES.rst:764 -#: ../../../CHANGES.rst:803 ../../[towncrier-fragments]:40 -msgid "Misc" +#: ../../../CHANGES.rst:107 +msgid "" +"Added documentation for webhook and polling modes. `#1241 " +"`_" msgstr "" -#: ../../[towncrier-fragments]:42 +#: ../../../CHANGES.rst:114 msgid "" "Reworked InputFile reading, removed :code:`__aiter__` method, added `bot:" " Bot` argument to the :code:`.read(...)` method, so, from now " @@ -100,18 +219,18 @@ msgid "" "`_" msgstr "" -#: ../../[towncrier-fragments]:46 +#: ../../../CHANGES.rst:118 msgid "" "Code-generated :code:`__init__` typehints in types and methods to make " "IDE happy without additional pydantic plugin `#1245 " "`_" msgstr "" -#: ../../../CHANGES.rst:21 +#: ../../../CHANGES.rst:123 msgid "3.0.0b9 (2023-07-30)" msgstr "" -#: ../../../CHANGES.rst:26 +#: ../../../CHANGES.rst:128 msgid "" "Added new shortcuts for " ":class:`aiogram.types.chat_member_updated.ChatMemberUpdated` to send " @@ -119,7 +238,7 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:29 +#: ../../../CHANGES.rst:131 msgid "" "Added new shortcuts for " ":class:`aiogram.types.chat_join_request.ChatJoinRequest` to make easier " @@ -127,13 +246,13 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:37 +#: ../../../CHANGES.rst:139 msgid "" "Fixed bot assignment in the :code:`Message.send_copy` shortcut `#1232 " "`_" msgstr "" -#: ../../../CHANGES.rst:39 +#: ../../../CHANGES.rst:141 msgid "" "Added model validation to remove UNSET before field validation. This " "change was necessary to correctly handle parse_mode where 'UNSET' is used" @@ -143,26 +262,21 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:44 +#: ../../../CHANGES.rst:146 msgid "Updated pydantic to 2.1 with few bugfixes" msgstr "" -#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:133 ../../../CHANGES.rst:366 -#: ../../../CHANGES.rst:416 ../../../CHANGES.rst:796 -msgid "Improved Documentation" -msgstr "" - -#: ../../../CHANGES.rst:50 +#: ../../../CHANGES.rst:152 msgid "" "Improved docs, added basic migration guide (will be expanded later) " "`#1143 `_" msgstr "" -#: ../../../CHANGES.rst:55 ../../../CHANGES.rst:140 ../../../CHANGES.rst:423 +#: ../../../CHANGES.rst:157 ../../../CHANGES.rst:242 ../../../CHANGES.rst:525 msgid "Deprecations and Removals" msgstr "" -#: ../../../CHANGES.rst:57 +#: ../../../CHANGES.rst:159 msgid "" "Removed the use of the context instance (Bot.get_current) from all " "placements that were used previously. This is to avoid the use of the " @@ -170,78 +284,78 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:63 +#: ../../../CHANGES.rst:165 msgid "3.0.0b8 (2023-07-17)" msgstr "" -#: ../../../CHANGES.rst:68 +#: ../../../CHANGES.rst:170 msgid "" "Added possibility to use custom events in routers (If router does not " "support custom event it does not break and passes it to included " "routers). `#1147 `_" msgstr "" -#: ../../../CHANGES.rst:70 +#: ../../../CHANGES.rst:172 msgid "Added support for FSM in Forum topics." msgstr "" -#: ../../../CHANGES.rst:72 +#: ../../../CHANGES.rst:174 msgid "The strategy can be changed in dispatcher:" msgstr "" -#: ../../../CHANGES.rst:85 +#: ../../../CHANGES.rst:187 msgid "" "If you have implemented you own storages you should extend record key " "generation with new one attribute - :code:`thread_id`" msgstr "" -#: ../../../CHANGES.rst:87 +#: ../../../CHANGES.rst:189 msgid "`#1161 `_" msgstr "" -#: ../../../CHANGES.rst:88 +#: ../../../CHANGES.rst:190 msgid "Improved CallbackData serialization." msgstr "" -#: ../../../CHANGES.rst:90 +#: ../../../CHANGES.rst:192 msgid "Minimized UUID (hex without dashes)" msgstr "" -#: ../../../CHANGES.rst:91 +#: ../../../CHANGES.rst:193 msgid "Replaced bool values with int (true=1, false=0)" msgstr "" -#: ../../../CHANGES.rst:92 +#: ../../../CHANGES.rst:194 msgid "`#1163 `_" msgstr "" -#: ../../../CHANGES.rst:93 +#: ../../../CHANGES.rst:195 msgid "" "Added a tool to make text formatting flexible and easy. More details on " "the :ref:`corresponding documentation page ` `#1172 " "`_" msgstr "" -#: ../../../CHANGES.rst:96 +#: ../../../CHANGES.rst:198 msgid "" "Added :code:`X-Telegram-Bot-Api-Secret-Token` header check `#1173 " "`_" msgstr "" -#: ../../../CHANGES.rst:98 +#: ../../../CHANGES.rst:200 msgid "" "Made :code:`allowed_updates` list to revolve automatically in " "start_polling method if not set explicitly. `#1178 " "`_" msgstr "" -#: ../../../CHANGES.rst:100 +#: ../../../CHANGES.rst:202 msgid "" "Added possibility to pass custom headers to :class:`URLInputFile` object " "`#1191 `_" msgstr "" -#: ../../../CHANGES.rst:107 +#: ../../../CHANGES.rst:209 msgid "" "Change type of result in InlineQueryResult enum for " ":code:`InlineQueryResultCachedMpeg4Gif` and " @@ -249,51 +363,51 @@ msgid "" "documentation." msgstr "" -#: ../../../CHANGES.rst:110 +#: ../../../CHANGES.rst:212 msgid "" "Change regexp for entities parsing to more correct " "(:code:`InlineQueryResultType.yml`). `#1146 " "`_" msgstr "" -#: ../../../CHANGES.rst:112 +#: ../../../CHANGES.rst:214 msgid "" "Fixed signature of startup/shutdown events to include the " ":code:`**dispatcher.workflow_data` as the handler arguments. `#1155 " "`_" msgstr "" -#: ../../../CHANGES.rst:114 +#: ../../../CHANGES.rst:216 msgid "" "Added missing :code:`FORUM_TOPIC_EDITED` value to content_type property " "`#1160 `_" msgstr "" -#: ../../../CHANGES.rst:116 +#: ../../../CHANGES.rst:218 msgid "" "Fixed compatibility with Python 3.8-3.9 (from previous release) `#1162 " "`_" msgstr "" -#: ../../../CHANGES.rst:118 +#: ../../../CHANGES.rst:220 msgid "" "Fixed the markdown spoiler parser. `#1176 " "`_" msgstr "" -#: ../../../CHANGES.rst:120 +#: ../../../CHANGES.rst:222 msgid "" "Fixed workflow data propagation `#1196 " "`_" msgstr "" -#: ../../../CHANGES.rst:122 +#: ../../../CHANGES.rst:224 msgid "" "Fixed the serialization error associated with nested subtypes like " "InputMedia, ChatMember, etc." msgstr "" -#: ../../../CHANGES.rst:125 +#: ../../../CHANGES.rst:227 msgid "" "The previously generated code resulted in an invalid schema under " "pydantic v2, which has stricter type parsing. Hence, subtypes without the" @@ -302,71 +416,71 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:135 +#: ../../../CHANGES.rst:237 msgid "" "Changed small grammar typos for :code:`upload_file` `#1133 " "`_" msgstr "" -#: ../../../CHANGES.rst:142 +#: ../../../CHANGES.rst:244 msgid "" "Removed text filter in due to is planned to remove this filter few " "versions ago." msgstr "" -#: ../../../CHANGES.rst:144 +#: ../../../CHANGES.rst:246 msgid "" "Use :code:`F.text` instead `#1170 " "`_" msgstr "" -#: ../../../CHANGES.rst:151 +#: ../../../CHANGES.rst:253 msgid "" "Added full support of `Bot API 6.6 `_" msgstr "" -#: ../../../CHANGES.rst:155 +#: ../../../CHANGES.rst:257 msgid "" "Note that this issue has breaking changes described in in the Bot API " "changelog, this changes is not breaking in the API but breaking inside " "aiogram because Beta stage is not finished." msgstr "" -#: ../../../CHANGES.rst:158 +#: ../../../CHANGES.rst:260 msgid "`#1139 `_" msgstr "" -#: ../../../CHANGES.rst:159 +#: ../../../CHANGES.rst:261 msgid "" "Added full support of `Bot API 6.7 `_" msgstr "" -#: ../../../CHANGES.rst:163 +#: ../../../CHANGES.rst:265 msgid "" "Note that arguments *switch_pm_parameter* and *switch_pm_text* was " "deprecated and should be changed to *button* argument as described in API" " docs." msgstr "" -#: ../../../CHANGES.rst:165 +#: ../../../CHANGES.rst:267 msgid "`#1168 `_" msgstr "" -#: ../../../CHANGES.rst:166 +#: ../../../CHANGES.rst:268 msgid "Updated `Pydantic to V2 `_" msgstr "" -#: ../../../CHANGES.rst:170 +#: ../../../CHANGES.rst:272 msgid "Be careful, not all libraries is already updated to using V2" msgstr "" -#: ../../../CHANGES.rst:171 +#: ../../../CHANGES.rst:273 msgid "`#1202 `_" msgstr "" -#: ../../../CHANGES.rst:172 +#: ../../../CHANGES.rst:274 msgid "" "Added global defaults :code:`disable_web_page_preview` and " ":code:`protect_content` in addition to :code:`parse_mode` to the Bot " @@ -374,13 +488,13 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:175 +#: ../../../CHANGES.rst:277 msgid "" "Removed bot parameters from storages `#1144 " "`_" msgstr "" -#: ../../../CHANGES.rst:178 +#: ../../../CHANGES.rst:280 msgid "" "Replaced ContextVar's with a new feature called `Validation Context " "`_" @@ -388,69 +502,69 @@ msgid "" "handling the Bot instance within method shortcuts." msgstr "" -#: ../../../CHANGES.rst:183 +#: ../../../CHANGES.rst:285 msgid "**Breaking**: The 'bot' argument now is required in `URLInputFile`" msgstr "" -#: ../../../CHANGES.rst:184 +#: ../../../CHANGES.rst:286 msgid "`#1210 `_" msgstr "" -#: ../../../CHANGES.rst:185 +#: ../../../CHANGES.rst:287 msgid "Updated magic-filter with new features" msgstr "" -#: ../../../CHANGES.rst:187 +#: ../../../CHANGES.rst:289 msgid "Added hint for :code:`len(F)` error" msgstr "" -#: ../../../CHANGES.rst:188 +#: ../../../CHANGES.rst:290 msgid "Added not in operation" msgstr "" -#: ../../../CHANGES.rst:189 +#: ../../../CHANGES.rst:291 msgid "`#1221 `_" msgstr "" -#: ../../../CHANGES.rst:193 +#: ../../../CHANGES.rst:295 msgid "3.0.0b7 (2023-02-18)" msgstr "" -#: ../../../CHANGES.rst:197 +#: ../../../CHANGES.rst:299 msgid "" "Note that this version has incompatibility with Python 3.8-3.9 in case " "when you create an instance of Dispatcher outside of the any coroutine." msgstr "" -#: ../../../CHANGES.rst:199 +#: ../../../CHANGES.rst:301 msgid "Sorry for the inconvenience, it will be fixed in the next version." msgstr "" -#: ../../../CHANGES.rst:201 +#: ../../../CHANGES.rst:303 msgid "This code will not work:" msgstr "" -#: ../../../CHANGES.rst:213 +#: ../../../CHANGES.rst:315 msgid "But if you change it like this it should works as well:" msgstr "" -#: ../../../CHANGES.rst:231 +#: ../../../CHANGES.rst:333 msgid "Added missing shortcuts, new enums, reworked old stuff" msgstr "" -#: ../../../CHANGES.rst:233 +#: ../../../CHANGES.rst:335 msgid "" "**Breaking** All previously added enums is re-generated in new place - " "`aiogram.enums` instead of `aiogram.types`" msgstr "" -#: ../../../CHANGES.rst:251 +#: ../../../CHANGES.rst:353 msgid "" "**Added enums:** " ":class:`aiogram.enums.bot_command_scope_type.BotCommandScopeType`," msgstr "" -#: ../../../CHANGES.rst:237 +#: ../../../CHANGES.rst:339 msgid "" ":class:`aiogram.enums.chat_action.ChatAction`, " ":class:`aiogram.enums.chat_member_status.ChatMemberStatus`, " @@ -469,15 +583,15 @@ msgid "" ":class:`aiogram.enums.update_type.UpdateType`," msgstr "" -#: ../../../CHANGES.rst:253 +#: ../../../CHANGES.rst:355 msgid "**Added shortcuts**:" msgstr "" -#: ../../../CHANGES.rst:278 +#: ../../../CHANGES.rst:380 msgid "*Chat* :meth:`aiogram.types.chat.Chat.get_administrators`," msgstr "" -#: ../../../CHANGES.rst:256 +#: ../../../CHANGES.rst:358 msgid "" ":meth:`aiogram.types.chat.Chat.delete_message`, " ":meth:`aiogram.types.chat.Chat.revoke_invite_link`, " @@ -505,85 +619,85 @@ msgid "" ":meth:`aiogram.types.chat.Chat.set_photo`," msgstr "" -#: ../../../CHANGES.rst:280 +#: ../../../CHANGES.rst:382 msgid "*Sticker*: :meth:`aiogram.types.sticker.Sticker.set_position_in_set`," msgstr "" -#: ../../../CHANGES.rst:281 +#: ../../../CHANGES.rst:383 msgid ":meth:`aiogram.types.sticker.Sticker.delete_from_set`," msgstr "" -#: ../../../CHANGES.rst:282 +#: ../../../CHANGES.rst:384 msgid "*User*: :meth:`aiogram.types.user.User.get_profile_photos`" msgstr "" -#: ../../../CHANGES.rst:283 +#: ../../../CHANGES.rst:385 msgid "`#952 `_" msgstr "" -#: ../../../CHANGES.rst:284 +#: ../../../CHANGES.rst:386 msgid "" "Added :ref:`callback answer ` feature `#1091 " "`_" msgstr "" -#: ../../../CHANGES.rst:286 +#: ../../../CHANGES.rst:388 msgid "" "Added a method that allows you to compactly register routers `#1117 " "`_" msgstr "" -#: ../../../CHANGES.rst:293 +#: ../../../CHANGES.rst:395 msgid "" "Check status code when downloading file `#816 " "`_" msgstr "" -#: ../../../CHANGES.rst:295 +#: ../../../CHANGES.rst:397 msgid "" "Fixed `ignore_case` parameter in :obj:`aiogram.filters.command.Command` " "filter `#1106 `_" msgstr "" -#: ../../../CHANGES.rst:302 +#: ../../../CHANGES.rst:404 msgid "" "Added integration with new code-generator named `Butcher " "`_ `#1069 " "`_" msgstr "" -#: ../../../CHANGES.rst:304 +#: ../../../CHANGES.rst:406 msgid "" "Added full support of `Bot API 6.4 `_ `#1088 " "`_" msgstr "" -#: ../../../CHANGES.rst:306 +#: ../../../CHANGES.rst:408 msgid "" "Updated package metadata, moved build internals from Poetry to Hatch, " "added contributing guides. `#1095 " "`_" msgstr "" -#: ../../../CHANGES.rst:308 +#: ../../../CHANGES.rst:410 msgid "" "Added full support of `Bot API 6.5 `_" msgstr "" -#: ../../../CHANGES.rst:312 +#: ../../../CHANGES.rst:414 msgid "" "Note that :obj:`aiogram.types.chat_permissions.ChatPermissions` is " "updated without backward compatibility, so now this object has no " ":code:`can_send_media_messages` attribute" msgstr "" -#: ../../../CHANGES.rst:314 +#: ../../../CHANGES.rst:416 msgid "`#1112 `_" msgstr "" -#: ../../../CHANGES.rst:315 +#: ../../../CHANGES.rst:417 msgid "" "Replaced error :code:`TypeError: TelegramEventObserver.__call__() got an " "unexpected keyword argument ''` with a more understandable one for " @@ -591,13 +705,13 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:318 +#: ../../../CHANGES.rst:420 msgid "" "Added possibility to reply into webhook with files `#1120 " "`_" msgstr "" -#: ../../../CHANGES.rst:320 +#: ../../../CHANGES.rst:422 msgid "" "Reworked graceful shutdown. Added method to stop polling. Now polling " "started from dispatcher can be stopped by signals gracefully without " @@ -605,127 +719,127 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:326 +#: ../../../CHANGES.rst:428 msgid "3.0.0b6 (2022-11-18)" msgstr "" -#: ../../../CHANGES.rst:331 +#: ../../../CHANGES.rst:433 msgid "" "(again) Added possibility to combine filters with an *and*/*or* " "operations." msgstr "" -#: ../../../CHANGES.rst:333 +#: ../../../CHANGES.rst:435 msgid "" "Read more in \":ref:`Combining filters `\" " "documentation section `#1018 " "`_" msgstr "" -#: ../../../CHANGES.rst:335 +#: ../../../CHANGES.rst:437 msgid "Added following methods to ``Message`` class:" msgstr "" -#: ../../../CHANGES.rst:337 +#: ../../../CHANGES.rst:439 msgid ":code:`Message.forward(...)`" msgstr "" -#: ../../../CHANGES.rst:338 +#: ../../../CHANGES.rst:440 msgid ":code:`Message.edit_media(...)`" msgstr "" -#: ../../../CHANGES.rst:339 +#: ../../../CHANGES.rst:441 msgid ":code:`Message.edit_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:340 +#: ../../../CHANGES.rst:442 msgid ":code:`Message.stop_live_location(...)`" msgstr "" -#: ../../../CHANGES.rst:341 +#: ../../../CHANGES.rst:443 msgid ":code:`Message.pin(...)`" msgstr "" -#: ../../../CHANGES.rst:342 +#: ../../../CHANGES.rst:444 msgid ":code:`Message.unpin()`" msgstr "" -#: ../../../CHANGES.rst:343 +#: ../../../CHANGES.rst:445 msgid "`#1030 `_" msgstr "" -#: ../../../CHANGES.rst:344 +#: ../../../CHANGES.rst:446 msgid "Added following methods to :code:`User` class:" msgstr "" -#: ../../../CHANGES.rst:346 +#: ../../../CHANGES.rst:448 msgid ":code:`User.mention_markdown(...)`" msgstr "" -#: ../../../CHANGES.rst:347 +#: ../../../CHANGES.rst:449 msgid ":code:`User.mention_html(...)`" msgstr "" -#: ../../../CHANGES.rst:348 +#: ../../../CHANGES.rst:450 msgid "`#1049 `_" msgstr "" -#: ../../../CHANGES.rst:349 +#: ../../../CHANGES.rst:451 msgid "" "Added full support of `Bot API 6.3 `_ `#1057 " "`_" msgstr "" -#: ../../../CHANGES.rst:356 +#: ../../../CHANGES.rst:458 msgid "" "Fixed :code:`Message.send_invoice` and :code:`Message.reply_invoice`, " "added missing arguments `#1047 " "`_" msgstr "" -#: ../../../CHANGES.rst:358 +#: ../../../CHANGES.rst:460 msgid "Fixed copy and forward in:" msgstr "" -#: ../../../CHANGES.rst:360 +#: ../../../CHANGES.rst:462 msgid ":code:`Message.answer(...)`" msgstr "" -#: ../../../CHANGES.rst:361 +#: ../../../CHANGES.rst:463 msgid ":code:`Message.copy_to(...)`" msgstr "" -#: ../../../CHANGES.rst:362 +#: ../../../CHANGES.rst:464 msgid "`#1064 `_" msgstr "" -#: ../../../CHANGES.rst:368 +#: ../../../CHANGES.rst:470 msgid "" "Fixed UA translations in index.po `#1017 " "`_" msgstr "" -#: ../../../CHANGES.rst:370 +#: ../../../CHANGES.rst:472 msgid "" "Fix typehints for :code:`Message`, :code:`reply_media_group` and " ":code:`answer_media_group` methods `#1029 " "`_" msgstr "" -#: ../../../CHANGES.rst:372 +#: ../../../CHANGES.rst:474 msgid "" "Removed an old now non-working feature `#1060 " "`_" msgstr "" -#: ../../../CHANGES.rst:379 +#: ../../../CHANGES.rst:481 msgid "" "Enabled testing on Python 3.11 `#1044 " "`_" msgstr "" -#: ../../../CHANGES.rst:381 +#: ../../../CHANGES.rst:483 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" @@ -734,23 +848,23 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:386 +#: ../../../CHANGES.rst:488 msgid "3.0.0b5 (2022-10-02)" msgstr "" -#: ../../../CHANGES.rst:391 +#: ../../../CHANGES.rst:493 msgid "" "Add PyPy support and run tests under PyPy `#985 " "`_" msgstr "" -#: ../../../CHANGES.rst:393 +#: ../../../CHANGES.rst:495 msgid "" "Added message text to aiogram exceptions representation `#988 " "`_" msgstr "" -#: ../../../CHANGES.rst:395 +#: ../../../CHANGES.rst:497 msgid "" "Added warning about using magic filter from `magic_filter` instead of " "`aiogram`'s ones. Is recommended to use `from aiogram import F` instead " @@ -758,61 +872,61 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:398 +#: ../../../CHANGES.rst:500 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:405 +#: ../../../CHANGES.rst:507 msgid "" "Reworked error event, introduced " ":class:`aiogram.types.error_event.ErrorEvent` object. `#898 " "`_" msgstr "" -#: ../../../CHANGES.rst:407 +#: ../../../CHANGES.rst:509 msgid "" "Fixed escaping markdown in `aiogram.utils.markdown` module `#903 " "`_" msgstr "" -#: ../../../CHANGES.rst:409 +#: ../../../CHANGES.rst:511 msgid "" "Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. " "`#995 `_" msgstr "" -#: ../../../CHANGES.rst:411 +#: ../../../CHANGES.rst:513 msgid "" "Fixed empty mention in command parsing, now it will be None instead of an" " empty string `#1013 `_" msgstr "" -#: ../../../CHANGES.rst:418 +#: ../../../CHANGES.rst:520 msgid "" "Initialized Docs translation (added Ukrainian language) `#925 " "`_" msgstr "" -#: ../../../CHANGES.rst:425 +#: ../../../CHANGES.rst:527 msgid "" "Removed filters factory as described in corresponding issue. `#942 " "`_" msgstr "" -#: ../../../CHANGES.rst:432 +#: ../../../CHANGES.rst:534 msgid "" "Now Router/Dispatcher accepts only keyword arguments. `#982 " "`_" msgstr "" -#: ../../../CHANGES.rst:437 +#: ../../../CHANGES.rst:539 msgid "3.0.0b4 (2022-08-14)" msgstr "" -#: ../../../CHANGES.rst:442 +#: ../../../CHANGES.rst:544 msgid "" "Add class helper ChatAction for constants that Telegram BotAPI uses in " "sendChatAction request. In my opinion, this will help users and will also" @@ -820,198 +934,198 @@ msgid "" "\"ChatActions\". `#803 `_" msgstr "" -#: ../../../CHANGES.rst:446 +#: ../../../CHANGES.rst:548 msgid "Added possibility to combine filters or invert result" msgstr "" -#: ../../../CHANGES.rst:448 +#: ../../../CHANGES.rst:550 msgid "Example:" msgstr "" -#: ../../../CHANGES.rst:456 +#: ../../../CHANGES.rst:558 msgid "`#894 `_" msgstr "" -#: ../../../CHANGES.rst:457 +#: ../../../CHANGES.rst:559 msgid "" "Fixed type hints for redis TTL params. `#922 " "`_" msgstr "" -#: ../../../CHANGES.rst:459 +#: ../../../CHANGES.rst:561 msgid "" "Added `full_name` shortcut for `Chat` object `#929 " "`_" msgstr "" -#: ../../../CHANGES.rst:466 +#: ../../../CHANGES.rst:568 msgid "" "Fixed false-positive coercing of Union types in API methods `#901 " "`_" msgstr "" -#: ../../../CHANGES.rst:468 +#: ../../../CHANGES.rst:570 msgid "Added 3 missing content types:" msgstr "" -#: ../../../CHANGES.rst:470 +#: ../../../CHANGES.rst:572 msgid "proximity_alert_triggered" msgstr "" -#: ../../../CHANGES.rst:471 +#: ../../../CHANGES.rst:573 msgid "supergroup_chat_created" msgstr "" -#: ../../../CHANGES.rst:472 +#: ../../../CHANGES.rst:574 msgid "channel_chat_created" msgstr "" -#: ../../../CHANGES.rst:473 +#: ../../../CHANGES.rst:575 msgid "`#906 `_" msgstr "" -#: ../../../CHANGES.rst:474 +#: ../../../CHANGES.rst:576 msgid "" "Fixed the ability to compare the state, now comparison to copy of the " "state will return `True`. `#927 " "`_" msgstr "" -#: ../../../CHANGES.rst:476 +#: ../../../CHANGES.rst:578 msgid "" "Fixed default lock kwargs in RedisEventIsolation. `#972 " "`_" msgstr "" -#: ../../../CHANGES.rst:483 +#: ../../../CHANGES.rst:585 msgid "" "Restrict including routers with strings `#896 " "`_" msgstr "" -#: ../../../CHANGES.rst:485 +#: ../../../CHANGES.rst:587 msgid "" "Changed CommandPatterType to CommandPatternType in " "`aiogram/dispatcher/filters/command.py` `#907 " "`_" msgstr "" -#: ../../../CHANGES.rst:487 +#: ../../../CHANGES.rst:589 msgid "" "Added full support of `Bot API 6.1 `_ `#936 " "`_" msgstr "" -#: ../../../CHANGES.rst:489 +#: ../../../CHANGES.rst:591 msgid "**Breaking!** More flat project structure" msgstr "" -#: ../../../CHANGES.rst:491 +#: ../../../CHANGES.rst:593 msgid "These packages was moved, imports in your code should be fixed:" msgstr "" -#: ../../../CHANGES.rst:493 +#: ../../../CHANGES.rst:595 msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`" msgstr "" -#: ../../../CHANGES.rst:494 +#: ../../../CHANGES.rst:596 msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`" msgstr "" -#: ../../../CHANGES.rst:495 +#: ../../../CHANGES.rst:597 msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`" msgstr "" -#: ../../../CHANGES.rst:496 +#: ../../../CHANGES.rst:598 msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`" msgstr "" -#: ../../../CHANGES.rst:497 +#: ../../../CHANGES.rst:599 msgid "" ":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` " "(single module instead of package)" msgstr "" -#: ../../../CHANGES.rst:498 +#: ../../../CHANGES.rst:600 msgid "`#938 `_" msgstr "" -#: ../../../CHANGES.rst:499 +#: ../../../CHANGES.rst:601 msgid "" "Removed deprecated :code:`router._handler` and " ":code:`router.register__handler` methods. `#941 " "`_" msgstr "" -#: ../../../CHANGES.rst:501 +#: ../../../CHANGES.rst:603 msgid "" "Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942" " `_" msgstr "" -#: ../../../CHANGES.rst:503 +#: ../../../CHANGES.rst:605 msgid "" "`MessageEntity` method `get_text` was removed and `extract` was renamed " "to `extract_from` `#944 `_" msgstr "" -#: ../../../CHANGES.rst:505 +#: ../../../CHANGES.rst:607 msgid "" "Added full support of `Bot API 6.2 `_ `#975 " "`_" msgstr "" -#: ../../../CHANGES.rst:510 +#: ../../../CHANGES.rst:612 msgid "3.0.0b3 (2022-04-19)" msgstr "" -#: ../../../CHANGES.rst:515 +#: ../../../CHANGES.rst:617 msgid "" "Added possibility to get command magic result as handler argument `#889 " "`_" msgstr "" -#: ../../../CHANGES.rst:517 +#: ../../../CHANGES.rst:619 msgid "" "Added full support of `Telegram Bot API 6.0 " "`_ `#890 " "`_" msgstr "" -#: ../../../CHANGES.rst:524 +#: ../../../CHANGES.rst:626 msgid "" "Fixed I18n lazy-proxy. Disabled caching. `#839 " "`_" msgstr "" -#: ../../../CHANGES.rst:526 +#: ../../../CHANGES.rst:628 msgid "" "Added parsing of spoiler message entity `#865 " "`_" msgstr "" -#: ../../../CHANGES.rst:528 +#: ../../../CHANGES.rst:630 msgid "" "Fixed default `parse_mode` for `Message.copy_to()` method. `#876 " "`_" msgstr "" -#: ../../../CHANGES.rst:530 +#: ../../../CHANGES.rst:632 msgid "" "Fixed CallbackData factory parsing IntEnum's `#885 " "`_" msgstr "" -#: ../../../CHANGES.rst:537 +#: ../../../CHANGES.rst:639 msgid "" "Added automated check that pull-request adds a changes description to " "**CHANGES** directory `#873 " "`_" msgstr "" -#: ../../../CHANGES.rst:539 +#: ../../../CHANGES.rst:641 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" @@ -1019,14 +1133,14 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:542 +#: ../../../CHANGES.rst:644 msgid "" "Used `redis-py` instead of `aioredis` package in due to this packages was" " merged into single one `#882 " "`_" msgstr "" -#: ../../../CHANGES.rst:544 +#: ../../../CHANGES.rst:646 msgid "" "Solved common naming problem with middlewares that confusing too much " "developers - now you can't see the `middleware` and `middlewares` " @@ -1035,113 +1149,113 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:551 +#: ../../../CHANGES.rst:653 msgid "3.0.0b2 (2022-02-19)" msgstr "" -#: ../../../CHANGES.rst:556 +#: ../../../CHANGES.rst:658 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:559 +#: ../../../CHANGES.rst:661 msgid "" "Added possibility to add handler flags via decorator (like `pytest.mark` " "decorator but `aiogram.flags`) `#836 " "`_" msgstr "" -#: ../../../CHANGES.rst:561 +#: ../../../CHANGES.rst:663 msgid "" "Added :code:`ChatActionSender` utility to automatically sends chat action" " while long process is running." msgstr "" -#: ../../../CHANGES.rst:563 +#: ../../../CHANGES.rst:665 msgid "" "It also can be used as message middleware and can be customized via " ":code:`chat_action` flag. `#837 " "`_" msgstr "" -#: ../../../CHANGES.rst:570 +#: ../../../CHANGES.rst:672 msgid "" "Fixed unexpected behavior of sequences in the StateFilter. `#791 " "`_" msgstr "" -#: ../../../CHANGES.rst:572 +#: ../../../CHANGES.rst:674 msgid "" "Fixed exceptions filters `#827 " "`_" msgstr "" -#: ../../../CHANGES.rst:579 +#: ../../../CHANGES.rst:681 msgid "" "Logger name for processing events is changed to :code:`aiogram.events`. " "`#830 `_" msgstr "" -#: ../../../CHANGES.rst:581 +#: ../../../CHANGES.rst:683 msgid "" "Added full support of Telegram Bot API 5.6 and 5.7 `#835 " "`_" msgstr "" -#: ../../../CHANGES.rst:583 +#: ../../../CHANGES.rst:685 msgid "" "**BREAKING** Events isolation mechanism is moved from FSM storages to " "standalone managers `#838 " "`_" msgstr "" -#: ../../../CHANGES.rst:589 +#: ../../../CHANGES.rst:691 msgid "3.0.0b1 (2021-12-12)" msgstr "" -#: ../../../CHANGES.rst:594 +#: ../../../CHANGES.rst:696 msgid "Added new custom operation for MagicFilter named :code:`as_`" msgstr "" -#: ../../../CHANGES.rst:596 +#: ../../../CHANGES.rst:698 msgid "Now you can use it to get magic filter result as handler argument" msgstr "" -#: ../../../CHANGES.rst:612 +#: ../../../CHANGES.rst:714 msgid "`#759 `_" msgstr "" -#: ../../../CHANGES.rst:618 +#: ../../../CHANGES.rst:720 msgid "" "Fixed: Missing :code:`ChatMemberHandler` import in " ":code:`aiogram/dispatcher/handler` `#751 " "`_" msgstr "" -#: ../../../CHANGES.rst:625 +#: ../../../CHANGES.rst:727 msgid "" "Check :code:`destiny` in case of no :code:`with_destiny` enabled in " "RedisStorage key builder `#776 " "`_" msgstr "" -#: ../../../CHANGES.rst:627 +#: ../../../CHANGES.rst:729 msgid "" "Added full support of `Bot API 5.5 `_ `#777 " "`_" msgstr "" -#: ../../../CHANGES.rst:629 +#: ../../../CHANGES.rst:731 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:631 +#: ../../../CHANGES.rst:733 msgid "" "Make TelegramAPIServer files wrapper in local mode bi-directional " "(server-client, client-server) Now you can convert local path to server " @@ -1149,11 +1263,11 @@ msgid "" "`_" msgstr "" -#: ../../../CHANGES.rst:637 +#: ../../../CHANGES.rst:739 msgid "3.0.0a18 (2021-11-10)" msgstr "" -#: ../../../CHANGES.rst:642 +#: ../../../CHANGES.rst:744 msgid "" "Breaking: Changed the signature of the session middlewares Breaking: " "Renamed AiohttpSession.make_request method parameter from call to method " @@ -1161,258 +1275,258 @@ msgid "" "outgoing requests `#716 `_" msgstr "" -#: ../../../CHANGES.rst:646 +#: ../../../CHANGES.rst:748 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:656 +#: ../../../CHANGES.rst:758 msgid "`#717 `_" msgstr "" -#: ../../../CHANGES.rst:657 +#: ../../../CHANGES.rst:759 msgid "" "**Breaking internal API change** Reworked FSM Storage record keys " "propagation `#723 `_" msgstr "" -#: ../../../CHANGES.rst:660 +#: ../../../CHANGES.rst:762 msgid "" "Implemented new filter named :code:`MagicData(magic_data)` that helps to " "filter event by data from middlewares or other filters" msgstr "" -#: ../../../CHANGES.rst:662 +#: ../../../CHANGES.rst:764 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:668 +#: ../../../CHANGES.rst:770 msgid "`#724 `_" msgstr "" -#: ../../../CHANGES.rst:674 +#: ../../../CHANGES.rst:776 msgid "" "Fixed I18n context inside error handlers `#726 " "`_" msgstr "" -#: ../../../CHANGES.rst:676 +#: ../../../CHANGES.rst:778 msgid "" "Fixed bot session closing before emit shutdown `#734 " "`_" msgstr "" -#: ../../../CHANGES.rst:678 +#: ../../../CHANGES.rst:780 msgid "" "Fixed: bound filter resolving does not require children routers `#736 " "`_" msgstr "" -#: ../../../CHANGES.rst:685 +#: ../../../CHANGES.rst:787 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:688 +#: ../../../CHANGES.rst:790 msgid "" "Converted README.md to README.rst and use it as base file for docs `#725 " "`_" msgstr "" -#: ../../../CHANGES.rst:690 +#: ../../../CHANGES.rst:792 msgid "Rework filters resolving:" msgstr "" -#: ../../../CHANGES.rst:692 +#: ../../../CHANGES.rst:794 msgid "Automatically apply Bound Filters with default values to handlers" msgstr "" -#: ../../../CHANGES.rst:693 +#: ../../../CHANGES.rst:795 msgid "Fix data transfer from parent to included routers filters" msgstr "" -#: ../../../CHANGES.rst:694 +#: ../../../CHANGES.rst:796 msgid "`#727 `_" msgstr "" -#: ../../../CHANGES.rst:695 +#: ../../../CHANGES.rst:797 msgid "" "Added full support of Bot API 5.4 https://core.telegram.org/bots/api-" "changelog#november-5-2021 `#744 " "`_" msgstr "" -#: ../../../CHANGES.rst:701 +#: ../../../CHANGES.rst:803 msgid "3.0.0a17 (2021-09-24)" msgstr "" -#: ../../../CHANGES.rst:706 +#: ../../../CHANGES.rst:808 msgid "" "Added :code:`html_text` and :code:`md_text` to Message object `#708 " "`_" msgstr "" -#: ../../../CHANGES.rst:708 +#: ../../../CHANGES.rst:810 msgid "" "Refactored I18n, added context managers for I18n engine and current " "locale `#709 `_" msgstr "" -#: ../../../CHANGES.rst:713 +#: ../../../CHANGES.rst:815 msgid "3.0.0a16 (2021-09-22)" msgstr "" -#: ../../../CHANGES.rst:718 +#: ../../../CHANGES.rst:820 msgid "Added support of local Bot API server files downloading" msgstr "" -#: ../../../CHANGES.rst:720 +#: ../../../CHANGES.rst:822 msgid "" "When Local API is enabled files can be downloaded via " "`bot.download`/`bot.download_file` methods. `#698 " "`_" msgstr "" -#: ../../../CHANGES.rst:722 +#: ../../../CHANGES.rst:824 msgid "" "Implemented I18n & L10n support `#701 " "`_" msgstr "" -#: ../../../CHANGES.rst:729 +#: ../../../CHANGES.rst:831 msgid "" "Covered by tests and docs KeyboardBuilder util `#699 " "`_" msgstr "" -#: ../../../CHANGES.rst:731 +#: ../../../CHANGES.rst:833 msgid "**Breaking!!!**. Refactored and renamed exceptions." msgstr "" -#: ../../../CHANGES.rst:733 +#: ../../../CHANGES.rst:835 msgid "" "Exceptions module was moved from :code:`aiogram.utils.exceptions` to " ":code:`aiogram.exceptions`" msgstr "" -#: ../../../CHANGES.rst:734 +#: ../../../CHANGES.rst:836 msgid "Added prefix `Telegram` for all error classes" msgstr "" -#: ../../../CHANGES.rst:735 +#: ../../../CHANGES.rst:837 msgid "`#700 `_" msgstr "" -#: ../../../CHANGES.rst:736 +#: ../../../CHANGES.rst:838 msgid "" "Replaced all :code:`pragma: no cover` marks via global " ":code:`.coveragerc` config `#702 " "`_" msgstr "" -#: ../../../CHANGES.rst:738 +#: ../../../CHANGES.rst:840 msgid "Updated dependencies." msgstr "" -#: ../../../CHANGES.rst:740 +#: ../../../CHANGES.rst:842 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:746 +#: ../../../CHANGES.rst:848 msgid "3.0.0a15 (2021-09-10)" msgstr "" -#: ../../../CHANGES.rst:751 +#: ../../../CHANGES.rst:853 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:759 +#: ../../../CHANGES.rst:861 msgid "" "Fixed incorrect type checking in the " ":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 " "`_" msgstr "" -#: ../../../CHANGES.rst:766 +#: ../../../CHANGES.rst:868 msgid "" "Disable ContentType filter by default `#668 " "`_" msgstr "" -#: ../../../CHANGES.rst:768 +#: ../../../CHANGES.rst:870 msgid "" "Moved update type detection from Dispatcher to Update object `#669 " "`_" msgstr "" -#: ../../../CHANGES.rst:770 +#: ../../../CHANGES.rst:872 msgid "" "Updated **pre-commit** config `#681 " "`_" msgstr "" -#: ../../../CHANGES.rst:772 +#: ../../../CHANGES.rst:874 msgid "" "Reworked **handlers_in_use** util. Function moved to Router as method " "**.resolve_used_update_types()** `#682 " "`_" msgstr "" -#: ../../../CHANGES.rst:777 +#: ../../../CHANGES.rst:879 msgid "3.0.0a14 (2021-08-17)" msgstr "" -#: ../../../CHANGES.rst:782 +#: ../../../CHANGES.rst:884 msgid "" "add aliases for edit/delete reply markup to Message `#662 " "`_" msgstr "" -#: ../../../CHANGES.rst:784 +#: ../../../CHANGES.rst:886 msgid "" "Reworked outer middleware chain. Prevent to call many times the outer " "middleware for each nested router `#664 " "`_" msgstr "" -#: ../../../CHANGES.rst:791 +#: ../../../CHANGES.rst:893 msgid "" "Prepare parse mode for InputMessageContent in AnswerInlineQuery method " "`#660 `_" msgstr "" -#: ../../../CHANGES.rst:798 +#: ../../../CHANGES.rst:900 msgid "" "Added integration with :code:`towncrier` `#602 " "`_" msgstr "" -#: ../../../CHANGES.rst:805 +#: ../../../CHANGES.rst:907 msgid "" "Added `.editorconfig` `#650 " "`_" msgstr "" -#: ../../../CHANGES.rst:807 +#: ../../../CHANGES.rst:909 msgid "" "Redis storage speedup globals `#651 " "`_" msgstr "" -#: ../../../CHANGES.rst:809 +#: ../../../CHANGES.rst:911 msgid "" "add allow_sending_without_reply param to Message reply aliases `#663 " "`_" @@ -3043,3 +3157,6 @@ msgstr "" #~ msgid "\\ |release| [UNRELEASED DRAFT] (2023-07-30)" #~ msgstr "" + +#~ msgid "\\ |release| [UNRELEASED DRAFT] (2023-08-06)" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/contributing.po b/docs/locale/uk_UA/LC_MESSAGES/contributing.po index 40354edd..7cf1b5d8 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/contributing.po +++ b/docs/locale/uk_UA/LC_MESSAGES/contributing.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -78,112 +78,112 @@ msgstr "" msgid "Activate the environment" msgstr "" -#: ../../contributing.rst:38 -msgid "Linux/ macOS:" +#: ../../contributing.rst:38 ../../contributing.rst:77 +msgid "Linux / macOS:" msgstr "" #: ../../contributing.rst:44 -msgid "Windows PoweShell" +msgid "Windows cmd" msgstr "" #: ../../contributing.rst:50 -msgid "" -"To check it worked, use described command, it should show the :code:`pip`" -" location inside the isolated environment" -msgstr "" - -#: ../../contributing.rst:53 -msgid "Linux, macOS:" -msgstr "" - -#: ../../contributing.rst:59 msgid "Windows PowerShell" msgstr "" -#: ../../contributing.rst:65 +#: ../../contributing.rst:56 msgid "" -"Also make you shure you have the latest pip version in your virtual " +"To check it worked, use described command, it should show the :code:`pip`" +" version and location inside the isolated environment" +msgstr "" + +#: ../../contributing.rst:64 +msgid "" +"Also make sure you have the latest pip version in your virtual " "environment to avoid errors on next steps:" msgstr "" -#: ../../contributing.rst:74 +#: ../../contributing.rst:73 msgid "Setup project" msgstr "" -#: ../../contributing.rst:76 +#: ../../contributing.rst:75 msgid "" "After activating the environment install `aiogram` from sources and their" -" dependencies:" +" dependencies." msgstr "" -#: ../../contributing.rst:82 +#: ../../contributing.rst:83 +msgid "Windows:" +msgstr "" + +#: ../../contributing.rst:89 msgid "" "It will install :code:`aiogram` in editable mode into your virtual " "environment and all dependencies." msgstr "" -#: ../../contributing.rst:85 +#: ../../contributing.rst:92 msgid "Making changes in code" msgstr "" -#: ../../contributing.rst:87 +#: ../../contributing.rst:94 msgid "" "At this point you can make any changes in the code that you want, it can " "be any fixes, implementing new features or experimenting." msgstr "" -#: ../../contributing.rst:92 +#: ../../contributing.rst:99 msgid "Format the code (code-style)" msgstr "" -#: ../../contributing.rst:94 +#: ../../contributing.rst:101 msgid "" "Note that this project is Black-formatted, so you should follow that " "code-style, too be sure You're correctly doing this let's reformat the " "code automatically:" msgstr "" -#: ../../contributing.rst:104 +#: ../../contributing.rst:111 msgid "Run tests" msgstr "" -#: ../../contributing.rst:106 +#: ../../contributing.rst:113 msgid "All changes should be tested:" msgstr "" -#: ../../contributing.rst:112 +#: ../../contributing.rst:119 msgid "" "Also if you are doing something with Redis-storage, you will need to test" " everything works with Redis:" msgstr "" -#: ../../contributing.rst:119 +#: ../../contributing.rst:126 msgid "Docs" msgstr "" -#: ../../contributing.rst:121 +#: ../../contributing.rst:128 msgid "" "We are using `Sphinx` to render docs in different languages, all sources " "located in `docs` directory, you can change the sources and to test it " "you can start live-preview server and look what you are doing:" msgstr "" -#: ../../contributing.rst:130 +#: ../../contributing.rst:137 msgid "Docs translations" msgstr "" -#: ../../contributing.rst:132 +#: ../../contributing.rst:139 msgid "" "Translation of the documentation is very necessary and cannot be done " "without the help of the community from all over the world, so you are " "welcome to translate the documentation into different languages." msgstr "" -#: ../../contributing.rst:136 +#: ../../contributing.rst:143 msgid "Before start, let's up to date all texts:" msgstr "" -#: ../../contributing.rst:144 +#: ../../contributing.rst:151 msgid "" "Change the :code:`` in example below to the target " "language code, after that you can modify texts inside " @@ -192,120 +192,120 @@ msgid "" "example via `poedit `_." msgstr "" -#: ../../contributing.rst:149 +#: ../../contributing.rst:156 msgid "To view results:" msgstr "" -#: ../../contributing.rst:157 +#: ../../contributing.rst:164 msgid "Describe changes" msgstr "" -#: ../../contributing.rst:159 +#: ../../contributing.rst:166 msgid "" "Describe your changes in one or more sentences so that bot developers " "know what's changed in their favorite framework - create " "`..rst` file and write the description." msgstr "" -#: ../../contributing.rst:162 +#: ../../contributing.rst:169 msgid "" ":code:`` is Issue or Pull-request number, after release link to " "this issue will be published to the *Changelog* page." msgstr "" -#: ../../contributing.rst:165 +#: ../../contributing.rst:172 msgid ":code:`` is a changes category marker, it can be one of:" msgstr "" -#: ../../contributing.rst:167 +#: ../../contributing.rst:174 msgid ":code:`feature` - when you are implementing new feature" msgstr "" -#: ../../contributing.rst:168 +#: ../../contributing.rst:175 msgid ":code:`bugfix` - when you fix a bug" msgstr "" -#: ../../contributing.rst:169 +#: ../../contributing.rst:176 msgid ":code:`doc` - when you improve the docs" msgstr "" -#: ../../contributing.rst:170 +#: ../../contributing.rst:177 msgid ":code:`removal` - when you remove something from the framework" msgstr "" -#: ../../contributing.rst:171 +#: ../../contributing.rst:178 msgid "" ":code:`misc` - when changed something inside the Core or project " "configuration" msgstr "" -#: ../../contributing.rst:173 +#: ../../contributing.rst:180 msgid "" "If you have troubles with changing category feel free to ask Core-" "contributors to help with choosing it." msgstr "" -#: ../../contributing.rst:176 +#: ../../contributing.rst:183 msgid "Complete" msgstr "" -#: ../../contributing.rst:178 +#: ../../contributing.rst:185 msgid "" "After you have made all your changes, publish them to the repository and " "create a pull request as mentioned at the beginning of the article and " "wait for a review of these changes." msgstr "" -#: ../../contributing.rst:183 +#: ../../contributing.rst:190 msgid "Star on GitHub" msgstr "" -#: ../../contributing.rst:185 +#: ../../contributing.rst:192 msgid "" "You can \"star\" repository on GitHub - " "https://github.com/aiogram/aiogram (click the star button at the top " "right)" msgstr "" -#: ../../contributing.rst:187 +#: ../../contributing.rst:194 msgid "" "Adding stars makes it easier for other people to find this project and " "understand how useful it is." msgstr "" -#: ../../contributing.rst:190 +#: ../../contributing.rst:197 msgid "Guides" msgstr "" -#: ../../contributing.rst:192 +#: ../../contributing.rst:199 msgid "" "You can write guides how to develop Bots on top of aiogram and publish it" " into YouTube, Medium, GitHub Books, any Courses platform or any other " "platform that you know." msgstr "" -#: ../../contributing.rst:195 +#: ../../contributing.rst:202 msgid "" "This will help more people learn about the framework and learn how to use" " it" msgstr "" -#: ../../contributing.rst:199 +#: ../../contributing.rst:206 msgid "Take answers" msgstr "" -#: ../../contributing.rst:201 +#: ../../contributing.rst:208 msgid "" "The developers is always asks for any question in our chats or any other " "platforms like GitHub Discussions, StackOverflow and others, feel free to" " answer to this questions." msgstr "" -#: ../../contributing.rst:205 +#: ../../contributing.rst:212 msgid "Funding" msgstr "" -#: ../../contributing.rst:207 +#: ../../contributing.rst:214 msgid "" "The development of the project is free and not financed by commercial " "organizations, it is my personal initiative (`@JRootJunior " @@ -313,7 +313,7 @@ msgid "" "project in my free time." msgstr "" -#: ../../contributing.rst:211 +#: ../../contributing.rst:218 msgid "" "So, if you want to financially support the project, or, for example, give" " me a pizza or a beer, you can do it on `OpenCollective " @@ -328,3 +328,31 @@ msgstr "" #~ "`_ or `Patreon " #~ "`_." #~ msgstr "" + +#~ msgid "Linux/ macOS:" +#~ msgstr "" + +#~ msgid "Windows PoweShell" +#~ msgstr "" + +#~ msgid "" +#~ "To check it worked, use described " +#~ "command, it should show the :code:`pip`" +#~ " location inside the isolated environment" +#~ msgstr "" + +#~ msgid "Linux, macOS:" +#~ msgstr "" + +#~ msgid "" +#~ "Also make you shure you have the" +#~ " latest pip version in your virtual" +#~ " environment to avoid errors on next" +#~ " steps:" +#~ msgstr "" + +#~ msgid "" +#~ "After activating the environment install " +#~ "`aiogram` from sources and their " +#~ "dependencies:" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dependency_injection.po b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dependency_injection.po new file mode 100644 index 00000000..b3e158d8 --- /dev/null +++ b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dependency_injection.po @@ -0,0 +1,96 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2023, aiogram Team +# This file is distributed under the same license as the aiogram package. +# FIRST AUTHOR , 2023. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: aiogram \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2023-08-26 23:17+0300\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.12.1\n" + +#: ../../dispatcher/dependency_injection.rst:3 +msgid "Dependency injection" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:5 +msgid "" +"Dependency injection is a programming technique that makes a class " +"independent of its dependencies. It achieves that by decoupling the usage" +" of an object from its creation. This helps you to follow `SOLID's " +"`_ dependency inversion and single " +"responsibility principles." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:12 +msgid "How it works in aiogram" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:14 +msgid "" +"For each update :class:`aiogram.dispatcher.dispatcher.Dispatcher` passes " +"handling context data. Filters and middleware can also make changes to " +"the context." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:17 +msgid "" +"To access contextual data you should specify corresponding keyword " +"parameter in handler or filter. For example, to get " +":class:`aiogram.fsm.context.FSMContext` we do it like that:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:30 +msgid "Injecting own dependencies" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:32 +msgid "Aiogram provides several ways to complement / modify contextual data." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:34 +msgid "" +"The first and easiest way is to simply specify the named arguments in " +":class:`aiogram.dispatcher.dispatcher.Dispatcher` initialization, polling" +" start methods or " +":class:`aiogram.webhook.aiohttp_server.SimpleRequestHandler` " +"initialization if you use webhooks." +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:46 +msgid "Analogy for webhook:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:55 +msgid "" +":class:`aiogram.dispatcher.dispatcher.Dispatcher`'s workflow data also " +"can be supplemented by setting values as in a dictionary:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:63 +msgid "" +"The middlewares updates the context quite often. You can read more about " +"them on this page:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:66 +msgid ":ref:`Middlewares `" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:68 +msgid "The last way is to return a dictionary from the filter:" +msgstr "" + +#: ../../dispatcher/dependency_injection.rst:72 +msgid "" +"...or using :ref:`MagicFilter ` with :code:`.as_(...)` " +"method." +msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po index 7b2707da..099f6e08 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po +++ b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/dispatcher.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: 2022-12-10 19:44+0200\n" "Last-Translator: \n" "Language-Team: \n" @@ -38,12 +38,13 @@ msgstr "" "обробників, фільтрів і т.п. ви можете знайти на наступних сторінках:" #: ../../dispatcher/dispatcher.rst:9 -msgid "`Router `__" +#, fuzzy +msgid ":ref:`Router `" msgstr "`Router `__" #: ../../dispatcher/dispatcher.rst:10 -msgid "`Observer `__" -msgstr "`Observer `__" +msgid ":ref:`Filtering events`" +msgstr "" #: aiogram.dispatcher.dispatcher.Dispatcher:1 #: aiogram.dispatcher.dispatcher.Dispatcher.__init__:1 of @@ -186,3 +187,6 @@ msgstr "" #~ msgid "Poling timeout" #~ msgstr "Час очікування на відповідь" + +#~ msgid "`Observer `__" +#~ msgstr "`Observer `__" diff --git a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/chat_member_updated.po b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/chat_member_updated.po index 6f6d5248..6b144595 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/chat_member_updated.po +++ b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/chat_member_updated.po @@ -5,23 +5,42 @@ # msgid "" msgstr "" -"Project-Id-Version: aiogram\n" +"Project-Id-Version: aiogram\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-01 22:51+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: 2022-10-25 18:00+0300\n" "Last-Translator: \n" "Language-Team: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" -"X-Generator: Poedit 3.1.1\n" +"Generated-By: Babel 2.12.1\n" #: ../../dispatcher/filters/chat_member_updated.rst:3 msgid "ChatMemberUpdated" msgstr "Зміна статусу користувача в чаті" -#: ../../dispatcher/filters/chat_member_updated.rst:10 +#: ../../dispatcher/filters/chat_member_updated.rst:6 +msgid "Usage" +msgstr "Використання" + +#: ../../dispatcher/filters/chat_member_updated.rst:8 +msgid "Handle user leave or join events" +msgstr "Керуйте подіями, які залишають користувачів або приєднуються" + +#: ../../dispatcher/filters/chat_member_updated.rst:20 +msgid "" +"Or construct your own terms via using pre-defined set of statuses and " +"transitions." +msgstr "" +"Або створіть власні умови, використовуючи попередньо визначений набір " +"статусів і переходів." + +#: ../../dispatcher/filters/chat_member_updated.rst:24 +msgid "Explanation" +msgstr "" + +#: ../../dispatcher/filters/chat_member_updated.rst:31 msgid "" "You can import from :code:`aiogram.filters` all available variants of " "`statuses`_, `status groups`_ or `transitions`_:" @@ -29,98 +48,98 @@ msgstr "" "Ви можете імпортувати з :code:`aiogram.filters` усі доступні варіанти " "`statuses`_, `status group`_ або `transitions`_:" -#: ../../dispatcher/filters/chat_member_updated.rst:14 +#: ../../dispatcher/filters/chat_member_updated.rst:35 msgid "Statuses" msgstr "Статуси" -#: ../../dispatcher/filters/chat_member_updated.rst:17 -#: ../../dispatcher/filters/chat_member_updated.rst:42 -#: ../../dispatcher/filters/chat_member_updated.rst:62 +#: ../../dispatcher/filters/chat_member_updated.rst:38 +#: ../../dispatcher/filters/chat_member_updated.rst:63 +#: ../../dispatcher/filters/chat_member_updated.rst:83 msgid "name" msgstr "ім'я" -#: ../../dispatcher/filters/chat_member_updated.rst:17 -#: ../../dispatcher/filters/chat_member_updated.rst:42 -#: ../../dispatcher/filters/chat_member_updated.rst:62 +#: ../../dispatcher/filters/chat_member_updated.rst:38 +#: ../../dispatcher/filters/chat_member_updated.rst:63 +#: ../../dispatcher/filters/chat_member_updated.rst:83 msgid "Description" msgstr "Опис" -#: ../../dispatcher/filters/chat_member_updated.rst:19 +#: ../../dispatcher/filters/chat_member_updated.rst:40 msgid ":code:`CREATOR`" msgstr ":code:`CREATOR`" -#: ../../dispatcher/filters/chat_member_updated.rst:19 +#: ../../dispatcher/filters/chat_member_updated.rst:40 msgid "Chat owner" msgstr "Власник чату" -#: ../../dispatcher/filters/chat_member_updated.rst:21 +#: ../../dispatcher/filters/chat_member_updated.rst:42 msgid ":code:`ADMINISTRATOR`" msgstr ":code:`ADMINISTRATOR`" -#: ../../dispatcher/filters/chat_member_updated.rst:21 +#: ../../dispatcher/filters/chat_member_updated.rst:42 msgid "Chat administrator" msgstr "Адміністратор чату" -#: ../../dispatcher/filters/chat_member_updated.rst:23 +#: ../../dispatcher/filters/chat_member_updated.rst:44 msgid ":code:`MEMBER`" msgstr ":code:`MEMBER`" -#: ../../dispatcher/filters/chat_member_updated.rst:23 +#: ../../dispatcher/filters/chat_member_updated.rst:44 msgid "Member of the chat" msgstr "Учасник чату" -#: ../../dispatcher/filters/chat_member_updated.rst:25 +#: ../../dispatcher/filters/chat_member_updated.rst:46 msgid ":code:`RESTRICTED`" msgstr ":code:`RESTRICTED`" -#: ../../dispatcher/filters/chat_member_updated.rst:25 +#: ../../dispatcher/filters/chat_member_updated.rst:46 msgid "Restricted user (can be not member)" msgstr "Обмежений користувач (може бути не учасником)" -#: ../../dispatcher/filters/chat_member_updated.rst:27 +#: ../../dispatcher/filters/chat_member_updated.rst:48 msgid ":code:`LEFT`" msgstr ":code:`LEFT`" -#: ../../dispatcher/filters/chat_member_updated.rst:27 +#: ../../dispatcher/filters/chat_member_updated.rst:48 msgid "Isn't member of the chat" msgstr "Не є учасником чату" -#: ../../dispatcher/filters/chat_member_updated.rst:29 +#: ../../dispatcher/filters/chat_member_updated.rst:50 msgid ":code:`KICKED`" msgstr ":code:`KICKED`" -#: ../../dispatcher/filters/chat_member_updated.rst:29 +#: ../../dispatcher/filters/chat_member_updated.rst:50 msgid "Kicked member by administrators" msgstr "Вигнанийадміністраторами учасник" -#: ../../dispatcher/filters/chat_member_updated.rst:32 +#: ../../dispatcher/filters/chat_member_updated.rst:53 msgid "" -"Statuses can be extended with `is_member` flag by prefixing with :code:`" -"+` (for :code:`is_member == True)` or :code:`-` (for :code:`is_member == " -"False`) symbol, like :code:`+RESTRICTED` or :code:`-RESTRICTED`" +"Statuses can be extended with `is_member` flag by prefixing with " +":code:`+` (for :code:`is_member == True)` or :code:`-` (for " +":code:`is_member == False`) symbol, like :code:`+RESTRICTED` or " +":code:`-RESTRICTED`" msgstr "" -"Статуси можна розширити маркером `is_member`, додавши префікс :" -"code:`+` (для :code:`is_member == True)` або :code:`-` (для :code:" -"`is_member == False`) , наприклад :code:`+RESTRICTED` або :code:`-" -"RESTRICTED`" +"Статуси можна розширити маркером `is_member`, додавши префікс :code:`+` " +"(для :code:`is_member == True)` або :code:`-` (для :code:`is_member == " +"False`) , наприклад :code:`+RESTRICTED` або :code:`-RESTRICTED`" -#: ../../dispatcher/filters/chat_member_updated.rst:37 +#: ../../dispatcher/filters/chat_member_updated.rst:58 msgid "Status groups" msgstr "Групи статусів" -#: ../../dispatcher/filters/chat_member_updated.rst:39 +#: ../../dispatcher/filters/chat_member_updated.rst:60 msgid "" "The particular statuses can be combined via bitwise :code:`or` operator, " "like :code:`CREATOR | ADMINISTRATOR`" msgstr "" -"Окремі статуси можна комбінувати за допомогою побітового оператора :code:" -"`or`, наприклад :code:`CREATOR | ADMINISTRATOR`" +"Окремі статуси можна комбінувати за допомогою побітового оператора " +":code:`or`, наприклад :code:`CREATOR | ADMINISTRATOR`" -#: ../../dispatcher/filters/chat_member_updated.rst:44 +#: ../../dispatcher/filters/chat_member_updated.rst:65 msgid ":code:`IS_MEMBER`" msgstr ":code:`IS_MEMBER`" -#: ../../dispatcher/filters/chat_member_updated.rst:44 +#: ../../dispatcher/filters/chat_member_updated.rst:65 msgid "" "Combination of :code:`(CREATOR | ADMINISTRATOR | MEMBER | +RESTRICTED)` " "statuses." @@ -128,41 +147,41 @@ msgstr "" "Комбінація статусів :code:`(CREATOR | ADMINISTRATOR | MEMBER | " "+RESTRICTED)`." -#: ../../dispatcher/filters/chat_member_updated.rst:46 +#: ../../dispatcher/filters/chat_member_updated.rst:67 msgid ":code:`IS_ADMIN`" msgstr ":code:`IS_ADMIN`" -#: ../../dispatcher/filters/chat_member_updated.rst:46 +#: ../../dispatcher/filters/chat_member_updated.rst:67 msgid "Combination of :code:`(CREATOR | ADMINISTRATOR)` statuses." msgstr "Комбінація статусів :code:`(CREATOR | ADMINISTRATOR)`." -#: ../../dispatcher/filters/chat_member_updated.rst:48 +#: ../../dispatcher/filters/chat_member_updated.rst:69 msgid ":code:`IS_NOT_MEMBER`" msgstr ":code:`IS_NOT_MEMBER`" -#: ../../dispatcher/filters/chat_member_updated.rst:48 +#: ../../dispatcher/filters/chat_member_updated.rst:69 msgid "Combination of :code:`(LEFT | KICKED | -RESTRICTED)` statuses." msgstr "Комбінація статусів :code:`(LEFT | KICKED | -RESTRICTED)` ." -#: ../../dispatcher/filters/chat_member_updated.rst:52 +#: ../../dispatcher/filters/chat_member_updated.rst:73 msgid "Transitions" msgstr "Переходи" -#: ../../dispatcher/filters/chat_member_updated.rst:54 +#: ../../dispatcher/filters/chat_member_updated.rst:75 msgid "" -"Transitions can be defined via bitwise shift operators :code:`>>` and :" -"code:`<<`. Old chat member status should be defined in the left side " -"for :code:`>>` operator (right side for :code:`<<`) and new status " -"should be specified on the right side for :code:`>>` operator (left side " -"for :code:`<<`)" +"Transitions can be defined via bitwise shift operators :code:`>>` and " +":code:`<<`. Old chat member status should be defined in the left side for" +" :code:`>>` operator (right side for :code:`<<`) and new status should be" +" specified on the right side for :code:`>>` operator (left side for " +":code:`<<`)" msgstr "" -"Переходи можна визначити за допомогою операторів порозрядного зсуву :" -"code:`>>` і :code:`<<`. Старий статус учасника чату має бути визначений " +"Переходи можна визначити за допомогою операторів порозрядного зсуву " +":code:`>>` і :code:`<<`. Старий статус учасника чату має бути визначений " "ліворуч для оператора :code:`>>` (праворуч для :code:`<<`), а новий " -"статус має бути вказаний праворуч для :code:`>>` оператор (ліворуч для :" -"code:`<<`)" +"статус має бути вказаний праворуч для :code:`>>` оператор (ліворуч для " +":code:`<<`)" -#: ../../dispatcher/filters/chat_member_updated.rst:58 +#: ../../dispatcher/filters/chat_member_updated.rst:79 msgid "" "The direction of transition can be changed via bitwise inversion " "operator: :code:`~JOIN_TRANSITION` will produce swap of old and new " @@ -172,45 +191,45 @@ msgstr "" "інверсії: :code:`~JOIN_TRANSITION` призведе до обміну старих і нових " "статусів." -#: ../../dispatcher/filters/chat_member_updated.rst:64 +#: ../../dispatcher/filters/chat_member_updated.rst:85 msgid ":code:`JOIN_TRANSITION`" msgstr ":code:`JOIN_TRANSITION`" -#: ../../dispatcher/filters/chat_member_updated.rst:64 +#: ../../dispatcher/filters/chat_member_updated.rst:85 msgid "" -"Means status changed from :code:`IS_NOT_MEMBER` to :code:`IS_MEMBER` (:" -"code:`IS_NOT_MEMBER >> IS_MEMBER`)" +"Means status changed from :code:`IS_NOT_MEMBER` to :code:`IS_MEMBER` " +"(:code:`IS_NOT_MEMBER >> IS_MEMBER`)" msgstr "" "Означає, що статус змінено з :code:`IS_NOT_MEMBER` на :code:`IS_MEMBER` " "(:code:`IS_NOT_MEMBER >> IS_MEMBER`)" -#: ../../dispatcher/filters/chat_member_updated.rst:67 +#: ../../dispatcher/filters/chat_member_updated.rst:88 msgid ":code:`LEAVE_TRANSITION`" msgstr ":code:`LEAVE_TRANSITION`" -#: ../../dispatcher/filters/chat_member_updated.rst:67 +#: ../../dispatcher/filters/chat_member_updated.rst:88 msgid "" -"Means status changed from :code:`IS_MEMBER` to :code:`IS_NOT_MEMBER` (:" -"code:`~JOIN_TRANSITION`)" +"Means status changed from :code:`IS_MEMBER` to :code:`IS_NOT_MEMBER` " +"(:code:`~JOIN_TRANSITION`)" msgstr "" "Означає, що статус змінено з :code:`IS_MEMBER` на :code:`IS_NOT_MEMBER` " "(:code:`~JOIN_TRANSITION`)" -#: ../../dispatcher/filters/chat_member_updated.rst:70 +#: ../../dispatcher/filters/chat_member_updated.rst:91 msgid ":code:`PROMOTED_TRANSITION`" msgstr ":code:`PROMOTED_TRANSITION`" -#: ../../dispatcher/filters/chat_member_updated.rst:70 +#: ../../dispatcher/filters/chat_member_updated.rst:91 msgid "" -"Means status changed from :code:`(MEMBER | RESTRICTED | LEFT | KICKED) " -">> ADMINISTRATOR` (:code:`(MEMBER | RESTRICTED | LEFT | KICKED) >> " +"Means status changed from :code:`(MEMBER | RESTRICTED | LEFT | KICKED) >>" +" ADMINISTRATOR` (:code:`(MEMBER | RESTRICTED | LEFT | KICKED) >> " "ADMINISTRATOR`)" msgstr "" -"Означає, що статус змінено з :code:`(MEMBER | RESTRICTED | LEFT | " -"KICKED) >> ADMINISTRATOR` (:code:`(MEMBER | RESTRICTED | LEFT | KICKED) " -">> ADMINISTRATOR`)" +"Означає, що статус змінено з :code:`(MEMBER | RESTRICTED | LEFT | KICKED)" +" >> ADMINISTRATOR` (:code:`(MEMBER | RESTRICTED | LEFT | KICKED) >> " +"ADMINISTRATOR`)" -#: ../../dispatcher/filters/chat_member_updated.rst:77 +#: ../../dispatcher/filters/chat_member_updated.rst:98 msgid "" "Note that if you define the status unions (via :code:`|`) you will need " "to add brackets for the statement before use shift operator in due to " @@ -220,34 +239,18 @@ msgstr "" "вам потрібно буде додати дужки для оператора перед використанням " "оператора зсуву через пріоритети оператора." -#: ../../dispatcher/filters/chat_member_updated.rst:81 -msgid "Usage" -msgstr "Використання" - -#: ../../dispatcher/filters/chat_member_updated.rst:83 -msgid "Handle user leave or join events" -msgstr "Керуйте подіями, які залишають користувачів або приєднуються" - -#: ../../dispatcher/filters/chat_member_updated.rst:95 -msgid "" -"Or construct your own terms via using pre-defined set of statuses and " -"transitions." -msgstr "" -"Або створіть власні умови, використовуючи попередньо визначений набір " -"статусів і переходів." - -#: ../../dispatcher/filters/chat_member_updated.rst:98 +#: ../../dispatcher/filters/chat_member_updated.rst:103 msgid "Allowed handlers" msgstr "Дозволені обробники" -#: ../../dispatcher/filters/chat_member_updated.rst:100 +#: ../../dispatcher/filters/chat_member_updated.rst:105 msgid "Allowed update types for this filter:" msgstr "Дозволені типи оновлень для цього фільтра:" -#: ../../dispatcher/filters/chat_member_updated.rst:102 +#: ../../dispatcher/filters/chat_member_updated.rst:107 msgid "`my_chat_member`" msgstr "`my_chat_member`" -#: ../../dispatcher/filters/chat_member_updated.rst:103 +#: ../../dispatcher/filters/chat_member_updated.rst:108 msgid "`chat_member`" msgstr "`chat_member`" diff --git a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/magic_data.po b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/magic_data.po index d62ee41e..5025169e 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/magic_data.po +++ b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/magic_data.po @@ -7,36 +7,24 @@ msgid "" msgstr "" "Project-Id-Version: aiogram\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-10-25 22:10+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: 2022-10-25 16:00+0300\n" "Last-Translator: \n" "Language-Team: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.10.3\n" +"Generated-By: Babel 2.12.1\n" #: ../../dispatcher/filters/magic_data.rst:3 msgid "MagicData" msgstr "MagicData" -#: aiogram.filters.magic_data.MagicData:1 of -msgid "This filter helps to filter event with contextual data" -msgstr "Цей фільтр допомагає фільтрувати події з контекстними даними" - -#: ../../dispatcher/filters/magic_data.rst:10 -msgid "Can be imported:" -msgstr "Можна імпортувати:" - -#: ../../dispatcher/filters/magic_data.rst:12 -msgid ":code:`from aiogram.filters import MagicData`" -msgstr ":code:`from aiogram.filters import MagicData`" - -#: ../../dispatcher/filters/magic_data.rst:15 +#: ../../dispatcher/filters/magic_data.rst:6 msgid "Usage" msgstr "Використання" -#: ../../dispatcher/filters/magic_data.rst:17 +#: ../../dispatcher/filters/magic_data.rst:8 msgid "" ":code:`MagicData(F.event.from_user.id == F.config.admin_id)` (Note that " ":code:`config` should be passed from middleware)" @@ -44,70 +32,86 @@ msgstr "" ":code:`MagicData(F.event.from_user.id == F.config.admin_id)` (Зауважте, " "що :code:`config` слід передати з проміжної програми)" -#: ../../dispatcher/filters/magic_data.rst:21 +#: ../../dispatcher/filters/magic_data.rst:11 +msgid "Explanation" +msgstr "" + +#: aiogram.filters.magic_data.MagicData:1 of +msgid "This filter helps to filter event with contextual data" +msgstr "Цей фільтр допомагає фільтрувати події з контекстними даними" + +#: ../../dispatcher/filters/magic_data.rst:18 +msgid "Can be imported:" +msgstr "Можна імпортувати:" + +#: ../../dispatcher/filters/magic_data.rst:20 +msgid ":code:`from aiogram.filters import MagicData`" +msgstr ":code:`from aiogram.filters import MagicData`" + +#: ../../dispatcher/filters/magic_data.rst:24 msgid "Allowed handlers" msgstr "Дозволені типи обробників (handler)" -#: ../../dispatcher/filters/magic_data.rst:23 +#: ../../dispatcher/filters/magic_data.rst:26 msgid "Allowed update types for this filter:" msgstr "Дозволені типи оновлень для цього фільтра:" -#: ../../dispatcher/filters/magic_data.rst:25 +#: ../../dispatcher/filters/magic_data.rst:28 msgid ":code:`message`" msgstr ":code:`message`" -#: ../../dispatcher/filters/magic_data.rst:26 +#: ../../dispatcher/filters/magic_data.rst:29 msgid ":code:`edited_message`" msgstr ":code:`edited_message`" -#: ../../dispatcher/filters/magic_data.rst:27 +#: ../../dispatcher/filters/magic_data.rst:30 msgid ":code:`channel_post`" msgstr ":code:`channel_post`" -#: ../../dispatcher/filters/magic_data.rst:28 +#: ../../dispatcher/filters/magic_data.rst:31 msgid ":code:`edited_channel_post`" msgstr ":code:`edited_channel_post`" -#: ../../dispatcher/filters/magic_data.rst:29 +#: ../../dispatcher/filters/magic_data.rst:32 msgid ":code:`inline_query`" msgstr ":code:`inline_query`" -#: ../../dispatcher/filters/magic_data.rst:30 +#: ../../dispatcher/filters/magic_data.rst:33 msgid ":code:`chosen_inline_result`" msgstr ":code:`chosen_inline_result`" -#: ../../dispatcher/filters/magic_data.rst:31 +#: ../../dispatcher/filters/magic_data.rst:34 msgid ":code:`callback_query`" msgstr ":code:`callback_query`" -#: ../../dispatcher/filters/magic_data.rst:32 +#: ../../dispatcher/filters/magic_data.rst:35 msgid ":code:`shipping_query`" msgstr ":code:`shipping_query`" -#: ../../dispatcher/filters/magic_data.rst:33 +#: ../../dispatcher/filters/magic_data.rst:36 msgid ":code:`pre_checkout_query`" msgstr ":code:`pre_checkout_query`" -#: ../../dispatcher/filters/magic_data.rst:34 +#: ../../dispatcher/filters/magic_data.rst:37 msgid ":code:`poll`" msgstr ":code:`poll`" -#: ../../dispatcher/filters/magic_data.rst:35 +#: ../../dispatcher/filters/magic_data.rst:38 msgid ":code:`poll_answer`" msgstr ":code:`poll_answer`" -#: ../../dispatcher/filters/magic_data.rst:36 +#: ../../dispatcher/filters/magic_data.rst:39 msgid ":code:`my_chat_member`" msgstr ":code:`my_chat_member`" -#: ../../dispatcher/filters/magic_data.rst:37 +#: ../../dispatcher/filters/magic_data.rst:40 msgid ":code:`chat_member`" msgstr ":code:`chat_member`" -#: ../../dispatcher/filters/magic_data.rst:38 +#: ../../dispatcher/filters/magic_data.rst:41 msgid ":code:`chat_join_request`" msgstr ":code:`chat_join_request`" -#: ../../dispatcher/filters/magic_data.rst:39 +#: ../../dispatcher/filters/magic_data.rst:42 msgid ":code:`error`" msgstr ":code:`error`" diff --git a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po index 74d507c1..6342649a 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po +++ b/docs/locale/uk_UA/LC_MESSAGES/dispatcher/router.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: 2022-12-10 20:41+0200\n" "Last-Translator: \n" "Language-Team: \n" @@ -16,10 +16,15 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.12.1\n" -#: ../../dispatcher/router.rst:3 +#: ../../dispatcher/router.rst:5 msgid "Router" msgstr "Маршрутизатор" +#: ../../dispatcher/router.rst:7 +#, fuzzy +msgid "Usage:" +msgstr "Повідомлення" + #: aiogram.dispatcher.router.Router:1 of msgid "Bases: :py:class:`object`" msgstr "Базується на :py:class:`object`" @@ -91,11 +96,11 @@ msgstr "" msgid "set of registered names" msgstr "" -#: ../../dispatcher/router.rst:13 +#: ../../dispatcher/router.rst:29 msgid "Event observers" msgstr "Обсервери подій" -#: ../../dispatcher/router.rst:17 +#: ../../dispatcher/router.rst:33 msgid "" "All handlers always should be asynchronous. The name of the handler " "function is not important. The event argument name is also not important " @@ -107,7 +112,7 @@ msgstr "" "накладати назву на контекстні дані, оскільки функція не може прийняти два" " аргументи з однаковою назвою." -#: ../../dispatcher/router.rst:20 +#: ../../dispatcher/router.rst:36 msgid "" "Here is the list of available observers and examples of how to register " "handlers" @@ -115,7 +120,7 @@ msgstr "" "Ось список доступних обсерверів і приклади того, як зареєструвати " "обробники" -#: ../../dispatcher/router.rst:22 +#: ../../dispatcher/router.rst:38 msgid "" "In these examples only decorator-style registering handlers are used, but" " if you don't like @decorators just use :obj:`.register(...)`" @@ -125,15 +130,15 @@ msgstr "" "декоратора, але якщо вам не подобаються @decorators, просто " "використовуйте :obj:`.register(...)` method instead." -#: ../../dispatcher/router.rst:25 +#: ../../dispatcher/router.rst:41 msgid "Message" msgstr "Повідомлення" -#: ../../dispatcher/router.rst:30 +#: ../../dispatcher/router.rst:46 msgid "Be attentive with filtering this event" msgstr "Будьте уважні при фільтруванні цієї події" -#: ../../dispatcher/router.rst:32 +#: ../../dispatcher/router.rst:48 msgid "" "You should expect that this event can be with different sets of " "attributes in different cases" @@ -141,13 +146,13 @@ msgstr "" "Вам слід очікувати, що ця подія може мати різні набори атрибутів у різних" " випадках" -#: ../../dispatcher/router.rst:34 +#: ../../dispatcher/router.rst:50 msgid "" "(For example text, sticker and document are always of different content " "types of message)" msgstr "(Наприклад, текст, стікер та документ завжди мають різні типи вмісту)" -#: ../../dispatcher/router.rst:36 +#: ../../dispatcher/router.rst:52 msgid "" "Recommended way to check field availability before usage, for example via" " :ref:`magic filter `: :code:`F.text` to handle text, " @@ -158,62 +163,62 @@ msgstr "" ":code:`F.text` для обробки тексту, :code:`F.sticker` для обробки лише " "стікерів і тощо." -#: ../../dispatcher/router.rst:47 +#: ../../dispatcher/router.rst:63 msgid "Edited message" msgstr "Відредаговане повідомлення" -#: ../../dispatcher/router.rst:55 +#: ../../dispatcher/router.rst:71 msgid "Channel post" msgstr "Пост на каналі" -#: ../../dispatcher/router.rst:63 +#: ../../dispatcher/router.rst:79 msgid "Edited channel post" msgstr "Відредагований пост на каналі" -#: ../../dispatcher/router.rst:72 +#: ../../dispatcher/router.rst:88 msgid "Inline query" msgstr "Inline запит" -#: ../../dispatcher/router.rst:80 +#: ../../dispatcher/router.rst:96 msgid "Chosen inline query" msgstr "Вибраний результат inline запиту" -#: ../../dispatcher/router.rst:88 +#: ../../dispatcher/router.rst:104 msgid "Callback query" msgstr "Запит зворотної відповіді" -#: ../../dispatcher/router.rst:96 +#: ../../dispatcher/router.rst:112 msgid "Shipping query" msgstr "Запит підтвердження доставки" -#: ../../dispatcher/router.rst:104 +#: ../../dispatcher/router.rst:120 msgid "Pre checkout query" msgstr "Запит перед оформленням замовлення" -#: ../../dispatcher/router.rst:112 +#: ../../dispatcher/router.rst:128 msgid "Poll" msgstr "Опитування" -#: ../../dispatcher/router.rst:120 +#: ../../dispatcher/router.rst:136 msgid "Poll answer" msgstr "Відповідь на опитування" -#: ../../dispatcher/router.rst:128 +#: ../../dispatcher/router.rst:144 msgid "Errors" msgstr "Помилки" -#: ../../dispatcher/router.rst:135 +#: ../../dispatcher/router.rst:151 #, fuzzy msgid "" "Is useful for handling errors from other handlers, error event described " ":ref:`here `" msgstr "Корисно для обробки помилок інших обробників" -#: ../../dispatcher/router.rst:142 +#: ../../dispatcher/router.rst:158 msgid "Nested routers" msgstr "Вкладені маршрутизатори" -#: ../../dispatcher/router.rst:147 +#: ../../dispatcher/router.rst:163 msgid "" "Routers by the way can be nested to an another routers with some " "limitations:" @@ -221,7 +226,7 @@ msgstr "" "До речі, маршрутизатори можуть бути вкладеними в інші маршрутизатори з " "деякими обмеженнями:" -#: ../../dispatcher/router.rst:147 +#: ../../dispatcher/router.rst:163 msgid "" "1. Router **CAN NOT** include itself 1. Routers **CAN NOT** be used for " "circular including (router 1 include router 2, router 2 include router 3," @@ -232,39 +237,39 @@ msgstr "" "(маршрутизатор 1 включає маршрутизатор 2, маршрутизатор 2 включає " "маршрутизатор 3, маршрутизатор 3 включає маршрутизатор 1)" -#: ../../dispatcher/router.rst:151 +#: ../../dispatcher/router.rst:167 msgid "Example:" msgstr "Приклад:" -#: ../../dispatcher/router.rst:153 +#: ../../dispatcher/router.rst:169 #, fuzzy msgid "module_1.py" msgstr "module_2.py" -#: ../../dispatcher/router.rst:163 +#: ../../dispatcher/router.rst:179 msgid "module_2.py" msgstr "module_2.py" -#: ../../dispatcher/router.rst:175 +#: ../../dispatcher/router.rst:191 msgid "Update" msgstr "Оновлення" -#: ../../dispatcher/router.rst:184 +#: ../../dispatcher/router.rst:200 msgid "The only root Router (Dispatcher) can handle this type of event." msgstr "" -#: ../../dispatcher/router.rst:188 +#: ../../dispatcher/router.rst:204 msgid "" "Dispatcher already has default handler for this event type, so you can " "use it for handling all updates that are not handled by any other " "handlers." msgstr "" -#: ../../dispatcher/router.rst:191 +#: ../../dispatcher/router.rst:207 msgid "How it works?" msgstr "Як це працює?" -#: ../../dispatcher/router.rst:193 +#: ../../dispatcher/router.rst:209 msgid "" "For example, dispatcher has 2 routers, the last router also has one " "nested router:" @@ -276,7 +281,7 @@ msgstr "" msgid "Nested routers example" msgstr "Приклад вкладених маршрутизаторів" -#: ../../dispatcher/router.rst:198 +#: ../../dispatcher/router.rst:214 msgid "In this case update propagation flow will have form:" msgstr "У цьому випадку потік розповсюдження оновлення матиме вигляд:" diff --git a/docs/locale/uk_UA/LC_MESSAGES/index.po b/docs/locale/uk_UA/LC_MESSAGES/index.po index 5ad3333e..d6003bba 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/index.po +++ b/docs/locale/uk_UA/LC_MESSAGES/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,17 +18,9 @@ msgstr "" "Generated-By: Babel 2.12.1\n" #: ../../../README.rst:3 -msgid "aiogram |beta badge|" +msgid "aiogram" msgstr "" -#: ../../../README.rst:94 -msgid "Beta badge" -msgstr "" - -#: ../../../README.rst:6 -msgid "This version is still in development!" -msgstr "Ще в розробці!" - #: ../../../README.rst:-1 msgid "MIT License" msgstr "" @@ -61,7 +53,7 @@ msgstr "Тести" msgid "Codecov" msgstr "" -#: ../../../README.rst:40 +#: ../../../README.rst:37 msgid "" "**aiogram** is a modern and fully asynchronous framework for `Telegram " "Bot API `_ written in Python 3.8 " @@ -74,39 +66,27 @@ msgstr "" "`_ та `aiohttp " "`_." -#: ../../../README.rst:45 +#: ../../../README.rst:42 msgid "Make your bots faster and more powerful!" msgstr "Зробіть своїх ботів швидшими та потужнішими!" -#: ../../../README.rst:50 +#: ../../../README.rst:47 msgid "Documentation:" msgstr "Документація" -#: ../../../README.rst:48 +#: ../../../README.rst:45 msgid "🇺🇸 `English `_" msgstr "🇺🇸 `English `_" -#: ../../../README.rst:49 +#: ../../../README.rst:46 msgid "🇺🇦 `Ukrainian `_" msgstr "🇺🇦 `Українською `_" -#: ../../../README.rst:54 -msgid "**Breaking News:**" -msgstr "**Важливі новини**" - -#: ../../../README.rst:56 -msgid "*aiogram* 3.0 has breaking changes." -msgstr "*aiogram* 3.0 має зміни, що ламають зворотну сумісність." - -#: ../../../README.rst:58 -msgid "It breaks backward compatibility by introducing new breaking changes!" -msgstr "Порушує зворотну сумісність, вводячи нові критичні зміни!" - -#: ../../../README.rst:61 +#: ../../../README.rst:50 msgid "Features" msgstr "Особливості" -#: ../../../README.rst:63 +#: ../../../README.rst:52 msgid "" "Asynchronous (`asyncio docs " "`_, :pep:`492`)" @@ -114,7 +94,7 @@ msgstr "" "Асинхронність (`asyncio docs " "`_, :pep:`492`)" -#: ../../../README.rst:64 +#: ../../../README.rst:53 msgid "" "Has type hints (:pep:`484`) and can be used with `mypy `_" @@ -122,20 +102,20 @@ msgstr "" "Має анотації типів (:pep:`484`) та може використовуватись з `mypy `_" -#: ../../../README.rst:65 +#: ../../../README.rst:54 msgid "Supports `PyPy `_" msgstr "Працює з `PyPy `_" -#: ../../../README.rst:66 +#: ../../../README.rst:55 #, fuzzy msgid "" -"Supports `Telegram Bot API 6.7 `_ and" +"Supports `Telegram Bot API 6.8 `_ and" " gets fast updates to the latest versions of the Bot API" msgstr "" "Підтримує `Telegram Bot API 6.3 `_ та" " швидко отримує оновлення до нових версії АПІ" -#: ../../../README.rst:67 +#: ../../../README.rst:56 msgid "" "Telegram Bot API integration code was `autogenerated " "`_ and can be easily re-generated " @@ -145,28 +125,28 @@ msgstr "" "/tg-codegen>`_ що надає змогу дуже легко оновлювати фреймворк до останніх" " версій АПІ" -#: ../../../README.rst:68 +#: ../../../README.rst:57 msgid "Updates router (Blueprints)" msgstr "Має роутери подій (Blueprints)" -#: ../../../README.rst:69 +#: ../../../README.rst:58 msgid "Has Finite State Machine" msgstr "Має вбудований кінцевий автомат" -#: ../../../README.rst:70 +#: ../../../README.rst:59 msgid "" "Uses powerful `magic filters " -"`" +"`_" msgstr "" -#: ../../../README.rst:71 +#: ../../../README.rst:60 msgid "Middlewares (incoming updates and API calls)" msgstr "" "Підтримує мідлвари (для вхідних подій від АПІ та для вихідних запитів до " "АПІ)" -#: ../../../README.rst:72 +#: ../../../README.rst:61 msgid "" "Provides `Replies into Webhook `_" @@ -175,13 +155,13 @@ msgstr "" "`_" -#: ../../../README.rst:73 +#: ../../../README.rst:62 msgid "Integrated I18n/L10n support with GNU Gettext (or Fluent)" msgstr "" "Має вбудовану інтеграцію для використання інтернаціоналізації та " "локалізації GNU Gettext (або Fluent)" -#: ../../../README.rst:78 +#: ../../../README.rst:67 msgid "" "It is strongly advised that you have prior experience working with " "`asyncio `_ before " @@ -191,39 +171,39 @@ msgstr "" "починати використовувати цей фреймворк. `asyncio " "`_" -#: ../../../README.rst:82 +#: ../../../README.rst:71 msgid "If you have any questions, you can visit our community chats on Telegram:" msgstr "Якщо є якість додаткові запитання, ласкаво просимо до онлайн-спільнот:" -#: ../../../README.rst:84 +#: ../../../README.rst:73 msgid "🇺🇸 `@aiogram `_" msgstr "" -#: ../../../README.rst:85 +#: ../../../README.rst:74 msgid "🇺🇦 `@aiogramua `_" msgstr "" -#: ../../../README.rst:86 +#: ../../../README.rst:75 msgid "🇺🇿 `@aiogram_uz `_" msgstr "" -#: ../../../README.rst:87 +#: ../../../README.rst:76 msgid "🇰🇿 `@aiogram_kz `_" msgstr "" -#: ../../../README.rst:88 +#: ../../../README.rst:77 msgid "🇷🇺 `@aiogram_ru `_" msgstr "💩 `@aiogram_ru `_" -#: ../../../README.rst:89 +#: ../../../README.rst:78 msgid "🇮🇷 `@aiogram_fa `_" msgstr "" -#: ../../../README.rst:90 +#: ../../../README.rst:79 msgid "🇮🇹 `@aiogram_it `_" msgstr "" -#: ../../../README.rst:91 +#: ../../../README.rst:80 msgid "🇧🇷 `@aiogram_br `_" msgstr "" @@ -237,3 +217,27 @@ msgstr "Зміст" #~ msgid "[Telegram] aiogram live" #~ msgstr "" + +#~ msgid "aiogram |beta badge|" +#~ msgstr "" + +#~ msgid "Beta badge" +#~ msgstr "" + +#~ msgid "This version is still in development!" +#~ msgstr "Ще в розробці!" + +#~ msgid "**Breaking News:**" +#~ msgstr "**Важливі новини**" + +#~ msgid "*aiogram* 3.0 has breaking changes." +#~ msgstr "*aiogram* 3.0 має зміни, що ламають зворотну сумісність." + +#~ msgid "It breaks backward compatibility by introducing new breaking changes!" +#~ msgstr "Порушує зворотну сумісність, вводячи нові критичні зміни!" + +#~ msgid "" +#~ "Uses powerful `magic filters " +#~ "`" +#~ msgstr "" diff --git a/docs/locale/uk_UA/LC_MESSAGES/migration_2_to_3.po b/docs/locale/uk_UA/LC_MESSAGES/migration_2_to_3.po index 9035b8b8..3541ffff 100644 --- a/docs/locale/uk_UA/LC_MESSAGES/migration_2_to_3.po +++ b/docs/locale/uk_UA/LC_MESSAGES/migration_2_to_3.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: aiogram \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-07-30 18:31+0300\n" +"POT-Creation-Date: 2023-08-26 23:17+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -99,17 +99,24 @@ msgid "" "accessed via :code:`data[\"bot\"]`." msgstr "" -#: ../../migration_2_to_3.rst:46 +#: ../../migration_2_to_3.rst:43 +msgid "" +"Now to skip pending updates, you should call the " +":class:`aiogram.methods.delete_webhook.DeleteWebhook` method directly " +"instead of passing :code:`skip_updates=True` to start polling method." +msgstr "" + +#: ../../migration_2_to_3.rst:47 msgid "Filtering events" msgstr "" -#: ../../migration_2_to_3.rst:48 +#: ../../migration_2_to_3.rst:49 msgid "" "Keyword filters can no more be used, use filters explicitly. (`Read more " "» `_)" msgstr "" -#: ../../migration_2_to_3.rst:49 +#: ../../migration_2_to_3.rst:50 msgid "" "In due to keyword filters was removed all enabled by default filters " "(state and content_type now is not enabled), so you should specify them " @@ -118,19 +125,19 @@ msgid "" "use :code:`@router.message(F.photo)`" msgstr "" -#: ../../migration_2_to_3.rst:53 +#: ../../migration_2_to_3.rst:54 msgid "" "Most of common filters is replaced by \"magic filter\". (:ref:`Read more " "» `)" msgstr "" -#: ../../migration_2_to_3.rst:54 +#: ../../migration_2_to_3.rst:55 msgid "" "Now by default message handler receives any content type, if you want " "specific one just add the filters (Magic or any other)" msgstr "" -#: ../../migration_2_to_3.rst:56 +#: ../../migration_2_to_3.rst:57 msgid "" "State filter now is not enabled by default, that's mean if you using " ":code:`state=\"*\"` in v2 then you should not pass any state filter in " @@ -138,38 +145,38 @@ msgid "" "specify the state." msgstr "" -#: ../../migration_2_to_3.rst:59 +#: ../../migration_2_to_3.rst:60 msgid "" "Added possibility to register per-router global filters, that helps to " "reduces the number of repetitions in the code and makes easily way to " "control for what each router will be used." msgstr "" -#: ../../migration_2_to_3.rst:65 +#: ../../migration_2_to_3.rst:66 msgid "Bot API" msgstr "" -#: ../../migration_2_to_3.rst:67 +#: ../../migration_2_to_3.rst:68 msgid "" "Now all API methods is classes with validation (via `pydantic " "`_) (all API calls is also available as " "methods in the Bot class)." msgstr "" -#: ../../migration_2_to_3.rst:69 +#: ../../migration_2_to_3.rst:70 msgid "" "Added more pre-defined Enums and moved into `aiogram.enums` sub-package. " "For example chat type enum now is :class:`aiogram.enums.ChatType` instead" " of :class:`aiogram.types.chat.ChatType`. (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:72 +#: ../../migration_2_to_3.rst:73 msgid "" "Separated HTTP client session into container that can be reused between " "different Bot instances in the application." msgstr "" -#: ../../migration_2_to_3.rst:74 +#: ../../migration_2_to_3.rst:75 msgid "" "API Exceptions is no more classified by specific message in due to " "Telegram has no documented error codes. But all errors is classified by " @@ -179,17 +186,17 @@ msgid "" "types>`)" msgstr "" -#: ../../migration_2_to_3.rst:81 +#: ../../migration_2_to_3.rst:82 msgid "Middlewares" msgstr "" -#: ../../migration_2_to_3.rst:83 +#: ../../migration_2_to_3.rst:84 msgid "" "Middlewares can now control a execution context, e.g. using context " "managers (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:84 +#: ../../migration_2_to_3.rst:85 msgid "" "All contextual data now is shared between middlewares, filters and " "handlers to end-to-end use. For example now you can easily pass some data" @@ -197,75 +204,102 @@ msgid "" "same way as in the handlers via keyword arguments." msgstr "" -#: ../../migration_2_to_3.rst:87 +#: ../../migration_2_to_3.rst:88 msgid "" "Added mechanism named **flags**, that helps to customize handler behavior" " in conjunction with middlewares. (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:92 +#: ../../migration_2_to_3.rst:93 msgid "Keyboard Markup" msgstr "" -#: ../../migration_2_to_3.rst:94 +#: ../../migration_2_to_3.rst:95 msgid "" "Now :class:`aiogram.types.inline_keyboard_markup.InlineKeyboardMarkup` " "and :class:`aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup` has " "no methods to extend it, instead you have to use markup builders " ":class:`aiogram.utils.keyboard.ReplyKeyboardBuilder` and " ":class:`aiogram.utils.keyboard.KeyboardBuilder` respectively (:ref:`Read " -"more » `)" +"more » `)" msgstr "" -#: ../../migration_2_to_3.rst:102 +#: ../../migration_2_to_3.rst:103 msgid "Callbacks data" msgstr "" -#: ../../migration_2_to_3.rst:104 +#: ../../migration_2_to_3.rst:105 msgid "" "Callback data factory now is strictly typed via `pydantic " -"`_ models (:ref:`Read more » `_ models (:ref:`Read more » `)" msgstr "" -#: ../../migration_2_to_3.rst:109 +#: ../../migration_2_to_3.rst:110 msgid "Finite State machine" msgstr "" -#: ../../migration_2_to_3.rst:111 +#: ../../migration_2_to_3.rst:112 msgid "" "State filter will no more added to all handlers, you will need to specify" " state if you want" msgstr "" -#: ../../migration_2_to_3.rst:112 +#: ../../migration_2_to_3.rst:113 msgid "" "Added possibility to change FSM strategy, for example if you want to " "control state for each user in chat topics instead of user in chat you " "can specify it in the Dispatcher." msgstr "" -#: ../../migration_2_to_3.rst:117 +#: ../../migration_2_to_3.rst:115 +msgid "" +"Now :class:`aiogram.fsm.state.State` and " +":class:`aiogram.fsm.state.StateGroup` don't have helper methods like " +":code:`.set()`, :code:`.next()`, etc." +msgstr "" + +#: ../../migration_2_to_3.rst:118 +msgid "" +"Instead of this you should set states by passing them directly to " +":class:`aiogram.fsm.context.FSMContext` (:ref:`Read more » `)" +msgstr "" + +#: ../../migration_2_to_3.rst:120 +msgid "" +"State proxy is deprecated, you should update the state data by calling " +":code:`state.set_data(...)` and :code:`state.get_data()` respectively." +msgstr "" + +#: ../../migration_2_to_3.rst:125 msgid "Sending Files" msgstr "" -#: ../../migration_2_to_3.rst:119 +#: ../../migration_2_to_3.rst:127 msgid "" "From now you should wrap sending files into InputFile object before send " "instead of passing IO object directly to the API method. (:ref:`Read more" " » `)" msgstr "" -#: ../../migration_2_to_3.rst:124 +#: ../../migration_2_to_3.rst:132 msgid "Webhook" msgstr "" -#: ../../migration_2_to_3.rst:126 +#: ../../migration_2_to_3.rst:134 msgid "Simplified aiohttp web app configuration" msgstr "" -#: ../../migration_2_to_3.rst:127 +#: ../../migration_2_to_3.rst:135 msgid "" "By default added possibility to upload files when you use reply into " "webhook" msgstr "" + +#~ msgid "" +#~ "Callback data factory now is strictly" +#~ " typed via `pydantic " +#~ "`_ models (:ref:`Read " +#~ "more » `)" +#~ msgstr "" diff --git a/docs/migration_2_to_3.rst b/docs/migration_2_to_3.rst index 8a42fa5e..80910f84 100644 --- a/docs/migration_2_to_3.rst +++ b/docs/migration_2_to_3.rst @@ -96,14 +96,14 @@ Keyboard Markup and :class:`aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup` has no methods to extend it, instead you have to use markup builders :class:`aiogram.utils.keyboard.ReplyKeyboardBuilder` and :class:`aiogram.utils.keyboard.KeyboardBuilder` respectively - (:ref:`Read more » `) + (:ref:`Read more » `) Callbacks data ============== - Callback data factory now is strictly typed via `pydantic `_ models - (:ref:`Read more » `) + (:ref:`Read more » `) Finite State machine diff --git a/docs/utils/keyboard.rst b/docs/utils/keyboard.rst index 35559fc0..6f631ae6 100644 --- a/docs/utils/keyboard.rst +++ b/docs/utils/keyboard.rst @@ -1,4 +1,5 @@ -.. _keyboard-builder +.. _Keyboard builder: + ================ Keyboard builder ================