Metadata-Version: 2.4
Name: ios-unittest-generator
Version: 4.19.3
Summary: MCP Server for generating iOS unit tests for Chromium/Edge projects
Author: Microsoft Edge iOS Team
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: chromium,edge,ios,mcp,test-generation,unittest
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.11
Requires-Dist: mcp<2.0.0,>=1.9.4
Description-Content-Type: text/markdown

# iOS Unit Test Generator

智能 MCP 服务器，自动生成、编译、运行和修复 iOS 单元测试。

## 🚀 快速开始

**无需拉取代码，直接在 VS Code 中配置即可使用！**

### 方式一：VS Code 一键安装（最简单 ⭐）

1. 打开 VS Code
2. `Cmd+Shift+P` → 输入 `MCP: Add Server`
3. 选择 **"Pip Package"**
4. 输入包名：`ios-unittest-generator`
5. 设置环境变量 `CHROMIUM_SRC` 为你的 Chromium 源码路径
6. 完成！

### 方式二：手动编辑配置文件

**macOS/Linux** - 编辑 `~/.vscode/mcp.json`:
```json
{
  "servers": {
    "ios-unittest-generator": {
      "command": "uvx",
      "args": ["ios-unittest-generator"],
      "env": {
        "CHROMIUM_SRC": "/path/to/chromium/src"
      }
    }
  }
}
```

**Windows** - 编辑 `%APPDATA%\Code\User\mcp.json`:
```json
{
  "servers": {
    "ios-unittest-generator": {
      "command": "uvx",
      "args": ["ios-unittest-generator"],
      "env": {
        "CHROMIUM_SRC": "C:\\path\\to\\chromium\\src"
      }
    }
  }
}
```

## 📋 核心功能

- ✅ 自动分析源文件，识别可测试元素
- ✅ 生成完整的测试文件（包含 fixture、SetUp、测试用例）
- ✅ 智能检测测试目标（支持 `ios/chrome/*`、`components/*/ios/*` 等所有路径）
- ✅ 自动更新 BUILD.gn 文件（按字母顺序）
- ✅ 自动编译测试，智能分析编译错误
- ✅ 自动运行测试，智能分析运行时错误

## 📖 11 个 MCP 工具

| 工具 | 功能 |
|------|------|
| `full_test_workflow` | 完整工作流（分析→生成→增强→编译→运行） |
| `analyze_ios_code_for_testing` | 分析源文件，提取可测试元素 |
| `generate_ios_unittest_file` | 生成测试文件 |
| `check_ios_test_coverage` | 检查测试覆盖率 |
| `verify_test_enhancement_complete` | 验证测试增强完成（质量门控） |
| `compile_ios_unittest` | 编译测试（自动错误分析） |
| `run_ios_unittest` | 运行测试（自动错误分析） |
| `analyze_runtime_errors` | 分析运行时错误 |
| `analyze_compilation_errors` | 分析编译错误 |
| `update_existing_tests` | 增量更新测试 |
| `update_build_file_for_test` | 自动更新 BUILD 文件 |

## 💡 使用示例

```bash
# 一键生成完整测试
Use full_test_workflow for ios/chrome/browser/ui/foo.mm

# 单独编译
Use compile_ios_unittest for ios/chrome/browser/ui/foo.mm

# 单独运行
Use run_ios_unittest with filter FooTest.*
```

## 🔗 相关链接

- **PyPI**: https://pypi.org/project/ios-unittest-generator/
- **快速入门**: [QUICKSTART.md](QUICKSTART.md)

---

**版本**: v4.19.1  
**更新日期**: 2026-01-22
