Robot Framework 语言

# 编写你的首个代码 | ROBOT FRAMEWORK 来源：https://docs.robotframework.org/docs/getting_started/how_to_write_rf Robot Framework 是一个通用且强大的自动化框架，采用纯文本语法。其设计易于阅读和编写，技术与非技术用户均可轻松上手。本指南将介绍 Robot Framework 的语法基础，助你快速入门。 **注意** 本指南主要聚焦于测试场景，特别是测试用例与测试套件。这些原则同样适用于 RPA 任务的讨论。 ## 文件名（https://docs.robotframework.org/docs/getting_started/how_to_write_rf#file-name） 你可以为文件任意命名，只需确保扩展名为 `.robot`。例如：`MyFirstTest.robot`。 ## 部分（https://docs.robotframework.org/docs/getting_started/how_to_write_rf#sections） Robot Framework 测试套件由单个文件中的多个测试用例组成。测试套件文件的基本结构包含以下部分： 1. 设置 2. 测试用例 尽管存在其他可选部分，但运行测试时“测试用例”部分是必需的。 ### 设置（https://docs.robotframework.org/docs/getting_started/how_to_write_rf#settings） “设置”部分用于定义测试套件所需的库、资源文件及其他配置。 ```robot *** Settings *** Library String ``` 库包含 Robot Framework 执行测试所使用的关键词（函数/步骤）。每个库都附有其提供关键词的文档。使用这些功能前需先导入相应库。 ### 测试用例或任务（https://docs.robotframework.org/docs/getting_started/how_to_write_rf#test-cases-or-tasks） “测试用例或任务”部分用于定义单个测试用例。每个测试用例/任务由一系列关键词组成，这些关键词决定了测试或任务执行的步骤与操作。测试用例的步骤数量没有限制，但建议遵循良好实践，并与同事建立统一规范以确保代码可读性。 - 测试 - 任务 ```robot *** Test Cases *** Create A Random String Log To Console We are going to generate a random string Generate Random String 10 Log To Console We finished generating a random string ``` ## 缩进（https://docs.robotframework.org/docs/getting_started/how_to_write_rf#indentation） 从示例中可见，Robot Framework 代码通过空格分隔元素。为正确区分不同部分，Robot Framework 要求至少使用两个空格。以下基于前述代码给出示例说明： ```robot *** Settings *** Library String ``` - “设置”部分中的 `Library` 关键词未缩进，表示此处声明的是 `Library` 设置。 - `Library` 与 `String` 之间的若干空格表明 `String` 是测试所需的库名称。 ```robot *** Test Cases *** Create A Random String Log To Console We are going to generate a random string Generate Random String 10 Log To Console We finished generating a random string ``` - “测试用例”部分中的 `Create A Random String` 未缩进，表明这是一个测试用例名称。 - `Create A Random String` 下方的行均缩进，表示这些是测试用例中使用的关键词。 - `Generate Random String` 与 `10` 之间的若干空格表明 `10` 是该关键词的参数，指定生成随机字符串的长度为10个字符。 - `Log To Console` 关键词后通过若干空格连接句子，这些空格确保后续文本是我们要输出到控制台的内容。 由此可见空格与缩进在 Robot Framework 中至关重要。它们用于区分关键词及其参数，以及测试名称与测试内关键词的边界。记住，Robot Framework 需要至少两个空格才能正确识别元素。更多空格同样允许。关于空格规范的详细信息，请参阅《风格指南》（https://docs.robotframework.org/docs/style_guide#horizontal-spacing）。 ## 整体结合（https://docs.robotframework.org/docs/getting_started/how_to_write_rf#everything-together）