1. 前言

allure 除了支持 pytest 自带的特性之外（fixture、parametrize、xfail、skip），自己本身也有强大的特性可以在pytest 中使用

2. @allure.step

  • allure 报告最重要的一点是，它允许对每个测试用例进行非常详细的步骤说明
  • 通过 @allure.step() 装饰器，可以让测试用例在 allure 报告中显示更详细的测试过程

2.1 示例代码

  1. #!/usr/bin/env python
  2. # -*- coding: utf-8 -*-
  4. """
  5. __title__  =
  6. __Time__   = 2020-04-08 21:24
  7. __Author__ = 小菠萝测试笔记
  8. __Blog__   = https://www.cnblogs.com/poloyy/
  9. """
  10. import allure
  13. @allure.step("第一步")
  14. def passing_step():
  15.     pass
  18. @allure.step("第二步")
  19. def step_with_nested_steps():
  20.     nested_step()
  23. @allure.step("第三步")
  24. def nested_step():
  25.     nested_step_with_arguments(1, 'abc')
  28. @allure.step("第四步{0}，{arg2}")
  29. def nested_step_with_arguments(arg1, arg2):
  30.     pass
  33. @allure.step("第五步")
  34. def test_with_nested_steps():
  35.     passing_step()
  36.     step_with_nested_steps()

2.2 测试用例在allure上的显示

image.png

2.3 知识点

  • step() 只有一个参数，就是title，你传什么，在allure上就显示什么
  • 可以像 python 字符串一样，支持位置参数和关键字参数 {0}，{arg2}，可看第四步那里，如果函数的参数没有匹配成功就会报错哦
  • step() 的使用场景，给我感觉就是，当方法之间嵌套会比较有用，否则的话只会显示一个步骤，类似下面图

image.png

3. allure.attach（挺有用的）

作用：allure 报告还支持显示许多不同类型的附件，可以补充测试结果；自己想输出啥就输出啥，挺好的

3.1 语法一

  1. allure.attach(body, name, attachment_type, extension)

3.1.1 参数列表

  • body：要显示的内容（附件）
  • name：附件名字
  • attachment_type：附件类型，是 allure.attachment_type 里面的其中一种
  • extension：附件的扩展名（比较少用）

3.1.2 allure.attachment_type 提供了哪些附件类型？

image.png

3.2 语法二

  1. allure.attach.file(source, name, attachment_type, extension)

source：文件路径，相当于传一个文件
其他参数和上面的一致

3.3 其中一个测试用例的代码栗子

  1. #!/usr/bin/env python
  2. # -*- coding: utf-8 -*-
  4. """
  5. __title__  =
  6. __Time__   = 2020-04-08 21:24
  7. __Author__ = 小菠萝测试笔记
  8. __Blog__   = https://www.cnblogs.com/poloyy/
  9. """
  10. import allure
  11. import pytest
  14. @pytest.fixture
  15. def attach_file_in_module_scope_fixture_with_finalizer(request):
  16.     allure.attach('在fixture前置操作里面添加一个附件txt', 'fixture前置附件', allure.attachment_type.TEXT)
  18.     def finalizer_module_scope_fixture():
  19.         allure.attach('在fixture后置操作里面添加一个附件txt', 'fixture后置附件',
  20.                       allure.attachment_type.TEXT)
  22.     request.addfinalizer(finalizer_module_scope_fixture)
  25. def test_with_attacments_in_fixture_and_finalizer(attach_file_in_module_scope_fixture_with_finalizer):
  26.     pass
  29. def test_multiple_attachments():
  30.     allure.attach('<head></head><body> 一个HTML页面 </body>', 'Attach with HTML type', allure.attachment_type.HTML)
  31.     allure.attach.file('./reports.html', attachment_type=allure.attachment_type.HTML)

3.4 运行之后看结果

image.png
这是一个 txt 附件

image.png
这是一个用了 allure.attach() 来插入一段自己写的HTML和 allure.attach.file() 来导入一个已存在的 HTML 文件（pytest-html 报告）