Pytest框架 — 10、Pytest的标记（一）

目录

• 1、标记跳过
  
  
  
  • （一）无条件跳过skip
    
  • （二）有条件跳过skipif
    
  
  
• 2、标记实现参数化
  
  
  
  • 示例1：单个参数
    
  • 示例2：多个参数
    
  • 示例3：多个参数化（笛卡尔积）
    
  • 示例4：ids参数给用例起别名
    
  • 示例5：使用indirect处理参数值
    
  • 示例6：标记数据
    
  
  

1、标记跳过

在自动化测试过程中，我们经常会遇到因为某些功能阻塞，未开发完成或者环境等问题，一些测试用例不能执行，如果人工去注释掉，后面还需要再恢复才能继续测试，pytest的标记跳过功能就可以实现暂时跳过。
（一）无条件跳过skip

使用方法：通过@pytest.mark.skip(reason=跳过原因)装饰器标记要跳过的测试用例

• 参数reason：跳过的原因，非必填
  

1. import pytest
4. @pytest.mark.skip
5. def test_register():
6.     # 测试注册功能
7.     raise Exception("该功能尚未开发完成")
10. @pytest.mark.skip(reason="该功能尚未开发完成")
11. def test_logout():
12.     # 注销
13.     raise Exception("该功能尚未开发完成")
16. def test_login():
17.     # 登录功能
18.     assert True
20. """
21. 执行结果
22. mark/skip_mark.py::test_register SKIPPED (unconditional skip)
23. mark/skip_mark.py::test_logout SKIPPED (该功能尚未开发完成)
24. mark/skip_mark.py::test_login PASSED
25. """

复制代码

（二）有条件跳过skipif

使用方法：通过@pytest.mark.skipif(condition=跳过条件，reason=跳过原因)标记要跳过的测试用例。

• 参数condition：跳过的条件，值为True则跳过，值为False则继续执行，默认值为True
  
• 参数reason：必填，跳过的原因
  

1. import pytest
3. version = 3.0
6. @pytest.mark.skipif(condition=version > 3.0 or version == 3.0, reason="3.0及以上版本不提供下载功能")
7. def test_download():
8.     print("下载功能")
11. def test_upload():
12.     print("上传功能")
15. """
16. 执行结果
17. mark/skipif_mark.py::test_download SKIPPED (3.0及以上版本不提供下载功能)
18. mark/skipif_mark.py::test_upload 上传功能
19. PASSED
20. """

复制代码

2、标记实现参数化

通过@pytest.mark.parametrize(argnames, argvalues, indirect=False, ids=None, scope=None)装饰器来实现参数化。
参数说明：

• argnames：参数名，使用逗号分隔的列表，或元祖，或字符串，表示一个或多个参数名，【常用】
  
• argvalues：参数值，可以是列表、元祖、字典列表、字典元祖，【常用】
  
• indirect：中文翻译为中间人，为True时可以对argvalues的参数值进行处理，默认False，【不常用】
  
  
  
  • indirect=True: 且argnames的值为fixture函数名，此时argnames的值变为可执行函数，会将argvalues的参数值当做参数传递给fixture函数进行处理，fixture函数返回处理结果给argnames
    
  • indirect=False: argnames仅为参数名
    
  
  
• ids：给用例起别名，字符串列表或数字列表，不设置会自动从测试数据中提取
  
• scope：待理解【不常用】
  

示例1：单个参数

1. import pytest
4. phone_list = [
5.     "13881118888",
6.     "13012034288",
7.     "13234324188",
8.     "13231423288"
9. ]
11. @pytest.mark.parametrize(argnames="phone_num", argvalues=phone_list)
12. def test_phone_number(phone_num):  # 注意，这里的参数要和argnames参数名一致
13.     print(f"正在测试手机号{phone_num}")
15. """
16. 执行结果
17. mark/parametrize/single_param.py::test_phone_number[13881118888] 正在测试手机号13881118888
18. PASSED
19. mark/parametrize/single_param.py::test_phone_number[13012034288] 正在测试手机号13012034288
20. PASSED
21. mark/parametrize/single_param.py::test_phone_number[13234324188] 正在测试手机号13234324188
22. PASSED
23. mark/parametrize/single_param.py::test_phone_number[13231423288] 正在测试手机号13231423288
24. PASSED
25. """

复制代码

示例2：多个参数

1. import pytest
3. user_info = [
4.     ("张三", "18011111111"),
5.     ("李四", "18022222222"),
6.     ("王五", "18033333333")
7. ]
9. @pytest.mark.parametrize(argnames="name,phonenum", argvalues=user_info)
10. def test_read_info(name, phonenum):
11.     print(f"正在读取用户{name}，手机号{phonenum}")
13. """
14. 执行结果
15. mark/parametrize/multiple_param.py::test_read_info[\u5f20\u4e09-18011111111] 正在读取用户张三，手机号18011111111
16. PASSED
17. mark/parametrize/multiple_param.py::test_read_info[\u674e\u56db-18022222222] 正在读取用户李四，手机号18022222222
18. PASSED
19. mark/parametrize/multiple_param.py::test_read_info[\u738b\u4e94-18033333333] 正在读取用户王五，手机号18033333333
20. PASSED
21. """

复制代码

由上面例子执行结果中可以看到中文参数值乱码了，解决办法如下
方法1. 在pytest.ini中加入disable_test_id_escaping_and_forfeit_all_rights_to_community_support=True
方法2. 在conftest.py中加入

1. # 收集每一个用例name和nodeid的中文显示，转化为utf-8形式
2. def pytest_collection_modifyitems(items):
3.     for item in items:
4.         item.name = item.name.encode("utf-8").decode("unicode_escape")
5.         item._nodeid = item.nodeid.encode("utf-8").decode("unicode_escape")

复制代码

示例3：多个参数化（笛卡尔积）

1. import pytest
4. data1 = ['a', 'b', 'c']
5. data2 = [1, 2]
8. @pytest.mark.parametrize('test1', data1)
9. @pytest.mark.parametrize('test2', data2)
10. def test_param(test1, test2):
11.     print('\n测试数据：{}-{}'.format(test1, test2))
12. """
13. 执行结果
14. mark/parametrize/multiple_parameterization.py::test_param[1-a]
15. 测试数据：a-1
16. PASSED
17. mark/parametrize/multiple_parameterization.py::test_param[1-b]
18. 测试数据：b-1
19. PASSED
20. mark/parametrize/multiple_parameterization.py::test_param[1-c]
21. 测试数据：c-1
22. PASSED
23. mark/parametrize/multiple_parameterization.py::test_param[2-a]
24. 测试数据：a-2
25. PASSED
26. mark/parametrize/multiple_parameterization.py::test_param[2-b]
27. 测试数据：b-2
28. PASSED
29. mark/parametrize/multiple_parameterization.py::test_param[2-c]
30. 测试数据：c-2
31. PASSED
32. """

复制代码

示例4：ids参数给用例起别名

1. import pytest
4. user_info = [
5.     ("张三", "18011111111"),
6.     ("李四", "18022222222"),
7.     ("王五", "18033333333")
8. ]
10. @pytest.mark.parametrize(argnames="name,phonenum", argvalues=user_info, ids=["用户1","用户2","用户3"])
11. def test_read_info(name, phonenum):
12.     print(f"正在读取用户{name}，手机号{phonenum}")
13.    
14. """
15. 执行结果
16. mark/parametrize/ids.py::test_read_info[用户1] 正在读取用户张三，手机号18011111111
17. PASSED
18. mark/parametrize/ids.py::test_read_info[用户2] 正在读取用户李四，手机号18022222222
19. PASSED
20. mark/parametrize/ids.py::test_read_info[用户3] 正在读取用户王五，手机号18033333333
21. PASSED
22. """

复制代码

示例5：使用indirect处理参数值

1. import pytest
3. @pytest.fixture()
4. def fixture_and_parametrize(request):  # request是关键字不能改变，用来接收参数
5.     print('邮箱账号为：{}'.format(request.param))
6.     return request.param + "@qq.com"
9. @pytest.mark.parametrize('fixture_and_parametrize', ['100203', '466238894', '23942423'],
10.                          indirect=True)
11. def test_fixture_and_parametrize_2(fixture_and_parametrize):
12.     print('拼接后邮箱为：{}'.format(fixture_and_parametrize))
14. """
15. 执行结果
16. mark/parametrize/indirect.py::test_fixture_and_parametrize_2[100203] 邮箱账号为：100203
17. 拼接后邮箱为：100203@qq.com
18. PASSED
19. mark/parametrize/indirect.py::test_fixture_and_parametrize_2[466238894] 邮箱账号为：466238894
20. 拼接后邮箱为：466238894@qq.com
21. PASSED
22. mark/parametrize/indirect.py::test_fixture_and_parametrize_2[23942423] 邮箱账号为：23942423
23. 拼接后邮箱为：23942423@qq.com
24. PASSED
25. """

复制代码

示例6：标记数据

在参数化的过程中也可以标记数据进行跳过等

1. import pytest
4. @pytest.mark.parametrize("test_input,expected", [
5.     ("3+9", 12), ("5+4", 9),
6.     pytest.param("7 * 9", 42, marks=pytest.mark.xfail),
7.     pytest.param("8 * 6", 42, marks=pytest.mark.skip)
8. ])
9. def test_mark(test_input, expected):
10.     assert eval(test_input) == expected
11. """
12. 执行结果
13. mark/parametrize/mark_data.py::test_mark[3+9-12] PASSED
14. mark/parametrize/mark_data.py::test_mark[5+4-9] PASSED
15. mark/parametrize/mark_data.py::test_mark[7 * 9-42] XFAIL
16. mark/parametrize/mark_data.py::test_mark[8 * 6-42] SKIPPED (unconditional skip)
17. """

复制代码

参考
https://www.cnblogs.com/miki-peng/p/14736332.html
https://zhuanlan.zhihu.com/p/515377205

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！