關鍵詞：接口掰茶、python暇藏、requests、unittest
引言：一般對于自動化的理解濒蒋，有兩種方式的自動化盐碱。
第一，不需要寫代碼沪伙，完全由工具實現瓮顽，這種方式的工具一般是公司自己研發(fā)的，方便黑盒測試人員使用围橡。這種工具的特點是學習成本低暖混，方便使用，但是通用性不強翁授，也就是換了一家公司拣播，就很有可能無法使用之前的工具晾咪。
第二，需要自己寫代碼贮配，在別人的框架下編寫代碼測試谍倦，或者是需要自己搭建自動化測試框架。這種方式對測試人員的代碼要求高泪勒，學習成本高昼蛀，但是通用性很強，去任何一家都可以用這套東西圆存。
鑒于以上介紹曹洽，本文當然是介紹第二種方式了。
我們的課題是接口自動化辽剧，我們的目的是使用python進行接口測試送淆，并完成輸出測試報告。我們需要用到的東西有如下：python3怕轿，unittest偷崩，requests。
一：接口項目
我們使用的項目是發(fā)布會簽到系統(tǒng)撞羽〔保總共有5個接口，雖然不多诀紊，但足夠學習使用谒出。
接口文檔如下：
二、接口用例
軟件測試都需要寫測試用例邻奠，不管你做的性能笤喳，自動化還是其它任何的測試工作窥淆。
真實的工作寫接口的測試用例李请，可能考慮很多場景济榨，如接口的功能（正常場景）杨刨，接口的邊界等價，接口的異常場景垦搬，接口參數組合滓彰，接口的性能等等晚岭。本文采用輸出法分析碑隆，根據出參的不同設計出測試用例恭陡。詳細用例參考如下：（用例太小看不清楚，可以查看原圖上煤，然后放大）
三休玩、代碼階段
3.1 框架的設計
我們使用unittest框架，case目錄存放所有的測試用例，lib目錄存放自己封裝的一些代碼哥捕，result目錄存放測試結果和測試日志，runner.py是主程序嘉熊。
3.2 主程序 runner.py
這個主程序跟之前的《selenium unittest實戰(zhàn)》文章類似遥赚，不再詳細介紹，不太一樣的地方是使用一個logging模塊阐肤。不知道大家有沒有感受凫佛，測試接口的時候，想看完整的請求和響應孕惜，以便分析定位問題愧薛。
import unittest
import time
import os
import logging
from HTMLTestRunner import HTMLTestRunner
#獲取項目的根目錄
test_dir = os.path.join(os.getcwd())
# 自動搜索項目根目錄下的所有case，構造測試集衫画；返回TestSuite對象
discover = unittest.defaultTestLoader.discover(test_dir, pattern='test_*.py')
# 實例化TextTestRunner類
# runner = unittest.TextTestRunner(verbosity=2)
now = time.strftime('%Y-%m-%d %H_%M_%S') # 獲取當前日期
result = test_dir+ '\\result\\'+now + '_result.html' # 測試報告的完整路徑
log = test_dir+'\\result\\'+now+'_log.txt' #日志的完整路徑
logging.basicConfig(filename=log,level=logging.INFO,format = '%(asctime)s - %(name)s - %(levelname)s - %(message)s') #filename 日志文件路徑 level 日志的級別 format 格式
fp = open(result, 'wb') # wb方式寫入
runner = HTMLTestRunner(stream=fp, title='測試報告', description='aguest_master項目用例執(zhí)行情況',verbosity=2) #構造runner
# 使用run()方法運行測試套件（即運行測試套件中的所有用例）
runner.run(discover)
3.3 測試用例和lib庫
1） 由于總共只有5個接口毫炉，所以設計為5個代碼文件，分別為：test_add_event,py削罩，test_add_guest.py瞄勾，test_get_event_list.py，test_get_guest_list.py弥激，test_user_sign.py进陡。
2）我們使用python的requests測試接口，這個庫大名鼎鼎微服，而且官網還有中文趾疚。
官網網址：http://docs.python-requests.org/zh_CN/latest/
3）每個代碼文件都是一個接口，接口的url地址是固定的以蕴，所以設計成類屬性糙麦，方便后續(xù)測試用例使用。
4）每個測試用例都寫明代碼邏輯丛肮，方便以后調試喳资。
5）如果遇到經常調用的東西，如獲取最新發(fā)布會ID腾供，獲取添加發(fā)布會body數據仆邓，都封裝成庫。
6）最后根據出參的狀態(tài)碼斷言是否成功
7）使用logging.info 記錄每個測試用例的日志情況
添加發(fā)布會接口代碼文件：test_add_event.py
import requests
import unittest
import logging
import addEventDataTemplate
import getNewID
from urllib import parse #使用requests發(fā)送post請求伴鳖，body的漢字會進行url編碼节值，即%xx形式。想看到原始body榜聂，需要使用parse.unquote進入url解碼
class Test_addEvent(unittest.TestCase):
'''添加發(fā)布會接口'''
@classmethod
def setUpClass(cls):
cls.url="http://127.0.0.1:8000/api/add_event/"
@classmethod
def tearDownClass(cls):
pass
def setUp(self):
pass
def tearDown(self):
pass
def test_00(self): #代碼邏輯::獲取當前最新發(fā)布會ID搞疗，設置入參，eid置空须肆，發(fā)送post請求
'''添加發(fā)布會-eid為空'''
id=getNewID.getNewID() #獲取當前最新發(fā)布會ID
data=addEventDataTemplate.getEventData(id) #獲取添加發(fā)布會的數據模板
data['eid']='' #eid為空匿乃，即參數錯誤
r=requests.post(self.url,data=data)
status=r.json()['status']
self.assertEqual(10021,status)
logging.info(f"case:添加發(fā)布會桩皿，eid為空\n請求地址：{r.url}\t請求方式:{r.request.method}\n請求頭：{r.request.headers}\n請求正文：{parse.unquote(r.request.body)}\n響應頭：{r.headers}\n響應正文：{r.text}\n")
def test_01(self): #代碼邏輯::獲取當前最新發(fā)布會ID，設置入參幢炸，發(fā)送post請求
'''添加發(fā)布會-成功'''
id = getNewID.getNewID() # 獲取當前最新發(fā)布會ID
data = addEventDataTemplate.getEventData(id)#獲取添加最新發(fā)布會的數據模板
r=requests.post(self.url,data=data)
status=r.json()['status']
self.assertEqual(10000,status)
logging.info(f"case:添加發(fā)布會泄隔，成功\n請求地址：{r.url}\t請求方式:{r.request.method}\n請求頭：{r.request.headers}\n請求正文：{parse.unquote(r.request.body)}\n響應頭：{r.headers}\n響應正文：{r.text}\n")
def test_02(self): #代碼邏輯::獲取當前最新發(fā)布會ID，ID-1即為發(fā)布會已經存在的ID（發(fā)布會ID是遞增加1）
'''添加發(fā)布會-發(fā)布會ID已存在'''
id = getNewID.getNewID() # 獲取當前最新發(fā)布會ID
data=addEventDataTemplate.getEventData(id)#獲取添加最新發(fā)布會的數據模板
data['eid']=data['eid']-1 #最新模板ID減一即為重復ID
r=requests.post(self.url,data=data)
status = r.json()['status']
self.assertEqual(10022, status)
logging.info(f"case:添加發(fā)布會宛徊，發(fā)布會ID已存在\n請求地址：{r.url}\t請求方式:{r.request.method}\n請求頭：{r.request.headers}\n請求正文：{parse.unquote(r.request.body)}\n響應頭：{r.headers}\n響應正文：{r.text}\n")
def test_03(self): #代碼邏輯::先新增發(fā)布會佛嬉，再獲取最新發(fā)布會ID，設置入參的name為重復闸天。
'''添加發(fā)布會-發(fā)布會標題已存在'''
#新增發(fā)布會
id = getNewID.getNewID() # 獲取當前最新發(fā)布會ID
r=requests.post(self.url,data=addEventDataTemplate.getEventData(id)) #先新增一個發(fā)布會
id = getNewID.getNewID() # 獲取當前最新發(fā)布會ID
data = addEventDataTemplate.getEventData(id)#獲取添加最新發(fā)布會的數據模板
data['name']=f'發(fā)布會測試標題{id}' #最新模板ID減一暖呕，標題即為重復
r=requests.post(self.url,data=data)
status = r.json()['status']
self.assertEqual(10023,status)
logging.info(f"case:添加發(fā)布會，發(fā)布會標題已存在\n請求地址：{r.url}\t請求方式:{r.request.method}\n請求頭：{r.request.headers}\n請求正文：{parse.unquote(r.request.body)}\n響應頭：{r.headers}\n響應正文：{r.text}\n")
def test_04(self): #代碼邏輯::獲取最新發(fā)布會ID苞氮，設置入參湾揽，開始時間:改為-,再提交請求
'''添加發(fā)布會-發(fā)布會時間錯誤'''
id = getNewID.getNewID() # 獲取當前最新發(fā)布會ID
data = addEventDataTemplate.getEventData(id)#獲取添加最新發(fā)布會的數據模板
data['start_time']=data['start_time'].replace(':','-') #時間 : 改為 - ,即為時間錯誤
r = requests.post(self.url, data=data)
status = r.json()['status']
self.assertEqual(10024,status)
logging.info(f"case:添加發(fā)布會，發(fā)布會時間錯誤\n請求地址：{r.url}\t請求方式:{r.request.method}\n請求頭：{r.request.headers}\n請求正文：{parse.unquote(r.request.body)}\n響應頭：{r.headers}\n響應正文：{r.text}\n")
if __name__ == '__main__':
unittest.main(verbosity=2)
lib庫 getNewID.py：
def getNewID():
'''獲取最新的（最大的）發(fā)布會編號id'''
import sqlite3
con=sqlite3.connect(r'D:\backup\guest2-master\db.sqlite3')
cur=con.cursor()
cur.execute("select max(id) from sign_event")
new_id=cur.fetchone()
new_id=new_id[0]
cur.close()
con.close()
return new_id
lib庫 addEventDataTemplate.py：
import datetime
def getEventData(id):
'''添加發(fā)布會 body模板'''
startTime=(datetime.datetime.now()+datetime.timedelta(days=30)).strftime("%Y-%m-%d %H:%M:00") #獲得當前時間笼吟，并往后30天為發(fā)布會時間
data={
'eid':id+1,
'name':f"發(fā)布會測試標題{id+1}", #當前發(fā)布會編號加1
'limit':100, #默認值
'status':1, #默認值
'address':'新街口金鷹', #默認值
'start_time':startTime #%格式 Y-%m-%d %H:%M:00
}
return data
由于篇幅的原因钝腺，其它的代碼省略。
最后的測試結果：
日志結果如下：
總結：在寫代碼的過程中赞厕，每個測試用例的代碼邏輯非常重要艳狐，不管是什么邏輯，得保證每個測試用例代碼都可以獨立運行皿桑，不會產生耦合毫目。還有在測試接口的時候，經常與數據庫打交道诲侮，比如獲取數據镀虐，判斷測試結果等。
