Metadata-Version: 2.4
Name: easyui-zyhgo
Version: 1.0.0
Summary: EasyUI - Qt UI 双向同步中间件
Home-page: https://gitee.com/yourusername/easyui
Author: Your Name
Author-email: your.email@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6
Requires-Dist: watchdog
Requires-Dist: psutil
Requires-Dist: pywin32; platform_system == "Windows"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# EasyUI - Qt UI 双向同步中间件

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue.svg)](https://www.python.org/downloads/)

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

## 功能特性

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

## 安装

### 使用 pip 安装

```bash
pip install easyui-pyside6
```

### 从源码安装

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

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

# 安装包
pip install -e .
```

## 快速开始

### 1. 启动双向同步服务

在您的项目目录中运行：

```bash
easyui start
```

### 2. 编辑 UI 文件

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

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

```bash
easyui open
```

### 3. 查看服务状态

```bash
easyui status
```

### 4. 停止服务

```bash
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](LICENSE) 文件
