一、断言 基础知识
测试用例三要素:输入、执行条件、预期输出
预期输出就要靠断言来实现,简单来讲就是实际结果和期望结果去对比,符合预期那就测试pass,不符合预期那就测试 failed
1.断言语法
pytest与unittest不同,pytest使用的是python自带的assert关键字来进行断言,unittest使用的是自己的断言,需要用self来调用
assert关键字后面可以接一个表达式,只要表达式的最终结果为True,那么断言通过,用例执行成功,否则用例执行失败
常用格式:
- assert xx :判断 xx 为真
- assert not xx :判断 xx 不为真
- assert a in b :判断 b 包含 a
- assert a == b :判断 a 等于 b
- assert a != b :判断 a 不等于 b
- assert a > b :判断 a 大于 b(<, >=, <=等等)
2.自定义断言失败信息
第一种:不做任何处理,默认报错信息,如 assert "1" == '23' 失败后,报告:AssertionError: assert '1' == '23'
第二种:自定义报错信息,如:assert "1" == '23', '1 难道不等于 23 么?' 失败后报告: AssertionError: 1 难道不等于 23 么?
二、异常断言
1.异常断言 pytest.raises
pytest.raises 作为上下文管理器,当其管理的执行代码抛出我们指定类型的异常时,可以异常捕获为一个异常对象,不会报错,继续执行后续代码
pytest.raises只会捕获指定的异常类型,遇到其他类型异常或者没有报错,都会直接报错造成用例执行失败
应用场景:在一些代码块或者函数会引发意料之中的异常,导致程序无法运行时,使用 raises 捕获匹配到的异常,代码可以继续正常运行
def test_dir01_8():# pytest.raises会对AttributeError类型进行捕获,执行代码如出现这个错误,不报错会继续往下执行,对于去其他类型错误还是会报错
# 常见类型:AttributeError ValueError等等 BaseException(万能捕获)
with pytest.raises(AttributeError) as e:
raise AttributeError('属性报错') # 这个是执行代码
# raise ValueError('值报错')
print()
print('错误类型:', type(e.type), e.type) # 错误类型:
print('报错类型名称:', type(e.typename), e.typename) # 报错类型名称: AttributeError
print('报错信息:', type(e.value),e.value) # 报错信息: 属性报错
assert e.type == AttributeError
assert e.typename == 'AttributeError'
# assert e.value == '属性报错' # 这是错误语法,type(e.value)=,是个类不是字符串,需要用下面的方式
assert '属性报错' in str(e.value)
执行结果:用例通过
执行过程:执行代码报属性错误 --> 异常管理器捕获到,并生成异常实例 e --> 继续执行管理器外其他代码
异常对象常用属性:type、typename、value、traceback
注意:异常管理的执行代码没有出现预言的异常的话,会报错,用例执行失败
2.异常断言 正则匹配
pytest.raises上下文管理器,支持正则表达式,match参数即为正则表达式,表示的是re.search()
正则匹配的是异常实例的value,如果异常类型匹配,且异常信息value和 re.search('表达式') 也匹配,则表示出现了预期内的异常
执行结果:通过
def test_dir01_9():with pytest.raises(ValueError, match=r'.*\d$') as e:
# raise ValueError('值报错') # 这个会造成用例执行失败:AssertionError: Regex pattern '.*\\d$' does not match '值报错'.
raise ValueError('值报错666')
print()
print('错误类型:', type(e.type), e.type) # 错误类型:
print('报错类型名称:', type(e.typename), e.typename) # 报错类型名称: ValueError
print('报错信息:', type(e.value),e.value) # 报错信息: 值报错666
print('报错:', type(e.traceback),e.traceback) # 报错: []
assert e.type == ValueError
assert e.typename == 'ValueError'
# assert e.value == '属性报错' # 这是错误语法,type(e.value)=,是个类不是字符串,需要用下面的方式
assert '值报错' in str(e.value)
三、 pytest使用xfail处理失败
xfail意味将测试用例标记为预期失败,常用于对尚未实现的功能或尚未修复的错误进行测试
当测试被标记为预期失败(用装饰器pytest.mark.xfail标记):
1.xfail基础语法
@pytest.mark.xfail(condition=None, *, reason=None, raises=None, run=True, strict=False)参数
- condition(bool或str)– (True/False或条件字符串)将测试函数标记为 xfail的条件。如果是 bool,还必须指定后面的reason。
- reason (str) – 测试函数被标记为 xfail 的原因描述,报错后会显示出来,相当于自定义异常提示
- raises ( Type [Exception ] ) – 预期为由测试函数引发的子类异常如ValueError,TypeError等;其他异常不通过测试。
- run (bool ) –是否实际执行测试函数。如果False,该函数将始终 xfail 并且不会被执行
- strict(bool ) - 默认False,如果通过测试结果为xpassed。如果是True,即使用例无报错,测试结果也是failed,可以在pytest.ini配置文件中指定xfail_strict,对全局用xfail的用例生效。如果配置文件和用例中都有,以用例中的为准
2.检查断言装饰器
@pytest.mark.xfail(raises='异常类型')
检查是否有异常,常见情况有以下三种:
@pytest.mark.xfail(raises=ValueError) # 检查断言装饰器,检查ValueError类型错误def test_dir01_9():
# 情况一:出现预期报错,用例 XFAIL,不继续往后执行
# raise ValueError('值报错') # XFAIL dir01/dir01_test.py::test_dir01_9
# 情况二:出现其他报错,用例 FAILED,不会影响用例,不继续往后执行
raise AttributeError('属性报错') # FAILED dir01/dir01_test.py::test_dir01_9 - AttributeError: 属性报错
# 情况三:没有任何报错,用例 XPASS
# print('能到这里么?') # XPASS dir01/dir01_test.py::test_dir01_9
总结:
- with pytest.raise 对于故意测试异常代码的情况,使用可能会更好
- @pytest.mark.xfail 对于检查未修复的错误(即,可能会发生异常),使用检查断言可能会更好
3.reason自定义报错信息
@pytest.mark.xfail(raises=ValueError,reason='就是值报错了呗') # 检查断言装饰器,检查ValueError类型错误def test_dir01_9():
# 出现预期报错,用例 XFAIL,会附带失败的描述reason
raise ValueError('值报错') # dir01/dir01_test.py::test_dir01_9 XFAIL (就是值报错了呗)
4.condition用法
两种用法:
# condition 两种使用方法# @pytest.mark.xfail('11>2',raises=TypeError) # 第一种 字符串,会解析字符串为表达式,判断 11>2得到bool
# @pytest.mark.xfail('11<2',raises=TypeError) # 11<2为False,这个装饰器就不会生效
@pytest.mark.xfail(11>2, reason='11比2大,我就生效了', raises=TypeError) # 第二种 bool + reason
def test_function_003():
raise TypeError('777') # xfail
# raise AttributeError('888') # failed
# assert True # xpassed
# assert False # failed
举例:
import sys@pytest.mark.xfail(sys.platform == "win32", reason="平台是 win32 时,此用例被xfail管理,否则就是个普通用例")
def test_function_003():
assert True # XPASS dir01/dir01_test.py::test_function_003 平台是 win32 时,此用例被xfail管理,否则就是个普通用例
# assert False # XFAIL dir01/dir01_test.py::test_function_003 平台是 win32 时,此用例被xfail管理,否则就是个普通用例
condition为:sys.platform == "win32"
条件成立:该用例xfail才会生效,无报错则 XPASS,有报错则XFAIL
条件不成立:就是没有xfail管理的普通用例
>>参考小菠萝<<