测试套件中的用户关键字和变量只能在创建它们的文件中使用,但是resource file可以共享它们。创建资源文件的语法与创建测试套件的语法一样,只是资源文件中没有测试用例即TestCase。
资源文件使用文本格式创建,也可以使用重组文件格式或者json格式。
什么是资源文件?
RF资源文件是Robot Framework(RF)层面的库文件,其主要作用是提供一种共享用户关键字和变量的机制。资源文件中可以包含用来共享的用户关键字,也可以包含Variable表定义的变量。这使得在多个测试套件或测试用例中可以重用这些关键字和变量,提高了测试代码的可维护性和复用性。
用户关键字类似于RF层面的函数,可以把多个关键字操作组成一个“宏”关键字。在RF中,用户关键字是通过Keywords表来定义的,其定义和写一个用例的写法很像,参数支持[Arguments]和返回值[Return]。定义好用户关键字后,该测试套件里面就可以使用该用户关键字了,就像使用库关键字一样。
资源文件的格式基本和测试套件文件类似,除了不能有测试用例表和一些特别的设置项外,其它的都是跟普通的测试套件文件一样的。如果它有Test Case,那它就是一个正常的测试套件文件,而不是资源文件。
在测试用例文件或测试套件初始化文件中定义的用户关键字和变量,只能在创建它们的文件中使用。而通过使用资源文件,可以在多个测试套件或测试用例中共享这些用户关键字和变量。在设置表中使用资源设置来导入资源文件,资源文件的路径可以在设置名称后的单元格中指定。
总的来说,RF资源文件是Robot Framework中一个重要的概念,它极大地提高了测试代码的可重用性和维护性,是编写高效、可维护的自动化测试脚本的关键工具之一。
如何使用资源文件
资源文件在Settings中使用Resource导入,推荐的扩展名是.resource,为了兼容性,也支持扩展名是.robot,.txt,.tsv格式,未来可以强制为.resource格式。
如果资源路径是绝对路径,则可以直接使用,否则,会先搜索导入路径,如果没有找到资源文件,会从python的模块搜索路径查找。
资源文件的路径可以包含变量,并且建议使用以使路径进行独立于系统。如${RESOURCES}/common.resource或 ${RESOURCE_PATH}
*** Settings ***
Resource example.resource
Resource ../resources/login.resource
Resource package/example.resource
Resource ${RESOURCES}/common.resource
资源文件中的用户关键字和变量可以在导入资源文件的文件中使用。
资源文件的结构
资源文件的结构和测试套件一样,只是不包含tests和tasks。另外,资源文件的Setting部分只能导入Library,Resource和Variables,Documentation和Keyword Tag,用户关键字部分和变量部分则和在测试套件中使用方法一样。
如果几个资源文件有相同的关键字,则调用的时候需要用前缀如myresources.SomeKeyword,另外,如果资源文件包含相同的变量,则会使用首先导入的那个资源文件。
*** Settings ***
Documentation An example resource file
Library SeleniumLibrary
Resource ${RESOURCES}/common.resource
*** Variables ***
${HOST} localhost:7272
${LOGIN URL} http://${HOST}/
${WELCOME URL} http://${HOST}/welcome.html
${BROWSER} Firefox
*** Keywords ***
Open Login Page
[Documentation] Opens browser to login page
Open Browser ${LOGIN URL} ${BROWSER}
Title Should Be Login Page
Input Name
[Arguments] ${name}
Input Text username_field ${name}
Input Password
[Arguments] ${password}
Input Text password_field ${password}