Test Strategy

April 12, 2026 · View on GitHub

当前真实覆盖

层	文件	范围	默认运行
Unit	`tests/test_units.py`, `tests/test_errors.py`, `tests/test_doctor.py`	纯函数、错误层级、doctor env report	✓
Integration	`tests/test_deck.py`, `tests/test_slide.py`, `tests/test_shape.py`	`Deck` / `Slide` / `Shape` 的 open-edit-save-reopen roundtrip	✓
CLI	`tests/test_cli.py`	通过 `main(argv=...)` 调用已实现子命令，不走 subprocess	✓
Render	`tests/test_render.py`	`render_slide_png()` smoke test	默认 skip，`-m libreoffice` 时运行

测试不依赖外部 .pptx 文件。tests/conftest.py 用 python-pptx 在每个 test run 里动态生成一个最小 deck：

2 张 slide
slide 0: 一个多 run / 多 paragraph 的 text box、一个副标题 text box、一个 rectangle、speaker notes
slide 1: 一个 text box、一个 rectangle、speaker notes
shape 名称固定，方便按 name、id、text 三种方式查找

这样每个写操作都可以做真正的 roundtrip：打开、修改、保存、重新打开、验证结果。

units.py: parse_unit, format_emu, parse_color
errors.py: 全部 domain error 的继承关系
deck.py: Deck.open, save, slides, slide, add_slide, delete_slide, to_dict, to_markdown
slide.py: shape, shape_by_text, notes, set_notes, to_dict, to_markdown, add_text_box, add_rectangle, delete_shape
shape.py: id, name, type, position, size, text, has_text, set_text, set_position, set_size, set_fill, set_font
doctor.py: DoctorReport, run_doctor() 的无 deck env check

tests/test_cli.py 只覆盖当前真正实现并接到 handler 的命令：

同时覆盖：

下面这些能力不应在当前测试文档里写成已覆盖，因为它们现在并没有全部实现到可执行状态：

CLI: set-position, set-size, set-fill, set-font, add-slide, delete-slide, move-slide, add-picture, replace-picture, normalize-fonts, check-overflow, raw-xml-patch
library / module level: overflow.py, dump.py 这种文档里曾提到但当前源码中并不存在的模块
依赖真实 Office / PowerPoint 打开的视觉一致性验证

tests/test_render.py 用 @pytest.mark.libreoffice 标记，并在默认 pytest 下跳过。运行方式：

.venv/bin/python -m pytest -v -m libreoffice

如果本机没装 LibreOffice 或 poppler，这个测试会 skip；默认测试结果不依赖它。

.venv/bin/python -m pytest -v 全 pass
.venv/bin/python -m pytest -v -m libreoffice 中 render tests 被正确选中；若缺少依赖则 skip，若依赖存在则 pass