自动化框架 - 核心功能使用指南 - 用例过滤Tag使用

1. 什么是 Tag

Tag 是一种标记机制，用于标识测试用例的分类或特性。通过为测试用例添加不同的标签，可以灵活地控制测试用例的执行范围。例如，可以使用 regression 标签标记回归测试用例，使用 smoke 标签标记冒烟测试用例，使用 admin 标签标记与管理员功能相关的测试用例。

2. 标签命名规范

标签应简洁明了，通常与测试用例的功能模块或测试场景相关。

示例标签：

• regression：回归测试。
• smoke：冒烟测试。
• admin：管理员相关测试。
• oah：OAH 相关测试。
• api：接口测试。

 

3. 在测试用例表中配置Tag

在测试用例表中， 有一个字段Tag， 用于配置Tag信息。可以多个Tag，用逗号“，”分隔。

假设你有一个测试用例文件 test_api_dz_tenant.xlsx，并且你只想运行带有 oah 标签的测试用例， 以下测试用例会被筛选出来

TestCaseID	LFCaseID	ScenarioDescription	Step	Description	Module	Action	Tag	Params	ParamsSetID	Priority
TC_OAH_API_Tenant_Base_Config_Edit		API_编辑租户基础配置	1	设置变量	data_process	data_process	regression, api,oah		oah_body	p1
			2	get sign	oah_api	generate_sign			oah_sign
			3	basicConfig edit	oah_api	send_request			oah_request	p1
			4	validate 200	value_validation	validate_data		{ "field_name": "status_code", "actual_value": "@response.json:data.code", "operator": "equal", "expect_value": "200" }
			5	validate msg	value_validation	validate_data		{ "field_name": "msg", "actual_value": "@response.json:data.msg", "operator": "equal", "expect_value": "操作成功" }

 

 

4. 使用 Tag过滤测试用例

 

在运行测试时，可以通过 --tag-filter 参数指定一个或多个标签，只执行带有这些标签的测试用例。

命令行参数说明：

• --testcase-path：指定测试用例文件的路径。
• --tag-filter：指定标签过滤器，仅运行带有指定标签的测试用例。
• --env-config：指定环境配置，例如 qa、prod 等。

示例：

- **执行所有带有 `regression` 标签的测试用例**：

python tests/main.py --testcase-path tests/excelcases/administrator/test_admin_dz_tenant.xlsx --tag-filter regression --env-config qa

- **执行所有带有 `admin` 和`smoke` 标签的测试用例**：

python tests/main.py --testcase-path tests/excelcases/administrator/test_admin_dz_tenant.xlsx --tag-filter "admin and smoke" --env-config qa

- **执行所有带有 `admin` 或者`smoke` 标签的测试用例**：

python tests/main.py --testcase-path tests/excelcases/administrator/test_admin_dz_tenant.xlsx --tag-filter "admin or smoke" --env-config qa