Allure有很多好用的功能,这里只是记录我自己的总结的一些经验。
首页(Overview)
报告首页,可以选择中文语言展示。右侧的面板可以拖拽。放到自己喜欢的位置。设置会存到 local Storage
中,下次访问直接显示中文。ALLURE_REPORT_SETTINGS:{"language":"zh","sidebarCollapsed":false}
。 ALLURE_REPORT_SETTINGS_WIDGETS
存放页面模块展示位置。
修改报告Logo
将Logo图片放在allure\plugins\custom-logo-plugin\static
目录下。编辑当前目录下的styles.css
。
.side-nav__brand {background: url('logo.png') no-repeat left center !important;padding-left: 180px !important;margin-left: 10px;}
替换背景图片。
本地运行时,展示趋势图(TREND)的方法
当本地运行时,无法展示历史执行信息。
测试执行结束,先不要生产测试报告
将
html\history
下的所有文件复制黏贴到
report\history
下。(可能不存在此文件,先创建)执行生成报告命令。
该操作影响到:
Graphs
页面历史信息展示Case详情中的
History
信息
定义环境信息
创建 environment.xml
文件,将文件放在 report
目录下。
report目录是执行pytest --alluredir report时,生成的测试报告数据文件夹
文件格式
<environment> <parameter> <key>Browser</key> <value>Chrome</value> </parameter> <parameter> <key>Browser.Version</key> <value>78.0</value> </parameter> <parameter> <key>执行环境</key> <value>Develop</value> </parameter> <parameter> <key>执行机</key> <value>10.0.228.51</value> </parameter></environment>
首页展示效果:
分类页(Categories)
此页面默认分类为:
Product defects (failed tests)
Test defects (broken tests)
创建 categories.json
放在report
目录下。
[ { "name": "跳过", "messageRegex": ".*", "matchedStatuses": ["skipped"] }, { "name": "查询超时", "traceRegex": ".*QueryTimeOut.*", "matchedStatuses": ["broken","failed"] }, { "name": "元素查找超时", "traceRegex": ".*TimeoutException.*", "matchedStatuses": ["broken","failed"] }, { "name": "断言失败", "traceRegex": ".*AssertionError.*", "matchedStatuses": ["broken","failed"] }, { "name": "HTTP调用错误", "traceRegex": ".*HTTPError.*", "matchedStatuses": ["broken","failed"] }]
将异常或是错误,通过正则进行分类展示。利用这个功能可以将测试结果进行有效分类,比如如上所示,将QueryTimeOut
都归到 查询超时的分类中。
测试框架中自定义详细的异常。便于归类展示。
测试套(Suites)和功能(Behaviors)
巧用标签
这两个页面的使用场景不同,使用方法基本一致。只说Suites
。页面展现的层级结构完全由不同的标签决定。在测试类或方法上添加标签。
@allure.parent_suite('创建基础数据')@allure.suite('基础数据')@allure.sub_suite('工单基础数据')@allure.title('修改2017001为一级施工人员')
这里有个使用上的小技巧, 当一个py文件存在多个用例时,每个方法或类上都添加相同的标签,显得很累赘,也浪费时间。可以使用pytestmark
来定义 module
级别的标签。在文件最上方,定义一次。影响当前所有的测试用例。
pytestmark = [pytest.mark.OrderWork, allure.parent_suite("创建基础数据"), allure.suite("基础数据"), allure.sub_suite('工单基础数据') ]
这样在测试用例上只添加title
即可。同理,其他标记也可以这样使用。
标签:
class LabelType(str): EPIC = 'epic' FEATURE = 'feature' STORY = 'story' PARENT_SUITE = 'parentSuite' SUITE = 'suite' SUB_SUITE = 'subSuite' SEVERITY = 'severity' THREAD = 'thread' HOST = 'host' TAG = 'tag' ID = 'as_id' FRAMEWORK = 'framework' LANGUAGE = 'language'
巧用Step
在测试过程中增加详细测试步骤。并将格式约定为'操作:内容'。
冒号左边为操作,如:Step,验证,API,聚合,查询等。
中文冒号,页面展示更舒服。
冒号右边为具体操作内容。
还可以将参数添加到step中。
所有接口和页面操作方法的封装。均添加装饰器:
@allure.step("API:调用XXX接口")
@allure.step("Step:点击XXX按钮")
确保所有测试执行过程都有记录。
方法中使用 with allure.step()
增加测试步骤。
with allure.step('Step: 创建营销方案'): ...
效果:
title
测试类和方法均添加 title
,定义中文用例名称。
@allure.title('测试登录')
只是一些想到的心得。之后会分享一些具体的使用~
下面的学习资料总有一个适合你:
本文分享自微信公众号 - 测试技术圈(SoftwareTesters)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。