Unittest之断言

前言

Python unintest单元测试框架提供了一整套内置的断言方法

• 如果断言失败，则抛出一个AssertionError,并标识该测试为失败状态
• 如果异常，则当做错误来处理
• 注意：以上两种方式的区别
• 如果成功，则标识该测试为成功状态

---

下面我们看下在unittest框架中定义了哪几类断言方法:

1. 基本的Boolean断言，即：要么True，要么False的验证；
2. 简单比较断言，例如比较a,b两个变量的值；
3. 复杂断言；

1、基本断言方法

基本的断言方法提供了测试结果是True还是False。所有的断言方法都有一个msg参数，如果指定msg参数的值，则将该信息作为失败的错误信息返回。

序号	断言语法	断言描述
1	assertEqual(arg1, arg2, msg=None)	验证arg1=arg2，不等则fail
2	assertNotEqual(arg1, arg2, msg=None)	验证arg1 != arg2, 相等则fail
3	assertTrue(expr, msg=None)	验证expr是true，如果为false，则fail
4	assertFalse(expr,msg=None)	验证expr是false，如果为true，则fail
5	assertIs(arg1, arg2, msg=None)	验证arg1、arg2是同一个对象，不是则fail
6	assertIsNot(arg1, arg2, msg=None)	验证arg1、arg2不是同一个对象，是则fail
7	assertIsNone(expr, msg=None)	验证expr是None，不是则fail
8	assertIsNotNone(expr, msg=None)	验证expr不是None，是则fail
9	assertIn(arg1, arg2, msg=None)	验证arg1是arg2的子串，不是则fail
10	assertNotIn(arg1, arg2, msg=None)	验证arg1不是arg2的子串，是则fail
11	assertIsInstance(obj, cls, msg=None)	验证obj是cls的实例，不是则fail
12	assertNotIsInstance(obj, cls, msg=None)	验证obj不是cls的实例，是则fail

2、比较断言

unittest框架提供的第二种断言类型就是比较断言

下面我们看下各种比较断言：

• assertAlmostEqual (first, second, places = 7, msg = None, delta = None)

验证first约等于second。
palces: 指定精确到小数点后多少位，默认为7

• assertNotAlmostEqual (first, second, places, msg, delta)

验证first不约等于second。
palces: 指定精确到小数点后多少位，默认为7
注： 在上述的两个函数中，如果delta指定了值，则first和second之间的差值必须≤delta

• assertGreater (first, second, msg = None)

验证first > second，否则fail

• assertGreaterEqual (first, second, msg = None)

验证first ≥ second，否则fail

• assertLess (first, second, msg = None)

验证first < second，否则fail

• assertLessEqual (first, second, msg = None)

验证first ≤ second，否则fail

• assertRegexpMatches (text, regexp, msg = None)

验证正则表达式regexp搜索匹配的文本text。
regexp：通常使用re.search()

• assertNotRegexpMatches (text, regexp, msg = None)

验证正则表达式regexp搜索不匹配的文本text。
regexp：通常使用re.search()

3、复杂断言

序号	断言语法	断言描述
1	assertListEqual (list1, list2, msg = None)	验证列表list1、list2相等，不等则fail，同时报错信息返回具体的不同的地方
2	assertTupleEqual (tuple1, tuple2, msg = None)	验证元组tuple1、tuple2相等，不等则fail，同时报错信息返回具体的不同的地方
3	assertSetEqual (set1, set2, msg = None)	验证集合set1、set2相等，不等则fail，同时报错信息返回具体的不同的地方
4	assertDictEqual (expected, actual, msg = None)	验证字典expected、actual相等，不等则fail，同时报错信息返回具体的不同的地方