Skip to content

README.ru.md

Latest commit

 

History

History
76 lines (59 loc) · 5.36 KB

README.ru.md

File metadata and controls

76 lines (59 loc) · 5.36 KB
Raw

ru en

GenerateGUIforCLI

Лёгкий инструмент для создания удобных графических интерфейсов для консольных приложений (CLI) с использованием JSON-конфигураций. Идеально подходит для пользователей, которые предпочитают графический интерфейс работе с терминалом.

Возможности

  • Преобразование аргументов CLI в GUI-формы (флажки, выпадающие списки, выбор файлов).
  • Конфигурация на основе JSON — опишите параметры CLI один раз и используйте многократно.
  • Запуск приложений напрямую из графического интерфейса (только для NW.js/HTA).

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

1. Установка

Скачайте и распакуйте архив репозитория.

2. Запуск инструмента

Выберите один из способов:

Способ Требования Команда запуска
NW.js Установите NW.js nw C:\Путь\к\приложению где 'C:\Путь\к\приложению' — папка с GenerateGUIforCLI.
HTA Только Windows Двойной клик по generateGUIforCLI.hta
Браузер Любой современный браузер Откройте generateGUIforCLI.html (ограниченная функциональность)

Как использовать

Шаг 1: Подготовка JSON-конфигурации

Создайте JSON-файл с описанием аргументов вашего CLI-приложения. Вы можете:

  1. Создать конфигурацию самостоятельно по JSON Schema, или
  2. Использовать готовую конфигурацию из проверенного источника (например, репозиториев сообщества или официальной документации).

Шаг 2: Загрузка JSON-файла

  1. Откройте инструмент (NW.js/HTA/браузер).
  2. Нажмите "Choose a file with a declarative description of CLI arguments" и выберите ваш JSON-файл с описанием GUI.
  3. Приложение автоматически сгенерирует поля ввода на основе выбранного файла.

Шаг 3: Генерация и выполнение

  1. Заполните поля в графическом интерфейсе.
  2. Нажмите "Generate CLI arguments" для предпросмотра CLI-команды.
  3. (Только для NW.js/HTA):
    • Укажите путь к исполняемому файлу.
    • Нажмите "Execute" для запуска приложения с вашими параметрами.
  • ** Важно**: Перед выполнением всегда проверяйте сгенерированную команду в текстовом поле. Продолжайте только если:
    • Вы полностью понимаете, что делает команда.
    • Убедились, что она соответствует вашим намерениям (например, не содержит неожиданного удаления файлов или рискованных операций).

Редакторы JSON

Для создания/редактирования JSON-конфигураций используйте:

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

Где взять описание аргументов CLI?

Вы можете получить описание аргументов:

  1. Через встроенную справку (в терминале): 
    your_app --help    # Для большинства Unix-утилит
your_app /?       # Часто используется в Windows
  2. В официальной документации:
    Проверьте:
    • Официальный сайт приложения
    • Исходный репозиторий (например, README.md или man-страницы на GitHub)

Почему нельзя запускать приложения из браузера?

Браузеры предназначены для отображения веб-страниц, а не для выполнения произвольных исполняемых файлов (например, .exe). Для полного функционала используйте NW.js или HTA.