Robot Framework官方教程（五）使用测试库

Robot Framework官方教程（一）入门
Robot Framework官方教程（二）测试数据语法
Robot Framework官方教程（三）创建测试用例
Robot Framework官方教程（四）创建测试套件
Robot Framework官方教程（五）使用测试库
Robot Framework官方教程（六）变量
Robot Framework官方教程（七）创建用户关键字
Robot Framework官方教程（八） 资源和变量文件
Robot Framework官方教程（九） 执行测试用例
Robot Framework官方教程（十）扩展RobotFramework框架

使用测试库

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

2.4.1使用测试库

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

使用库设置

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

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

Setting	Value	Value	Value
Library	OperatingSystem
Library	com.company.TestLib
Library	MyLibrary	arg1	arg2
Library	${LIBRARY}

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

使用Import Library关键字

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

Test Case	Action	Argument	Argument	Argument
Example	Do Something
	Import Library	MyLibrary	arg1	arg2
	KW From Mylibrary

库搜索路径

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

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

使用到库的路径

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

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

Setting	Value	Value	Value
Library	PythonLib.py
Library	/absolute/path/JavaLib.java
Library	relative/path/PythonDirLib/	possible	arguments
Library	${RESOURCES}/Example.class

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

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

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

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

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

Setting	Value	Value	Value
Library	com.company.TestLib	WITH NAME	TestLib
Library	${LIBRARY}	WITH NAME	MyName

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

Setting	Value	Value	Value	Value	Value
Library	SomeLibrary	localhost	1234	WITH NAME	LocalLib
Library	SomeLibrary	server.domain	8080	WITH NAME	RemoteLib

Test Case	Action	Argument	Argument
My Test	LocalLib.Some Keyword	some arg	second arg
	RemoteLib.Some Keyword	another arg	whatever
	LocalLib.Another Keyword

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

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 对话框库

Dialogs库提供暂停测试执行和从用户获取输入的方法。对话框略有不同，具体取决于在Python或Jython上运行的测试，但它们提供相同的功能。

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

ScreenShot 截图库

屏幕截图库具有捕获和存储整个桌面的屏幕截图的关键字。该库使用Java AWT API实现，因此只有在Jython上运行Robot Framework时才能使用它。

有关更多信息，请参阅屏幕截图库文档。

Remote 远程库

远程库与其他标准库完全不同。它没有自己的任何关键字，但它作为Robot Framework和实际测试库实现之间的代理。这些库可以在除核心框架之外的其他机器上运行，甚至可以使用Robot Framework本身不支持的语言来实现。

有关该概念的更多信息，请参见单独的远程库接口部分。该库是Robot Framework 2.1中的新增功能。

2.4.4外部库

根据定义，任何不属于标准库的测试库都是外部库。Robot Framework开发人员提供了一些通用库，例如SeleniumLibrary和SwingLibrary，它们不与框架本身打包在一起，因为它们需要外部依赖项。通用库也可以由其他方提供，大多数团队也只为自己提供一些自定义库。

不同的外部库可以使用完全不同的机制来安装和引入它们。通常，它们还需要单独安装其他一些依赖项。所有库都应该有明确的说明，并最好自动化安装。

有关如何为自己的或一般用法创建新测试库的更多信息，请参阅创建测试库部分。