Robot Framework（五）使用测试库

使用测试库

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

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库是特殊的，因为它自动使用，因此它的关键字始终可用。其他标准库需要以与任何其他库相同的方式导入，但不需要安装它们。此外，它们在使用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库文档。

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