Notes

unittest

概述：unittest

unittest

介绍

支持测试自动化，配置共享和关机代码测试。支持将测试样例聚合到测试集中，并将测试与报告框架独立。

unittest是一个单元测试框架，是Python编程的单元测试框架。

unittest支持测试自动化，共享测试用例中的初始化和关闭退出代码，在unittest中最小单元是test，也就是一个测试用例。要了解unittest单元测试框架，先来了解以下几个重要的概念。

用例编写

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import unittest

class TestStringMethods(unittest.TestCase):

    def test_upper(self):
        self.assertEqual('foo'.upper(), 'FOO')

    def test_isupper(self):
        self.assertTrue('FOO'.isupper())
        self.assertFalse('Foo'.isupper())

    def test_split(self):
        s = 'hello world'
        self.assertEqual(s.split(), ['hello', 'world'])
        # check that s.split fails when the separator is not a string
        with self.assertRaises(TypeError):
            s.split(2)

if __name__ == '__main__':
    unittest.main()

  • 需继承unittest.TestCase 测试用例类

  • 在 test_upper 测试中，使用 assertEqual 检查是否是预期值

  • 在 test_isupper 测试中，使用 assertTrue 或 assertFalse 验证是否符合条件

  • 在 test_split 测试中，使用 assertRaises 验证是否抛出一个特定异常

测试夹具

测试夹具包含测试前置（setUp）和清理（tearDown）方法。

测试前置方法 setUp来做一些准备工作，比如建立数据库连接。它会在用例执行前被测试框架自动调用。

测试清理方法 tearDown() 用来做一些清理工作，比如断开数据库连接。它会在用例执行完成（包括失败的情况）后被测试框架自动调用。

测试前置和清理方法可以有不同的执行级别。

  • 生效级别：测试方法

如果我们希望每个测试方法之前前后分别执行测试前置和清理方法，那么需要在测试类中定义好 setUp()]和 tearDown()：

1
2
3
4
5
6
class MyTestCase(unittest.TestCase):
    def setUp(self):
        pass

    def tearDown(self):
        pass
  • 生效级别：测试类

如果我们希望单个测试类中只执行一次前置方法，再执行该测试类中的所有测试，最后执行一次清理方法，那么需要在测试类中定义好 setUpClass() 和 tearDownClass()：

1
2
3
4
5
6
class MyTestCase(unittest.TestCase):
    def setUpClass(self):
        pass

    def tearDownClass(self):
        pass
  • 生效级别：测试模块

如果我们希望单个测试模块中只执行一次前置方法，再执行该模块中所有测试类的所有测试，最后执行一次清理方法，那么需要在测试模块中定义好 setUpModule()和 tearDownModule()：

1
2
3
4
5
def setUpModule():
    pass

def tearDownModule():
    pass

跳过测试/预计失败

  • 通过skip装饰器或SkipTest直接跳过测试
  • 通过skipIf或skipUnless按条件跳过或不跳过测试
  • 通过 expectedFailure 预计测试失败
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
class MyTestCase(unittest.TestCase):

    @unittest.skip("直接跳过")
    def test_nothing(self):
        self.fail("shouldn't happen")

    @unittest.skipIf(mylib.__version__ < (1, 3),
                     "满足条件跳过")
    def test_format(self):
        # Tests that work for only a certain version of the library.
        pass

    @unittest.skipUnless(sys.platform.startswith("win"), "满足条件不跳过")
    def test_windows_support(self):
        # windows specific testing code
        pass

    def test_maybe_skipped(self):
        if not external_resource_available():
            self.skipTest("跳过")
        # test code that depends on the external resource
        pass

    @unittest.expectedFailure
    def test_fail(self):
        self.assertEqual(1, 0, "这个目前是失败的")

子测试

在一个测试方法中传入不同的参数来测试同一段逻辑，但它将被视作一个测试，但是如果使用了子测试，就能被视作 N（即为参数的个数）个测试。

1
2
3
4
5
6
7
8
9
class NumbersTest(unittest.TestCase):

    def test_even(self):
        """
        Test that numbers between 0 and 5 are all even.
        """
        for i in range(0, 6):
            with self.subTest(i=i):
                self.assertEqual(i % 2, 0)

示例中使用了 with self.subTest(i=i) 的方式定义子测试，这种情况下，即使单个子测试执行失败，也不会影响后续子测试的执行。

测试结果输出

  • 在调用测试脚本时添加 -v 参数使unittest.main()显示更为详细的信息

  • 可以使用第三方库（HtmlTestRunner）生成HTML格式报告 HtmlTestRunner-Github文档说明

1
2
3
4
import HtmlTestRunner
...
if __name__ == '__main__':
    unittest.main(testRunner=HtmlTestRunner.HTMLTestRunner())

其它

第三方单元测试框架：nose 和 nose2

ssh

1
2
cd ./~ssh
cat id_rsa.pub

测试固件（test fixture）

一个测试固件包括两部分，执行测试代码之前的准备部分和测试结束之后的清扫代码。这两部分一般用函数setUp()和tearDown()表示。这里举例以下，例如要测试百度搜索selenium这个场景，我们的测试固件可以这样写，setUp()里写打开浏览器，浏览器最大化，和打开百度首页等脚本代码；在tearDown（）里写结束搜索后，退出并关闭浏览器的代码。

测试用例（test case）

unittest中管理的最小单元是测试用例，一个测试用例，包括测试固件，和具体测试业务的函数或者方法。一个测试用例中，测试固件可以不写，但是至少有一个已test开头的函数。unittest会自动化识别test开头的函数是测试代码，如果你写的函数不是test开头，unittest是不会执行这个函数里面的脚本的，这个千万要记住，所有的测试函数都要test开头，记住是小写的哦。

测试套件 （test suite）

很简单，就是很多测试用例的集合，叫测试套件，一个测试套件可以随意管理多个测试用例。如果测试用例比作单个学生，测试套件就是好像是班级的概念。

测试执行器 （test runner）

test runner是一个用来执行加载测试用例，并执行用例，且提供测试输出的一个组建。它可以加载test case或者test suite进行执行测试任务。

POM Page Object Model 页面对象模型，解决前端UI变化频繁造成自动化测试，将页面元素和业务逻辑和测试脚本分离出来到两个不同类文件。ClassA只写页面元素定位，和业务逻辑代码操作的封装，ClassB只写测试脚本，不关心如何元素定位，只写调用ClassA的代码去覆盖不同的测试场景。如果前端页面发生变化，只需要修改ClassA的元素定位，而不需要去修改ClassB中的测试脚本代码。

POM优点

  1. 把web ui对象仓库从测试脚本分离，业务代码和测试脚本分离。

  2. 每一个页面对应一个页面类，页面的元素写到这个页面类中。

  3. 页面类主要包括该页面的元素定位，和和这些元素相关的业务操作代码封装的方法。

  4. 代码复用，从而减少测试脚本代码量。

  5. 层次清晰，同时支持多个编写自动化脚本开发，例如每个人写哪几个页面，不影响他人。

  6. 建议页面类和业务逻辑方法都给一个有意义的名称，方便他人快速编写脚本和维护脚本。

自动生成测试脚本 Playwright

1
2
3
4
5
pip install playwright

python -m playwright install

python -m playwright codegen