pytest-ddreport(入门篇)

编写目的

1. pytest受规则限制，参数化是在测试运行之前静态地确定参数值的，这意味着参数化不支持在测试运行时动态生成参数值。
2. 缺乏简洁风格的测试报告模板，使得测试人员难以定位失败用例问题。
3. 每次自动化项目都需封装大量常用方法。
4. 接口请求需重复携带参数，而requests的session好像并不能满足我们的需求。

库的功能

• 提供环境配置参数，方便切换环境。
• 封装requests方法，用例编写中接口请求只需填写关键信息，省去重复参数填写。
• 数据库封装mysql和pg，简化数据库操作。
• 程序运行后自动生成简约测试报告，详细展示代码异常和用例失败信息，便于问题定位。
• 在测试运行时动态生成参数值（参数化可动态）。

注意事项

• 在安装当前插件之前，请确保已安装 pytest 库。
• 由于新版 PyCharm 无法友好地识别 Pytest 插件中的 fixture，导致编写用例时无法自动补全代码。因此，不得已改变了插件的实现逻辑，并对插件进行了修复和优化。如果您希望尝试此插件，请安装最新版本，当前最新版本为 ddreport==4.6。

插件安装

pip install ddreport

项目结构

my_project/
│
├── Cases/
│   └── test_demo1.py
│
├── reports/
│
├── conftest.py
└── main.py

• Cases是存放测试用例文件的目录
• reports是存放测试报告的目录

编写教程

第一步（conftest.py）

# conftest.py
from ddreport import ddreport
import pytest


@pytest.fixture(scope='session')
def drt():
    return ddreport()

第二步（main.py）

# main.py
import pytest


if __name__ == "__main__":

    pytest.main(
        [
            '--ddreport=reports/test.html',     # 测试报告路径
            '--title=API自动化测试',             # 测试报告标题
            '--desc=测试测试测试',               # 测试报告描述
            '--tester=duanliangcong',           # 测试人员
            'Cases/test_demo1.py'               # 需要执行的用例
        ]
    )

第三步（演示测试用例）

# test_demo1.py
class TestDemo:

    def test_1(self, drt):
        """请求百度"""
        r = drt.api.query("get", "https://www.baidu.com")  # 请求接口
        assert "百度" in r.text

运行

完成上述步骤后，执行 main.py 文件，即可在 reports 目录下生成 test.html 测试报告。

测试报告

失败详情

点击序号前面的箭头即可展开查看，失败、错误以及跳过的用例都会有详细的信息

查看成功用例详情

默认情况下，成功用例的详细信息不会显示，旨在减少测试报告的大小。如需查看详细信息，需在main.py中添加--apiresult参数，示例如下：

# main.py
import pytest


if __name__ == "__main__":

    pytest.main(
        [
            '--ddreport=reports/test.html',     # 测试报告路径
            '--title=API自动化测试',             # 测试报告标题
            '--desc=测试测试测试',               # 测试报告描述
            '--tester=duanliangcong',           # 测试人员
            '--apiresult=1',                    # 查看成功用例的详情
            'Cases/test_demo1.py'               # 需要执行的用例
        ]
    )

再次执行 main.py 后，即可查看成功用例的详细信息