# -*- coding: utf-8 -*-
# @Time    : 2023/6/28 19:47
# @Author  : yanfa
# @user   : yanfa 
# @File    : test_allure_01_for_add_title.py
# @remark: 添加用例標(biāo)題
""""""
import allure
import pytest

"""
一、allure用法
方法名                 方法參數(shù)                        參數(shù)說明
@allure.epic()          epic描述              敏捷里面的概念，定義史詩，往下是 feature
@allure.feature()       模塊名稱                功能點(diǎn)的描述，往下是 story
@allure.story()         用戶故事                用戶故事，往下是 title
@allure.title("xx")     用例的標(biāo)題           重命名 html 報告名稱
@allure.step()          操作步驟                測試用例的步驟
@allure.testcase()      測試用例的鏈接地址       對應(yīng)功能測試用例系統(tǒng)里面的 case
@allure.issue()         缺陷                  對應(yīng)缺陷管理系統(tǒng)里面的鏈接
@allure.description()   用例描述                測試用例的描述
@allure.severity()      用例等級                blocker，critical，normal，minor，trivial
@allure.link()          鏈接                  定義一個鏈接，在測試報告展現(xiàn)
@allure.attachment()    附件                  報告添加附件

二、添加用例標(biāo)題
通過@allure.title()自定義標(biāo)題，支持三種方式：
1、直接@allre.title()

2、@allre.title()支持占位符的方式傳遞參數(shù)，實(shí)現(xiàn)測試用例標(biāo)題參數(shù)化，動態(tài)生成用例標(biāo)題

3、@allure.dynamic.title()動態(tài)更新測試用例標(biāo)題

"""


# 例子：
# 方式一：直接@allre.title()
@allure.title("這是標(biāo)題")
def test_with_title():
    assert True

# 方式二：參數(shù)化標(biāo)題
@allure.title("參數(shù)化標(biāo)題：參數(shù)1:{param1} 參數(shù)2：{param2}")
@pytest.mark.parametrize("param1,param2,expected", [(1, 1, 2), (1, 3, 3)])
def test_with_title_param(param1, param2, expected):
    assert param1 + param2 == expected

# 方式三：更新標(biāo)題
@allure.title("老標(biāo)題")
def test_with_dynamic_title():
    assert True
    allure.dynamic.title("新標(biāo)題")