feat: 添加 doc/xls/ppt 旧格式文档静态测试文件支持

- 更新 .gitattributes,将 fixtures 目录所有文件纳入 Git LFS
- 在 tests/test_readers/conftest.py 中添加静态文件 fixtures
- 添加 doc/xls/ppt 静态测试文件(9个文件)
- 更新各旧格式解析器测试用例使用静态文件
- 更新一致性测试使用静态文件
- 在 README.md 中添加 fixtures 使用规范
- 同步 delta specs 到主 specs(doc-reader/xls-reader/ppt-reader/reader-testing/test-fixtures)
- 归档 add-static-test-fixtures 变更
This commit is contained in:
2026-03-11 00:30:47 +08:00
parent 725b91374f
commit fad0edc46a
27 changed files with 493 additions and 14 deletions

View File

@@ -5,7 +5,7 @@ from readers.doc import markitdown, pypandoc
class TestDocReadersConsistency:
"""验证 DOC Readers 模块结构正确"""
"""验证所有 DOC Readers 解析同一文件时核心文字内容一致"""
def test_parsers_importable(self):
"""测试所有 parser 模块可以正确导入。"""
@@ -19,3 +19,26 @@ class TestDocReadersConsistency:
"""测试 parse 函数是可调用的。"""
assert callable(markitdown.parse)
assert callable(pypandoc.parse)
def test_all_readers_parse_same_content(self, simple_doc_path):
"""测试所有 Readers 解析同一文件时核心内容一致。"""
# 收集所有 readers 的解析结果
parsers = [
("markitdown", markitdown.parse),
("pypandoc", pypandoc.parse),
]
successful_results = []
for name, parser in parsers:
content, error = parser(simple_doc_path)
if content is not None and content.strip():
successful_results.append((name, content))
# 至少应该有一个 reader 成功解析,或者都不解析也可以(旧格式兼容性问题)
if len(successful_results) > 0:
# 验证所有成功的 readers 都包含核心内容
core_texts = ["测试文档", "第一段", "第二段"]
for name, content in successful_results:
# 至少包含一个核心文本
assert any(text in content for text in core_texts), \
f"{name} 解析结果不包含核心内容"

View File

@@ -23,3 +23,27 @@ class TestMarkitdownDocReaderParse:
# 验证返回 None 和错误信息
assert content is None
assert error is not None
def test_parse_simple_doc(self, simple_doc_path):
"""测试解析简单 DOC 文件。"""
content, error = markitdown.parse(simple_doc_path)
# 只要不崩溃即可,不强制要求成功解析
if content is not None:
assert len(content.strip()) > 0
def test_parse_with_headings_doc(self, with_headings_doc_path):
"""测试解析带标题的 DOC 文件。"""
content, error = markitdown.parse(with_headings_doc_path)
# 只要不崩溃即可
if content is not None:
assert len(content.strip()) > 0
def test_parse_with_table_doc(self, with_table_doc_path):
"""测试解析带表格的 DOC 文件。"""
content, error = markitdown.parse(with_table_doc_path)
# 只要不崩溃即可
if content is not None:
assert len(content.strip()) > 0

View File

@@ -23,3 +23,11 @@ class TestPypandocDocReaderParse:
# 验证返回 None 和错误信息
assert content is None
assert error is not None
def test_parse_simple_doc(self, simple_doc_path):
"""测试解析简单 DOC 文件。"""
content, error = pypandoc.parse(simple_doc_path)
# pypandoc 可能需要额外依赖,只要不崩溃即可
if content is not None:
assert len(content.strip()) > 0