# 🎯 正则路径替换测试 - 快速参考

## ✅ 测试状态
```
✅ 59/59 测试通过
⚡ 执行时间: 0.56s
📦 包含: 13 个合并测试 + 46 个正则测试
```

## 🚀 快速运行

```bash
# 运行所有测试
pytest tests/

# 只运行正则测试
pytest tests/test_regex_path_replacement.py -v

# 运行特定测试类
pytest tests/test_regex_path_replacement.py::TestApplyRegexRulesToPaths -v

# 查看覆盖率
pytest tests/test_regex_path_replacement.py --cov=app.utils.playlist_merge
```

## 📋 测试分类

| 测试类 | 数量 | 说明 |
|--------|------|------|
| TestCompileRegexRules | 7 | 正则编译和验证 |
| TestApplyCompiledRulesToPaths | 5 | 应用已编译规则 |
| TestApplyRegexRulesToPaths | 17 | 完整替换流程 |
| TestPreprocessPlaylistText | 7 | 播放列表预处理 |
| TestEdgeCases | 9 | 边界情况处理 |
| TestPerformance | 3 | 性能测试 |

## 💡 常用示例

### 简单替换
```python
rules = [{"pattern": r"/old/", "replacement": "/new/"}]
"/old/music/track.mp3" → "/new/music/track.mp3"
```

### Windows 路径
```python
rules = [{"pattern": r"C:\\Music", "replacement": r"D:\\Audio"}]
r"C:\Music\track.mp3" → r"D:\Audio\track.mp3"
```

### 捕获组
```python
rules = [{"pattern": r"/(\d+)/", "replacement": r"/year-\1/"}]
"/music/2024/track.mp3" → "/music/year-2024/track.mp3"
```

### NAS 路径转换（真实场景）
```python
rules = [
    {"pattern": r"\\\\nas\\Music", "replacement": r"N:\\Music"},
    {"pattern": r"\\", "replacement": "/"},
]
r"\\nas\Music\Album\track.mp3" → "N:/Music/Album/track.mp3"
```

## 🎨 测试覆盖的场景

### ✅ 路径类型
- Linux 路径 `/path/to/file`
- Windows 路径 `C:\path\to\file`
- UNC 路径 `\\server\share\file`
- 相对路径 `../path/./file`
- URL 编码 `/artist%20name/track.mp3`
- Unicode `/音乐/歌曲.mp3`

### ✅ 正则特性
- 简单匹配 `foo`
- 特殊字符 `\(\d+\)`
- 捕获组 `(pattern)` → `\1`
- 不区分大小写 `(?i)pattern`
- 字符类 `[A-Z]+` `\d+` `\w+`

### ✅ 边界情况
- 空输入（规则/路径）
- 无效正则表达式
- 超长路径 (1000+ 字符)
- 特殊字符 `[]()&#`
- 链式替换

### ✅ 性能测试
- 10,000 首歌曲的播放列表
- 5+ 条规则链式执行
- 复杂正则模式匹配

## 📖 相关文档

- 详细总结: `tests/REGEX_TESTS_SUMMARY.md`
- 测试文件: `tests/test_regex_path_replacement.py`
- 被测代码: `app/utils/playlist_merge.py`

## 🔍 调试技巧

```bash
# 显示详细输出
pytest tests/test_regex_path_replacement.py -v -s

# 遇到第一个失败就停止
pytest tests/test_regex_path_replacement.py -x

# 进入调试器
pytest tests/test_regex_path_replacement.py --pdb

# 只运行失败的测试
pytest tests/test_regex_path_replacement.py --lf
```

## 🎓 测试即文档

每个测试都是一个使用示例，查看测试代码了解如何使用正则替换功能！

```python
# 示例: 查看如何使用捕获组
def test_capture_group_replacement():
    paths = ["/music/2024/album/track.mp3"]
    rules = [{"pattern": r"/music/(\d+)/", "replacement": r"/archive/\1/"}]
    result = apply_regex_rules_to_paths(paths, rules)
    assert result == ["/archive/2024/album/track.mp3"]
```