kolo/Argenta
1
0
Fork 0
mirror of https://github.com/koloideal/Argenta.git synced 2026-06-10 10:05:28 +03:00
Code Issues Packages Projects Releases Wiki Activity

Update documentation

Browse Source
This commit is contained in:
kolo
2025-12-03 15:53:39 +03:00
parent 52139e5405
commit 08660f81d7
16 changed files with 425 additions and 239 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/locales/en/LC_MESSAGES/index.po
-1
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
docs/locales/en/LC_MESSAGES/root/api/app/dividing_lines.po
-1
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
docs/locales/en/LC_MESSAGES/root/api/command/flag.po
+69 -51
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -28,40 +27,46 @@ msgid ""
"``Flag`` — это сущность, описывающая флаг команды. Её основная задача — "
"определить параметры флага, включая его имя, префикс и правила валидации."
msgstr ""
"``Flag`` is an entity describing a command flag. Its main purpose is to define "
"flag parameters, including its name, prefix, and validation rules."
#: ../../root/api/command/flag.rst:10
msgid ""
"Документация по :ref:`PossibleValues <root_api_command_possible_values>` "
"— перечисление, определяющее типы допустимых значений."
msgstr ""
"Documentation for :ref:`PossibleValues <root_api_command_possible_values>` "
"— an enumeration defining types of allowed values."
#: ../../root/api/command/flag.rst:12
msgid ""
"Документация по :ref:`InputFlag <root_api_command_input_flag>` — объект "
"обработанного флага, введённого пользователем."
msgstr ""
"Documentation for :ref:`InputFlag <root_api_command_input_flag>` — an object "
"representing a processed flag entered by the user."
#: ../../root/api/command/flag.rst:14
msgid ""
":ref:`Общая информация <root_flags>` о флагах и их использовании в "
"``Argenta``"
msgstr ""
msgstr ":ref:`General information <root_flags>` about flags and their usage in ``Argenta``"
#: ../../root/api/command/flag.rst:19
msgid "Инициализация"
msgstr ""
msgstr "Initialization"
#: ../../root/api/command/flag.rst:30
msgid "Создаёт новый флаг для регистрации в команде."
msgstr ""
msgstr "Creates a new flag for registration in a command."
#: ../../root/api/command/flag.rst:32
msgid "``name``: Имя флага (обязательный параметр)."
msgstr ""
msgstr "``name``: Flag name (required parameter)."
#: ../../root/api/command/flag.rst:33
msgid "``prefix``: Префикс флага (``-``, ``--``, ``---``). По умолчанию ``--``."
msgstr ""
msgstr "``prefix``: Flag prefix (``-``, ``--``, ``---``). Defaults to ``--``."
#: ../../root/api/command/flag.rst:34
msgid ""
@@ -69,32 +74,35 @@ msgid ""
"строк, регулярным выражением или значением из ``PossibleValues``. По "
"умолчанию ``PossibleValues.ALL``, то есть любое значение допустимо."
msgstr ""
"``possible_values``: Value validation rules. Can be a list of strings, a regular "
"expression, or a value from ``PossibleValues``. Defaults to ``PossibleValues.ALL``, "
"meaning any value is allowed."
#: ../../root/api/command/flag.rst:36
msgid "**Атрибуты:**"
msgstr ""
msgstr "**Attributes:**"
#: ../../root/api/command/flag.rst:40
msgid "Имя флага в виде строки."
msgstr ""
msgstr "Flag name as a string."
#: ../../root/api/command/flag.rst:44
msgid "Префикс флага. Один из: ``\"-\"``, ``\"--\"``, ``\"---\"``."
msgstr ""
msgstr "Flag prefix. One of: ``\"-\"``, ``\"--\"``, ``\"---\"``."
#: ../../root/api/command/flag.rst:48
msgid "Допустимые значения для флага."
msgstr ""
msgstr "Allowed values for the flag."
#: ../../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 ""
msgstr "**Usage example:**"
#: ../../root/api/command/flag.rst:59
msgid "Свойства"
msgstr ""
msgstr "Properties"
#: ../../root/api/command/flag.rst:62
msgid "string_entity"
@@ -102,25 +110,27 @@ msgstr ""
#: ../../root/api/command/flag.rst:70
msgid "Возвращает строковое представление флага в формате ``prefix + name``."
msgstr ""
msgstr "Returns the string representation of the flag in the format ``prefix + name``."
#: ../../root/api/command/flag.rst
msgid "return"
msgstr ""
msgstr "return"
#: ../../root/api/command/flag.rst:72 ../../root/api/command/flag.rst:91
msgid "Строковое представление флага"
msgstr ""
msgstr "String representation of the flag"
#: ../../root/api/command/flag.rst:74
msgid ""
"Это свойство объединяет префикс и имя в единую строку, которая "
"представляет флаг так, как он выглядел бы в командной строке."
msgstr ""
"This property combines the prefix and name into a single string that represents "
"the flag as it would appear on the command line."
#: ../../root/api/command/flag.rst:79
msgid "Магические методы"
msgstr ""
msgstr "Magic Methods"
#: ../../root/api/command/flag.rst:82
msgid "__str__"
@@ -128,7 +138,7 @@ msgstr ""
#: ../../root/api/command/flag.rst:89
msgid "Возвращает строковое представление флага (аналогично ``string_entity``)."
msgstr ""
msgstr "Returns the string representation of the flag (similar to ``string_entity``)."
#: ../../root/api/command/flag.rst:102
msgid "__repr__"
@@ -136,11 +146,11 @@ msgstr ""
#: ../../root/api/command/flag.rst:109
msgid "Возвращает отладочное представление объекта."
msgstr ""
msgstr "Returns the debug representation of the object."
#: ../../root/api/command/flag.rst:111
msgid "Строка в формате ``Flag<prefix=..., name=...>``."
msgstr ""
msgstr "String in the format ``Flag<prefix=..., name=...>``."
#: ../../root/api/command/flag.rst:122
msgid "__eq__"
@@ -151,30 +161,31 @@ msgid ""
"Сравнивает два флага на равенство по их строковому представлению "
"(``string_entity``)."
msgstr ""
"Compares two flags for equality based on their string representation (``string_entity``)."
#: ../../root/api/command/flag.rst
msgid "param other"
msgstr ""
msgstr "param other"
#: ../../root/api/command/flag.rst:131
msgid "Объект для сравнения"
msgstr ""
msgstr "Object to compare"
#: ../../root/api/command/flag.rst:132
msgid "**True**, если флаги равны, иначе **False**"
msgstr ""
msgstr "**True** if flags are equal, otherwise **False**"
#: ../../root/api/command/flag.rst:134
msgid "Два флага считаются равными, если их ``string_entity`` идентичны."
msgstr ""
msgstr "Two flags are considered equal if their ``string_entity`` are identical."
#: ../../root/api/command/flag.rst:147
msgid "PredefinedFlags"
msgstr ""
msgstr "PredefinedFlags"
#: ../../root/api/command/flag.rst:149
msgid "``argenta.command.PredefinedFlags``"
msgstr ""
msgstr "``argenta.command.PredefinedFlags``"
#: ../../root/api/command/flag.rst:151
msgid ""
@@ -182,101 +193,104 @@ msgid ""
"использования в приложениях без их ручного создания. Эти флаги покрывают "
"распространённые сценарии."
msgstr ""
"The ``PredefinedFlags`` class provides a set of ready-made flags for use in "
"applications without manual creation. These flags cover common scenarios."
#: ../../root/api/command/flag.rst:153
msgid ""
"Все предопределённые флаги являются атрибутами класса и представляют "
"собой готовые экземпляры ``Flag``."
msgstr ""
"All predefined flags are class attributes and represent ready-made ``Flag`` instances."
#: ../../root/api/command/flag.rst:158
msgid "Информационные флаги"
msgstr ""
msgstr "Informational Flags"
#: ../../root/api/command/flag.rst:163
msgid "Флаг для отображения справки: ``--help``"
msgstr ""
msgstr "Flag for displaying help: ``--help``"
#: ../../root/api/command/flag.rst:165
msgid "``name``: ``\"help\"``"
msgstr ""
msgstr "``name``: ``\"help\"\"`"
#: ../../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 ""
msgstr "``prefix``: ``\"--\"`` (default)"
#: ../../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 ""
msgstr "``possible_values``: ``PossibleValues.NEITHER``"
#: ../../root/api/command/flag.rst:171
msgid "Короткая версия флага справки: ``-H``"
msgstr ""
msgstr "Short version of the help flag: ``-H``"
#: ../../root/api/command/flag.rst:173 ../../root/api/command/flag.rst:231
msgid "``name``: ``\"H\"``"
msgstr ""
msgstr "``name``: ``\"H\"\"`"
#: ../../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 ""
msgstr "``prefix``: ``\"-\"\"`"
#: ../../root/api/command/flag.rst:179
msgid "Флаг для отображения информации: ``--info``"
msgstr ""
msgstr "Flag for displaying information: ``--info``"
#: ../../root/api/command/flag.rst:181
msgid "``name``: ``\"info\"``"
msgstr ""
msgstr "``name``: ``\"info\"\"`"
#: ../../root/api/command/flag.rst:187
msgid "Короткая версия флага информации: ``-I``"
msgstr ""
msgstr "Short version of the info flag: ``-I``"
#: ../../root/api/command/flag.rst:189
msgid "``name``: ``\"I\"``"
msgstr ""
msgstr "``name``: ``\"I\"\"`"
#: ../../root/api/command/flag.rst:196
msgid "Флаги выбора"
msgstr ""
msgstr "Selection Flags"
#: ../../root/api/command/flag.rst:200
msgid "Флаг для выбора всех элементов: ``--all``"
msgstr ""
msgstr "Flag for selecting all items: ``--all``"
#: ../../root/api/command/flag.rst:202
msgid "``name``: ``\"all\"``"
msgstr ""
msgstr "``name``: ``\"all\"\"`"
#: ../../root/api/command/flag.rst:203
msgid "``prefix``: ``\"--\"``"
msgstr ""
msgstr "``prefix``: ``\"--\"\"`"
#: ../../root/api/command/flag.rst:208
msgid "Короткая версия флага выбора всех элементов: ``-A``"
msgstr ""
msgstr "Short version of the select all flag: ``-A``"
#: ../../root/api/command/flag.rst:210
msgid "``name``: ``\"A\"``"
msgstr ""
msgstr "``name``: ``\"A\"\"`"
#: ../../root/api/command/flag.rst:217
msgid "Сетевые флаги"
msgstr ""
msgstr "Network Flags"
#: ../../root/api/command/flag.rst:221
msgid "Флаг для указания IP-адреса хоста: ``--host``"
msgstr ""
msgstr "Flag for specifying host IP address: ``--host``"
#: ../../root/api/command/flag.rst:223
msgid "``name``: ``\"host\"``"
msgstr ""
msgstr "``name``: ``\"host\"\"`"
#: ../../root/api/command/flag.rst:225 ../../root/api/command/flag.rst:233
#, python-brace-format
@@ -284,18 +298,20 @@ msgid ""
"``possible_values``: Регулярное выражение для валидации IPv4: "
"``r\"^\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$\"``"
msgstr ""
"``possible_values``: Regular expression for IPv4 validation: "
"``r\"^\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}$\"``"
#: ../../root/api/command/flag.rst:229
msgid "Короткая версия флага хоста: ``-H``"
msgstr ""
msgstr "Short version of the host flag: ``-H``"
#: ../../root/api/command/flag.rst:237
msgid "Флаг для указания порта: ``--port``"
msgstr ""
msgstr "Flag for specifying port: ``--port``"
#: ../../root/api/command/flag.rst:239
msgid "``name``: ``\"port\"``"
msgstr ""
msgstr "``name``: ``\"port\"\"`"
#: ../../root/api/command/flag.rst:241 ../../root/api/command/flag.rst:249
#, python-brace-format
@@ -303,12 +319,14 @@ msgid ""
"``possible_values``: Регулярное выражение для валидации порта: "
"``r\"^\\d{1,5}$\"``"
msgstr ""
"``possible_values``: Regular expression for port validation: "
"``r\"^\\d{1,5}$\"``"
#: ../../root/api/command/flag.rst:245
msgid "Короткая версия флага порта: ``-P``"
msgstr ""
msgstr "Short version of the port flag: ``-P``"
#: ../../root/api/command/flag.rst:247
msgid "``name``: ``\"P\"``"
msgstr ""
msgstr "``name``: ``\"P\"\"`"
docs/locales/en/LC_MESSAGES/root/api/command/flags.po
+35 -21
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/api/command/flags.rst:4
msgid "Flags"
msgstr ""
msgstr "Flags"
#: ../../root/api/command/flags.rst:6
msgid ""
@@ -30,55 +29,66 @@ msgid ""
"конкретной команды. ``Flags`` служит контейнером, который позволяет "
"удобно добавлять, извлекать, итерировать флаги и проверять их наличие."
msgstr ""
"``Flags`` is a collection of command flags. Its main purpose is to group and manage "
"the set of flags registered for a specific command. ``Flags`` serves as a container "
"that allows convenient addition, retrieval, iteration of flags, and checking their presence."
#: ../../root/api/command/flags.rst:10
msgid ""
"Документация по отдельным флагам (:ref:`Flag <root_api_command_flag>`, "
":ref:`InputFlag <root_api_command_input_flag>`)"
msgstr ""
"Documentation for individual flags (:ref:`Flag <root_api_command_flag>`, "
":ref:`InputFlag <root_api_command_input_flag>`)"
#: ../../root/api/command/flags.rst:12
msgid ""
"Документация по :ref:`InputFlags <root_api_command_input_flags>` — "
"коллекция обработанных флагов, введённых пользователем."
msgstr ""
"Documentation for :ref:`InputFlags <root_api_command_input_flags>` — "
"a collection of processed flags entered by the user."
#: ../../root/api/command/flags.rst:14
msgid ""
":ref:`Общая информация <root_flags>` о флагах и их использовании в "
"приложении ``Argenta``"
msgstr ""
":ref:`General information <root_flags>` about flags and their usage in "
"the ``Argenta`` application"
#: ../../root/api/command/flags.rst:19
msgid "Инициализация"
msgstr ""
msgstr "Initialization"
#: ../../root/api/command/flags.rst:26
msgid "Создаёт новую коллекцию флагов."
msgstr ""
msgstr "Creates a new flag collection."
#: ../../root/api/command/flags.rst:28
msgid ""
"``flags``: Необязательный список флагов типа ``Flag`` для инициализации "
"коллекции. Если не указан, создаётся пустая коллекция."
msgstr ""
"``flags``: Optional list of flags of type ``Flag`` for initializing the collection. "
"If not specified, an empty collection is created."
#: ../../root/api/command/flags.rst:30
msgid "**Атрибуты:**"
msgstr ""
msgstr "**Attributes:**"
#: ../../root/api/command/flags.rst:35
msgid "Список всех зарегистрированных флагов типа ``Flag``."
msgstr ""
msgstr "List of all registered flags of type ``Flag``."
#: ../../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 ""
msgstr "**Usage example:**"
#: ../../root/api/command/flags.rst:46
msgid "Методы"
msgstr ""
msgstr "Methods"
#: ../../root/api/command/flags.rst:49
msgid "add_flag"
@@ -86,27 +96,27 @@ msgstr ""
#: ../../root/api/command/flags.rst:56
msgid "Добавляет флаг в коллекцию."
msgstr ""
msgstr "Adds a flag to the collection."
#: ../../root/api/command/flags.rst
msgid "param flag"
msgstr ""
msgstr "param flag"
#: ../../root/api/command/flags.rst:58
msgid "Флаг типа ``Flag`` для добавления."
msgstr ""
msgstr "Flag of type ``Flag`` to add."
#: ../../root/api/command/flags.rst
msgid "return"
msgstr ""
msgstr "return"
#: ../../root/api/command/flags.rst:59 ../../root/api/command/flags.rst:82
msgid "None."
msgstr ""
msgstr "None."
#: ../../root/api/command/flags.rst:61
msgid "Используется для динамического расширения набора флагов."
msgstr ""
msgstr "Used for dynamically extending the set of flags."
#: ../../root/api/command/flags.rst:72
msgid "add_flags"
@@ -114,21 +124,23 @@ msgstr ""
#: ../../root/api/command/flags.rst:79
msgid "Добавляет в коллекцию список флагов."
msgstr ""
msgstr "Adds a list of flags to the collection."
#: ../../root/api/command/flags.rst
msgid "param flags"
msgstr ""
msgstr "param flags"
#: ../../root/api/command/flags.rst:81
msgid "Список флагов типа ``Flag`` для добавления."
msgstr ""
msgstr "List of flags of type ``Flag`` to add."
#: ../../root/api/command/flags.rst:84
msgid ""
"Метод расширяет коллекцию, добавляя в неё все флаги из переданного "
"списка. Эффективен для пакетного добавления."
msgstr ""
"The method extends the collection by adding all flags from the provided list. "
"Efficient for batch addition."
#: ../../root/api/command/flags.rst:95
msgid "get_flag_by_name"
@@ -136,23 +148,25 @@ msgstr ""
#: ../../root/api/command/flags.rst:102
msgid "Возвращает флаг по имени."
msgstr ""
msgstr "Returns a flag by name."
#: ../../root/api/command/flags.rst
msgid "param name"
msgstr ""
msgstr "param name"
#: ../../root/api/command/flags.rst:104
msgid "Имя искомого флага."
msgstr ""
msgstr "Name of the flag to search for."
#: ../../root/api/command/flags.rst:105
msgid "Объект ``Flag`` или ``None``, если флаг не найден."
msgstr ""
msgstr "``Flag`` object or ``None`` if the flag is not found."
#: ../../root/api/command/flags.rst:107
msgid ""
"Метод возвращает флаг с соответствующим именем. Если флаг не найден, "
"возвращается ``None``."
msgstr ""
"The method returns a flag with the corresponding name. If the flag is not found, "
"``None`` is returned."
docs/locales/en/LC_MESSAGES/root/api/command/index.po
+38 -18
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -29,58 +28,70 @@ msgid ""
"команда связывает хэндлер с триггером, введя который он будет вызван для "
"обработки."
msgstr ""
"``Command`` is the basic unit of functionality in an application. Each command "
"links a handler to a trigger, which when entered will invoke it for processing."
#: ../../root/api/command/index.rst:8
msgid ""
"``Command`` инкапсулирует всю информацию о команде: её триггер (ключевое "
"слово для вызова), описание, набор флагов и список псевдонимов."
msgstr ""
"``Command`` encapsulates all information about a command: its trigger (keyword for invocation), "
"description, set of flags, and list of aliases."
#: ../../root/api/command/index.rst:13
msgid "Инициализация"
msgstr ""
msgstr "Initialization"
#: ../../root/api/command/index.rst:23
msgid "Создаёт новую команду для регистрации в роутере."
msgstr ""
msgstr "Creates a new command for registration in a router."
#: ../../root/api/command/index.rst:25
msgid ""
"``trigger``: Строковый триггер, который пользователь вводит для вызова "
"команды. Является основным идентификатором."
msgstr ""
"``trigger``: String trigger that the user enters to invoke the command. "
"Serves as the primary identifier."
#: ../../root/api/command/index.rst:26
msgid ""
"``description``: Необязательное описание, объясняющее назначение команды."
" Отображается в справке."
msgstr ""
"``description``: Optional description explaining the command's purpose. "
"Displayed in help."
#: ../../root/api/command/index.rst:27
msgid ""
"``flags``: Набор флагов для настройки поведения. Может быть одиночным "
"объектом ``Flag`` или коллекцией ``Flags``."
msgstr ""
"``flags``: Set of flags for configuring behavior. Can be a single ``Flag`` "
"object or a ``Flags`` collection."
#: ../../root/api/command/index.rst:28
msgid "``aliases``: Список строковых псевдонимов для основного триггера."
msgstr ""
msgstr "``aliases``: List of string aliases for the main trigger."
#: ../../root/api/command/index.rst:30 ../../root/api/command/index.rst:108
msgid "**Атрибуты:**"
msgstr ""
msgstr "**Attributes:**"
#: ../../root/api/command/index.rst:34
msgid ""
"Основной триггер команды. Используется для её идентификации при обработке"
" пользовательского ввода."
msgstr ""
"The main command trigger. Used for its identification when processing user input."
#: ../../root/api/command/index.rst:38
msgid ""
"Текстовое описание команды. Если не передано, используется значение по "
"умолчанию."
msgstr ""
"Text description of the command. If not provided, the default value is used."
#: ../../root/api/command/index.rst:42
msgid ""
@@ -88,62 +99,67 @@ msgid ""
"передан ``Flag``, то автоматически конвертируется из одиночного в "
"коллекцию при инициализации."
msgstr ""
"A ``Flags`` object containing all registered flags. If a ``Flag`` was passed, "
"it is automatically converted from a single flag to a collection during initialization."
#: ../../root/api/command/index.rst:46
msgid "Список строковых псевдонимов. Пуст, если псевдонимы не заданы."
msgstr ""
msgstr "List of string aliases. Empty if no aliases are defined."
#: ../../root/api/command/index.rst:48
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
#: ../../root/api/command/index.rst:54
msgid ""
"Подробнее про флаги: :ref:`Flags <root_api_command_flags>` и :ref:`Флаги "
"вводимых команд <root_flags>`."
msgstr ""
"More about flags: :ref:`Flags <root_api_command_flags>` and :ref:`Input command flags <root_flags>`."
#: ../../root/api/command/index.rst:59
msgid "Регистрация команд"
msgstr ""
msgstr "Command Registration"
#: ../../root/api/command/index.rst:61
msgid "Команды передаются в качестве аргумента в декоратор ``@router.command()``."
msgstr ""
msgstr "Commands are passed as an argument to the ``@router.command()`` decorator."
#: ../../root/api/command/index.rst:63
msgid "**Базовый пример:**"
msgstr ""
msgstr "**Basic example:**"
#: ../../root/api/command/index.rst:68
msgid "**Команды с флагами:**"
msgstr ""
msgstr "**Commands with flags:**"
#: ../../root/api/command/index.rst:76
msgid "Работа с псевдонимами"
msgstr ""
msgstr "Working with Aliases"
#: ../../root/api/command/index.rst:78
msgid ""
"Псевдонимы позволяют вызывать один и тот же обработчик разными "
"триггерами, сохраняя флаги и описание команды."
msgstr ""
"Aliases allow invoking the same handler with different triggers while preserving "
"the command's flags and description."
#: ../../root/api/command/index.rst:80
msgid "**Пример с псевдонимами:**"
msgstr ""
msgstr "**Example with aliases:**"
#: ../../root/api/command/index.rst:85
msgid "Теперь пользователь может вызвать команду любым из способов:"
msgstr ""
msgstr "Now the user can invoke the command in any of the following ways:"
#: ../../root/api/command/index.rst:94
msgid "Все эти варианты вызовут один и тот же хэндлер ``handle_shutdown``."
msgstr ""
msgstr "All these variants will invoke the same handler ``handle_shutdown``."
#: ../../root/api/command/index.rst:101
msgid "InputCommand"
msgstr ""
msgstr "InputCommand"
#: ../../root/api/command/index.rst:103
msgid ""
@@ -152,18 +168,22 @@ msgid ""
"обработке пользовательского ввода. Прямая работа с ним возможна при "
"создании пользовательского обработчика для неизвестных команд."
msgstr ""
"``InputCommand`` represents a processed command entered by the user. This internal "
"class is created automatically when processing user input. Direct work with it is "
"possible when creating a custom handler for unknown commands."
#: ../../root/api/command/index.rst:106
msgid ""
"Подробнее о пользовательских обработчиках исключений см. :ref:`здесь "
"<root_error_handling_unknown_command>`."
msgstr ""
"For more details on custom exception handlers, see :ref:`here <root_error_handling_unknown_command>`."
#: ../../root/api/command/index.rst:113
msgid "Строковый триггер, введённый пользователем."
msgstr ""
msgstr "String trigger entered by the user."
#: ../../root/api/command/index.rst:118
msgid "Объект ``InputFlags``, содержащий все введённые и распаршенные флаги."
msgstr ""
msgstr "An ``InputFlags`` object containing all entered and parsed flags."
docs/locales/en/LC_MESSAGES/root/api/command/input_flag.po
+32 -20
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/api/command/input_flag.rst:4
msgid "InputFlag"
msgstr ""
msgstr "InputFlag"
#: ../../root/api/command/input_flag.rst:6
msgid ""
@@ -30,50 +29,61 @@ msgid ""
"информацию о распознанном флаге: его имя, префикс, значение и статус "
"валидации."
msgstr ""
"The ``InputFlag`` object represents a flag entered by the user. It is created "
"as a result of processing user input and contains information about the recognized "
"flag: its name, prefix, value, and validation status."
#: ../../root/api/command/input_flag.rst:10
msgid ""
"Документация по :ref:`Flag <root_api_command_flag>` — класс для "
"регистрации флага."
msgstr ""
"Documentation for :ref:`Flag <root_api_command_flag>` — class for "
"registering a flag."
#: ../../root/api/command/input_flag.rst:12
msgid ""
"Документация по :ref:`ValidationStatus "
"<root_api_command_validation_status>` — статусы валидации флагов."
msgstr ""
"Documentation for :ref:`ValidationStatus "
"<root_api_command_validation_status>` — flag validation statuses."
#: ../../root/api/command/input_flag.rst:17
msgid ""
"Экземпляры этого класса не предназначены для прямого создания. Они "
"содержатся в объекте :ref:`Response <root_api_response>`."
msgstr ""
"Instances of this class are not intended for direct creation. They are "
"contained in the :ref:`Response <root_api_response>` object."
#: ../../root/api/command/input_flag.rst:19
msgid "**Атрибуты:**"
msgstr ""
msgstr "**Attributes:**"
#: ../../root/api/command/input_flag.rst:24
msgid "Имя введённого флага."
msgstr ""
msgstr "Name of the entered flag."
#: ../../root/api/command/input_flag.rst:29
msgid "Префикс флага: ``-``, ``--`` или ``---``."
msgstr ""
msgstr "Flag prefix: ``-``, ``--``, or ``---``."
#: ../../root/api/command/input_flag.rst:33
msgid "Значение, переданное с флагом. Может быть `None` для флагов без значений."
msgstr ""
msgstr "Value passed with the flag. Can be `None` for flags without values."
#: ../../root/api/command/input_flag.rst:38
msgid ""
"Статус валидации флага: ``ValidationStatus.VALID``, "
"``ValidationStatus.INVALID`` или ``ValidationStatus.UNDEFINED``."
msgstr ""
"Flag validation status: ``ValidationStatus.VALID``, "
"``ValidationStatus.INVALID``, or ``ValidationStatus.UNDEFINED``."
#: ../../root/api/command/input_flag.rst:43
msgid "Свойства"
msgstr ""
msgstr "Properties"
#: ../../root/api/command/input_flag.rst:46
msgid "string_entity"
@@ -81,19 +91,19 @@ msgstr ""
#: ../../root/api/command/input_flag.rst:54
msgid "Возвращает строковое представление флага в формате ``prefix + name``."
msgstr ""
msgstr "Returns the string representation of the flag in the format ``prefix + name``."
#: ../../root/api/command/input_flag.rst
msgid "return"
msgstr ""
msgstr "return"
#: ../../root/api/command/input_flag.rst:56
msgid "Строковое представление флага"
msgstr ""
msgstr "String representation of the flag"
#: ../../root/api/command/input_flag.rst:61
msgid "Магические методы"
msgstr ""
msgstr "Magic Methods"
#: ../../root/api/command/input_flag.rst:64
msgid "__str__"
@@ -101,16 +111,16 @@ msgstr ""
#: ../../root/api/command/input_flag.rst:71
msgid "Возвращает строковое представление флага вместе с его значением."
msgstr ""
msgstr "Returns the string representation of the flag along with its value."
#: ../../root/api/command/input_flag.rst:73
msgid "Строка в формате ``флаг значение``."
msgstr ""
msgstr "String in the format ``flag value``."
#: ../../root/api/command/input_flag.rst:75
#: ../../root/api/command/input_flag.rst:95
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
#: ../../root/api/command/input_flag.rst:84
msgid "__repr__"
@@ -118,13 +128,15 @@ msgstr ""
#: ../../root/api/command/input_flag.rst:91
msgid "Возвращает отладочное представление объекта."
msgstr ""
msgstr "Returns the debug representation of the object."
#: ../../root/api/command/input_flag.rst:93
msgid ""
"Строка в формате ``InputFlag<prefix=..., name=..., value=..., "
"status=...>``."
msgstr ""
"String in the format ``InputFlag<prefix=..., name=..., value=..., "
"status=...>``."
#: ../../root/api/command/input_flag.rst:104
msgid "__eq__"
@@ -132,21 +144,21 @@ msgstr ""
#: ../../root/api/command/input_flag.rst:111
msgid "Сравнивает два введённых флага на равенство по имени."
msgstr ""
msgstr "Compares two entered flags for equality by name."
#: ../../root/api/command/input_flag.rst
msgid "param other"
msgstr ""
msgstr "param other"
#: ../../root/api/command/input_flag.rst:113
msgid "Объект для сравнения."
msgstr ""
msgstr "Object to compare."
#: ../../root/api/command/input_flag.rst:114
msgid "**True**, если имена флагов совпадают, иначе **False**."
msgstr ""
msgstr "**True** if flag names match, otherwise **False**."
#: ../../root/api/command/input_flag.rst:116
msgid "Два введённых флага считаются равными, если их имена совпадают."
msgstr ""
msgstr "Two entered flags are considered equal if their names match."
docs/locales/en/LC_MESSAGES/root/api/command/input_flags.po
+45 -21
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/api/command/input_flags.rst:4
msgid "InputFlags"
msgstr ""
msgstr "InputFlags"
#: ../../root/api/command/input_flags.rst:6
msgid ""
@@ -31,44 +30,58 @@ msgid ""
"удобно извлекать, итерировать и проверять наличие флагов, а также "
"работать с их значениями и статусами валидации."
msgstr ""
"``InputFlags`` is a collection of flags entered by the user. Its main purpose is to "
"group and manage the set of flags passed with a command. ``InputFlags`` serves as a "
"container that allows convenient retrieval, iteration, and checking of flag presence, "
"as well as working with their values and validation statuses."
#: ../../root/api/command/input_flags.rst:10
msgid ""
"Документация по отдельным флагам (:ref:`Flag <root_api_command_flag>`, "
":ref:`InputFlag <root_api_command_input_flag>`)"
msgstr ""
"Documentation for individual flags (:ref:`Flag <root_api_command_flag>`, "
":ref:`InputFlag <root_api_command_input_flag>`)"
#: ../../root/api/command/input_flags.rst:12
msgid ""
"Документация по :ref:`InputFlags <root_api_command_input_flags>` — "
"коллекция обработанных флагов, введённых пользователем."
msgstr ""
"Documentation for :ref:`InputFlags <root_api_command_input_flags>` — "
"a collection of processed flags entered by the user."
#: ../../root/api/command/input_flags.rst:14
msgid ""
"Документация по :ref:`Response <root_api_response>` — объект ответа, "
"содержащий ``InputFlags``"
msgstr ""
"Documentation for :ref:`Response <root_api_response>` — response object "
"containing ``InputFlags``"
#: ../../root/api/command/input_flags.rst:16
msgid ""
":ref:`Общая информация <root_flags>` о флагах и их использовании в "
"приложении ``Argenta``"
msgstr ""
":ref:`General information <root_flags>` about flags and their usage in "
"the ``Argenta`` application"
#: ../../root/api/command/input_flags.rst:21
msgid "Инициализация"
msgstr ""
msgstr "Initialization"
#: ../../root/api/command/input_flags.rst:28
msgid "Создаёт новую коллекцию введённых флагов."
msgstr ""
msgstr "Creates a new collection of entered flags."
#: ../../root/api/command/input_flags.rst:30
msgid ""
"``flags``: Необязательный список флагов типа ``InputFlag`` для "
"инициализации коллекции. Если не указан, создаётся пустая коллекция."
msgstr ""
"``flags``: Optional list of flags of type ``InputFlag`` for initializing the collection. "
"If not specified, an empty collection is created."
#: ../../root/api/command/input_flags.rst:33
msgid ""
@@ -76,16 +89,21 @@ msgid ""
"формируются системой при обработке пользовательского ввода и доступны "
"через атрибут ``input_flags`` объекта ``Response``."
msgstr ""
"Instances of this class are usually not created directly. They are automatically "
"formed by the system when processing user input and are accessible through the "
"``input_flags`` attribute of the ``Response`` object."
#: ../../root/api/command/input_flags.rst:35
msgid "**Атрибуты:**"
msgstr ""
msgstr "**Attributes:**"
#: ../../root/api/command/input_flags.rst:40
msgid ""
"Список всех введённых флагов типа ``InputFlag``. Пуст, если флаги не были"
" переданы при инициализации или пользователь не ввёл их с командой."
msgstr ""
"List of all entered flags of type ``InputFlag``. Empty if flags were not passed "
"during initialization or the user did not enter them with the command."
#: ../../root/api/command/input_flags.rst:42
#: ../../root/api/command/input_flags.rst:68
@@ -93,11 +111,11 @@ msgstr ""
#: ../../root/api/command/input_flags.rst:117
#: ../../root/api/command/input_flags.rst:131
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
#: ../../root/api/command/input_flags.rst:51
msgid "Методы"
msgstr ""
msgstr "Methods"
#: ../../root/api/command/input_flags.rst:54
msgid "get_flag_by_name"
@@ -105,29 +123,30 @@ msgstr ""
#: ../../root/api/command/input_flags.rst:61
msgid "Возвращает флаг по имени."
msgstr ""
msgstr "Returns a flag by name."
#: ../../root/api/command/input_flags.rst
msgid "param name"
msgstr ""
msgstr "param name"
#: ../../root/api/command/input_flags.rst:63
msgid "Имя искомого флага (без префикса)."
msgstr ""
msgstr "Name of the flag to search for (without prefix)."
#: ../../root/api/command/input_flags.rst
msgid "return"
msgstr ""
msgstr "return"
#: ../../root/api/command/input_flags.rst:64
msgid "Объект ``InputFlag`` или ``None``, если флаг не найден."
msgstr ""
msgstr "``InputFlag`` object or ``None`` if the flag is not found."
#: ../../root/api/command/input_flags.rst:66
msgid ""
"Метод возвращает первый флаг с соответствующим именем (без учёта "
"префикса)."
msgstr ""
"The method returns the first flag with the corresponding name (ignoring the prefix)."
#: ../../root/api/command/input_flags.rst:77
msgid "add_flag"
@@ -135,26 +154,27 @@ msgstr ""
#: ../../root/api/command/input_flags.rst:84
msgid "Добавляет введённый флаг в коллекцию."
msgstr ""
msgstr "Adds an entered flag to the collection."
#: ../../root/api/command/input_flags.rst
msgid "param flag"
msgstr ""
msgstr "param flag"
#: ../../root/api/command/input_flags.rst:86
msgid "Флаг типа ``InputFlag`` для добавления."
msgstr ""
msgstr "Flag of type ``InputFlag`` to add."
#: ../../root/api/command/input_flags.rst:87
#: ../../root/api/command/input_flags.rst:113
msgid "None."
msgstr ""
msgstr "None."
#: ../../root/api/command/input_flags.rst:89
msgid ""
"Метод добавляет флаг в конец списка ``flags``. Используется для "
"динамического расширения коллекции."
msgstr ""
"The method adds a flag to the end of the ``flags`` list. Used for dynamically extending the collection."
#: ../../root/api/command/input_flags.rst:92
msgid ""
@@ -162,6 +182,8 @@ msgid ""
"автоматически. Однако он может быть полезен для тестирования или ручного "
"создания коллекций."
msgstr ""
"This method is rarely used, as `InputFlags` is usually created automatically. "
"However, it can be useful for testing or manual collection creation."
#: ../../root/api/command/input_flags.rst:103
msgid "add_flags"
@@ -169,27 +191,29 @@ msgstr ""
#: ../../root/api/command/input_flags.rst:110
msgid "Добавляет в коллекцию список введённых флагов."
msgstr ""
msgstr "Adds a list of entered flags to the collection."
#: ../../root/api/command/input_flags.rst
msgid "param flags"
msgstr ""
msgstr "param flags"
#: ../../root/api/command/input_flags.rst:112
msgid "Список флагов типа ``InputFlag`` для добавления."
msgstr ""
msgstr "List of flags of type ``InputFlag`` to add."
#: ../../root/api/command/input_flags.rst:115
msgid ""
"Метод расширяет коллекцию, добавляя в неё все флаги из переданного "
"списка. Эффективен для пакетного добавления."
msgstr ""
"The method extends the collection by adding all flags from the provided list. "
"Efficient for batch addition."
#: ../../root/api/command/input_flags.rst:126
msgid "Практические примеры"
msgstr ""
msgstr "Practical Examples"
#: ../../root/api/command/input_flags.rst:129
msgid "Обработка всех флагов с проверкой статусов"
msgstr ""
msgstr "Processing All Flags with Status Checking"
docs/locales/en/LC_MESSAGES/root/api/command/possible_values.po
+45 -23
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,16 +20,20 @@ msgstr ""
#: ../../root/api/command/possible_values.rst:5
msgid "PossibleValues"
msgstr ""
msgstr "PossibleValues"
#: ../../root/api/command/possible_values.rst:7
msgid ""
"``PossibleValues`` — это перечисление (``Enum``), которое определяет "
"``PossibleValues`` — это перечисление, которое определяет "
"специальные режимы валидации для значений флагов. ``PossibleValues`` "
"используется в параметре ``possible_values`` класса ``Flag``, чтобы "
"указать, может ли флаг принимать значения и какие ограничения на них "
"накладываются."
msgstr ""
"``PossibleValues`` is an enumeration that defines special validation "
"modes for flag values. ``PossibleValues`` is used in the ``possible_values`` parameter "
"of the ``Flag`` class to specify whether a flag can accept values and what restrictions "
"are imposed on them."
#: ../../root/api/command/possible_values.rst:9
msgid ""
@@ -40,18 +43,26 @@ msgid ""
"списками строк и регулярными выражениями для создания гибкой системы "
"валидации."
msgstr ""
"``PossibleValues`` contains two main values: ``NEITHER`` (for flags that cannot "
"accept values) and ``ALL`` (for flags accepting any values). This enumeration is "
"used together with string lists and regular expressions to create a flexible "
"validation system."
#: ../../root/api/command/possible_values.rst:12
msgid ""
"Результат валидации доступен через атрибут ``status`` у экземпляра "
"``InputFlag``. Подробнее см. :ref:`здесь <root_api_command_input_flag>`."
msgstr ""
"The validation result is available through the ``status`` attribute of the "
"``InputFlag`` instance. For more details, see :ref:`here <root_api_command_input_flag>`."
#: ../../root/api/command/possible_values.rst:16
msgid ""
"Документация по :ref:`Flag <root_api_command_flag>` — класс флага, "
"использующий ``PossibleValues``."
msgstr ""
"Documentation for :ref:`Flag <root_api_command_flag>` — flag class "
"using ``PossibleValues``."
#: ../../root/api/command/possible_values.rst:18
msgid ""
@@ -59,20 +70,24 @@ msgid ""
"<root_api_command_validation_status>` — результат валидации ввёденного "
"флага."
msgstr ""
"Documentation for :ref:`ValidationStatus "
"<root_api_command_validation_status>` — validation result of the entered flag."
#: ../../root/api/command/possible_values.rst:20
msgid ""
":ref:`Общая информация <root_flags>` о флагах и их использовании в "
"приложении ``Argenta``"
msgstr ""
":ref:`General information <root_flags>` about flags and their usage in "
"the ``Argenta`` application"
#: ../../root/api/command/possible_values.rst:25
msgid "NEITHER"
msgstr ""
msgstr "NEITHER"
#: ../../root/api/command/possible_values.rst:32
msgid "Указывает, что флаг **не должен** иметь значения."
msgstr ""
msgstr "Indicates that the flag **should not** have a value."
#: ../../root/api/command/possible_values.rst:34
msgid ""
@@ -80,89 +95,96 @@ msgid ""
"командной строке само по себе является информацией. Попытка передать "
"такому флагу значение приведёт к ошибке валидации."
msgstr ""
"Flags with this value work as boolean switches: their presence on the command line "
"is information in itself. Attempting to pass a value to such a flag will result in "
"a validation error."
#: ../../root/api/command/possible_values.rst:36
msgid "**Примеры флагов с** ``NEITHER``:"
msgstr ""
msgstr "**Examples of flags with** ``NEITHER``:"
#: ../../root/api/command/possible_values.rst:38
msgid "``--help`` — флаг справки"
msgstr ""
msgstr "``--help`` — help flag"
#: ../../root/api/command/possible_values.rst:39
msgid "``--verbose`` — флаг подробного вывода"
msgstr ""
msgstr "``--verbose`` — verbose output flag"
#: ../../root/api/command/possible_values.rst:40
msgid "``--force`` — флаг принудительного выполнения"
msgstr ""
msgstr "``--force`` — forced execution flag"
#: ../../root/api/command/possible_values.rst:41
msgid "``-A`` / ``--all`` — флаг выбора всех элементов"
msgstr ""
msgstr "``-A`` / ``--all`` — select all items flag"
#: ../../root/api/command/possible_values.rst:43
#: ../../root/api/command/possible_values.rst:68
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
#: ../../root/api/command/possible_values.rst:52
msgid "ALL"
msgstr ""
msgstr "ALL"
#: ../../root/api/command/possible_values.rst:59
msgid "Указывает, что флаг может принимать **любое** значение."
msgstr ""
msgstr "Indicates that the flag can accept **any** value."
#: ../../root/api/command/possible_values.rst:61
msgid ""
"Флаги с этим значением универсальны и не накладывают ограничений на "
"передаваемые данные. Валидация всегда будет успешной."
msgstr ""
"Flags with this value are universal and do not impose restrictions on the data passed. "
"Validation will always be successful."
#: ../../root/api/command/possible_values.rst:63
msgid "**Примеры флагов с** ``ALL``:"
msgstr ""
msgstr "**Examples of flags with** ``ALL``:"
#: ../../root/api/command/possible_values.rst:65
msgid "``--message`` — произвольное текстовое сообщение"
msgstr ""
msgstr "``--message`` — arbitrary text message"
#: ../../root/api/command/possible_values.rst:66
msgid "``--name`` — произвольное имя"
msgstr ""
msgstr "``--name`` — arbitrary name"
#: ../../root/api/command/possible_values.rst:77
msgid "Параметр possible_values"
msgstr ""
msgstr "The possible_values Parameter"
#: ../../root/api/command/possible_values.rst:79
msgid ""
"``PossibleValues`` используется как один из возможных типов для параметра"
" ``possible_values`` при создании экземпляра ``Flag``."
msgstr ""
"``PossibleValues`` is used as one of the possible types for the ``possible_values`` "
"parameter when creating a ``Flag`` instance."
#: ../../root/api/command/possible_values.rst:81
msgid "**Доступные типы для** ``possible_values``:"
msgstr ""
msgstr "**Available types for** ``possible_values``:"
#: ../../root/api/command/possible_values.rst:83
msgid "``PossibleValues.NEITHER``: флаг без значения."
msgstr ""
msgstr "``PossibleValues.NEITHER``: flag without a value."
#: ../../root/api/command/possible_values.rst:84
msgid "``PossibleValues.ALL``: флаг с любым значением (по умолчанию)."
msgstr ""
msgstr "``PossibleValues.ALL``: flag with any value (default)."
#: ../../root/api/command/possible_values.rst:85
msgid "``list[str]``: флаг с ограниченным набором значений."
msgstr ""
msgstr "``list[str]``: flag with a limited set of values."
#: ../../root/api/command/possible_values.rst:86
msgid "``Pattern[str]``: флаг со значением, проверяемым по регулярному выражению."
msgstr ""
msgstr "``Pattern[str]``: flag with a value validated by a regular expression."
#: ../../root/api/command/possible_values.rst:88
msgid "**Пример комбинированного использования:**"
msgstr ""
msgstr "**Combined usage example:**"
docs/locales/en/LC_MESSAGES/root/api/command/validation_status.po
+37 -20
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/api/command/validation_status.rst:4
msgid "ValidationStatus"
msgstr ""
msgstr "ValidationStatus"
#: ../../root/api/command/validation_status.rst:6
msgid ""
@@ -30,44 +29,57 @@ msgid ""
"отображения результата проверки. ``ValidationStatus`` используется в "
"атрибуте ``status`` класса ``InputFlag``."
msgstr ""
"``ValidationStatus`` is an enumeration that defines the validation state of a flag. "
"Its purpose is to provide standard constants for displaying the validation result. "
"``ValidationStatus`` is used in the ``status`` attribute of the ``InputFlag`` class."
#: ../../root/api/command/validation_status.rst:8
msgid ""
"``ValidationStatus`` содержит три значения: **VALID** (корректный флаг), "
"**INVALID** (некорректный) и **UNDEFINED** (незарегистрированный)."
msgstr ""
"``ValidationStatus`` contains three values: **VALID** (valid flag), "
"**INVALID** (invalid), and **UNDEFINED** (unregistered)."
#: ../../root/api/command/validation_status.rst:12
msgid ""
"Статус валидации устанавливается автоматически при создании экземпляра "
"``InputFlag`` на основе правил, заданных в соответствующем ``Flag``."
msgstr ""
"The validation status is set automatically when creating an ``InputFlag`` instance "
"based on the rules defined in the corresponding ``Flag``."
#: ../../root/api/command/validation_status.rst:16
msgid ""
"Документация по :ref:`InputFlag <root_api_command_input_flag>` — класс "
"введённого флага, использующий ``ValidationStatus``."
msgstr ""
"Documentation for :ref:`InputFlag <root_api_command_input_flag>` — entered flag class "
"using ``ValidationStatus``."
#: ../../root/api/command/validation_status.rst:18
msgid ""
"Документация по :ref:`Flag <root_api_command_flag>` — класс флага с "
"правилами валидации."
msgstr ""
"Documentation for :ref:`Flag <root_api_command_flag>` — flag class with "
"validation rules."
#: ../../root/api/command/validation_status.rst:20
msgid ""
"Документация по :ref:`PossibleValues <root_api_command_possible_values>` "
"— типы допустимых значений."
msgstr ""
"Documentation for :ref:`PossibleValues <root_api_command_possible_values>` "
"— types of allowed values."
#: ../../root/api/command/validation_status.rst:25
msgid "VALID"
msgstr ""
msgstr "VALID"
#: ../../root/api/command/validation_status.rst:32
msgid "Указывает, что флаг и его значение **прошли** валидацию."
msgstr ""
msgstr "Indicates that the flag and its value **passed** validation."
#: ../../root/api/command/validation_status.rst:34
msgid ""
@@ -75,74 +87,79 @@ msgid ""
"``possible_values`` соответствующего ``Flag``. Их можно безопасно "
"использовать в логике приложения без дополнительных проверок."
msgstr ""
"Flags with this status comply with the rules defined in the ``possible_values`` "
"of the corresponding ``Flag``. They can be safely used in application logic without "
"additional checks."
#: ../../root/api/command/validation_status.rst:36
msgid "**Условия получения статуса** ``VALID``:"
msgstr ""
msgstr "**Conditions for receiving** ``VALID`` **status:**"
#: ../../root/api/command/validation_status.rst:38
msgid "Флаг с ``PossibleValues.NEITHER`` передан без значения."
msgstr ""
msgstr "Flag with ``PossibleValues.NEITHER`` passed without a value."
#: ../../root/api/command/validation_status.rst:39
msgid "Флаг с ``PossibleValues.ALL`` передан с любым значением или без него."
msgstr ""
msgstr "Flag with ``PossibleValues.ALL`` passed with any value or without one."
#: ../../root/api/command/validation_status.rst:40
msgid "Значение флага входит в список разрешённых."
msgstr ""
msgstr "Flag value is in the list of allowed values."
#: ../../root/api/command/validation_status.rst:41
msgid "Значение флага соответствует регулярному выражению."
msgstr ""
msgstr "Flag value matches the regular expression."
#: ../../root/api/command/validation_status.rst:46
msgid "INVALID"
msgstr ""
msgstr "INVALID"
#: ../../root/api/command/validation_status.rst:53
msgid "Указывает, что флаг или его значение **не прошли** валидацию."
msgstr ""
msgstr "Indicates that the flag or its value **did not pass** validation."
#: ../../root/api/command/validation_status.rst:55
msgid ""
"Флаги с этим статусом нарушают правила, заданные в ``possible_values`` "
"соответствующего ``Flag``. Их следует обрабатывать как ошибочные."
msgstr ""
"Flags with this status violate the rules defined in the ``possible_values`` "
"of the corresponding ``Flag``. They should be treated as erroneous."
#: ../../root/api/command/validation_status.rst:57
msgid "**Условия получения статуса** ``INVALID``:"
msgstr ""
msgstr "**Conditions for receiving** ``INVALID`` **status:**"
#: ../../root/api/command/validation_status.rst:59
msgid "Флаг с ``PossibleValues.NEITHER`` передан со значением."
msgstr ""
msgstr "Flag with ``PossibleValues.NEITHER`` passed with a value."
#: ../../root/api/command/validation_status.rst:60
msgid "Значение флага не входит в список разрешённых."
msgstr ""
msgstr "Flag value is not in the list of allowed values."
#: ../../root/api/command/validation_status.rst:61
msgid "Значение флага не соответствует регулярному выражению."
msgstr ""
msgstr "Flag value does not match the regular expression."
#: ../../root/api/command/validation_status.rst:62
msgid "Флаг требует значение, но передан без него."
msgstr ""
msgstr "Flag requires a value but was passed without one."
#: ../../root/api/command/validation_status.rst:67
msgid "UNDEFINED"
msgstr ""
msgstr "UNDEFINED"
#: ../../root/api/command/validation_status.rst:74
msgid "Указывает, что введённый флаг не был зарегистрирован в команде."
msgstr ""
msgstr "Indicates that the entered flag was not registered in the command."
#: ../../root/api/command/validation_status.rst:76
msgid "**Условия получения статуса** ``UNDEFINED``:"
msgstr ""
msgstr "**Conditions for receiving** ``UNDEFINED`` **status:**"
#: ../../root/api/command/validation_status.rst:78
msgid "Введённый флаг не найден среди зарегистрированных для данной команды."
msgstr ""
msgstr "The entered flag is not found among those registered for this command."
docs/locales/en/LC_MESSAGES/root/api/orchestrator/argparser.po
+34 -14
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/api/orchestrator/argparser.rst:4
msgid "ArgParser"
msgstr ""
msgstr "ArgParser"
#: ../../root/api/orchestrator/argparser.rst:6
msgid ""
@@ -31,42 +30,50 @@ msgid ""
"позволяет получать внешнюю конфигурацию в момент старта (например, путь к"
" файлу настроек, флаги отладки или режим запуска)."
msgstr ""
"``ArgParser`` is designed for processing **command-line arguments** passed to the "
"application at startup. It's important not to confuse them with flags that the user "
"enters in interactive mode. ``ArgParser`` allows receiving external configuration at "
"startup (e.g., path to settings file, debug flags, or launch mode)."
#: ../../root/api/orchestrator/argparser.rst:11
msgid "Инициализация"
msgstr ""
msgstr "Initialization"
#: ../../root/api/orchestrator/argparser.rst:21
msgid "Создаёт экземпляр парсера аргументов командной строки."
msgstr ""
msgstr "Creates an instance of the command-line argument parser."
#: ../../root/api/orchestrator/argparser.rst:23
msgid ""
"``processed_args``: Список аргументов для обработки при запуске "
"приложения. Подробнее см. :ref:`здесь <root_api_orchestrator_arguments>`."
msgstr ""
"``processed_args``: List of arguments to process at application startup. "
"For more details, see :ref:`here <root_api_orchestrator_arguments>`."
#: ../../root/api/orchestrator/argparser.rst:24
msgid "``name``: Имя приложения для отображения в справке."
msgstr ""
msgstr "``name``: Application name for display in help."
#: ../../root/api/orchestrator/argparser.rst:25
msgid "``description``: Описание приложения для отображения в справке."
msgstr ""
msgstr "``description``: Application description for display in help."
#: ../../root/api/orchestrator/argparser.rst:26
msgid "``epilog``: Дополнительная информация для отображения в конце справки."
msgstr ""
msgstr "``epilog``: Additional information for display at the end of help."
#: ../../root/api/orchestrator/argparser.rst:31
msgid "Атрибуты"
msgstr ""
msgstr "Attributes"
#: ../../root/api/orchestrator/argparser.rst:35
msgid ""
"Экземпляр ``ArgSpace``, содержащий все обработанные аргументы командной "
"строки. Подробнее см. :ref:`здесь <root_api_orchestrator_argspace>`."
msgstr ""
"``ArgSpace`` instance containing all processed command-line arguments. "
"For more details, see :ref:`here <root_api_orchestrator_argspace>`."
#: ../../root/api/orchestrator/argparser.rst:38
msgid ""
@@ -74,6 +81,8 @@ msgid ""
"экземпляр ``ArgParser``, атрибут ``parsed_argspace`` будет содержать "
"пустой ``ArgSpace``."
msgstr ""
"Before initializing ``Orchestrator``, to whose constructor an ``ArgParser`` instance "
"was passed, the ``parsed_argspace`` attribute will contain an empty ``ArgSpace``."
#: ../../root/api/orchestrator/argparser.rst:40
msgid ""
@@ -81,10 +90,12 @@ msgid ""
"``Orchestrator``, поэтому использовать ``parsed_argspace`` "
"**целесообразно только после** этого."
msgstr ""
"Parsing and validation of arguments occur during ``Orchestrator`` initialization, "
"so using ``parsed_argspace`` is **advisable only after** that."
#: ../../root/api/orchestrator/argparser.rst:45
msgid "Лучшие практики"
msgstr ""
msgstr "Best Practices"
#: ../../root/api/orchestrator/argparser.rst:47
msgid ""
@@ -93,42 +104,51 @@ msgid ""
"``ArgSpace`` через DI. Подробнее см. :ref:`здесь "
"<root_dependency_injection>`."
msgstr ""
"Using the ``parsed_argspace`` attribute is recommended only during the application "
"setup phase. In handlers, the best practice is to obtain ``ArgSpace`` through DI. "
"For more details, see :ref:`here <root_dependency_injection>`."
#: ../../root/api/orchestrator/argparser.rst:49
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
#: ../../root/api/orchestrator/argparser.rst:56
msgid "Обработка ошибок"
msgstr ""
msgstr "Error Handling"
#: ../../root/api/orchestrator/argparser.rst:59
msgid ""
"Про типы аргументов подробнее в :ref:`Arguments "
"<root_api_orchestrator_arguments>`"
msgstr ""
"For more details on argument types, see :ref:`Arguments "
"<root_api_orchestrator_arguments>`"
#: ../../root/api/orchestrator/argparser.rst:61
msgid ""
"При работе с аргументами командной строки стандартный ``ArgumentParser`` "
"автоматически обрабатывает следующие ситуации:"
msgstr ""
"When working with command-line arguments, the standard ``ArgumentParser`` "
"automatically handles the following situations:"
#: ../../root/api/orchestrator/argparser.rst:63
msgid "**Отсутствие обязательного аргумента:**"
msgstr ""
msgstr "**Missing required argument:**"
#: ../../root/api/orchestrator/argparser.rst:71
msgid "**Недопустимое значение из списка possible_values:**"
msgstr ""
msgstr "**Invalid value from possible_values list:**"
#: ../../root/api/orchestrator/argparser.rst:79
msgid "**Использование устаревшего аргумента:**"
msgstr ""
msgstr "**Using a deprecated argument:**"
#: ../../root/api/orchestrator/argparser.rst:81
msgid ""
"При использовании аргумента с ``is_deprecated=True`` выводится "
"предупреждение, но выполнение продолжается:"
msgstr ""
"When using an argument with ``is_deprecated=True``, a warning is displayed, "
"but execution continues:"
docs/locales/en/LC_MESSAGES/root/api/orchestrator/argspace.po
+35 -20
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/api/orchestrator/argspace.rst:4
msgid "ArgSpace"
msgstr ""
msgstr "ArgSpace"
#: ../../root/api/orchestrator/argspace.rst:6
msgid ""
@@ -29,34 +28,41 @@ msgid ""
"аргументами командной строки. Его основная задача — предоставить удобный "
"интерфейс для доступа к значениям, переданным при запуске приложения."
msgstr ""
"``ArgSpace`` is a container for storing and managing processed command-line arguments. "
"Its main purpose is to provide a convenient interface for accessing values passed at "
"application startup."
#: ../../root/api/orchestrator/argspace.rst:8
msgid ""
"``ArgSpace`` создаётся автоматически после обработки аргументов с помощью"
" ``ArgParser`` и содержит коллекцию объектов ``InputArgument``."
msgstr ""
"``ArgSpace`` is created automatically after processing arguments using ``ArgParser`` "
"and contains a collection of ``InputArgument`` objects."
#: ../../root/api/orchestrator/argspace.rst:13
msgid "Инициализация"
msgstr ""
msgstr "Initialization"
#: ../../root/api/orchestrator/argspace.rst:15
msgid ""
"Создание экземпляров класса ``ArgSpace`` происходит под `капотом`, вам не"
" нужно создавать их вручную."
msgstr ""
"Creation of ``ArgSpace`` class instances happens under the hood, you don't need to "
"create them manually."
#: ../../root/api/orchestrator/argspace.rst:17
msgid "**Атрибуты:**"
msgstr ""
msgstr "**Attributes:**"
#: ../../root/api/orchestrator/argspace.rst:21
msgid "Список всех обработанных аргументов типа ``InputArgument``."
msgstr ""
msgstr "List of all processed arguments of type ``InputArgument``."
#: ../../root/api/orchestrator/argspace.rst:26
msgid "Методы"
msgstr ""
msgstr "Methods"
#: ../../root/api/orchestrator/argspace.rst:29
msgid "get_by_name"
@@ -64,29 +70,29 @@ msgstr ""
#: ../../root/api/orchestrator/argspace.rst:36
msgid "Возвращает аргумент по имени."
msgstr ""
msgstr "Returns an argument by name."
#: ../../root/api/orchestrator/argspace.rst
msgid "param name"
msgstr ""
msgstr "param name"
#: ../../root/api/orchestrator/argspace.rst:38
msgid "Имя искомого аргумента."
msgstr ""
msgstr "Name of the argument to search for."
#: ../../root/api/orchestrator/argspace.rst
msgid "return"
msgstr ""
msgstr "return"
#: ../../root/api/orchestrator/argspace.rst:39
msgid "Объект ``InputArgument`` или ``None``, если аргумент не найден."
msgstr ""
msgstr "``InputArgument`` object or ``None`` if the argument is not found."
#: ../../root/api/orchestrator/argspace.rst:41
#: ../../root/api/orchestrator/argspace.rst:63
#: ../../root/api/orchestrator/argspace.rst:90
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
#: ../../root/api/orchestrator/argspace.rst:49
msgid "get_by_type"
@@ -94,39 +100,43 @@ msgstr ""
#: ../../root/api/orchestrator/argspace.rst:56
msgid "Возвращает все аргументы определённого типа."
msgstr ""
msgstr "Returns all arguments of a specific type."
#: ../../root/api/orchestrator/argspace.rst
msgid "param arg_type"
msgstr ""
msgstr "param arg_type"
#: ../../root/api/orchestrator/argspace.rst:58
msgid "Тип аргумента (``BooleanArgument`` или ``ValueArgument``)."
msgstr ""
msgstr "Argument type (``BooleanArgument`` or ``ValueArgument``)."
#: ../../root/api/orchestrator/argspace.rst:59
msgid "Список аргументов указанного типа или пустой список."
msgstr ""
msgstr "List of arguments of the specified type or an empty list."
#: ../../root/api/orchestrator/argspace.rst:61
msgid ""
"Метод фильтрует ``all_arguments`` по атрибуту ``founder_class`` и "
"возвращает аргументы, созданные из указанного типа."
msgstr ""
"The method filters ``all_arguments`` by the ``founder_class`` attribute and "
"returns arguments created from the specified type."
#: ../../root/api/orchestrator/argspace.rst:71
msgid "InputArgument"
msgstr ""
msgstr "InputArgument"
#: ../../root/api/orchestrator/argspace.rst:74
msgid ""
"Документация по ``InputArgument`` находится :ref:`здесь "
"<root_api_orchestrator_arguments_inputargument>`."
msgstr ""
"Documentation for ``InputArgument`` is located :ref:`here "
"<root_api_orchestrator_arguments_inputargument>`."
#: ../../root/api/orchestrator/argspace.rst:79
msgid "Примеры использования"
msgstr ""
msgstr "Usage Examples"
#: ../../root/api/orchestrator/argspace.rst:81
msgid ""
@@ -134,18 +144,23 @@ msgid ""
"запуска приложения. Типичный сценарий включает обработку аргументов через"
" ``ArgParser`` и последующее извлечение значений из ``ArgSpace``."
msgstr ""
"``ArgSpace`` is used to access argument values after the application starts. "
"A typical scenario includes processing arguments through ``ArgParser`` and subsequent "
"extraction of values from ``ArgSpace``."
#: ../../root/api/orchestrator/argspace.rst:83
msgid "**Полный пример:**"
msgstr ""
msgstr "**Complete example:**"
#: ../../root/api/orchestrator/argspace.rst:88
msgid ""
"Доступ к аргументам из обработчиков осуществляется с помощью ``di``. "
"Подробнее см. :ref:`здесь <root_dependency_injection>`."
msgstr ""
"Access to arguments from handlers is done using ``di``. "
"For more details, see :ref:`here <root_dependency_injection>`."
#: ../../root/api/orchestrator/argspace.rst:95
msgid "**Запуск приложения:**"
msgstr ""
msgstr "**Running the application:**"
docs/locales/en/LC_MESSAGES/root/api/orchestrator/arguments.po
+32 -17
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -29,12 +28,15 @@ msgid ""
"командной строки. Они позволяют настраивать поведение приложения в момент"
" его запуска, передавая различные параметры конфигурации."
msgstr ""
"The ``Arguments`` module provides classes for working with command-line arguments. "
"They allow configuring application behavior at startup by passing various configuration parameters."
#: ../../root/api/orchestrator/arguments.rst:8
msgid ""
"Аргументы регистрируются в ``ArgParser`` и после обработки становятся "
"доступными в объекте ``ArgSpace``."
msgstr ""
"Arguments are registered in ``ArgParser`` and after processing become available in the ``ArgSpace`` object."
#: ../../root/api/orchestrator/arguments.rst:13
msgid "ValueArgument"
@@ -42,11 +44,11 @@ msgstr ""
#: ../../root/api/orchestrator/arguments.rst:15
msgid "Класс для аргументов, требующих передачи значения."
msgstr ""
msgstr "Class for arguments that require passing a value."
#: ../../root/api/orchestrator/arguments.rst:31
msgid "Создаёт аргумент командной строки, требующий значения."
msgstr ""
msgstr "Creates a command-line argument that requires a value."
#: ../../root/api/orchestrator/arguments.rst
msgid "param name"
@@ -56,7 +58,7 @@ msgstr ""
#: ../../root/api/orchestrator/arguments.rst:74
#: ../../root/api/orchestrator/arguments.rst:117
msgid "Имя аргумента"
msgstr ""
msgstr "Argument name"
#: ../../root/api/orchestrator/arguments.rst
msgid "param prefix"
@@ -65,7 +67,7 @@ msgstr ""
#: ../../root/api/orchestrator/arguments.rst:34
#: ../../root/api/orchestrator/arguments.rst:75
msgid "Префикс (по умолчанию ``--``)"
msgstr ""
msgstr "Prefix (defaults to ``--``)"
#: ../../root/api/orchestrator/arguments.rst
msgid "param help"
@@ -74,7 +76,7 @@ msgstr ""
#: ../../root/api/orchestrator/arguments.rst:35
#: ../../root/api/orchestrator/arguments.rst:76
msgid "Сообщение для справки (``--help``)"
msgstr ""
msgstr "Help message (``--help``)"
#: ../../root/api/orchestrator/arguments.rst
msgid "param possible_values"
@@ -82,7 +84,7 @@ msgstr ""
#: ../../root/api/orchestrator/arguments.rst:36
msgid "Список допустимых значений"
msgstr ""
msgstr "List of allowed values"
#: ../../root/api/orchestrator/arguments.rst
msgid "param default"
@@ -90,7 +92,7 @@ msgstr ""
#: ../../root/api/orchestrator/arguments.rst:37
msgid "Значение по умолчанию, если аргумент не передан"
msgstr ""
msgstr "Default value if the argument is not passed"
#: ../../root/api/orchestrator/arguments.rst
msgid "param is_required"
@@ -101,6 +103,7 @@ msgid ""
"Если ``True``, аргумент становится обязательным. Если не передать при "
"запуске, приложение не запустится"
msgstr ""
"If ``True``, the argument becomes required. If not passed at startup, the application will not start"
#: ../../root/api/orchestrator/arguments.rst
msgid "param is_deprecated"
@@ -111,16 +114,17 @@ msgid ""
"Если ``True``, помечает аргумент как устаревший. Если передать при "
"запуске, будет выведено предупреждение в консоль"
msgstr ""
"If ``True``, marks the argument as deprecated. If passed at startup, a warning will be displayed in the console"
#: ../../root/api/orchestrator/arguments.rst:41
#: ../../root/api/orchestrator/arguments.rst:79
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
#: ../../root/api/orchestrator/arguments.rst:47
#: ../../root/api/orchestrator/arguments.rst:85
msgid "**Запуск приложения:**"
msgstr ""
msgstr "**Running the application:**"
#: ../../root/api/orchestrator/arguments.rst:57
msgid "BooleanArgument"
@@ -131,14 +135,16 @@ msgid ""
"Класс для булевых аргументов, не требующих значения. Их наличие при "
"запуске устанавливает значение в **True**, отсутствие — в **False**."
msgstr ""
"Class for boolean arguments that do not require a value. Their presence at startup "
"sets the value to **True**, absence to **False**."
#: ../../root/api/orchestrator/arguments.rst:72
msgid "Создаёт булев аргумент командной строки без значения."
msgstr ""
msgstr "Creates a boolean command-line argument without a value."
#: ../../root/api/orchestrator/arguments.rst:77
msgid "Если ``True``, помечает аргумент как устаревший"
msgstr ""
msgstr "If ``True``, marks the argument as deprecated"
#: ../../root/api/orchestrator/arguments.rst:98
msgid "InputArgument"
@@ -150,6 +156,8 @@ msgid ""
"его наполнителем. Подробнее о нём см. :ref:`здесь "
"<root_api_orchestrator_argspace>`."
msgstr ""
"``InputArgument`` is directly related to the ``ArgSpace`` container and serves as its filler. "
"For more details, see :ref:`here <root_api_orchestrator_argspace>`."
#: ../../root/api/orchestrator/arguments.rst:103
msgid ""
@@ -157,10 +165,12 @@ msgid ""
"используется внутри ``ArgSpace`` для хранения значений, полученных после "
"парсинга."
msgstr ""
"Represents a processed command-line argument. This class is used inside ``ArgSpace`` "
"to store values obtained after parsing."
#: ../../root/api/orchestrator/arguments.rst:115
msgid "Создаёт экземпляр обработанного входного аргумента."
msgstr ""
msgstr "Creates an instance of a processed input argument."
#: ../../root/api/orchestrator/arguments.rst
msgid "param value"
@@ -171,6 +181,8 @@ msgid ""
"Значение аргумента. Для ``BooleanArgument`` — **True**, если аргумент "
"передан, и **False**, если нет; для ``ValueArgument`` — введённая строка"
msgstr ""
"Argument value. For ``BooleanArgument`` — **True** if the argument is passed, and **False** if not; "
"for ``ValueArgument`` — the entered string"
#: ../../root/api/orchestrator/arguments.rst
msgid "param founder_class"
@@ -181,32 +193,35 @@ msgid ""
"Класс-родитель, из которого был создан аргумент (``BooleanArgument`` или "
"``ValueArgument``)"
msgstr ""
"Parent class from which the argument was created (``BooleanArgument`` or ``ValueArgument``)"
#: ../../root/api/orchestrator/arguments.rst:121
msgid "**Атрибуты:**"
msgstr ""
msgstr "**Attributes:**"
#: ../../root/api/orchestrator/arguments.rst:125
msgid ""
"Имя аргумента, указанное при создании ``ValueArgument`` или "
"``BooleanArgument``."
msgstr ""
"Argument name specified when creating ``ValueArgument`` or ``BooleanArgument``."
#: ../../root/api/orchestrator/arguments.rst:129
msgid "Значение аргумента. Тип зависит от исходного класса:"
msgstr ""
msgstr "Argument value. Type depends on the source class:"
#: ../../root/api/orchestrator/arguments.rst:131
msgid "Для ``BooleanArgument``: **True**, если аргумент был передан"
msgstr ""
msgstr "For ``BooleanArgument``: **True** if the argument was passed"
#: ../../root/api/orchestrator/arguments.rst:132
msgid ""
"Для ``ValueArgument``: строка с переданным значением или значением по "
"умолчанию"
msgstr ""
"For ``ValueArgument``: string with the passed value or default value"
#: ../../root/api/orchestrator/arguments.rst:136
msgid "Ссылка на класс-родитель. Используется для определения типа и фильтрации."
msgstr ""
msgstr "Reference to the parent class. Used for type determination and filtering."
docs/locales/en/LC_MESSAGES/root/api/orchestrator/index.po
+22 -9
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
@@ -21,7 +20,7 @@ msgstr ""
#: ../../root/api/orchestrator/index.rst:4
msgid "Orchestrator"
msgstr ""
msgstr "Orchestrator"
#: ../../root/api/orchestrator/index.rst:6
msgid ""
@@ -29,6 +28,8 @@ msgid ""
" оркестрирует приложение, парсер командной строки, ``di`` и остальные "
"компоненты, находящиеся по иерархии на уровне с ``App``."
msgstr ""
"``Orchestrator`` is a high-level component that configures and orchestrates the application, "
"command-line parser, ``di``, and other components at the same hierarchical level as ``App``."
#: ../../root/api/orchestrator/index.rst:8
msgid ""
@@ -36,14 +37,16 @@ msgid ""
"команд, маршрутизация), ``Orchestrator`` подготавливает окружение для его"
" работы и служит точкой входа в приложение."
msgstr ""
"While ``App`` is responsible for interactive session logic (command input, routing), "
"``Orchestrator`` prepares the environment for its operation and serves as the entry point to the application."
#: ../../root/api/orchestrator/index.rst:13
msgid "Инициализация"
msgstr ""
msgstr "Initialization"
#: ../../root/api/orchestrator/index.rst:28
msgid "Создаёт и конфигурирует экземпляр ``Orchestrator``."
msgstr ""
msgstr "Creates and configures an ``Orchestrator`` instance."
#: ../../root/api/orchestrator/index.rst:30
msgid ""
@@ -51,6 +54,8 @@ msgid ""
" командной строки при запуске скрипта (не путать с командами в "
"интерактивном режиме)."
msgstr ""
"``arg_parser``: ``ArgParser`` instance responsible for parsing command-line arguments "
"at script startup (not to be confused with commands in interactive mode)."
#: ../../root/api/orchestrator/index.rst:31
msgid ""
@@ -58,6 +63,8 @@ msgid ""
"``dishka.Provider`` для добавления ваших сервисов (например, подключений "
"к БД или API-клиентов) в DI-контейнер."
msgstr ""
"``custom_providers``: List of custom ``dishka.Provider`` providers for adding your services "
"(e.g., database connections or API clients) to the DI container."
#: ../../root/api/orchestrator/index.rst:32
msgid ""
@@ -65,34 +72,38 @@ msgid ""
"автоматически внедрит зависимости в обработчики команд, инспектируя их "
"сигнатуры."
msgstr ""
"``auto_inject_handlers``: If **True** (default), ``dishka`` will automatically inject "
"dependencies into command handlers by inspecting their signatures."
#: ../../root/api/orchestrator/index.rst:37
msgid "Основные методы"
msgstr ""
msgstr "Main Methods"
#: ../../root/api/orchestrator/index.rst:41
msgid ""
"Это главный метод, который запускает приложение. Он запускает бесконечный"
" цикл ввода -> вывода."
msgstr ""
"This is the main method that starts the application. It launches an infinite input -> output loop."
#: ../../root/api/orchestrator/index.rst
msgid "Parameters"
msgstr ""
msgstr "Parameters"
#: ../../root/api/orchestrator/index.rst:43
msgid "Экземпляр ``App``, который будет запущен."
msgstr ""
msgstr "``App`` instance to be launched."
#: ../../root/api/orchestrator/index.rst:48
msgid "Назначение и использование"
msgstr ""
msgstr "Purpose and Usage"
#: ../../root/api/orchestrator/index.rst:50
msgid ""
"``Orchestrator`` абстрагирует сложность, связанную с настройкой ``di`` и "
"парсингом стартовых аргументов."
msgstr ""
"``Orchestrator`` abstracts the complexity associated with setting up ``di`` and parsing startup arguments."
#: ../../root/api/orchestrator/index.rst:52
msgid ""
@@ -100,8 +111,10 @@ msgid ""
"интерактивной сессии, а ``Orchestrator`` — за подготовку окружения и "
"запуск приложения."
msgstr ""
"This approach separates responsibilities: ``App`` is responsible for interactive session logic, "
"while ``Orchestrator`` handles environment preparation and application launch."
#: ../../root/api/orchestrator/index.rst:54
msgid "**Пример использования:**"
msgstr ""
msgstr "**Usage example:**"
docs/locales/en/LC_MESSAGES/root/quickstart.po
-1
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
docs/locales/en/LC_MESSAGES/root/testing.po
-1
View File
@@ -3,7 +3,6 @@
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
docs/root/api/command/possible_values.rst
+1 -1
View File
@@ -4,7 +4,7 @@
PossibleValues
==============
``PossibleValues`` — это перечисление (``Enum``), которое определяет специальные режимы валидации для значений флагов. ``PossibleValues`` используется в параметре ``possible_values`` класса ``Flag``, чтобы указать, может ли флаг принимать значения и какие ограничения на них накладываются.
``PossibleValues`` — это перечисление, которое определяет специальные режимы валидации для значений флагов. ``PossibleValues`` используется в параметре ``possible_values`` класса ``Flag``, чтобы указать, может ли флаг принимать значения и какие ограничения на них накладываются.
``PossibleValues`` содержит два основных значения: ``NEITHER`` (для флагов, которые не могут принимать значения) и ``ALL`` (для флагов, принимающих любые значения). Это перечисление используется вместе со списками строк и регулярными выражениями для создания гибкой системы валидации.