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 == 1def 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 =name1name2name3

2. 打上标记

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

class Test_A:@pytest.mark.name1def test_1(self):print('用例1')@pytest.mark.name1def test_2(self):print('用例2')@[e-mail]2def test_3(self):print('用例3')@pytest.mark.name2def 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 == [e-mail](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 + [e-mail](  # 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作用域下，执行夹具前置代码')yieldprint('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)

在结果中可以看到function作用域的夹具对每个用例都执行了一次

class作用域的夹具对类在执行用例的前后执行了一次，并且夹具的返回值对类中的用例共享