pytest测试框架-Allure语法学习

一、Allure特点

• 支持多平台；
• java语言开发的，支持多语言pytest，js、php、ruby等；
• 可以提供详细的测试报告，测试步骤、log、标题、优先级、附件等；
• 可以提供high level统计报告；
• 可以集成到jenkins展示项目趋势图；

二、Allure用法

可以添加步骤、描述、日志、图片、视频、标题等。

• 1.@allure.epic()有多个项目，不同的项目定义为不同的epic；

• 2.@allure.feature()模块名称，按用例的模块区分，类级别相当于testsuite；

• 3.@allure.story()用例标题，对用例进行描述，如失败的用例、成功的用例，方法级别，对应功能或模块下不同场景，分支功能；

• 4.@allure.title()用例标题，给用例取名字；

• 5.@allure.testcase()用例相关链接，这条自动化测试用例关联的功能测试用例存放url；

• 6.@allure.issue()缺陷地址，对应缺陷关联系统中的缺陷地址；

• 7.@allure.description()用例描述，对用例的详细描述步骤；

• 8.@allure.severity()用例等级，对用例划分等级blocker阻塞、critical严重、normal普通、minorUI相关的、trivial建议；

• 9.@allure.link()定义链接，用于定义一个需要在测试报告中展示的链接；

• 10.@allure.attachment()附件，添加测试报告附件；

以上十种用法，参考下面代码示例~

import allure

TEST_CASE_LINK = "http://www.baidu.com"
bugid = 140

@allure.feature("搜索模块")
class TestSearch():
    @allure.story("搜索成功")
    #@allure.title("搜索词为中文")
    def test_case_succ(self):
        pass

    @allure.story("搜索失败")
    def test_case_fail(self):
        pass

    # 添加url链接
    @allure.link('http://www.lingtiku.com', name='灵题库地址')
    def test_link(self):
        pass

    # 添加bug管理平台链接
    @allure.issue(f'http://www.baidu.com/{bugid}', 'bug地址')
    def test_issue(self):
        pass

    # 添加用例管理平台链接
    @allure.testcase('TEST_CASE_LINK', '测试用例管理平台地址')
    def test_testcase(self):
        pass

    # 添加优先级
    @allure.severity(allure.severity_level.BLOCKER)
    # @allure.severity(allure.severity_level.CRITICAL)
    # @allure.severity(allure.severity_level.NORMAL)
    # @allure.severity(allure.severity_level.MINOR)
    # @allure.severity(allure.severity_level.TRIVIAL)
    def test_severity(self):
        pass

@allure.feature("登录模块")
class TestLogin():
    @allure.title("登录成功")
    def test_case_login(self):
        with allure.step("步骤1：打开应用"):
            print("打开应用")
            # 添加附件-截图
            allure.attach.file("/Users/xxx/Desktop/11.jpg", name="截图", attachment_type=allure.attachment_type.JPG, extension=".jpg")
        with allure.step("步骤2：进入登录页面"):
            print("登录页面")
            allure.attach("这是一段测试文本",name="文本展示")
        with allure.step("步骤3：登录应用"):
            assert 1 == 1
            print("输入用户名密码")
            allure.attach('<script type="text/javascript" src="//img0.bdstatic.com/static/common/widget/ui/base/base_a66ce51.js"></script>', name="html文本展示", attachment_type=allure.attachment_type.HTML, extension=".html")
        with allure.step("步骤4：登录成功"):
            print("登录成功")

三、Allure特性

1、allure特性： feature与story关系

• feature：类级别相当于testsuite
• story：方法级别，对应功能或模块下不同场景，分支功能
• feature与story类似父子关系

2、allure特性： step

测试过程中每个步骤，一般放在逻辑方法中，每切换一个新页面当做一个step，可以帮助标注出哪个测试步骤成功，哪个测试步骤失败
with allure.step():可以放在测试用例方法里面，但测试步骤的代码需要被该语句包含--参考上方代码

3、allure特性： testcase/issue/link

为了将allure报告和测试管理系统集成，主要有用例或bug管理，可以更快速的跳转到公司内部地址
场景：测试报告中添加用例的链接、bug链接地址、相关的链接地址

• @allure.link()
• @allure.issue()
• @allure.testcase()

4、allure特性： 设置优先级

通常测试有p0、冒烟测试、验证上线测试，按优先级来分别执行

• blocker阻塞，功能未实现，不能进行下一步
• critical严重，功能点确实
• normal普通，边界错误，格式错误
• minor 次要缺陷，UI相关的
• trivial轻微缺陷，建议，提示不规范等
  通过allure.severity来附加标记：@allure.severity(allure.severity_level.TRIVIAL)

@allure.severity(allure.severity_level.BLOCKER)
@allure.severity(allure.severity_level.CRITICAL)
@allure.severity(allure.severity_level.NORMAL)
@allure.severity(allure.severity_level.MINOR)
@allure.severity(allure.severity_level.TRIVIAL)

按优先级执行 pytest -s -v 文件名 --allure-serverties normal,critical --alluredir=./result则只执行normal和critical两种优先级的case，其他优先级则不执行。

5、allure特性：测试报告中添加附件

希望在报告中看到测试用例的详细内容，如文本、数据、图片、视频、网页
添加方法，在测试步骤中添加 allure.attach(body(内容),name,attachment_type,extension)

allure.attach.file("/Users/jinchunzhi/Desktop/11.jpg",name ="截图",attachment_type=allure.attachment_type.JPG,extension=".jpg")
allure.attach("这是一段测试文本",name="文本展示")
allure.attach('<script type="text/javascript" src="//img0.bdstatic.com/static/common/widget/ui/base/base_a66ce51.js"></script>', name="html文本展示", attachment_type=allure.attachment_type.HTML, extension=".html")

四、Allure运行方式

1、以python文件运行

import os
import pytest

if __name__ == '__main__':
    # 执行优先级blocker的case
    # pytest.main(['-s', '-v', '--allure-severities=blocker', '--alluredir=result', '--clean-alluredir'])
   
     # 以模块features运行
    #pytest.main(['-s', '-v', '--allure-features=搜索模块', '--alluredir=result', '--clean-alluredir'])
    
    # 运行整个文件
    pytest.main(['-s', '-v', '--alluredir=result', '--clean-alluredir'])
    
    # 打开在线测试报告
    #os.system('allure serve ./result')
    
    # 生成最终版测试报告
    os.system('allure generate ./result/ -o ./report/ --clean')
   
     # 打开最终版测试报告
    os.system('allure open -h 127.0.0.1 -p 8080 ./report')

2、以常用行方式运行

• 1.生成测试报告的中间结果，json和txt文件 pytest test_allure.py --alluredir ./result --clean-alluredir

• 2.生成在线测试报告 allure serve ./result

• 3.生成最终版本测试报告（指定文件夹名称、清理上一次运行结果） allure generate ./result/ -o ./report/ --clean

• 4.打开最终版本测试报告 allure open -h 127.0.0.1 -p 8080 ./report