RF框架自定义测试库开发

静态库

方法(methods)直接映射为关键字名称。关键字接受和方法相同的参数, 通过抛异常来报告错误, 通过往标准输出里写入来写 log, 同时可以通过return 来返回结果。

创建步骤：

▲ 首先，在D:\xxxxx\Lib\site-packages目录下新建包名【比如MyLibrary】

▲ 其次，在__init__.py文件用于定义自定义库的相关信息，需要用到的keywords调用继承和声明。

注意：类名必须跟创建的包名MyLibrary一模一样，否则导入库会失败。

▲ 再次，在D:\xxxxxx\Lib\site-packages/MyLibrary目录下新建version.py文件用于描述自定义测试库的版本信息

▲ 最后， MyLibrary目录下新建MyKeywords类文件，用于完成想封装的各项功能方法，在函数定义文档注释用于导入RF框架，会显示该库的关键字文档内容信息

RIDE中导入库，用文件夹名字导入就行。

如果有多类需要引用，比如引用MyKeywords和MyTest1类，如下方法：

导入测试库

可看测试库信息

执行脚本

输出结果

动态库

RF的动态API方式，是利用get_keyword_names、run_keyword、get_keyword_arguments、 get_keyword_documentation四个固定名称的方法来运行关键字。只要你创建的类有这四个方法（主要是前两个），就可以让RF识别关键字。

动态库和混合库定义版本信息和init文件方法是一样，只是类文件封装方法及机制处理不同。

RF的动态API方式，是利用get_keyword_names、run_keyword、get_keyword_arguments、 get_keyword_documentation四个固定名称的方法来运行关键字，只要你创建的类有这四个方法（主要是前两个），就可以让RF识别关键字。
get_keyword_names方法实际是告诉RF，我们的库中有哪些关键字。RF会从get_keyword_names方法的返回值中读取关键字名称。
run_keyword方法则实际执行关键字对应的代码。run_keyword第一个参数是需要执行的关键字的名称，第二个参数是关键字的参数。
get_keyword_arguments方法告诉RF，每个关键字的参数是什么样的。它的参数是关键字的名称，返回值则是关键字的参数。
get_keyword_documentation方法告诉RF，每个关键字的说明文档的内容。

导入库后，查看信息如下图所示：

混合库

顾名思义，混合API方式是静态API和动态API方式的混合使用。混合API方式，使用get_keyword_names方法告知RF关键字有哪些，但是不使用run_keyword方法执行关键字。执行方式和静态API相同，执行和关键字同名的方法。

▲ 这个例子中，使用get_keyword_names方法告诉RF有“first_keyword”和"second_keyword"两个关键字。其中 “first_keyword”关键字执行first_keyword方法的代码。执行"second_keyword"关键字时，由于没有对应的方法，所以RF先执行“__getattr__”方法，然后获取“__getattr__”方法返回的值。

▲ 注意：这里返回的值是一个可以被RF执行的方法（或函数），而不是一个字符串。RF找到这个方法（或者函数）后，再执行代码。

测试库文档

测试库文档其实就是代码里的document注释，通常用3个双引号括起来，通常建议写在代码注释，这样有一个好处，RF提供了libdoc工具，可以很方便生成一份测试库文档，具体命令参考：

生成后的文档样本如下：

每次代码更新，就同步更新document注释，只需重新执行命令生成新的文档即可，文档可以直接为他人使用提供参考便利。

可以创建文档:

测试库实现 Python 或 Java 使用正常静态库API,
测试库使用动态API ,包括远程库
资源文件。

另外可以使用Libdoc创建的XML规范作为输入。

选项

- f , - - -格式 `< html \| xml >`
	指定是否要生成HTML或XML输出。如果不使用此选项,格式扩展的输出文件。
- f , ——docformat `<机器人其他html文本\| \| \| >`
	指定源文件的格式。可能的值是机器人框架的文档格式, HTML、文本和恰好。默认值可以指定在测试库源代码和初始默认值 `机器人` 。 2.7.5新机器人框架。
- n , ——名字 `<新名称>`
	集的名字记录库或资源。
- v , ——版本 `<新版本>`
	集的版本库或记录资源。测试库的默认值从源代码。
- p , ——pythonpath环境 `<路径>`
	额外的位置搜索库和资源同样时运行测试。
- e , ——逃避 `<什么:>`
	转义字符的问题在控制台。 `什么` 角色的名字逃脱吗和 `与` 是字符串来逃避它。在列出可用的逃 ——帮助输出。
- h ,——帮助	打印这个帮助。

资源文件的路径

资源文件必须使用指定的路径。如果路径是不存在,资源文件中所有目录搜索的模块搜索路径同样当执行测试用例。

生成文档

在HTML或XML格式生成文档时,输出文件必须被指定为第二个参数后,图书馆/资源名称或路径。输出格式是自动从扩展但也可以设置使用 - - -格式选择。

例子:

python -m robot.libdoc OperatingSystem OperatingSystem.html
python -m robot.libdoc --name MyLibrary Remote::http://10.0.0.42:8270 MyLibrary.xml
python -m robot.libdoc test/resource.html doc/resource_doc.html
jython -m robot.libdoc --version 1.0 MyJavaLibrary.java MyJavaLibrary.html
jython -m robot.libdoc my.organization.DynamicJavaLibrary my.organization.DynamicJavaLibrary.xml

查看控制台信息

Libdoc有三个特殊的命令在控制台上显示信息。使用这些命令输出文件的名称,而是和他们可以也附加参数。

列表

: 列表的名称关键词库/资源包含。可以限于只显示某些关键词通过可选模式作为参数。关键词列出其名称是否包含给定的模式。

显示

: 显示库/资源文档。只能是有限的显示吗某些关键词通过名称作为参数。如果显示关键字它的名字匹配任何名字。特别的观点 介绍 将显示只有图书馆引进和导入部分。

版本

: 显示库版本

可选模式给 列表和显示。同时也接受 * 和 ?作为通配符。

例子:

python -m robot.libdoc Dialogs list
python -m robot.libdoc Selenium2Library list browser
python -m robot.libdoc Remote::10.0.0.42:8270 show
python -m robot.libdoc Dialogs show PauseExecution execute*
python -m robot.libdoc Selenium2Library show intro
python -m robot.libdoc Selenium2Library version