Обёртка для Python, которая упрощает создание GUI на tkinter, Qt, wxPython и Remi с помощью компактного API, понятного новичкам.
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
Установите Gooey из PyPI с помощью pip
pip install Gooey - 2
Примените декоратор @Gooey к главной функции argparse
Что важно знать
- Python 2 больше не поддерживается; пользователям Python 2 необходимо указать более старую версию и установить wxPython вручную.
- Gooey зависит от wxPython, который нельзя установить с помощью pip в Python 2.
В подборках
Темы
Частые вопросы
- Что такое 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 обновляется ежедневно.
Похожие проекты
Графический интерфейс на базе PyInstaller для преобразования скриптов Python в автономные файлы .exe.
Настольный набор инструментов для разработчиков: быстрые заметки, форматирование JSON, HTTP-запросы, кодирование, криптография, QR-коды, cron и многое другое.
Библиотека Python для создания простых настольных GUI на Qt с минимальным количеством кода.
Настольный графический интерфейс для управления контейнерами, подами, образами и подключениями к движкам Podman с дополнительной поддержкой Docker.
Бесплатная нативная IDE для Kubernetes с открытым исходным кодом, созданная на Tauri и Vue: сочетает горячие клавиши с удобным интерфейсом для работы с несколькими кластерами.