寻求可显示文件差异的pytest文件内容断言插件

推荐的pytest插件及用法 #

pytest-diff #

这个插件可直接在断言文件内容时展示详细差异，无需自行编写复杂对比逻辑：

1. 安装插件：

pip install pytest-diff

2. 在测试用例中直接使用原生断言对比文件内容：

from pathlib import Path

def test_file_content():
    expected = Path("expected.txt")
    actual = Path("actual.txt")
    assert actual.read_text() == expected.read_text()

当断言失败时，pytest-diff会自动渲染两份文件的行级差异，高亮显示不同部分。

pytest-testdox（可选增强） #

若想让差异展示更直观，搭配该插件可让输出格式更易读——它会以文档风格呈现测试结果，包括差异内容。安装后直接运行pytest即可生效。

自定义函数优化（无需插件） #

如果不想额外安装插件，可修改现有函数，借助difflib库生成差异内容：

import filecmp
from pathlib import Path
import difflib

def assert_files_equal(p1: Path, p2: Path):
    if not filecmp.cmp(p1, p2):
        with open(p1, 'r') as f1, open(p2, 'r') as f2:
            diff = difflib.unified_diff(
                f1.readlines(),
                f2.readlines(),
                fromfile=str(p1),
                tofile=str(p2),
                lineterm=''
            )
            diff_content = '\n'.join(list(diff))
            raise AssertionError(f"文件内容差异:\n{diff_content}")

这样断言失败时会直接输出统一格式的差异对比，清晰展示具体不同的行。

内容的提问来源于stack exchange，提问作者Kevin Pauli