AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

pytest学习和使用23-通俗易懂的聊聊allure常用特性集合及使用方法说明

2023-03-30 134
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： pytest学习和使用23-通俗易懂的聊聊allure常用特性集合及使用方法说明

1 @allure.step()

  • @allure.step()装饰器，可以让测试用例在allure报告中显示详细的测试过程；
  • step() 只有一个参数title，传什么就在allure上就显示什么；
  • 举例：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_allure_step.py
# 作用：@allure.step特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import pytest
import allure

@allure.step("步骤1：用户登陆")
def test_login():
    pass

@allure.step("步骤2：用户数据检查")
def test_check():
    test_login()


if __name__ == '__main__':
    pytest.main(["-s", "test_allure_step.py"])
  • 运行命令再回顾下：
pytest -n auto --alluredir=allure test_allure_step.py
allure serve allure
  • 运行后如下：

在这里插入图片描述
在这里插入图片描述

  • 还有一种场景就是用例之间的嵌套， step() 支持支持位置参数和关键字参数；
  • 如下：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_allure_step1.py
# 作用：@allure.step特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import pytest
import allure

@allure.step("步骤1：用户登陆{0}, {passwd}")
def login(name, passwd):
    pass

@allure.step("步骤2:数据检查")
def check():
    login("zhang", "123456")

@allure.step("步骤3:登陆")
def test_case():
    check()

if __name__ == '__main__':
    pytest.main(["-s", "test_allure_step1.py"])

在这里插入图片描述

2 allure.attach

  • allure报告支持显示许多不同类型的附件；
  • 使用方法是：
allure.attach(body, name, attachment_type, extension)
  • 参数说明：
body：附件内容
name：附件名称
attachment_type：附件类型，是 allure.attachment_type 里面的其中一种
extension：附件扩展名
  • 而allure.attachment_type的类型如下，可以查看源码：
class AttachmentType(Enum):

    def __init__(self, mime_type, extension):
        self.mime_type = mime_type
        self.extension = extension

    TEXT = ("text/plain", "txt")
    CSV = ("text/csv", "csv")
    TSV = ("text/tab-separated-values", "tsv")
    URI_LIST = ("text/uri-list", "uri")

    HTML = ("text/html", "html")
    XML = ("application/xml", "xml")
    JSON = ("application/json", "json")
    YAML = ("application/yaml", "yaml")
    PCAP = ("application/vnd.tcpdump.pcap", "pcap")

    PNG = ("image/png", "png")
    JPG = ("image/jpg", "jpg")
    SVG = ("image/svg-xml", "svg")
    GIF = ("image/gif", "gif")
    BMP = ("image/bmp", "bmp")
    TIFF = ("image/tiff", "tiff")

    MP4 = ("video/mp4", "mp4")
    OGG = ("video/ogg", "ogg")
    WEBM = ("video/webm", "webm")

    PDF = ("application/pdf", "pdf")
  • 举例：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_allure_attach.py
# 作用：allure.attach特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure
import pytest

def test_login():
    allure.attach("user01,user02,user03", "用户信息", allure.attachment_type.TEXT)
    pass

在这里插入图片描述

  • allure.attach（）的另一种使用方法为：
allure.attach.file(source, name, attachment_type, extension)
  • 参数说明：
source：文件路径
body：附件内容
name：附件名称
attachment_type：附件类型，是 allure.attachment_type 里面的其中一种
extension：附件扩展名
  • 举例：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_allure_attach.py
# 作用：allure.attach特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure
import pytest

def test_login():
    allure.attach("user01,user02,user03", "用户信息", allure.attachment_type.TEXT)
    pass

def test_login_info():
    allure.attach.file("./user_info.csv", attachment_type=allure.attachment_type.CSV)
    pass

在这里插入图片描述

3 @allure.description()

  • 添加更详细的测试用例描述；
  • 格式为：@allure.description(str），类似于函数声明下方添加 """ """；
  • 举例：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_allure_description.py
# 作用：@allure.description特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure
import pytest

# 使用方法一
@allure.description("""
这个用例的主要所用是验证？
哦，对了，我也不知道干啥的！！！
""")
def test_case01():
    num = 100 * (1 + 9)
    assert num == 1000

# 使用方法二
def test_case02():
    """
    这是一个用例！
    这个用例什么也没做！
    这个用例只是简单做个验证而已~
    """
    pass

在这里插入图片描述
在这里插入图片描述

4 @allure.title()

  • 描述测试用例的标题，可为中文；
  • 格式为：@allure.title(str)
  • 如下：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_allure_title.py
# 作用：@allure.title特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure

@allure.title("用户正常登陆")
def test_login01():
    pass

@allure.title("用户名错误")
def test_login02():
    pass

在这里插入图片描述

  • 另外，allure.title()支持占位符传递关键字参数；
  • 如下：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_allure_title1.py
# 作用：@allure.title特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure
import pytest

@allure.title("用户登陆")
@pytest.fixture
def test_login(request):
    args = request.param
    user = args["name"]
    pwd = args["password"]
    print(user, pwd, args)
    yield user, pwd

@allure.title("正常登陆，用户信息为：{test_login}")
@pytest.mark.parametrize("test_login", [
    {"name": "xiaoli", "password": "123456"},
    {"name": "laoli", "password": "123456"}], indirect=True)
def test_login_info(test_login):
    user, pwd = test_login
    allure.attach(f"用户名：{user}, 密码：{pwd}")

在这里插入图片描述

5 @allure.link()、@allure.issue()、allure.testcase()

  • 为了将allure报告和一些系统集成，可以更快速的跳转到指定地址；
  • 源码为：
def link(url, link_type=LinkType.LINK, name=None):
    return safely(plugin_manager.hook.decorate_as_link(url=url, link_type=link_type, name=name))
  • 参数说明：
issue()和testcase()其实调用的也是link()，只是link_type不一样
url：跳转的链接；
name：可选参数，显示在allure报告的名字，不传则显示完整的链接；
link_type：跳转的type类型；LINK、ISSUE、TEST_CASE，即访问链接、Bug链接、测试用例链接；
总结：三个方法是一样的，只是link_type不一样，allure报告显示的样式不一样。
  • 举例：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_link_issue_testcase.py
# 作用：@allure.link()、@allure.issue()、@allure.testcase()的特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure

@allure.link("https://blog.csdn.net/NoamaNelson")
def test_blog_link():
    pass

@allure.link("https://blog.csdn.net/NoamaNelson", name="点击查看博客主页")
def test_blog_link1():
    pass

@allure.issue('https://bbs.csdn.net/forums/NoamaNelson', '全栈测试技术社区')
def test_blog_issue():
    pass

@allure.testcase("https://bbs.csdn.net/forums/NoamaNelson?category=10003&typeId=1566629", "测试用例地址")
def test_blog_testcase():
    pass

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

6 @allure.epic()、@allure.feature()、@allure.story()

  • allure的三种标记装饰器，可以显示在allure报告上；
  • @pytest.mark 不会显示在allure报告上；
  • 作用：
@allure.epic：往下是 feature
@allure.feature：功能点的描述，模块往下是 story
@allure.story：故事，往下是 title
注意：
story 是 feature 的子集。
  • 举例：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_epic_feature_story.py
# 作用：@allure.epic()、@allure.feature()、@allure.story()特性
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure

def test_case01():
    pass

@allure.story('epic01')
def test_case02():
    pass

@allure.story('story01')
def test_case03():
    pass

@allure.story('story02')
def test_case04():
    pass

@allure.feature('feature02')
@allure.story('story02')
def test_case05():
    pass

在这里插入图片描述

7 @allure.severity

  • 在 allure 报告可以看到不同级别用例的缺陷数量，即标记用例级别 ；
  • 使用方法：
@allure.severity(allure.severity_level.xxx)
# xxx为级别
  • 比如@allure.severity(allure.severity_level.TRIVIAL)，可以看下源码：
class Severity(str, Enum):
    BLOCKER = 'blocker'
    CRITICAL = 'critical'
    NORMAL = 'normal'
    MINOR = 'minor'
    TRIVIAL = 'trivial'
  • 从以上可以看出有5个等级，分别是：
blocker：阻塞缺陷
critical：严重缺陷
normal： 一般缺陷
minor：次要缺陷
trivial： 轻微缺陷
  • 举例：
# -*- coding:utf-8 -*-
# 作者：虫无涯
# 日期：2023/3/28 
# 文件名称：test_severity.py
# 作用：@allure.severity标记用例级别
# 联系：VX(NoamaNelson)
# 博客：https://blog.csdn.net/NoamaNelson

import allure

# @allure.severity(allure.severity_level.NORMAL)
@allure.severity("normal")
@allure.description("""normal级别用例""")
def test_case01():
    print("用例01")

# @allure.severity(allure.severity_level.CRITICAL)
@allure.severity("critical")
@allure.description("""critical级别用例""")
def test_case02():
    print("用例02")

# @allure.severity(allure.severity_level.BLOCKER)
@allure.severity("blocker")
@allure.description("""blocker级别用例""")
def test_case03():
    print("用例03")

# @allure.severity(allure.severity_level.MINOR)
@allure.severity("minor")
@allure.description("""minor级别用例""")
def test_case04():
    print("用例04")

# @allure.severity(allure.severity_level.TRIVIAL)
@allure.severity("trivial")
@allure.description("""trivial级别用例""")
def test_case05():
    print("用例05")

@allure.description("""没标记,默认为 normal""")
def test_case06():
    print("用例06")

在这里插入图片描述

  • 没标记的默认normal：

在这里插入图片描述

  • 图表样式：

在这里插入图片描述

  • 也可以使用命令行参数 allure-severities根据优先级选择需要运行的测试用例，比如：
pytest test_severity.py -sq --alluredir=./allure --allure-severities=blocker,critical
用例02
.用例03
.
2 passed in 0.10s
文章标签：
测试技术
虫无涯
目录
相关文章
蓝易云
|
2月前
|
存储 大数据 Python
案例学Python：filter()函数的用法，高级！
`filter()`函数是Python中处理序列数据的强大工具，它允许我们高效地根据条件过滤元素。通过结合匿名函数、常规函数或直接利用Python的内置逻辑，`filter()`提供了灵活且高效的过滤机制，尤其在大数据处理和内存敏感的应用中展现出其价值。掌握 `filter()`的使用，不仅能提升代码的可读性和效率，还能更好地适应Python的函数式编程风格。
蓝易云
50 2
DreamSpark
|
3月前
|
测试技术 API Python
python在自动化测试中的经典例子
python在自动化测试中的经典例子
DreamSpark
45 12
糜终
|
2月前
|
缓存 监控 程序员
Python装饰器：深入探索功能增强的神奇工具（特点+应用+举例）
Python装饰器：深入探索功能增强的神奇工具（特点+应用+举例）
糜终
29 0
糜终
|
2月前
|
缓存 监控 程序员
Python装饰器：深入探索功能增强的神奇工具（特点+应用+举例）
Python装饰器：深入探索功能增强的神奇工具（特点+应用+举例）
糜终
20 0
智物科技库
|
5月前
|
SQL 存储 算法
一些使用python过程中的小贴士
摘要： 在Python中，`type`是一个特殊类型，既是类型也是对象。`isinstance()`函数表明`type`和`object`都是类型并且是彼此的基类。`all()`和`any()`函数分别检查可迭代对象的所有元素是否都为真或至少有一个元素为真。链式操作如`==`和`in`具有相同的优先级，从左到右结合，可能导致意外的结果，例如`False == False in [False]`实际上是`True`，因为`False in [False]`先计算并返回`True`，然后与`False == True`比较。
智物科技库
23 1
测个der
|
索引 Python
Python的知识点运用-3(不太基础的基础运用，代码美化)
Python的知识点运用-3(不太基础的基础运用，代码美化)
测个der
67 0
大花爱编程
|
7月前
|
安全 C#
c#学习相关系列之as和is的相关用法
c#学习相关系列之as和is的相关用法
大花爱编程
74 0
北京-宏哥
|
Java 测试技术 数据库连接
python接口自动化（二十一）--unittest简介（详解）
前边的随笔主要介绍的requests模块的有关知识个内容，接下来看一下python的单元测试框架unittest。熟悉 或者了解java 的小伙伴应该都清楚常见的单元测试框架 Junit 和 TestNG，这个招聘的需求上也是经常见到的。
北京-宏哥
226 1
python接口自动化（二十一）--unittest简介（详解）
北京-宏哥
|
网络协议 jenkins 测试技术
python接口自动化（二十五）--unittest断言——下（详解）
本篇还是回归到我们最初始的话题，想必大家都忘记了，没关系看这里：传送门 没错最初的话题就是登录，由于博客园的登录机制改变了，本篇以我找到的开源免费的登录API为案例，结合 unittest 框架写 2 个用例。同样我们先来看一下接口文档。
北京-宏哥
162 0
python接口自动化（二十五）--unittest断言——下（详解）
北京-宏哥
|
测试技术 Python
python接口自动化（二十三）--unittest断言——上（详解）
在测试用例中，执行完测试用例后，最后一步是判断测试结果是 pass 还是 fail，自动化测试脚本里面一般把这种生成测试结果的方法称为断言（assert）。用 unittest 组件测试用例的时候，断言的方法还是很多的，下面介绍几种常用的断 言方法：assertEqual、assertIn、assertTrue。想了解更多可以点击 传送门 看一下最后的小结有大致介绍。
北京-宏哥
282 0
python接口自动化（二十三）--unittest断言——上（详解）

热门文章

最新文章

  • 1
    跟阿里云技术专家阙寒一起深度了解视频直播CDN技术
  • 2
    流批一体的近实时数仓的思考与设计
  • 3
    丰富、连接、待集成—MaxCompute 生态再出发
  • 4
    securecrt克隆会话与sshd 的 MaxSessions
  • 5
    McAfee揭秘网络最危险搜索关键词
  • 6
    微软再爆IE 0day漏洞 绿盟科技提供预警及防护手段
  • 7
    uboot命令分析+实现【转】
  • 8
    读书笔记--101个shell脚本 之#11--炫
  • 9
    SQL Server 深入解析索引存储(堆)
  • 10
    OAF_EO系列3 - Initialize详解和实现（案例）
  • 1
    【claude官网中文版】国内如何使用claude?记住这十大技巧！
    102
  • 2
    调用云端Qwen系列大模型（TURBO、PLUS、MAX和MAX_LATEST）在国际商业咨询智能体场景的实践探索
    55
  • 3
    已解决：国内如何使用Claude 3.5 Sonnet \ claude官网中文入口
    44
  • 4
    HarmonyOS 5.0 Next实战应用开发—‘我的家乡’【HarmonyOS Next华为公司完全自研的操作系统】
    64
  • 5
    自学记录鸿蒙API 13：实现多目标识别Object Detection
    159
  • 6
    《探索人工智能产业的可持续发展模式与策略》
    18
  • 7
    《人工智能助力社会学研究：数据挖掘与分析方法的深度探索》
    22
  • 8
    《软体机器人与仿生机器人的人工智能控制技术：挑战与突破》
    18
  • 9
    《探索机器人自主导航与路径规划技术的热点》
    21
  • 10
    《集成学习：堆叠泛化与提升法在人工智能中的应用热点》
    16

    • 相关课程

    更多
  • Python语言基础 - 语法入门
  • Python 脚本进阶
  • Python Web开发基础
  • Python基础快速入门实战教程
  • PHP进阶教程 - 由浅入深掌握面向对象开发 - 第二阶段
  • Python入门与实践

    • 相关电子书

    更多
  • Python第五讲——关于爬虫如何做js逆向的思路
  • Python 脚本速查手册
  • 编程语言如何演化-以JS的private为例

    • 相关实验场景

    更多
  • 语言入门-1：环境构建
  • Python选择及循环结构
  • 云端Python及基本操作
  • Python网络通信程序典型应用
  • Python新手入门
    • 下一篇
    手把手教你白嫖阿里云服务器(免费领服务器)