您的位置:

pytestallure详解

一、什么是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)