pytest框架的基本使用

1. 测试框架的作用

测试框架不关系用例的内容

它关心的是：用例编排和结果收集

2. pytest框架的特点

1. 适用于python语言

2. 用法符合python风格

3. 有丰富的生态

3. 安装pytest框架

1. 新建一个项目

2. 在项目终端窗口输入如下命令，用于安装pytest，其中-U是表示更新到最新的版本（如果你已经有了pytest，但是不是最新版，也会进行下载最新版）

pip install pytest -U

3. 下载完成后可以输入如下命令查看pytest是否安装成功

pip list

如果输出的列表中存在pytest，并且版本为最新，则安装成功。

4. pytest的用例发现规则

1. 从 以test_开头和以_test为结尾的文件 中收集用例

2. 从 以Test_开头的类 中收集用例（类不能包含__init__()方法）

3. 以test_开头的函数和方法 会作为测试用例

注意：作为测试用例的函数不能含有参数和返回值

5. 编写和执行测试用例

编写测试用例

编写测试用例就是通过代码实现用例的逻辑，可以通过assert来确定用例是否执行成功

class Test_A:
    def test_1(self):
        assert 1 == 1

    def test_2(self):
        assert 2 == 2

执行测试用例

方法一：通过执行pytest自带的main方法，该方法会执行项目中的所有用例

方法二：通过在终端输入命令行的方式，如下

pytest

执行不符合规则的文件中的用例

通过在终端中执行如下命令，符合的文件也可以通过此方法执行：

pytest 文件路径

6. 用例执行结果

结果缩写：

.	测试通过
F	测试失败
E	出现错误
s	跳过执行
x	预期内失败
X	预期外通过

结果的缩写是按照用例的执行顺序依次往后输出的

7. 配置

约定大于配置对于成熟的工具来说（如：pytest），默认配置是一种比较好的配置，如非必要，请勿修改

添加配置

1. 新建一个.ini结尾的文件

2. 加上如下内容

[pytest]

3. 查看所有的配置项：在终端中输入如下内容

pytest -h

4. 选择需要添加的配置项，将其按照对应的格式填写到.ini文件中

常用的命令行参数

额外的命令行选项 - addopts

v	增加详细程度
q	减少详细程度
s	不进行内容捕捉，让所有的输出内容可以正常展示（成功的用例不会将里面的执行过程打印出来，可以通过-s来设置）
x	快速退出（只要发现失败用例就立即停止运行）

一般情况下可以使用-vs，打印详细执行结果+用例输出内容打印

[pytest]
addopts = -vs

用户自定义标记 - mark

1. 注册标记

在.ini文件中添加mark，并添加标记

# 用户自定义标记
markers =
    name1
    name2
    name3

2. 打上标记

在函数上面添加标记，应该函数可以添加多个标记

class Test_A:
    @pytest.mark.name1
    def test_1(self):
        print('用例1')

    @pytest.mark.name1
    def test_2(self):
        print('用例2')

    @pytest.mark.name1
    @pytest.mark.name2
    def test_3(self):
        print('用例3')

    @pytest.mark.name2
    def test_4(self):
        print('用例4')

3. 筛选标记

通过筛选标记，筛选出需要执行的用例

在终端输入如下命令（可以结合前面的筛选文件）：

pytest -m 标记名

也支持逻辑运算

pytest -m "标记1 and 标记2" # 执行包含标记1和标记2的用例
pytest -m "标记1 or 标记2"  # 执行包含标记1或标记2的用例

框架内置标记

特点：

1. 不需要注册，可以直接使用

2. 标记不仅仅用于筛选，还有特殊的效果

常用内置标记：

skip	无条件跳过用例
skipif	有条件跳过用例
sfail	预期用例失败
parametrize	参数化测试

class Test_A:
    def test_1(self):
        print('用例1')

    @pytest.mark.skip()
    def test_2(self):
        print('用例2')

    @pytest.mark.xfail(reason='预期失败')
    def test_3(self):
        print('用例3')
        assert 1 == 2

    @pytest.mark.skipif(1 == 2, reason='当1 == 2时用例跳过')
    def test_4(self):
        print('用例4')

参数化执行带参数的用例

1. 在用例中添加参数

2. 再用力中使用参数

3. 给用例添加parametrize注解

3.1 添加第一个参数：参数名称（与用例参数名相同且对应）

3.2 添加第二个参数：用例传入参数的数据（有几组数据就意味着这个用例要执行几次，只是参数不同）

3.3 添加第三个参数（非必填）：给每组参数添加用例名称

如果名称带有中文可以在.ini配置文件中添加如下内容，否则会乱码

# 用例的id可以包含各类字符，并且自负风险
disable_test_id_escaping_and_forfeit_all_rights_to_community_support = true

def add(a, b):
    return a + b

@pytest.mark.parametrize(  # 3. 添加parametreze标记
    'a, b',  # 3.1 第一个参数为参数名称（要与用例参数对应）
    [
        (1, 1),  # 3.2 第二个参数添加用例的参数数据（有几组参数就相当于是几个用例，只是参数不一样）
        (2, 2),
        (3, 3)
    ],
    ids=[
        "1 + 1",  # 3.3 给每组参数添加用例名称（非必填，且使用中文需要添加相应的配置）
        "2 + 2",
        "3 加 3"
    ]
)
def test_add(a, b): # 1. 给用例添加参数
    print(f'执行add的结果为: {add(a, b)}') # 2. 再用例中使用参数

8. 夹具fixture

创建和使用夹具

夹具就是一个带有fixture标记的函数，然后将夹具作为参数传入用例的形参中即可。

如果夹具中正常去写，其所有内容会在用例执行之前执行

@pytest.fixture()
def fixture1(): # 夹具
    print('执行前置代码，用例执行前使用') # 夹具的内容



def test_1(fixture1): # 在用例中使用夹具
    print('执行用例内容')

如果想在前后都执行部分夹具的代码，也需要加上yield关键字

@pytest.fixture()
def fixture1():
    print('执行前置代码，用例执行前使用')
    
    # yield之前的代码会在用例执行前执行
    yield  
    # yield之后的代码会在用例执行后执行
    
    print('执行后置代码，用例执行后使用')



def test_1(fixture1):
    print('执行用例内容')

夹具的返回值

夹具可以带有返回值，并且其返回值可以在用例中使用

@pytest.fixture()
def fixture1():
    print('执行前置代码，用例执行前使用')

    # yield之前的代码会在用例执行前执行
    yield 5
    # yield之后的代码会在用例执行后执行

    print('执行后置代码，用例执行后使用')



def test_1(fixture1):
    print(f'输出夹具返回值：{fixture1}')

夹具的作用域

function	每个用例直接不共享fixture的返回值（默认）
class	每个类中的用例共享fixture的返回值
module	每个文件中的用例共享fixture的返回值
package	每个目录中的用例共享fixture的返回值
session	全部用例共享fixture的返回值

下面以class和function作用域举例

注意：一个用例可以添加多个夹具，使用逗号分隔

@pytest.fixture(scope='class')
def fixture2():
    print('class作用域下，执行夹具前置代码')

    yield []  # 返回一个空列表，让用例之间传递数据

    print('class作用域下，执行夹具后置代码')


@pytest.fixture()
def fixture3():
    print('function作用域下，执行夹具前置代码')

    yield

    print('function作用域下，执行夹具后置代码')


# Test_A中的用例共享同一个 fixture2 夹具的返回值
class Test_A:
    def test_1(self, fixture2, fixture3):
        fixture2.append('A-test_1')
        print(fixture2)

    def test_2(self, fixture2, fixture3):
        fixture2.append('A-test_2')
        print(fixture2)

    def test_3(self, fixture2, fixture3):
        fixture2.append('A-test_3')
        print(fixture2)


# Test_B中的用例共享同一个 fixture2 夹具的返回值
class Test_B:
    def test_1(self, fixture2, fixture3):  # 一个用例可以添加多个夹具，用 逗号 分隔
        fixture2.append('B-test_1')
        print(fixture2)

    def test_2(self, fixture2, fixture3):
        fixture2.append('B-test_2')
        print(fixture2)

    def test_3(self, fixture2, fixture3):
        fixture2.append('B-test_3')
        print(fixture2)