目录
unittest是一个Python版本的Junit,Junit是Java中的单元测试框架;
本章我们学习单元测试框架unittest,这里的单元测试指的是对最小的软件设计单元(模块)进行验证,在UI自动化测试里面,我们的单元测试主要针对UI界面的功能进行自动化测试。所以这里大家要注意不要和Java的Junit单元测试框架搞混;
unittest 是python 的单元测试框架,它主要有以下作用:
提供用例组织与执行:当你的测试用例只有几条时,可以不必考虑用例的组织,但是,当测试用例达到成百上千条时,大量的测试用例堆砌在一起,就产生了扩展性与维护性等问题,此时需要考虑用例的规范与组织问题了。单元测试框架就是来解决这个问题的。
提供丰富的比较方法:在用例执行完之后都需要将实际结果与预期结果进行比较(断言),从而断定用例是否可以顺利通过。单元测试一般会提供丰富的断言方法。例如,判断相等/不相等、包含/不包含、True/False等断言方法。
提供丰富的日志:当测试用例执行失败时能抛出清晰的失败原因,当所有用例执行完成后能提供丰富的执行结果。例如,总的执行时间,失败用例数,成功用例数等。
unittest里面有四个很重要的概念,test fixture,test case,test suite,test runner。
对一个测试用例环境的搭建和销毁,就是一个fixture,通过覆盖setUp()和tearDown()方法来实现。
setUp()方法可以进行测试环境的搭建,比如获取待测试浏览器的驱动,或者如果测试中需要访问数据库,那么可以在setUp()中通过建立数据库连接来进行初始化。
tearDown()方法进行环境的销毁,可以进行关闭浏览器,关闭数据库连接,清除数据库中产生的数据等操作。
一个TestCase的实例就是一个测试用例。测试用例就是一个完整的测试流程,包括测试前准备环境的搭建(setUp)、实现测试过程的代码,以及测试后环境的还原(tearDown)。单元测试(unit test)的本质就在这里,一个测试用例就是一个完整的测试单元,可以对某一个功能进行验证。
一个功能的验证往往需要多个测试用例,可以把多个测试用例集合在一起执行,这个就产生了测试套件TestSuite的概念。Test Suit用来将多个测试用例组装在一起;
测试的执行也是非常重要的一个概念,在unittest框架中,通过TextTestRunner类提供的run()方法来执行test suite/test case。
下面是一个使用了unittest框架的脚本:
- from selenium import webdriver
- import unittest
- import time
- import os
- from selenium.common.exceptions import NoAlertPresentException
- from selenium.common.exceptions import NoSuchElementException
-
- class Baidu1(unittest.TestCase):
- def setUp(self):
- print("-----setUp-----")
- self.driver = webdriver.Chrome()
- self.url = "https://www.baidu.com/"
- self.driver.maximize_window()
- time.sleep(3)
-
- def tearDown(self):
- print("-----tearDown-----")
- self.driver.quit()
-
- def test_hao(self):
- driver = self.driver
- url = self.url
- driver.get(url)
- driver.find_element_by_link_text("hao123").click()
- time.sleep(6)
-
- def test_hbaidu(self):
- driver = self.driver
- url = self.url
- driver.get(url)
- driver.find_element_by_id("kw").send_keys("突如其来的假期")
- driver.find_element_by_id("su").submit()
- time.sleep(5)
- print(driver.title)
- # self.assertNotEqual(driver.title, "百度一下_百度搜索", msg="不相等")
- # self.assertTrue("beautiful"=="beauty", msg="Not Equal!")
- time.sleep(6)
-
- def saveScreenAsPhoto(self, driver, file_name):
- if not os.path.exists("./image"):
- os.makedirs("./image")
- now = time.strftime("%Y%m%d-%H%M%S", time.localtime(time.time()))
- driver.get_screenshot_as_file("./image/" + now + "-" + file_name)
- time.sleep(3)
-
- if __name__ == "__main__":
- unittest.main()
(1)测试固件(框架里面固定的方法)
setUp() 方法,测试环境和数据的装备工作;tearDown() 方法,测试执行完以后的清理工作。
(2)测试用例
以 def test_ 开头命名的方法,是测试方法,在运行整个类的时候会默认执行,一个用例就是一个方法。
(3)测试套件
把测试用例组织到一起进行一个整体的测试,必须以继承的方式来使用。
unittest提供了全局的main()方法,使用它可以方便地将一个单元测试模块变成可以直接运行的测试脚本。main()方法搜索所有包含在该模块中以”test"命名的测试方法,并自动执行他们。
当我们增加了被测试功能和相应的测试用例之后,我们就需要把多个测试用例组织在一起执行,那
unittest框架是如何扩展和组织新增的测试用例的呢?它使用的就是上文中提到的测试套件Test Suite
假设我们已经编写了testbaidu1.py,testbaidu2.py两个文件,那么我们怎么同时执行这两个文件呢?
testbaidu1.py
- from selenium import webdriver
- import unittest
- import time
- import os
- from selenium.common.exceptions import NoAlertPresentException
- from selenium.common.exceptions import NoSuchElementException
- class Baidu1(unittest.TestCase):
-
- def setUp(self):
- self.driver = webdriver.Firefox()
- self.url = "https://www.baidu.com/"
- self.driver.maximize_window()
- time.sleep(3)
-
- def tearDown(self):
- self.driver.quit()
-
- def test_hao(self):
- driver = self.driver
- url = self.url
- driver.get(url)
- driver.find_element_by_link_text("hao123").click()
- time.sleep(6)
-
- def test_hbaidu(self):
- driver = self.driver
- url = self.url
- driver.get(url)
- driver.find_element_by_id("kw").send_keys("突如其来的假期")
- driver.find_element_by_id("su").submit()
- time.sleep(5)
- print(driver.title)
- time.sleep(6)
-
- def saveScreenAsPhoto(self, driver, file_name):
- if not os.path.exists("./image"):
- os.makedirs("./image")
- now = time.strftime("%Y%m%d-%H%M%S", time.localtime(time.time()))
- driver.get_screenshot_as_file("./image/" + now + "-" + file_name)
- time.sleep(3)
-
- if __name__ == "__main__":
- unittest.main()
testbaidu2.py
- from selenium import webdriver
- import unittest
- import time
- from selenium.common.exceptions import NoAlertPresentException
- from selenium.common.exceptions import NoSuchElementException
-
- class Baidu2 (unittest.TestCase) :
-
- def setUp(self):
- self.driver = webdriver.Chrome()
- self.driver.implicitly_wait(30)
- self.base_url = "http://www.baidu.com/"
- self.driver.maximize_window()
- self.verificationErrors=[]
- self.accept_next_alert = True
-
- def tearDown(self):
- self.driver.quit()
- self.assertEqual([], self.verificationErrors)
-
- def test_hao(self):
- driver = self.driver
- driver.get(self.base_url)
- driver.find_element_by_link_text("新闻").click()
- time.sleep(6)
- self.assertTrue("123" == "1234", msg="not true")
- time.sleep(3)
-
- def test_baidusearch(self):
- driver = self.driver
- driver.get(self.base_url)
- driver.find_element_by_id("kw").clear()
- driver.find_element_by_id("kw").send_keys(u"庆余年")
- driver.find_element_by_id("su").click()
- time.sleep(6)
-
- def is_element_present(self, how, what):
- try:
- self.driver.find_element(by=how, value=what)
- except NoSuchElementException as e:
- return False
- return True
-
- def is_alert_present(self):
- try:
- self.driver.switch_to.alert
- except NoAlertPresentException as e:
- return False
- return True
-
- def close_alert_and_get_its_text(self):
- try:
- alert = self.driver.switch_to.alert
- alert_text = alert.text
- if self.accept_next_alert:
- alert.accept()
- else:
- alert.dismiss()
- return alert_text
- finally: self.accept_next_alert = True
-
- if __name__ == "__main__":
- unittest.main(verbosity=2)
addTest()
TestSuite类的addTest()方法可以把不同的测试类中的测试方法组装到测试套件中,但是addTest()一次只能把一个类里面的一个测试方法组装到测试套件中。
方式如下:将testbaidu1.py、testbaidu2.py中的测试方法放到一个测试套件中,在testsuite.py中实现。
testsuite.py
- import unittest
-
- from src.Test import testbaidu1, testbaidu2
-
- def createsuite():
- # addTeat
- suite = unittest.TestSuite()
- suite.addTest(testbaidu1.Baidu1("test_hao"))
- suite.addTest(testbaidu1.Baidu1("test_hbaidu"))
- suite.addTest(testbaidu2.Baidu2("test_hao"))
- suite.addTest(testbaidu2.Baidu2("test_baidusearch"))
- return suite
-
-
- if __name__ == "__main__":
- suite = createsuite()
- runner = unittest.TextTestRunner(verbosity=2)
- runner.run(suite)
但是上述做法有两个不方便的地方,阻碍脚本的快速执行,必须每次修改testsuite.py:
makeSuite()和TestLoader()的应用
在unittest 框架中提供了makeSuite() 的方法,makeSuite可以实现把测试用例类内所有的测试case组成的测试套件TestSuite ,unittest 调用makeSuite的时候,只需要把测试类名称传入即可。
TestLoader 用于创建类和模块的测试套件,一般的情况下,使TestLoader().loadTestsFromTestCase(TestClass) 来加载测试类。
runall.py
- import unittest
-
- import testbaidu1
- import testbaidu2
-
-
- # 手工添加案例到套件,
- def createsuite():
- suite = unittest.TestSuite()
- # 将测试用例加入到测试容器(套件)中
- suite.addTest(unittest.makeSuite(testbaidu1.Baidu1))
- suite.addTest(unittest.makeSuite(testbaidu2.Baidu2))
- return suite
- '''
- suite1 = unittest.TestLoader().loadTestsFromTestCase(testbaidu1.Baidu1)
- suite2 = unittest.TestLoader().loadTestsFromTestCase(testbaidu2.Baidu2)
- suite = unittest.TestSuite([suite1, suite2])
- return suite
- '''
-
-
- if __name__ == "__main__":
- suite = createsuite()
- runner = unittest.TextTestRunner(verbosity=2)
- runner.run(suite)
经过makeSuite()和TestLoader()的引入,我们不用一个py文件测试类,只需要导入一次即可。那么能不能测试类也不用每次添加指定呢?
discover()的应用
discover 是通过递归的方式到其子目录中从指定的目录开始, 找到所有测试模块并返回一个包含它们对象的TestSuite ,然后进行加载与模式匹配唯一的测试文件,discover 参数分别为discover(dir,pattern,top_level_dir=None)
runall1.py
- import unittest, csv
- import os, sys
- import time
-
-
- # 手工添加案例到套件,
- def createsuite():
- discover = unittest.defaultTestLoader.discover('../test', pattern='test*.py', top_level_dir=None)
- print(discover)
- return discover
-
-
- if __name__ == "__main__":
- suite = createsuite()
- runner = unittest.TextTestRunner(verbosity=2)
- runner.run(suite)
unittest 框架默认加载测试用例的顺序是根据ASCII 码的顺序,数字与字母的顺序为: 0~9,A~Z,a~z 。
所以, TestAdd 类会优先于TestBdd 类被发现, test_aaa() 方法会优先于test_ccc() 被执行。对于测试目录与测试文件来说, unittest 框架同样是按照这个规则来加载测试用例。
addTest()方法按照增加顺序来执行。
- from selenium import webdriver
- from selenium.webdriver.common.by import By
- from selenium.webdriver.common.keys import Keys
- from selenium.webdriver.support.ui import Select
- from selenium.common.exceptions import NoSuchElementException
- from selenium.common.exceptions import NoAlertPresentException
- import unittest, time, re
-
-
- class Baidu1(unittest.TestCase):
- # test fixture,初始化环境
- def setUp(self):
- self.driver = webdriver.Firefox()
- self.driver.implicitly_wait(30)
- self.base_url = "http://www.baidu.com/"
- self.verificationErrors = []
- self.accept_next_alert = True
-
- @unittest.skip("skipping")
- def test_baidusearch(self):
- driver = self.driver
- driver.get(self.base_url + "/")
- driver.find_element_by_id("kw").click()
- driver.find_element_by_id("kw").clear()
- driver.find_element_by_id("kw").send_keys(u"测试")
- driver.find_element_by_id("su").click()
- driver.find_element_by_id("su").click()
-
- def test_hao(self):
- driver = self.driver
- driver.get(self.base_url + "/")
- driver.find_element_by_link_text("hao123").click()
- self.assertEqual(u"hao123_上网从这里开始", driver.title)
-
- # 判断element是否存在,可删除
- def is_element_present(self, how, what):
- try:
- self.driver.find_element(by=how, value=what)
- except NoSuchElementException as e:
- return False
- return True
-
- # 判断alert是否存在,可删除
- def is_alert_present(self):
- try:
- self.driver.switch_to_alert()
- except NoAlertPresentException as e:
- return False
- return True
-
- # 关闭alert,可删除
- def close_alert_and_get_its_text(self):
- try:
- alert = self.driver.switch_to_alert()
- alert_text = alert.text
- if self.accept_next_alert:
- alert.accept()
- else:
- alert.dismiss()
- return alert_text
- finally:
- self.accept_next_alert = True
-
- # test fixture,清除环境
- def tearDown(self):
- self.driver.quit()
- self.assertEqual([], self.verificationErrors)
-
- if __name__ == "__main__":
- # 执行用例
- unittest.main()
自动化的测试中, 对于每个单独的case来说,一个case的执行结果中, 必然会有期望结果与实际结果, 来判断该case是通过还是失败, 在unittest 的库中提供了大量的实用方法来检查预期值与实际值, 来验证case的结果, 一般来说, 检查条件大体分为等价性, 逻辑比较以及其他, 如果给定的断言通过, 测试会继续执行到下一行的代码, 如果断言失败, 对应的case测试会立即停止或者生成错误信息( 一般打印错误信息即可) ,但是不要影响其他的case执行。
unittest 的单元测试库提供了标准的xUnit 断言方法。下面是一些常用的断言:
脚本执行完毕之后,还需要看到HTML报告,下面我们就通过HTMLTestRunner.py 来生成测试报告。HTMLTestRunner支持python2.7。python3可以参见http://blog.51cto.com/hzqldjb/1590802来进行修改。
HTMLTestRunner.py 文件,下载地址: http://tungwaiyip.info/software/HTMLTestRunner.html
下载后将其放在testcase目录中去或者放入...\Python27\Lib 目录下(windows)。
修改runall1.py
- import HTMLTestRunner
- import os
- import sys
- import time
- import unittest
-
-
- # 手工添加案例到套件,
- def createsuite():
- discover = unittest.defaultTestLoader.discover('../test', pattern='test*.py', top_level_dir=None)
- print(discover)
- return discover
-
-
- if __name__ == "__main__":
- curpath = sys.path[0]
- # 取当前时间
- now = time.strftime("%Y-%m-%d-%H %M %S", time.localtime(time.time()))
-
- if not os.path.exists(curpath + '/resultreport'):
- os.makedirs(curpath + '/resultreport')
- filename = curpath + '/resultreport/' + now + 'resultreport.html'
- with open(filename, 'wb') as fp:
- # 出html报告
- runner = HTMLTestRunner.HTMLTestRunner(stream=fp, title=u'测试报告', description=u'用例执行情况', verbosity=2)
- suite = createsuite()
- runner.run(suite)