Commit 00cd32cb authored by Ivan Mazhukin's avatar Ivan Mazhukin

translate extension readme to russian

parent 471d1a0c
# EPM Docker Test Runner # EPM Docker Test Runner
VS Code extension with buttons for `epm-docker-test.sh`. Расширение VS Code с кнопками для запуска `epm-docker-test.sh`.
## Use ## Использование
1. Open this folder in VS Code: `vscode-extension`. 1. Откройте эту папку в VS Code: `vscode-extension`.
2. Press `F5` to start an Extension Development Host. 2. Нажмите `F5`, чтобы запустить Extension Development Host.
3. Open the repository with `epm-docker-test.sh` in that host. 3. В открывшемся окне откройте репозиторий с `epm-docker-test.sh`.
4. Use the `EPM Test` activity bar view or the `$(beaker) EPM Test` status bar button. 4. Используйте панель `EPM Test` на боковой панели активности или кнопку `$(beaker) EPM Test` в строке состояния.
The extension runs commands in a normal VS Code terminal, so the same output and prompts remain visible. Расширение запускает команды в обычном терминале VS Code, поэтому вывод и интерактивные сообщения остаются видимыми.
## Install ## Установка
For day-to-day local use without packaging: Для повседневного локального использования без упаковки:
```bash ```bash
mkdir -p ~/.vscode/extensions/eter.epm-docker-test-runner-0.1.0 mkdir -p ~/.vscode/extensions/eter.epm-docker-test-runner-0.1.0
rsync -a --delete ./ ~/.vscode/extensions/eter.epm-docker-test-runner-0.1.0/ rsync -a --delete ./ ~/.vscode/extensions/eter.epm-docker-test-runner-0.1.0/
``` ```
Then run `Developer: Reload Window` in VS Code. После этого выполните в VS Code команду `Developer: Reload Window`.
To install as a VSIX package: Установка через VSIX-пакет:
```bash ```bash
cd vscode-extension cd vscode-extension
...@@ -31,24 +31,24 @@ vsce package ...@@ -31,24 +31,24 @@ vsce package
code --install-extension epm-docker-test-runner-0.1.0.vsix code --install-extension epm-docker-test-runner-0.1.0.vsix
``` ```
The same VSIX can be installed from the VS Code command `Extensions: Install from VSIX...`. Этот же VSIX можно установить через команду VS Code `Extensions: Install from VSIX...`.
## Actions ## Действия
- `Run app on systems`: asks for an app and target systems. - `Run app on systems`: спрашивает приложение и целевые системы.
- `Run app on systems parallel`: asks for an app, then lets you choose a preset or type target systems manually, and passes `--parallel`. - `Run app on systems parallel`: спрашивает приложение, затем даёт выбрать пресет или вручную ввести системы, и передаёт `--parallel`.
- `Run app preset`: asks for an app and `main`, `russian`, or `all`. - `Run app preset`: спрашивает приложение и пресет `main`, `russian` или `all`.
- `Run exec command`: asks for a shell command and target systems or preset. - `Run exec command`: спрашивает shell-команду и целевые системы или пресет.
- `./bin/epm play <app>`: runs a local play command outside Docker. - `./bin/epm play <app>`: запускает локальный `epm play` вне Docker.
- `./bin/epm play --latest <app>`: runs a local latest play command outside Docker. - `./bin/epm play --latest <app>`: запускает локальный `epm play --latest` вне Docker.
- `Rerun last command`: repeats the last generated command. - `Rerun last command`: повторяет последнюю сгенерированную команду.
- `Open log folder`: opens `${XDG_STATE_HOME:-$HOME/.local/state}/epm-docker-test` or the configured log root. - `Open log folder`: открывает `${XDG_STATE_HOME:-$HOME/.local/state}/epm-docker-test` или настроенный каталог логов.
When an app name is requested, it is inferred from the active editor if the file is in `play.d`, `pack.d`, or `repack.d`. The extension first checks simple shell variables such as `PRODUCT=rstudio` or `PKGNAME=rstudio`, then falls back to the file name without extension. If an app is inferred, the extension shows clickable `OK` and `Cancel` choices; the app name can be edited in the picker input before pressing `OK`. Когда расширение спрашивает имя приложения, оно пытается определить его по активному файлу, если файл находится в `play.d`, `pack.d` или `repack.d`. Сначала проверяются простые shell-переменные вроде `PRODUCT=rstudio` или `PKGNAME=rstudio`; если они не найдены, используется имя файла без расширения. Если приложение найдено, расширение показывает кликабельные варианты `OK` и `Cancel`; имя приложения можно поправить в поле выбора перед нажатием `OK`.
## Favorites ## Избранное
Pinned commands can be added to workspace settings: Закреплённые команды можно добавить в настройки рабочей области:
```json ```json
{ {
...@@ -67,18 +67,18 @@ Pinned commands can be added to workspace settings: ...@@ -67,18 +67,18 @@ Pinned commands can be added to workspace settings:
} }
``` ```
## Settings ## Настройки
Important settings: Основные настройки:
- `epmDockerTest.scriptPath`: path to `epm-docker-test.sh`; empty means auto-detect. - `epmDockerTest.scriptPath`: путь к `epm-docker-test.sh`; пустое значение означает автоопределение.
- `epmDockerTest.workingDirectory`: command working directory. - `epmDockerTest.workingDirectory`: рабочий каталог команды.
- `epmDockerTest.defaultSystems`: default systems for app/exec runs. - `epmDockerTest.defaultSystems`: системы по умолчанию для запусков app/exec.
- `epmDockerTest.defaultPreset`: default preset for preset runs. - `epmDockerTest.defaultPreset`: пресет по умолчанию для запусков по пресету.
- `epmDockerTest.defaultMode`: `auto`, `local`, or `remote`. - `epmDockerTest.defaultMode`: `auto`, `local` или `remote`.
- `epmDockerTest.latest`: pass `--latest`. - `epmDockerTest.latest`: передавать `--latest`.
- `epmDockerTest.parallelJobs`: pass `-j N` when greater than `1`. - `epmDockerTest.parallelJobs`: передавать `-j N`, если значение больше `1`.
- `epmDockerTest.localEpmRoot`: local eepm tree for outside-container `./bin/epm play` commands. - `epmDockerTest.localEpmRoot`: локальное дерево eepm для команд `./bin/epm play` вне контейнера.
- `epmDockerTest.eepmDir`, `epmDockerTest.eepmSource`, `epmDockerTest.remoteHost`, `epmDockerTest.remoteUser`, `epmDockerTest.builderUser`, `epmDockerTest.builderPath`, `epmDockerTest.logRoot`: map to the same script options. - `epmDockerTest.eepmDir`, `epmDockerTest.eepmSource`, `epmDockerTest.remoteHost`, `epmDockerTest.remoteUser`, `epmDockerTest.builderUser`, `epmDockerTest.builderPath`, `epmDockerTest.logRoot`: соответствуют одноимённым опциям скрипта.
For Docker test commands, auto-detection prefers the nearest parent directory of the active editor that contains both `bin/epm` and `epm-docker-test.sh`. That directory is used as the command working directory, and its `epm-docker-test.sh` is used as the runner. Для Docker-тестов автоопределение предпочитает ближайший родительский каталог активного файла, в котором есть и `bin/epm`, и `epm-docker-test.sh`. Этот каталог используется как рабочий каталог команды, а его `epm-docker-test.sh` используется как запускаемый скрипт.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment