1. 使用pytest完成接口自动化 1.1. pytest 简介 pytest 是 Python 的一款开源测试框架。
主要特点:
简单灵活,文档丰富; 能够支持单元测试、功能测试、接口自动化测试等; 具有众多第三方插件,且可以自定义扩展; 支持参数化,可控制测试用例的粒度; 可以很好的和 CI 工具结合,例如 Jenkins 。 1.2. 使用参考 1.2.1. 命名约束 测试文件以"test_"开头/以"_test"结尾 测试类以"Test"开头,并且不能带有 __init__ 方法 测试函数以"test_"开头 默认情况下,pytest 查找当前目录下所有以 test 开始或结尾的 Python 脚本,并执行文件内的所有以 test 开始的函数和方法。
1.2.2. 运行 在终端按需输入以下命令来运行 case:
运行所有 case :pytest 运行指定 case :pytest testCase/test_demo1.py 运行关键字匹配的 case :pytest -k “表达式” 运行标记匹配的 case :pytest -m "标记" 运行后控制台展示详细信息:pytest -v ... 1.2.3. 断言assert pytest 中可以使用 Python 原生的断言语句 assert 来进行验证。
常用:
assert xx:判断 xx 为真 assert not xx:判断 xx 不为真 assert a in b:判断 b 包含 a assert a == b:判断 a 等于 b assert a !=b:判断 a 不等于 b 可以指定断言失败的返回信息,举例如下:
assert response["result_code"] == expected["response"]["result_code"], "实际的返回结果是:{}".format(response["result_code"])
1.2.4. fixture fixture 是 pytest 特有功能,目的是提供一种手段去运行最基本的、重复的测试内容,是将测试前后的预备工作、清理工作的代码分离出核心测试逻辑的一种机制。通常用来对测试方法、测试函数、测试类和整个测试文件进行初始化或还原测试环境。
@pytest.fixture(scope="function", params=None, autouse=False, ids=None, name=None)
scope:作用域,(
function:方法,默认为function
class:类
module:.py文件
session:会话)
params:可选的参数列表,可使多个参数调用fixture功能 autouse:是否默认调用该fixture,默认为False ids:每个字符串id的列表 name:装饰器名字
1.2.4.1. fixture 作为函数参数
可以通过使用 @pytest.fixture 注册成为一个 fixture 函数,来为测试方法提供一个 fixture 对象。
如下图所示,connect_mysql_uds 函数被注册成了一个 fixture 函数,在 test_query_couplist 方法中可以直接被作为参数使用。
1.2.4.2. 在 conftest.py 中管理 fixture
如果多个文件都需要用到这个fixture函数,则可以将该函数放到conftest.py文件中管理,所需的 fixture 对象会自动被 pytest 发现。
1.2.4.3. 执行顺序
较高范围的 fixture(例如session会话级)比低范围的 fixture(例如function函数级或class类级)优先执行。
相同范围的 fixture 对象的按引入的顺序或依赖关系按顺序调用。
1.2.4.4. yield
yield 语句之后的所有代码都视为 teardown 代码。
举例,如下图所示,整个会话结束后,会打印出”关闭数据库”的语句。
1.2.5. mark
1.2.5.1. 标记和分类用例
@pytest.mark.level
用法步骤:
a. 先在 pytest.ini 文件中对标签进行注册
b. 对用例进行标记
@pytest.mark.P0
c. 运行指定标记的用例
在终端输入: pytest -m "P0"
1.2.5.2. 标记跳过用例
无条件跳过:@pytest.mark.skip(reason="跳过原因描述")
在指定条件下跳过:@pytest.mark.skipif(condition, reason="跳过原因描述")
1.2.5.3. 标记用例为预期失败
@pytest.mark.xfail(reason="预期失败描述")
对于功能未完成或已知有问题的用例,可以用 xfail 标记,这样即使断言失败,也不会影响其他测试用例的的执行。
执行 case 后,控制台中显示:
XFAIL:表示预期失败,实际也失败 XPASS:表示预期失败,实际运行没有失败
1.2.5.4. 参数化
我们进行接口测试时,往往很多时候操作步骤都是一样的,只有数据不一样,这时候就可以使用参数化功能,来减少代码冗余。
@pytest.mark.parametrize(argnames, argvalues, ids=None)
argnames:参数名称,字符串格式 argvalues:参数值列表,列表格式 ids:用例的 ID ,字符串列表格式 举例,如下图所示,装饰器会自动对 list_params 解包并赋值给装饰器的第一参数。装饰器的第一个参数中逗号分隔的变量可以作为测试方法的参数,在测试方法内就可以直接获取这些变量的值。
1.2.6. Allure Allure 是一种灵活、轻量级、多语言的测试报告工具,以简洁精美的 web 报告形式展示。
Python 中有一个第三方库:allure-pytest,用于连接 pytest 和 allure ,使它们可以更好的配合使用。
Allure的常用用法: 使用方法 说明 @allure.epic() 描述史诗,即未拆解的story @allure.feature() 描述功能模块 @allure.story() 描述用户故事 @allure.title() 描述用例标题 @allure.step() 描述用例步骤 @allure.severity() 描述用例等级:blocker,critical,normal,minor,trivial
报告的主要页面介绍:
Graphs 该页面展示本次执行结果的统计信息,比如执行结果成功失败比例、测试用例等级分布、用例执行时间等。 Behaviors 该页面根据代码中设定的 @allure.feature()、@allure.story() 等来展示用例执行的结果,这里可以看到用例执行的详细信息