【免费下载】 pytest 中文文档教程

项目介绍

pytest 是一个功能强大、易于上手的 Python 测试框架。本项目（pytest-chinese-doc）是 pytest 官方文档的中文翻译，不仅包含翻译，还融入了作者的理解和实践经验，旨在帮助更多开发者了解和使用 pytest。

项目快速启动

安装 pytest

首先，确保你已经安装了 Python。然后，通过以下命令安装 pytest：

pip install pytest

编写第一个测试

创建一个名为 test_sample.py 的文件，并添加以下内容：

def test_answer():
    assert 5 == 5

运行测试

在终端中，导航到包含 test_sample.py 文件的目录，并运行以下命令：

pytest

你应该会看到类似以下的输出：

============================= test session starts ==============================
platform linux -- Python 3.x.y, pytest-6.x.y, py-1.x.y, pluggy-0.x.y
rootdir: /path/to/your/project
collected 1 item

test_sample.py .                                                          [100%]

============================== 1 passed in 0.12s ===============================

应用案例和最佳实践

应用案例

假设你有一个简单的计算器应用，包含加法和减法功能。你可以使用 pytest 来测试这些功能。

# calculator.py
def add(a, b):
    return a + b

def subtract(a, b):
    return a - b

对应的测试文件 test_calculator.py 如下：

from calculator import add, subtract

def test_add():
    assert add(2, 3) == 5

def test_subtract():
    assert subtract(5, 3) == 2

最佳实践

1. 使用 fixtures：通过 fixtures 可以实现测试数据的共享和复用。
2. 参数化测试：使用 @pytest.mark.parametrize 装饰器可以对同一测试函数进行多组数据测试。
3. 捕获输出：使用 capsys 或 capfd 捕获标准输出和标准错误输出。

典型生态项目

pytest-cov

用于代码覆盖率报告：

pip install pytest-cov
pytest --cov=your_project

pytest-xdist

用于并行测试：

pip install pytest-xdist
pytest -n 4

pytest-html

用于生成 HTML 测试报告：

pip install pytest-html
pytest --html=report.html

通过这些插件，可以进一步扩展 pytest 的功能，提升测试效率和质量。