本文節選自霍格沃玆測試學院測試開發內部教材，進階學習文末加群！

測試報告在項目中是至關重要的角色，一個好的測試報告：

1. 可以體現測試人員的工作量；
2. 開發人員可以從測試報告中瞭解缺陷的情況；
3. 測試經理可以從測試報告中看到測試人員的執行情況及測試用例的覆蓋率；
4. 項目負責人可以通過測試報告查看整個項目還餘留多少問題，此次版本是否測試通過；

所以打造一個美觀、一目瞭然的測試報告，清晰的反應質量問題，並提供給相關人員瞭解項目的整體狀態，是非常必要的。

Pytest 結合 Allure 生成測試報告

Allure 框架是一種靈活的、輕量級、支持多語言測試報告工具，它不僅能夠以簡潔的 Web 報告形式顯示已測試的內容，而且允許參與開發過程的每個人從測試的日常執行中提取最大限度的有用信息。同時支持多種語言包括 Java、Python、JavaScript、Ruby、Groovy、PHP、.Net、 Scala。

安裝

Mac 可以使用 brew 安裝 allure，安裝命令如下：

brew install allure 

其他操作系統請參考：
https://docs.qameta.io/allure/#_installing_a_commandline

與 pytest 結合需要安裝 allure-pytest 插件：

pip install allure-pytest

查看 Allure 版本：

allure --version

運行

第一步：在 pytest 執行測試的時候，指定參數 --alluredir 選項及結果數據保存的目錄，代碼如下：

pytest --alluredir=tmp/my_allure_results

tmp/my_allure_results 中保存了本次測試的結果數據。

第二步：打開報告，需要啟動 allure 服務，在 terminal 中輸入 allure serve [path/to/allure_results]，代碼如下：

allure serve path/to/allure_results

也可以使用 allure generate 生成 HTML 格式的測試結果報告，並使用 allure open 來打開報告。

allure generate ./result/ -o ./report/ --clean

上面的命令將 ./result/ 目錄下的測試數據生成HTML測試報告到 ./report 路徑下，--clean 選項目的是先清空測試報告目錄，再生成新的測試報告，然後使用下面的命令打開報告。

allure open -h 127.0.0.1 -p 8883 ./report/ 

上面這個命令則會啟動一個 Web 服務將已經生成的測試報告打開。打開生成的測試報告，在默認的瀏覽器打開測試報告，報告如下：

上面的測試報告首頁中展示了此次測試的測試用例數量以及成功用例、失敗用例、跳過用例的比例、測試環境、SUITES、FEATURES BY STORIES 等基本信息。當與 Jenkins 做了持續置成後，TREND 區域還將顯示，歷次測試的通過情況。

首頁的左邊欄，還從不同的維度展示測試報告的其他信息。重點頁面介紹：

• Behaviors 頁面，按照 FEATURES 和 STORIES 展示測試用例的執行結果；
• Suites 頁面，Allure 測試報告將每一個測試腳本，作為一個 Suite。在首頁裡點擊 Suites 區域內的任何一條 Suite，都會進入 Suites 頁面；
• Graphs 頁面，展示了此次測試結果的統計信息，比如測試用例執行結果狀態、測試用例重要等級分佈、測試用例執行時間分佈等；
• 測試用例詳情頁面，在 Suites 頁面上點擊任何一條測試用例，Suites 頁面的右側將展示這條用例的詳細執行情況。在這個頁面可以看到測試用例的每個步驟，以及每個步驟的執行結果，包括步驟裡面添加的鏈接、圖片、網頁片段或者視頻作為重要信息的補充。在這裡可以一目了在的看到用例失敗的原因。

實戰案例 | 百度搜索功能自動化測試

在實際項目中，一旦用例報錯，我們希望能夠將當時應用的狀態記錄下來，記錄這些狀態的方式可以是日誌、截圖、視頻等手段，並將這些記錄在測試報告中，方便相關人員定位問題。我們基於 Pytest 與 Allure 結合生成測試報告來實現這個目標。

以百度 Web 網頁版本測試為例，百度首頁呈現的功能：新聞、網頁、貼吧、知道、音樂、圖片、視頻、地圖等，我們以百度網頁的搜索功能為例，使用 Allure、pytest 結合 Selenium 自動化測試框架，完成一個搜索功能的測試。

為了模擬百度搜索功能場景，這裡需要創建兩個文件，數據文件與用例文件。首先創建數據管理文件 data/data.yml，代碼如下：

- allure
- pytest
- unittest

然後，創建用例文件名為 test_baidudemo.py，代碼如下：

#!/usr/bin/env python
# -*- coding: utf-8 -*-

import allure
import pytest
import yaml
from selenium import webdriver
import time

@allure.testcase("http://www.github.com")
@allure.feature("百度搜索")
@pytest.mark.parametrize('test_data1', yaml.safe_load(\
open("data/data.yml")))
def test_steps_demo(test_data1):
    with allure.step("打開百度網頁"):
        driver = webdriver.Chrome()
        driver.get("http://www.baidu.com")
        driver.maximize_window()

    with allure.step(f"輸入搜索詞：{test_data1}"):
        driver.find_element_by_id("kw").send_keys(test_data1)
        time.sleep(2)
        driver.find_element_by_id("su").click()
        time.sleep(2)

    with allure.step("保存圖片"):
        driver.save_screenshot("./result/b.png")
        allure.attach.file("./result/b.png", \
        attachment_type=allure.attachment_type.PNG)
    with allure.step("關閉瀏覽器"):
        driver.quit()

代碼解析：

• allure.testcase 用例標識，給定用例的鏈接，可以與用例的管理地址關聯。
• allure.feature 功能模塊劃分，方便管理和運行測試用例。
• pytest.mark.parametrize 用來參數化測試用例。
• allure.step 用來添加測試步驟，在測試報告裡面會展示出來這個步驟說明。

執行：

 pytest test_baidudemo.py -s -q --alluredir=./result/

 allure serve ./result/

測試結果圖：

上面的測試報告展示運行時間，時長，用例數，通過率，以及測試套件 SUITES，環境等信息。
點擊左側欄最下方的 Package 可以看到所有的測試用例以及測試數據，點擊一條用例右側會展示出用例的優先級，數據，測試步驟以及每個步驟的的名稱及附加的圖片等信息。這裡添加了一個測試用例的鏈接，可以與測試用例的管理鏈接關聯起來，方便後期統計覆蓋率。

另外，pytest 與 Allure 也可以與 Jenkins 集成，實現自動化測試的持續集成。

更多技術文章分享及測試資料點此獲取