|
|
# Cppcheck Test Generator
|
|
|
|
|
|
一个用于根据 cppcheck 报告生成可运行测试用例的模块化工具包。
|
|
|
|
|
|
## 模块结构
|
|
|
|
|
|
### `models.py` - 数据模型
|
|
|
- `CppcheckIssue`: cppcheck 问题信息
|
|
|
- `IssueLocation`: 问题位置信息
|
|
|
- `CodeContext`: 代码上下文信息
|
|
|
|
|
|
### `parsers.py` - 解析器模块
|
|
|
- `parse_cppcheck_xml()`: 解析 XML 格式的 cppcheck 报告
|
|
|
- `parse_cppcheck_text()`: 解析文本格式的 cppcheck 报告
|
|
|
- `read_code_snippet()`: 读取代码片段
|
|
|
|
|
|
### `analysis.py` - 代码分析模块
|
|
|
- `analyze_code_context()`: 分析代码上下文
|
|
|
- `analyze_issue_relevance()`: 分析问题相关性
|
|
|
- `analyze_project_structure()`: 分析项目结构
|
|
|
- `get_enhanced_issue_analysis()`: 获取增强的问题分析
|
|
|
- `filter_and_clean_issues()`: 过滤和清理问题
|
|
|
- `prioritize_issues()`: 问题优先级排序
|
|
|
|
|
|
### `generation.py` - 测试用例生成模块
|
|
|
- `generate_test_for_issue()`: 使用 AI 生成测试用例
|
|
|
- `get_issue_specific_template()`: 获取问题特定的模板
|
|
|
- `smart_select_issues()`: 智能选择最有代表性的问题
|
|
|
- `write_issue_output()`: 写入问题输出文件
|
|
|
|
|
|
### `verification.py` - 验证模块
|
|
|
- `verify_single_test()`: 验证单个测试用例
|
|
|
- `auto_verify_tests()`: 自动验证所有测试用例
|
|
|
- `generate_verification_report()`: 生成验证报告
|
|
|
|
|
|
### `main.py` - 主程序入口
|
|
|
- `main()`: 主程序逻辑，处理命令行参数和协调各模块
|
|
|
|
|
|
## 使用方法
|
|
|
|
|
|
### 作为模块使用
|
|
|
```python
|
|
|
from cppcheck_test_generator import main
|
|
|
main.main(['report.xml', '--out', 'tests', '--max', '5'])
|
|
|
```
|
|
|
|
|
|
### 作为脚本使用
|
|
|
```bash
|
|
|
python cppcheck_to_tests_new.py report.xml --out tests --max 5
|
|
|
```
|
|
|
|
|
|
## 功能特性
|
|
|
|
|
|
- 支持 XML 和文本格式的 cppcheck 报告
|
|
|
- 智能分析代码上下文和项目结构
|
|
|
- AI 驱动的测试用例生成
|
|
|
- 自动验证生成的测试用例
|
|
|
- 智能筛选最有代表性的问题
|
|
|
- 生成详细的验证报告
|
|
|
|
|
|
## 依赖
|
|
|
|
|
|
- Python 3.7+
|
|
|
- OpenAI API 客户端（用于 AI 生成）
|
|
|
- g++ 编译器（用于验证）
|
|
|
- cppcheck（用于验证）
|
|
|
|
|
|
## 迁移说明
|
|
|
|
|
|
从原始的 `cppcheck_to_tests.py` 迁移到新的模块化版本：
|
|
|
|
|
|
1. 所有功能保持不变
|
|
|
2. 命令行参数完全兼容
|
|
|
3. 输出格式保持一致
|
|
|
4. 性能没有变化
|
|
|
|
|
|
新的模块化结构提供了更好的：
|
|
|
- 代码可维护性
|
|
|
- 功能扩展性
|
|
|
- 测试覆盖性
|
|
|
- 文档完整性
|
