一、pytest实现测试用例参数化(@pytest.mark.parametrize)
@pytest.mark. parametrize装饰器可以实现对测试用例的参数化,方便测试数据的获取。
@pytest.mark. parametrize的基本使用:
方便测试函数对测试数据的获取。
方法:
parametrize(argnames, argvalues, indirect=False, ids=None, scope=None)
参数说明:
参数化用法
1、单个参数【测试方法入参只有一个参数】
# file_name: test_parametrize.py
import pytest
class Test_D:
@pytest.mark.parametrize("a", [1, 2, 3]) # 参数a被赋予3个值,test_a将会运行3遍
def test_a(self, a): # 参数必须和parametrize里面的参数一致
print('\n------------------> test_a has ran, and a = {}'.format(a))
assert 1 == a
if __name__ == '__main__':
pytest.main(['-s', 'test_parametrize.py'])
运行结果:
从运行结果中可以看到test_a方法被执行了3遍,说明参数a参数化成功。
2、多个参数【测试方法入参有多个参数】
# file_name:test_parametrize.py
import pytest
class Test_D:
@pytest.mark.parametrize("a,b", [(1, 2), (2, 3), (3, 4)]) # 参数a,b均被赋予三个值,函数会运行三遍
def test_b(self, a, b): # 参数必须和parametrize里面的参数一致
print('\n------------------> test_b has ran, and a = {}, b = {}'.format(a, b))
assert 1
if __name__ == '__main__':
pytest.main(['-s', 'test_parametrize.py'])
运行结果:
从运行结果中可以看到test_b方法被执行了三遍,说明参数a,b都已经被参数化。
3、利用函数的返回值进行用例参数化
# file_name: test_parametrize.py
import pytest
# 定义返回参数值的函数
def return_test_data():
return [(1, 2), (2, 3), (3, 4)]
class Test_D:
@pytest.mark.parametrize("a,b", return_test_data()) # 使用函数返回值的方式传入参数值
def test_c(self, a, b):
print('\n------------------> test_c has ran, and a = {}, b = {}'.format(a, b))
assert 1
if __name__ == '__main__':
pytest.main(['-s', 'test_parametrize.py'])
运行结果:
从运行结果中可以看到test_c方法被执行了三遍,这说明使用函数的返回值方式同样可以做到参数化。
4、参数组合
获得多个参数化参数的所有组合,可以堆叠使用参数化装饰器:【每一个参数化装饰器代表参数化测试方法中的一组测试数据】
# file_name: test_parametrize.py
import pytest
class Test_D:
@pytest.mark.parametrize("x", [1, 2])
@pytest.mark.parametrize("y", [3, 4])
def test_d(self, x, y):
print("\n------------------> test_d has ran, and x={}, y={}".format(x, y))
if __name__ == '__main__':
pytest.main(['-s', 'test_parametrize.py'])
运行结果:
从运行结果中可以看到test_d方法被执行了四遍,这是因为参数x和参数y分别被赋予了2个值,组合起来就是2*2=4次,说明装饰器叠加可以获得所有参数的组合。
二、参数化@pytest.mark.parametrize装饰器中的indirect参数使用
① indirect 参数一般与pytest中的fixture函数中的 request 组合使用。
②当 indrect=True 时,argnames则要传入fixture函数名称,不再是一个普通参数,而是要被调用的fixture函数,argvalues则是要给这个fixture函数传的值。
③用法其实与 @pytest.fixture(params) 一样,但使用了 @pytest.mark.parametrize 相当于参数化了fixture函数,而不是只有固定的一套数据传入使用。
实例1:【因为参数化装饰器的参数 indirect=Ture ,所以pytest测试框架将login_r当作函数执行,且将test_user_data列表作为参数传入到login_r函数中】
import pytest
test_user_data = ['Tom', 'Jerry']
# 方法名作为参数
@pytest.fixture(scope='module')
def login_r(request):
user = request.param # 通过 request.param 获取测试参数
print(f" 登录用户: {user}")
return user
@pytest.mark.parametrize("login_r", test_user_data, indirect=True)
def test_login(login_r):
a = login_r
print(f"测试用例中 login_r 函数 的返回值; {a}")
assert a != ""
运行结果:
实例2:单fixture单值(通过列表)
import pytest
@pytest.fixture()
def login(request):
user = request.param
print("传入的用户名为:{}".format(user))
return user
user = ['张三', '李四']
@pytest.mark.parametrize('login', user, indirect=True) # 此时测试函数参数化的值为login fixture函数的返回值(参数列表user中存在几组数据就进行了几次参数化)
def test_one_param(login):
print("测试函数的读到的用户是:{}".format(login))
运行结果:
详细解释:
整个调用过程如下:
实例3:单fixture多值(通过字典)
import pytest
user_info = [
{'user': '张三', 'pwd': 123},
{'user': '李四', 'pwd': 456}
]
@pytest.fixture()
def login(request):
user = request.param
print("传入的用户名为:{},密码为:{}".format(user['user'], user['pwd']))
return user
@pytest.mark.parametrize('login', user_info, indirect=True)
def test_one_param(login):
print("测试类的读到的用户是:{} 密码是:{}".format(login['user'], login['pwd']))
运行结果:
实例4:传多fixture多值(通过嵌套元组的列表)
import pytest
# 一个@pytest.mark.parametrize使用多个fixture,传入的数据要是嵌套了元组的列表
user_info = [
('张三', 123),
('李四', 'pwd')
]
@pytest.fixture()
def login_user(request):
user = request.param
print("传入的用户名为:{}".format(user))
return user
@pytest.fixture()
def login_pwd(request):
pwd = request.param
print("密码为:{}".format(pwd))
return pwd
@pytest.mark.parametrize('login_user,login_pwd', user_info, indirect=True)
def test_one_param(login_user, login_pwd):
print("测试类的读到的用户是:{} 密码是:{}".format(login_user, login_pwd))
运行结果:
实例5:叠加fixture(单值列表,执行次数笛卡尔集 N*M)
import pytest
user = ['张三', '李四']
pwd = [124, 345]
@pytest.fixture()
def login_user(request):
user = request.param
print("传入的用户名为:{}".format(user))
return user
@pytest.fixture()
def login_pwd(request):
pwd = request.param
print("密码为:{}".format(pwd))
return pwd
@pytest.mark.parametrize('login_pwd', pwd, indirect=True)
@pytest.mark.parametrize('login_user', user, indirect=True)
def test_one_param(login_user, login_pwd):
print("测试类的读到的用户是:{} 密码是:{}".format(login_user, login_pwd))
运行结果:
三、参数化@pytest.mark.parametrize装饰器中的scope参数使用
① scope 参数的作用范围取值与fixture函数的scope一致,且hi有当 indirect=True 才会被使用。
② scope 参数的作用范围会覆盖fixture函数的scope范围,如果同一个被调用的fixture函数有多个parametrize定义了scope,取第一条的范围。
实例:
import pytest
@pytest.fixture(scope='class')
def login_user(request):
user = request.param
print("传入的用户名为:{}".format(user))
return user
@pytest.fixture(scope='class')
def login_pwd(request):
pwd = request.param
print("密码为:{}".format(pwd))
return pwd
class TestCase:
userinfo = [
('张三', 123)
]
ids = ["case{}".format(i) for i in range(len(userinfo))]
@pytest.mark.parametrize('login_user,login_pwd', userinfo, ids=ids, indirect=True, scope='function')
def test_one_param(self, login_user, login_pwd):
print("测试类的读到的内容是{}{}".format(login_user, login_pwd))
@pytest.mark.parametrize('login_user,login_pwd', userinfo, ids=ids, indirect=True, scope='function')
def test_one_param2(self, login_user, login_pwd):
print("测试类的读到的内容是{}{}".format(login_user, login_pwd))
运行结果:
①小于fixture函数的scope范围:
②大于fixture函数的scope范围:
③多个SCOPE范围为先执行的:
与③相比调整一下顺序:
四、参数化@pytest.mark.parametrize加mark标记跳过执行其中一组或者多组测试数据(标记同一的测试方法中的子用例,并在子用例上做mark操作:xfail,skip等等)
需求:pytest 使用 @pytest.mark.parametrize 对测试用例进行参数化的时候,当存在多组测试数据时,需要对其中的一组或者多组测试数据加标记跳过执行,可以用 pytest.param 实现。
pytest.param用法:
参数:
① param values :按顺序传参数集值的变量args
② keyword marks : marks关键字参数,要应用于此参数集的单个标记或标记列表。
③ keyword str id : id字符串关键字参数,测试用例的id属性【测试用例名】
源码:
def param(*values, **kw):
"""Specify a parameter in `pytest.mark.parametrize`_ calls or
:ref:`parametrized fixtures <fixture-parametrize-marks>`.
.. code-block:: python
@pytest.mark.parametrize("test_input,expected", [
("3+5", 8),
pytest.param("6*9", 42, marks=pytest.mark.xfail),
])
def test_eval(test_input, expected):
assert eval(test_input) == expected
:param values: variable args of the values of the parameter set, in order.
:keyword marks: a single mark or a list of marks to be applied to this parameter set.
:keyword str id: the id to attribute to this parameter set.
"""
return ParameterSet.param(*values, **kw)
实例1:xfail标记同一测试方法的子用例
import pytest
@pytest.mark.parametrize("test_input,expected", [
("3+5", 8),
pytest.param("6*9", 42, marks=pytest.mark.xfail),
])
def test_eval(test_input, expected):
assert eval(test_input) == expected
运行结果:
实例2:skip标记同一测试方法的子用例
import pytest
@pytest.mark.parametrize("user,psw",
[("student", "123456"),
("teacher", "abcdefg"),
pytest.param("admin", "我爱中华!", marks=pytest.mark.skip(reason='跳过原因'))
])
def test_login(user, psw):
print(user + " : " + psw)
assert 1 == 1
运行结果:
实例3:类比实例2与实例3子用例参数化的区别
import pytest
@pytest.mark.parametrize("number",
[pytest.param("1"),
pytest.param("2"),
pytest.param("3", marks=pytest.mark.skip(reason='该参数未准备好'))])
def test_login1(number):
print(number)
assert 1 == 1
运行结果:
实例4:
import pytest
@pytest.mark.parametrize("user,psw",
[pytest.param("admin1", "123456"),
pytest.param("admin2", "abcdefg"),
pytest.param("admin3", "higklmn", marks=pytest.mark.skip('此用户的登录信息还没有初始化,不可使用'))])
def test_login1(user, psw):
print(user + " : " + psw)
assert 1 == 1
运行结果:
五、参数化@pytest.mark.parametrize装饰器中的id参数与ids参数使用
id参数需要参照ids参数并加以区分:pytest参数化自定义测试用例标题【@pytest.mark.parametrize(ids=XXX)】
①id参数是给用例添加标题内容,没加id参数的时候,用例会默认拿请求的参数当用例标题;如实例1
②id参数是指单条参数化测试用例数据时,分别为同一测试方法中的每一条测试用例进行命名;ids参数是指多条参数化测试用例数据时,ids参数传入一个列表或者元组,分别为同一测试方法中的所有测试用例进行命名。如实例2、实例3
实例1:
import pytest
@pytest.mark.parametrize("user,psw",
[pytest.param("admin1", "abcdefg"),
pytest.param("admin2", "123456"),
pytest.param("admin3", "qwerty", marks=pytest.mark.skip)])
def test_login1(user, psw):
print(user + " : " + psw)
assert 1 == 1
运行结果:
实例2:
import pytest
@pytest.mark.parametrize("user,psw",
[pytest.param("admin1", "abcdefg", id="第一条测试用例名字"),
pytest.param("admin2", "123456", id="第二条测试用例名字"),
pytest.param("admin3", "qwerty", marks=pytest.mark.skip, id="第三条测试用例名字")])
def test_login1(user, psw):
print(user + " : " + psw)
assert 1 == 1
运行结果:
实例3:
import pytest
@pytest.mark.parametrize("user,psw", argvalues=[("admin1", "abcdefg"), ("admin2", "123456"), ("admin3", "qwerty")],
ids=["第一条测试用例名字", "第二条测试用例名字", "第三条测试用例名字"])
def test_login1(user, psw):
print(user + " : " + psw)
assert 1 == 1
运行结果:
去期待陌生,去拥抱惊喜。