# copr-push-gui

**Repository Path**: humanfans/copr-push-gui

## Basic Information

- **Project Name**: copr-push-gui
- **Description**: 基于 PyQt6 的 Fedora Copr 手动发布工具。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Copr Push GUI

基于 PyQt6 的 Fedora Copr 手动发布工具。

## 功能特性

- **项目管理**：创建、删除、查看 Copr 项目
- **构建管理**：触发 SRPM 构建、监控构建状态、取消构建
- **实时更新**：自动轮询构建状态
- **日志记录**：详细的操作日志
- **配置管理**：安全的 API Token 存储

## 安装

### 依赖要求

- Python 3.8+
- PyQt6
- python-copr (可选，用于实际 API 调用)

### 安装步骤

```bash
# 克隆或下载项目
cd copr-push-gui

# 创建虚拟环境（推荐）
python3 -m venv venv
source venv/bin/activate

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

## 使用方法

### 1. 配置 API Token

首次使用前需要配置 Copr API Token：

1. 访问 [Copr 设置页面](https://copr.fedorainfracloud.org/api/)
2. 复制 API Token
3. 打开工具，点击"设置"菜单
4. 输入用户名和 API Token
5. 保存设置

### 2. 启动应用程序

```bash
python main.py
```

### 3. 发布流程

1. **选择或创建项目**：
   - 从左侧列表选择现有项目
   - 或点击"新建项目"创建新项目

2. **准备 SRPM**：
   - 准备要发布的源 RPM 文件
   - 点击"浏览..."选择 SRPM 文件

3. **触发构建**：
   - 确认包名（自动从 SRPM 文件名提取）
   - 点击"触发构建"按钮
   - 等待构建完成

4. **监控构建**：
   - 在"构建历史"中查看构建状态
   - 绿色 = 成功，红色 = 失败，黄色 = 进行中

## 项目结构

```
copr-push-gui/
├── main.py              # 应用程序入口
├── main_window.py       # 主窗口 UI
├── copr_client.py       # Copr API 客户端
├── config_manager.py    # 配置管理
├── requirements.txt     # Python 依赖
└── README.md           # 说明文档
```

## 配置说明

配置文件存储在 `~/.config/copr-push-gui/config.json`：

```json
{
  "api_token": "your-api-token",
  "api_url": "https://copr.fedorainfracloud.org",
  "username": "your-username"
}
```

## 注意事项

1. **API Token 安全**：Token 存储在本地配置文件，请确保文件权限安全
2. **模拟模式**：如果没有安装 `python-copr`，工具将以模拟模式运行
3. **网络要求**：需要连接互联网访问 Copr API

## 开发计划

- [ ] 支持从 Git 仓库直接构建
- [ ] 支持批量构建
- [ ] 构建结果通知
- [ ] 多语言支持
- [ ] 构建日志查看

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！