Python+Requests實現接口自動化


一般對於自動化的理解,有兩種方式的自動化。

第一,不需要寫代碼,完全由工具實現,這種方式的工具一般是公司自己研發的,方便黑盒測試人員使用。這種工具的特點是學習成本低,方便使用,但是通用性不強,也就是換了一家公司,就很有可能無法使用之前的工具。

第二,需要自己寫代碼,在別人的框架下編寫代碼測試,或者是需要自己搭建自動化測試框架。這種方式對測試人員的代碼要求高,學習成本高,但是通用性很強,去任何一家都可以用這套東西。
鑒於以上介紹,本文當然是介紹第二種方式了。

接口自動化測試,我們的目的是使用python進行接口測試,並完成輸出測試報告。我們需要用到的東西有如下:python3,unittest,requests。

一、接口項目

我們使用的項目是發布會簽到系統。總共有5個接口,雖然不多,但足夠學習使用。

接口文檔如下:

 

 

 

二、接口用例 

軟件測試都需要寫測試用例,不管你做的性能,自動化還是其它任何的測試工作。

真實的工作寫接口的測試用例,可能考慮很多場景,如接口的功能(正常場景),接口的邊界等價,接口的異常場景,接口參數組合,接口的性能等等。本文采用輸出法分析,根據出參的不同設計出測試用例。詳細用例參考如下:(用例太小看不清楚,可以查看原圖,然后放大) 

三、代碼階段

3.1 框架的設計

我們使用unittest框架,case目錄存放所有的測試用例,lib目錄存放自己封裝的一些代碼,result目錄存放測試結果和測試日志,runner.py是主程序。

3.2 主程序 runner.py

這個主程序跟之前的《selenium unittest實戰》文章類似,不再詳細介紹,不太一樣的地方是使用一個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項目用例執行情況',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測試接口,這個庫大名鼎鼎,而且官網還有中文。

官網網址:

4)每個測試用例都寫明代碼邏輯,方便以后調試。
5)如果遇到經常調用的東西,如獲取最新發布會ID,獲取添加發布會body數據,都封裝成庫。
6)最后根據出參的狀態碼斷言是否成功
7)使用 記錄每個測試用例的日志情況

添加發布會接口代碼文件:test_add_event.py

import requests
import unittest
import logging
import addEventDataTemplate
import getNewID
from urllib import  parse  #使用requests發送post請求,body的漢字會進行url編碼,即%xx形式。想看到原始body,需要使用parse.unquote進入url解碼
class Test_addEvent(unittest.TestCase):
    '''添加發布會接口'''
    @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):   #代碼邏輯::獲取當前最新發布會ID,設置入參,eid置空,發送post請求
        '''添加發布會-eid為空'''
        id=getNewID.getNewID()   #獲取當前最新發布會ID
        data=addEventDataTemplate.getEventData(id)  #獲取添加發布會的數據模板
        data['eid']=''  #eid為空,即參數錯誤
        r=requests.post(self.url,data=data)
        status=r.json()['status']
        self.assertEqual(10021,status)
        logging.info(f"case:添加發布會,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):    #代碼邏輯::獲取當前最新發布會ID,設置入參,發送post請求
        '''添加發布會-成功'''
        id = getNewID.getNewID()  # 獲取當前最新發布會ID
        data = addEventDataTemplate.getEventData(id)#獲取添加最新發布會的數據模板
        r=requests.post(self.url,data=data)
        status=r.json()['status']
        self.assertEqual(10000,status)
        logging.info(f"case:添加發布會,成功\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):   #代碼邏輯::獲取當前最新發布會ID,ID-1即為發布會已經存在的ID(發布會ID是遞增加1)
        '''添加發布會-發布會ID已存在'''
        id = getNewID.getNewID()  # 獲取當前最新發布會ID
        data=addEventDataTemplate.getEventData(id)#獲取添加最新發布會的數據模板
        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:添加發布會,發布會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):   #代碼邏輯::先新增發布會,再獲取最新發布會ID,設置入參的name為重復。
        '''添加發布會-發布會標題已存在'''
        #新增發布會
        id = getNewID.getNewID()  # 獲取當前最新發布會ID
        r=requests.post(self.url,data=addEventDataTemplate.getEventData(id))  #先新增一個發布會

        id = getNewID.getNewID()  # 獲取當前最新發布會ID
        data = addEventDataTemplate.getEventData(id)#獲取添加最新發布會的數據模板
        data['name']=f'發布會測試標題{id}' #最新模板ID減一,標題即為重復
        r=requests.post(self.url,data=data)
        status = r.json()['status']
        self.assertEqual(10023,status)
        logging.info(f"case:添加發布會,發布會標題已存在\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):   #代碼邏輯::獲取最新發布會ID,設置入參,開始時間:改為-,再提交請求
        '''添加發布會-發布會時間錯誤'''
        id = getNewID.getNewID()  # 獲取當前最新發布會ID
        data = addEventDataTemplate.getEventData(id)#獲取添加最新發布會的數據模板
        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:添加發布會,發布會時間錯誤\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():
    '''獲取最新的(最大的)發布會編號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):
    '''添加發布會 body模板'''
    startTime=(datetime.datetime.now()+datetime.timedelta(days=30)).strftime("%Y-%m-%d %H:%M:00")  #獲得當前時間,並往后30天為發布會時間

    data={
          'eid':id+1,
          'name':f"發布會測試標題{id+1}",  #當前發布會編號加1
          'limit':100,    #默認值
          'status':1,    #默認值
          'address':'新街口金鷹',    #默認值
          'start_time':startTime  #%格式   Y-%m-%d %H:%M:00
        }
    return data

由於篇幅的原因,其它的代碼省略。

請點查看公告處加入測試行業圈方式,(←可點擊查看公告處),在線解答哦

最后的測試結果:

日志結果如下:

總結:在寫代碼的過程中,每個測試用例的代碼邏輯非常重要,不管是什么邏輯,得保證每個測試用例代碼都可以獨立運行,不會產生耦合。還有在測試接口的時候,經常與數據庫打交道,比如獲取數據,判斷測試結果等。

看完這篇內容后,相信以下兩件事,也會對你的個人提升有所幫助:

 - 將來的你定會感謝現在拼命努力的自己 

 

> > > 學習路線+測試實用干貨精選匯總,需要可以關注一下我的公眾號,公眾號長期做「有價值的輸出」是最低標准,感謝您的閱讀。

> > > 一起探討交流,共同學習軟件測試技術、進測試Q群,里面有我們收集的配套教程和技術文檔提供給自學的伙伴。請點此處查看公告處加入社區方式,(←可點擊查看公告處)

> > > 薦語:與其花時間吃點點點苦,不如學學自動化,提高薪資然后摸魚,不香么?

📘 往期技術文章推薦

測試開發技能(1):持續集成這樣做,App自動化測試效率提高50%

測試開發技能(2):性能測試知識學習路線(看看這篇,好好學習)

測試開發技能(3):十分鍾弄懂最快的APP自動化工具uiautomator2 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM