easyui-zyhgo 1.0.0

EasyUI - Qt UI 双向同步中间件

EasyUI - Qt UI 双向同步中间件

EasyUI 是一个基于 PySide6 的 Qt UI 双向同步中间件，支持 .py 和 .ui 文件的实时双向同步，让您的 UI 开发更加高效。

功能特性

• 🔄 实时双向同步：自动监听 .py 和 .ui 文件变化，实时双向转换
• 🎨 Qt Designer 集成：一键打开 Qt Designer 编辑 UI 文件
• 📦 全局命令行工具：安装后可在任意目录使用 easyui 命令
• 🔧 后台服务：使用线程在后台运行，不阻塞终端
• 💻 跨平台支持：支持 Windows、macOS 和 Linux

安装

使用 pip 安装

pip install easyui-pyside6

从源码安装

# 克隆仓库
git clone https://gitee.com/yourusername/easyui.git
cd easyui

# 安装依赖
pip install -r requirements.txt

# 安装包
pip install -e .

快速开始

1. 启动双向同步服务

在您的项目目录中运行：

easyui start

2. 编辑 UI 文件

您可以通过以下方式编辑 UI：

• 方式一：直接编辑 ui 目录下的 .py 文件
• 方式二：使用 Qt Designer 编辑 .ui 文件

easyui open

3. 查看服务状态

easyui status

4. 停止服务

easyui stop

工作原理

1. 目录结构：

   • ui/：存放 Python UI 文件（如 ui_test.py）
   • .ui_cache/：存放自动生成的 .ui 文件

2. 双向同步：

   • 当 .py 文件变化时，自动转换为 .ui 文件
   • 当 .ui 文件变化时，自动转换为 .py 文件

3. Qt Designer 集成：

   • 自动查找并启动 Qt Designer
   • 当 .ui 文件更新时，自动刷新 Qt Designer 窗口

命令说明

命令	描述
easyui start	启动双向同步服务
easyui stop	停止服务
easyui open	用 Qt Designer 打开当前 UI
easyui status	显示服务运行状态

项目结构

easyui/
├── easyui/
│   ├── __init__.py    # 包初始化文件
│   ├── main.py        # 主功能实现
│   └── utils.py       # 工具函数
├── setup.py           # 包配置文件
├── README.md          # 项目说明
└── requirements.txt   # 依赖项

依赖项

• PySide6：Qt6 的 Python 绑定
• watchdog：文件系统监听库
• pywin32（Windows 平台）：Windows API 支持

注意事项

1. 请确保已安装 PySide6 和 Qt Designer
2. 第一次运行时会自动创建 ui 和 .ui_cache 目录
3. 建议在项目根目录运行 easyui 命令

贡献

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目！

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件