Fixture中文称为固件或夹具,用于测试用例执行前的数据准备、环境搭建和测试用例执行后的数据销毁、环境恢复等工作。Fixture很灵活,不仅允许代码在运行时只在某些特定测试用例前执行,而且还可以在测试用例之间传递参数和数据。
一、固件的使用
如果要将一个方法作为Fixture使用,只需要在这个方法前添加装饰器@pytest.fixture()即可,先看一个简单的例子。
import pytest
list_two = [(1, 2, 3), (2, 3, 5)]
def add_number(a, b):
return a+b
@pytest.fixture() #fixture装饰器
def fixture_function():
print('\nthis a fixture!')
@pytest.mark.parametrize('num1, num2, sum', list_two)
#测试方法在参数中调用fixture函数,那么在每次运行该测试用例时,就会执行一次fixture函数
def test_add1(num1, num2, sum, fixture_function):
assert add_number(num1, num2) == sum
运行结果如下:可以看到测试方法在运行前都执行了fixture函数。
二、固件的参数
pytest.fixture()方法的参数在源码中定义为fixture(scope="function", params=None, autouse=False, ids=None, name=None),参数说明如下:
- scope:为fixture的作用域,有4组可选参数,分别为function、class、module、package/session,默认为function。
- params:一个可选的参数列表,会使多个参数调用fixture函数和所有测试使用它。
- autouse:如果为Ture,则所有的测试方法都会执行固件方法,如果为False(默认值),则只对添加了固件方法的测试方法执行固件方法。
- ids:每个参数都与列表中的字符串id对应,因此是测试id的一部分。如果没有提供id将会从参数中自动生成。
- name:fixture的名称,默认为装饰器的名称。
2.1 scope作用域
作用域的4个选项分别为:
- function:函数级别,默认值,每个测试方法执行前都会执行一次
- class:类级别,每个测试类执行前执行一次
- module:模块级别,每个模块执行前执行一次,也就是每个.py文件执行前都会执行一次
- session:会话级别,一次测试只执行一次
看一个例子:
import pytest
@pytest.fixture(scope='session') #session作用域
def session_fix():
print('\nthis is a session fixture!')
@pytest.fixture(scope='module') #module作用域
def module_fix():
print('\nthis is a module fixture!')
@pytest.fixture(scope='class') #class作用域
def class_fix():
print('\nthis is a class fixture!')
@pytest.fixture(scope='function') #function作用域
def function_fix():
print('\nthis is a function fixture!')
def test_api(session_fix, module_fix, class_fix, function_fix):
print('\nthis is a test example!')
if __name__ == '__main__':
pytest.main(['-v', '--setup-show']) #使用--setup-show查看具体的stup和teardown顺序
运行结果如下:运行结果中展示了作用域的标识符号,分别为S M C F
- S:表示作用范围最大的session会话级
- M:表示module模块级
- C:表示class类级
- F:表示function函数级
而且如果一个测试类中所有的方法都要调用fixture,每个用例传参会比较麻烦,这个时候可以选择在class类上使用装饰器@pytest.mark.usefixture()实现,示例如下:
import pytest
from pytest_example.test_fixture import function_fix
@pytest.mark.usefixtures('function_fix')
class TestFixture():
def test_api1(self):
print('test example 1!')
def test_api2(self):
print('test example 2!')
if __name__ == '__main__':
pytest.main(['-v', '--setup-show'])
运行结果如下:可以看到类中的两个方法在执行时都调用了函数级的fixture。
fixture的ids和params参数下节再说!