12306helper,avi电影下载网站,血荨麻

python单元测试

本篇全面介绍一下python中很常用的单元测试框架unitest。

1、unitest主要功能模块介绍

unitest主要包含testcase、testsuite、testloader、texttestrunner、texttestresult这几个功能模块。

• testcase：一个testcase实例就是一个测试用例，一个测试用例就是一个完整的测试流程，包括测试前环境的搭建，测试代码的执行，以及测试后环境的还原或者销毁。元测试的本质也就在这里，一个测试用例是一个完整的测试单元，可以对某一具体问题进行检查验证。

• testsuite：多个测试用例集合在一起就是testsuite，testsuite也可以嵌套testsuite。

• testloader：testloader的作用是将testcase加载到testsuite中。

• texttestrunner：texttestrunner是用来执行测试用例的，其中的run(test)会执行testsuite/testcase中的run(result)方法。

• texttestresult：texttestresult用来保存测试结果，其中包括运行了多少测试用例，成功了多少，失败了多少等信息。

整个流程为：写好testcase，然后由testloader加载testcase到testsuite，然后由texttestrunner来运行testsuite，运行的结果保存在texttestresult中。

2、实例介绍

首先准备几个待测的方法，写在test_func.py中。

def add(a, b):
    return a + b


def multi(a, b):
    return a * b


def lower_str(string):
    return string.lower()


def square(x):
    return x ** 2

准备好几个待测的方法之后，为这些方法写一个测试用例,写入our_testcase.py中。

import unittest
from test_func import *


class testfunc(unittest.testcase):
    """test test_func.py"""

    def test_add(self):
        """test func add"""
        self.assertequal(3, add(1, 2))
        self.assertnotequal(3, add(1, 3))

    def test_multi(self):
        """test func multi"""
        self.assertequal(6, multi(2, 3))
        self.assertnotequal(8, multi(3, 3))

    def test_lower_str(self):
        """test func lower_str"""
        self.assertequal("abc", lower_str("abc"))
        self.assertnotequal("dce", lower_str("dce"))

    def test_square(self):
        """test func square"""
        self.assertequal(17, square(4))  # 这里故意设计一个会出错的用例，测试4的平方等于17，实际上并不等于。
        self.assertnotequal(35, square(6))


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

这里写好之后，进入命令行终端，执行python our_testcase.py，执行结果如下。

...f
======================================================================
fail: test_square (__main__.testfunc)
test func square
----------------------------------------------------------------------
traceback (most recent call last):
  file "our_testcase.py", line 27, in test_square
    self.assertequal(17, square(4))
assertionerror: 17 != 16

----------------------------------------------------------------------
ran 4 tests in 0.000s

failed (failures=1)

这里分析一下这个执行结果。首先能够看到一共运行了4个测试用例，失败了1个，并且给出了失败原因，assertionerror: 17 != 16，这是我们故意留下的错误漏洞，被测试用例测试出来了。

第一行...f中，一个点.代表测试成功，f代表失败，我们的测试结果中，前三个成功了，第四个失败了，总共是四个测试，其余的符号中e代表出错，s代表跳过。

特别说明的一点是，测试的执行顺序跟方法的顺序没有关系，四个测试是随机先后执行的。

每个测试方法编写的时候，都要以test开头，比如test_square，否则是不被unitest识别的。

在unitest.main()中加上verbosity参数可以控制输出的错误报告的详细程序，默认是1，如果设为0，则不输出每一用例的执行结果，即上面的第一行的执行结果内容。如果设为2，则输出详细的执行结果。

修改our_testcase.py中主函数。

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

执行结果如下。

test_add (__main__.testfunc)
test func add ... ok
test_lower_str (__main__.testfunc)
test func lower_str ... ok
test_multi (__main__.testfunc)
test func multi ... ok
test_square (__main__.testfunc)
test func square ... fail

======================================================================
fail: test_square (__main__.testfunc)
test func square
----------------------------------------------------------------------
traceback (most recent call last):
  file "our_testcase.py", line 27, in test_square
    self.assertequal(17, square(4))
assertionerror: 17 != 16

----------------------------------------------------------------------
ran 4 tests in 0.000s

failed (failures=1)

可以看到，每一个用例的详细执行情况以及用例名，用例描述均被输出了出来，在测试方法下加代码示例中的"""doc string"""，在用例执行时，会将该字符串作为此用例的描述，加合适的注释能够使输出的测试报告更加便于阅读。

3、组织testsuite

按照上面的测试方法，我们无法控制用例执行的顺序，这样显然是不合理的，因为在一些测试过程中，我们肯定需要控制先测试某些用例，再测试某些用例，这些用例有先后的因果关系。在这里，我们就需要用到testsuite。我们添加到testsuite中的case是会按照添加的顺序执行的。

还有一个问题是，我们现在只有一个测试文件，我们直接执行该文件即可，但如果有多个测试文件，怎么进行组织，总不能一个个文件执行吧，答案也在testsuite中。

新建一个文件，test_suite.py。

import unittest
from our_testcase import testfunc

if __name__ == '__main__':
    suite = unittest.testsuite()
    tests = [testfunc("test_square"), testfunc("test_lower_str"), testfunc("test_multi")]
    suite.addtests(tests)
    runner = unittest.texttestrunner(verbosity=2)
    runner.run(suite)

执行结果如下。

test_square (our_testcase.testfunc)
test func square ... fail
test_lower_str (our_testcase.testfunc)
test func lower_str ... ok
test_multi (our_testcase.testfunc)
test func multi ... ok

======================================================================
fail: test_square (our_testcase.testfunc)
test func square
----------------------------------------------------------------------
traceback (most recent call last):
  file "/users/luyuze/projects/test/our_testcase.py", line 27, in test_square
    self.assertequal(17, square(4))
assertionerror: 17 != 16

----------------------------------------------------------------------
ran 3 tests in 0.000s

failed (failures=1)

这样，用例执行的顺序就是按照我们添加进去的顺序来执行的了。

上面使用的是testsuite的addtests()方法，并直接传入testcase列表，也有一些其他的方法可以向testsuite中添加用例。

# 直接用addtest方法添加单个testcase
suite.addtest(testmathfunc("test_multi"))


# 使用loadtestfromname,传入模块名.testcase名，下面俩方法效果相同
suite.addtests(unittest.testloader().loadtestsfromname('our_testcase.testfunc'))
suite.addtests(unittest.testloader().loadtestsfromnames(['our_testcase.testfunc']))


# loadtestsfromtestcase()，传入testcase
suite.addtests(unittest.testloader().loadtestsfromtestcase(testfunc))

用testloader的方法是无法对case进行排序的，同时，suite中也可以套suite。

4、输出文件

用例组织好了，但是结果只能输出到控制台，这样没办法查看之前的执行记录，我们想将结果输出到文件。

修改test_suite.py。

import unittest
from our_testcase import testfunc

if __name__ == '__main__':
    suite = unittest.testsuite()
    tests = [testfunc("test_square"), testfunc("test_lower_str"), testfunc("test_multi")]
    suite.addtests(tests)

    with open('unitesttextreport.txt', 'a') as f:
        runner = unittest.texttestrunner(stream=f, verbosity=2)
        runner.run(suite)

5、测试前后的处理

在之前的测试中，可能会存在这样的问题：如果要在测试之前准备环境，测试完成之后做一些清理怎么办？这里需要用到的是setup()和teardown()。

修改our_testcase.py。

import unittest
from test_func import *


class testfunc(unittest.testcase):
    """test test_func.py"""
    
    def setup(self):
        print("do something before testcase")

    def test_add(self):
        """test func add"""
        self.assertequal(3, add(1, 2))
        self.assertnotequal(3, add(1, 3))

    def test_multi(self):
        """test func multi"""
        self.assertequal(6, multi(2, 3))
        self.assertnotequal(8, multi(3, 3))

    def test_lower_str(self):
        """test func lower_str"""
        self.assertequal("abc", lower_str("abc"))
        self.assertnotequal("dce", lower_str("dce"))

    def test_square(self):
        """test func square"""
        self.assertequal(17, square(4))
        self.assertnotequal(35, square(6))
        
    def teardownclass(self):
        print("do something after testcase")


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

执行结果：

test_add (__main__.testfunc)
test func add ... do something before testcase
do something after testcase
ok
test_lower_str (__main__.testfunc)
test func lower_str ... do something before testcase
do something after testcase
ok
test_multi (__main__.testfunc)
test func multi ... do something before testcase
do something after testcase
ok
test_square (__main__.testfunc)
test func square ... do something before testcase
do something after testcase
fail

======================================================================
fail: test_square (__main__.testfunc)
test func square
----------------------------------------------------------------------
traceback (most recent call last):
  file "our_testcase.py", line 30, in test_square
    self.assertequal(17, square(4))
assertionerror: 17 != 16

----------------------------------------------------------------------
ran 4 tests in 0.001s

failed (failures=1)

可以发现setup()和teardown()在每个case前后都执行了一次。如果要在所有case执行之前和所有case执行之后准备和清理环境，我们可以使用setupclass() 与 teardownclass()。

class testfunc(unittest.testcase):
    """test test_func.py"""

    @classmethod
    def setupclass(cls):
        print "this setupclass() method only called once."

    @classmethod
    def teardownclass(cls):
        print "this teardownclass() method only called once too."

6、跳过case

如果我们临时想要跳过某个case不执行，unitest也有相应的方法。

• 1、skip装饰器

# -*- coding: utf-8 -*-

import unittest
from test_func import *


class testfunc(unittest.testcase):
    """test test_func.py"""

    @unittest.skip('do not run this case')
    def test_add(self):
        """test func add"""
        self.assertequal(3, add(1, 2))
        self.assertnotequal(3, add(1, 3))

    def test_multi(self):
        """test func multi"""
        self.assertequal(6, multi(2, 3))
        self.assertnotequal(8, multi(3, 3))

    def test_lower_str(self):
        """test func lower_str"""
        self.assertequal("abc", lower_str("abc"))
        self.assertnotequal("dce", lower_str("dce"))

    def test_square(self):
        """test func square"""
        self.assertequal(17, square(4))
        self.assertnotequal(35, square(6))


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

执行结果：

test_add (__main__.testfunc)
test func add ... skipped 'do not run this case'
test_lower_str (__main__.testfunc)
test func lower_str ... ok
test_multi (__main__.testfunc)
test func multi ... ok
test_square (__main__.testfunc)
test func square ... fail

======================================================================
fail: test_square (__main__.testfunc)
test func square
----------------------------------------------------------------------
traceback (most recent call last):
  file "our_testcase.py", line 28, in test_square
    self.assertequal(17, square(4))
assertionerror: 17 != 16

----------------------------------------------------------------------
ran 4 tests in 0.000s

failed (failures=1, skipped=1)

结果显示为，总共执行4个测试，1个失败，1个被跳过。

skip装饰器一共有三个 unittest.skip(reason)、unittest.skipif(condition, reason)、unittest.skipunless(condition, reason)，skip无条件跳过，skipif当condition为true时跳过，skipunless当condition为false时跳过。

• 2、testcase.skiptest()方法

class testfunc(unittest.testcase):
    """test test_func.py"""

    def test_add(self):
        """test func add"""
        self.skiptest("do not run this case")
        self.assertequal(3, add(1, 2))
        self.assertnotequal(3, add(1, 3))

效果与第一种是一样的。

如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！ 点击进行留言回复