mirror of
https://github.com/koloideal/Argenta.git
synced 2026-08-08 17:01:13 +03:00
update docs and cli module
This commit is contained in:
@@ -7,7 +7,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Argenta \n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2025-07-25 18:00+0300\n"
|
||||
"POT-Creation-Date: 2026-08-03 18:51+0300\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language: en\n"
|
||||
@@ -18,248 +18,583 @@ msgstr ""
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
"Generated-By: Babel 2.17.0\n"
|
||||
|
||||
#: ../../root/cli.rst:3
|
||||
msgid "Командная строка"
|
||||
msgstr "Command Line Interface"
|
||||
#: ../../root/cli.rst:4
|
||||
msgid "CLI"
|
||||
msgstr "CLI"
|
||||
|
||||
#: ../../root/cli.rst:5
|
||||
#: ../../root/cli.rst:6
|
||||
msgid ""
|
||||
"Помимо библиотеки, ``Argenta`` поставляется с собственным CLI-инструментом, "
|
||||
"который помогает создавать проекты, запускать приложения, инспектировать "
|
||||
"маршруты и собирать бинарники."
|
||||
"Помимо библиотеки, ``Argenta`` поставляется с собственным "
|
||||
"CLI-инструментом. Он берёт на себя рутину, которая сопровождает "
|
||||
"разработку CLI-приложений: создаёт каркас проекта, запускает приложение, "
|
||||
"инспектирует зарегистрированные маршруты и собирает standalone-бинарник."
|
||||
msgstr ""
|
||||
"In addition to the library, ``Argenta`` ships with its own CLI tool that "
|
||||
"helps scaffold projects, run applications, inspect routes, and build binaries."
|
||||
"In addition to the library, ``Argenta`` ships with its own CLI tool. It "
|
||||
"takes over the routine that surrounds CLI app development: scaffolds a "
|
||||
"project, runs the application, inspects registered routes, and builds a "
|
||||
"standalone binary."
|
||||
|
||||
#: ../../root/cli.rst:8
|
||||
msgid ""
|
||||
"CLI поставляется как опциональная зависимость — основная библиотека "
|
||||
"остаётся лёгкой, а инструмент доступен только тем, кому он нужен."
|
||||
msgstr ""
|
||||
"The CLI is shipped as an optional dependency — the core library stays "
|
||||
"light, and the tool is available only to those who need it."
|
||||
|
||||
#: ../../root/cli.rst:11
|
||||
msgid "Установка"
|
||||
msgstr "Installation"
|
||||
|
||||
#: ../../root/cli.rst:10
|
||||
msgid "CLI доступен как опциональная зависимость:"
|
||||
msgstr "The CLI is available as an optional dependency:"
|
||||
#: ../../root/cli.rst:13
|
||||
msgid "CLI доступен как опциональная зависимость ``[cli]``:"
|
||||
msgstr "The CLI is available as the optional ``[cli]`` dependency:"
|
||||
|
||||
#: ../../root/cli.rst:16
|
||||
#: ../../root/cli.rst:23
|
||||
msgid "После установки команда ``argenta`` доступна в терминале:"
|
||||
msgstr "After installation, the ``argenta`` command is available in the terminal:"
|
||||
|
||||
#: ../../root/cli.rst:34
|
||||
msgid ""
|
||||
"После установки команда ``argenta`` доступна в терминале:"
|
||||
"Если ``argenta`` установлена без extras, команда ``argenta`` не будет "
|
||||
"доступна. Установите с ``[cli]``, чтобы получить доступ к "
|
||||
"CLI-инструменту."
|
||||
msgstr ""
|
||||
"After installation, the ``argenta`` command is available in the terminal:"
|
||||
"If ``argenta`` is installed without extras, the ``argenta`` command will "
|
||||
"not be available. Install with ``[cli]`` to get access to the CLI tool."
|
||||
|
||||
#: ../../root/cli.rst:22
|
||||
msgid ""
|
||||
"Если вы устанавливали ``argenta`` без extras, CLI-инструмент не будет "
|
||||
"доступен. Установите с ``[cli]`` для доступа к команде ``argenta``."
|
||||
msgstr ""
|
||||
"If you installed ``argenta`` without extras, the CLI tool will not be "
|
||||
"available. Install with ``[cli]`` to access the ``argenta`` command."
|
||||
|
||||
#: ../../root/cli.rst:25
|
||||
#: ../../root/cli.rst:37
|
||||
msgid "Флаг ``--version``"
|
||||
msgstr "The ``--version`` flag"
|
||||
|
||||
#: ../../root/cli.rst:27
|
||||
#: ../../root/cli.rst:39
|
||||
msgid "Показать установленную версию ``Argenta``:"
|
||||
msgstr "Show the installed ``Argenta`` version:"
|
||||
|
||||
#: ../../root/cli.rst:35
|
||||
msgid "Создание проектов"
|
||||
msgstr "Scaffolding Projects"
|
||||
|
||||
#: ../../root/cli.rst:38
|
||||
msgid "Команда ``new``"
|
||||
msgstr "The ``new`` command"
|
||||
|
||||
#: ../../root/cli.rst:40
|
||||
msgid "Создаёт новую директорию проекта с boilerplate-кодом."
|
||||
msgstr "Creates a new project directory with boilerplate code."
|
||||
|
||||
#: ../../root/cli.rst:44
|
||||
msgid "``project_name`` — имя директории проекта (обязательный аргумент)."
|
||||
msgstr "``project_name`` — project directory name (required argument)."
|
||||
|
||||
#: ../../root/cli.rst:45
|
||||
msgid "``--with-arch`` — архитектура проекта: ``flat`` (по умолчанию) или ``src``."
|
||||
msgstr "``--with-arch`` — project architecture: ``flat`` (default) or ``src``."
|
||||
msgid "Аналогично через короткий флаг:"
|
||||
msgstr "Equivalently, via the short flag:"
|
||||
|
||||
#: ../../root/cli.rst:53
|
||||
msgid "При архитектуре ``flat`` создаётся следующая структура:"
|
||||
msgstr "With the ``flat`` architecture, the following structure is created:"
|
||||
#: ../../root/cli.rst:56
|
||||
msgid "Формат entrypoint"
|
||||
msgstr "Entrypoint format"
|
||||
|
||||
#: ../../root/cli.rst:59
|
||||
msgid "При архитектуре ``src``:"
|
||||
msgstr "With the ``src`` architecture:"
|
||||
#: ../../root/cli.rst:58
|
||||
msgid ""
|
||||
"Команды ``run``, ``routes`` и ``build`` принимают **entrypoint** — "
|
||||
"указатель на объект внутри проекта, который нужно запустить, "
|
||||
"инспектировать или собрать. Единый формат описан здесь, чтобы не "
|
||||
"повторяться в каждой команде."
|
||||
msgstr ""
|
||||
"The ``run``, ``routes`` and ``build`` commands accept an **entrypoint** —"
|
||||
" a pointer to an object inside the project to run, inspect, or build. The"
|
||||
" shared format is documented here once instead of repeating it in each "
|
||||
"command."
|
||||
|
||||
#: ../../root/cli.rst:60
|
||||
msgid "Формат entrypoint:"
|
||||
msgstr "Entrypoint format:"
|
||||
|
||||
#: ../../root/cli.rst:67
|
||||
msgid "Команда ``init``"
|
||||
msgstr "The ``init`` command"
|
||||
msgid "Поддерживаются два способа адресации:"
|
||||
msgstr "Two addressing styles are supported:"
|
||||
|
||||
#: ../../root/cli.rst:69
|
||||
msgid ""
|
||||
"Инициализирует boilerplate в текущей директории. Удобно, когда проект уже "
|
||||
"существует и нужно добавить структуру Argenta."
|
||||
"**Путь к файлу** — ``app/main.py:main``. Удобно при работе с конкретным "
|
||||
"файлом."
|
||||
msgstr ""
|
||||
"Initializes boilerplate in the current directory. Useful when the project "
|
||||
"already exists and you need to add Argenta structure."
|
||||
"**File path** — ``app/main.py:main``. Convenient when working with a "
|
||||
"specific file."
|
||||
|
||||
#: ../../root/cli.rst:75
|
||||
#: ../../root/cli.rst:70
|
||||
msgid ""
|
||||
"Команда ``init`` не перезаписывает существующие файлы — они будут пропущены."
|
||||
"**Dotted-модуль** — ``my_project.application:main``. Естественно для "
|
||||
"установленных пакетов."
|
||||
msgstr ""
|
||||
"The ``init`` command does not overwrite existing files — they will be skipped."
|
||||
"**Dotted module** — ``my_project.application:main``. Natural for "
|
||||
"installed packages."
|
||||
|
||||
#: ../../root/cli.rst:80
|
||||
msgid "Запуск приложений"
|
||||
msgstr "Running Applications"
|
||||
#: ../../root/cli.rst:72
|
||||
msgid ""
|
||||
"Если передан путь к директории с ``__main__.py``, он разрешается "
|
||||
"автоматически — указывать файл явно не нужно."
|
||||
msgstr ""
|
||||
"If a directory path containing ``__main__.py`` is passed, it is resolved "
|
||||
"automatically — no need to name the file explicitly."
|
||||
|
||||
#: ../../root/cli.rst:83
|
||||
#: ../../root/cli.rst:74
|
||||
msgid "**Примеры валидных entrypoint-ов:**"
|
||||
msgstr "**Examples of valid entrypoints:**"
|
||||
|
||||
#: ../../root/cli.rst:84
|
||||
msgid ""
|
||||
"Тип объекта зависит от команды: ``run`` и ``build`` ожидают callable, "
|
||||
"``routes`` — инстанс ``App`` или callable, возвращающий ``App``."
|
||||
msgstr ""
|
||||
"The expected object type depends on the command: ``run`` and ``build`` "
|
||||
"expect a callable, ``routes`` expects an ``App`` instance or a callable "
|
||||
"returning ``App``."
|
||||
|
||||
#: ../../root/cli.rst:89
|
||||
msgid "Создание проектов"
|
||||
msgstr "Scaffolding projects"
|
||||
|
||||
#: ../../root/cli.rst:92
|
||||
msgid "Команда ``new``"
|
||||
msgstr "The ``new`` command"
|
||||
|
||||
#: ../../root/cli.rst:94
|
||||
msgid ""
|
||||
"Создаёт новую директорию проекта с boilerplate-кодом. Это отправная "
|
||||
"точка: вместо ручной настройки структуры — готовый каркас за одну "
|
||||
"команду."
|
||||
msgstr ""
|
||||
"Creates a new project directory with boilerplate code. It is the starting"
|
||||
" point: instead of setting up the structure by hand, a ready-made "
|
||||
"skeleton in a single command."
|
||||
|
||||
#: ../../root/cli.rst:100
|
||||
msgid "``project_name`` — имя директории проекта (обязательный аргумент)."
|
||||
msgstr "``project_name`` — project directory name (required argument)."
|
||||
|
||||
#: ../../root/cli.rst:101 ../../root/cli.rst:133
|
||||
msgid "``--arch`` — архитектура проекта: ``flat`` (по умолчанию) или ``src``."
|
||||
msgstr "``--arch`` — project architecture: ``flat`` (default) or ``src``."
|
||||
|
||||
#: ../../root/cli.rst:103 ../../root/cli.rst:135 ../../root/cli.rst:161
|
||||
#: ../../root/cli.rst:191
|
||||
msgid "**Примеры:**"
|
||||
msgstr "**Examples:**"
|
||||
|
||||
#: ../../root/cli.rst:110
|
||||
msgid "При архитектуре ``flat`` создаётся следующая структура:"
|
||||
msgstr "With the ``flat`` architecture, the following structure is created:"
|
||||
|
||||
#: ../../root/cli.rst:115
|
||||
msgid "При архитектуре ``src``:"
|
||||
msgstr "With the ``src`` architecture:"
|
||||
|
||||
#: ../../root/cli.rst:125
|
||||
msgid "Команда ``init``"
|
||||
msgstr "The ``init`` command"
|
||||
|
||||
#: ../../root/cli.rst:127
|
||||
msgid ""
|
||||
"Делает то же, что и ``new``, но в текущей директории. Удобно, когда "
|
||||
"проект уже существует и нужно добавить структуру Argenta, не создавая "
|
||||
"лишний уровень вложенности."
|
||||
msgstr ""
|
||||
"Does the same as ``new``, but in the current directory. Convenient when "
|
||||
"the project already exists and the Argenta structure needs to be added "
|
||||
"without introducing an extra level of nesting."
|
||||
|
||||
#: ../../root/cli.rst:143
|
||||
msgid ""
|
||||
"Команда ``init`` не перезаписывает существующие файлы — они будут "
|
||||
"пропущены."
|
||||
msgstr "The ``init`` command does not overwrite existing files — they are skipped."
|
||||
|
||||
#: ../../root/cli.rst:148
|
||||
msgid "Запуск приложения"
|
||||
msgstr "Running an application"
|
||||
|
||||
#: ../../root/cli.rst:151
|
||||
msgid "Команда ``run``"
|
||||
msgstr "The ``run`` command"
|
||||
|
||||
#: ../../root/cli.rst:85
|
||||
#: ../../root/cli.rst:153
|
||||
msgid ""
|
||||
"Запускает оркестратор ``Argenta`` из callable-ентрипойнта. Это альтернатива "
|
||||
"прямому вызову ``python main.py``, но с автоматической настройкой окружения."
|
||||
"Запускает оркестратор ``Argenta`` из callable-entrypoint. Это "
|
||||
"альтернатива прямому вызову ``python main.py``, но с автоматической "
|
||||
"настройкой окружения."
|
||||
msgstr ""
|
||||
"Starts the ``Argenta`` orchestrator from a callable entrypoint. This is an "
|
||||
"alternative to directly calling ``python main.py``, but with automatic "
|
||||
"Starts the ``Argenta`` orchestrator from a callable entrypoint. It is an "
|
||||
"alternative to calling ``python main.py`` directly, but with automatic "
|
||||
"environment setup."
|
||||
|
||||
#: ../../root/cli.rst:89
|
||||
msgid ""
|
||||
"``entrypoint`` — путь к callable в формате "
|
||||
"``<path/to/file.py>:<callable>`` или ``<path.to.module>:<callable>``."
|
||||
msgstr ""
|
||||
"``entrypoint`` — path to a callable in the format "
|
||||
"``<path/to/file.py>:<callable>`` or ``<path.to.module>:<callable>``."
|
||||
#: ../../root/cli.rst:159 ../../root/cli.rst:189 ../../root/cli.rst:249
|
||||
msgid "Формат entrypoint — см. :ref:`Формат entrypoint <cli_entrypoint>`."
|
||||
msgstr "Entrypoint format — see :ref:`Entrypoint format <cli_entrypoint>`."
|
||||
|
||||
#: ../../root/cli.rst:99
|
||||
#: ../../root/cli.rst:173
|
||||
msgid ""
|
||||
"Команда ``run`` устанавливает переменную окружения "
|
||||
"``RUN_FROM_ARGENTA_RUNNER=1``, что отключает парсинг аргументов командной "
|
||||
"строки в ``ArgParser``. Это позволяет запустить REPL без конфликтов с "
|
||||
"CLI-аргументами ``argenta``."
|
||||
"``RUN_FROM_ARGENTA_RUNNER=1``. ``ArgParser`` видит этот флаг и пропускает"
|
||||
" парсинг ``sys.argv``, поэтому аргументы самого ``argenta`` (типа "
|
||||
"``--help``, ``--version``) не конфликтуют с аргументами запускаемого "
|
||||
"приложения. REPL стартует чисто, без ошибок про неизвестные флаги."
|
||||
msgstr ""
|
||||
"The ``run`` command sets the ``RUN_FROM_ARGENTA_RUNNER=1`` environment "
|
||||
"variable, which disables command-line argument parsing in ``ArgParser``. "
|
||||
"This allows starting the REPL without conflicts with ``argenta`` CLI arguments."
|
||||
"variable. ``ArgParser`` sees this flag and skips parsing ``sys.argv``, so"
|
||||
" the ``argenta`` arguments themselves (such as ``--help``, ``--version``)"
|
||||
" do not conflict with the arguments of the application being launched. "
|
||||
"The REPL starts cleanly, with no errors about unknown flags."
|
||||
|
||||
#: ../../root/cli.rst:104
|
||||
#: ../../root/cli.rst:178
|
||||
msgid "Инспекция маршрутов"
|
||||
msgstr "Inspecting Routes"
|
||||
msgstr "Inspecting routes"
|
||||
|
||||
#: ../../root/cli.rst:107
|
||||
#: ../../root/cli.rst:181
|
||||
msgid "Команда ``routes``"
|
||||
msgstr "The ``routes`` command"
|
||||
|
||||
#: ../../root/cli.rst:109
|
||||
#: ../../root/cli.rst:183
|
||||
msgid ""
|
||||
"Отображает все зарегистрированные роутеры, команды, алиасы и флаги в виде "
|
||||
"дерева. Принимает как инстанс ``App``, так и callable, возвращающий ``App``."
|
||||
"Отображает все зарегистрированные роутеры, команды, алиасы и флаги в виде"
|
||||
" дерева. Принимает как инстанс ``App``, так и callable, возвращающий "
|
||||
"``App``."
|
||||
msgstr ""
|
||||
"Displays all registered routers, commands, aliases, and flags as a tree. "
|
||||
"Accepts either an ``App`` instance or a callable returning ``App``."
|
||||
|
||||
#: ../../root/cli.rst:113
|
||||
#: ../../root/cli.rst:198
|
||||
msgid ""
|
||||
"``entrypoint`` — путь к ``App`` или callable в формате "
|
||||
"``<path/to/file.py>:<app_or_callable>``."
|
||||
"Инстанс ``App`` передаётся напрямую, если роутеры подключены на уровне "
|
||||
"модуля:"
|
||||
msgstr ""
|
||||
"``entrypoint`` — path to an ``App`` or callable in the format "
|
||||
"``<path/to/file.py>:<app_or_callable>``."
|
||||
"An ``App`` instance is passed directly when routers are registered at the"
|
||||
" module level:"
|
||||
|
||||
#: ../../root/cli.rst:125
|
||||
msgid "Если передан инстанс ``App``:"
|
||||
msgstr "If an ``App`` instance is passed:"
|
||||
|
||||
#: ../../root/cli.rst:131
|
||||
#: ../../root/cli.rst:204
|
||||
msgid ""
|
||||
"Если передан callable (фабрика), он будет вызван, и результат будет "
|
||||
"использован для отображения маршрутов:"
|
||||
"Фабрика ``create_app`` передаётся, если роутеры регистрируются внутри "
|
||||
"функции — например, зависят от конфига или DI:"
|
||||
msgstr ""
|
||||
"If a callable (factory) is passed, it will be called, and the result will "
|
||||
"be used to display routes:"
|
||||
"A ``create_app`` factory is passed when routers are registered inside a "
|
||||
"function — for example, when they depend on config or DI:"
|
||||
|
||||
#: ../../root/cli.rst:139
|
||||
#: ../../root/cli.rst:211
|
||||
msgid ""
|
||||
"При использовании callable-ентрипойнта (например, ``create_app``) REPL не "
|
||||
"запускается — фабрика вызывается, и маршруты считываются из возвращённого "
|
||||
"``App``. Это полезно, когда роутеры подключаются внутри функции, а не на "
|
||||
"уровне модуля."
|
||||
"При использовании callable-entrypoint REPL не запускается — фабрика "
|
||||
"вызывается, и маршруты считываются из возвращённого ``App``."
|
||||
msgstr ""
|
||||
"When using a callable entrypoint (e.g., ``create_app``), the REPL is not "
|
||||
"started — the factory is called, and routes are read from the returned "
|
||||
"``App``. This is useful when routers are registered inside a function "
|
||||
"rather than at the module level."
|
||||
"When a callable entrypoint is used, the REPL is not started — the factory"
|
||||
" is called, and routes are read from the returned ``App``."
|
||||
|
||||
#: ../../root/cli.rst:144
|
||||
msgid "Сборка бинарников"
|
||||
msgstr "Building Binaries"
|
||||
#: ../../root/cli.rst:213 ../../root/cli.rst:325
|
||||
msgid "Пример вывода:"
|
||||
msgstr "Example output:"
|
||||
|
||||
#: ../../root/cli.rst:147
|
||||
#: ../../root/cli.rst:238
|
||||
msgid "Сборка бинарника"
|
||||
msgstr "Building a binary"
|
||||
|
||||
#: ../../root/cli.rst:241
|
||||
msgid "Команда ``build``"
|
||||
msgstr "The ``build`` command"
|
||||
|
||||
#: ../../root/cli.rst:149
|
||||
msgid "Компилирует проект в standalone-бинарник с помощью `Nuitka <https://nuitka.net/>`_."
|
||||
msgstr "Compiles a project into a standalone binary using `Nuitka <https://nuitka.net/>`_."
|
||||
|
||||
#: ../../root/cli.rst:153
|
||||
#: ../../root/cli.rst:243
|
||||
msgid ""
|
||||
"``entrypoint`` — путь к callable в формате "
|
||||
"``<path/to/file.py>:<callable>``."
|
||||
"Компилирует проект в standalone-бинарник с помощью `Nuitka "
|
||||
"<https://nuitka.net/>`_, которая входит в ``[cli]`` extra."
|
||||
msgstr ""
|
||||
"``entrypoint`` — path to a callable in the format "
|
||||
"``<path/to/file.py>:<callable>``."
|
||||
"Compiles a project into a standalone binary using `Nuitka "
|
||||
"<https://nuitka.net/>`_, which is included in the ``[cli]`` extra."
|
||||
|
||||
#: ../../root/cli.rst:154
|
||||
#: ../../root/cli.rst:251
|
||||
msgid ""
|
||||
"``--output`` / ``-o`` — имя выходного бинарника (по умолчанию — имя файла "
|
||||
"или пакета)."
|
||||
"``--output`` / ``-o`` — имя выходного бинарника (по умолчанию — имя файла"
|
||||
" или пакета)."
|
||||
msgstr ""
|
||||
"``--output`` / ``-o`` — output binary name (defaults to the file or package name)."
|
||||
"``--output`` / ``-o`` — output binary name (defaults to the file or "
|
||||
"package name)."
|
||||
|
||||
#: ../../root/cli.rst:166
|
||||
#: ../../root/cli.rst:252
|
||||
msgid ""
|
||||
"Для использования команды ``build`` необходимо установить ``Nuitka``:"
|
||||
"``--`` — разделитель, после которого передаются **произвольные флаги "
|
||||
"Nuitka**. Они добавляются к вызову Nuitka после аргументов Argenta, "
|
||||
"поэтому могут переопределять дефолты и добавлять любые опции, которые "
|
||||
"Nuitka поддерживает."
|
||||
msgstr ""
|
||||
"To use the ``build`` command, you must install ``Nuitka``:"
|
||||
"``--`` — a separator after which **arbitrary Nuitka flags** are passed."
|
||||
" They are appended to the Nuitka invocation after Argenta's arguments,"
|
||||
" so they can override defaults and add any options Nuitka supports."
|
||||
|
||||
#: ../../root/cli.rst:174
|
||||
#: ../../root/cli.rst:254
|
||||
#, fuzzy
|
||||
msgid "**Базовые примеры:**"
|
||||
msgstr "**Basic examples:**"
|
||||
|
||||
#: ../../root/cli.rst:262
|
||||
msgid "**Примеры с флагами Nuitka:**"
|
||||
msgstr "**Examples with Nuitka flags:**"
|
||||
|
||||
#: ../../root/cli.rst:271
|
||||
msgid "Что делает Argenta по умолчанию"
|
||||
msgstr "What Argenta does by default"
|
||||
|
||||
#: ../../root/cli.rst:273
|
||||
msgid "Команда ``build`` формирует вызов Nuitka со следующими аргументами:"
|
||||
msgstr "The ``build`` command assembles a Nuitka invocation with the following arguments:"
|
||||
|
||||
#: ../../root/cli.rst:275
|
||||
msgid ""
|
||||
"``--standalone --onefile`` — собирает единый бинарник со всеми "
|
||||
"зависимостями внутри."
|
||||
msgstr ""
|
||||
"``--standalone --onefile`` — builds a single binary with all dependencies"
|
||||
" bundled inside."
|
||||
|
||||
#: ../../root/cli.rst:276
|
||||
msgid ""
|
||||
"``--output-filename=<name>`` — имя выходного файла (из ``--output`` или "
|
||||
"имени entrypoint)."
|
||||
msgstr ""
|
||||
"``--output-filename=<name>`` — output file name (from ``--output`` or the"
|
||||
" entrypoint name)."
|
||||
|
||||
#: ../../root/cli.rst:277
|
||||
msgid "``--jobs=<cpu_count>`` — параллельная компиляция на всех ядрах."
|
||||
msgstr "``--jobs=<cpu_count>`` — parallel compilation across all cores."
|
||||
|
||||
#: ../../root/cli.rst:278
|
||||
msgid ""
|
||||
"``--lto=no`` — LTO отключён по умолчанию (быстрее сборка, медленнее "
|
||||
"запуск)."
|
||||
msgstr ""
|
||||
"``--lto=no`` — LTO is disabled by default (faster build, slower startup)."
|
||||
|
||||
#: ../../root/cli.rst:279
|
||||
msgid ""
|
||||
"``--include-windows-runtime-dlls=no`` — на Windows не включает runtime "
|
||||
"DLL в бинарник."
|
||||
msgstr ""
|
||||
"``--include-windows-runtime-dlls=no`` — on Windows, runtime DLLs are not"
|
||||
" bundled into the binary."
|
||||
|
||||
#: ../../root/cli.rst:280
|
||||
msgid ""
|
||||
"``--python-flag=-m`` — добавляется автоматически, если entrypoint "
|
||||
"указывает на ``__main__.py``."
|
||||
msgstr ""
|
||||
"``--python-flag=-m`` — added automatically when the entrypoint points at"
|
||||
" a ``__main__.py``."
|
||||
|
||||
#: ../../root/cli.rst:282
|
||||
msgid ""
|
||||
"Все эти дефолты можно переопределить, передав соответствующий флаг после "
|
||||
"``--``. Например, ``-- --lto=yes`` включит LTO, а ``-- --jobs=1`` "
|
||||
"отключит параллельную сборку."
|
||||
msgstr ""
|
||||
"Any of these defaults can be overridden by passing the corresponding flag"
|
||||
" after ``--``. For example, ``-- --lto=yes`` enables LTO, and ``--"
|
||||
" --jobs=1`` disables parallel compilation."
|
||||
|
||||
#: ../../root/cli.rst:285
|
||||
msgid "Основные флаги Nuitka и их нюансы"
|
||||
msgstr "Key Nuitka flags and their trade-offs"
|
||||
|
||||
#: ../../root/cli.rst:287
|
||||
msgid ""
|
||||
"Полный список флагов — в `документации Nuitka <https://nuitka.net/user-"
|
||||
"documentation/user-manual.html>`_. Ниже — те, с которыми чаще всего "
|
||||
"сталкиваются при сборке CLI-приложений."
|
||||
msgstr ""
|
||||
"The full flag list is in the `Nuitka documentation <https://nuitka.net"
|
||||
"/user-documentation/user-manual.html>`_. Below are the ones most often"
|
||||
" encountered when building CLI applications."
|
||||
|
||||
#: ../../root/cli.rst:289
|
||||
#, python-brace-format
|
||||
msgid "``--lto={yes,no,auto}``"
|
||||
msgstr "``--lto={yes,no,auto}``"
|
||||
|
||||
#: ../../root/cli.rst:290
|
||||
msgid ""
|
||||
"Link-Time Optimization. ``yes`` — бинарник меньше и быстрее запускается, "
|
||||
"но сборка длится заметно дольше. ``no`` (дефолт Argenta) — сборка "
|
||||
"быстрее, бинарник больше. ``auto`` — Nuitka выбирает сам. Для "
|
||||
"production-сборки имеет смысл ``yes``, для итеративной разработки — "
|
||||
"``no``."
|
||||
msgstr ""
|
||||
"Link-Time Optimization. ``yes`` — the binary is smaller and starts"
|
||||
" faster, but the build takes noticeably longer. ``no`` (Argenta's"
|
||||
" default) — faster build, larger binary. ``auto`` — Nuitka decides. For"
|
||||
" production builds ``yes`` makes sense; for iterative development, ``no``."
|
||||
|
||||
#: ../../root/cli.rst:292
|
||||
msgid "``--include-package=<package>``"
|
||||
msgstr "``--include-package=<package>``"
|
||||
|
||||
#: ../../root/cli.rst:293
|
||||
msgid ""
|
||||
"Явно включает пакет в бинарник. Nuitka отслеживает импорты статически, "
|
||||
"поэтому пакеты, которые импортируются динамически (через ``importlib``, "
|
||||
"плагины, ``__import__``), в бинарник не попадают — их нужно добавлять "
|
||||
"вручную. Типичные кандидаты: ``numpy``, ``pandas``, ``rich``, "
|
||||
"``prompt_toolkit``."
|
||||
msgstr ""
|
||||
"Explicitly includes a package in the binary. Nuitka tracks imports"
|
||||
" statically, so packages imported dynamically (via ``importlib``, plugins,"
|
||||
" ``__import__``) do not end up in the binary — they must be added by hand."
|
||||
" Common candidates: ``numpy``, ``pandas``, ``rich``, ``prompt_toolkit``."
|
||||
|
||||
#: ../../root/cli.rst:295
|
||||
msgid "``--include-data-files=<source>=<dest>``"
|
||||
msgstr "``--include-data-files=<source>=<dest>``"
|
||||
|
||||
#: ../../root/cli.rst:296
|
||||
msgid ""
|
||||
"Включает файлы данных (шаблоны, конфиги, ассеты) в бинарник. Формат: "
|
||||
"``--include-data-files=assets/logo.png=assets/logo.png``. Для директорий "
|
||||
"целиком — ``--include-data-dir=assets=assets``. Без этого файлы, которые "
|
||||
"приложение читает во время выполнения, не будут найдены в собранном "
|
||||
"бинарнике."
|
||||
msgstr ""
|
||||
"Includes data files (templates, configs, assets) into the binary. Format:"
|
||||
" ``--include-data-files=assets/logo.png=assets/logo.png``. For whole"
|
||||
" directories — ``--include-data-dir=assets=assets``. Without this, files"
|
||||
" the application reads at runtime will not be found inside the built binary."
|
||||
|
||||
#: ../../root/cli.rst:298
|
||||
msgid "``--enable-plugin=<plugin>``"
|
||||
msgstr "``--enable-plugin=<plugin>``"
|
||||
|
||||
#: ../../root/cli.rst:299
|
||||
msgid ""
|
||||
"Включает `плагин Nuitka <https://nuitka.net/user-documentation/user-"
|
||||
"manual.html#plugins>`_ для поддержки фреймворков, требующих специальной "
|
||||
"обработки. Распространённые: ``anti-bloat`` (вырезает ненужные части "
|
||||
"тяжёлых пакетов), ``numpy`` (корректная сборка с numpy), ``tk-inter`` "
|
||||
"(Tkinter GUI), ``triton`` (PyTorch triton kernels)."
|
||||
msgstr ""
|
||||
"Enables a `Nuitka plugin <https://nuitka.net/user-documentation/user-"
|
||||
"manual.html#plugins>`_ for frameworks that need special handling. Common"
|
||||
" ones: ``anti-bloat`` (strips unneeded parts of heavy packages), ``numpy``"
|
||||
" (correct numpy bundling), ``tk-inter`` (Tkinter GUI), ``triton`` (PyTorch"
|
||||
" triton kernels)."
|
||||
|
||||
#: ../../root/cli.rst:301
|
||||
msgid "``--onefile`` / ``--standalone``"
|
||||
msgstr "``--onefile`` / ``--standalone``"
|
||||
|
||||
#: ../../root/cli.rst:302
|
||||
msgid ""
|
||||
"``--onefile`` (дефолт Argenta) — единый бинарник, удобный для "
|
||||
"дистрибуции. При запуске распаковывается во временную директорию, поэтому"
|
||||
" стартует медленнее. ``--standalone`` — папка с бинарником и "
|
||||
"зависимостями, стартует быстрее, но дистрибуция — это вся папка целиком. "
|
||||
"Чтобы переключиться: ``-- --standalone`` (переопределит дефолтный "
|
||||
"``--onefile``)."
|
||||
msgstr ""
|
||||
"``--onefile`` (Argenta's default) — a single binary, convenient for"
|
||||
" distribution. It unpacks into a temporary directory on startup, so it"
|
||||
" starts slower. ``--standalone`` — a folder with the binary and its"
|
||||
" dependencies; starts faster, but distribution means shipping the whole"
|
||||
" folder. To switch: ``-- --standalone`` (overrides the default ``--onefile``)."
|
||||
|
||||
#: ../../root/cli.rst:304
|
||||
msgid "``--jobs=<n>``"
|
||||
msgstr "``--jobs=<n>``"
|
||||
|
||||
#: ../../root/cli.rst:305
|
||||
msgid ""
|
||||
"Количество параллельных процессов компиляции. Дефолт Argenta — все ядра "
|
||||
"(``os.cpu_count()``). На машинах с малым объёмом памяти имеет смысл "
|
||||
"ограничить: ``-- --jobs=2``."
|
||||
msgstr ""
|
||||
"Number of parallel compilation processes. Argenta's default is all cores"
|
||||
" (``os.cpu_count()``). On memory-constrained machines it makes sense to"
|
||||
" limit it: ``-- --jobs=2``."
|
||||
|
||||
#: ../../root/cli.rst:314
|
||||
msgid "Информация об окружении"
|
||||
msgstr "Environment Information"
|
||||
msgstr "Environment information"
|
||||
|
||||
#: ../../root/cli.rst:177
|
||||
#: ../../root/cli.rst:317
|
||||
msgid "Команда ``info``"
|
||||
msgstr "The ``info`` command"
|
||||
|
||||
#: ../../root/cli.rst:179
|
||||
#: ../../root/cli.rst:319
|
||||
msgid ""
|
||||
"Отображает версию ``Argenta``, версию Python, платформу и ссылку на "
|
||||
"документацию."
|
||||
msgstr ""
|
||||
"Displays the ``Argenta`` version, Python version, platform, and a link to "
|
||||
"the documentation."
|
||||
"Displays the ``Argenta`` version, Python version, platform, and a link to"
|
||||
" the documentation."
|
||||
|
||||
#: ../../root/cli.rst:187
|
||||
msgid "Формат ентрипойнтов"
|
||||
msgstr "Entrypoint Format"
|
||||
#~ msgid "Командная строка"
|
||||
#~ msgstr "Command Line Interface"
|
||||
|
||||
#: ../../root/cli.rst:190
|
||||
msgid ""
|
||||
"Все команды, принимающие ентрипойнт (``run``, ``routes``, ``build``), "
|
||||
"используют единый формат:"
|
||||
msgstr ""
|
||||
"All commands that accept an entrypoint (``run``, ``routes``, ``build``) "
|
||||
"use a unified format:"
|
||||
#~ msgid "Создаёт новую директорию проекта с boilerplate-кодом."
|
||||
#~ msgstr "Creates a new project directory with boilerplate code."
|
||||
|
||||
#: ../../root/cli.rst:196
|
||||
msgid ""
|
||||
"Поддерживаются как пути к файлам, так и dotted-модули. Если передан путь к "
|
||||
"директории с ``__main__.py``, он будет разрешён автоматически."
|
||||
msgstr ""
|
||||
"Both file paths and dotted modules are supported. If a directory path "
|
||||
"containing ``__main__.py`` is passed, it will be resolved automatically."
|
||||
#~ msgid ""
|
||||
#~ "``entrypoint`` — путь к callable в "
|
||||
#~ "формате ``<path/to/file.py>:<callable>`` или "
|
||||
#~ "``<path.to.module>:<callable>``."
|
||||
#~ msgstr ""
|
||||
#~ "``entrypoint`` — path to a callable "
|
||||
#~ "in the format ``<path/to/file.py>:<callable>`` "
|
||||
#~ "or ``<path.to.module>:<callable>``."
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Команда ``run`` устанавливает переменную "
|
||||
#~ "окружения ``RUN_FROM_ARGENTA_RUNNER=1``, что "
|
||||
#~ "отключает парсинг аргументов командной строки"
|
||||
#~ " в ``ArgParser``. Это позволяет запустить"
|
||||
#~ " REPL без конфликтов с CLI-аргументами "
|
||||
#~ "``argenta``."
|
||||
#~ msgstr ""
|
||||
#~ "The ``run`` command sets the "
|
||||
#~ "``RUN_FROM_ARGENTA_RUNNER=1`` environment variable, "
|
||||
#~ "which disables command-line argument "
|
||||
#~ "parsing in ``ArgParser``. This allows "
|
||||
#~ "starting the REPL without conflicts with"
|
||||
#~ " ``argenta`` CLI arguments."
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``entrypoint`` — путь к ``App`` или "
|
||||
#~ "callable в формате "
|
||||
#~ "``<path/to/file.py>:<app_or_callable>``."
|
||||
#~ msgstr ""
|
||||
#~ "``entrypoint`` — path to an ``App`` "
|
||||
#~ "or callable in the format "
|
||||
#~ "``<path/to/file.py>:<app_or_callable>``."
|
||||
|
||||
#~ msgid "Если передан инстанс ``App``:"
|
||||
#~ msgstr "If an ``App`` instance is passed:"
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Если передан callable (фабрика), он "
|
||||
#~ "будет вызван, и результат будет "
|
||||
#~ "использован для отображения маршрутов:"
|
||||
#~ msgstr ""
|
||||
#~ "If a callable (factory) is passed, "
|
||||
#~ "it will be called, and the result"
|
||||
#~ " will be used to display routes:"
|
||||
|
||||
#~ msgid ""
|
||||
#~ "``entrypoint`` — путь к callable в "
|
||||
#~ "формате ``<path/to/file.py>:<callable>``."
|
||||
#~ msgstr ""
|
||||
#~ "``entrypoint`` — path to a callable "
|
||||
#~ "in the format ``<path/to/file.py>:<callable>``."
|
||||
|
||||
#~ msgid "Для использования команды ``build`` необходимо установить ``Nuitka``:"
|
||||
#~ msgstr "To use the ``build`` command, you must install ``Nuitka``:"
|
||||
|
||||
#~ msgid "Формат ентрипойнтов"
|
||||
#~ msgstr "Entrypoint Format"
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Все команды, принимающие ентрипойнт (``run``,"
|
||||
#~ " ``routes``, ``build``), используют единый "
|
||||
#~ "формат:"
|
||||
#~ msgstr ""
|
||||
#~ "All commands that accept an entrypoint"
|
||||
#~ " (``run``, ``routes``, ``build``) use a "
|
||||
#~ "unified format:"
|
||||
|
||||
#~ msgid ""
|
||||
#~ "Поддерживаются как пути к файлам, так"
|
||||
#~ " и dotted-модули. Если передан путь к"
|
||||
#~ " директории с ``__main__.py``, он будет "
|
||||
#~ "разрешён автоматически."
|
||||
#~ msgstr ""
|
||||
#~ "Both file paths and dotted modules "
|
||||
#~ "are supported. If a directory path "
|
||||
#~ "containing ``__main__.py`` is passed, it "
|
||||
#~ "will be resolved automatically."
|
||||
|
||||
#: ../../root/cli.rst:199
|
||||
msgid "Примеры валидных ентрипойнтов:"
|
||||
msgstr "Examples of valid entrypoints:"
|
||||
|
||||
@@ -7,7 +7,7 @@ msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: Argenta \n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2025-12-04 20:39+0300\n"
|
||||
"POT-Creation-Date: 2026-08-03 17:30+0300\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language: en\n"
|
||||
@@ -82,8 +82,9 @@ msgid "E2E-тестирование цикла"
|
||||
msgstr "E2E Testing of the Loop"
|
||||
|
||||
#: ../../root/testing.rst:48
|
||||
#, fuzzy
|
||||
msgid ""
|
||||
"Полный запуск цикла ``start_polling`` можно покрывать через подпроцесс с "
|
||||
"Полный запуск цикла ``run_repl`` можно покрывать через подпроцесс с "
|
||||
"передачей строк в ``stdin``. Это тяжелее и обычно не требуется. Если всё "
|
||||
"же необходимо — пример ниже."
|
||||
msgstr ""
|
||||
|
||||
Reference in New Issue
Block a user