HttpRunner接口自動化測試框架

本文轉載自查看原文 2019-02-24 17:38 7628 自動化測試總結

簡介

2018年python開發者大會上，了解到HttpRuuner開源自動化測試框架，采用YAML/JSON格式管理用例，能錄制和轉換生成用例功能，充分做到用例與測試代碼分離，相比excel維護測試場景數據更加簡潔。在此，利用業余時間研究這個框架去實現接口自動化測試。

HttpRunner 是一款面向 HTTP(S) 協議的通用開源測試框架，只需編寫維護一份 YAML/JSON 腳本，即可實現自動化測試、性能測試、線上監控、持續集成等多種測試需求。

主流接口自動化工具框架：

從上圖可知，技術選型一般會優先考慮Requests+Python和HttpRunner，Requests+Python在自動化測試總結分類里面有文章講過，這里我們針對HttpRunner進行探索。

框架流程

主要特性：

繼承 Requests 的全部特性，輕松實現 HTTP(S) 的各種測試需求
采用 YAML/JSON 的形式描述測試場景，保障測試用例描述的統一性和可維護性
借助輔助函數（debugtalk.py），在測試腳本中輕松實現復雜的動態計算邏輯
支持完善的測試用例分層機制，充分實現測試用例的復用
測試前后支持完善的 hook 機制
響應結果支持豐富的校驗機制
基於 HAR 實現接口錄制和用例生成功能（har2case）
結合 Locust 框架，無需額外的工作即可實現分布式性能測試
執行方式采用 CLI 調用，可與 Jenkins 等持續集成工具完美結合
測試結果統計報告簡潔清晰，附帶詳盡統計信息和日志記錄
極強的可擴展性，輕松實現二次開發和 Web 平台化

環境安裝：

HttpRunner 是一個基於 Python 開發的測試框架，可以運行在 macOS、Linux、Windows 系統平台上。HttpRunner 支持 Python 3.4 及以上的所有版本，推薦建議使用 Python 3.4 及以上版本。

使用pip命令安裝：pip3 install httprunner 【因本人環境裝有python兩個版本，這里使用是python3.6版本，就使用pip3命令，如是python2.7版本的話，就用pip命令安裝】

安裝完成后校驗：

如版本號正常顯示，則說明安裝正常。

基礎功能

　　1、錄制生成用例

在轉換生成測試用例之前，需要先將抓取得到的數據包導出為 HAR 格式的文件。使用Charles抓包工具 Proxy中的操作方式為，選中需要轉換的接口（可多選或全選），點擊右鍵，在懸浮的菜單目錄中點擊【Export...】，格式選擇HTTP Archive(.har)后保存即可；假設我們保存的文件名稱為test.har

轉換測試用例

在命令行終端中運行 har2case 命令，即可將 test.har 轉換為 HttpRunner 的測試用例文件。使用 har2case 轉換腳本時默認轉換為 JSON 格式

加上 -2y/--to-yml 參數后轉換為 YAML 格式

兩種格式完全等價，YAML 格式更簡潔，JSON 格式支持的工具更豐富，大家可根據個人喜好進行選擇。

生成后的用例如下圖所示：

json格式：

YAML格式：

config：作為整個測試用例集的全局配置項
test：對應單個測試用例
name 這個test的名字
request 這個test具體發送http請求的各種信息, 如下:
url 請求的路徑 (若config中有定義base_url, 則完整路徑是用 base_url + url )
method 請求方法 POST, GET等等
data 傳入參數值
validate 完成請求后, 所要進行的驗證內容. 所有驗證內容均通過該test才算通過,否則失敗.

　　2、運行測試

若希望測試用例在運行過程中，遇到失敗時不再繼續運行后續用例，則可通過在命令中添加--failfast實現。如：hrun test.yaml --failfast

若需要查看到更詳盡的信息，例如請求的參數和響應的詳細內容，可以將日志級別設置為DEBUG，即在命令中添加--log-level debug。如：hrun test.yaml --log-level debug

為了方便定位問題，運行測試時可指定 --save-tests 參數，即可將運行過程的中間數據保存為日志文件。

日志文件將保存在項目根目錄的 logs 文件夾中，生成的文件有如下三個（XXX為測試用例名稱）：

XXX.loaded.json：測試用例加載后的數據結構內容，加載包括測試用例文件（YAML/JSON）、debugtalk.py、.env 等所有項目文件，例如 test-quickstart-6.loaded.json
XXX.parsed.json：測試用例解析后的數據結構內容，解析內容包括測試用例引用（API/testcase）、變量計算和替換、base_url 拼接等，例如 test-quickstart-6.parsed.json
XXX.summary.json：測試報告生成前的數據結構內容，例如 test-quickstart-6.summary.json

　　3、測試報告

默認情況下，生成的測試報告文件會位於項目根目錄的 reports 文件夾中，文件名稱為測試開始的時間戳。HttpRunner 中自帶了一個 Jinja2 格式的默認報告模版

測試報告形式如下：

在 Summary 中，會羅列本次測試的整體信息，包括測試開始時間、總運行時長、運行的Python版本和系統環境、運行結果統計數據。