gui_ui

Визуальный конструктор Tkinter-интерфейсов без единой внешней зависимости.

gui_ui — это редактор, в котором вы мышкой расставляете виджеты Tkinter на холсте, настраиваете их свойства в инспекторе, пишете функции в банке функций и одним нажатием получаете готовый .py-файл. Идеально для быстрой разработки GUI на олимпиадах, хакатонах и учебных проектах.

✨ Возможности

• 🎨 Визуальный холст — перетаскивайте виджеты мышью, координаты синхронизированы с инспектором один-в-один.
• 🧩 Все базовые виджеты Tkinter — Button, Label, Entry, Text, Frame, LabelFrame, Treeview, Combobox, Checkbutton, Radiobutton, Listbox, Scale, Notebook.
• 🛠 Инспектор свойств — геометрия (x/y/w/h), стиль (bg, fg, font, padx, pady...), события (command, <Button-1>, <Double-Button-1> и др.). Можно добавлять произвольные свойства из выпадающего списка.
• 📝 Вкладка «Код» — для каждого виджета показывается его кусок кода, который можно править и применять обратно.
• 📚 Банк функций — храните все обработчики событий в одном месте. Переименование функции автоматически обновляет все ссылки в проекте.
• 💡 Редактор кода с подсветкой — синтаксис Python, автодополнение (Ctrl+Space или по мере ввода), автоотступ после :, табы.
• 🔄 Импорт .py — парсер Tkinter-скриптов через ast, восстанавливает холст и функции.
• 💾 Сохранение в .json — промежуточный формат проекта.
• 📤 Экспорт в .py — готовый запускаемый скрипт с полем для импортов и подсчётом строк.
• ▶ F5 — мгновенный тестовый запуск в отдельном окне.
• 🖥 Полный экран — F11/Esc, зум холста — Ctrl + колесо.
• 🪶 Ноль зависимостей — только стандартная библиотека Python.

🚀 Установка

pip install gui-ui

Проверка:

gui_ui

Важно: откроется консольное окно с надписью «Пожалуйста, не закрывайте это консольное окно...» — не закрывайте его, пока работаете с редактором.

Из исходников (для разработки)

git clone https://github.com/ваш_логин/gui_ui.git
cd gui_ui
pip install -e .
gui_ui

🎮 Как пользоваться

1. Добавить виджет — нажмите кнопку на левой панели. Виджет появится на холсте и сразу выделится.
2. Настроить — в правом инспекторе задайте текст, координаты, цвета, шрифт, события. Все изменения видны в реальном времени.
3. Привязать событие — на вкладке «События» выберите функцию из списка (её нужно сначала создать в банке функций).
4. Написать функцию — откройте вкладку «Банк функций», создайте новую функцию, напишите код (автодополнение поможет).
5. Проверить — нажмите F5. Откроется окно с работающим приложением.
6. Сохранить — «Файл → Экспорт в .py».

Горячие клавиши

🧪 Пример: сгенерированный код

Редактор создаёт обычный Tkinter-код без магии:

from tkinter import *
from tkinter import ttk

def on_click():
    print('clicked')

tk = Tk()
tk.geometry('800x600')
tk.title('MyApp')

button_1 = Button(tk, text='Нажми меня')
button_1.config(command=lambda: on_click())
button_1.place(x=100, y=50, width=150, height=40)

tk.mainloop()

Этот файл запускается обычным python file.py — на любом Python 3.9+, без установки gui_ui.

🧩 Совместимость

• Python: 3.9, 3.10, 3.11, 3.12
• ОС: Windows, Linux, macOS
• Tkinter: входит в стандартную поставку Python

🤝 Вклад

PR и issue приветствуются. По вопросам сотрудничества — почта из pyproject.toml.

📄 Лицензия

MIT. Полный текст — в файле LICENSE.