一、什么是Unittest框架
unittest是python自带的一个单元测试框架,不仅适用于单元测试,还可用于Web、Appium、接口自动化测试用例的开发与执行;此框架可以组织执行测试用例,并且提供了丰富的断言方法,判断测试用例是否执行通过,并生成测试结果。
二、Unittest框架原理
Unittest框架最核心的四个概念:
test case:测试用例test suite:测试套件test runner: 用来执行测试用例和测试套件,并返回测试用例的执行结果TestLoader:批量执行测试用例test fixure:测试夹具三、Unittest的使用
3.1 TestCase 测试用例
当我们在写接口用例的时候,会继承 unittest 当中的 TestCase 的类和方法,可以用来创建新的测试用例,一个TestCase的实例就是一个测试用例,unittest中的测试用例都是以 “test” 开头,并且它的执行顺序是按照方法名的ASCII值进行排序。
# test_001.pyimport unittestdef add(x, y): return x + yclass Test_Case_01(unitest.TestCase): # 新建测试类必须继承unittest.TestCase # 测试方法名称必须以 test 开头 def test_add_01(self): result = add(2, 4) print(f'两数和为:{result}') def test_add_02(self): result = add(5, 7) print(f'两数之和为:{result}')if __name__ == '__main__': # 执行测试用例 unittest.main()
3.2 TestSuite
一个功能的验证往往需要多个测试用例,可以把多个测试用例集合在一起执行,这就产生了TestSuite的概念。我们可以把它理解成一个篮子,篮子里面放了很多东西(test case)。使用addTest来加载TestCase到TestSuite中。
testsuit的使用:
(1)实例化:suite = unittest.TestSuite()
(2)添加用例:suite.addTest(ClassName(“MethodName”))
(ClassName:类名,MethodName:方法名)
(3)添加扩展:suite.addTest(unittest.makeSuite(ClassName))
(搜索指定ClassName内 test 开头的方法,并添加到测试套件中)
提示: TestSuite需要配合TestRunner才能被执行
# 公众号:大森玩测试# 案例import unittestfrom test_001 import Test_Case_01# 实例化测试套件对象suite = unittest.TestSuite()# 单独添加测试用例suite.addTest(Test_Case_01("test_add_01"))suite.addTest(Test_Case_01("test_add_02"))# 批量添加用例, addTest()添加的次数根据Test_Case_01中的测试用例个数决定,这里是添加2次suite.addTest(unittest.makeSuite(Test_Case_01))# 执行runner = unittest.TextTestRunner()runner.run(suite)
3.3 TextTestRunner
用来执行测试用例和测试套件,并返回测试用例的执行结果。在unittest单元测试框架中,通过TextTestRunner类提供的run()方法来执行test suite/test case。它还可以用图形或者文本接口,把返回的测试结果更形象的展现出来,如:HTMLTestRunner。
使用:
(1)实例化:runner = unittest.TextTestRunner()
(2)执行:runner.run(suite) # suite为测试套件的名称,可以参考上文的代码
# 示例代码可以参考3.2 TestSuite 的案例,这里不再赘述
3.4 TestLoader
用来加载TestCase到TestSuite中,即加载满足条件的测试用例,并把测试用例封装成测试套件。
使用unittest.TestLoader(),通过该类下面的discover()方法自动搜索指定目录下指定开头的 .py 文件,并将查到的测试用例组装到测试套件。
# 示例# 公众号:大森玩测试import osimport unittest# 获取根目录BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) # 获取文件的根目录# 测试用例地址test_case_path = os.path.join(BASE_DIR, "Scripts")suit = unittest.TestSuite()loader = unittest.TestLoader() # 专门用来查找用例的实例# test_case_path:测试用例的所在路径。pattern:搜索以test开头的py文件,默认为‘test*.py’suit.addTests(loader.discover(test_case_path, pattern="test*.py"))runner = unittest.TextTestRunner()runner.run(suit)
注意: 也可以使用unittest.defaultTestLoader 代替 unittest.TestLoader()
discover = unittest.defaultTestLoader.discover(test_case_path, pattern="t*.py")suit.addTests(discover)
TestSuite和TestLoader的区别
共同点:都是测试套件
不同点:实现方式不同
(1) TestSuite需要手动添加测试用例(可以添加测试类,也可以添加测试类中的某个测试方法)
(2)TestLoader搜索指定目录下指定开头的py文件,并添加测试类中的所有测试方法,不能指定添加某个测试方法
3.5 Fixture
是对一个测试用例环境的初始化和销毁操作。即执行测试用例前准备环境的搭建(前置-SetUp),以及测试后环境的还原(后置-TearDown)。
控制级别:
(1)函数级别
def setUp() / def tearDown()
特性:几个测试函数,被执行几次。每个测试函数执行之前都会执行setUp,执行之后都会执行tearDown(运行一次测试方法就会运行一次 setUp 和 tearDown)
(2)类级别
def setUpClass() / def tearDownClass()
特性:测试类运行之前运行一次setUpClass;类运行之后运行一次tearDownClass
注意: 类方法必须使用 @classmethod装饰
(3)模块级别
def setUpModule() / def tearDownModule()
特性:模块运行之前执行一次 setUpModule;模块运行之后执行一次 tearDownModule
# 示例# 公众号:大森玩测试import timeimport unittestfrom selenium import webdriverclass Test_Tmall_Login(unittest.TestCase): def setUp(self) -> None: # 获取Chrome浏览器驱动对象 self.driver = webdriver.Chrome() # 打开url self.driver.get("http://www.tmall.com") # 窗口最大化 self.driver.maximize_window() # 隐式等待 self.driver.implicitly_wait(30) def tearDown(self) -> None: # 等待3秒,关闭浏览器 time.sleep(3) self.driver.quit() def test_login(self): driver = self.driver # 输入用户名 driver.find_element(by="id", value="username").send_keys("test001") # 输入密码 driver.find_element(by="id", value="password").send_keys("admin001") # 点击登录按钮 driver.find_element(by="name", value="sbtbutton").click()
四、断言
1)什么是断言
让程序代替人工自动的判断预期结果和实际结果是否相符
2)为什么要学习断言
自动化脚本在执行的时候一般都是无人值守状态,我们不知道执行的结果是否符合预期结果,所以需要让程序代替人工检测程序执行的结果是否符合预期结果,这个时候就需要用到断言。
3) Unittest常用断言方法
注意: 如果断言失败(用例执行不通过)就会抛出一个AssertionError断言错误,成功则标识为通过,以上几种方式都有一个共同点,就是都有一个msg参数,默认是None,即msg = None,如果指定msg参数的值,则将该信息作为失败的错误信息返回。
断言方法在unittest.TestCase类中已经定义好了,我们自定义的测试类已经继承了 TestCase ,所以在测试方法中直接调用即可。
# 示例# 公众号:大森玩测试import unittestdef add(x, y): return x + yclass Test_Assert(unittest.TestCase): def setUp(self): print("前置操作") def tearDown(self): print("后置操作") # 测试用例 def test_01(self): result = add(2, 4) # 断言 self.assertEqual(2, result) def test_02(self): result = add(5, 7) is_ok = result == 12 self.assertTrue(is_ok) def test_03(self): result = add(2, 3) result = str(result) self.assertIn(result, "1234567")
五、参数化
1)通过参数的方式来传递数据,从而实现数据和脚本分离,也可以把测试数据定义到数据文件或者数据库中
2)针对同一个测试方法,可以实现用例的重复执行,减少代码冗余,提高测试效率
3) unittest测试框架,本身不支持参数化,但是可以通过安装扩展插件parameterized来实现
安装
pip install parameterized
使用方式
导包:from parameterized import parameterized
修饰测试函数 @parameterized.expand([数据])
数据格式:
单个参数:类型为列表
多个参数:类型为列表嵌套元组
在测试函数中的参数设置变量引用参数值,注意:变量的数量必须和数据值的个数相同
六、跳过
对于一些未完成的或者不满足测试条件的测试函数和测试类,可以跳过执行。
使用方式
1.直接将测试函数标记成跳过
@unittest.skip('代码未完成')
2.根据条件判断测试函数是否跳过
@unittest.skipIf(condition, reason)
七、生成HTML测试报告
测试脚本执行完后,可以生成以 HTML( 网页 ) 格式的测试报告。
这里给大家推荐一个个人感觉不错的HTMLTestRunner版本——XTestRunner
安装方式:
pip install XTestRunner
或
pip install -U git+https://github.com/SeldomQA/XTestRunner.git@master
使用:
# 注意:生成HTML报告,必须使用wb,以二进制形式写入with open(report_dir, "wb") as f : HTMLTestRunner(stream=f, verbosity=2, title="XXX自动化测试报告", description="欢迎关注公众号:大森玩测试")