前言：
最近在研究接口自動(dòng)化的框架急迂，好的測(cè)試報(bào)告在整個(gè)測(cè)試框架起到至關(guān)重要的部分影所。終于被我發(fā)現(xiàn)一個(gè)超好用的報(bào)告框架,不僅報(bào)告美觀,而且方便CI集成。
就是它僚碎，就是它：Allure Test Report：锩洹！勺阐！
先上一張報(bào)告效果圖：Allure Test Report.png
python版本及必要庫
pytest==3.6.0
pytest-allure-adaptor==1.7.10
allure-python-commons==2.7.0
2020-4-30更新
pytest==5.3.1
allure-pytest==2.8.6
allure-python-commons==2.8.6
??注：pytest-allure-adaptor已棄用卷中，改為allure-pytest；
安裝allure-pytest時(shí)渊抽，需將pytest-allure-adaptor卸載
一蟆豫、環(huán)境配置
安裝Python依賴庫：
pip3 install pytest
pip3 install allure-pytest
安裝 Command Tool：
brew tap qatools/formulas
brew install allure-commandline
官方參考文檔：https://docs.qameta.io/allure/#_pytest
二、生成html報(bào)告命令
1懒闷、pytest命令基礎(chǔ)上加--alluredir十减，生成xml報(bào)告。
pytest -s -q --alluredir [xml_report_path]
//[xml_report_path]根據(jù)自己需要定義文件夾愤估，作者定義為：/report/xml
2玩焰、需要使用 Command Tool 來生成我們需要的美觀報(bào)告由驹。
allure generate [xml_report_path] -o [html_report_path]
//[html_report_path]根據(jù)自己需要定義文件夾，作者定義為：/report/html
注??：直接用chrome瀏覽器打開報(bào)告昔园，報(bào)告可能會(huì)是空白頁面蔓榄。
解決辦法：
1闹炉、在pycharm中右擊index.html選擇打開方式Open in Browser就可以了。
2润樱、使用Firefox直接打開index.html渣触。
三、定制報(bào)告
Feature: 標(biāo)注主要功能模塊
Story: 標(biāo)注Features功能模塊下的分支功能
Severity: 標(biāo)注測(cè)試用例的重要級(jí)別
Step: 標(biāo)注測(cè)試用例的重要步驟
Issue和TestCase: 標(biāo)注Issue壹若、Case嗅钻，可加入U(xiǎn)RL
attach: 標(biāo)注增加附件
Environment: 標(biāo)注環(huán)境Environment字段
1、Features定制詳解
# -*- coding: utf-8 -*-
# @Time : 2018/8/17 上午10:10
# @Author : WangJuan
# @File : test_case.py
import allure
import pytest
@allure.feature('test_module_01')
def test_case_01():
"""
用例描述：Test case 01
"""
assert 0
@allure.feature('test_module_02')
def test_case_02():
"""
用例描述：Test case 02
"""
assert 0 == 0
if __name__ == '__main__':
pytest.main(['-s', '-q', '--alluredir', './report/xml'])
添加feature店展，Report展示見下圖养篓。feature.png
2、Story定制詳解
# -*- coding: utf-8 -*-
# @Time : 2018/8/17 上午10:10
# @Author : WangJuan
# @File : test_case.py
import allure
import pytest
@allure.feature('test_module_01')
@allure.story('test_story_01')
def test_case_01():
"""
用例描述：Test case 01
"""
assert 0
@allure.feature('test_module_01')
@allure.story('test_story_02')
def test_case_02():
"""
用例描述：Test case 02
"""
assert 0 == 0
if __name__ == '__main__':
pytest.main(['-s', '-q', '--alluredir', './report/xml'])
添加story赂蕴，Report展示見下圖柳弄。image.png
3、用例標(biāo)題和用例描述定制詳解
# -*- coding: utf-8 -*-
# @Time : 2018/8/17 上午10:10
# @Author : WangJuan
# @File : test_case.py
import allure
import pytest
@allure.feature('test_module_01')
@allure.story('test_story_01')
#test_case_01為用例title
def test_case_01():
"""
用例描述：這是用例描述概说，Test case 01碧注，描述本人
"""
#注釋為用例描述
assert 0
if __name__ == '__main__':
pytest.main(['-s', '-q', '--alluredir', './report/xml'])
添加用例標(biāo)題和用例描述，Report展示見下圖糖赔。image.png
4 萍丐、Severity定制詳解
Allure中對(duì)嚴(yán)重級(jí)別的定義：
1、 Blocker級(jí)別：中斷缺陷（客戶端程序無響應(yīng)放典，無法執(zhí)行下一步操作）
2逝变、 Critical級(jí)別：臨界缺陷（ 功能點(diǎn)缺失）
3、 Normal級(jí)別：普通缺陷（數(shù)值計(jì)算錯(cuò)誤）
4奋构、 Minor級(jí)別：次要缺陷（界面錯(cuò)誤與UI需求不符）
5壳影、 Trivial級(jí)別：輕微缺陷（必輸項(xiàng)無提示，或者提示不規(guī)范）
# -*- coding: utf-8 -*-
# @Time : 2018/8/17 上午10:10
# @Author : WangJuan
# @File : test_case.py
import allure
import pytest
@allure.feature('test_module_01')
@allure.story('test_story_01')
@allure.severity('blocker')
def test_case_01():
"""
用例描述：Test case 01
"""
assert 0
@allure.feature('test_module_01')
@allure.story('test_story_01')
@allure.severity('critical')
def test_case_02():
"""
用例描述：Test case 02
"""
assert 0 == 0
@allure.feature('test_module_01')
@allure.story('test_story_02')
@allure.severity('normal')
def test_case_03():
"""
用例描述：Test case 03
"""
assert 0
@allure.feature('test_module_01')
@allure.story('test_story_02')
@allure.severity('minor')
def test_case_04():
"""
用例描述：Test case 04
"""
assert 0 == 0
if __name__ == '__main__':
pytest.main(['-s', '-q', '--alluredir', './report/xml'])
添加Severity弥臼，Report展示見下圖宴咧。image.png
5、Step定制詳解
# -*- coding: utf-8 -*-
# @Time : 2018/8/17 上午10:10
# @Author : WangJuan
# @File : test_case.py
import allure
import pytest
@allure.step("字符串相加：{0}醋火，{1}")
# 測(cè)試步驟悠汽，可通過format機(jī)制自動(dòng)獲取函數(shù)參數(shù)
def str_add(str1, str2):
if not isinstance(str1, str):
return "%s is not a string" % str1
if not isinstance(str2, str):
return "%s is not a string" % str2
return str1 + str2
@allure.feature('test_module_01')
@allure.story('test_story_01')
@allure.severity('blocker')
def test_case():
str1 = 'hello'
str2 = 'world'
assert str_add(str1, str2) == 'helloworld'
if __name__ == '__main__':
pytest.main(['-s', '-q', '--alluredir', './report/xml'])
添加Step箱吕，Report展示見下圖芥驳。image.png
6、Issue和TestCase定制詳解
# -*- coding: utf-8 -*-
# @Time : 2018/8/17 上午10:10
# @Author : WangJuan
# @File : test_case.py
import allure
import pytest
@allure.step("字符串相加：{0}茬高，{1}") # 測(cè)試步驟兆旬，可通過format機(jī)制自動(dòng)獲取函數(shù)參數(shù)
def str_add(str1, str2):
print('hello')
if not isinstance(str1, str):
return "%s is not a string" % str1
if not isinstance(str2, str):
return "%s is not a string" % str2
return str1 + str2
@allure.feature('test_module_01')
@allure.story('test_story_01')
@allure.severity('blocker')
@allure.issue("http://www.baidu.com")
@allure.testcase("http://www.testlink.com")
def test_case():
str1 = 'hello'
str2 = 'world'
assert str_add(str1, str2) == 'helloworld'
if __name__ == '__main__':
pytest.main(['-s', '-q', '--alluredir', './report/xml'])
添加Issue和TestCase，Report展示見下圖怎栽。image.png
7丽猬、Environment定制詳解
# 具體Environment參數(shù)可自行設(shè)置
allure.environment(app_package='com.mobile.fm')
allure.environment(app_activity='com.mobile.fm.activity')
allure.environment(device_name='aad464')
allure.environment(platform_name='Android')
添加Environment參數(shù)宿饱，Report展示見下圖。Environment.png
8脚祟、attach定制詳解
file = open('../test.png', 'rb').read()
allure.attach(name='cart_pay_err', body=file, attachment_type=allure.attachment_type.PNG)
在報(bào)告中增加附件：
allure.attach(’arg1’,’arg2’,’arg3’)：
arg1：表示添加附件的內(nèi)容
arg2：是在報(bào)告中顯示的附件名稱
arg3：表示添加的類型(支持:HTML,JPG,PNG,JSON,OTHER,TEXTXML)
添加attach參數(shù)谬以，Report展示見下圖。image.png
此外由桌，Allure還支持Jenkins Plugin～
感興趣的話为黎，請(qǐng)移步Jenkins構(gòu)建Allure Report
以上，對(duì)你有幫助的話行您，點(diǎn)贊吧??～～
歡迎關(guān)注我的簡書,博客,TesterHome,Github～～～
