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"
@@ -27,8 +27,6 @@ msgstr ""
msgid ""
"``Flag`` — это сущность, описывающая флаг команды. Её основная задача — "
"определить параметры флага, включая его имя, префикс и правила валидации."
" `Flag` используется при создании команд и предоставляет механизм для "
"проверки значений, введённых пользователем."
msgstr ""
#: ../../root/api/command/flag.rst:10
@@ -46,7 +44,7 @@ msgstr ""
#: ../../root/api/command/flag.rst:14
msgid ""
":ref:`Общая информация <root_flags>` о флагах и их использовании в "
"приложении ``Argenta``"
"``Argenta``"
msgstr ""
#: ../../root/api/command/flag.rst:19
@@ -68,8 +66,8 @@ msgstr ""
#: ../../root/api/command/flag.rst:34
msgid ""
"``possible_values``: Правила валидации значения. Может быть списком "
"строк, регулярным выражением или значением из `PossibleValues`. По "
"умолчанию `PossibleValues.ALL`."
"строк, регулярным выражением или значением из ``PossibleValues``. По "
"умолчанию ``PossibleValues.ALL``, то есть любое значение допустимо."
msgstr ""
#: ../../root/api/command/flag.rst:36
@@ -85,258 +83,232 @@ msgid "Префикс флага. Один из: ``\"-\"``, ``\"--\"``, ``\"---\
msgstr ""
#: ../../root/api/command/flag.rst:48
msgid "Определяет допустимые значения для флага:"
msgid "Допустимые значения для флага."
msgstr ""
#: ../../root/api/command/flag.rst:50
msgid "Список строк: флаг принимает только значения из этого списка."
msgstr ""
#: ../../root/api/command/flag.rst:51
msgid ""
"Регулярное выражение (`Pattern[str]`): значение проверяется на "
"соответствие паттерну."
msgstr ""
#: ../../root/api/command/flag.rst:52
msgid "`PossibleValues.ALL`: флаг принимает любое значение."
msgstr ""
#: ../../root/api/command/flag.rst:53
msgid "`PossibleValues.NEITHER`: флаг не должен иметь значения."
msgstr ""
#: ../../root/api/command/flag.rst:55 ../../root/api/command/flag.rst:81
#: ../../root/api/command/flag.rst:104 ../../root/api/command/flag.rst:124
#: ../../root/api/command/flag.rst:148 ../../root/api/command/flag.rst:265
#: ../../root/api/command/flag.rst:50 ../../root/api/command/flag.rst:93
#: ../../root/api/command/flag.rst:113 ../../root/api/command/flag.rst:136
#: ../../root/api/command/flag.rst:253
msgid "**Пример использования:**"
msgstr ""
#: ../../root/api/command/flag.rst:64
#: ../../root/api/command/flag.rst:59
msgid "Свойства"
msgstr ""
#: ../../root/api/command/flag.rst:67
#: ../../root/api/command/flag.rst:62
msgid "string_entity"
msgstr ""
#: ../../root/api/command/flag.rst:75
msgid "Возвращает строковое представление флага в формате `prefix + name`."
#: ../../root/api/command/flag.rst:70
msgid "Возвращает строковое представление флага в формате ``prefix + name``."
msgstr ""
#: ../../root/api/command/flag.rst
msgid "return"
msgstr ""
#: ../../root/api/command/flag.rst:77 ../../root/api/command/flag.rst:102
#: ../../root/api/command/flag.rst:72 ../../root/api/command/flag.rst:91
msgid "Строковое представление флага"
msgstr ""
#: ../../root/api/command/flag.rst:79
#: ../../root/api/command/flag.rst:74
msgid ""
"Это свойство объединяет префикс и имя в единую строку, которая "
"представляет флаг так, как он выглядел бы в командной строке."
msgstr ""
#: ../../root/api/command/flag.rst:90
#: ../../root/api/command/flag.rst:79
msgid "Магические методы"
msgstr ""
#: ../../root/api/command/flag.rst:93
#: ../../root/api/command/flag.rst:82
msgid "__str__"
msgstr ""
#: ../../root/api/command/flag.rst:100
msgid "Возвращает строковое представление флага (аналогично `string_entity`)."
#: ../../root/api/command/flag.rst:89
msgid "Возвращает строковое представление флага (аналогично ``string_entity``)."
msgstr ""
#: ../../root/api/command/flag.rst:113
#: ../../root/api/command/flag.rst:102
msgid "__repr__"
msgstr ""
#: ../../root/api/command/flag.rst:120
#: ../../root/api/command/flag.rst:109
msgid "Возвращает отладочное представление объекта."
msgstr ""
#: ../../root/api/command/flag.rst:122
msgid "Строка в формате `Flag<prefix=..., name=...>`."
#: ../../root/api/command/flag.rst:111
msgid "Строка в формате ``Flag<prefix=..., name=...>``."
msgstr ""
#: ../../root/api/command/flag.rst:133
#: ../../root/api/command/flag.rst:122
msgid "__eq__"
msgstr ""
#: ../../root/api/command/flag.rst:140
#: ../../root/api/command/flag.rst:129
msgid ""
"Сравнивает два флага на равенство по их строковому представлению "
"(`string_entity`)."
"(``string_entity``)."
msgstr ""
#: ../../root/api/command/flag.rst
msgid "param other"
msgstr ""
#: ../../root/api/command/flag.rst:142
#: ../../root/api/command/flag.rst:131
msgid "Объект для сравнения"
msgstr ""
#: ../../root/api/command/flag.rst:143
msgid "``True``, если флаги равны, иначе ``False``"
#: ../../root/api/command/flag.rst:132
msgid "**True**, если флаги равны, иначе **False**"
msgstr ""
#: ../../root/api/command/flag.rst
msgid "raises NotImplementedError"
#: ../../root/api/command/flag.rst:134
msgid "Два флага считаются равными, если их ``string_entity`` идентичны."
msgstr ""
#: ../../root/api/command/flag.rst:144
msgid "Если `other` не является экземпляром `Flag`."
msgstr ""
#: ../../root/api/command/flag.rst:146
msgid "Два флага считаются равными, если их `string_entity` идентичны."
msgstr ""
#: ../../root/api/command/flag.rst:159
#: ../../root/api/command/flag.rst:147
msgid "PredefinedFlags"
msgstr ""
#: ../../root/api/command/flag.rst:161
#: ../../root/api/command/flag.rst:149
msgid "``argenta.command.PredefinedFlags``"
msgstr ""
#: ../../root/api/command/flag.rst:163
#: ../../root/api/command/flag.rst:151
msgid ""
"Класс `PredefinedFlags` предоставляет набор готовых флагов для "
"Класс ``PredefinedFlags`` предоставляет набор готовых флагов для "
"использования в приложениях без их ручного создания. Эти флаги покрывают "
"наиболее распространённые сценарии и следуют общепринятым соглашениям."
"распространённые сценарии."
msgstr ""
#: ../../root/api/command/flag.rst:165
#: ../../root/api/command/flag.rst:153
msgid ""
"Все предопределённые флаги являются атрибутами класса и представляют "
"собой готовые экземпляры `Flag`."
"собой готовые экземпляры ``Flag``."
msgstr ""
#: ../../root/api/command/flag.rst:170
#: ../../root/api/command/flag.rst:158
msgid "Информационные флаги"
msgstr ""
#: ../../root/api/command/flag.rst:175
#: ../../root/api/command/flag.rst:163
msgid "Флаг для отображения справки: ``--help``"
msgstr ""
#: ../../root/api/command/flag.rst:177
#: ../../root/api/command/flag.rst:165
msgid "``name``: ``\"help\"``"
msgstr ""
#: ../../root/api/command/flag.rst:178 ../../root/api/command/flag.rst:194
#: ../../root/api/command/flag.rst:236 ../../root/api/command/flag.rst:252
#: ../../root/api/command/flag.rst:166 ../../root/api/command/flag.rst:182
#: ../../root/api/command/flag.rst:224 ../../root/api/command/flag.rst:240
msgid "``prefix``: ``\"--\"`` (по умолчанию)"
msgstr ""
#: ../../root/api/command/flag.rst:179 ../../root/api/command/flag.rst:187
#: ../../root/api/command/flag.rst:195 ../../root/api/command/flag.rst:203
#: ../../root/api/command/flag.rst:216 ../../root/api/command/flag.rst:224
#: ../../root/api/command/flag.rst:167 ../../root/api/command/flag.rst:175
#: ../../root/api/command/flag.rst:183 ../../root/api/command/flag.rst:191
#: ../../root/api/command/flag.rst:204 ../../root/api/command/flag.rst:212
msgid "``possible_values``: ``PossibleValues.NEITHER``"
msgstr ""
#: ../../root/api/command/flag.rst:183
#: ../../root/api/command/flag.rst:171
msgid "Короткая версия флага справки: ``-H``"
msgstr ""
#: ../../root/api/command/flag.rst:185 ../../root/api/command/flag.rst:243
#: ../../root/api/command/flag.rst:173 ../../root/api/command/flag.rst:231
msgid "``name``: ``\"H\"``"
msgstr ""
#: ../../root/api/command/flag.rst:186 ../../root/api/command/flag.rst:202
#: ../../root/api/command/flag.rst:223 ../../root/api/command/flag.rst:244
#: ../../root/api/command/flag.rst:260
#: ../../root/api/command/flag.rst:174 ../../root/api/command/flag.rst:190
#: ../../root/api/command/flag.rst:211 ../../root/api/command/flag.rst:232
#: ../../root/api/command/flag.rst:248
msgid "``prefix``: ``\"-\"``"
msgstr ""
#: ../../root/api/command/flag.rst:191
#: ../../root/api/command/flag.rst:179
msgid "Флаг для отображения информации: ``--info``"
msgstr ""
#: ../../root/api/command/flag.rst:193
#: ../../root/api/command/flag.rst:181
msgid "``name``: ``\"info\"``"
msgstr ""
#: ../../root/api/command/flag.rst:199
#: ../../root/api/command/flag.rst:187
msgid "Короткая версия флага информации: ``-I``"
msgstr ""
#: ../../root/api/command/flag.rst:201
#: ../../root/api/command/flag.rst:189
msgid "``name``: ``\"I\"``"
msgstr ""
#: ../../root/api/command/flag.rst:208
#: ../../root/api/command/flag.rst:196
msgid "Флаги выбора"
msgstr ""
#: ../../root/api/command/flag.rst:212
#: ../../root/api/command/flag.rst:200
msgid "Флаг для выбора всех элементов: ``--all``"
msgstr ""
#: ../../root/api/command/flag.rst:214
#: ../../root/api/command/flag.rst:202
msgid "``name``: ``\"all\"``"
msgstr ""
#: ../../root/api/command/flag.rst:215
#: ../../root/api/command/flag.rst:203
msgid "``prefix``: ``\"--\"``"
msgstr ""
#: ../../root/api/command/flag.rst:220
#: ../../root/api/command/flag.rst:208
msgid "Короткая версия флага выбора всех элементов: ``-A``"
msgstr ""
#: ../../root/api/command/flag.rst:222
#: ../../root/api/command/flag.rst:210
msgid "``name``: ``\"A\"``"
msgstr ""
#: ../../root/api/command/flag.rst:229
#: ../../root/api/command/flag.rst:217
msgid "Сетевые флаги"
msgstr ""
#: ../../root/api/command/flag.rst:233
#: ../../root/api/command/flag.rst:221
msgid "Флаг для указания IP-адреса хоста: ``--host``"
msgstr ""
#: ../../root/api/command/flag.rst:235
#: ../../root/api/command/flag.rst:223
msgid "``name``: ``\"host\"``"
msgstr ""
#: ../../root/api/command/flag.rst:237 ../../root/api/command/flag.rst:245
#: ../../root/api/command/flag.rst:225 ../../root/api/command/flag.rst:233
#, python-brace-format
msgid ""
"``possible_values``: Регулярное выражение для валидации IPv4: "
"``r\"^\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$\"``"
msgstr ""
#: ../../root/api/command/flag.rst:241
#: ../../root/api/command/flag.rst:229
msgid "Короткая версия флага хоста: ``-H``"
msgstr ""
#: ../../root/api/command/flag.rst:249
#: ../../root/api/command/flag.rst:237
msgid "Флаг для указания порта: ``--port``"
msgstr ""
#: ../../root/api/command/flag.rst:251
#: ../../root/api/command/flag.rst:239
msgid "``name``: ``\"port\"``"
msgstr ""
#: ../../root/api/command/flag.rst:253 ../../root/api/command/flag.rst:261
#: ../../root/api/command/flag.rst:241 ../../root/api/command/flag.rst:249
#, python-brace-format
msgid ""
"``possible_values``: Регулярное выражение для валидации порта: "
"``r\"^\\d{1,5}$\"``"
msgstr ""
#: ../../root/api/command/flag.rst:257
#: ../../root/api/command/flag.rst:245
msgid "Короткая версия флага порта: ``-P``"
msgstr ""
#: ../../root/api/command/flag.rst:259
#: ../../root/api/command/flag.rst:247
msgid "``name``: ``\"P\"``"
msgstr ""
@@ -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 ""
@@ -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"
@@ -26,9 +26,8 @@ msgstr ""
#: ../../root/api/command/index.rst:6
msgid ""
"``Command`` — это основная единица функциональности в приложении. Каждая "
"команда определяет действие, которое пользователь может выполнить, введя "
"соответствующий триггер. Команды регистрируются в роутерах и формируют "
"интерфейс взаимодействия с приложением."
"команда связывает хэндлер с триггером, введя который он будет вызван для "
"обработки."
msgstr ""
#: ../../root/api/command/index.rst:8
@@ -60,14 +59,14 @@ msgstr ""
#: ../../root/api/command/index.rst:27
msgid ""
"``flags``: Набор флагов для настройки поведения. Может быть одиночным "
"объектом `Flag` или коллекцией `Flags`."
"объектом ``Flag`` или коллекцией ``Flags``."
msgstr ""
#: ../../root/api/command/index.rst:28
msgid "``aliases``: Список строковых псевдонимов для основного триггера."
msgstr ""
#: ../../root/api/command/index.rst:30 ../../root/api/command/index.rst:125
#: ../../root/api/command/index.rst:30 ../../root/api/command/index.rst:108
msgid "**Атрибуты:**"
msgstr ""
@@ -85,8 +84,9 @@ msgstr ""
#: ../../root/api/command/index.rst:42
msgid ""
"Объект `Flags`, содержащий все зарегистрированные флаги. Автоматически "
"конвертируется из одиночного `Flag` в коллекцию при инициализации."
"Объект ``Flags``, содержащий все зарегистрированные флаги. Если был "
"передан ``Flag``, то автоматически конвертируется из одиночного в "
"коллекцию при инициализации."
msgstr ""
#: ../../root/api/command/index.rst:46
@@ -108,9 +108,7 @@ msgid "Регистрация команд"
msgstr ""
#: ../../root/api/command/index.rst:61
msgid ""
"Команды регистрируются в роутерах с помощью декоратора "
"``@router.command()``, после чего становятся доступными для вызова."
msgid "Команды передаются в качестве аргумента в декоратор ``@router.command()``."
msgstr ""
#: ../../root/api/command/index.rst:63
@@ -135,19 +133,19 @@ msgstr ""
msgid "**Пример с псевдонимами:**"
msgstr ""
#: ../../root/api/command/index.rst:97
#: ../../root/api/command/index.rst:85
msgid "Теперь пользователь может вызвать команду любым из способов:"
msgstr ""
#: ../../root/api/command/index.rst:106
msgid "Все эти варианты выполнят одну и ту же функцию ``handle_shutdown``."
#: ../../root/api/command/index.rst:94
msgid "Все эти варианты вызовут один и тот же хэндлер ``handle_shutdown``."
msgstr ""
#: ../../root/api/command/index.rst:113
#: ../../root/api/command/index.rst:101
msgid "InputCommand"
msgstr ""
#: ../../root/api/command/index.rst:115
#: ../../root/api/command/index.rst:103
msgid ""
"``InputCommand`` представляет собой обработанную команду, введённую "
"пользователем. Этот внутренний класс создаётся автоматически при "
@@ -155,39 +153,17 @@ msgid ""
"создании пользовательского обработчика для неизвестных команд."
msgstr ""
#: ../../root/api/command/index.rst:118
#: ../../root/api/command/index.rst:106
msgid ""
"Подробнее о пользовательских обработчиках исключений см. :ref:`здесь "
"<root_error_handling>`."
"<root_error_handling_unknown_command>`."
msgstr ""
#: ../../root/api/command/index.rst:120
msgid "Создаёт экземпляр обработанной команды."
msgstr ""
#: ../../root/api/command/index.rst
msgid "param trigger"
msgstr ""
#: ../../root/api/command/index.rst:122
msgid "Триггер команды, извлечённый из пользовательского ввода."
msgstr ""
#: ../../root/api/command/index.rst
msgid "param input_flags"
msgstr ""
#: ../../root/api/command/index.rst:123
msgid "Флаги, переданные пользователем."
msgstr ""
#: ../../root/api/command/index.rst:130
#: ../../root/api/command/index.rst:113
msgid "Строковый триггер, введённый пользователем."
msgstr ""
#: ../../root/api/command/index.rst:135
msgid ""
"Объект `InputFlags`, содержащий все переданные с командой флаги. "
"Автоматически конвертируется из одиночного `InputFlag` в коллекцию."
#: ../../root/api/command/index.rst:118
msgid "Объект ``InputFlags``, содержащий все введённые и распаршенные флаги."
msgstr ""
@@ -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,8 +25,8 @@ msgstr ""
#: ../../root/api/command/input_flag.rst:6
msgid ""
"Объект `InputFlag` представляет собой флаг, введённый пользователем. Он "
"создаётся в результате обработки пользовательского ввода и содержит "
"Объект ``InputFlag`` представляет собой флаг, введённый пользователем. Он"
" создаётся в результате обработки пользовательского ввода и содержит "
"информацию о распознанном флаге: его имя, префикс, значение и статус "
"валидации."
msgstr ""
@@ -44,124 +44,93 @@ msgid ""
msgstr ""
#: ../../root/api/command/input_flag.rst:17
msgid "Инициализация"
msgstr ""
#: ../../root/api/command/input_flag.rst:29
msgid "Создаёт новый объект введённого флага."
msgstr ""
#: ../../root/api/command/input_flag.rst:31
msgid "``name``: Имя введённого флага."
msgstr ""
#: ../../root/api/command/input_flag.rst:32
msgid "``prefix``: Префикс флага (``-``, ``--``, ``---``). По умолчанию ``--``."
msgstr ""
#: ../../root/api/command/input_flag.rst:33
msgid "``input_value``: Значение, переданное с флагом. Может быть `None`."
msgstr ""
#: ../../root/api/command/input_flag.rst:34
msgid "``status``: Статус валидации из перечисления `ValidationStatus`."
msgstr ""
#: ../../root/api/command/input_flag.rst:37
msgid ""
"Экземпляры этого класса не предназначены для прямого создания. Они "
"содержатся в объекте :ref:`Response <root_api_response>`."
msgstr ""
#: ../../root/api/command/input_flag.rst:39
#: ../../root/api/command/input_flag.rst:19
msgid "**Атрибуты:**"
msgstr ""
#: ../../root/api/command/input_flag.rst:44
#: ../../root/api/command/input_flag.rst:24
msgid "Имя введённого флага."
msgstr ""
#: ../../root/api/command/input_flag.rst:49
#: ../../root/api/command/input_flag.rst:29
msgid "Префикс флага: ``-``, ``--`` или ``---``."
msgstr ""
#: ../../root/api/command/input_flag.rst:53
#: ../../root/api/command/input_flag.rst:33
msgid "Значение, переданное с флагом. Может быть `None` для флагов без значений."
msgstr ""
#: ../../root/api/command/input_flag.rst:58
#: ../../root/api/command/input_flag.rst:38
msgid ""
"Статус валидации флага: `ValidationStatus.VALID`, "
"`ValidationStatus.INVALID` или `ValidationStatus.UNDEFINED`."
"Статус валидации флага: ``ValidationStatus.VALID``, "
"``ValidationStatus.INVALID`` или ``ValidationStatus.UNDEFINED``."
msgstr ""
#: ../../root/api/command/input_flag.rst:60
#: ../../root/api/command/input_flag.rst:86
#: ../../root/api/command/input_flag.rst:109
#: ../../root/api/command/input_flag.rst:129
#: ../../root/api/command/input_flag.rst:153
msgid "**Пример использования:**"
msgstr ""
#: ../../root/api/command/input_flag.rst:69
#: ../../root/api/command/input_flag.rst:43
msgid "Свойства"
msgstr ""
#: ../../root/api/command/input_flag.rst:72
#: ../../root/api/command/input_flag.rst:46
msgid "string_entity"
msgstr ""
#: ../../root/api/command/input_flag.rst:80
msgid "Возвращает строковое представление флага в формате `prefix + name`."
#: ../../root/api/command/input_flag.rst:54
msgid "Возвращает строковое представление флага в формате ``prefix + name``."
msgstr ""
#: ../../root/api/command/input_flag.rst
msgid "return"
msgstr ""
#: ../../root/api/command/input_flag.rst:82
#: ../../root/api/command/input_flag.rst:56
msgid "Строковое представление флага"
msgstr ""
#: ../../root/api/command/input_flag.rst:84
msgid ""
"Это свойство объединяет префикс и имя в строку, представляющую флаг так, "
"как он был введён в командной строке."
msgstr ""
#: ../../root/api/command/input_flag.rst:95
#: ../../root/api/command/input_flag.rst:61
msgid "Магические методы"
msgstr ""
#: ../../root/api/command/input_flag.rst:98
#: ../../root/api/command/input_flag.rst:64
msgid "__str__"
msgstr ""
#: ../../root/api/command/input_flag.rst:105
#: ../../root/api/command/input_flag.rst:71
msgid "Возвращает строковое представление флага вместе с его значением."
msgstr ""
#: ../../root/api/command/input_flag.rst:107
msgid "Строка в формате `флаг значение`."
#: ../../root/api/command/input_flag.rst:73
msgid "Строка в формате ``флаг значение``."
msgstr ""
#: ../../root/api/command/input_flag.rst:118
#: ../../root/api/command/input_flag.rst:75
#: ../../root/api/command/input_flag.rst:95
msgid "**Пример использования:**"
msgstr ""
#: ../../root/api/command/input_flag.rst:84
msgid "__repr__"
msgstr ""
#: ../../root/api/command/input_flag.rst:125
#: ../../root/api/command/input_flag.rst:91
msgid "Возвращает отладочное представление объекта."
msgstr ""
#: ../../root/api/command/input_flag.rst:127
msgid "Строка в формате `InputFlag<prefix=..., name=..., value=..., status=...>`."
#: ../../root/api/command/input_flag.rst:93
msgid ""
"Строка в формате ``InputFlag<prefix=..., name=..., value=..., "
"status=...>``."
msgstr ""
#: ../../root/api/command/input_flag.rst:138
#: ../../root/api/command/input_flag.rst:104
msgid "__eq__"
msgstr ""
#: ../../root/api/command/input_flag.rst:145
#: ../../root/api/command/input_flag.rst:111
msgid "Сравнивает два введённых флага на равенство по имени."
msgstr ""
@@ -169,23 +138,15 @@ msgstr ""
msgid "param other"
msgstr ""
#: ../../root/api/command/input_flag.rst:147
#: ../../root/api/command/input_flag.rst:113
msgid "Объект для сравнения."
msgstr ""
#: ../../root/api/command/input_flag.rst:148
msgid "`True`, если имена флагов совпадают, иначе `False`."
#: ../../root/api/command/input_flag.rst:114
msgid "**True**, если имена флагов совпадают, иначе **False**."
msgstr ""
#: ../../root/api/command/input_flag.rst
msgid "raises NotImplementedError"
msgstr ""
#: ../../root/api/command/input_flag.rst:149
msgid "Если `other` не является экземпляром `InputFlag`."
msgstr ""
#: ../../root/api/command/input_flag.rst:151
#: ../../root/api/command/input_flag.rst:116
msgid "Два введённых флага считаются равными, если их имена совпадают."
msgstr ""
@@ -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,105 +25,93 @@ msgstr ""
#: ../../root/api/command/input_flags.rst:6
msgid ""
"`InputFlags` — это коллекция флагов, введённых пользователем. Её основная"
" задача — группировать и управлять набором флагов, переданных вместе с "
"командой. `InputFlags` служит контейнером, который позволяет удобно "
"извлекать, итерировать и проверять наличие флагов, а также работать с их "
"значениями и статусами валидации."
"``InputFlags`` — это коллекция флагов, введённых пользователем. Её "
"основная задача — группировать и управлять набором флагов, переданных "
"вместе с командой. ``InputFlags`` служит контейнером, который позволяет "
"удобно извлекать, итерировать и проверять наличие флагов, а также "
"работать с их значениями и статусами валидации."
msgstr ""
#: ../../root/api/command/input_flags.rst:8
msgid ""
"`InputFlags` наследуется от `BaseFlags` и специализируется на работе с "
"объектами типа `InputFlag`. Этот класс создаётся автоматически при "
"обработке пользовательского ввода и передаётся в обработчики команд через"
" объект `Response`."
msgstr ""
#: ../../root/api/command/input_flags.rst:12
#: ../../root/api/command/input_flags.rst:10
msgid ""
"Документация по отдельным флагам (:ref:`Flag <root_api_command_flag>`, "
":ref:`InputFlag <root_api_command_input_flag>`)"
msgstr ""
#: ../../root/api/command/input_flags.rst:14
#: ../../root/api/command/input_flags.rst:12
msgid ""
"Документация по :ref:`InputFlags <root_api_command_input_flags>` — "
"коллекция обработанных флагов, введённых пользователем."
msgstr ""
#: ../../root/api/command/input_flags.rst:16
#: ../../root/api/command/input_flags.rst:14
msgid ""
"Документация по :ref:`Response <root_api_response>` — объект ответа, "
"содержащий ``InputFlags``"
msgstr ""
#: ../../root/api/command/input_flags.rst:18
#: ../../root/api/command/input_flags.rst:16
msgid ""
":ref:`Общая информация <root_flags>` о флагах и их использовании в "
"приложении ``Argenta``"
msgstr ""
#: ../../root/api/command/input_flags.rst:23
#: ../../root/api/command/input_flags.rst:21
msgid "Инициализация"
msgstr ""
#: ../../root/api/command/input_flags.rst:30
#: ../../root/api/command/input_flags.rst:28
msgid "Создаёт новую коллекцию введённых флагов."
msgstr ""
#: ../../root/api/command/input_flags.rst:32
#: ../../root/api/command/input_flags.rst:30
msgid ""
"``flags``: Необязательный список флагов типа `InputFlag` для "
"``flags``: Необязательный список флагов типа ``InputFlag`` для "
"инициализации коллекции. Если не указан, создаётся пустая коллекция."
msgstr ""
#: ../../root/api/command/input_flags.rst:35
#: ../../root/api/command/input_flags.rst:33
msgid ""
"Экземпляры этого класса обычно не создаются напрямую. Они автоматически "
"формируются системой при обработке пользовательского ввода и доступны "
"через атрибут `input_flags` объекта `Response`."
"через атрибут ``input_flags`` объекта ``Response``."
msgstr ""
#: ../../root/api/command/input_flags.rst:37
#: ../../root/api/command/input_flags.rst:35
msgid "**Атрибуты:**"
msgstr ""
#: ../../root/api/command/input_flags.rst:42
#: ../../root/api/command/input_flags.rst:40
msgid ""
"Список всех введённых флагов типа `InputFlag`. Пуст, если флаги не были "
"переданы при инициализации или пользователь не ввёл их с командой."
"Список всех введённых флагов типа ``InputFlag``. Пуст, если флаги не были"
" переданы при инициализации или пользователь не ввёл их с командой."
msgstr ""
#: ../../root/api/command/input_flags.rst:44
#: ../../root/api/command/input_flags.rst:70
#: ../../root/api/command/input_flags.rst:96
#: ../../root/api/command/input_flags.rst:119
#: ../../root/api/command/input_flags.rst:144
#: ../../root/api/command/input_flags.rst:167
#: ../../root/api/command/input_flags.rst:189
#: ../../root/api/command/input_flags.rst:213
#: ../../root/api/command/input_flags.rst:237
#: ../../root/api/command/input_flags.rst:42
#: ../../root/api/command/input_flags.rst:68
#: ../../root/api/command/input_flags.rst:94
#: ../../root/api/command/input_flags.rst:117
#: ../../root/api/command/input_flags.rst:131
msgid "**Пример использования:**"
msgstr ""
#: ../../root/api/command/input_flags.rst:53
#: ../../root/api/command/input_flags.rst:51
msgid "Методы"
msgstr ""
#: ../../root/api/command/input_flags.rst:56
#: ../../root/api/command/input_flags.rst:54
msgid "get_flag_by_name"
msgstr ""
#: ../../root/api/command/input_flags.rst:63
msgid "Возвращает введённый флаг по имени."
#: ../../root/api/command/input_flags.rst:61
msgid "Возвращает флаг по имени."
msgstr ""
#: ../../root/api/command/input_flags.rst
msgid "param name"
msgstr ""
#: ../../root/api/command/input_flags.rst:65
#: ../../root/api/command/input_flags.rst:63
msgid "Имя искомого флага (без префикса)."
msgstr ""
@@ -131,21 +119,21 @@ msgstr ""
msgid "return"
msgstr ""
#: ../../root/api/command/input_flags.rst:64
msgid "Объект ``InputFlag`` или ``None``, если флаг не найден."
msgstr ""
#: ../../root/api/command/input_flags.rst:66
msgid "Объект `InputFlag` или `None`, если флаг не найден."
msgstr ""
#: ../../root/api/command/input_flags.rst:68
msgid ""
"Метод выполняет поиск по списку `flags` и возвращает первый флаг с "
"соответствующим именем (без учёта префикса)."
"Метод возвращает первый флаг с соответствующим именем (без учёта "
"префикса)."
msgstr ""
#: ../../root/api/command/input_flags.rst:79
#: ../../root/api/command/input_flags.rst:77
msgid "add_flag"
msgstr ""
#: ../../root/api/command/input_flags.rst:86
#: ../../root/api/command/input_flags.rst:84
msgid "Добавляет введённый флаг в коллекцию."
msgstr ""
@@ -153,33 +141,33 @@ msgstr ""
msgid "param flag"
msgstr ""
#: ../../root/api/command/input_flags.rst:88
msgid "Флаг типа `InputFlag` для добавления."
#: ../../root/api/command/input_flags.rst:86
msgid "Флаг типа ``InputFlag`` для добавления."
msgstr ""
#: ../../root/api/command/input_flags.rst:89
#: ../../root/api/command/input_flags.rst:115
#: ../../root/api/command/input_flags.rst:87
#: ../../root/api/command/input_flags.rst:113
msgid "None."
msgstr ""
#: ../../root/api/command/input_flags.rst:91
#: ../../root/api/command/input_flags.rst:89
msgid ""
"Метод добавляет флаг в конец списка `flags`. Используется для "
"Метод добавляет флаг в конец списка ``flags``. Используется для "
"динамического расширения коллекции."
msgstr ""
#: ../../root/api/command/input_flags.rst:94
#: ../../root/api/command/input_flags.rst:92
msgid ""
"Этот метод используется редко, так как `InputFlags` обычно создаётся "
"автоматически. Однако он может быть полезен для тестирования или ручного "
"создания коллекций."
msgstr ""
#: ../../root/api/command/input_flags.rst:105
#: ../../root/api/command/input_flags.rst:103
msgid "add_flags"
msgstr ""
#: ../../root/api/command/input_flags.rst:112
#: ../../root/api/command/input_flags.rst:110
msgid "Добавляет в коллекцию список введённых флагов."
msgstr ""
@@ -187,160 +175,21 @@ msgstr ""
msgid "param flags"
msgstr ""
#: ../../root/api/command/input_flags.rst:114
msgid "Список флагов типа `InputFlag` для добавления."
#: ../../root/api/command/input_flags.rst:112
msgid "Список флагов типа ``InputFlag`` для добавления."
msgstr ""
#: ../../root/api/command/input_flags.rst:117
#: ../../root/api/command/input_flags.rst:115
msgid ""
"Метод расширяет коллекцию, добавляя в неё все флаги из переданного "
"списка. Эффективен для пакетного добавления."
msgstr ""
#: ../../root/api/command/input_flags.rst:128
msgid "Магические методы"
msgstr ""
#: ../../root/api/command/input_flags.rst:131
msgid "__iter__"
msgstr ""
#: ../../root/api/command/input_flags.rst:138
msgid "Делает коллекцию итерируемой для использования в циклах."
msgstr ""
#: ../../root/api/command/input_flags.rst:140
msgid "Итератор по списку введённых флагов."
msgstr ""
#: ../../root/api/command/input_flags.rst:142
msgid ""
"Позволяет перебирать все введённые флаги, что полезно для проверки их "
"статусов или пакетной обработки."
msgstr ""
#: ../../root/api/command/input_flags.rst:153
msgid "__getitem__"
msgstr ""
#: ../../root/api/command/input_flags.rst:160
msgid "Позволяет получать введённый флаг по индексу."
msgstr ""
#: ../../root/api/command/input_flags.rst
msgid "param flag_index"
msgstr ""
#: ../../root/api/command/input_flags.rst:162
msgid "Индекс флага в списке."
msgstr ""
#: ../../root/api/command/input_flags.rst:163
msgid "Флаг по указанному индексу."
msgstr ""
#: ../../root/api/command/input_flags.rst:165
msgid ""
"Позволяет обращаться к флагам по их позиции, что может быть полезно для "
"их обработки в определённом порядке."
msgstr ""
#: ../../root/api/command/input_flags.rst:176
msgid "__bool__"
msgstr ""
#: ../../root/api/command/input_flags.rst:183
msgid "Определяет, содержит ли коллекция флаги."
msgstr ""
#: ../../root/api/command/input_flags.rst:185
msgid "`True`, если в коллекции есть хотя бы один флаг, иначе `False`."
msgstr ""
#: ../../root/api/command/input_flags.rst:187
msgid "Позволяет проверять наличие флагов в команде для условной логики."
msgstr ""
#: ../../root/api/command/input_flags.rst:198
msgid "__eq__"
msgstr ""
#: ../../root/api/command/input_flags.rst:205
msgid "Сравнивает две коллекции введённых флагов на равенство."
msgstr ""
#: ../../root/api/command/input_flags.rst
msgid "param other"
msgstr ""
#: ../../root/api/command/input_flags.rst:207
msgid "Объект для сравнения."
msgstr ""
#: ../../root/api/command/input_flags.rst:208
msgid "`True`, если коллекции равны, иначе `False`."
msgstr ""
#: ../../root/api/command/input_flags.rst
msgid "raises NotImplementedError"
msgstr ""
#: ../../root/api/command/input_flags.rst:209
msgid "Если `other` не является экземпляром `InputFlags`."
msgstr ""
#: ../../root/api/command/input_flags.rst:211
msgid ""
"Две коллекции считаются равными, если они содержат одинаковое количество "
"флагов и все соответствующие флаги равны (сравнение по имени, см. "
"`InputFlag.__eq__`)."
msgstr ""
#: ../../root/api/command/input_flags.rst:222
msgid "__contains__"
msgstr ""
#: ../../root/api/command/input_flags.rst:229
msgid "Проверяет, содержится ли введённый флаг в коллекции."
msgstr ""
#: ../../root/api/command/input_flags.rst
msgid "param ingressable_item"
msgstr ""
#: ../../root/api/command/input_flags.rst:231
msgid "Объект `InputFlag` для проверки."
msgstr ""
#: ../../root/api/command/input_flags.rst:232
msgid "`True`, если флаг найден, иначе `False`."
msgstr ""
#: ../../root/api/command/input_flags.rst
msgid "raises TypeError"
msgstr ""
#: ../../root/api/command/input_flags.rst:233
msgid "Если `ingressable_item` не является экземпляром `InputFlag`."
msgstr ""
#: ../../root/api/command/input_flags.rst:235
msgid ""
"Позволяет использовать оператор `in` для проверки наличия флага в "
"коллекции."
msgstr ""
#: ../../root/api/command/input_flags.rst:246
#: ../../root/api/command/input_flags.rst:126
msgid "Практические примеры"
msgstr ""
#: ../../root/api/command/input_flags.rst:249
#: ../../root/api/command/input_flags.rst:129
msgid "Обработка всех флагов с проверкой статусов"
msgstr ""
#: ../../root/api/command/input_flags.rst:251
msgid ""
"Пример демонстрирует итерацию по всем введённым флагам с проверкой их "
"статусов валидации:"
msgstr ""
@@ -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,39 +25,39 @@ msgstr ""
#: ../../root/api/command/possible_values.rst:7
msgid ""
"`PossibleValues` — это перечисление (`Enum`), которое определяет "
"специальные режимы валидации для значений флагов. Его задача — "
"предоставить стандартные константы для управления поведением флагов. "
"`PossibleValues` используется в параметре `possible_values` класса "
"`Flag`, чтобы указать, может ли флаг принимать значения и какие "
"ограничения на них накладываются."
"``PossibleValues`` — это перечисление (``Enum``), которое определяет "
"специальные режимы валидации для значений флагов. ``PossibleValues`` "
"используется в параметре ``possible_values`` класса ``Flag``, чтобы "
"указать, может ли флаг принимать значения и какие ограничения на них "
"накладываются."
msgstr ""
#: ../../root/api/command/possible_values.rst:9
msgid ""
"`PossibleValues` наследуется от `Enum` и содержит два основных значения: "
"`NEITHER` (для флагов без значений) и `ALL` (для флагов, принимающих "
"любые значения). Это перечисление используется вместе со списками строк и"
" регулярными выражениями для создания гибкой системы валидации."
"``PossibleValues`` содержит два основных значения: ``NEITHER`` (для "
"флагов, которые не могут принимать значения) и ``ALL`` (для флагов, "
"принимающих любые значения). Это перечисление используется вместе со "
"списками строк и регулярными выражениями для создания гибкой системы "
"валидации."
msgstr ""
#: ../../root/api/command/possible_values.rst:12
msgid ""
"Результат валидации доступен через атрибут `status` у экземпляра "
"`InputFlag`. Подробнее см. :ref:`здесь <root_api_command_input_flag>`."
"Результат валидации доступен через атрибут ``status`` у экземпляра "
"``InputFlag``. Подробнее см. :ref:`здесь <root_api_command_input_flag>`."
msgstr ""
#: ../../root/api/command/possible_values.rst:16
msgid ""
"Документация по :ref:`Flag <root_api_command_flag>` — класс флага, "
"использующий `PossibleValues`."
"использующий ``PossibleValues``."
msgstr ""
#: ../../root/api/command/possible_values.rst:18
msgid ""
"Документация по :ref:`PredefinedFlags "
"<root_api_command_flag_predefined_flags>` — готовые флаги с примерами "
"использования `PossibleValues`."
"Документация по :ref:`ValidationStatus "
"<root_api_command_validation_status>` — результат валидации ввёденного "
"флага."
msgstr ""
#: ../../root/api/command/possible_values.rst:20
@@ -67,129 +67,102 @@ msgid ""
msgstr ""
#: ../../root/api/command/possible_values.rst:25
msgid "Значения enum"
msgstr ""
#: ../../root/api/command/possible_values.rst:28
msgid "NEITHER"
msgstr ""
#: ../../root/api/command/possible_values.rst:35
#: ../../root/api/command/possible_values.rst:32
msgid "Указывает, что флаг **не должен** иметь значения."
msgstr ""
#: ../../root/api/command/possible_values.rst:37
#: ../../root/api/command/possible_values.rst:34
msgid ""
"Флаги с этим значением работают как булевы переключатели: их наличие в "
"командной строке само по себе является информацией. Попытка передать "
"такому флагу значение приведёт к ошибке валидации."
msgstr ""
#: ../../root/api/command/possible_values.rst:39
#: ../../root/api/command/possible_values.rst:36
msgid "**Примеры флагов с** ``NEITHER``:"
msgstr ""
#: ../../root/api/command/possible_values.rst:41
#: ../../root/api/command/possible_values.rst:38
msgid "``--help`` — флаг справки"
msgstr ""
#: ../../root/api/command/possible_values.rst:42
#: ../../root/api/command/possible_values.rst:39
msgid "``--verbose`` — флаг подробного вывода"
msgstr ""
#: ../../root/api/command/possible_values.rst:43
#: ../../root/api/command/possible_values.rst:40
msgid "``--force`` — флаг принудительного выполнения"
msgstr ""
#: ../../root/api/command/possible_values.rst:44
#: ../../root/api/command/possible_values.rst:41
msgid "``-A`` / ``--all`` — флаг выбора всех элементов"
msgstr ""
#: ../../root/api/command/possible_values.rst:46
#: ../../root/api/command/possible_values.rst:73
#: ../../root/api/command/possible_values.rst:43
#: ../../root/api/command/possible_values.rst:68
msgid "**Пример использования:**"
msgstr ""
#: ../../root/api/command/possible_values.rst:55
#: ../../root/api/command/possible_values.rst:52
msgid "ALL"
msgstr ""
#: ../../root/api/command/possible_values.rst:62
#: ../../root/api/command/possible_values.rst:59
msgid "Указывает, что флаг может принимать **любое** значение."
msgstr ""
#: ../../root/api/command/possible_values.rst:64
#: ../../root/api/command/possible_values.rst:61
msgid ""
"Флаги с этим значением универсальны и не накладывают ограничений на "
"передаваемые данные. Валидация всегда будет успешной."
msgstr ""
#: ../../root/api/command/possible_values.rst:66
#: ../../root/api/command/possible_values.rst:63
msgid "**Примеры флагов с** ``ALL``:"
msgstr ""
#: ../../root/api/command/possible_values.rst:68
msgid "``--output`` — путь к выходному файлу"
msgstr ""
#: ../../root/api/command/possible_values.rst:69
#: ../../root/api/command/possible_values.rst:65
msgid "``--message`` — произвольное текстовое сообщение"
msgstr ""
#: ../../root/api/command/possible_values.rst:70
#: ../../root/api/command/possible_values.rst:66
msgid "``--name`` — произвольное имя"
msgstr ""
#: ../../root/api/command/possible_values.rst:71
msgid "``--data`` — произвольные данные"
msgstr ""
#: ../../root/api/command/possible_values.rst:82
msgid "Использование в Flag"
msgstr ""
#: ../../root/api/command/possible_values.rst:85
#: ../../root/api/command/possible_values.rst:77
msgid "Параметр possible_values"
msgstr ""
#: ../../root/api/command/possible_values.rst:87
#: ../../root/api/command/possible_values.rst:79
msgid ""
"`PossibleValues` используется как один из возможных типов для параметра "
"`possible_values` при создании экземпляра `Flag`."
"``PossibleValues`` используется как один из возможных типов для параметра"
" ``possible_values`` при создании экземпляра ``Flag``."
msgstr ""
#: ../../root/api/command/possible_values.rst:89
msgid "**Доступные типы для** `possible_values`:"
#: ../../root/api/command/possible_values.rst:81
msgid "**Доступные типы для** ``possible_values``:"
msgstr ""
#: ../../root/api/command/possible_values.rst:91
msgid "`PossibleValues.NEITHER`: флаг без значения."
#: ../../root/api/command/possible_values.rst:83
msgid "``PossibleValues.NEITHER``: флаг без значения."
msgstr ""
#: ../../root/api/command/possible_values.rst:92
msgid "`PossibleValues.ALL`: флаг с любым значением (по умолчанию)."
#: ../../root/api/command/possible_values.rst:84
msgid "``PossibleValues.ALL``: флаг с любым значением (по умолчанию)."
msgstr ""
#: ../../root/api/command/possible_values.rst:93
msgid "`list[str]`: флаг с ограниченным набором значений."
#: ../../root/api/command/possible_values.rst:85
msgid "``list[str]``: флаг с ограниченным набором значений."
msgstr ""
#: ../../root/api/command/possible_values.rst:94
msgid "`Pattern[str]`: флаг со значением, проверяемым по регулярному выражению."
#: ../../root/api/command/possible_values.rst:86
msgid "``Pattern[str]``: флаг со значением, проверяемым по регулярному выражению."
msgstr ""
#: ../../root/api/command/possible_values.rst:96
#: ../../root/api/command/possible_values.rst:88
msgid "**Пример комбинированного использования:**"
msgstr ""
#: ../../root/api/command/possible_values.rst:105
msgid "Использование в PredefinedFlags"
msgstr ""
#: ../../root/api/command/possible_values.rst:107
msgid "Многие предопределённые флаги используют `PossibleValues.NEITHER`:"
msgstr ""
#~ msgid "mda"
#~ msgstr ""
@@ -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,30 +25,28 @@ msgstr ""
#: ../../root/api/command/validation_status.rst:6
msgid ""
"`ValidationStatus` — это перечисление (`Enum`), которое определяет "
"состояние валидации флага. Его задача — предоставить стандартные "
"константы для отображения результата проверки. `ValidationStatus` "
"используется в атрибуте `status` класса `InputFlag`, чтобы сообщить, "
"прошла ли валидация успешно."
"``ValidationStatus`` — это перечисление, которое определяет состояние "
"валидации флага. Его задача — предоставить стандартные константы для "
"отображения результата проверки. ``ValidationStatus`` используется в "
"атрибуте ``status`` класса ``InputFlag``."
msgstr ""
#: ../../root/api/command/validation_status.rst:8
msgid ""
"`ValidationStatus` наследуется от `Enum` и содержит три значения: `VALID`"
" (корректный флаг), `INVALID` (некорректный) и `UNDEFINED` "
"(незарегистрированный)."
"``ValidationStatus`` содержит три значения: **VALID** (корректный флаг), "
"**INVALID** (некорректный) и **UNDEFINED** (незарегистрированный)."
msgstr ""
#: ../../root/api/command/validation_status.rst:12
msgid ""
"Статус валидации устанавливается автоматически при создании экземпляра "
"`InputFlag` на основе правил, заданных в соответствующем `Flag`."
"``InputFlag`` на основе правил, заданных в соответствующем ``Flag``."
msgstr ""
#: ../../root/api/command/validation_status.rst:16
msgid ""
"Документация по :ref:`InputFlag <root_api_command_input_flag>` — класс "
"введённого флага, использующий `ValidationStatus`."
"введённого флага, использующий ``ValidationStatus``."
msgstr ""
#: ../../root/api/command/validation_status.rst:18
@@ -64,111 +62,87 @@ msgid ""
msgstr ""
#: ../../root/api/command/validation_status.rst:25
msgid "Значения enum"
msgstr ""
#: ../../root/api/command/validation_status.rst:28
msgid "VALID"
msgstr ""
#: ../../root/api/command/validation_status.rst:35
#: ../../root/api/command/validation_status.rst:32
msgid "Указывает, что флаг и его значение **прошли** валидацию."
msgstr ""
#: ../../root/api/command/validation_status.rst:37
#: ../../root/api/command/validation_status.rst:34
msgid ""
"Флаги с этим статусом соответствуют правилам, заданным в "
"`possible_values` соответствующего `Flag`. Их можно безопасно "
"``possible_values`` соответствующего ``Flag``. Их можно безопасно "
"использовать в логике приложения без дополнительных проверок."
msgstr ""
#: ../../root/api/command/validation_status.rst:39
#: ../../root/api/command/validation_status.rst:36
msgid "**Условия получения статуса** ``VALID``:"
msgstr ""
#: ../../root/api/command/validation_status.rst:41
msgid "Флаг с `PossibleValues.NEITHER` передан без значения."
#: ../../root/api/command/validation_status.rst:38
msgid "Флаг с ``PossibleValues.NEITHER`` передан без значения."
msgstr ""
#: ../../root/api/command/validation_status.rst:42
msgid "Флаг с `PossibleValues.ALL` передан с любым значением или без него."
#: ../../root/api/command/validation_status.rst:39
msgid "Флаг с ``PossibleValues.ALL`` передан с любым значением или без него."
msgstr ""
#: ../../root/api/command/validation_status.rst:43
#: ../../root/api/command/validation_status.rst:40
msgid "Значение флага входит в список разрешённых."
msgstr ""
#: ../../root/api/command/validation_status.rst:44
#: ../../root/api/command/validation_status.rst:41
msgid "Значение флага соответствует регулярному выражению."
msgstr ""
#: ../../root/api/command/validation_status.rst:46
#: ../../root/api/command/validation_status.rst:73
msgid "**Пример использования:**"
msgstr ""
#: ../../root/api/command/validation_status.rst:55
msgid "INVALID"
msgstr ""
#: ../../root/api/command/validation_status.rst:62
#: ../../root/api/command/validation_status.rst:53
msgid "Указывает, что флаг или его значение **не прошли** валидацию."
msgstr ""
#: ../../root/api/command/validation_status.rst:64
#: ../../root/api/command/validation_status.rst:55
msgid ""
"Флаги с этим статусом нарушают правила, заданные в `possible_values` "
"соответствующего `Flag`. Их следует обрабатывать как ошибочные."
"Флаги с этим статусом нарушают правила, заданные в ``possible_values`` "
"соответствующего ``Flag``. Их следует обрабатывать как ошибочные."
msgstr ""
#: ../../root/api/command/validation_status.rst:66
#: ../../root/api/command/validation_status.rst:57
msgid "**Условия получения статуса** ``INVALID``:"
msgstr ""
#: ../../root/api/command/validation_status.rst:68
msgid "Флаг с `PossibleValues.NEITHER` передан со значением."
#: ../../root/api/command/validation_status.rst:59
msgid "Флаг с ``PossibleValues.NEITHER`` передан со значением."
msgstr ""
#: ../../root/api/command/validation_status.rst:69
#: ../../root/api/command/validation_status.rst:60
msgid "Значение флага не входит в список разрешённых."
msgstr ""
#: ../../root/api/command/validation_status.rst:70
#: ../../root/api/command/validation_status.rst:61
msgid "Значение флага не соответствует регулярному выражению."
msgstr ""
#: ../../root/api/command/validation_status.rst:71
#: ../../root/api/command/validation_status.rst:62
msgid "Флаг требует значение, но передан без него."
msgstr ""
#: ../../root/api/command/validation_status.rst:82
#: ../../root/api/command/validation_status.rst:67
msgid "UNDEFINED"
msgstr ""
#: ../../root/api/command/validation_status.rst:89
#: ../../root/api/command/validation_status.rst:74
msgid "Указывает, что введённый флаг не был зарегистрирован в команде."
msgstr ""
#: ../../root/api/command/validation_status.rst:91
#: ../../root/api/command/validation_status.rst:76
msgid "**Условия получения статуса** ``UNDEFINED``:"
msgstr ""
#: ../../root/api/command/validation_status.rst:93
#: ../../root/api/command/validation_status.rst:78
msgid "Введённый флаг не найден среди зарегистрированных для данной команды."
msgstr ""
#: ../../root/api/command/validation_status.rst:99
msgid "Практические примеры"
msgstr ""
#: ../../root/api/command/validation_status.rst:102
msgid "Комплексный пример валидации"
msgstr ""
#: ../../root/api/command/validation_status.rst:104
msgid "Пример демонстрирует использование всех статусов в реальном сценарии."
msgstr ""
#~ msgid "case"
#~ msgstr ""