# branch_cleaner

**Repository Path**: Cat_Catcher/branch_cleaner

## Basic Information

- **Project Name**: branch_cleaner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-06
- **Last Updated**: 2025-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git分支清理工具 🌿

一个现代化的Web界面Git分支管理工具，帮助您轻松管理和清理Git分支。

## 功能特色

- 🌟 **现代化Web界面** - 美观的用户界面，支持响应式设计
- 📁 **多仓库管理** - 支持添加和管理多个Git仓库
- 🔍 **智能分支筛选** - 按类型（本地/远程）和时间排序
- 🧩 **正则表达式匹配** - 使用正则表达式批量选择分支
- 🛡️ **分支保护** - 防止误删重要分支（如master、main）
- 🗑️ **批量删除** - 支持同时删除本地和远程分支
- 💾 **状态持久化** - 保存仓库配置和保护分支设置

## 项目结构

```
branch_cleaner/
├── app.py                 # Flask后端应用
├── start.py               # 项目启动脚本
├── templates/
│   └── index.html        # 前端页面
├── requirements.txt      # 生产环境依赖
├── requirements-dev.txt  # 开发环境依赖
├── venv/                 # 虚拟环境目录
└── README.md             # 项目说明文档
```

## 环境要求

- Python 3.7+
- Git
- 支持的操作系统：Windows、macOS、Linux

## 安装和启动指南

### 1. 克隆项目

```bash
git clone <repository-url>
cd branch_cleaner
```

### 2. 创建并激活虚拟环境

#### macOS/Linux:
```bash
# 创建虚拟环境（如果不存在）
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate
```

#### Windows:
```bash
# 创建虚拟环境（如果不存在）
python -m venv venv

# 激活虚拟环境
venv\Scripts\activate
```

### 3. 安装依赖

#### 安装生产环境依赖：
```bash
pip install -r requirements.txt
```

#### 安装开发环境依赖（包含代码检查工具）：
```bash
pip install -r requirements-dev.txt
```

### 4. 启动项目

#### 方法一：使用启动脚本（推荐）
```bash
python start.py
```

#### 方法二：直接运行Flask应用
```bash
python app.py
```

### 5. 访问应用

启动成功后，浏览器将自动打开，或者手动访问：http://localhost:8000

## ⚡ 快速启动

如果您已经配置好环境，可以使用以下命令快速启动：

```bash
# 一键启动（激活虚拟环境并启动项目）
source venv/bin/activate && python start.py
```

## 依赖说明

### 生产环境依赖 (requirements.txt)
- **Flask==2.3.3** - Web框架
- **GitPython==3.1.40** - Git操作库
- **Werkzeug==2.3.7** - WSGI工具库

### 开发环境依赖 (requirements-dev.txt)
- **pylint** - Python代码检查工具
- 包含所有生产环境依赖

## 使用说明

1. **添加仓库** - 在仓库路径输入框中输入Git仓库的完整路径
2. **选择分支** - 浏览所有分支，点击复选框选择要删除的分支
3. **正则匹配** - 使用正则表达式批量选择符合条件的分支
4. **保护分支** - 点击分支右侧的"保护"按钮防止误删
5. **删除分支** - 在删除列表中确认选择，然后点击"确认删除"

## 开发指南

### 激活开发环境
```bash
source venv/bin/activate  # macOS/Linux
# 或
venv\Scripts\activate     # Windows
```

### 运行代码检查
```bash
pylint app.py
```

### 项目结构说明
- `app.py` - Flask后端，提供API接口
- `templates/index.html` - 前端页面，包含完整的UI和JavaScript逻辑
- `start.py` - 项目启动脚本，包含环境检查

## 注意事项

⚠️ **重要提醒**：
- 删除分支操作不可逆，请谨慎操作
- 建议在删除前确认当前工作目录没有未提交的重要更改
- 保护重要分支（如master、main、develop等）
- 删除远程分支需要相应的权限

## 故障排除

### 常见问题

1. **虚拟环境激活失败**
   - 确保Python正确安装
   - 检查虚拟环境目录是否存在

2. **依赖安装失败**
   - 升级pip：`pip install --upgrade pip`
   - 检查网络连接
   - 使用国内镜像：`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt`

3. **Git操作失败**
   - 确保当前目录是有效的Git仓库
   - 检查Git配置和权限
   - 确保远程仓库地址正确

4. **端口占用**
   - 修改`app.py`中的端口号
   - 或者终止占用8000端口的进程

## 版本信息

- 当前版本：1.0.0
- Python版本要求：3.7+
- Flask版本：2.3.3

## 许可证

此项目采用MIT许可证。

## 贡献

欢迎提交Issue和Pull Request！

---

🌟 如果这个项目对您有帮助，请给个Star支持一下！