3.1 unittest简介

前言

(python基础比较弱的，建议大家多花点时间把基础语法学好，这里有套视频，可以照着练习下：http://pan.baidu.com/s/1i44jZdb 密码：92fs)

熟悉java的应该都清楚常见的单元测试框架Junit和TestNG，这个招聘的需求上也是经常见到的。python里面也有单元测试框架-unittest,相当于是一个python版的junit。

python里面的单元测试框架除了unittest,还有一个pytest框架，这个用的比较少，后面有空再继续分享。

3.1.1 unittest简介

1).先导入unittest

2).用help函数查看源码解析

3).查看描述：

Python unit testing framework, based on Erich Gamma's JUnit and KentBeck's Smalltalk testing framework.

翻译：python的单元测试框架，是基于java的junit测试框架。

3.1.2 简单用法

1).可以把上图的这段代码copy出来，单独运行，看看测试结果。

Simple usage:

importunittestclassIntegerArithmeticTestCase(unittest.TestCase):

deftestAdd(self):## test method names begin 'test*'

self.assertEqual((1 + 2), 3)

self.assertEqual(0+ 1, 1)

deftestMultiply(self):

self.assertEqual((0* 10), 0)

self.assertEqual((5 * 8), 40)if __name__ == '__main__':

unittest.main()

2).第一行是导入unittest这个模块

3).class这一行是定义一个测试的类，并继承unittest.TestCase这个类

4).接下来是定义了两个测试case名称:testAdd和testMultiply

5).注释里面有句话很重要，这个要敲下黑板记笔记了：## test method names begin 'test*'

--翻译：测试用例的名称要以test开头

6).然后是断言assert，这里的断言方法是assertEqual-判断两个是否相等，

这个断言可以是一个也可以是多个

7).if下面的这个unittest.main()是运行主函数，运行后会看到测试结果(跑了两个用例耗时0.000秒,两个用例都通过)：

----------------------------------------------------------------------

Ran 2 tests in 0.000s

OK

3.1.3 小试牛刀

1).上面的两个案例是加法和乘法，我们可以写个case试下减法和除法。

2).有很多小伙伴不知道断言怎么写，断言其实就是拿实际结果和期望结果去对比，对比的方法很多，这里只是举的最简单的一个判断相等的方法。

3).最后运行结果，第二个是失败的，失败原因：AssertionError: 3 != 3.5

F.

======================================================================

FAIL: testDivide (__main__.Test)

这里是测试除法

----------------------------------------------------------------------

Traceback (most recent call last):

File "D:/test/web-project/p.py", line 14, in testDivide

self.assertEqual(result, hope)

AssertionError: 3 != 3.5

----------------------------------------------------------------------

Ran 2 tests in 0.000s

FAILED (failures=1)

3.1.4 前置和后置

1).setUp：在写测试用例的时候，每次操作其实都是基于打开浏览器输入对应网址这些操作，这个就是执行用例的前置条件。

2).tearDown：执行完用例后，为了不影响下一次用例的执行，一般有个数据还原的过程，这就是执行用例的后置条件。

3).很多人执行完用例，都不去做数据还原，以致于下一个用例执行失败，这就是不喜欢擦屁股的事情，习惯不好。

4).前置和后置都是非必要的条件，如果没有也可以写pass

3.1.5 博客案例

1).打开博客首页为例，写一个简单的case

2).判断title完全等于期望结果

3).运行通过，下面会有一个绿条显示：1 test passed

3.1.6 参考代码

#coding=utf-8

from selenium importwebdriverfrom selenium.webdriver.support importexpected_conditions as ECimporttimeimportunittestclassBlog(unittest.TestCase):defsetUp(self):

self.driver=webdriver.Firefox()

self.driver.get("http://www.cnblogs.com/yoyoketang")deftest_blog(self):

time.sleep(3)

result= EC.title_is(u'上海-悠悠 - 博客园')(self.driver)printresult

self.assertTrue(result)deftearDown(self):

self.driver.quit()if __name__ == "__main__":

unittest.main()

3.2 unittest执行顺序

前言

很多初学者在使用unittest框架时候，不清楚用例的执行顺序到底是怎样的。对测试类里面的类和方法分不清楚，不知道什么时候执行，什么时候不执行。

本篇通过最简单案例详细讲解unittest执行顺序。

一、案例分析

1.先定义一个测试类，里面写几个简单的case

#coding:utf-8

importunittestimporttimeclassTest(unittest.TestCase):defsetUp(self):print "start!"deftearDown(self):

time.sleep(1)print "end!"deftest01(self):print "执行测试用例01"deftest03(self):print "执行测试用例03"deftest02(self):print "执行测试用例02"defaddtest(self):print "add方法"

if __name__ == "__main__":

unittest.main()

二、执行结果

D:\test\python2\python.exe D:/test/test01.py

start!

执行测试用例01

end!

start!

执行测试用例02

end!

start!

执行测试用例03

end!

.

----------------------------------------------------------------------

Ran 3 tests in 3.001s

OK

三、结果分析

1.执行顺序：

start!-执行测试用例01-end!

start!-执行测试用例02-end!

start!-执行测试用例03-end!

2.从执行结果可以看出几点：

--先执行的前置setUp，然后执行的用例(test*)，最后执行的后置tearDown。

--测试用例(test*)的执行顺序是根据01-02-03执行的，也就是说根据用例名称来顺序执行的。

--addtest(self)这个方法没执行,说明只执行test开头的用例。

四、selenium实例

1.具体实例参考 登录方法(参数化)

#coding:utf-8

from selenium importwebdriverimportunittestimporttimeclassBolg(unittest.TestCase):

u'''登录博客'''defsetUp(self):

self.driver=webdriver.Firefox()

url= "https://passport.cnblogs.com/user/signin"self.driver.get(url)

self.driver.implicitly_wait(30)deflogin(self, username, psw):

u'''这里写了一个登录的方法,账号和密码参数化'''self.driver.find_element_by_id("input1").send_keys(username)

self.driver.find_element_by_id("input2").send_keys(psw)

self.driver.find_element_by_id("signin").click()

time.sleep(3)defis_login_sucess(self):

u'''判断是否获取到登录账户名称'''try:

text= self.driver.find_element_by_id("lnk_current_user").textprinttextreturnTrueexcept:returnFalsedeftest_01(self):

u'''登录案例参考:账号，密码自己设置'''self.login(u"上海-悠悠", u"xxxx")  #调用登录方法

#判断结果

result =self.is_login_sucess()

self.assertTrue(result)deftest_02(self):

u'''登录案例参考:账号，密码自己设置'''self.login(u"上海-悠悠", u"xxxx")  #调用登录方法

#判断结果

result =self.is_login_sucess()

self.assertTrue(result)deftearDown(self):

self.driver.quit()if __name__ == "__main__":

unittest.main()

3.3 unittest批量执行

我们在写用例的时候，单个脚本的用例好执行，那么多个脚本的时候，如何批量执行呢？这时候就需要用到unittet里面的discover方法来加载用例了。

加载用例后，用unittest里面的TextTestRunner这里类的run方法去一次执行多个脚本的用例。

一、新建测试项目

1.pycharm左上角File>New Projetc>Pure Python,在location位置命名一个测试工程的名称：yoyotest,然后保存

2.选中刚才新建的工程右键>New>Python Package>新建一个case文件夹

3.重复第2步的操作，新建一个case的文件夹，在里面添加一个baidu和一个blog的文件夹，里面分别有两个用例的脚本，如下图所示。

test_01,test_02,test_03,test_04是我们写用例的脚本

4.test_01创建完后，打开脚本，写入用例

5.在yoyotest这个项目下面创建一个脚本run_all_case.py，接下来用这个脚本去批量执行所有的用例。

二、diascover加载测试用例

1.discover方法里面有三个参数：

-case_dir:这个是待执行用例的目录。

-pattern：这个是匹配脚本名称的规则，test*.py意思是匹配test开头的所有脚本。

-top_level_dir：这个是顶层目录的名称，一般默认等于None就行了。

2.discover加载到的用例是一个list集合，需要重新写入到一个list对象testcase里，这样就可以用unittest里面的TextTestRunner这里类的run方法去执行。

3.运行后结果如下，就是加载到的所有测试用例了：

, , ,

testMethod=test01>, , , , ,

, , , ]>

三、run测试用例

1.为了更方便的理解，可以把上面discover加载用例的方法封装下，写成一个函数

2.参考代码：

#coding:utf-8

importunittestimportos#用例路径

case_path = os.path.join(os.getcwd(), "case")#报告存放路径

report_path = os.path.join(os.getcwd(), "report")defall_case():

discover=unittest.defaultTestLoader.discover(case_path, pattern="test*.py", top_level_dir=None)print(discover)returndiscoverif __name__ == "__main__":

runner=unittest.TextTestRunner()

runner.run(all_case())

3.4 unittest之装饰器(@classmethod)

前言

前面讲到unittest里面setUp可以在每次执行用例前执行，这样有效的减少了代码量，但是有个弊端，比如打开浏览器操作，每次执行用例时候都会重新打开，这样就会浪费很多时间。

于是就想是不是可以只打开一次浏览器，执行完用例再关闭呢？这就需要用到装饰器(@classmethod)来解决了。

一、装饰器

1.用setUp与setUpClass区别

setup():每个测试case运行前运行

teardown():每个测试case运行完后执行

setUpClass():必须使用@classmethod 装饰器,所有case运行前只运行一次

tearDownClass():必须使用@classmethod装饰器,所有case运行完后只运行一次

2.@是修饰符，classmethod是python里的类方法

二、执行顺序

1.用类方法写几个简单case，可以对比这篇：Selenium2+python自动化52-unittest执行顺序

#coding:utf-8

importunittestimporttimeclassTest(unittest.TestCase):

@classmethoddefsetUpClass(cls):print "start!"@classmethoddeftearDownClass(cls):

time.sleep(1)print "end!"deftest01(self):print "执行测试用例01"deftest03(self):print "执行测试用例03"deftest02(self):print "执行测试用例02"defaddtest(self):print "add方法"

if __name__ == "__main__":

unittest.main()

2.从执行结果可以看出，前置和后置在执行用例前只执行了一次。

start!

执行测试用例01

执行测试用例02

执行测试用例03

...end!

----------------------------------------------------------------------

Ran 3 tests in 1.001s

三、selenium实例

1.可以把打开浏览器操作放到前置setUpClass(cls)里，这样就可以实现打开一次浏览器，执行多个case了

#coding:utf-8

from selenium importwebdriverfrom selenium.webdriver.support importexpected_conditions as ECimportunittestclassBolgHome(unittest.TestCase):

u'''博客首页'''@classmethoddefsetUpClass(cls):

cls.driver=webdriver.Firefox()

url= "http://www.cnblogs.com/yoyoketang/"cls.driver.get(url)

cls.driver.implicitly_wait(30)

@classmethoddeftearDownClass(cls):

cls.driver.quit()deftest_01(self):

u'''验证元素存在：博客园'''locator= ("id", "blog_nav_sitehome")

text= u"博客园"result=EC.text_to_be_present_in_element(locator, text)(self.driver)

self.assertTrue(result)deftest_02(self):

u'''验证元素存在：首页'''locator= ("id", "blog_nav_myhome")

text= u"首页"result=EC.text_to_be_present_in_element(locator, text)(self.driver)

self.assertTrue(result)if __name__ == "__main__":

unittest.main()

上述代码运行的顺序就是从上至下，而不再是每次执行完成一个testcase之后，执行一次teardownClass再进行下一个testcase。

这样一来，退出浏览器仅仅执行一次即可，这样有一个不好的地方就是，teardownClass这个函数不能再进行每个测试用例的终结操作，比如：修改个人信息后恢复到登录成功后的状态，对当前测试用例的异常处理等。

后来，本人尝试在tearDownClass后增加如下代码：

deftearDown(self):

self.driver.refresh()

self.assertEqual( [], self.verificationErrors )

然后，果然每次测试用完成都会刷新当前页面，这样一来，每一个testcase的用例都能被终结函数tearDown结束，最后再执行tearDownClass关闭测试浏览器。

需要说明的是：

@classmethod是python本身的装饰器，所以他不要使用隶属于unittest框架下断言assertEqual。

unittest本身也带有装饰器unittest.skip()，专门用于跳过testcase的装饰器，其用法如下：

@unittest.skip(reason)， skip装饰器：直接跳过装饰下的testcase，reason用来说明原因，下同。

@unittest.skipIf(condition,reason)， skipIf装饰器：condition条件为True时，跳过装饰下的testcase，计入skip的testcase执行次数。

@unittest.skipUnless(condition,reason)，skipUnless装饰器：condition条件为False时，跳过装饰下的testcase，计入skip的testcase执行次数。

@unittest.expectedFailure()， expectedFailure装饰器：执行装饰下的testcase，执行失败则跳过该testcase，计入expected下成败的testcase次数。

一般来讲，使用@unittest.skipIf 或者 @unittest.skipUnless，应该也能实现@classmethod装饰器的效果， 想来只是实现起来相对来说较为麻烦。

3.5 unittest生成测试报告HTMLTestRunner

前言

批量执行完用例后，生成的测试报告是文本形式的，不够直观，为了更好的展示测试报告，最好是生成HTML格式的。

unittest里面是不能生成html格式报告的，需要导入一个第三方的模块：HTMLTestRunner

备注：(以下是python2.7的HTMLTestRunner，python3.x的HTMLTestRunner需要自己稍做修改，可以在这里下载：http://pan.baidu.com/s/1hs5OXNY)

一、导入HTMLTestRunner

1.这个模块下载不能通过pip安装了，只能下载后手动导入，下载地址：http://tungwaiyip.info/software/HTMLTestRunner.html

2.Download下HTMLTestRunner.py文件就是我们需要下载的包。

3.下载后手动拖到python安装文件的Lib目录下

二、demo解析

1.下载Download下的第二个文件test_HTMLTestRunner.py,这个就是官方给的一个测试demo了，从这个文件可以找到该模块的用法。

2.找到下图这段，就是官方给的一个demo了，test_main()里上半部分就是加载测试case,我们不需要搞这么复杂。

参考前面一篇内容就行了Selenium2+python自动化53-unittest批量执行(discover)

3.最核心的代码是下面的红色区域，这个就是本篇的重点啦。

三、生成html报告

1.我们只需把上面红色区域代码copy到上一篇的基础上稍做修改就可以了，这里主要有三个参数:

--stream:测试报告写入文件的存储区域

--title:测试报告的主题

--description：测试报告的描述

2.report_path是存放测试报告的地址

四、测试报告详情

1.找到测试报告文件，用浏览器打开，点开View里的Detail可以查看详情描述。

2.为了生成带中文描述的测试用例，可以在case中添加注释，如在test_01的脚本添加如下注释：

classTest(unittest.TestCase):defsetUp(self):print "start!"

deftearDown(self):

time.sleep(1)print "end!"

deftest01(self):

u'''测试登录用例，账号：xx 密码xx'''

print "执行测试用例01"

deftest03(self):

u'''测试登搜索用例，关键词：xxx'''

print "执行测试用例03"

3.重新运行后查看测试报告

五、参考代码：

1.我下面的代码文件路径用的相对路径，这样就避免代码换个地址找不到路径的情况了

#coding:utf-8

importunittestimportosimportHTMLTestRunner#用例路径

case_path = os.path.join(os.getcwd(), "case")#报告存放路径

report_path = os.path.join(os.getcwd(), "report")defall_case():

discover= unittest.defaultTestLoader.discover(case_path, pattern="test*.py", top_level_dir=None)print(discover)returndiscoverif __name__ == "__main__":#runner = unittest.TextTestRunner()

#runner.run(all_case())

#html报告文件路径

report_abspath = os.path.join(report_path, "result.html")

fp= open(report_abspath, "wb")

runner= HTMLTestRunner.HTMLTestRunner(stream=fp, title=u'自动化测试报告,测试结果如下：', description=u'用例执行情况：')#调用add_case函数返回值

runner.run(all_case())

fp.close()

3.6 html报告乱码问题优化

前言

python2用HTMLTestRunner生成测试报告时，有中文输出情况会出现乱码,这个主要是编码格式不统一，改下编码格式就行。

下载地址：http://tungwaiyip.info/software/HTMLTestRunner.html

一、中文乱码

1.测试报告中，msg自定义异常内容有中文情况会出现乱码，如下图所示

二、修改编码

1.找到HTMLTestRunner.py文件，搜索:uo =

2.找到红色区域设置编码的两个地方

3.注释掉红色区域这两个设置，重新添加编码格式为：uo = o.decode('utf-8')   ue = e.decode('utf-8')

4.修改好之后记得保存，重新运行，乱码问题就解决了

三、python3报告问题

1.python3的小伙伴直接用这个下载地址：http://tungwaiyip.info/software/HTMLTestRunner.html的文件，是不能直接生成报告的，需要稍做修改

2.修改后的源文件已经打包：https://files.cnblogs.com/files/zidonghua/HTMLTestRunner%28%E7%8B%AC%E5%AE%B6%E5%90%88%E9%9B%86%29.zip

3.7 unittest之断言

前言

在测试用例中，执行完测试用例后，最后一步是判断测试结果是pass还是fail，自动化测试脚本里面一般把这种生成测试结果的方法称为断言(assert)。

用unittest组件测试用例的时候，断言的方法还是很多的，下面介绍几种常用的断言方法：assertEqual、assertIn、assertTrue

3.7.1 简单案例

1).下面写了4个case，其中第四个是执行失败的

#coding:utf-8

importunittestclassTest(unittest.TestCase):deftest01(self):'''判断 a == b'''a= 1b= 1self.assertEqual(a, b)deftest02(self):'''判断 a in b'''a= "hello"b= "hello world!"self.assertIn(a, b)deftest03(self):'''判断 a isTrue'''a=True

self.assertTrue(a)deftest04(self):'''失败案例'''a= "上海-悠悠"b= "yoyo"self.assertEqual(a, b)if __name__ == "__main__":

unittest.main()

2).执行结果如下

Failure

Expected :'\xe4\xb8\x8a\xe6\xb5\xb7-\xe6\x82\xa0\xe6\x82\xa0'

Actual   :'yoyo'

Traceback (most recent call last):

File "D:\test\yoyotest\kecheng\test12.py", line 27, in test04

self.assertEqual(a, b)

AssertionError: '\xe4\xb8\x8a\xe6\xb5\xb7-\xe6\x82\xa0\xe6\x82\xa0' != 'yoyo'

3.执行的结果，中文编码不对，没正常显示中文，遇到这种情况，可以自定义异常输出

3.7.2 自定义异常

1).以assertEqual为例分析：

assertEqual(self, first, second, msg=None)

Fail if the two objects are unequal as determined by the'=='

operator.

2).翻译：如果两个对象不能相等，就返回失败，相当于return: first==second

3).这里除了相比较的两个参数first和second，还有第三个参数msg=None,这个msg参数就是遇到异常后自定义输出信息

3.7.3 unittest常用的断言方法

1).assertEqual(self, first, second,msg=None)

--判断两个参数相等：first == second

2).assertNotEqual(self, first, second,msg=None)

--判断两个参数不相等：first ！= second

3).assertIn(self, member, container,msg=None)

--判断是字符串是否包含：member in container

4).assertNotIn(self, member,container, msg=None)

--判断是字符串是否不包含：member not in container

5).assertTrue(self, expr, msg=None)

--判断是否为真：expr is True

6).assertFalse(self, expr, msg=None)

--判断是否为假：expr is False

7).assertIsNone(self, obj, msg=None)

--判断是否为None：objis None

8).assertIsNotNone(self, obj,msg=None)

--判断是否不为None：obj is not None

3.7.4 unittest所有断言方法

1).下面是unittest框架支持的所有断言方法，有兴趣的同学可以慢慢看。(官方资料)

| assertAlmostEqual(self, first, second, places=None, msg=None,delta=None)| Fail ifthe two objects are unequal asdetermined by their|difference rounded to the given number ofdecimal places| (default 7) and comparing to zero, orbycomparing that the| between the two objects ismore than the givendelta.|

| Note that decimal places (from zero) areusually notthe same| as significant digits (measured fromthe mostsignficant digit).|

|If the two objects compare equal then they willautomatically|compare almost equal.|

| assertAlmostEquals = assertAlmostEqual(self, first, second,places=None, msg=None, delta=None)|

| assertDictContainsSubset(self, expected, actual, msg=None)| Checks whether actual isa superset ofexpected.|

| assertDictEqual(self, d1, d2, msg=None)|

| assertEqual(self, first, second, msg=None)| Fail if the two objects are unequal asdetermined by the '=='

|operator.|

| assertEquals = assertEqual(self, first, second, msg=None)|

| assertFalse(self, expr, msg=None)| Check that the expression isfalse.|

| assertGreater(self, a, b, msg=None)| Just like self.assertTrue(a >b), but with anicer default message.|

| assertGreaterEqual(self, a, b, msg=None)| Just like self.assertTrue(a >=b), but witha nicer default message.|

| assertIn(self, member, container, msg=None)| Just like self.assertTrue(a inb), but with anicer default message.|

| assertIs(self, expr1, expr2, msg=None)| Just like self.assertTrue(a isb), but with anicer default message.|

| assertIsInstance(self, obj, cls, msg=None)|Same as self.assertTrue(isinstance(obj, cls)),with a nicer|default message.|

| assertIsNone(self, obj, msg=None)| Same as self.assertTrue(obj isNone), with anicer default message.|

| assertIsNot(self, expr1, expr2, msg=None)| Just like self.assertTrue(a is notb), but witha nicer default message.|

| assertIsNotNone(self, obj, msg=None)| Included forsymmetry with assertIsNone.|

| assertItemsEqual(self, expected_seq, actual_seq, msg=None)|An unordered sequence specific comparison. Itasserts that| actual_seq andexpected_seq have the sameelement counts.|Equivalent to::|

|self.assertEqual(Counter(iter(actual_seq)),|Counter(iter(expected_seq)))|

|Asserts that each element has the same count inboth sequences.|Example:| - [0, 1, 1] and [1, 0,1] compare equal.| - [0, 0, 1] and [0, 1]compare unequal.|

| assertLess(self, a, b, msg=None)| Just like self.assertTrue(a

| assertLessEqual(self, a, b, msg=None)| Just like self.assertTrue(a <=b), but witha nicer default message.|

| assertListEqual(self, list1, list2, msg=None)| A list-specific equality assertion.|

|Args:|list1: The first listto compare.|list2: The second listto compare.|msg: Optional messageto use on failure instead of a list of|differences.|

| assertMultiLineEqual(self, first, second, msg=None)| Assert that two multi-line strings are equal.|

| assertNotAlmostEqual(self, first, second, places=None, msg=None,delta=None)| Fail ifthe two objects are equal as determinedby their|difference rounded to the given number ofdecimal places| (default 7) and comparing to zero, orbycomparing that the| between the two objects isless than the givendelta.|

| Note that decimal places (from zero) areusually notthe same| as significant digits (measured fromthe mostsignficant digit).|

|Objects that are equal automatically fail.|

| assertNotAlmostEquals = assertNotAlmostEqual(self, first, second, places=None,msg=None, delta=None)|

| assertNotEqual(self, first, second, msg=None)| Fail if the two objects are equal as determinedby the '!='

|operator.|

| assertNotEquals = assertNotEqual(self, first, second, msg=None)|

| assertNotIn(self, member, container, msg=None)| Just like self.assertTrue(a not inb), but witha nicer default message.|

| assertNotIsInstance(self, obj, cls, msg=None)| Included forsymmetry with assertIsInstance.|

| assertNotRegexpMatches(self, text, unexpected_regexp, msg=None)| Fail the test ifthe text matches the regularexpression.|

| assertRaises(self, excClass, callableObj=None, *args, **kwargs)| Fail unless an exception of classexcClass israised|by callableObj when invoked with arguments argsand keyword| arguments kwargs. If a different type ofexception is

| raised, it will not be caught, andthe testcase will be|deemed to have suffered an error, exactly asfor an|unexpected exception.|

| If called with callableObj omitted or None,will returna|context object used like this::|

|withself.assertRaises(SomeException):|do_something()|

|The context manager keeps a reference to theexception as| the 'exception'attribute. This allows you toinspect the|exception after the assertion::|

|withself.assertRaises(SomeException) as cm:|do_something()| the_exception =cm.exception| self.assertEqual(the_exception.error_code, 3)|

| assertRaisesRegexp(self, expected_exception, expected_regexp,callable_obj=None, *args, **kwargs)| Asserts that the message ina raised exceptionmatches a regexp.|

|Args:| expected_exception:Exception classexpected to be raised.| expected_regexp: Regexp(re pattern object orstring) expected| to be found inerror message.|callable_obj: Functionto be called.|args: Extra args.|kwargs: Extra kwargs.|

| assertRegexpMatches(self, text, expected_regexp, msg=None)|Fail the test unless the text matches theregular expression.|

| assertSequenceEqual(self, seq1, seq2, msg=None, seq_type=None)| An equality assertion for ordered sequences(like lists andtuples).|

| For the purposes of this function, a validordered sequence type isone

one| which can be indexed, has a length, andhas anequality operator.|

|Args:|seq1: The firstsequence to compare.|seq2: The secondsequence to compare.| seq_type: The expecteddatatype of the sequences, or None ifno|datatype should be enforced.|msg: Optional messageto use on failure instead of a list of|differences.|

| assertSetEqual(self, set1, set2, msg=None)| A set-specific equality assertion.|

|Args:|set1: The first set tocompare.|set2: The second set tocompare.|msg: Optional messageto use on failure instead of a list of|differences.|

| assertSetEqual uses ducktyping to supportdifferent types of sets, and

| is optimized forsets specifically (parametersmust support a|difference method).|

| assertTrue(self, expr, msg=None)| Check that the expression istrue.|

| assertTupleEqual(self, tuple1, tuple2, msg=None)| A tuple-specific equality assertion.|

|Args:|tuple1: The first tupleto compare.|tuple2: The secondtuple to compare.|msg: Optional messageto use on failure instead of a list of| differences.

3.8 搭建简易项目

前言

到unittest这里基本上可以搭建一个简易的项目框架了，我们可以用一条run_main.py脚本去控制执行所有的用例，并生成报告，发送邮件一系列的动作

一、新建工程

1.打开pycharm左上角File>New Project，在Location位置输入项目名称：D:\test\test_blog

2.创建之后，选择Opin in current window就可以了

二、项目结构

1.在测试工程下，创建文件夹，一定要选Python Package的方式创建，要不然后面导入自己写的模块会出现各种问题

2.在工程下创建以下几个文件

--test_case           这个文件夹放所有测试用例

----blog_home       可以按功能用例模块划分

---------test_home

---------test_home_1     测试用例以test开头命名

----blog_login

---------test_login

----blog_set

---------test_set

--test_report

--run_main.py          注意这个脚本放文件根目录

三、run_main

1.run_main.py这个脚本里面写主函数，控制执行所有的用例，最终我们只需要运行这个脚本就可以了

2.我们也可以在cmd里执行这个脚本文件，这样就不用依赖pycharm去执行了(后续用jenkins执行，也是同样道理，启动cmd执行脚本)

>>d:

>>cd test\test_blog

>>python run_main.py

3.run_main.py源代码在下一章节。

3.8-1 生成报告的源码下载(兼容python2和3)

生成测试项目报告模板：

测试报告搞不出来的看这里：

3.9 run_main.py源码(兼容python2和3)

以下代码在python2和python3上都跑通过，python3只需注释掉上面红色框框区域代码就行(最后一步发送邮箱代码，我注释掉了)。

#coding=utf-8

importunittestimporttimeimportHTMLTestRunnerfrom email.mime.text importMIMETextfrom email.mime.multipart importMIMEMultipartimportsmtplibimportos####下面三行代码python2报告出现乱码时候可以加上####

importsys

reload(sys)

sys.setdefaultencoding('utf8')#这个是优化版执行所有用例并发送报告，分四个步骤#第一步加载用例#第二步执行用例#第三步获取最新测试报告#第四步发送邮箱 (这一步不想执行的话，可以注释掉最后面那个函数就行)

defadd_case(case_path, rule):'''加载所有的测试用例'''testunit=unittest.TestSuite()#定义discover方法的参数

discover =unittest.defaultTestLoader.discover(case_path,

pattern=rule,

top_level_dir=None)#discover方法筛选出来的用例，循环添加到测试套件中

#for test_suite in discover:

#for test_case in test_suite:

#testunit.addTests(test_case)

#print testunit

testunit.addTests(discover)  #直接加载discover

print(testunit)returntestunitdefrun_case(all_case, report_path):'''执行所有的用例, 并把结果写入测试报告'''now= time.strftime("%Y_%m_%d %H_%M_%S")

report_abspath= os.path.join(report_path, now+"result.html")#report_abspath = "D:\\web_project\\report\\"+now+"result.html"

fp = open(report_abspath, "wb")

runner= HTMLTestRunner.HTMLTestRunner(stream=fp,

title=u'自动化测试报告,测试结果如下：',

description=u'用例执行情况：')#调用add_case函数返回值

runner.run(all_case)

fp.close()defget_report_file(report_path):'''获取最新的测试报告'''lists=os.listdir(report_path)

lists.sort(key=lambdafn: os.path.getmtime(os.path.join(report_path, fn)))print (u'最新测试生成的报告：'+lists[-1])#找到最新生成的报告文件

report_file = os.path.join(report_path, lists[-1])returnreport_filedefsend_mail(sender, psw, receiver, smtpserver, report_file):'''发送最新的测试报告内容'''#读取测试报告的内容

with open(report_file, "rb") as f:

mail_body=f.read()#定义邮件内容

msg =MIMEMultipart()

body= MIMEText(mail_body, _subtype='html', _charset='utf-8')

msg['Subject'] = u"自动化测试报告"msg["from"] =sender

msg["to"] =psw#加上时间戳

#msg["date"] = time.strftime('%a, %d %b %Y %H_%M_%S %z')

msg.attach(body)#添加附件

att = MIMEText(open(report_file, "rb").read(), "base64", "utf-8")

att["Content-Type"] = "application/octet-stream"att["Content-Disposition"] = 'attachment; filename= "report.html"'msg.attach(att)#登录邮箱

smtp =smtplib.SMTP()#连接邮箱服务器

smtp.connect(smtpserver)#用户名密码

smtp.login(sender, psw)

smtp.sendmail(sender, receiver, msg.as_string())

smtp.quit()print('test report email has send out !')if __name__ == "__main__":#测试用例的路径、匹配规则

case_path = "D:\\test\\newp\\case"rule= "test*.py"all_case= add_case(case_path, rule)   #1加载用例

#生成测试报告的路径

report_path = "D:\\test\\newp\\report"run_case(all_case, report_path)#2执行用例

#获取最新的测试报告文件

report_file = get_report_file(report_path)  #3获取最新的测试报告

#邮箱配置

sender = "yoyo@xxx.com"psw= "xxx"#收件人多个时，中间用逗号隔开,如'a@xx.com,b@xx.com'

receiver = "yoyo@xxx.com"smtp_server= 'smtp.xxx.com'#send_mail(sender, psw, receiver, smtp_server, report_file)  # 4最后一步发送报告，需要发邮件就取消注释。

3.10 练习题1:模块导入(登录方法)

以登录博客园为案例https://passport.cnblogs.com/user/signin

一、登录方法封装

1.我们可以把登录写成一个登录类，里面写个登录的方法，保存文件为login_pub.py

#coding:utf-8

'''这里写了一个登录博客园的类，登录博客园方法'''

classLogin_Blog():'''登录类封装'''

def __init__(self, driver):'''初始化driver参数'''self.driver=driverdefinput_user(self, username):'''输入用户名'''self.driver.find_element_by_id("input1").clear()

self.driver.find_element_by_id("input1").send_keys(username)definput_psw(self,psw):'''输入密码'''self.driver.find_element_by_id("input2").clear()

self.driver.find_element_by_id("input2").send_keys(psw)defclick_button(self):'''点击登录按钮'''self.driver.find_element_by_id("signin").click()deflogin(self, username, psw):'''登录公共方法'''self.input_user(username)

self.input_psw(psw)

self.click_button()

2.调用登录公共方法

#coding:utf-8

from selenium importwebdriverimportunittestfrom login_pub importLogin_Blog

login_url= "https://passport.cnblogs.com/user/signin"

classTetsLogin(unittest.TestCase):defsetUp(self):

self.driver=webdriver.Firefox()

self.driver.get(login_url)deftearDown(self):

self.driver.quit()deftest_login(self):#调用登录类里面的login方法

Login_Blog(self.driver).login("xxx", "111")

self.driver.find_element()#后面接着的操作省略了

if __name__ == "__main__":

unittest.main()

3.11 练习题2:捕获异常

前言

在定位元素的时候，经常会遇到各种异常，为什么会发生这些异常，遇到异常又该如何处理呢？

本篇通过学习selenium的exceptions模块，了解异常发生的原因。

一、发生异常

1.打开博客首页，定位“新随笔”元素，此元素id="blog_nav_newpost"

2.为了故意让它定位失败，我在元素属性后面加上xx

3.运行失败后如下图所示，程序在查找元素的这一行发生了中断，不会继续执行click事件了

二、捕获异常

1.为了让程序继续执行，我们可以用try...except...捕获异常。捕获异常后可以打印出异常原因，这样以便于分析异常原因。

2.从如下异常内容可以看出，发生异常原因是：NoSuchElementException

selenium.common.exceptions.NoSuchElementException: Message: Unable to locate element: {"method":"id","selector":"blog_nav_newpostxx"}

3.从selenium.common.exceptions 导入 NoSuchElementException类。

三、参考代码：

#coding:utf-8

from selenium importwebdriverfrom selenium.common.exceptions importNoSuchElementException

driver=webdriver.Firefox()

driver.get("http://www.cnblogs.com/yoyoketang/")#定位首页"新随笔"

try:

element= driver.find_element("id", "blog_nav_newpostxx")exceptNoSuchElementException as msg:print u"查找元素异常%s"%msg#点击该元素

else:

element.click()

四、selenium常见异常

1.NoSuchElementException：没有找到元素

2.NoSuchFrameException：没有找到iframe

3.NoSuchWindowException:没找到窗口句柄handle

4.NoSuchAttributeException:属性错误

5.NoAlertPresentException：没找到alert弹出框

6.ElmentNotVisibleException：元素不可见

7.ElementNotSelectableException：元素没有被选中

8.TimeoutException：查找元素超时

备注：其它异常与源码在Lib目录下：selenium/common/exceptions有兴趣的可以看看。

3.12 练习题3:异常后截图

前言

在执行用例过程中由于是无人值守的，用例运行报错的时候，我们希望能对当前屏幕截图，留下证据。

在写用例的时候，最后一步是断言，可以把截图的动作放在断言这里，那么如何在断言失败后截图呢？

一、截图方法

1.get_screenshot_as_file(self, filename)

--这个方法是获取当前window的截图，出现IOError时候返回False,截图成功返回True。

filename参数是保存文件的路径。

Usage:

driver.get_screenshot_as_file('/Screenshots/foo.png')

2.get_screenshot_as_base64(self)

--这个方法也是获取屏幕截图，保存的是base64的编码格式，在HTML界面输出截图的时候，会用到。

比如，想把截图放到html测试报告里。

Usage:

driver.get_screenshot_as_base64()

3.get_screenshot_as_png(self)

--这个是获取屏幕截图，保存的是二进制数据，很少用到。

Usage:

driver.get_screenshot_as_png()

二、异常后截图

1.为了能抛异常，把定位登录按钮的id换了个错的id。

2.给图片命名时候加个时间戳，避免同一个文件名称被覆盖掉。

3.文件路径，这里直接写的文件名称，就是跟当前的脚本同一个路径。如果图片输出到其它文件路径，需要些文件的绝对路径了。

4.截图的结果，如果没截到图返回False,截图成功会返回True。

三、selenium实例

1.在unittest框架里写用例的时候，我们希望在断言失败的时候，对当前屏幕截图。

2.如果加try...except捕获异常后结果，此时所有的测试用例都是通过的了，会影响测试结果。解决办法其实很简单，再把异常抛出来就行了。

3.参考代码：

#coding:utf-8

from selenium importwebdriverimporttime,unittestfrom selenium.webdriver.support importexpected_conditions as ECclassLogin(unittest.TestCase):defsetUp(self):

url_login= "https://passport.cnblogs.com/user/signin"self.driver=webdriver.Firefox()

self.driver.get(url_login)deftest_01(self):'''前面输入账号密码，让正确运行到assert这一步，断言故意设置为Fals

e不成功'''try:

self.driver.find_element_by_id("input1").send_keys(u"上海-悠悠")

self.driver.find_element_by_id("input2").send_keys("xxx")#登录id是错的，定位会抛异常

self.driver.find_element_by_id("signin").click()#判断登录成功页面是否有账号："上海-悠悠"

time.sleep(3)

locator= ("id", "lnk_current_user")

result= EC.text_to_be_present_in_element(locator,u"上海-悠悠")(self.driver)

self.assertFalse(result)exceptException as msg:print(u"异常原因%s"%msg)#图片名称可以加个时间戳

nowTime = time.strftime("%Y%m%d.%H.%M.%S")

self.driver.get_screenshot_as_file('%s.jpg' %nowTime)raisedeftearDown(self):

self.driver.quit()if __name__ == "__main__":

unittest.main()

4.运行结果：

异常原因True is not false

Failure

Traceback (most recent call last):

File "D:\test\yoyot\ketang\test01.py", line 22, in test_01

self.assertFalse(result)

AssertionError: True is not false

3.13 练习题4:邮件发送(smtp)

前言

本篇总结了QQ邮箱和163邮箱发送邮件，邮件包含html中文和附件，可以发给多个收件人，专治各种不行，总之看完这篇麻麻再也不用担心我的邮件收不到了。

以下代码兼容python2和python3，运行无异常，放心大胆食用。

一、163邮箱

1.先导入smtplib库用来发送邮件，导入MIMEText库用来做纯文本的邮件模板

2.先准备几个跟发邮件相关的参数，每个邮箱的发件服务器都不一样，以163为例，百度搜到发件服务器为：smtp.163.com

3.接下来就是写邮件的主题和正文内容，正文这里用html格式的

4.最后调用SMTP发件服务

5.参考代码：

#coding:utf-8

importsmtplibfrom email.mime.text importMIMEText#----------1.跟发件相关的参数------

smtpserver = "smtp.163.com"            #发件服务器

port = 0                                            #端口

sender = "yoyo@163.com"                #账号

psw = "**************"                         #密码

receiver = "283340479@qq.com"        #接收人#----------2.编辑邮件的内容------

subject = "这个是主题163"body= '

这个是发送的163邮件

'  #定义邮件正文为html格式

msg = MIMEText(body, "html", "utf-8")

msg['from'] =sender

msg['to'] = "283340479@qq.com"msg['subject'] =subject#----------3.发送邮件------

smtp =smtplib.SMTP()

smtp.connect(smtpserver)#连服务器

smtp.login(sender, psw)                                     #登录

smtp.sendmail(sender, receiver, msg.as_string())  #发送

smtp.quit()                                                         #关闭

二、QQ邮件

1.QQ邮箱是需要SSL认证的，这种邮箱跟上面的就有点不一样了。

2.找到QQ邮箱授权码，打开QQ邮箱-设置-账号-POP3开启服务-开启

(如果已经开启了，不知道授权码，就点温馨提示里面的‘生成授权码’)

3.发验证短信获取授权码，照着提示发个短信，如何点我已发送，就会收到授权码了。

4.收到授权码后复制，保存下来，这个就可以当QQ邮箱的密码了。

5.QQ邮箱发送邮件代码，跟163有点不一样，如下图红色框框：

6.参考代码：

#coding:utf-8

importsmtplibfrom email.mime.text importMIMEText#----------1.跟发件相关的参数------#smtpserver = "smtp.163.com"         # 发件服务器

smtpserver = "smtp.qq.com"port= 465                                        #端口

sender = "283340479@qq.com"         #账号

psw = "**************"                         #密码

receiver = "283340479@qq.com"        #接收人#----------2.编辑邮件的内容------

subject = "这个是主题QQ"body= '

这个是发送的QQ邮件

'     #定义邮件正文为html格式

msg = MIMEText(body, "html", "utf-8")

msg['from'] =sender

msg['to'] = "283340479@qq.com"msg['subject'] =subject#----------3.发送邮件------#smtp = smtplib.SMTP()#smtp.connect(smtpserver)                                 # 连服务器

smtp =smtplib.SMTP_SSL(smtpserver, port)

smtp.login(sender, psw)#登录

smtp.sendmail(sender, receiver, msg.as_string())  #发送

smtp.quit()                                                        #关闭

三、兼容163和QQ邮箱

1.如果想兼容上面两种方式发送邮件，只需把第三块内容稍微改下，如下所示

四、发送带附件

1.上面的MIMEText只能发送正文，无法带附件，发送带附件的需要导入另外一个模块MIMEMultipart

2.先读取要发送文件的内容，file_path是路径的参数名

3.下图红色框框file_name参数是发送的附件重新命名

4.参考代码：

#coding:utf-8

importsmtplibfrom email.mime.text importMIMETextfrom email.mime.multipart importMIMEMultipart#----------1.跟发件相关的参数------

smtpserver = "smtp.163.com"           #发件服务器

port = 0                                           #端口

sender = "yoyo@163.com"               #账号

psw = "***********"                             #密码

receiver = "283340479@qq.com"        #接收人#----------2.编辑邮件的内容------#读文件

file_path = "result.html"with open(file_path,"rb") as fp:

mail_body=fp.read()

msg=MIMEMultipart()

msg["from"] = sender                             #发件人

msg["to"] = receiver                               #收件人

msg["subject"] = "这个我的主题"             #主题#正文

body = MIMEText(mail_body, "html", "utf-8")

msg.attach(body)#附件

att = MIMEText(mail_body, "base64", "utf-8")

att["Content-Type"] = "application/octet-stream"att["Content-Disposition"] = 'attachment; filename="test_report.html"'msg.attach(att)#----------3.发送邮件------

try:

smtp=smtplib.SMTP()

smtp.connect(smtpserver)#连服务器

smtp.login(sender, psw)except:

smtp=smtplib.SMTP_SSL(smtpserver, port)

smtp.login(sender, psw)#登录

smtp.sendmail(sender, receiver, msg.as_string())  #发送

smtp.quit()

5.最后结果，有图有真相

五、发给多个收件人

1.上面都是发给一个收件人，那么如何一次发给多个收件人呢？只需改两个小地方

2.把receiver参数改成list对象，单个多个都是可以收到的

3.msg["to"]这个参数不能用list了，得先把receiver参数转化成字符串，如下图所示

4.参考代码：

#coding:utf-8

importsmtplibfrom email.mime.text importMIMETextfrom email.mime.multipart importMIMEMultipart#----------1.跟发件相关的参数------

smtpserver = "smtp.163.com"           #发件服务器

port = 0                              #端口

sender = "yoyo@163.com"     #账号

psw = "*********"                  #密码#receiver = ["xxxx@qq.com"]      # 单个接收人也可以是list

receiver = ["xxxx@qq.com", "yoyo@qq.com"]   #多个收件人list对象#----------2.编辑邮件的内容------#读文件

file_path = "result.html"with open(file_path,"rb") as fp:

mail_body=fp.read()

msg=MIMEMultipart()

msg["from"] = sender                       #发件人

msg["to"] = ";".join(receiver)             #多个收件人list转str

msg["subject"] = "这个我的主题999"              #主题#正文

body = MIMEText(mail_body, "html", "utf-8")

msg.attach(body)#附件

att = MIMEText(mail_body, "base64", "utf-8")

att["Content-Type"] = "application/octet-stream"att["Content-Disposition"] = 'attachment; filename="test_report.html"'msg.attach(att)#----------3.发送邮件------

try:

smtp=smtplib.SMTP()

smtp.connect(smtpserver)#连服务器

smtp.login(sender, psw)except:

smtp=smtplib.SMTP_SSL(smtpserver, port)

smtp.login(sender, psw)#登录

smtp.sendmail(sender, receiver, msg.as_string())  #发送

smtp.quit()                                       #关闭

六：邮件收不到的几种原因：

1.Subject和正文内容不要用hello、hehe、test等单词

2.from(发件人)和to(收件人)不要为空，

(要不然会被认为是垃圾邮件)

3.找不到的话，先看下垃圾信箱，是不是跑到垃圾箱了

4.如果前几次可以收到，后来收不到了，需改下subject内容

(因为每次都是一个subject，系统也会拒收的，把subject内容设置为动态的是最好的)

5.部分邮箱是ssl加密了的，所以无法发送，如:qq邮箱

(用授权码去登录)

6.要是按照上面的步骤来报错了，说明代码抄错了，多检查几次。

(以上代码均在python2和python3上都测试通过了)

3.14 unittest之skip

前言

当测试用例写完后，有些模块有改动时候，会影响到部分用例的执行，这个时候我们希望暂时跳过这些用例。

或者前面某个功能运行失败了，后面的几个用例是依赖于这个功能的用例，如果第一步就失败了，后面的用例也就没必要去执行了，直接跳过就行，节省用例执行时间。

一、skip装饰器

skip装饰器一共有四个：

@unittest.skip(reason)

Unconditionally skip the decorated test. reason should describe why the test is being skipped.

翻译：无条件跳过用例，reason是说明原因。

@unittest.skipIf(condition, reason)

Skip the decorated test if condition is true.

翻译：condition为true的时候跳过。

@unittest.skipUnless(condition, reason)

Skip the decorated test unless condition is true.

翻译：condition为False的时候跳过。

@unittest.expectedFailure

Mark the test as an expected failure. If the test fails when run, the test is not counted as a failure.

翻译：断言的时候跳过。

二、skip案例

运行结果：

测试1

测试4

.ssx

----------------------------------------------------------------------

Ran 4 tests in 0.003s

OK (skipped=2, expected failures=1)

三、跳过整个测试类

四、参考代码：

#coding:utf-8

importunittestclassTest(unittest.TestCase):

@unittest.skip(u"无条件跳过此用例")deftest_1(self):print "测试1"@unittest.skipIf(True, u"为True的时候跳过")deftest_2(self):print "测试2"@unittest.skipUnless(False, u"为False的时候跳过")deftest_3(self):print "测试3"@unittest.expectedFailuredeftest_4(self):print "测试4"self.assertEqual(2, 4, msg=u"判断相等")if __name__ == "__main__":

unittest.main()