---

一、pytest的命名规则

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

二、界面化配置

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

三、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

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}')

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')

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}')

七、标记测试用例

场景：只执行符合要求的某一部分用例可以把一个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

测试结果

执行用例会出现警告，解决方法：在pytest.ini中将标签注册

再次执行，没有警告了

八、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

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

案例：做判断

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、运行多个测试包

目录结构

运行测试用例：

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

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"

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

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

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"

---