探秘pytest-check：多失败测试插件

在软件测试中，我们通常期望一个测试函数在首次断言失败时立即停止运行。但有时，你可能希望在同一个测试里检查多个条件，以便了解所有潜在问题。这就是pytest-check发挥效用的时刻。这是一个Pytest插件，它允许每个测试函数有多个失败点，让你全面了解测试结果。

安装与使用

安装pytest-check非常简单，通过PyPI或conda-forge即可：

pip install pytest-check
conda install -c conda-forge pytest-check

在你的代码中，导入并使用check上下文管理器或者作为fixture来执行一系列检查，如下所示：

import httpx
from pytest_check import check

def test_httpx_get():
    r = httpx.get('https://www.example.org/')
    # 先检查状态码
    assert r.status_code == 200
    # 后续检查不因前面的失败而中断
    with check:
        assert r.is_redirect is False
    with check:
        assert r.encoding == 'utf-8'
    with check:
        assert 'Example Domain' in r.text

检查辅助函数

除了基本的断言外，pytest-check还提供了多种便利的检查方法，如check.equal、check.is_not等，可以直接使用它们进行更直观的比较：

def test_httpx_get_with_helpers():
    r = httpx.get('https://www.example.org/')
    assert r.status_code == 200
    check.is_false(r.is_redirect)
    check.equal(r.encoding, 'utf-8')
    check.is_in('Example Domain', r.text)

自定义检查函数

使用check.check_func装饰器，你可以把任何包含断言的辅助函数包装成非阻塞的断言函数，增强可复用性。

from pytest_check import check

@check.check_func
def is_four(a):
    assert a == 4

def test_all_four():
    is_four(1)
    is_four(2)
    is_four(3)
    is_four(4)

功能特性

• 多失败报告：提供详细的失败信息，即使在多个检查中。
• 伪堆栈跟踪：为每一个失败点提供简化的堆栈信息，以节省输出空间。
• 颜色提示：默认情况下，失败信息会以红色高亮显示，方便快速定位。
• 控制台选项：你可以通过--tb=no关闭输出，或者通过--check-max-tb和--check-max-report限制输出量。
• 停止单元测试：设置-x或--maxfail=1可以在第一个检查失败后立即终止测试。

应用场景

pytest-check适用于各种需要全面评估错误情况的场合，例如：

• 在复杂的HTTP响应测试中，不仅检查状态码，还要验证响应体的内容。
• 验证数据库查询结果是否符合预期，同时检查多个字段。
• 在单元测试中，检查对象的多个属性是否正确设置。

利用这个强大的工具，你将能更高效地找出并修复代码中的问题，同时保持清晰的测试记录。

总的来说，pytest-check以其独特的功能和易用性，为Python测试带来了一种新的方式。不妨现在就将其集成到你的项目中，享受它带来的便捷吧！