声明：本文搬运自官方操作文档，仅用作学习，有错误的地方欢迎指正。
原文链接：RobotFramework--创建测试套

2.3 创建测试套

2.3.1 测试用例文件

Robot Framework测试案例是在测试案例文件中使用测试案例表创建的。此类文件会自动从它包含的所有测试案例中创建测试套件。测试案例数量没有上限，但建议少于 10 个，除非使用数据驱动方法（其中一个测试案例仅由一个高级关键字组成）。

设置表中的以下设置可用于自定义测试套件：

Documentation
用于指定测试套件文档

Metadata
用于将免费测试套件元数据设置为名称值对。

Suite Setup, Suite Teardown
指定套件设置和拆解。也有同义词分别是Suite Precondition和Suite Postcondition。

注意
所有设置名称都可以在末尾可选地加冒号，例如Documentation:.这样阅读起来更清晰，尤其是在使用纯文本格式时。是Robot Framework 2.5.5 中的新功能。

2.3.2 测试套目录

测试案例文件可以组织成目录，这些目录创建更高级别的测试套件。从目录创建的测试套件不能直接包含任何测试案例，但它包含具有测试案例的其他测试套件。然后，这些目录可以放置到其他目录中，创建更高级别的套件。结构没有限制，因此可以根据需要组织测试案例。

执行测试目录时，其包含的文件和目录将递归处理如下：

• 以点(.) 或下划线(_)开头的文件或目录被忽略。
• 忽略带有 CVS名称的目录（对案例敏感）。
• 不支持的扩展名文件(.html, .xhtml, .htm,.tsv,.txt,.rst, or .rest)被忽略（不区分大小写）。
• 经过特殊处理的其他文件和目录。

如果正在处理的文件或目录不包含任何测试案例则会忽略（同时将消息写入syslog），并且继续执行下面的文件或目录。

无效文件警告

没有有效测试案例表的文件会被忽略，并写入syslog。在Robot Framework2.5.5及以上版本，可以使用命令行--warnonskippedfiles，会在测试执行错误时显示警告。

初始化文件

从目录创建的测试套件可以具有与从测试案例文件创建的套件类似的设置。由于目录本身不能有此类信息，因此必须将其放入特殊测试套件初始化文件中。初始化文件具有与测试案例文件相同的结构和语法，只是它们不能具有测试案例表，并且并非所有设置都得到支持。

初始化文件名称必须__init__.ext格式，且必须是支持的扩展（例如，__init__.html或__init__.txt）。命名方式来源于Python，表示以这种方式命名的文件目录是一个模块。

初始化文件的主要用途是指定与测试案例文件类似的测试套件相关设置，但设置一些测试案例相关设置也是可以的。在较低级别的测试套件中无法使用初始化文件中创建或导入的变量和关键字，但如果需要共享资源文件，则可以使用资源文件。

如何在初始化文件中使用不同的设置：
Documentation, Metadata, Suite Setup, Suite Teardown
参数的工作方式与测试案例文件相同。
Force Tags
指定的标签被应用到此目录包含的测试案例及目录下的所有测试案例
Test Setup, Test Teardown, Test Timeout
为此目录包含的所有测试案例设置默认值（setup/teardown or test timeout）。可以在较低的水平上被覆盖。Robot Framework 2.7 中添加了对初始化文件中定义测试超时的支持。
Default Tags, Test Template
初始化文件不支持。

image.png

2.3.3 测试套名称和文档

测试套件名称由文件或目录名构成。创建套件名称好处是可以忽略文件的扩展名，下划线使用空格替换，完全小写的名称将转为标题格式。例如，some_tests.html变为Some Tests， My_test_directory变为My test directory。

注意
在Robot Framework 2.5中，创建测试套件名称的规则略有不同。

文件或目录名称可以包含用于控制套件执行顺序的前缀。前缀通过两个下划线与基本名称分隔，并且在构造实际测试套件名称时，前缀和下划线都将被删除。例如，文件 01__some_tests.txt和02__more_tests.txt分别创建测试套件Some Tests和More Tests，前者在后者之前执行。

使用 “设置”表中的“Documentation”设置测试套件的文档。它可以在测试用例文件中使用，也可以在更高级别的套件中用于测试套件初始化文件。测试套件文档用法和之前创建测试用例章节中的用法一样。

image.png

在测试执行中，可以覆盖顶级测试套件的名称和文档。这可以分别使用命令行选项--name和--doc来完成，如设置元数据一节中所述。

2.3.4 免费测试条件元数据

测试套件还可以包含除文档之外的其他元数据。此元数据使用“Metadata”设置。以这种方式设置的元数据显示在测试报告和日志中。

对元数据的名称和值参见下表。该值的处理方式与文档类似，这意味着它可以拆分为多个单元格（用空格连接在一起）或分成几行（用换行连接在一起），简单的HTML格式化，甚至可以使用变量。

image.png

对于顶级测试套件，也可以使用--metadata命令行选项设置元数据 。这在“ 设置元数据”一节中有更详细的讨论。

2.3.5 套件设置和拆解

测试用例和测试套件都可以进行设置和拆卸。在运行任何套件或子测试套件的测试用例之前执行套件设置，并在它们之后执行测试拆卸。所有测试套件都可以进行设置和拆卸; 对于从目录创建的套件，必须在测试套件初始化文件中指定它们。

与测试用例类似，套件设置和拆解是一个可以带参数的关键字。它们分别在设置表中使用Suite Setup和Suite Teardown设置进行定义 。它们也有类似的同义词，Suite Precondition和Suite Postcondition，作为测试用例设置和拆解。关键字名称和可能的参数位于设置名称后面的列中。

如果套件设置失败，则会立即为其中的所有测试用例及其子测试套件分配一个失败状态，并且它们实际上并未执行。这使得套件设置非常适合检查在运行测试用例之前必须满足的前提条件。

在执行完所有测试用例后，套件拆卸通常用于清理。即使同一套件的设置失败，也会执行它。如果套件拆卸失败，则套件中的所有测试用例都标记为失败，无论其原始执行状态如何。从Robot Framework 2.5开始，即使其中一个关键字失败，也会执行套件拆解中的所有关键字。

作为设置或拆卸执行的关键字的名称可以是变量。通过从命令行提供关键字名称作为变量，这有助于在不同环境中进行不同的设置或拆卸。