Python 的 unittest
框架是用于编写和运行可重复的测试的一个强大工具。它允许你定义测试用例、测试套件、测试运行器和测试固件(fixtures),从而系统化地测试你的代码。以下是如何使用 unittest
框架来编写和运行单元测试的基本步骤:
1. 导入 unittest 模块
首先,你需要在你的测试脚本中导入 unittest
模块。
python复制代码
import unittest |
2. 编写测试用例
然后,你需要创建一个继承自 unittest.TestCase
的类,并在其中编写你的测试方法。测试方法必须以 test
开头,这样 unittest
框架才能识别并运行它们。
python复制代码
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']) | |
# 检查带有分隔符的分割 | |
with self.assertRaises(TypeError): | |
s.split(2) |
3. 编写测试套件(可选)
如果你需要组织多个测试用例,可以将它们添加到测试套件中。这通常在你有很多测试用例分布在不同的测试类中时很有用。
python复制代码
# 假设你有另一个测试类 TestAnotherModule | |
from another_module_tests import TestAnotherModule | |
def suite(): | |
suite = unittest.TestSuite() | |
suite.addTest(unittest.makeSuite(TestStringMethods)) | |
suite.addTest(unittest.makeSuite(TestAnotherModule)) | |
return suite |
注意:从 Python 3.4 开始,你可以使用 unittest.TestLoader
来更简单地加载测试。
4. 运行测试
有几种方法可以运行你的测试:
使用命令行
你可以使用 Python 自带的 -m unittest
选项来运行你的测试。只需在命令行中指定包含测试用例的模块或文件即可。
bash复制代码
python -m unittest test_module.py |
或者,如果你已经定义了一个测试套件,可以在模块中这样运行它:
python复制代码
if __name__ == '__main__': | |
runner = unittest.TextTestRunner() | |
runner.run(suite()) |
使用 IDE
大多数现代的 Python IDE(如 PyCharm、VS Code 等)都内置了对 unittest
的支持,允许你直接在 IDE 中运行和调试测试。
5. 测试固件
测试固件(fixtures)是测试运行之前和之后运行的代码,用于设置和清理测试环境。unittest
提供了几种设置和清理测试环境的方法,包括 setUp()
, tearDown()
, setUpClass()
, 和 tearDownClass()
。
python复制代码
class TestStringMethods(unittest.TestCase): | |
@classmethod | |
def setUpClass(cls): | |
print("Setup class once") | |
def setUp(self): | |
print("Setup before each test") | |
def test_upper(self): | |
self.assertEqual('foo'.upper(), 'FOO') | |
def tearDown(self): | |
print("Teardown after each test") | |
@classmethod | |
def tearDownClass(cls): | |
print("Teardown class once") |
通过以上步骤,你可以有效地使用 unittest
框架来编写和运行你的单元测试,从而确保你的代码质量。