初学 pytest 记录

1. 安装

   pip install pytest
   

   用例可以是函数也可以是类中的方法

   def test_func():print()class TestAdd:
   # def __init__(self):  在 pytest 中不可以使用__init__方法
   #     self.cc = 12345
   @pytest.mark.api
   def test_str(self):res = add('1', '2')assert res == '12'def test_int(self):res = add(1, 2)assert res == 3def test_list(self):res = add([1, 2], [3, 4])assert res == [1, 2, 3, 4]
   

2. 启动测试

   • 命令行输入 pytest 会自动检索项目中所有的用例去执行 参数 -k “xx” 模糊匹配文件执行
   • 根目录新建 main.py 文件 右键运行脚本

   main.py
   import pytest
   pytest.main()
   

3. 用户自定义标记

   可以根据不同类型的用例分成不同的种类.在用例多的情况下可以根据需求执行部分种类测试日志.
   配置
   创建配置文件,我这边创建在项目的根目录下 pytest.ini

   [pytest]
   markers =api : 接口测试ui : UI测试ut : 重试login : 登录测试ddt: 数据驱动测试
   

   在 markers 中key:value 形式的就是自定义的标记,名称:注释
   打标记
   @pytest.mark.标记名称来使用.

   @pytest.mark.tt
   def test_func():print()
   

   使用

   • 命令行

   pytest -m 标记名称
   

   • 添加到配置文件中 pytest.ini 在配置文件中添加参数后.在命令行直接执行 pytest 会自动携带addopts中的参数

   [pytest]
   addopts = -m 标记名称
   

4. 内置标记

   • skip 无条件跳过
   • skipif 满足条件跳过
   • xfail 预期失败
   • xfailif 满足条件预期失败
   • parametrize 参数化
     使用@pytest.mark.parametrize标记.参数1为字段,参数 2 为函数解析出来的嵌套列表

     @pytest.mark.parametrize('a, b, c', read_csv('/Users/nieminghua/Desktop/pycode/pythonProject/Apytest/data.csv'))
     def test_ddt(a, b, c):assert int(a) + int(b) == int(c)
     

5. 夹具-fixture

   我把fixture 理解成用例执行的前置操作和后置操作(钩子函数)
   比如,在对 web 网站进行测试时,前置必要条件需要先打开浏览器.测试完毕后关闭浏览器.

   • fixture 可以被 fixture 调用
   • 在fixture中的yield关键字可以返回值,只能返回 1 个值
   • 在使用 fixture 中参数scope可以控制夹具的作用范围
     1. function 默认值, 每个用例都会执行一遍
     2. class 每个类执行一遍
     3. module 每个模块执行一遍
     4. session 每个会话执行一遍
     5. package 每个包执行一遍

   如果不指定作用域,则每个用例执行都会单独去执行 fixture
   @pytest.fixture()
   def func2():# 前置操作print(datetime.now(), "func2用例开始执行")yield [1, 2, 3]# 后置操作print(datetime.now(), "func2用例执行结束")@pytest.mark.usefixtures("func",'func2')
   def test_1():print('test1')@pytest.mark.usefixtures("func",'func2')
   def test_2():print('test2')>>>
   Apytest/test_fixture.py::test_1 2025-06-05 18:32:58.075634 func1用例开始执行
   2025-06-05 18:32:58.077104 func2用例开始执行
   test1
   PASSED2025-06-05 18:32:58.078129 func2用例执行结束
   2025-06-05 18:32:58.078950 func1用例执行结束Apytest/test_fixture.py::test_2 2025-06-05 18:32:58.080741 func1用例开始执行
   2025-06-05 18:32:58.080920 func2用例开始执行
   test2
   PASSED2025-06-05 18:32:58.081668 func2用例执行结束
   2025-06-05 18:32:58.082254 func1用例执行结束
   

   指定作用域给 fixture 添加scope=“session”

   @pytest.fixture(scope='session')
   def func():# 前置操作print(datetime.now(), "func1用例开始执行")yield# 后置操作print(datetime.now(), "func1用例执行结束")@pytest.fixture(scope='session')
   def func2():# 前置操作print(datetime.now(), "func2用例开始执行")yield [1, 2, 3]# 后置操作print(datetime.now(), "func2用例执行结束")@pytest.mark.usefixtures("func",'func2')
   def test_1():print('test1')@pytest.mark.usefixtures("func",'func2')
   def test_2():print('test2')>>>
   Apytest/test_fixture.py::test_1 2025-06-06 14:54:55.729863 func1用例开始执行
   2025-06-06 14:54:55.730163 func2用例开始执行
   test1
   PASSED
   Apytest/test_fixture.py::test_2 test2
   PASSED2025-06-06 14:54:55.733253 func2用例执行结束
   2025-06-06 14:54:55.733882 func1用例执行结束

   对于一些更通用的 fixture 可以定义在conftest.py 文件中.给 fixture添加 autouse=True 参数,和 scope 指定作用域,这样所有的用例在作用域范围内都会自动关联到 fixture.(fixture同样可以嵌套使用)

   conftest.py
   在 func2 方法中调用了 func 所以即使 func 并没有 autouse=True,一样会被调用.
   @pytest.fixture(scope='session')
   def func():# 前置操作print(datetime.now(), "conftest_func1用例开始执行")yield# 后置操作print(datetime.now(), "conftest_func1用例执行结束")@pytest.fixture(autouse=True, scope='session')
   def func2(func):# 前置操作print(datetime.now(), "conftest_func2用例开始执行")yield [1, 2, 3]# 后置操作print(datetime.now(), "conftest_func2用例执行结束")>>>>
   Apytest/test_fixture.py::test_1 2025-06-06 16:29:25.996684 conftest_func1用例开始执行
   2025-06-06 16:29:25.997059 conftest_func2用例开始执行
   test1
   PASSED
   Apytest/test_fixture.py::test_2 test2
   PASSED2025-06-06 16:29:26.000212 conftest_func2用例执行结束
   2025-06-06 16:29:26.001231 conftest_func1用例执行结束

6. 测试报告

   这里用到第三方插件allure

   	pip install allure-pytest
   

   allure下载地址官网

   添加启动命令

   pytest.ini
   [pytest]
   addopts =  --alluredir=allure-results --clean-alluredir
   

   加上这条命令后执行完会生成一个allure-results文件,里边放着 json 格式的测试日志.
   
   之后在执行allure generate allure-results -o allure-report --clean命令. -o 参数为报告输出路径
   之后打开目录里的 index.html 就可以看到报告
   

   可以在 main.py 文件中通过 os 模块来执行生成的动作,这样每次执行完用例会自动生成报告

   import pytest
   import ospytest.main()os.system("allure generate allure-results -o allure-report --clean")
   

   用例分类
   在报告中按功能给用例分类.

   • @allure.epic 项目名称
   • @allure.feature 模块名称
   • @allure.story 业务场景名称
   • @allure.title 标题
   • @allure.description 描述
   • @allure.setup 环境信息
   • @allure.testcase 测试用例链接
   • @allure.issue 缺陷链接
   • @allure.link 链接

   @allure.epic("hil测试")
   @allure.feature("故障注入")
   @allure.story("CVD")
   @allure.title("HTO")
   @allure.description("描述 11")
   @allure.testcase("https://www.baidu.com", "用例链接")
   @allure.issue("https://www.sogou.com", "缺陷链接", )
   @allure.link("链接")
   @pytest.mark.ut
   def test_01():assert 1 == [e-mail]("hil测试")
   @allure.feature("故障注入")
   @allure.story("CVD")
   @allure.title("低压")
   @allure.description("描述 11")
   @allure.testcase("www.baidu.com", "用例链接")
   @allure.issue("www.sogou.com", "缺陷链接", )
   @pytest.mark.ut
   def test_02():assert 1 == [e-mail]("hil测试")
   @allure.feature("故障注入")
   @allure.story("HTO")
   @allure.description("描述 11")
   @allure.testcase("www.baidu.com", "用例链接")
   @allure.issue("www.sogou.com", "缺陷链接", )
   @pytest.mark.ut
   def test_03():assert 1 == 1