首先配置好开发环境，下载安装Python并下载安装pycharm，在pycharm中创建项目功能目录。如果不会的可以百度Google一下，该内容网上的讲解还是比较多比较全的！

大家可以先简单了解下该项目的目录结构介绍，后面会针对每个文件有详细注解和代码。

common：

——configDb.py：这个文件主要编写数据库连接池的相关内容，本项目暂未考虑使用数据库来存储读取数据，此文件可忽略，或者不创建。本人是留着以后如果有相关操作时，方便使用。

——configEmail.py：这个文件主要是配置发送邮件的主题、正文等，将测试报告发送并抄送到相关人邮箱的逻辑。

——configHttp.py：这个文件主要来通过get、post、put、delete等方法来进行http请求，并拿到请求响应。

——HTMLTestRunner.py：主要是生成测试报告相关

——Log.py：调用该类的方法，用来打印生成日志

result:

——logs：生成的日志文件

——report.html：生成的测试报告

testCase:

——test01case.py：读取userCase.xlsx中的用例，使用unittest来进行断言校验

testFile/case:

——userCase.xlsx：对下面test_api.py接口服务里的接口，设计了三条简单的测试用例，如参数为null，参数不正确等

caselist.txt：配置将要执行testCase目录下的哪些用例文件，前加#代表不进行执行。当项目过于庞大，用例足够多的时候，我们可以通过这个开关，来确定本次执行哪些接口的哪些用例。

config.ini：数据库、邮箱、接口等的配置项，用于方便的调用读取。

getpathInfo.py：获取项目绝对路径

geturlParams.py：获取接口的URL、参数、method等

readConfig.py：读取配置文件的方法，并返回文件中内容

readExcel.py：读取Excel的方法

runAll.py：开始执行接口自动化，项目工程部署完毕后直接运行该文件即可

test_api.py：自己写的提供本地测试的接口服务

test_sql.py：测试数据库连接池的文件，本次项目未用到数据库，可以忽略

二、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_01——测试接口服务

首先，我们想搭建一个接口自动化测试框架，前提我们必须要有一个可支持测试的接口服务。有人可能会说，现在我们的环境不管测试环境，还是生产环境有现成的接口。但是，一般工作环境中的接口，不太满足我们框架的各种条件。举例如，接口a可能是get接口b可能又是post，等等等等。因此我决定自己写一个简单的接口！用于我们这个框架的测试！

按第一讲的目录创建好文件，打开test_api.py，写入如下代码

2. import flask

4. import json

6. from flask import request

9. '''

11. flask： web框架，通过flask提供的装饰器@server.route()将普通函数转换为服

13. '''

15. # 创建一个服务，把当前这个python文件当做一个服务

17. server = flask.Flask(__name__)

19. # @server.route()可以将普通函数转变为服务 登录接口的路径、请求方式

21. @server.route('/login', methods=['get', 'post'])

23. def login():

25. # 获取通过url请求传参的数据

27. username = request.values.get('name')

29. # 获取url请求传的密码，明文

31. pwd = request.values.get('pwd')

33. # 判断用户名、密码都不为空

35. if username and pwd:

37. if username == 'xiaoming' and pwd == '111':

39. resu = {'code': 200, 'message': '登录成功'}

41. return json.dumps(resu, ensure_ascii=False) # 将字典转换字符串

43. else:

45. resu = {'code': -1, 'message': '账号密码错误'}

47. return json.dumps(resu, ensure_ascii=False)

49. else:

51. resu = {'code': 10001, 'message': '参数不能为空！'}

53. return json.dumps(resu, ensure_ascii=False)

56. if __name__ == '__main__':

58. server.run(debug=True, port=8888, host='127.0.0.1')

执行test_api.py，在浏览器中输入http://127.0.0.1:8888/login?name=xiaoming&pwd=11199回车，验证我们的接口服务是否正常~　　

 变更我们的参数，查看不同的响应结果确认接口服务一切正常

 三、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_02——配置文件读取

在我们第二讲中，我们已经通过flask这个web框架创建好了我们用于测试的接口服务，因此我们可以把这个接口抽出来一些参数放到配置文件，然后通过一个读取配置文件的方法，方便后续的使用。同样还有邮件的相关配置~

按第一讲的目录创建好config.ini文件，打开该文件写入如下：

2. # -*- coding: utf-8 -*-

4. [HTTP]

6. scheme = http

8. baseurl = 127.0.0.1

10. port = 8888

12. timeout = 10.0

17. [EMAIL]

19. on_off = on;

21. subject = 接口自动化测试报告

23. app = Outlook

25. addressee = songxiaobao@qq.com

27. cc = zhaobenshan@qq.com

在HTTP中，协议http，baseURL，端口，超时时间。

在邮件中on_off是设置的一个开关，=on打开，发送邮件，=其他不发送邮件。subject邮件主题，addressee收件人，cc抄送人。

在我们编写readConfig.py文件前，我们先写一个获取项目某路径下某文件绝对路径的一个方法。按第一讲的目录结构创建好getpathInfo.py，打开该文件

2. import os

5. def get_Path():

7. path = os.path.split(os.path.realpath(__file__))[0]

9. return path

12. if __name__ == '__main__':# 执行该文件，测试下是否OK

14. print('测试路径是否OK,路径为：', get_Path())

填写如上代码并执行后，查看输出结果，打印出了该项目的绝对路径：

继续往下走，同理，按第一讲目录创建好readConfig.py文件，打开该文件，以后的章节不在累赘

2. import os

4. import configparser

6. import getpathInfo#引入我们自己的写的获取路径的类

9. path = getpathInfo.get_Path()#调用实例化，还记得这个类返回的路径为C:\Users\songlihui\PycharmProjects\dkxinterfaceTest

11. config_path = os.path.join(path, 'config.ini')#这句话是在path路径下再加一级，最后变成C:\Users\songlihui\PycharmProjects\dkxinterfaceTest\config.ini

13. config = configparser.ConfigParser()#调用外部的读取配置文件的方法

15. config.read(config_path, encoding='utf-8')

18. class ReadConfig():

21. def get_http(self, name):

23. value = config.get('HTTP', name)

25. return value

27. def get_email(self, name):

29. value = config.get('EMAIL', name)

31. return value

33. def get_mysql(self, name):#写好，留以后备用。但是因为我们没有对数据库的操作，所以这个可以屏蔽掉

35. value = config.get('DATABASE', name)

37. return value

41. if __name__ == '__main__':#测试一下，我们读取配置文件的方法是否可用

43. print('HTTP中的baseurl值为：', ReadConfig().get_http('baseurl'))

45. print('EMAIL中的开关on_off值为：', ReadConfig().get_email('on_off'))

执行下readConfig.py，查看数据是否正确

 一切OK

四、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_03——读取Excel中的case

配置文件写好了，接口我们也有了，然后我们来根据我们的接口设计我们简单的几条用例。首先在前两讲中我们写了一个我们测试的接口服务，针对这个接口服务存在三种情况的校验。正确的用户名和密码，账号密码错误和账号密码为空

 我们根据上面的三种情况，将对这个接口的用例写在一个对应的单独文件中testFile\case\userCase.xlsx ，userCase.xlsx内容如下：

 紧接着，我们有了用例设计的Excel了，我们要对这个Excel进行数据的读取操作，继续往下，我们创建readExcel.py文件

2. import os

4. import getpathInfo# 自己定义的内部类，该类返回项目的绝对路径

6. #调用读Excel的第三方库xlrd

8. from xlrd import open_workbook

10. # 拿到该项目所在的绝对路径

12. path = getpathInfo.get_Path()

15. class readExcel():

17. def get_xls(self, xls_name, sheet_name):# xls_name填写用例的Excel名称 sheet_name该Excel的sheet名称

19. cls = []

21. # 获取用例文件路径

23. xlsPath = os.path.join(path, "testFile", 'case', xls_name)

25. file = open_workbook(xlsPath)# 打开用例Excel

27. sheet = file.sheet_by_name(sheet_name)#获得打开Excel的sheet

29. # 获取这个sheet内容行数

31. nrows = sheet.nrows

33. for i in range(nrows):#根据行数做循环

35. if sheet.row_values(i)[0] != u'case_name':#如果这个Excel的这个sheet的第i行的第一列不等于case_name那么我们把这行的数据添加到cls[]

37. cls.append(sheet.row_values(i))

39. return cls

41. if __name__ == '__main__':#我们执行该文件测试一下是否可以正确获取Excel中的值

43. print(readExcel().get_xls('userCase.xlsx', 'login'))

45. print(readExcel().get_xls('userCase.xlsx', 'login')[0][1])

47. print(readExcel().get_xls('userCase.xlsx', 'login')[1][2])

结果为：

完全正确~ 

五、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_04——requests请求配置文件有了，读取配置文件有了，用例有了，读取用例有了，我们的接口服务有了，我们是不是该写对某个接口进行http请求了，这时候我们需要使用pip install requests来安装第三方库，在common下configHttp.py，configHttp.py的内容如下：

3. import requests

5. import json

9. class RunMain():

12. def send_post(self, url, data): # 定义一个方法，传入需要的参数url和data

14. # 参数必须按照url、data顺序传入

16. result = requests.post(url=url, data=data).json() # 因为这里要封装post方法，所以这里的url和data值不能写死

18. res = json.dumps(result, ensure_ascii=False, sort_keys=True, indent=2)

20. return res

23. def send_get(self, url, data):

25. result = requests.get(url=url, params=data).json()

27. res = json.dumps(result, ensure_ascii=False, sort_keys=True, indent=2)

29. return res

32. def run_main(self, method, url=None, data=None): # 定义一个run_main函数，通过传过来的method来进行不同的get或post请求

34. result = None

36. if method == 'post':

38. result = self.send_post(url, data)

40. elif method == 'get':

42. result = self.send_get(url, data)

44. else:

46. print("method值错误！！！")

48. return result

52. if __name__ == '__main__': # 通过写死参数，来验证我们写的请求是否正确

54. result1 = RunMain().run_main('post', 'http://127.0.0.1:8888/login', {'name': 'xiaoming','pwd':'111'})

56. result2 = RunMain().run_main('get', 'http://127.0.0.1:8888/login', 'name=xiaoming&pwd=111')

58. print(result1)

60. print(result2)

执行该文件，验证结果正确性：

 我们发现和浏览器中进行请求该接口，得到的结果一致，说明没有问题，一切OK

六、Python+unittest+requests+HTMLTestRunner完整的接口自动化测试框架搭建_05——参数动态化

在上一讲中，我们写了针对我们的接口服务，设计的三种测试用例，使用写死的参数（result = RunMain().run_main('post', 'http://127.0.0.1:8888/login', 'name=xiaoming&pwd=')）来进行requests请求。本讲中我们写一个类，来用于分别获取这些参数，来第一讲的目录创建geturlParams.py，geturlParams.py文件中的内容如下：

2. import readConfig as readConfig

5. readconfig = readConfig.ReadConfig()

8. class geturlParams():# 定义一个方法，将从配置文件中读取的进行拼接

10. def get_Url(self):

12. new_url = readconfig.get_http('scheme') + '://' + readconfig.get_http('baseurl') + ':8888' + '/login' + '?'

14. #logger.info('new_url'+new_url)

16. return new_url

19. if __name__ == '__main__':# 验证拼接后的正确性

21. print(geturlParams().get_Url())

 通过将配置文件中的进行拼接，拼接后的结果：http://127.0.0.1:8888/login?和我们请求的一致