Update documentation and code snippets

This commit is contained in:
2025-12-02 22:59:58 +03:00
parent e6645730f0
commit 2800a7ffc2
30 changed files with 1494 additions and 3962 deletions
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-11-03 19:01+0300\n"
"POT-Creation-Date: 2025-12-02 22:27+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: en\n"
@@ -25,77 +25,66 @@ msgstr ""
#: ../../root/api/command/flags.rst:6
msgid ""
"`Flags` — это коллекция флагов команды. Её основная задача — группировать"
" и управлять набором флагов, зарегистрированных для конкретной команды. "
"`Flags` служит контейнером, который позволяет удобно добавлять, "
"извлекать, итерировать флаги и проверять их наличие."
"``Flags`` — это коллекция флагов команды. Её основная задача — "
"группировать и управлять набором флагов, зарегистрированных для "
"конкретной команды. ``Flags`` служит контейнером, который позволяет "
"удобно добавлять, извлекать, итерировать флаги и проверять их наличие."
msgstr ""
#: ../../root/api/command/flags.rst:8
msgid ""
"`Flags` наследуется от базового класса `BaseFlags` и специализируется на "
"работе с объектами типа `Flag`. Этот класс используется при создании "
"команд с несколькими флагами и предоставляет интерфейс для управления "
"ими."
msgstr ""
#: ../../root/api/command/flags.rst:12
#: ../../root/api/command/flags.rst:10
msgid ""
"Документация по отдельным флагам (:ref:`Flag <root_api_command_flag>`, "
":ref:`InputFlag <root_api_command_input_flag>`)"
msgstr ""
#: ../../root/api/command/flags.rst:14
#: ../../root/api/command/flags.rst:12
msgid ""
"Документация по :ref:`InputFlags <root_api_command_input_flags>` — "
"коллекция обработанных флагов, введённых пользователем."
msgstr ""
#: ../../root/api/command/flags.rst:16
#: ../../root/api/command/flags.rst:14
msgid ""
":ref:`Общая информация <root_flags>` о флагах и их использовании в "
"приложении ``Argenta``"
msgstr ""
#: ../../root/api/command/flags.rst:21
#: ../../root/api/command/flags.rst:19
msgid "Инициализация"
msgstr ""
#: ../../root/api/command/flags.rst:28
#: ../../root/api/command/flags.rst:26
msgid "Создаёт новую коллекцию флагов."
msgstr ""
#: ../../root/api/command/flags.rst:30
#: ../../root/api/command/flags.rst:28
msgid ""
"``flags``: Необязательный список флагов типа `Flag` для инициализации "
"``flags``: Необязательный список флагов типа ``Flag`` для инициализации "
"коллекции. Если не указан, создаётся пустая коллекция."
msgstr ""
#: ../../root/api/command/flags.rst:32
#: ../../root/api/command/flags.rst:30
msgid "**Атрибуты:**"
msgstr ""
#: ../../root/api/command/flags.rst:37
msgid ""
"Список всех зарегистрированных флагов типа `Flag`. Пуст, если флаги не "
"были переданы при инициализации."
#: ../../root/api/command/flags.rst:35
msgid "Список всех зарегистрированных флагов типа ``Flag``."
msgstr ""
#: ../../root/api/command/flags.rst:39 ../../root/api/command/flags.rst:65
#: ../../root/api/command/flags.rst:88 ../../root/api/command/flags.rst:111
#: ../../root/api/command/flags.rst:134 ../../root/api/command/flags.rst:155
#: ../../root/api/command/flags.rst:37 ../../root/api/command/flags.rst:63
#: ../../root/api/command/flags.rst:86 ../../root/api/command/flags.rst:109
msgid "**Пример использования:**"
msgstr ""
#: ../../root/api/command/flags.rst:48
#: ../../root/api/command/flags.rst:46
msgid "Методы"
msgstr ""
#: ../../root/api/command/flags.rst:51
#: ../../root/api/command/flags.rst:49
msgid "add_flag"
msgstr ""
#: ../../root/api/command/flags.rst:58
#: ../../root/api/command/flags.rst:56
msgid "Добавляет флаг в коллекцию."
msgstr ""
@@ -103,29 +92,27 @@ msgstr ""
msgid "param flag"
msgstr ""
#: ../../root/api/command/flags.rst:60
msgid "Флаг типа `Flag` для добавления."
#: ../../root/api/command/flags.rst:58
msgid "Флаг типа ``Flag`` для добавления."
msgstr ""
#: ../../root/api/command/flags.rst
msgid "return"
msgstr ""
#: ../../root/api/command/flags.rst:61 ../../root/api/command/flags.rst:84
#: ../../root/api/command/flags.rst:59 ../../root/api/command/flags.rst:82
msgid "None."
msgstr ""
#: ../../root/api/command/flags.rst:63
msgid ""
"Метод добавляет флаг в конец списка `flags`. Используется для "
"динамического расширения набора флагов."
#: ../../root/api/command/flags.rst:61
msgid "Используется для динамического расширения набора флагов."
msgstr ""
#: ../../root/api/command/flags.rst:74
#: ../../root/api/command/flags.rst:72
msgid "add_flags"
msgstr ""
#: ../../root/api/command/flags.rst:81
#: ../../root/api/command/flags.rst:79
msgid "Добавляет в коллекцию список флагов."
msgstr ""
@@ -133,21 +120,21 @@ msgstr ""
msgid "param flags"
msgstr ""
#: ../../root/api/command/flags.rst:83
msgid "Список флагов типа `Flag` для добавления."
#: ../../root/api/command/flags.rst:81
msgid "Список флагов типа ``Flag`` для добавления."
msgstr ""
#: ../../root/api/command/flags.rst:86
#: ../../root/api/command/flags.rst:84
msgid ""
"Метод расширяет коллекцию, добавляя в неё все флаги из переданного "
"списка. Эффективен для пакетного добавления."
msgstr ""
#: ../../root/api/command/flags.rst:97
#: ../../root/api/command/flags.rst:95
msgid "get_flag_by_name"
msgstr ""
#: ../../root/api/command/flags.rst:104
#: ../../root/api/command/flags.rst:102
msgid "Возвращает флаг по имени."
msgstr ""
@@ -155,62 +142,17 @@ msgstr ""
msgid "param name"
msgstr ""
#: ../../root/api/command/flags.rst:106
#: ../../root/api/command/flags.rst:104
msgid "Имя искомого флага."
msgstr ""
#: ../../root/api/command/flags.rst:105
msgid "Объект ``Flag`` или ``None``, если флаг не найден."
msgstr ""
#: ../../root/api/command/flags.rst:107
msgid "Объект `Flag` или `None`, если флаг не найден."
msgstr ""
#: ../../root/api/command/flags.rst:109
msgid ""
"Метод выполняет поиск по списку `flags` и возвращает первый флаг с "
"соответствующим именем. Если флаг не найден, возвращается `None`."
"Метод возвращает флаг с соответствующим именем. Если флаг не найден, "
"возвращается ``None``."
msgstr ""
#: ../../root/api/command/flags.rst:120
msgid "Магические методы"
msgstr ""
#: ../../root/api/command/flags.rst:123
msgid "__iter__"
msgstr ""
#: ../../root/api/command/flags.rst:130
msgid "Делает коллекцию итерируемой для использования в циклах."
msgstr ""
#: ../../root/api/command/flags.rst:132
msgid "Итератор по списку флагов."
msgstr ""
#: ../../root/api/command/flags.rst:143
msgid "__getitem__"
msgstr ""
#: ../../root/api/command/flags.rst:150
msgid "Позволяет получать флаг по индексу."
msgstr ""
#: ../../root/api/command/flags.rst
msgid "param flag_index"
msgstr ""
#: ../../root/api/command/flags.rst:152
msgid "Индекс флага в списке."
msgstr ""
#: ../../root/api/command/flags.rst:153
msgid "Флаг по указанному индексу."
msgstr ""
#~ msgid "Flag"
#~ msgstr ""
#~ msgid "InputFlags"
#~ msgstr ""
#~ msgid "InputFlag"
#~ msgstr ""