mirror of
https://github.com/Cheviiot/Nivora.git
synced 2026-08-03 15:51:12 +00:00
113 lines
4.4 KiB
Markdown
113 lines
4.4 KiB
Markdown
# Nivora CLI
|
|
|
|
Nivora CLI — компактная многоязычная оболочка для Stapler. Она упрощает
|
|
установку, удаление, обновление и поиск пакетов, управление репозиториями и
|
|
диагностику системы.
|
|
|
|
```bash
|
|
sudo stplr install nivora/nivora-cli
|
|
```
|
|
|
|
## Интерактивный режим
|
|
|
|
Команда `nv` без аргументов открывает компактное меню:
|
|
|
|
```text
|
|
╭─ 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 |
|
|
|
|
Основная команда принимает и полные названия операций:
|
|
|
|
```bash
|
|
nv install codex
|
|
nv search editor
|
|
nv info codex
|
|
nv repo list
|
|
```
|
|
|
|
## Репозитории
|
|
|
|
Короткое имя автоматически получает префикс `nivora`:
|
|
|
|
```bash
|
|
nvi codex # stplr install nivora/codex
|
|
nvi other/package # stplr install other/package
|
|
```
|
|
|
|
Репозиторий можно изменить или отключить:
|
|
|
|
```bash
|
|
nvi --repo other package
|
|
nvi --repo none package
|
|
NIVORA_REPO=other nvi package
|
|
```
|
|
|
|
Локальные пути и файлы пакетов никогда не получают префикс.
|
|
|
|
## Язык и оформление
|
|
|
|
Русский или английский язык выбирается по системной локали. Явное
|
|
переопределение:
|
|
|
|
```bash
|
|
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>`.
|