pytest+allure生成测试报告

前言

allure是一个测试报告框架,支持java的Junit/testng等框架,当然也可以支持python的pytest框架，也可以集成到Jenkins上展示高大上的报告界面。

---

环境准备

• python3.7

• windows环境

• pycharm

• allure-pytest

• allure2

• java1.8

---

安装allure

1. 安装allure-pytest

pip install allure-pytest

2. 安装allure2
   （1） 下载allure2，解压文件
   （2） 配置环境变量
   找到allure2文件的bin目录加入到path环境变量中
   

   

   配置环境变量g

3. 打开cmd输入如下命令

C:\Users>allure --version
2.12.1

这样表示安装成功

---

生成报告

1. 通过命令行执行测试用例文件，生成xml报告

pytest --alluredir=生成的测试结果数据保存的目录  测试文件所在路径
# 如下：
pytest --alluredir=report/xml test_demo.py

2. 通过allure2把xml报告生成html报告

allure generate xml报告路径 -o html报告保存路径
# 如下：
allure generate report/xml -o report/html --clean

# –clean目的是先清空测试报告目录，再生成新的测试报告

3. 打开报告

   
   
   

   打开报告

测试报告

---

allure特性

1. feature与story

• fetature相当于一个功能，一个大的模块
• story相当于对应这个功能或者模块的不同场景，分之功能；
• feature和story类似父子关系

import allure
import logging

logging.basicConfig(level=logging.DEBUG)

@allure.feature("测试登陆功能")
class TestA():

    def setup_class(self):
        logging.info("初始化")

    def teardown_class(self):
        logging.info("结束动作")

      
    def test_1(self):
        assert 1 == 1

    @allure.story("测试登陆失败的场景")
    def test_2(self):
        assert 1 == 2

feature与story报告结果

feature与story测试报告

feature与story测试报告

可以看到报告更清晰，起到了类似与测试用例分类显示的效果。

2. severity 对测试用例分级别

• Blocker级别：中断缺陷（客户端程序无相应，无法执行下一步操作）
• Critical级别：临界缺陷（功能点缺失）
• Normal级别：普通缺陷（数值计算错误）
• Minor级别：次要缺陷（界面错误与UI需求不符）
• Trivial级别：轻微缺陷（必要项无提示，或者提示不规范）

一般分三个级别就好了，Minor、Normal、critical

实例

import allure
import logging

logging.basicConfig(level=logging.DEBUG)

class TestA():

    def setup_class(self):
        logging.info("初始化")

    def teardown_class(self):
        logging.info("结束动作")

    @allure.severity("minor")
    def test_1(self):
        assert 1 == 1

    @allure.severity("critical")
    def test_2(self):
        assert 1 == 2

    @allure.severity("normal")
    def test_3(self):
        assert 3 == 3

命令行执行，

$ pytest --alluredir=report/xml --allure-severities=minor  test_demo2.py

# 选项--allure-severities=minor 主要用来指定执行那些级别的用例
# 类似与pytest的 -m选项，把测试用例进行分组分组

执行结果

执行结果

3. step 测试过程中记录每个关键步骤

• 在app，web自动测试中，建议每切换到一个新的页面，当做一个step。

实例

"""打开社区的第三个置顶帖，打开帖子，并点击帖子内的连接，租后断言预期界面的关键字是否存在， 把源代码贴到回复里"""

from selenium import webdriver
import pytest
import allure


@allure.feature("测试testerhome社区")
class TestTesterHome():

    # 初始化，打开testerhome
    def setup_method(self):
        self.driver = webdriver.Chrome("/Users/lan/PycharmProjects/testerhomer_xuexi/src/selenium_demo/driver/chromedriver")
        self.url = "https://testerhome.com/"

        with allure.step("打开testerhome"):
            self.driver.get(self.url)
        self.driver.implicitly_wait(10)

    @allure.story("并点击帖子内的连接，断言预期界面的关键字是否存在")
    def test_open_testerhome(self):
        with allure.step("点击先到先得这个帖子，切换到贴子详情"):
            self.driver.find_element_by_partial_link_text("先到先得").click()
        # 获取当前窗口句柄
        sreach_windows = self.driver.current_window_handle
        with allure.step("点击帖子里面到链接，切换到该链接页面"):
            self.driver.find_element_by_link_text("https://testerhome.com/topics/19664").click()
        # 获取所有窗口句柄
        all_handles = self.driver.window_handles
        for handle in all_handles:
            if handle != sreach_windows:
                self.driver.switch_to.window(handle)
        with allure.step("获取页面标题"):
            value = self.driver.find_element_by_id("有奖投票").text
        assert value == "有奖投票"

    # 关闭浏览器
    def teardown_method(self):
        self.driver.quit()


if __name__ == '__main__':
    pytest.main()

命令行执行

$ pytest  --alluredir=report/xml  test_demo3.py
$ allure generate report/xml -o report/html --clean    

测试报告

step测试报告

可以看到报告上每一个测试步骤都很清楚，方便问题的定位。

---

allure 运行不同的测试用例

1. 按features运行测试用例

pytest --alluredir=report/xml --allure_features=测试登陆功能 test_demo2.py

2. 按story运行测试用例

pytest --alluredir=report/xml --allure_stories=测试登陆成功的场景 test_demo2.py

3. 按severity运行测试用例

pytest --alluredir=report/xml --allure_severities=blocker test_demo2.py

attach 添加附件（截图等）

在报告中增加附件：allure.attach('arg1', 'arg2', 'arg3')
arg1：是在报告中显示的附件名称
arg2：表示添加附件的内容
arg3：表示添加的类型(支持:HTML,JPG,PNG,JSON,OTHER,TEXTXML)

from allure_commons.types import AttachmentType
allure.attach(self.driver.get_screenshot_as_png(), name="图片名称", attachment_type=AttachmentType.PNG)

实例

"""打开社区的第三个置顶帖，打开帖子，并点击帖子内的连接，租后断言预期界面的关键字是否存在， 把源代码贴到回复里"""

from selenium import webdriver
import pytest
import allure
from allure_commons.types import AttachmentType

@allure.feature("测试testerhome社区")
class TestTesterHome():

    # 初始化，打开testerhome
    def setup_method(self):
        self.driver = webdriver.Chrome("/Users/lan/PycharmProjects/testerhomer_xuexi/src/selenium_demo/driver/chromedriver")
        self.url = "https://testerhome.com/"

        with allure.step("打开testerhome"):
            self.driver.get(self.url)
        self.driver.implicitly_wait(10)

    @allure.story("并点击帖子内的连接，断言预期界面的关键字是否存在")
    def test_open_testerhome(self):
        with allure.step("点击先到先得这个帖子，切换到贴子详情"):
            self.driver.find_element_by_partial_link_text("先到先得").click()
        # 获取当前窗口句柄
        sreach_windows = self.driver.current_window_handle
        with allure.step("点击帖子里面到链接，切换到该链接页面"):
            self.driver.find_element_by_link_text("https://testerhome.com/topics/19664").click()
        # 获取所有窗口句柄
        all_handles = self.driver.window_handles
        for handle in all_handles:
            if handle != sreach_windows:
                self.driver.switch_to.window(handle)
        with allure.step("获取页面标题"):
            value = self.driver.find_element_by_id("有奖投票").text
        assert value == "有奖投票"
       # 截图
        allure.attach(self.driver.get_screenshot_as_png(), name="Screenshot", attachment_type=AttachmentType.PNG)
    # 关闭浏览器
    def teardown_method(self):
        self.driver.quit()


if __name__ == '__main__':
    pytest.main()

补充 用代码执行目录下的所有测试文件并生成报告

import os
import sys
import pytest
BASEDIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(BASEDIR)

if __name__ == '__main__':
    pytest.main(["-s", "--alluredir=report/xml", "tests/"])