lanyuanxiaoyao
ab2510a400
Add complete test infrastructure for yaml2pptx project with 245+ tests covering unit, integration, and end-to-end scenarios. Test structure: - Unit tests: elements, template system, validators, loaders, utils - Integration tests: presentation and rendering flows - E2E tests: CLI commands (convert, check, preview) Key features: - PptxFileValidator for Level 2 PPTX validation (file structure, element count, content matching, position tolerance) - Comprehensive fixtures for test data consistency - Mock-based testing for external dependencies - Test images generated with PIL/Pillow - Boundary case coverage for edge scenarios Dependencies added: - pytest, pytest-cov, pytest-mock - pillow (for test image generation) Documentation updated: - README.md: test running instructions - README_DEV.md: test development guide Co-authored-by: OpenSpec change: add-comprehensive-tests
4.3 KiB
4.3 KiB
ADDED Requirements
Requirement: 元素类单元测试
系统 SHALL 为所有元素类（TextElement、ImageElement、ShapeElement、TableElement）提供单元测试。
Scenario: TextElement 创建验证
- WHEN 创建 TextElement 实例
- THEN box 参数被验证为包含 4 个数字的列表
- AND 无效的 box 会引发 ValueError
Scenario: TextElement 颜色验证
- WHEN TextElement 的 font.color 格式无效
- THEN validate() 返回包含 INVALID_COLOR_FORMAT 错误的 ValidationIssue 列表
Scenario: TextElement 字体大小验证
- WHEN TextElement 的 font.size 小于 8pt
- THEN validate() 返回包含 FONT_TOO_SMALL 警告的 ValidationIssue 列表
Scenario: ImageElement 创建验证
- WHEN 创建 ImageElement 实例
- THEN src 参数必须非空
- AND 空的 src 会引发 ValueError
Scenario: ShapeElement 类型验证
- WHEN ShapeElement 的 shape 类型不支持
- THEN validate() 返回包含 INVALID_SHAPE_TYPE 错误的 ValidationIssue 列表
Scenario: TableElement 数据验证
- WHEN TableElement 的 data 行列数不一致
- THEN validate() 返回包含 TABLE_INCONSISTENT_COLUMNS 错误的 ValidationIssue 列表
Scenario: 元素工厂函数
- WHEN 调用 create_element() 并传入不同 type
- THEN 返回对应类型的元素对象
- AND 不支持的 type 会引发 ValueError
Requirement: 模板系统单元测试
系统 SHALL 为模板系统（Template 类）提供单元测试。
Scenario: 模板初始化验证
- WHEN Template 初始化时未指定 templates_dir
- THEN 引发 YAMLError
Scenario: 模板名称验证
- WHEN Template 初始化时模板名称包含路径分隔符
- THEN 引发 YAMLError
Scenario: 变量解析
- WHEN 调用 resolve_value() 并包含变量引用
- THEN 返回解析后的值
- AND 未定义的变量会引发 YAMLError
Scenario: 条件渲染评估
- WHEN 调用 evaluate_condition() 并传入条件表达式
- THEN 返回正确的布尔值
Scenario: 模板渲染
- WHEN 调用 render() 并提供变量值
- THEN 返回渲染后的元素列表
- AND 缺少必需变量会引发 YAMLError
Requirement: 验证器单元测试
系统 SHALL 为所有验证器提供单元测试。
Scenario: 几何验证器 - 元素边界检查
- WHEN 元素超出页面边界
- THEN GeometryValidator 返回 ELEMENT_OUT_OF_BOUNDS 警告
Scenario: 几何验证器 - 完全在页面外
- WHEN 元素完全在页面外
- THEN GeometryValidator 返回 ELEMENT_COMPLETELY_OUT_OF_BOUNDS 警告
Scenario: 资源验证器 - 图片检查
- WHEN 图片文件不存在
- THEN ResourceValidator 返回 IMAGE_FILE_NOT_FOUND 错误
Scenario: 资源验证器 - 模板检查
- WHEN 模板文件不存在
- THEN ResourceValidator 返回 TEMPLATE_FILE_NOT_FOUND 错误
Scenario: 主验证器协调
- WHEN Validator.validate() 执行
- THEN 调用所有子验证器
- AND 按级别分类问题（ERROR/WARNING/INFO）
Requirement: YAML 加载器单元测试
系统 SHALL 为 YAML 加载器提供单元测试。
Scenario: 文件不存在
- WHEN 加载不存在的文件
- THEN 引发 YAMLError 并包含 "文件不存在" 消息
Scenario: YAML 语法错误
- WHEN 加载包含语法错误的 YAML 文件
- THEN 引发 YAMLError 并包含错误行号信息
Scenario: 演示文稿结构验证
- WHEN data 缺少 slides 字段
- THEN validate_presentation_yaml() 引发 YAMLError
Scenario: 模板结构验证
- WHEN 模板 data 缺少 elements 字段
- THEN validate_template_yaml() 引发 YAMLError
Requirement: 工具函数单元测试
系统 SHALL 为工具函数提供单元测试。
Scenario: 颜色转换 - 完整格式
- WHEN 调用 hex_to_rgb() 并传入 #RRGGBB 格式
- THEN 返回正确的 (R, G, B) 元组
Scenario: 颜色转换 - 短格式
- WHEN 调用 hex_to_rgb() 并传入 #RGB 格式
- THEN 返回正确的 (R, G, B) 元组
Scenario: 颜色转换 - 无效格式
- WHEN 调用 hex_to_rgb() 并传入无效格式
- THEN 引发 ValueError
Scenario: 颜色格式验证
- WHEN 调用 validate_color() 并传入有效颜色
- THEN 返回 True
- AND 无效颜色返回 False