一、什么是pytestallure
pytestallure是一个基于pytest测试框架的扩展,它可以为测试结果生成漂亮的HTML报告,让测试结果更加直观、易读。pytestallure的主要功能包括:测试结果展示、历史记录比较、执行时间计算、测试结果按模块分组等。
二、pytestallure的安装和配置
1、安装pytestallure支持包:
$ pip install pytest-allure-adaptor
2、安装allure-cli:
$ brew install allure
3、在项目中加入pytest.ini配置文件,配置pytestallure插件:
[pytest]
addopts = --alluredir ./allure_report
testpaths = ./tests
# 配置allure插件
pytest_allure_adaptor_host = localhost
pytest_allure_adaptor_port = 8080
pytest_allure_adaptor_reporter = allure
pytest_allure_adaptor_reporter_junit_path = ./allure_report/junit.xml
pytest_allure_adaptor_reporter_allure_path = ./allure_report/allure-report
pytest_allure_adaptor_reporter_others_path = ./allure_report/others
三、pytestallure的使用
1、pytestallure的基本用法是通过pytest的命令行参数来调用插件:
$ pytest --alluredir ./allure_report
2、使用pytestmark标记来标记测试用例的信息,例如优先级、故障原因等:
@pytest.mark.smoke
def test_demo():
'''这是一个示例测试函数'''
assert True
3、使用pytest-allure-adaptor提供的装饰器来分类测试用例的结果:
from allure_commons.types import Severity, Status
import allure
@allure.feature('购物车功能模块')
@allure.story('加入商品到购物车')
@allure.severity(Severity.CRITICAL)
def test_add_to_cart():
'''测试加入商品到购物车功能'''
assert True
@allure.feature('购物车功能模块')
@allure.story('从购物车删除商品')
def test_remove_from_cart():
'''测试从购物车删除商品功能'''
assert True
4、使用pytest-allure-adaptor提供的装饰器来生成测试步骤和截图:
@allure.step('打开浏览器')
def open_browser():
pass
@allure.step('输入用户名和密码')
def input_username_and_password():
pass
@allure.step('登录')
def click_login():
pass
def test_login():
'''测试登录功能'''
open_browser()
input_username_and_password()
click_login()
allure.attach('登录成功截图', '***')
@allure.step('添加商品到购物车')
def add_to_cart():
pass
@allure.step('检查购物车是否有商品')
def check_cart():
pass
def test_shopping_cart():
'''测试购物车功能'''
add_to_cart()
check_cart()
allure.attach('购物车内容截图', '***')
5、pytestallure还支持将测试结果按模块分组、比较历史记录等功能,可以通过pytest-allure-adaptor的命令行参数来进行配置。
四、pytestallure实践
下面是一个利用pytestallure进行web自动化测试的示例代码:
import allure
from selenium import webdriver
@allure.feature('百度搜索功能')
class TestBaiduSearch:
def setup_class(self):
self.driver = webdriver.Chrome()
self.driver.maximize_window()
def teardown_class(self):
self.driver.quit()
@allure.story('基本搜索')
def test_basic_search(self):
self.driver.get('https://www.baidu.com')
self.driver.find_element_by_id('kw').send_keys('pytest-allure')
self.driver.find_element_by_id('su').click()
assert 'pytest-allure' in self.driver.title
allure.attach(self.driver.get_screenshot_as_png(), '基本搜索截图', allure.attachment_type.PNG)
@allure.story('高级搜索')
def test_advanced_search(self):
self.driver.get('https://www.baidu.com')
self.driver.find_element_by_link_text('高级搜索').click()
self.driver.find_element_by_name('q1').send_keys('pytest-allure')
self.driver.find_element_by_id('domain').send_keys('github.com')
self.driver.find_element_by_id('su').click()
assert '百度搜索-更详细的搜索结果' in self.driver.title
allure.attach(self.driver.get_screenshot_as_png(), '高级搜索截图', allure.attachment_type.PNG)