Repolode
Shopify

Shopify/cli-ui

Небольшой Ruby-фреймворк для интерактивных CLI с запросами ввода, спиннерами, индикаторами выполнения и вложенными фреймами.

Звёзды
1,130
Форки
57
Открытые issues
23
Последний коммит
в прошлом месяце

Что это?

CLI UI — библиотека для Ruby, которая помогает создавать структурированный и аккуратно оформленный вывод в терминале. В ней есть инструменты для типичных интерактивных задач: например, можно предложить пользователю выбрать вариант, ввести произвольный текст или показать ход длительной операции.

Фреймворк включает вложенные фреймы для группировки связанных строк лога, группы спиннеров для параллельного запуска нескольких задач со скрытым выводом (если всё проходит успешно) и индикатор выполнения. Текст можно раскрашивать и оформлять с помощью глифов, используя простой синтаксис разметки, например {{red:text}} и {{*}}. Внешний вид фреймов можно настроить глобально или для каждого фрейма отдельно, выбрав стиль с рамками или скобками.

Библиотека не имеет зависимостей, необходимых во время выполнения, и включает заглушки типов, поэтому работает как с Sorbet, так и без него. Установка выполняется через RubyGems.

Ключевые возможности

  • 01Интерактивные запросы с поддержкой клавиш со стрелками, сочетаний vim, ввода чисел и фильтрации
  • 02Вложенные фреймы для группировки вывода
  • 03Группы спиннеров для запуска нескольких задач с отображением заголовков или статуса
  • 04Индикатор выполнения и виджет статуса
  • 05Цветное форматирование текста и глифов с помощью разметки
  • 06Глобальные стили рамок и скобок либо стили для отдельных фреймов

Сценарии использования

  • Создание интерактивных скриптов настройки или развёртывания на Ruby
  • Параллельный запуск нескольких этапов сборки или установки с аккуратным выводом
  • Запрос выбора или подтверждения у пользователей в Ruby CLI

Быстрый старт

  1. 1

    Установите гем из RubyGems

    gem install cli-ui
  2. 2

    Подключите библиотеку в коде и включите маршрутизатор stdout

Темы

Частые вопросы

Что такое cli-ui?
Небольшой Ruby-фреймворк для интерактивных CLI с запросами ввода, спиннерами, индикаторами выполнения и вложенными фреймами. CLI UI — библиотека для Ruby, которая помогает создавать структурированный и аккуратно оформленный вывод в терминале. В ней есть инструменты для типичных интерактивных задач: например, можно предложить пользователю выбрать вариант, ввести произвольный текст или показать ход длительной операции.
cli-ui можно использовать бесплатно? Какая у него лицензия?
cli-ui распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
cli-ui всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в cli-ui — 15 сент. 2026 г..
Для чего можно использовать cli-ui?
Создание интерактивных скриптов настройки или развёртывания на Ruby Параллельный запуск нескольких этапов сборки или установки с аккуратным выводом Запрос выбора или подтверждения у пользователей в Ruby CLI
Как установить cli-ui?
Установите гем из RubyGems: gem install cli-ui Подключите библиотеку в коде и включите маршрутизатор stdout
Где скачать cli-ui?
Исходный код и инструкции по установке — на GitHub: https://github.com/Shopify/cli-ui

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты