mirror of
https://github.com/koloideal/Argenta.git
synced 2026-06-10 18:15:28 +03:00
Update documentation and code snippets
This commit is contained in:
@@ -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"
|
||||
@@ -52,7 +52,9 @@ msgid "``farewell_message``: Сообщение, выводимое при вы
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:43
|
||||
msgid "``exit_command``: Команда, используемая для выхода из приложения."
|
||||
msgid ""
|
||||
"``exit_command``: Команда, которая маркируется как триггер для выхода из "
|
||||
"приложения."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:44
|
||||
@@ -63,20 +65,20 @@ msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:45
|
||||
msgid ""
|
||||
"``ignore_command_register``: Если ``True``, регистр команд игнорируется "
|
||||
"при поиске обработчика."
|
||||
"``ignore_command_register``: Если ``True``, регистр вводимых команд "
|
||||
"игнорируется при поиске обработчика."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:46
|
||||
msgid ""
|
||||
"``dividing_line``: Стиль разделительной линии (``StaticDividingLine`` или"
|
||||
" ``DynamicDividingLine``)."
|
||||
"``dividing_line``: Тип разделительной линии (``StaticDividingLine`` или "
|
||||
"``DynamicDividingLine``)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:47
|
||||
msgid ""
|
||||
"``repeat_command_groups_printing``: Если ``True``, список доступных команд "
|
||||
"выводится перед каждым вводом."
|
||||
"``repeat_command_groups_printing``: Если ``True``, список доступных "
|
||||
"команд выводится перед каждым вводом."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:48
|
||||
@@ -86,13 +88,15 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:49
|
||||
msgid "``autocompleter``: Объект, отвечающий за автодополнение команд."
|
||||
msgid ""
|
||||
"``autocompleter``: Экземпляр класса :ref:`AutoCompleter "
|
||||
"<root_api_app_autocompleter>`, отвечающий за автодополнение команд."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:50
|
||||
msgid ""
|
||||
"``print_func``: Функция для вывода всех системных сообщений (по умолчанию"
|
||||
" ``rich.print``)."
|
||||
" ``rich.Console().print``)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:55
|
||||
@@ -124,7 +128,7 @@ msgstr ""
|
||||
#: ../../root/api/app/index.rst:71
|
||||
msgid ""
|
||||
"Добавляет текстовое сообщение, которое выводится при запуске приложения "
|
||||
"после `initial_message`."
|
||||
"после ``initial_message``."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:73
|
||||
@@ -154,17 +158,15 @@ msgid ""
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:92
|
||||
msgid "Устанавливает шаблон для форматирования строки описания команды."
|
||||
msgid "Устанавливает шаблон для форматирования описания команды."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:94
|
||||
msgid ""
|
||||
"Обработчик принимает триггер команды (``str``) и её описание (``str``), а"
|
||||
" возвращает отформатированную строку."
|
||||
msgid "Обработчик принимает триггер команды (``str``) и её описание (``str``)."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:100
|
||||
msgid "Устанавливает обработчик для некорректного синтаксиса флагов."
|
||||
msgid "Устанавливает обработчик при некорректном введённом синтаксисе флагов."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:102 ../../root/api/app/index.rst:110
|
||||
@@ -172,19 +174,19 @@ msgid "Обработчик принимает строку, введённую
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:108
|
||||
msgid "Устанавливает обработчик для повторяющихся флагов в команде."
|
||||
msgid "Устанавливает обработчик при повторяющихся флагах в введённой команде."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:116
|
||||
msgid "Устанавливает обработчик для неизвестной команды."
|
||||
msgid "Устанавливает обработчик при вводе неизвестной команды."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:118
|
||||
msgid "Обработчик принимает объект ``InputCommand``."
|
||||
msgid "Обработчик принимает объект ``InputCommand`` - объект введённой команды."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:124
|
||||
msgid "Устанавливает обработчик для пустого ввода."
|
||||
msgid "Устанавливает обработчик при вводе пустой строки."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:126
|
||||
@@ -205,227 +207,37 @@ msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:149
|
||||
msgid ""
|
||||
"`PredefinedMessages` — это перечисление (Enum), содержащее набор готовых "
|
||||
"к использованию строковых сообщений. Они отформатированы с использованием"
|
||||
" синтаксиса `rich` и предназначены для вывода стандартной информации, "
|
||||
"такой как подсказки по использованию."
|
||||
"``PredefinedMessages`` — это контейнер, содержащий набор готовых к "
|
||||
"использованию сообщений. Они отформатированы с использованием синтаксиса "
|
||||
"``rich`` и предназначены для вывода стандартной информации, такой как "
|
||||
"подсказки по использованию."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:151
|
||||
msgid "Реккомендуется использовать их при старте приложения."
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:177
|
||||
#: ../../root/api/app/index.rst:178
|
||||
msgid "Строка: ``[b dim]Usage[/b dim]: [i]<command> <[green]flags[/green]>[/i]``"
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:179
|
||||
#: ../../root/api/app/index.rst:180
|
||||
msgid "Отображается как: ``Usage: <command> <flags>``"
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:183
|
||||
#: ../../root/api/app/index.rst:184
|
||||
msgid "Строка: ``[b dim]Help[/b dim]: [i]<command>[/i] [b red]--help[/b red]``"
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:185
|
||||
#: ../../root/api/app/index.rst:186
|
||||
msgid "Отображается как: ``Help: <command> --help``"
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:189
|
||||
#: ../../root/api/app/index.rst:190
|
||||
msgid "Строка: ``[b dim]Autocomplete[/b dim]: [i]<part>[/i] [bold]<tab>``"
|
||||
msgstr ""
|
||||
|
||||
#: ../../root/api/app/index.rst:191
|
||||
#: ../../root/api/app/index.rst:192
|
||||
msgid "Отображается как: ``Autocomplete: <part> <tab>``"
|
||||
msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Объект ``App`` является центральной сущностью"
|
||||
#~ " библиотеки ``Argenta``. Он выступает в "
|
||||
#~ "роли ядра вашего консольного приложения, "
|
||||
#~ "отвечая за его конфигурацию, управление "
|
||||
#~ "жизненным циклом, обработку команд и "
|
||||
#~ "взаимодействие с пользователем. ``App`` "
|
||||
#~ "координирует работу всех остальных "
|
||||
#~ "компонентов, таких как роутеры, обработчики"
|
||||
#~ " команд и системные сообщения."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Создает и настраивает экземпляр приложения ``Argenta``."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``prompt``: Строка-приглашение, которая "
|
||||
#~ "отображается перед вводом каждой команды. "
|
||||
#~ "По умолчанию: **\"What do you want "
|
||||
#~ "to do?\\\\n\\\\n\"**."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``initial_message``: Приветственное сообщение, "
|
||||
#~ "которое выводится при запуске приложения."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``farewell_message``: Прощальное сообщение при "
|
||||
#~ "завершении работы приложения."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``exit_command``: Сущность команды, которая "
|
||||
#~ "будет маркирована как команда для выхода"
|
||||
#~ " из приложения."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``system_router_title``: Заголовок для системного"
|
||||
#~ " роутера, который содержит команду выхода"
|
||||
#~ " и другие системные команды."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``ignore_command_register``: Если **True** (по "
|
||||
#~ "умолчанию), регистр введенных команд будет "
|
||||
#~ "игнорироваться при поиске обработчика."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``dividing_line``: Объект, управляющий стилем "
|
||||
#~ "разделительной линии. Может быть "
|
||||
#~ "**StaticDividingLine** или **DynamicDividingLine**."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``repeat_command_groups_printing``: Если **True** (по "
|
||||
#~ "умолчанию), описание доступных команд будет"
|
||||
#~ " выводиться перед каждым вводом."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``override_system_messages``: Если **True** (по "
|
||||
#~ "умолчанию), стандартное форматирование системных "
|
||||
#~ "сообщений (цвета, ASCII-арт) будет отключено."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``autocompleter``: Объект, отвечающий за логику автодополнения команд."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``print_func``: Функция, используемая для "
|
||||
#~ "вывода всех системных сообщений. По "
|
||||
#~ "умолчанию используется ``rich.console.Console().print``."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Регистрирует один ``Router`` в приложении. "
|
||||
#~ "Все команды, определенные в этом "
|
||||
#~ "роутере, становятся доступными для вызова."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Объект роутера, который нужно зарегистрировать."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Регистрирует несколько роутеров одновременно. "
|
||||
#~ "Является удобной оберткой над "
|
||||
#~ "``include_router``."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Последовательность объектов ``Router`` для регистрации."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Добавляет дополнительное текстовое сообщение, "
|
||||
#~ "которое будет выведено на экран при "
|
||||
#~ "запуске приложения, сразу после "
|
||||
#~ "`initial_message`."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``App`` позволяет гибко настраивать реакцию"
|
||||
#~ " на различные события, такие как "
|
||||
#~ "ошибки ввода или ввод неизвестной "
|
||||
#~ "команды."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Устанавливает пользовательский шаблон для "
|
||||
#~ "форматирования строки, описывающей доступную "
|
||||
#~ "команду (триггер + описание)."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``DescriptionMessageGenerator`` -> ``Callable[[str, str], str]``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Где первый аргумент - это триггер "
|
||||
#~ "команды, а второй - ее описание, "
|
||||
#~ "возвращает строку, которая является "
|
||||
#~ "форматированной строкой."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Устанавливает обработчик, который вызывается "
|
||||
#~ "при некорректном синтаксисе флагов в "
|
||||
#~ "введенной команде."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``NonStandardBehaviorHandler[str]`` -> ``Callable[[str], None]``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Где первый и единственный аргумент - "
|
||||
#~ "это необработанная строка пользовательского "
|
||||
#~ "ввода."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Устанавливает обработчик для ситуации, когда"
|
||||
#~ " пользователь вводит один и тот же"
|
||||
#~ " флаг несколько раз."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Устанавливает обработчик, который срабатывает, "
|
||||
#~ "если введенная команда не была найдена"
|
||||
#~ " ни в одном из зарегистрированных "
|
||||
#~ "роутеров."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``NonStandardBehaviorHandler[InputCommand]`` -> "
|
||||
#~ "``Callable[[InputCommand], None]``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Где первый и единственный аргумент - "
|
||||
#~ "это распаршенный в объект InputCommand "
|
||||
#~ "ввод пользователя."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Устанавливает обработчик для случая, когда "
|
||||
#~ "пользователь отправляет пустую строку вместо"
|
||||
#~ " команды."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "``EmptyCommandHandler`` -> ``Callable[[], None]``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Не принимает и не возвращает ничего."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Позволяет переопределить стандартное поведение "
|
||||
#~ "при вызове команды выхода. По умолчанию"
|
||||
#~ " просто выводится ``farewell_message``."
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``NonStandardBehaviorHandler[Response]`` -> "
|
||||
#~ "``Callable[[Response], None]``"
|
||||
#~ msgstr ""
|
||||
|
||||
#~ msgid "Где первый и единственный аргумент - это объект ответа, ``Response``."
|
||||
#~ msgstr ""
|
||||
|
||||
|
||||
Reference in New Issue
Block a user