pytest总结

刺骨的言语ヽ痛彻心扉 2024-03-26 10:31 63阅读 0赞

![在这里插入图片描述][f8bf5a6bbca54e4ea07d8e0defd0149d.webp_pic_center]

--------------------

#### 这里写目录标题 ####

*  一、pytest的命名规则
 *  二、界面化配置
 *   *  符合命名规则的方法前面会有运行标记
 *  三、pytest的用例结构
 *   *  三部分组成
 *  四、pytest的用例断言
 *   *  断言写法：
 *  五、pytest测试框架结构
 *  六、pytest参数化用例
 *   *  1、pytest参数化实现方式
     *  2、单参数：每一条测试数据都会生成一条测试用例
     *  3、多参数：
     *   *  ids:为测试用例起名字
         *  ids有中文的情况
     *  4、笛卡儿积
 *  七、标记测试用例
 *  八、pytest设置跳过、预期失败用例
 *   *  1、skip的使用场景：
     *  2、skipif的使用场景：
     *  3、xfail的使用场景：
 *  九、pytest运行测试用例
 *   *  1、运行多个测试包
     *  2、运行多个测试模块
     *  3、运行多个测试类
     *  4、运行多个测试方法
     *  5、运行单个测试方法
     *  6、运行结果分析
 *  十、pytest命令行常用参数
 *   *  1、-x：
     *  2、--maxfail=2：用例允许失败1条，第2条失败时，stop
     *  3、-k：执行测试用例中，包含“tup”的用例（采用双引号）
     *  4、-k：执行测试用例中，除了“tup”之外的用例（采用双引号）
     *  5、--collect-only：只收集不运行
 *  十一、python执行pytest
 *   *  1、使用main函数
     *   *  a、pytest.main() ：执行当前目录下符合规则的所有测试用例
         *  b、运行某一条用例
         *  c、运行某个标签
     *  2、使用python -m pytest调用pytest
     *  十二、pytest异常处理
     *  try...except
     *  pytest.raises()
     *   *  1、捕获异常：意料之内的异常，不会报错
         *  2、捕获异常：意料之外的异常，会报错
         *  3、捕获多个异常
         *  4、捕获异常后获取异常值和异常类型

## 一、pytest的命名规则 ##

**文件： `test开头或者_test结尾`  
类名 ： `Test开头`  
方法名 ：`test_开头`  
特别注意：`测试类中不能定义__init__()方法`**

## 二、界面化配置 ##

![在这里插入图片描述][6da3702f37294fbabbdfdbf53bf08ef4.png]

### 符合命名规则的方法前面会有运行标记 ###

![在这里插入图片描述][49b836ebc33d4ce38c16bbf79462ec7e.png]

## 三、pytest的用例结构 ##

### 三部分组成 ###

> **用例名称  
> 用例步骤  
> 用例断言**

class TestXXX:
        def setup(self):
            #资源准备
            pass
    
        def teardown(self):
            #资源销毁
            pass
    
        def test_xxx(self):
            #测试步骤1
            #测试步骤2
            #断言 实际结果 对比  期望结果
            logging.info('这是xxx测试用例')
            assert 1==1

## 四、pytest的用例断言 ##

断言(assert)，是一种在程序中的一阶逻辑(如:一个结果为真或假的逻辑判断式)，目的为了表示与验证软件开发者预期的结果。当程序执行到断言的位置时，对应的断言应该为真。若断言不为真时，程序会中止执行，并给出错误信息。

### 断言写法： ###

> assert 表达式  
> assert 表达式，描述：当断言成功时，描述语句不会执行；当断言失败时，描述语句会执行。

class TestDemo:
        def test_c(self):
            assert 1==1
    
        def test_c1(self):
            assert 'abc1' in 'abcdef' , 'abc不在abcdef中'

## 五、pytest测试框架结构 ##

> setup\_module/teardown\_module：全局模块级，只运行一次  
> setup\_class/teardown\_class：类级，只在类中前后运行一次  
> setup\_function/teardown\_function：函数级别：在类外  
> setup\_method/teardown\_method：方法级别，在类中。类中每个方法执行前后  
> setup/teardown：在类中，在每个测试方法前后执行

## 六、pytest参数化用例 ##

通过参数的方式传递数据，从而实现数据和脚本的分离  
并且可以实现用例的重复生成和执行

### 1、pytest参数化实现方式 ###

**装饰器：pytest.mark.parametrize**

### 2、单参数：每一条测试数据都会生成一条测试用例 ###

#单参数
    import pytest
    search_list=['appium','selenium','pytest']
    
    # 两组测试数据：两条测试用例
    @pytest.mark.parametrize('search_key',['java','appium'])
    def test_search_params(search_key):
        assert search_key in search_list

![在这里插入图片描述][1cef172475944c9899f5e4d58dbe03a8.png]

### 3、多参数： ###

#### ids:为测试用例起名字 ####

> **注意：ids 列表参数的个数要与参数值的个数一致**

import pytest
    
    #测试数据有2个参数
    @pytest.mark.parametrize("username,password",
                             [["kobe",666],["kd",111],[" ",888]],
                             ids=['success','fail','username is None'])
    def test_login1(username,password):
        print(f'登录的用户名:{
          username},密码：{
          password}')

![在这里插入图片描述][438002b6c2c3410db5f9336f0e7c596e.png]

#### ids有中文的情况 ####

import pytest
    
    @pytest.mark.parametrize("username,password",
                             [["kobe",666],["kd",111],[" ",888]],
                             ids=['成功','失败','用户名为空'])
    def test_login(username,password):
        print(f'登录的用户名:{
          username},密码：{
          password}')

**需要在conftest.py中定义pytest\_collection\_modifyitems方法**

def pytest_collection_modifyitems(items):
        """
        测试用例收集完成时，将收集到的用例名name和用例标识nodeid的中文信息显示在控制台上
        """
        for i in items:
            i.name=i.name.encode('utf-8').decode('unicode-escape')
            i._nodeid=i.nodeid.encode('utf-8').decode('unicode-escape')

![在这里插入图片描述][1cec178341f044bb8f4bb7d84478f1fb.png]

### 4、笛卡儿积 ###

两组数据a=\[1,2,3\],b=\[a,b,c\]  
对应的有几组组合形式？

> (1,a)(1,b)(1,c)  
> (2,a)(2,b)(2,c)  
> (3,a)(3,b)(3,c)

import pytest
    
    @pytest.mark.parametrize('a',[1,2,3])
    @pytest.mark.parametrize('b',['aa','bb','cc'])
    def test_params1(a,b):
        print(f'笛卡儿积形式参数化中,a={
          a},b={
          b}')

![在这里插入图片描述][2e5b1fde498a43ada24a07d7715e51f4.png]

## 七、标记测试用例 ##

场景：只执行符合要求的某一部分用例可以把一个web项目划分为多个模块，然后指定模块名执行  
解决：在测试用例方法上加@pytest.mark.标签名  
执行：-m 执行自定义标记的相关用例

import pytest
    #测试数据：整型
    @pytest.mark.int
    def test_int():
        assert isinstance(2,int)
    
    #测试数据：字符串
    @pytest.mark.str
    def test_str():
        assert isinstance('str',str)
    
    #测试数据：浮点型
    @pytest.mark.float
    def test_float():
        assert isinstance('2.7',float)

执行测试用例

D:\pytest_project\test_params>pytest test_mark.py -vs -m int

测试结果

![在这里插入图片描述][7315ac97f83c4fdd8c0441ce7c1a04e1.png]  
执行用例会出现警告，解决方法：在pytest.ini中将标签注册

![在这里插入图片描述][6899a7a67b254e92925f97376c2ccd9c.png]

再次执行，没有警告了  
![在这里插入图片描述][9aebbedbdf8d477c87c658e18904bbf7.png]

## 八、pytest设置跳过、预期失败用例 ##

> 这是pytest的内置标签，可以处理一些特殊的测试用例  
> skip：始终跳过该测试用例  
> skipif：遇到特定情况跳过该测试用例  
> xfail：遇到特定情况，产生一个”预期失败“输出

### 1、skip的使用场景： ###

1、调试时不想运行这个测试用例  
2、标记无法在某些平台运行的测试用例  
3、在某些版本中执行，其他版本中跳过

import pytest
    
    @pytest.mark.skip
    def test_aaa():
        print("代码未开发完")
        assert True
    
    @pytest.mark.skip(reason="代码没有实现")
    def test_bbb():
        assert False

执行测试用例：测试用例跳过图标默认置灰

![在这里插入图片描述][a86bc50872bb4809968debbdbf6ad171.png]

案例：做判断

def check_login():
        return False
    
    def test_function():
        print("start")
        #如果未登录，则跳过后续步骤
        if not check_login():
            pytest.skip("unsupported configuration")
        print("end")

### 2、skipif的使用场景： ###

import sys
    print(sys.platform)
    
    @pytest.mark.skipif(sys.platform == 'darwin', reason="does not run on mac")
    def test_case1():
        assert True
    @pytest.mark.skipif(sys.platform == 'win', reason="does not run on windows")
    def test_case2():
        assert True
    @pytest.mark.skipif(sys.version_info < (3, 6), reason="requires python3.6 or higher")
    def test_case3():
        assert True

### 3、xfail的使用场景： ###

import pytest
    
    @pytest.mark.xfail
    def test_aaa():
        print("test_xfail1 方法执行")
        assert 2 == 2
    
    xfail =pytest.mark.xfail
    
    @xfail(reason="bug")
    def test_hello4():
        assert 0

## 九、pytest运行测试用例 ##

### 1、运行多个测试包 ###

目录结构  
![在这里插入图片描述][273220f5ee3f42008ba00d2fccc64433.png]

运行测试用例：

D:\pytest_project>pytest demo_plugin

### 2、运行多个测试模块 ###

运行测试用例：

D:\pytest_project>pytest demo_plugin/demo1

### 3、运行多个测试类 ###

运行测试用例：

D:\pytest_project>pytest demo_plugin/demo2/test_demo2.py

### 4、运行多个测试方法 ###

运行测试用例：

D:\pytest_project>pytest demo_plugin/demo2/test_demo2.py::TestB

### 5、运行单个测试方法 ###

运行测试用例：

D:\pytest_project>pytest demo_plugin/demo2/test_demo2.py::TestB::test_d

### 6、运行结果分析 ###

常用的：pass（通过）、fail（失败）、error（代码错误）  
特殊的：warning（警告，例如pytest.ini中没有注册标签名）、deselect（跳过，加标签skip、skipif）

## 十、pytest命令行常用参数 ##

> \-m：执行加标签的测试用例  
> \-k：执行测试用例中包含某个关键字的测试用例（windows中关键字使用双引号）  
> \-x：用例一旦运行失败，立刻停止运行（冒烟测试）  
> – maxfail=num：测试用例失败达到num个时，立刻停止运行  
> \-v：打印详细信息  
> \-s：打印输出日志  
> \-n：并发执行测试用例  
> \-lf：只执行上次用例失败的测试用例  
> \-ff：先执行上次用例失败的测试用例，再执行其他的测试用例  
> –collect-only：测试平台，pytest自动导入功能

#!/usr/bin/env python
    # -*- coding: utf-8 -*-
    # @Time    : 2023/2/15 20:10
    # @Author  : 杜兰特
    # @File    : test_mark.py
    import pytest
    #测试数据：整型
    @pytest.mark.int
    def test_int():
        assert isinstance(2,int)
    
    #测试数据：字符串
    @pytest.mark.str
    def test_str():
        assert isinstance('str',str)
    
    #测试数据：浮点型
    @pytest.mark.float
    def test_float():
        assert isinstance('2.7',float)
    
    #测试数据：列表
    @pytest.mark.list
    def test_list():
        assert isinstance('[1,2,3]',list)
    
    #测试数据：元组
    @pytest.mark.tuple
    def test_tuple():
        assert isinstance('(1,)',tuple)

### 1、-x： ###

D:\pytest_project\test_params>pytest test_mark.py -x

![在这里插入图片描述][8166095742e841e2acb8573dd6670d09.png]

### 2、–maxfail=2：用例允许失败1条，第2条失败时，stop ###

D:\pytest_project\test_params>pytest test_mark.py --maxfail=2

### 3、-k：执行测试用例中，包含“tup”的用例（采用双引号） ###

D:\pytest_project\test_params>pytest test_mark.py -k "tup"

![在这里插入图片描述][9426b69a186245b1beb2bf7ad81a9c9a.png]

### 4、-k：执行测试用例中，除了“tup”之外的用例（采用双引号） ###

D:\pytest_project\test_params>pytest test_mark.py -k "not tup"

![在这里插入图片描述][f1d7c2ed54094d79a2f08abb06114b13.png]

### 5、–collect-only：只收集不运行 ###

## 十一、python执行pytest ##

### 1、使用main函数 ###

#### a、pytest.main() ：执行当前目录下符合规则的所有测试用例 ####

**test\_first.py文件**

import pytest
    
    def test_a():
        assert 1==1
    
    def test_b():
        assert 1==2
    
    class TestDemo:
        def test_c(self):
            assert 1==1
    
        def test_c1(self):
            assert 'abc1' in 'abcdef' , 'abc不在abcdef中'
    
    class TestXXX:
        def setup(self):
            #资源准备
            pass
    
        def teardown(self):
            #资源销毁
            pass
    
        def test_xxx(self):
            #测试步骤1
            #测试步骤2
            #断言 实际结果 对比  期望结果
            assert 1==1
    
    
    if __name__ == '__main__':
        pass
        #todo 1、运行当前目录下所有的用例
        pytest.main()   #相当于pytest.main(['./'])

执行测试用例

D:\pytest_project>python test_first.py

#### b、运行某一条用例 ####

import pytest
    
    if __name__ == '__main__':
        #todo 2、运行test_parameters.py::test_login中的某一条用例
        pytest.main(['test_params/test_parameters.py::test_login','-vs'])

执行测试用例

D:\pytest_project>python test_first.py

#### c、运行某个标签 ####

import pytest
    
    if __name__ == '__main__':
        #todo 3、运行某个标签
        pytest.main(['test_params/test_mark.py','-vs','-m','int'])

执行测试用例

D:\pytest_project>python test_first.py

### 2、使用python -m pytest调用pytest ###

D:\pytest_project>python -m pytest test_first.py

### 十二、pytest异常处理 ###

### try…except ###

### pytest.raises() ###

> 可以捕获特定的异常  
> 获取捕获的异常的细节（异常类型、异常信息）  
> 发生异常，后面的代码将不会被执行

#### 1、捕获异常：意料之内的异常，不会报错 ####

import pytest
    def test_raise():
        with pytest.raises(expected_exception=ValueError, match='must be 0 or None'):
            raise ValueError("value must be 0 or None")

#### 2、捕获异常：意料之外的异常，会报错 ####

def test_raise1():
        with pytest.raises(expected_exception=ValueError, match='must be 0 or None'):
            raise ZeroDivisionError("除数为0的")

#### 3、捕获多个异常 ####

def test_raise2():
        with pytest.raises(expected_exception=(ValueError,ZeroDivisionError), match='must be 0 or None'):
            raise ZeroDivisionError("value must be 0 or None")

#### 4、捕获异常后获取异常值和异常类型 ####

def test_raise2():
        with pytest.raises(ValueError) as exc_info:
            raise ValueError("value must be 42")
        assert exc_info.type is ValueError
        assert exc_info.value.args[0] == "value must be 42"

--------------------

![在这里插入图片描述][58c8cb9e48224e68a2066f9a2b7bf745.jpeg_pic_center]

[f8bf5a6bbca54e4ea07d8e0defd0149d.webp_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/9a66166e595b480da613b7b0e06e58ad.png
[6da3702f37294fbabbdfdbf53bf08ef4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/30e18c339b43431cb9a5bf344a8d8f85.png
[49b836ebc33d4ce38c16bbf79462ec7e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/9864f097e1ec4bb8b564694efa4f47d1.png
[1cef172475944c9899f5e4d58dbe03a8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/8adc53b215fd44e1acd05a939c853072.png
[438002b6c2c3410db5f9336f0e7c596e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/b2e85ccba8634a15931955983e90c2f3.png
[1cec178341f044bb8f4bb7d84478f1fb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/a06d204f9c3f488f82f678ea45ea00f2.png
[2e5b1fde498a43ada24a07d7715e51f4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/0c4bfd997a154137a36935393ee2004b.png
[7315ac97f83c4fdd8c0441ce7c1a04e1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/f0940b05694d4c01a9e2c5a72e0fe053.png
[6899a7a67b254e92925f97376c2ccd9c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/d63ca36a8ffd4146997d52e3ca9df125.png
[9aebbedbdf8d477c87c658e18904bbf7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/30653efc67a64d01ba419a1c9f724b9c.png
[a86bc50872bb4809968debbdbf6ad171.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/608b07279450400899beef3977a6c580.png
[273220f5ee3f42008ba00d2fccc64433.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/9177125826ee4ca7b19501e5a096e49d.png
[8166095742e841e2acb8573dd6670d09.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/d516777f12cf4d3597cfd763fac097f5.png
[9426b69a186245b1beb2bf7ad81a9c9a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/81cf31913e744c3b813de3e4189822b7.png
[f1d7c2ed54094d79a2f08abb06114b13.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/29501213bde84e3daaf7fa32700eae7c.png
[58c8cb9e48224e68a2066f9a2b7bf745.jpeg_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/61042d955d4e4932a553cb92a1f7a2a4.png