# sap-cli 测试覆盖率报告

> 测试时间：2026-06-09
> 测试用例：68（63 pass + 5 skip）
> 覆盖率工具：coverage.py

---

## 总体概况

| 指标 | 数值 |
|------|------|
| 源码总行数（Stmts） | 3,018 |
| 已覆盖行数 | 674 |
| **总体覆盖率** | **22%** |

---

## 按模块覆盖率（从低到高）

### 🔴 严重不足（< 20%）— 占总代码量 71%

| 模块 | 代码行 | 覆盖率 | 未覆盖行 | 说明 |
|------|--------|--------|---------|------|
| `cli/parser.py` | 114 | **4%** | 110 | CLI 参数定义，仅被 import 触发 |
| `commands/crud.py` | 560 | **5%** | 533 | **最大模块**，5 个核心命令零覆盖 |
| `commands/batch.py` | 230 | **7%** | 215 | 批量操作 3 个命令零覆盖 |
| `client.py` | 716 | **7%** | 665 | **第二大的**，30 个 API 方法零覆盖 |
| `commands/cds.py` | 126 | **10%** | 114 | CDS 命令零覆盖 |
| `commands/quality.py` | 94 | **10%** | 85 | check + format 零覆盖 |
| `commands/search.py` | 100 | **10%** | 90 | list/whereused/search 零覆盖 |
| `commands/transport.py` | 100 | **10%** | 90 | 传输管理零覆盖 |
| `commands/config_cmd.py` | 75 | **11%** | 67 | config 命令零覆盖 |
| `commands/package_cmd.py` | 78 | **12%** | 69 | package 命令零覆盖 |
| `commands/diff_cmd.py` | 59 | **17%** | 49 | diff 命令零覆盖 |
| `auth.py` | 99 | **31%** | 68 | keyring 方法被测，cmd_auth 未测 |

**小计：2,451 行未覆盖（占总量 81%）**

### 🟡 部分覆盖（20%–79%）

| 模块 | 代码行 | 覆盖率 | 说明 |
|------|--------|--------|------|
| `commands/analyze.py` | 62 | **34%** | 解析逻辑被测，命令入口未测 |
| `commands/scaffold.py` | 64 | **34%** | 4 个模板生成被测，命令入口未测 |
| `cli/output.py` | 25 | **60%** | print 函数被部分调用 |
| `scanner.py` | 52 | **62%** | 基础扫描被测，函数目录未测 |
| `manifest.py` | 82 | **70%** | CRUD 被测，文件 I/O 边界未测 |
| `config.py` | 62 | **77%** | 环境变量被测，profile/load 未测 |

### 🟢 良好（≥ 80%）

| 模块 | 代码行 | 覆盖率 | 说明 |
|------|--------|--------|------|
| `exceptions.py` | 35 | **83%** | 核心异常被测 |
| `ddic.py` | 128 | **84%** | XML/DDL 构建被测 |
| `types.py` | 69 | **90%** | 注册+解析被测，新注册 6 种未测 |
| `sorter.py` | 68 | **96%** | 几乎全覆盖 |
| `xml_utils.py` | 5 | **100%** | 全覆盖 |
| `__init__.py` 系列 | 15 | **100%** | 全覆盖 |

---

## 三层覆盖率分析

```
项目架构            代码行    覆盖率    未覆盖
──────────────────────────────────────────────
CLI 层  parser+app     139     5%       132
命令层  commands/*    1,548     8%     1,424
API 层  client.py      716     7%       665
基础层  其他模块       615    74%       159
──────────────────────────────────────────────
合计                 3,018    22%     2,344
```

### 关键发现

1. **CLI 层 + 命令层 + API 层 = 2,403 行，覆盖率仅 7%**
   — 这三层占总代码量的 80%，但几乎没有测试
   — 原因：现有 68 用例全部测的是基础层（types/config/ddic/manifest/sorter）

2. **基础层覆盖率 74%** — 已经不错
   — types.py 的 6 种新注册类型需要补充测试
   — config.py 的 `load_config(profile=...)` 需要补充测试

3. **单文件代码量 Top 3**：
   - `client.py` (716行) — 0 测试 ← 最大风险点
   - `commands/crud.py` (560行) — 0 测试
   - `commands/batch.py` (230行) — 0 测试

---

## 提升路径

| 目标覆盖率 | 需要新增测试 | 预计工时 |
|-----------|-------------|---------|
| 50% | client.py + commands 核心方法 (~130 用例) | 6h |
| 70% | 所有命令 + cli 入口 (~90 用例) | 4h |
| 80% | 边界条件 + 错误路径 (~50 用例) | 3h |
| 90% | 极端场景 + 集成测试 (~40 用例) | 3h |

> HTML 详细报告已生成：`tests/coverage_html/index.html`