Robot Framework（五）使用测试库

浅浅的花香味﹌ 2021-12-15 03:21 276阅读 0赞

## 使用测试库 ##

测试库包含那些最低级别的关键字，通常称为 *库关键字*，实际上与被测系统交互。所有测试用例总是使用某些库中的关键字，通常是通过更高级别的用户关键字。本节介绍如何使用测试库以及如何使用它们提供的关键字。创建测试库在单独的部分中描述。

### 2.4.1使用测试库 ###

下面的小节给出了使用测试库的说明。

#### 使用库设置 ####

通常使用“ 设置”表中的“ 库”设置导入测试库，并在后续列中具有库名称。库名称区分大小写（它是实现库的模块或类的名称，并且必须完全正确），但忽略其中的任何空格。使用模块中的Python库或包中的Java库，必须使用包括模块或包名称的全名。

在库需要参数的情况下，它们列在库名后面的列中。与关键字的参数类似，可以在测试库导入中使用默认值，可变数量的参数和命名参数。可以使用变量设置库名称和参数。

<table> 
 <thead> 
  <tr> 
   <th>Setting</th> 
   <th>Value</th> 
   <th>Value</th> 
   <th>Value</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Library</td> 
   <td>OperatingSystem</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>com.company.TestLib</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>MyLibrary</td> 
   <td>arg1</td> 
   <td>arg2</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>${LIBRARY}</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
 </tbody> 
</table>

可以在测试用例文件， 资源文件和测试套件初始化文件中导入测试库。在所有这些情况下，导入库中的所有关键字都可在该文件中使用。对于资源文件，这些关键字也可以在使用它们的其他文件中使用。

#### 使用Import Library关键字 ####

采取测试库投入使用另一种可能性是使用关键字导入库从内建库。此关键字与库设置类似地获取库名称和可能的参数。导入库中的关键字在测试套件中可用，其中使用了Import Library关键字。如果在测试执行开始时库不可用并且只有其他一些关键字使其可用，则此方法很有用。

<table> 
 <thead> 
  <tr> 
   <th>Test Case</th> 
   <th>Action</th> 
   <th>Argument</th> 
   <th>Argument</th> 
   <th>Argument</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Example</td> 
   <td>Do Something</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp;</td> 
   <td>Import Library</td> 
   <td>MyLibrary</td> 
   <td>arg1</td> 
   <td>arg2</td> 
  </tr> 
  <tr> 
   <td>&nbsp;</td> 
   <td>KW From Mylibrary</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
 </tbody> 
</table>

#### 库搜索路径 ####

指定要导入的测试库的最常用方法是使用其名称，就像在本节的所有示例中一样。在这些情况下，Robot Framework尝试从*库搜索路径中查找*实现库的类或模块。基本上，这意味着库代码及其所有可能的依赖项必须在PYTHONPATH中，或者在Jython上运行测试时，必须在 CLASSPATH中。设置库搜索路径在其自身的一节中进行了解释。库还可以自动设置搜索路径，或者有关于如何执行此操作的特殊说明。例如，所有 标准库都自动位于库搜索路径中。

这种方法的最大好处是，当配置库搜索路径时，通常使用自定义启动脚本，普通用户不需要考虑实际安装库的位置。缺点是将您自己的，可能非常简单的库放入搜索路径可能需要一些额外的配置。

#### 使用到库的路径 ####

指定要导入的库的另一种机制是在文件系统中使用它的路径。此路径被认为是相对于当前测试数据文件所在的目录，与资源和变量文件的路径类似。这种方法的主要好处是无需配置库搜索路径。

如果库是文件，则其路径必须包含扩展名。对于Python库，扩展名自然是.py，对于Java库，它可以是.class或.java，但类文件必须始终可用。如果将Python库实现为目录，则其路径必须具有正斜杠（/）。以下示例演示了这些不同的用法。

<table> 
 <thead> 
  <tr> 
   <th>Setting</th> 
   <th>Value</th> 
   <th>Value</th> 
   <th>Value</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Library</td> 
   <td>PythonLib.py</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>/absolute/path/JavaLib.java</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>relative/path/PythonDirLib/</td> 
   <td>possible</td> 
   <td>arguments</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>${RESOURCES}/Example.class</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
 </tbody> 
</table>

这种方法的局限性在于，作为Python类实现的库必须位于与类同名的模块中。此外，使用此机制无法导入以JAR或ZIP包分发的库。

### 2.4.2给测试库设置自定义名称 ###

库名称显示在关键字名称之前的测试日志中，如果多个关键字具有相同的名称，则必须使用它们，以便 关键字名称以库名称为前缀。库名通常来自实现它的模块或类名，但在某些情况下需要更改它：

*  需要使用不同的参数多次导入同一个库。否则这是不可能的。
 *  库名称不方便长。例如，如果Java库具有长包名称，则可能发生这种情况。
 *  您希望使用变量在不同环境中导入不同的库，但请使用相同的名称引用它们。
 *  库名称具有误导性或其他差异性。在这种情况下，更改实际名称当然是更好的解决方案。

指定新名称的基本语法是在库名后面加上文本 WITH NAME（不区分大小写），然后在下一个单元格中使用新名称。指定的名称显示在日志中，并且在使用关键字的全名（LibraryName.Keyword Name）时必须在测试数据中使用。

<table> 
 <thead> 
  <tr> 
   <th>Setting</th> 
   <th>Value</th> 
   <th>Value</th> 
   <th>Value</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Library</td> 
   <td>com.company.TestLib</td> 
   <td>WITH NAME</td> 
   <td>TestLib</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>${LIBRARY}</td> 
   <td>WITH NAME</td> 
   <td>MyName</td> 
  </tr> 
 </tbody> 
</table>

库的可能参数放在原始库名称和WITH NAME文本之间的单元格中。以下示例说明了如何使用不同的参数多次导入相同的库：

<table> 
 <thead> 
  <tr> 
   <th>Setting</th> 
   <th>Value</th> 
   <th>Value</th> 
   <th>Value</th> 
   <th>Value</th> 
   <th>Value</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Library</td> 
   <td>SomeLibrary</td> 
   <td>localhost</td> 
   <td>1234</td> 
   <td>WITH NAME</td> 
   <td>LocalLib</td> 
  </tr> 
  <tr> 
   <td>Library</td> 
   <td>SomeLibrary</td> 
   <td>server.domain</td> 
   <td>8080</td> 
   <td>WITH NAME</td> 
   <td>RemoteLib</td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <thead> 
  <tr> 
   <th>Test Case</th> 
   <th>Action</th> 
   <th>Argument</th> 
   <th>Argument</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>My Test</td> 
   <td>LocalLib.Some Keyword</td> 
   <td>some arg</td> 
   <td>second arg</td> 
  </tr> 
  <tr> 
   <td>&nbsp;</td> 
   <td>RemoteLib.Some Keyword</td> 
   <td>another arg</td> 
   <td>whatever</td> 
  </tr> 
  <tr> 
   <td>&nbsp;</td> 
   <td>LocalLib.Another Keyword</td> 
   <td>&nbsp;</td> 
   <td>&nbsp;</td> 
  </tr> 
 </tbody> 
</table>

将自定义名称设置为测试库既可以在“设置”表中导入库，也可以在使用“ 导入库”关键字时使用。

### 2.4.3标准库 ###

一些测试库与Robot Framework一起分发，这些库称为标准库。这些是可用的标准库：

*  BuiltIn
 *  OperatingSystem
 *  Telnet
 *  Collections
 *  String
 *  Dialogs
 *  Screenshot
 *  Remote

BuiltIn库是特殊的，因为它自动使用，因此它的关键字始终可用。其他标准库需要以与任何其他库相同的方式导入，但不需要安装它们。此外，它们在使用Python和Jython运行测试时也起作用（将Screenshot库作为例外）。

将来可以并且将来添加新的标准库。如果您对新标准库有所了解，或者甚至可以立即合并，请联系Robot Framework开发人员。通常，如果库是通用的，则可以将库添加到标准库中，在没有任何外部依赖性的情况下在Python和Jython上工作，并且经过充分的测试和记录。

#### BuiltIn库 ####

BuiltIn库提供了一组经常需要的通用关键字。它会自动导入，因此始终可用。提供的关键字可用于例如验证（例如，应该等于，应该包含），转换（例如转换为整数）和用于各种其他目的（例如，日志，睡眠，运行关键字如果，设置全局变量）。

BuiltIn库中的关键字名称已在Robot Framework 1.8版中重命名。所有旧关键字仍然有效，但不推荐使用的关键字的长名称（日志文件中可见的名称）以DeprecatedBuiltIn开头。（例如， DeprecatedBuiltIn.Equals）。强烈建议使用关键字的新名称，因为旧版本将来会被删除。

有关更多信息，请参阅BuiltIn库文档。

#### OperatingSystem库 ####

OperatingSystem库允许在运行Robot Framework的系统中执行各种与操作系统相关的任务。除其他外，它可以执行命令（例如运行），创建和删除文件和目录（例如创建文件，删除目录），检查文件或目录是否存在或包含某些内容（例如文件应该存在，目录应该为空）和操纵环境变量（例如设置环境变量）。

OperatingSystem库中的关键字名称已在Robot Framework 1.8中重命名，类似于BuiltIn关键字的名称。

有关更多信息，请参阅OperatingSystem库文档。

#### Telnet库 ####

Telnet库可以连接到Telnet服务器并在打开的连接上执行命令。

有关更多信息，请参阅Telnet库文档。

#### Collections 集合库 ####

Collections库提供了一组用于处理Python列表和字典的关键字。该库具有关键字，例如，用于修改和获取列表和词典中的值（例如，附加到列表，从词典中获取）以及用于验证其内容（例如，列表应该相等， 词典应该包含值）。

有关更多信息，请参阅集合库文档。

#### String 字符串库 ####

字符串库可以操作字符串（例如，使用Regexp替换字符串，拆分为行）并验证其内容（例如，应该是字符串）。

有关更多信息，请参阅字符串库文档。该库是Robot Framework 2.1中的新增功能。

#### Dialogs 对话框库 ####