十、测试的参数化

参数化的行为表现在不同的层级上：

• 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'；