lanyuanxiaoyao/PPTX
1
0
Fork 0
Code Activity
33 Commits 1 Branch 0 Tags
master
Commit Graph

7 Commits

Author SHA1 Message Date
lanyuanxiaoyao
98098dc911 feat: 实现模板库metadata和跨域字体引用系统 
实现了统一的metadata结构和字体作用域系统，支持文档和模板库之间的单向字体引用。

主要变更：
- 模板库必须包含metadata字段（包括size、fonts、fonts_default）
- 实现文档和模板库的size一致性校验
- 实现字体作用域系统（文档可引用模板库字体，反之不可）
- 实现跨域循环引用检测
- 实现fonts_default级联规则（模板库→文档→系统默认）
- 添加错误代码常量（SIZE_MISMATCH、FONT_NOT_FOUND等）
- 更新文档和开发者指南

测试覆盖：
- 新增33个测试（单元测试20个，集成测试13个）
- 所有457个测试通过

Breaking Changes：
- 模板库文件必须包含metadata字段
- 模板库metadata.size为必填字段
- 文档和模板库的size必须一致

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-03-05 18:12:05 +08:00
lanyuanxiaoyao
f1aae96a04 refactor: 重构外部模板系统，改为单文件模板库模式 
主要变更：
- 将 templates_dir 参数改为 template_file，支持单个模板库 YAML 文件
- 添加模板库 YAML 验证功能
- 为模板添加 base_dir 支持，正确解析相对路径资源
- 内联模板与外部模板同名时改为警告（内联优先）
- 移除模板缓存机制，直接使用模板库字典
- 更新所有相关测试以适配新的模板加载方式

此重构简化了模板管理，使模板资源的路径解析更加清晰明确。
 2026-03-05 13:27:12 +08:00
lanyuanxiaoyao
2fd8bc1b4a feat: 为metadata、模板和幻灯片添加description字段支持 
添加可选的description字段用于文档目的，不影响渲染输出。

主要更改：
- core/presentation.py: 添加metadata.description属性
- core/template.py: 添加template.description属性
- tests: 添加16个新测试用例验证description功能
- docs: 更新README.md和README_DEV.md文档
- specs: 新增page-description规范文件
 2026-03-04 13:22:33 +08:00
lanyuanxiaoyao
5d60f3c2c2 feat: 实现模板元素混合模式功能 
新增混合模式，允许幻灯片同时使用 template 和 elements，实现更灵活的布局组合。

核心变更：
- core/presentation.py: 修改 render_slide() 支持三种模式（纯模板/纯自定义/混合模式）
- 自定义元素可访问模板变量，实现主题色等值的统一控制
- 元素采用简单追加策略合并（模板元素在前，自定义元素在后）
- 完全向后兼容现有用法

测试覆盖：
- 新增 TestRenderSlideHybridMode 测试类，包含 8 个测试用例
- 验证向后兼容性（纯模板模式、纯自定义模式）
- 验证混合模式功能（变量共享、空元素列表、元素顺序等）
- 所有 79 个测试通过

文档更新：
- README.md: 新增"混合模式模板"章节，包含语法示例和使用场景
- README_DEV.md: 更新开发文档，说明元素合并策略和实现细节

规范更新：
- openspec/specs/template-system/spec.md:
  - 修改"系统必须支持自定义幻灯片"需求，支持混合模式
  - 新增 4 个需求：变量共享、元素合并策略、向后兼容、内联模板支持
  - 新增 13 个场景定义

归档：
- openspec/changes/archive/2026-03-04-template-element-composition/: 完整变更记录
 2026-03-04 13:12:51 +08:00
lanyuanxiaoyao
22614d6f55 fix: 修复 7 个失败测试和 1 个错误测试 
- 修复 conftest_pptx.py 中元素类型检测：使用 has_text_frame 替代不存在的 MSO_SHAPE.TEXT_BOX
- 修复 test_presentation.py 中 3 个测试：使用对象属性访问替代字典访问
- 修复 unit/test_presentation.py 中路径比较问题
- 添加缺失的 mock_template_class fixture

测试通过率: 316/316 (100%)
代码覆盖率: 94%
 2026-03-03 01:25:36 +08:00
lanyuanxiaoyao
f273cef195 fix: use quoted strings for size values in YAML to prevent time parsing 
YAML parser interprets 16:9 as time format (16h 9m = 969s).
Using quoted strings "16:9" ensures correct string parsing.
 2026-03-02 23:50:31 +08:00
lanyuanxiaoyao
ab2510a400 test: add comprehensive pytest test suite 
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
 2026-03-02 23:11:34 +08:00