Robotframework - 如何记录测试中存在的关键字

问题描述

我一直在讨论一些机器人测试用例的文档主题。

上下文：我尝试为所有机器人文件（测试用例或关键字库）生成文档。关于关键字 library => robots.libdoc 按预期完成工作。关于测试用例 => robots.testdoc 按预期完成工作。

但是对于以下情况我不知道。例如：

*** Settings ***
Documentation     description of test case: bla bla bla
Test Setup        SETUP_TC_001
Test Teardown     TEARDOWN_TC_001
Ressource         r1
Ressource         r2

*** Test Cases ***
TC_001
   step1
   step2

*** Keywords ***
SET_UP_TC_001
     Action1
     Action2

TEARDOWN_TC_001
    TD_action1
    TD_action2

问题：我们如何为测试用例中定义的关键字生成文档？我尝试使用 libdoc，但出现以下错误：

资源文件中不允许设置“测试设置”。
不允许在资源文件中设置“测试拆解”。
包含“测试用例”部分的资源文件无效。

我对 testdoc 进行了同样的尝试，它描述了测试用例和步骤顺序，但描述了内部关键字。我错过了什么吗？

溴紫苏

解决方法

libdoc 是生成“关键字”资源文档的工具。为了生成测试文档，您应该使用 testdoc 工具。

python -m robot.testdoc ./robot/space-test-plan.robot space-test-plan.html

这应该会生成TestCase的HTML报告，如果你有关联的关键字资源文件，你可以用libdoc工具生成这个文档

python -m robot.testdoc  ./robot/resources.robot resources.html

documentation documentation keyword robotframework