feat: 添加页面级 enabled 参数支持幻灯片启用/禁用控制
添加页面级 enabled 布尔参数,用于临时禁用整个幻灯片,无需删除或注释 YAML 内容。
与元素级 visible 条件渲染独立工作,提供两层控制机制。
主要变更:
- 在 yaml2pptx.py 主循环中检查 enabled 参数,跳过禁用的幻灯片
- 实现独立的 slide_index 计数器,准确统计实际渲染的幻灯片数量
- 在 yaml_loader.py 中添加 enabled 字段验证,确保类型为布尔值
- 添加 11 个测试用例,覆盖各种使用场景
- 更新 README.md 和 README_DEV.md 文档,说明 enabled 和 visible 的区别
- 创建新的 slide-enabled-control capability 规范
- 更新 template-system 规范,添加 enabled 字段支持
使用示例:
slides:
- template: title-slide
vars:
title: "正常页面"
- enabled: false
template: work-in-progress
vars:
title: "临时禁用的页面"
测试:所有 282 个单元测试通过
This commit is contained in:
@@ -90,6 +90,56 @@ class TestValidatePresentationYaml:
|
||||
validate_presentation_yaml(data, "test.yaml")
|
||||
assert "test.yaml" in str(exc_info.value)
|
||||
|
||||
def test_slide_enabled_true(self):
|
||||
"""测试 enabled=true 的幻灯片"""
|
||||
data = {
|
||||
"slides": [
|
||||
{"enabled": True, "elements": []}
|
||||
]
|
||||
}
|
||||
# 不应该引发错误
|
||||
validate_presentation_yaml(data)
|
||||
|
||||
def test_slide_enabled_false(self):
|
||||
"""测试 enabled=false 的幻灯片"""
|
||||
data = {
|
||||
"slides": [
|
||||
{"enabled": False, "elements": []}
|
||||
]
|
||||
}
|
||||
# 不应该引发错误
|
||||
validate_presentation_yaml(data)
|
||||
|
||||
def test_slide_enabled_invalid_string(self):
|
||||
"""测试 enabled 为字符串时拒绝"""
|
||||
data = {
|
||||
"slides": [
|
||||
{"enabled": "false", "elements": []}
|
||||
]
|
||||
}
|
||||
with pytest.raises(YAMLError, match="enabled 必须是布尔值"):
|
||||
validate_presentation_yaml(data)
|
||||
|
||||
def test_slide_enabled_invalid_number(self):
|
||||
"""测试 enabled 为数字时拒绝"""
|
||||
data = {
|
||||
"slides": [
|
||||
{"enabled": 0, "elements": []}
|
||||
]
|
||||
}
|
||||
with pytest.raises(YAMLError, match="enabled 必须是布尔值"):
|
||||
validate_presentation_yaml(data)
|
||||
|
||||
def test_slide_enabled_invalid_expression(self):
|
||||
"""测试 enabled 为条件表达式时拒绝"""
|
||||
data = {
|
||||
"slides": [
|
||||
{"enabled": "{some_var}", "elements": []}
|
||||
]
|
||||
}
|
||||
with pytest.raises(YAMLError, match="enabled 必须是布尔值"):
|
||||
validate_presentation_yaml(data)
|
||||
|
||||
|
||||
class TestValidateTemplateYaml:
|
||||
"""validate_template_yaml 函数测试类"""
|
||||
|
||||
Reference in New Issue
Block a user