Files

4.4 KiB

Nivora CLI

Nivora CLI — компактная многоязычная оболочка для Stapler. Она упрощает установку, удаление, обновление и поиск пакетов, управление репозиториями и диагностику системы.

sudo stplr install nivora/nivora-cli

Интерактивный режим

Команда nv без аргументов открывает компактное меню:

╭─ NIVORA ─────────────────────────────╮
│ Простое управление пакетами Stapler  │
╰──────────────────────────────────────╯

  Пакеты
  [i] Установить          nvi
  [e] Удалить             nve
  [u] Обновить            nvu
  [s] Найти               nvs
  [q] Информация          nvqi
  [a] Все пакеты          nvqa

  Система
  [r] Обновить репозитории nvr
  [l] Репозитории         nvrl
  [f] Исправить           nvf
  [d] Диагностика         nvd

В конвейере или другом неинтерактивном окружении nv выводит обычную справку.

Короткие команды

Команда Операция Stapler
nvi package установить nivora/package
nve package удалить nivora/package
nvu обновить установленные пакеты
nvs query найти пакет
nvqi package показать информацию о пакете
nvqa показать каталог пакетов
nvr обновить индексы репозиториев
nvrl показать подключённые репозитории
nvf исправить состояние Stapler
nvd проверить окружение
nvc показать или изменить конфигурацию Stapler

Основная команда принимает и полные названия операций:

nv install codex
nv search editor
nv info codex
nv repo list

Репозитории

Короткое имя автоматически получает префикс nivora:

nvi codex                  # stplr install nivora/codex
nvi other/package          # stplr install other/package

Репозиторий можно изменить или отключить:

nvi --repo other package
nvi --repo none package
NIVORA_REPO=other nvi package

Локальные пути и файлы пакетов никогда не получают префикс.

Язык и оформление

Русский или английский язык выбирается по системной локали. Явное переопределение:

nv --lang en help
NIVORA_LANG=ru nvd

Цветной вывод включается только для терминала. Его можно отключить стандартной переменной NO_COLOR, параметром --no-color или значением NIVORA_COLOR=never.

Безопасность

Изменяющие систему операции запускаются через sudo. Другую команду повышения привилегий можно задать в NIVORA_SUDO. Аргументы передаются массивом без вычисления shell-строк. Параметр --dry-run показывает итоговую команду без её выполнения.

Переменная Назначение
NIVORA_LANG язык интерфейса: ru или en
NIVORA_REPO репозиторий коротких имён
NIVORA_SUDO команда повышения привилегий
NIVORA_COLOR режим цвета; never отключает цвет
NIVORA_QUIET=1 не печатать запускаемую команду
NO_COLOR стандартное отключение цвета

Автодополнение для Bash, Fish или Zsh генерируется командой nv completion <shell>.