十、测试的参数化
参数化的行为表现在不同的层级上:
-
fixture
的参数化; -
测试用例的参数化:使用
@pytest.mark.parametrize
可以在测试用例、测试类甚至测试模块中标记多个参数或fixture
的组合;
另外,也可以通过pytest_generate_tests
这个钩子方法自定义参数化的方案;
1、@pytest.mark.parametrize标记
@pytest.mark.parametrize
的根本作用是在收集测试用例的过程中,通过对指定参数的赋值来新增被标记对象的调用(执行);
原型:
argnames
:一个用逗号分隔的字符串,或者一个列表/元组,表明指定的参数名;
使用限制
(1)只能是被标记对象入参的子集:
(2)不能是被标记对象入参中,定义了默认值的参数:
(3)会覆盖同名的fixture:
-
argvalues
:一个可迭代对象,表明对argnames
参数的赋值,具体有以下几种情况:
(1)如果argnames
包含多个参数,那么argvalues
的迭代返回元素必须是可度量的(即支持len()
方法),并且长度和argnames
声明参数的个数相等,所以它可以是元组/列表/集合等,表明所有入参的实参:
(2)如果argnames
只包含一个参数,那么argvalues
的迭代返回元素可以是具体的值:
(3)argvalues
是一个可迭代对象,那么可以实现更复杂的场景;例如:从excel
文件中读取实参:
(4)使用pytest.param
为argvalues
参数赋值:
-
indirect
:argnames
的子集或者一个布尔值;将指定参数的实参通过request.param
重定向到和参数同名的fixture
中,以此满足更复杂的场景;
-
ids
:一个可执行对象,用于生成测试ID
,或者一个列表/元组,指明所有新增用例的测试ID
;
(1)如果使用列表/元组直接指明测试ID
,那么它的长度要等于argvalues
的长度:
(2)如果指定了相同的测试ID
,pytest
会在后面自动添加索引:
(3)如果在指定的测试ID
中使用了非ASCII
的值,默认显示的是字节序列:
在pytest.ini使能
(4)如果通过一个可执行对象生成测试ID
:
(5)通过pytest.param
指定了id
属性,那么将会覆盖ids
中对应的测试ID
- scope:声明
argnames
中参数的作用域,并通过对应的argvalues
实例划分测试用例,进而影响到测试用例的收集顺序;
(1)可以显式的指明scope参数;例如,将参数作用域声明为模块级别:
(2)scope
未指定的情况下(或者scope=None
),当indirect
等于True
或者包含所有的argnames
参数时,作用域为所有fixture
作用域的最小范围;否则,其永远为function
;
1.1 empty_parameter_set_mark
选项
默认情况下,如果@pytest.mark.parametrize
的argnames
中的参数没有接收到任何的实参的话,用例的结果将会被置为SKIPPED
;
可以通过在pytest.ini
中设置empty_parameter_set_mark
选项来改变这种行为,其可能的值为:
skip
:默认值xfail
:跳过执行直接将用例标记为XFAIL
,等价于xfail(run=False)
fail_at_collect
:上报一个CollectError
异常;
1.2 多个@pytest.mark.parametrize
标记
如果一个用例标记了多个@pytest.mark.parametrize
标记,如下所示:
1.3 标记测试模块
通过对pytestmark
赋值,参数化一个测试模块:
2、pytest_generate_tests 钩子方法
pytest_generate_tests
方法在测试用例的收集过程中被调用,它接收一个metafunc
对象,可以通过其访问测试请求的上下文,更重要的是,可以使用metafunc.parametrize
方法自定义参数化的行为;
例子:
检查给定的stringinput
是否只由字母组成,但是并没有为其打上parametrize
标记,所以stringinput
被认为是一个fixture
:
不加--stringinput
选项,相当于parametrize
的argnames
中的参数没有接收到任何的实参,那么测试用例的结果将会置为SKIPPED。
注意:
不管是metafunc.parametrize
方法还是@pytest.mark.parametrize
标记,它们的参数(argnames
)不能是重复的,否则会产生一个错误:ValueError: duplicate 'stringinput'
;