command

Command Runner

Обёртка над os/exec для запуска внешних команд. Пакет самодостаточный — ничего не знает про apm. Debug-логирование подключается снаружи:

command.SetLogger(myLogger) // любой тип с Debug(args ...any), по умолчанию молчит

Использование

r := command.NewRunner("pkexec", verbose)
stdout, stderr, err := r.Run(ctx, []string{"apt-get", "update"})

Run всегда возвращает stdout и stderr раздельно, даже если вывод дублировался в консоль.

Опции

r.Run(ctx, args,
    command.WithEnv("LC_ALL=C"),        // добавить переменные окружения
    command.WithDir("/tmp"),            // рабочая директория
    command.WithStdin(reader),          // stdin
    command.WithShell(),                // через bash -c (пайпы, спецсимволы)
    command.WithPassthrough(),          // вывод сразу в консоль
    command.WithQuiet(),                // молчать даже в verbose-режиме
    command.WithPTY(rows, cols),        // pseudo-tty для интерактивного прогресса
    command.WithStreamHandler(h),       // свой обработчик потока stdout
    command.WithOutputCommand(cmd, &s), // вторая команда, результат в s
)

Логика вывода простая: verbose у раннера включает passthrough для всех команд, WithQuiet() его выключает точечно.

Режимы выполнения

Раннер сам выбирает режим по опциям, приоритет сверху вниз:

1. PTY — команда получает настоящий терминал заданного размера. Нужно для команд, которые рисуют прогресс и в пайпе ведут себя иначе (или буферизуют вывод).
2. Divider — основная команда и WithOutputCommand склеиваются в один bash-скрипт через set -e, между ними печатается строка-разделитель. Всё до разделителя — stdout основной команды, всё после — уходит в dest. Смысл: получить два результата за один запуск (например, состояние после операции), не платя за второй процесс с префиксом.
3. Shell — bash -c, когда нужны пайпы и подстановки.
4. Direct — обычный exec, по умолчанию.

Ошибки

ErrEmptyCommand — пустая команда. Остальное — как вернул exec (включая *exec.ExitError), плюс stderr всегда доступен отдельно для анализа выше.