UnitTest 框架 - API

本章讨论了 unittest 模块中定义的类和方法。此模块中有五个主要类。

TestCase 类

此类的对象表示最小的可测试单元。它包含测试例程，并提供用于准备每个例程和随后进行清理的钩子。

TestCase 类中定义了以下方法 −

Fixtures

TestCase 类中可以编写许多测试。这些测试方法可能需要初始化数据库连接、临时文件或其他资源。这些被称为 Fixtures。TestCase 包含一个特殊的钩子来配置和清理测试所需的任何 Fixtures。要配置 Fixtures，请重写 setUp()。要清理，请重写 teaDown()。

在下面的示例中，在 TestCase 类中编写了两个测试。它们测试两个值的加法和减法结果。setup() 方法根据每个测试的 shortDescription() 初始化参数。teardown() 方法将在每个测试结束时执行。

import unittest

class simpleTest2(unittest.TestCase):
   def setUp(self):
      self.a = 10
      self.b = 20
      name = self.shortDescription()
      if name == "Add":
         self.a = 10
         self.b = 20
         print name, self.a, self.b
      if name == "sub":
         self.a = 50
         self.b = 60
         print name, self.a, self.b
   def tearDown(self):
      print '
end of test',self.shortDescription()

   def testadd(self):
      """Add"""
      result = self.a+self.b
      self.assertTrue(result == 100)
   def testsub(self):
      """sub"""
      result = self.a-self.b
      self.assertTrue(result == -10)
      
if __name__ == '__main__':
   unittest.main()

从命令行运行上述代码。它给出以下输出 −

C:\Python27>python test2.py
Add 10 20
F
end of test Add
sub 50 60
end of test sub
.
================================================================
FAIL: testadd (__main__.simpleTest2)
Add
----------------------------------------------------------------------
Traceback (most recent call last):
   File "test2.py", line 21, in testadd
      self.assertTrue(result == 100)
AssertionError: False is not true
----------------------------------------------------------------------
Ran 2 tests in 0.015s

FAILED (failures = 1)

类 Fixture

TestCase 类有一个 setUpClass() 方法，可以重写该方法以在 TestCase 类中执行单个测试之前执行。同样，tearDownClass() 方法将在类中的所有测试之后执行。这两种方法都是类方法。因此，它们必须用 @classmethod 指令修饰。

以下示例演示了这些类方法的使用 −

import unittest

class TestFixtures(unittest.TestCase):

   @classmethod
   def setUpClass(cls):
      print 'called once before any tests in class'

   @classmethod
   def tearDownClass(cls):
      print '
called once after all tests in class'

   def setUp(self):
      self.a = 10
      self.b = 20
      name = self.shortDescription()
      print '
',name
   def tearDown(self):
      print '
end of test',self.shortDescription()

   def test1(self):
      """One"""
      result = self.a+self.b
      self.assertTrue(True)
   def test2(self):
      """Two"""
      result = self.a-self.b
      self.assertTrue(False)
      
if __name__ == '__main__':
unittest.main()

TestSuite 类

Python 的测试框架提供了一种有用的机制，通过该机制可以根据测试的功能将测试用例实例分组在一起。 unittest 模块中的 TestSuite 类提供了此机制。

创建和运行测试套件涉及以下步骤。

步骤 1 − 创建 TestSuite 类的实例。

suite = unittest.TestSuite()

步骤 2 − 在套件中的 TestCase 类中添加测试。

suite.addTest(testcase class)

步骤 3 −您还可以使用 makeSuite() 方法从类中添加测试

suite = unittest.makeSuite(测试​​用例类)

步骤 4 −也可以在套件中添加单独的测试。

suite.addTest(testcaseclass(""testmethod")

步骤 5 − 创建 TestTestRunner 类的对象。

runner = unittest.TextTestRunner()

步骤 6 − 调用 run() 方法运行套件中的所有测试

runner.run (suite)

TestSuite 类中定义了以下方法 −

以下示例显示如何使用 TestSuite 类 −

import unittest
class suiteTest(unittest.TestCase):
   def setUp(self):
      self.a = 10
      self.b = 20
      
   def testadd(self):
      """Add"""
      result = self.a+self.b
      self.assertTrue(result == 100)
   def testsub(self):
      """sub"""
      result = self.a-self.b
      self.assertTrue(result == -10)
      
def suite():
   suite = unittest.TestSuite()
##   suite.addTest (simpleTest3("testadd"))
##   suite.addTest (simpleTest3("testsub"))
   suite.addTest(unittest.makeSuite(simpleTest3))
   return suite
   
if __name__ == '__main__':
   runner = unittest.TextTestRunner()
   test_suite = suite()
   runner.run (test_suite)

您可以通过取消注释行和注释具有 makeSuite() 方法的语句来试验 addTest() 方法。

TestLoader 类

unittest 包具有 TestLoader 类，该类用于从类和模块创建测试套件。默认情况下，调用 unittest.main(0 方法时会自动创建 unittest.defaultTestLoader 实例。但是，显式实例可以自定义某些属性。

在下面的代码中，使用 TestLoader 对象将两个类的测试收集到列表中。

import unittest
testList = [Test1, Test2]
testLoad = unittest.TestLoader()

TestList = []
for testCase in testList:
   testSuite = testLoad.loadTestsFromTestCase(testCase)
   TestList.append(testSuite)
   
newSuite = unittest.TestSuite(TestList)
runner = unittest.TextTestRunner()
runner.run(newSuite)

下表显示了 TestLoader 类中的方法列表 −

TestResult 类

此类用于汇编有关已成功测试和失败测试的信息。TestResult 对象存储一组测试的结果。 TestRunner.run() 方法返回一个 TestResult 实例。

TestResult 实例具有以下属性 −

以下代码执行测试套件 −

if __name__ == '__main__':
   runner = unittest.TextTestRunner()
   test_suite = suite()
   result = runner.run (test_suite)
   
   print "---- START OF TEST RESULTS"
   print result

   print "result::errors"
   print result.errors

   print "result::failures"
   print result.failures

   print "result::skipped"
   print result.skipped

   print "result::successful"
   print result.wasSuccessful()
   
   print "result::test-run"
   print result.testsRun
   print "---- END OF TEST RESULTS"

代码执行后显示以下输出 −

---- START OF TEST RESULTS
<unittest.runner.TextTestResult run = 2 errors = 0 failures = 1>
result::errors
[]
result::failures
[(<__main__.suiteTest testMethod = testadd>, 'Traceback (most recent call last):

   File "test3.py", line 10, in testadd
 
   self.assertTrue(result == 100)
Assert
   ionError: False is not true
')]
result::skipped
[]
result::successful
False
result::test-run
2
---- END OF TEST RESULTS