前言
allure是一个测试报告框架,支持java的Junit/testng等框架,当然也可以支持python的pytest框架，也可以集成到Jenkins上展示高大上的报告界面。
环境准备
python3.7
windows环境
pycharm
allure-pytest
allure2
java1.8
安装allure
- 安装allure-pytest
pip install allure-pytest
-
安装allure2
（1） 下载allure2，解压文件
（2） 配置环境变量
找到allure2文件的bin目录加入到path环境变量中
配置环境变量g 打开cmd输入如下命令
C:\Users>allure --version
2.12.1
这样表示安装成功
生成报告
- 通过命令行执行测试用例文件，生成xml报告
pytest --alluredir=生成的测试结果数据保存的目录 测试文件所在路径
# 如下：
pytest --alluredir=report/xml test_demo.py
- 通过allure2把xml报告生成html报告
allure generate xml报告路径 -o html报告保存路径
# 如下：
allure generate report/xml -o report/html --clean
# –clean目的是先清空测试报告目录，再生成新的测试报告
-
打开报告
打开报告
测试报告
allure特性
1. feature与story
- fetature相当于一个功能，一个大的模块
- story相当于对应这个功能或者模块的不同场景，分之功能；
- feature和story类似父子关系
import allure
import logging
logging.basicConfig(level=logging.DEBUG)
@allure.feature("测试登陆功能")
class TestA():
def setup_class(self):
logging.info("初始化")
def teardown_class(self):
logging.info("结束动作")
def test_1(self):
assert 1 == 1
@allure.story("测试登陆失败的场景")
def test_2(self):
assert 1 == 2
feature与story报告结果
feature与story测试报告
feature与story测试报告
可以看到报告更清晰，起到了类似与测试用例分类显示的效果。
2. severity 对测试用例分级别
- Blocker级别：中断缺陷（客户端程序无相应，无法执行下一步操作）
- Critical级别：临界缺陷（功能点缺失）
- Normal级别：普通缺陷（数值计算错误）
- Minor级别：次要缺陷（界面错误与UI需求不符）
- Trivial级别：轻微缺陷（必要项无提示，或者提示不规范）
一般分三个级别就好了，Minor、Normal、critical
实例
import allure
import logging
logging.basicConfig(level=logging.DEBUG)
class TestA():
def setup_class(self):
logging.info("初始化")
def teardown_class(self):
logging.info("结束动作")
@allure.severity("minor")
def test_1(self):
assert 1 == 1
@allure.severity("critical")
def test_2(self):
assert 1 == 2
@allure.severity("normal")
def test_3(self):
assert 3 == 3
命令行执行，
$ pytest --alluredir=report/xml --allure-severities=minor test_demo2.py
# 选项--allure-severities=minor 主要用来指定执行那些级别的用例
# 类似与pytest的 -m选项，把测试用例进行分组分组
执行结果
执行结果
3. step 测试过程中记录每个关键步骤
- 在app，web自动测试中，建议每切换到一个新的页面，当做一个step。
实例
"""打开社区的第三个置顶帖，打开帖子，并点击帖子内的连接，租后断言预期界面的关键字是否存在， 把源代码贴到回复里"""
from selenium import webdriver
import pytest
import allure
@allure.feature("测试testerhome社区")
class TestTesterHome():
# 初始化，打开testerhome
def setup_method(self):
self.driver = webdriver.Chrome("/Users/lan/PycharmProjects/testerhomer_xuexi/src/selenium_demo/driver/chromedriver")
self.url = "https://testerhome.com/"
with allure.step("打开testerhome"):
self.driver.get(self.url)
self.driver.implicitly_wait(10)
@allure.story("并点击帖子内的连接，断言预期界面的关键字是否存在")
def test_open_testerhome(self):
with allure.step("点击先到先得这个帖子，切换到贴子详情"):
self.driver.find_element_by_partial_link_text("先到先得").click()
# 获取当前窗口句柄
sreach_windows = self.driver.current_window_handle
with allure.step("点击帖子里面到链接，切换到该链接页面"):
self.driver.find_element_by_link_text("https://testerhome.com/topics/19664").click()
# 获取所有窗口句柄
all_handles = self.driver.window_handles
for handle in all_handles:
if handle != sreach_windows:
self.driver.switch_to.window(handle)
with allure.step("获取页面标题"):
value = self.driver.find_element_by_id("有奖投票").text
assert value == "有奖投票"
# 关闭浏览器
def teardown_method(self):
self.driver.quit()
if __name__ == '__main__':
pytest.main()
命令行执行
$ pytest --alluredir=report/xml test_demo3.py
$ allure generate report/xml -o report/html --clean
测试报告
step测试报告
可以看到报告上每一个测试步骤都很清楚，方便问题的定位。
allure 运行不同的测试用例
- 按features运行测试用例
pytest --alluredir=report/xml --allure_features=测试登陆功能 test_demo2.py
- 按story运行测试用例
pytest --alluredir=report/xml --allure_stories=测试登陆成功的场景 test_demo2.py
- 按severity运行测试用例
pytest --alluredir=report/xml --allure_severities=blocker test_demo2.py
attach 添加附件（截图等）
在报告中增加附件：allure.attach('arg1', 'arg2', 'arg3')
arg1：是在报告中显示的附件名称
arg2：表示添加附件的内容
arg3：表示添加的类型(支持:HTML,JPG,PNG,JSON,OTHER,TEXTXML)
from allure_commons.types import AttachmentType
allure.attach(self.driver.get_screenshot_as_png(), name="图片名称", attachment_type=AttachmentType.PNG)
实例
"""打开社区的第三个置顶帖，打开帖子，并点击帖子内的连接，租后断言预期界面的关键字是否存在， 把源代码贴到回复里"""
from selenium import webdriver
import pytest
import allure
from allure_commons.types import AttachmentType
@allure.feature("测试testerhome社区")
class TestTesterHome():
# 初始化，打开testerhome
def setup_method(self):
self.driver = webdriver.Chrome("/Users/lan/PycharmProjects/testerhomer_xuexi/src/selenium_demo/driver/chromedriver")
self.url = "https://testerhome.com/"
with allure.step("打开testerhome"):
self.driver.get(self.url)
self.driver.implicitly_wait(10)
@allure.story("并点击帖子内的连接，断言预期界面的关键字是否存在")
def test_open_testerhome(self):
with allure.step("点击先到先得这个帖子，切换到贴子详情"):
self.driver.find_element_by_partial_link_text("先到先得").click()
# 获取当前窗口句柄
sreach_windows = self.driver.current_window_handle
with allure.step("点击帖子里面到链接，切换到该链接页面"):
self.driver.find_element_by_link_text("https://testerhome.com/topics/19664").click()
# 获取所有窗口句柄
all_handles = self.driver.window_handles
for handle in all_handles:
if handle != sreach_windows:
self.driver.switch_to.window(handle)
with allure.step("获取页面标题"):
value = self.driver.find_element_by_id("有奖投票").text
assert value == "有奖投票"
# 截图
allure.attach(self.driver.get_screenshot_as_png(), name="Screenshot", attachment_type=AttachmentType.PNG)
# 关闭浏览器
def teardown_method(self):
self.driver.quit()
if __name__ == '__main__':
pytest.main()
补充 用代码执行目录下的所有测试文件并生成报告
import os
import sys
import pytest
BASEDIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(BASEDIR)
if __name__ == '__main__':
pytest.main(["-s", "--alluredir=report/xml", "tests/"])
