目录/第 63 章 · unittest 与 doctest
第 63 章 / 70 · 工程 · 测试与第三方

unittest 与 doctest

标准库自带的测试工具

先介绍1 个 demo6 个任务答案可展开

一、本章介绍

课堂第 13 章 13.10 节讲了 unittest 和 doctest:不需要额外安装就能写测试。unittest 用类和 assert 方法,doctest 把测试写在文档字符串里。

这一章从最简单的断言到测试用例,掌握标准库测试的基本用法。

本章要点

  • unittest.TestCase
  • assertEqual 断言
  • doctest 文档测试
  • test_ 命名约定

二、先看 demo

下面这个例子把本章涉及的用法尽量全面地串了一遍,代码带逐行注释,可以直接复制到本地 .py 文件运行。

案例

先看一个完整例子

介绍 · 逐行注释
import unittest

class TestMath(unittest.TestCase):
    def test_add(self):
        self.assertEqual(1+1, 2)
    def test_upper(self):
        self.assertEqual("hi".upper(), "HI")

# 直接运行测试
suite = unittest.defaultTestLoader.loadTestsFromTestCase(TestMath)
r = unittest.TextTestRunner(verbosity=0).run(suite)
print("通过数:", r.testsRun, "失败数:", len(r.failures))
运行结果
通过数: 2 失败数: 0

要点:unittest 用 TestCase 类 + assertEqual 断言;test_ 开头的方法会被自动发现;TextTestRunner 运行结果对象里有 testsRun 等统计。

三、6 个任务(自己先写,再看答案)

难度从入门到挑战逐步增加。每个任务的答案默认折叠,点开可看参考代码、运行结果;有第二种解法的也一并给出。代码都可以直接运行。

任务 1

断言相等

自己写 · 附答案入门 ★☆☆
解题提示:本题主要用到 unittest.TestCase、assertEqual 断言、doctest 文档测试。先对照要求自己写一遍,卡住了再展开答案。

用 unittest 的 assertEqual 判断 2*3==6

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import unittest
class T(unittest.TestCase):
 def test_a(self): self.assertEqual(2*3,6)
s=unittest.TestSuite([T('test_a')])
r=unittest.TextTestRunner(verbosity=0).run(s)
print(len(r.failures)==0)
运行结果
True
参考答案二(另一种解法)
print(2*3==6)
任务 2

断言为真

自己写 · 附答案入门 ★☆☆
解题提示:本题主要用到 unittest.TestCase、assertEqual 断言、doctest 文档测试。先对照要求自己写一遍,卡住了再展开答案。

用 assertTrue 判断 5>3

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import unittest
class T(unittest.TestCase):
 def test_a(self): self.assertTrue(5>3)
s=unittest.TestSuite([T('test_a')])
print(len(unittest.TextTestRunner(verbosity=0).run(s).failures)==0)
运行结果
True
参考答案二(另一种解法)
print(5>3)
任务 3

断言不等

自己写 · 附答案进阶 ★★☆
解题提示:本题主要用到 unittest.TestCase、assertEqual 断言、doctest 文档测试。先对照要求自己写一遍,卡住了再展开答案。

用 assertNotEqual 判断 1!=2

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import unittest
class T(unittest.TestCase):
 def test_a(self): self.assertNotEqual(1,2)
s=unittest.TestSuite([T('test_a')])
print(len(unittest.TextTestRunner(verbosity=0).run(s).failures)==0)
运行结果
True
参考答案二(另一种解法)
print(1!=2)
任务 4

测试数量

自己写 · 附答案进阶 ★★☆
解题提示:本题主要用到 unittest.TestCase、assertEqual 断言、doctest 文档测试。先对照要求自己写一遍,卡住了再展开答案。

上面的 TestCase 有 2 个 test_ 方法,统计 testsRun

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import unittest
class T(unittest.TestCase):
 def test_a(self):pass
 def test_b(self):pass
s=unittest.defaultTestLoader.loadTestsFromTestCase(T)
print(unittest.TextTestRunner(verbosity=0).run(s).testsRun)
运行结果
2
参考答案二(另一种解法)
print(2)
任务 5

doctest示例

自己写 · 附答案挑战 ★★★
解题提示:本题主要用到 unittest.TestCase、assertEqual 断言、doctest 文档测试。先对照要求自己写一遍,卡住了再展开答案。

用 doctest 解析并执行文档字符串 '>>> 1+1\n2',看是否通过

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import doctest
t=doctest.DocTestParser().get_doctest(">>> 1+1\n2",{},"t",None,0)
r=doctest.DocTestRunner(verbose=False).run(t,out=lambda s:None)
print(r.failed)
运行结果
0
参考答案二(另一种解法)
import doctest
doc=">>> 1+1\n2"
t=doctest.DocTestParser().get_doctest(doc,{},"t",None,0)
print(doctest.DocTestRunner(verbose=False).run(t,out=lambda s:None).failed)
任务 6

doctest失败

自己写 · 附答案挑战 ★★★
解题提示:本题主要用到 unittest.TestCase、assertEqual 断言、doctest 文档测试。先对照要求自己写一遍,卡住了再展开答案。

doctest 测试错误示例,打印 failed 数

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import doctest
t=doctest.DocTestParser().get_doctest(">>> 1+1\n3",{},"t",None,0)
r=doctest.DocTestRunner(verbose=False).run(t,out=lambda s:None)
print(r.failed)
运行结果
1
参考答案二(另一种解法)
import doctest
doc=">>> 1+1\n3"
t=doctest.DocTestParser().get_doctest(doc,{},"t",None,0)
print(doctest.DocTestRunner(verbose=False).run(t,out=lambda s:None).failed)