pytest+allure

安装

下载：github win环境下载zip

环境变量：

pycharm：

        pip install allure-pytest

验证安装

生成结果：

if __name__ == '__main__':pytest.main(['-s','test_createTag2.py','--alluredir','result'])

生成报告：

allure generate ./result  -c -o ./report

完整： 

if __name__ == '__main__':pytest.main(['-s','test_createTag2.py','--alluredir','./result'])os.system('allure generate ./result -c -o ./report')

添加装饰器/方法后才能在报告中显示相关结果

12、用法（二）之生成测试报告_哔哩哔哩_bilibili

使用装饰器

1. @allure.feature 和 @allure.story： 这些装饰器用于描述测试的功能和具体的故事或场景。

   1import allure
   2
   [e-mail]('User Management')
   [e-mail]('Login')
   5def test_valid_login():
   6    # 测试代码

2. @allure.severity： 设置测试案例的严重性等级。

   [e-mail](allure.severity_level.CRITICAL)
   2def test_critical_function():
   3    # 测试代码

3. @allure.issue 和 @allure.tms_link： 链接到问题跟踪系统中的问题或测试管理系统中的测试用例。

   [e-mail]('PROJECT-123')
   [e-mail]_link('TC-1234')
   3def test_linked_case():
   4    # 测试代码

在测试函数内使用allure方法

1. allure.attach()： 添加文本、图片、HTML或任何类型的附件到测试报告。

   1def test_attach():
   2    allure.attach('This is a text attachment', attachment_type=allure.attachment_type.TEXT)
   3    # 测试代码

2. allure.step()： 创建可折叠的步骤，使测试报告更清晰。

   1def test_with_steps():
   2    with allure.step('Step 1'):
   3        # 执行步骤1
   4    with allure.step('Step 2'):
   5        # 执行步骤2

Environment设置

• Environment可以理解为环境变量；

• 默认为空；

• 可以自己设置。

   

创建environment.xml

<environment><parameter><key>Browser</key><value>Chrome</value></parameter><parameter><key>Browser.Version</key><value>111.0.5563.65</value></parameter><parameter><key>Env</key><value>Test</value></parameter><parameter><key>IP</key><value>192.168.1.133</value></parameter><parameter><key>Allure-Pytest.Version</key><value>2.8.12</value></parameter></environment>

  

Categories设置

1.Categories即分类，

测试用例结果的分类

默认有两种分类：

# Product defects 产品缺陷（测试结果：failed）

# Test defects 测试缺陷（测试结果：error/broken）

可以自定义分类。

2. 设置方式

创建categories.json文件

[{"name": "Passed tests","matchedStatuses": ["passed"]},{"name": "Ignored tests","matchedStatuses": ["skipped"]},{"name": "Infrastructure problems","matchedStatuses": ["broken", "failed"],"messageRegex": ".*bye-bye.*"},{"name": "Outdated tests","matchedStatuses": ["broken"],"traceRegex": ".*FileNotFoundException.*"},{"name": "Product defects","matchedStatuses": ["failed"]},{"name": "Test defects","matchedStatuses": ["broken"]}]

  参数说明：

• name：分类名称
• matchedStatuses：测试用例的运行状态，默认["failed", "broken", "passed", "skipped", "unknown"]
• messageRegex：测试用例运行的错误信息，默认.* ，通过正则匹配
• traceRegex：测试用例运行的错误堆栈信息，默认.* ，通过正则匹配

  

@pytest.mark.parametrize()

Allure能够很好的支持@pytest.mark.parametrize()进行参数化

  

with allure.step

@allure.step()标记函数使之成为测试步骤，而在测试函数/方法中，我们还可以通过with allure.step()的方式标记测试步骤。

它们之间的区别在于，@allure.step()用于标记通用函数，当这个被标记的函数被调用后，会插入步骤说明并展示在Allure报告中。

而with allure.step()则是将普通的代码标记为测试步骤，执行到这段代码时则会在Allure报告中展示步骤说明。

我们在上面代码的基础上，加入with allure.step()，示例如下：

import pytest
import allure
import osclass Counter:def __init__(self):self.value = 0def increment(self):self.value += [e-mail]("get value")def get_value(self):return [e-mail]
def counter(request):#request 参数不需要传值#setupwith allure.step("with.allure.step"):c = Counter()print("setup_value:",c.value)def reset_counter():#还原数据c.value = 0print("teardown_value:",c.value)request.addfinalizer(reset_counter)return cdef test_counter(counter):print('test-start')assert counter.get_value() == 0counter.increment()assert counter.get_value() == 1counter.increment()assert counter.get_value() == 2if __name__ == '__main__':pytest.main(['-s','test_yield_finalizer.py','--alluredir','./result'])os.system('allure generate ./result -c -o ./report')

fixture

pytest的fixture函数可以实现setup、teardown的功能，而Allure会跟踪每个fixture的调用情况，详细显示调用了哪些fixture和参数以及调用顺序。

  

@pytest.mark.skip(reason='这个是跳过的原因！')

@pytest.mark.skipif(condition, reason='跳过的原因！')

@pytest.skip()在用例内部跳过测试用例

@pytest.mark.xfail(condition, reason=‘理由!’)

tags

其他：

https://blog.csdn.net/2301_81967703/article/details/138576981

allure.attach

allure.attach用于在测试报告中添加附件，补充测试结果。附件格式可以是txt、jpg等，附件内容通常是测试数据、截图等。

allure.attach提供了两种方法：allure.attach()，allure.attach.file()

allure.attach()
作用：在测试报告中生成指定内容、名称、类型的附件

语法：allure.attach(body, name=None, attachment_type=None, extension=None)

参数说明：

body，需要显示的内容，也可以理解为写入附件的内容
name，附件名称
attachment_type，附件类型，如csv、jpg、html 等，由allure.attachment_type提供
extension：附件扩展名，不常用
allure.attach.file()
作用：向测试用例中上传附件

语法：allure.attach.file(source, name=None, attachment_type=None, extension=None)

参数说明：source为文件路径，其他参数与allure.attach()参数一致。

在UI自动化测试中，会经常用到这个方法来上传用例执行的截图。
 

Note:

关于Flaky test