Robot Framework是否提供测试用例回调？Python库场景咨询

核心思路：让你的Python库同时扮演监听器角色 #

Robot Framework允许Python库直接实现监听器方法，这样你可以在同一个库中同时处理套件级初始化/销毁，以及自动捕获每个测试用例的结束事件。具体步骤如下：

1. 在你的库中添加监听器相关配置和方法 #

修改你的Python库代码，加入监听器API声明和_end_test方法（这个方法会在每个测试用例执行完成后自动触发）：

from robot.api import logger
from robot.libraries.BuiltIn import BuiltIn

class YourTestSuiteLibrary:
    # 保持你的套件级作用域设置
    ROBOT_LIBRARY_SCOPE = "TEST SUITE"
    # 声明使用监听器API版本3（当前推荐版本）
    ROBOT_LISTENER_API_VERSION = 3

    def __init__(self):
        # 套件级初始化逻辑，只执行一次
        self.suite_resource = "初始化的套件级资源"
        logger.info(f"测试套件初始化完成：{self.suite_resource}")

    def _end_test(self, test, result):
        # 这个方法会自动在每个测试用例结束后执行
        logger.info(f"测试用例「{test.name}」执行完成，状态：{result.status}")
        # 在这里写你需要自动执行的用例后操作
        self._auto_post_test_action()

    def _auto_post_test_action(self):
        # 自定义的用例后操作逻辑，比如清理用例数据、重置状态等
        logger.info("自动执行测试用例后清理操作")
        # 也可以调用Robot Framework的内置关键字
        builtin = BuiltIn()
        builtin.run_keyword("Log", "自动Teardown已执行")

    def suite_teardown(self):
        # 套件级销毁逻辑，测试套件结束时自动执行
        logger.info(f"测试套件销毁：清理{self.suite_resource}")

2. 关键细节说明 #

• _end_test方法：前面的下划线是Robot Framework的约定，用来区分普通关键字和监听器方法，避免被当成可调用的关键字。它接收两个参数：
  • test：包含测试用例的名称、ID等元数据
  • result：包含用例的执行状态（PASS/FAIL）、执行时间等结果信息
• 监听器API版本：设置ROBOT_LISTENER_API_VERSION = 3是当前推荐的做法，版本3的接口更清晰、功能更完善。
• 套件级销毁：通过suite_teardown方法，结合TEST SUITE作用域，Robot Framework会在整个测试套件结束时自动调用它，实现单次销毁。

3. 使用方式 #

在你的Robot测试套件中直接导入这个库即可，不需要额外配置：

*** Settings ***
Library    YourTestSuiteLibrary

*** Test Cases ***
示例用例1
    Log    执行示例用例1

示例用例2
    Log    执行示例用例2

运行后你会看到：

• 套件启动时执行一次初始化
• 每个用例结束后自动执行_auto_post_test_action里的逻辑
• 套件结束时执行销毁操作

额外技巧：区分用例成功/失败场景 #

如果你需要根据用例的执行结果做不同操作，可以通过result.status判断：

def _end_test(self, test, result):
    if result.status == "PASS":
        logger.info(f"用例「{test.name}」执行成功，执行后续操作")
    elif result.status == "FAIL":
        logger.info(f"用例「{test.name}」执行失败，执行异常处理逻辑")

内容的提问来源于stack exchange，提问作者user3177338