一、Allure特点
- 支持多平台；
- java语言开发的，支持多语言pytest，js、php、ruby等；
- 可以提供详细的测试报告，测试步骤、log、标题、优先级、附件等；
- 可以提供high level统计报告；
- 可以集成到jenkins展示项目趋势图；
二、Allure用法
可以添加步骤、描述、日志、图片、视频、标题等。
1.
@allure.epic()有多个项目，不同的项目定义为不同的epic；2.
@allure.feature()模块名称，按用例的模块区分，类级别相当于testsuite；3.
@allure.story()用例标题，对用例进行描述，如失败的用例、成功的用例，方法级别，对应功能或模块下不同场景，分支功能；4.
@allure.title()用例标题，给用例取名字；5.
@allure.testcase()用例相关链接，这条自动化测试用例关联的功能测试用例存放url；6.
@allure.issue()缺陷地址，对应缺陷关联系统中的缺陷地址；7.
@allure.description()用例描述，对用例的详细描述步骤；8.
@allure.severity()用例等级，对用例划分等级blocker阻塞、critical严重、normal普通、minorUI相关的、trivial建议；9.
@allure.link()定义链接，用于定义一个需要在测试报告中展示的链接；10.
@allure.attachment()附件，添加测试报告附件；
以上十种用法，参考下面代码示例~
import allure
TEST_CASE_LINK = "http://www.baidu.com"
bugid = 140
@allure.feature("搜索模块")
class TestSearch():
@allure.story("搜索成功")
#@allure.title("搜索词为中文")
def test_case_succ(self):
pass
@allure.story("搜索失败")
def test_case_fail(self):
pass
# 添加url链接
@allure.link('http://www.lingtiku.com', name='灵题库地址')
def test_link(self):
pass
# 添加bug管理平台链接
@allure.issue(f'http://www.baidu.com/{bugid}', 'bug地址')
def test_issue(self):
pass
# 添加用例管理平台链接
@allure.testcase('TEST_CASE_LINK', '测试用例管理平台地址')
def test_testcase(self):
pass
# 添加优先级
@allure.severity(allure.severity_level.BLOCKER)
# @allure.severity(allure.severity_level.CRITICAL)
# @allure.severity(allure.severity_level.NORMAL)
# @allure.severity(allure.severity_level.MINOR)
# @allure.severity(allure.severity_level.TRIVIAL)
def test_severity(self):
pass
@allure.feature("登录模块")
class TestLogin():
@allure.title("登录成功")
def test_case_login(self):
with allure.step("步骤1：打开应用"):
print("打开应用")
# 添加附件-截图
allure.attach.file("/Users/xxx/Desktop/11.jpg", name="截图", attachment_type=allure.attachment_type.JPG, extension=".jpg")
with allure.step("步骤2：进入登录页面"):
print("登录页面")
allure.attach("这是一段测试文本",name="文本展示")
with allure.step("步骤3：登录应用"):
assert 1 == 1
print("输入用户名密码")
allure.attach('<script type="text/javascript" src="//img0.bdstatic.com/static/common/widget/ui/base/base_a66ce51.js"></script>', name="html文本展示", attachment_type=allure.attachment_type.HTML, extension=".html")
with allure.step("步骤4：登录成功"):
print("登录成功")
三、Allure特性
1、allure特性： feature与story关系
- feature：类级别相当于testsuite
- story：方法级别，对应功能或模块下不同场景，分支功能
- feature与story类似父子关系
2、allure特性： step
测试过程中每个步骤，一般放在逻辑方法中，每切换一个新页面当做一个step，可以帮助标注出哪个测试步骤成功，哪个测试步骤失败
with allure.step():可以放在测试用例方法里面，但测试步骤的代码需要被该语句包含--参考上方代码
3、allure特性： testcase/issue/link
为了将allure报告和测试管理系统集成，主要有用例或bug管理，可以更快速的跳转到公司内部地址
场景：测试报告中添加用例的链接、bug链接地址、相关的链接地址
- @allure.link()
- @allure.issue()
- @allure.testcase()
4、allure特性： 设置优先级
通常测试有p0、冒烟测试、验证上线测试，按优先级来分别执行
- blocker阻塞，功能未实现，不能进行下一步
- critical严重，功能点确实
- normal普通，边界错误，格式错误
- minor 次要缺陷，UI相关的
- trivial轻微缺陷，建议，提示不规范等
通过allure.severity来附加标记：@allure.severity(allure.severity_level.TRIVIAL)
@allure.severity(allure.severity_level.BLOCKER)
@allure.severity(allure.severity_level.CRITICAL)
@allure.severity(allure.severity_level.NORMAL)
@allure.severity(allure.severity_level.MINOR)
@allure.severity(allure.severity_level.TRIVIAL)
按优先级执行 pytest -s -v 文件名 --allure-serverties normal,critical --alluredir=./result则只执行normal和critical两种优先级的case，其他优先级则不执行。
5、allure特性：测试报告中添加附件
希望在报告中看到测试用例的详细内容，如文本、数据、图片、视频、网页
添加方法，在测试步骤中添加 allure.attach(body(内容),name,attachment_type,extension)
allure.attach.file("/Users/jinchunzhi/Desktop/11.jpg",name ="截图",attachment_type=allure.attachment_type.JPG,extension=".jpg")
allure.attach("这是一段测试文本",name="文本展示")
allure.attach('<script type="text/javascript" src="//img0.bdstatic.com/static/common/widget/ui/base/base_a66ce51.js"></script>', name="html文本展示", attachment_type=allure.attachment_type.HTML, extension=".html")
四、Allure运行方式
1、以python文件运行
import os
import pytest
if __name__ == '__main__':
# 执行优先级blocker的case
# pytest.main(['-s', '-v', '--allure-severities=blocker', '--alluredir=result', '--clean-alluredir'])
# 以模块features运行
#pytest.main(['-s', '-v', '--allure-features=搜索模块', '--alluredir=result', '--clean-alluredir'])
# 运行整个文件
pytest.main(['-s', '-v', '--alluredir=result', '--clean-alluredir'])
# 打开在线测试报告
#os.system('allure serve ./result')
# 生成最终版测试报告
os.system('allure generate ./result/ -o ./report/ --clean')
# 打开最终版测试报告
os.system('allure open -h 127.0.0.1 -p 8080 ./report')
2、以常用行方式运行
1.生成测试报告的中间结果，json和txt文件
pytest test_allure.py --alluredir ./result --clean-alluredir2.生成在线测试报告
allure serve ./result3.生成最终版本测试报告（指定文件夹名称、清理上一次运行结果）
allure generate ./result/ -o ./report/ --clean4.打开最终版本测试报告
allure open -h 127.0.0.1 -p 8080 ./report
