# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2025, kolo
# This file is distributed under the same license as the Argenta package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
#
msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-02-06 23:44+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: en\n"
"Language-Team: en <LL@li.org>\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.17.0\n"

#: ../../root/api/orchestrator/argparser.rst:4
msgid "ArgParser"
msgstr "ArgParser"

#: ../../root/api/orchestrator/argparser.rst:6
msgid ""
"``ArgParser`` предназначен для обработки **аргументов командной строки**,"
" передаваемых приложению при запуске. Важно не путать их с флагами, "
"которые пользователь вводит в интерактивном режиме. ``ArgParser`` "
"позволяет получать внешнюю конфигурацию в момент старта (например, путь к"
" файлу настроек, флаги отладки или режим запуска)."
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 "Initialization"

#: ../../root/api/orchestrator/argparser.rst:21
msgid "Создаёт экземпляр парсера аргументов командной строки."
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 "``name``: Application name for display in help."

#: ../../root/api/orchestrator/argparser.rst:25
msgid "``description``: Описание приложения для отображения в справке."
msgstr "``description``: Application description for display in help."

#: ../../root/api/orchestrator/argparser.rst:26
msgid "``epilog``: Дополнительная информация для отображения в конце справки."
msgstr "``epilog``: Additional information for display at the end of help."

#: ../../root/api/orchestrator/argparser.rst:31
msgid "Атрибуты"
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 ""
"До инициализации ``Orchestrator``, в конструктор которого был передан "
"экземпляр ``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 ""
"Парсинг и валидация аргументов происходят при инициализации "
"``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 "Best Practices"

#: ../../root/api/orchestrator/argparser.rst:47
msgid ""
"Использовать атрибут ``parsed_argspace`` рекомендуется только на этапе "
"настройки приложения. В обработчиках лучшей практикой является получение "
"``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 "**Usage example:**"

#: ../../root/api/orchestrator/argparser.rst:56
msgid "Обработка ошибок"
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 "**Missing required argument:**"

#: ../../root/api/orchestrator/argparser.rst:71
msgid "**Недопустимое значение из списка possible_values:**"
msgstr "**Invalid value from possible_values list:**"

#: ../../root/api/orchestrator/argparser.rst:79
msgid "**Использование устаревшего аргумента:**"
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:"

#: ../../root/api/orchestrator/argparser.rst:90
msgid ""
"Параметр поддерживается начиная с версии CPython 3.13, если версия ниже, "
"то параметр будет игнорироваться."
msgstr ""

