Repolode
chriskiehl

chriskiehl/Gooey

Библиотека Python, которая превращает программу на argparse в настольный GUI с помощью одного декоратора.

Звёзды
21,896
Форки
1,047
Открытые issues
172
Последний коммит
позавчера

Что это?

Gooey оборачивает консольную программу на Python, использующую argparse, и создаёт графический интерфейс на основе объявленных аргументов. Достаточно добавить декоратор @Gooey к функции, которая создаёт парсер, чтобы получить окно с полями ввода, флажками, выпадающими списками и другими элементами управления. При этом скрипт продолжит работать как прежде.

По умолчанию Gooey автоматически сопоставляет каждому действию argparse подходящий виджет. Если использовать GooeyParser вместо ArgumentParser, можно выбирать виджеты явно: например, диалоги выбора файлов и папок, средства выбора даты и времени, ползунки, поля для пароля и списки. Через аргументы декоратора также можно настроить компоновку, размер окна, экран конфигурации (базовый или расширенный), меню и индикаторы выполнения, которые обновляются по регулярным выражениям в выводе программы.

Gooey поддерживает Python 3; в README указано, что пользователям Python 2 нужно зафиксировать более старую версию. В библиотеку входят переводы на многие языки, а с помощью PyInstaller её можно упаковать в исполняемый файл.

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

  • 01Добавляет GUI к программе на argparse с помощью одного декоратора @Gooey.
  • 02Автоматически сопоставляет действия argparse с виджетами; GooeyParser позволяет выбирать виджеты явно.
  • 03Предоставляет виджеты для выбора файлов, папок, даты, времени, цвета и значения с помощью ползунка.
  • 04Отображает индикаторы выполнения по совпадениям с регулярными выражениями в выводе программы; при необходимости показывает оставшееся время.
  • 05Предлагает строку меню с диалогами «О программе», сообщениями, ссылками и HTML.
  • 06Поддерживает интернационализацию с помощью JSON-файлов языковых переводов.

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

  • Создать для коллег без навыков программирования интерфейс с кнопками и формами для внутреннего скрипта на Python.
  • Добавить к утилите для обработки данных или преобразования файлов интерфейс, в котором можно выбирать входные данные.
  • Упаковать CLI-инструмент на Python в автономный исполняемый файл для Windows или другого настольного окружения с интерфейсом в виде формы.

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

  1. 1

    Установите Gooey из PyPI с помощью pip

    pip install Gooey
  2. 2

    Примените декоратор @Gooey к главной функции argparse

Что важно знать

  • Python 2 больше не поддерживается; пользователям Python 2 необходимо указать более старую версию и установить wxPython вручную.
  • Gooey зависит от wxPython, который нельзя установить с помощью pip в Python 2.

В подборках

Темы

#python#gui#argparse#cli#desktop-app#wxpython

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

Что такое Gooey?
Библиотека Python, которая превращает программу на argparse в настольный GUI с помощью одного декоратора. Gooey оборачивает консольную программу на Python, использующую argparse, и создаёт графический интерфейс на основе объявленных аргументов. Достаточно добавить декоратор @Gooey к функции, которая создаёт парсер, чтобы получить окно с полями ввода, флажками, выпадающими списками и другими элементами управления. При этом скрипт продолжит работать как прежде.
Gooey можно использовать бесплатно? Какая у него лицензия?
Gooey распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Gooey всё ещё поддерживается?
Активно поддерживается. Последний коммит в Gooey — 5 нояб. 2026 г..
Для чего можно использовать Gooey?
Создать для коллег без навыков программирования интерфейс с кнопками и формами для внутреннего скрипта на Python. Добавить к утилите для обработки данных или преобразования файлов интерфейс, в котором можно выбирать входные данные. Упаковать CLI-инструмент на Python в автономный исполняемый файл для Windows или другого настольного окружения с интерфейсом в виде формы.
Как установить Gooey?
Установите Gooey из PyPI с помощью pip: pip install Gooey Примените декоратор @Gooey к главной функции argparse
Где скачать Gooey?
Исходный код и инструкции по установке — на GitHub: https://github.com/chriskiehl/Gooey

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

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

Обёртка для Python, которая упрощает создание GUI на tkinter, Qt, wxPython и Remi с помощью компактного API, понятного новичкам.

13,8 тыс.1,8 тыс.PythonLGPL-3.0Активно поддерживаетсяОбновлён 5 дней назад

Настольный набор инструментов для разработчиков: быстрые заметки, форматирование JSON, HTTP-запросы, кодирование, криптография, QR-коды, cron и многое другое.

2,1 тыс.263KotlinMITАктивно поддерживаетсяОбновлён 6 дней назад

Бесплатная нативная IDE для Kubernetes с открытым исходным кодом, созданная на Tauri и Vue: сочетает горячие клавиши с удобным интерфейсом для работы с несколькими кластерами.

66231TypeScriptMITАктивно поддерживаетсяОбновлён 7 дней назад