python接口自动化测试 - unittest框架基本使用
unittest简单介绍
- 单元测试框架
- 还可以适用WEB自动化测试用例的开发与执行
- 提供丰富的断言方法
- 官方文档:https://docs.python.org/zh-cn/3/library/unittest.html
unittest基础使用
1 # 导入unittest模块 2 import unittest 3 4 5 # 创建单元测试类,继承unittest.TestCase 6 class testCase(unittest.TestCase): 7 8 def setUp(self): 9 print("case执行前") 10 11 def tearDown(self): 12 print("case执行后") 13 14 @classmethod 15 def setUpClass(cls): 16 print("对象执行前") 17 18 @classmethod 19 def tearDownClass(cls): 20 print("对象执行后") 21 22 # 测试用例 23 def test_01(self): 24 print("test01") 25 26 def test_02(self): 27 print("test02") 28 29 30 if __name__ == '__main__': 31 unittest.main()
运行结果
1 对象执行前 2 case执行前 3 test01 4 case执行后 5 case执行前 6 test02 7 case执行后 8 对象执行后 9 10 11 Ran 2 tests in 0.002s 12 13 OK
这里包含的知识点:
unittest.Testcase
- 自己创建的单元测试类都要继承它,它是所有单元测试类的基类
setUp
- 用于每个测试用例执行前的初始化工作
- 所有类中方法的入参为 self ,定义实例变量也要 self.变量
tearDown
- 每个测试用例执行后的都会执行此方法
setUpClass
- 每个单元测试类运行前调用该方法,只会执行一次
- 属于类方法,需要加上装饰器 @classmethod
- 默认入参是 cls ,指的就是“类对象”本身,其实和self没什么区别,用法一致
tearDownClass
- 每个单元测试类运行后调用该方法,只会执行一次
- 属于类方法,需要加上装饰器 @classmethod
测试用例
- 必须以“test_”开头命名的方法,否则无法识别并执行
- 方法里面需要有断言,才能在最后运行时有该用例的执行结果
- 可包含多个测试用例
unittest.main()
- 运行单元测试
- 该命令会搜索当前module 下所有以 test开头的测试用例,并运行它们
- 执行顺序是按照case的命名
unitteest提供的各种断言方式
1 class testCase(unittest.TestCase): 2 3 def test_03(self): 4 # 断言 - 是否为True 5 flag = True 6 self.assertTrue(flag, msg="测试失败的信息,可不填") 7 8 def test_04(self): 9 # 断言 - 是否为False 10 flag = False 11 self.assertFalse(flag) 12 13 def test_05(self): 14 # 断言 - 提供的两个参数是否相同(任意类型) 15 self.assertEqual("123", "123") # 字符串 16 self.assertEqual({"a": 1}, {"a": 1}) # 字典 17 self.assertEqual([1, 2], [1, 2]) # 列表 18 self.assertEqual((1, 2), (1, 2)) # 元组 19 self.assertEqual({1, 2}, {1, 2}) # 集合 20 21 def test_06(self): 22 # 断言 - 列表是否相同 23 self.assertListtEqual([1, 2], [1, 2]) 24 25 def test_07(self): 26 # 断言 - 字典是否相同 27 self.assertDictEqual({"a": 1}, {"a": 1}) 28 29 def test_08(self): 30 # 断言 - 元组是否相同 31 self.assertTupleEqual((1, 2), (1, 2)) 32 33 def test_09(self): 34 # 断言 - 集合是否相同 35 self.assertSetEqual({1, 2}, {1, 2})
这是比较常见的断言方式,当然还有一些比较容易理解的断言方式就没有一一举例啦,具体可以看看下面列表
方法 |
等同于python里面的写法 |
assertEqual(a, b) |
a == b |
assertNotEqual(a, b) |
a != b |
assertTrue(x) |
bool(x) is True |
assertFalse(x) |
bool(x) is False |
assertIs(a, b) |
a is b |
assertIsNot(a, b) |
a is not b |
assertIsNone(x) |
x is None |
assertIsNotNone(x) |
x is not None |
assertIn(a, b) |
a in b |
assertNotIn(a, b) |
a not in b |
assertIsInstance(a, b) |
isinstance(a, b) |
assertNotIsInstance(a, b) |
not isinstance(a, b) |
assertRegex(s, r) |
r.search(s) |
unittest测试用例跳过执行
1 class testCase(unittest.TestCase): 2 3 # 直接跳过 4 @unittest.skip("直接跳过") 5 def test_skip(self): 6 self.fail("shouldn't happen") 7 8 # 满足condition则跳过 9 @unittest.skipIf(1 < 2, "满足condition则跳过") 10 def test_skipIf(self): 11 print("skip if") 12 13 # 不满足condition则跳过 14 @unittest.skipUnless(sys.platform.startswith("win"), "需要window平台才不会跳过") 15 def test_skipUnless(self): 16 print("skip Unless") 17 18 # 预计该测试用例会测试失败 19 @unittest.expectedFailure 20 def test_fail(self): 21 self.assertEqual(1, 0, "broken") 22 23 # 方法体内跳出不执行case 24 def test_maybe_skipped(self): 25 if True: 26 self.skipTest("调用unittest的skipTest,在方法体内满足某些条件则跳过该case") 27 pass
运行结果
1 Skipped: 调用unittest的skipTest,在方法体内满足某些条件则跳过该case 2 3 Skipped: 直接跳过 4 5 Skipped: 满足condition则跳过 6 skip Unless 7 8 9 Ran 5 tests in 0.010s 10 11 OK (skipped=3, expected failures=1)
跳过执行测试用例共有四种写法
- @unittest.skip(reason) :跳过测试用例,reason 为测试被跳过的原因
- @unittest.skipIf(condition, reason) :当 condition 为真时,跳过测试用例。
- @unittest.skipUnless(condition, reason) :跳过测试用例,除非 condition 为真
- @unittest.expectedFailure :把测试用例标记为预计失败;如果测试不通过,会被认为测试成功;如果测试通过了,则被认为是测试失败
self.skipTest(reason)
在方法体内满足某些条件下才跳过执行该测试用例
跳过执行测试用例注意点
- 被跳过的测试的 setUp() 和 tearDown() 不会被运行
- 只输入 unittest.skip ,也可以正常跳过,不必写reason
- 若输入 unittest.skip() ,括号内必须写reason,不得为空
- 可以针对单元测试类级别设置跳过执行(在class声明上面直接加装饰器即可),该单元测试类所有测试用例不会被执行
- 被跳过的类的 setUpClass() 和 tearDownClass() 不会被运行
- 当方法体内调用了 self.skipTest(reason) 方法,该测试用例还是会调用 setUp() 和 tearDown()