今天总结下Robot Framework最基本的用法,一来呢,希望自己以后看到这篇总结,很快能回忆起如何使用Robot Framework。二来呢,以初学者的姿态总结Robot Framework,希望帮助到刚入门,却无从下手的新手们,毕竟网上很多资料可能是一些大神整理的,跳跃性很大。
关于robotframework环境搭建请参考笔者的另外一篇博文:Robot Framework的环境搭建
2.1创建项目New Project
File->New Project
注:选择directory原因是,在directory的项目下可以创建测试套件,如果是tpye为file,则只能创建测试用例,这不利于用例的管理。
2.2创建测试套件New Suite
右键项目Test,点击New Suite。
注:选择file原因是,在file的测试套件下可以创建测试用例,如果是tpye为directory,还得重新再继续建file的测试套件,才能创建测试用例,因为测试用例只能在file类型下创建。
2.3创建测试用例New Test Case
右键测试套件,点击New Test Case。
最终页面显示
3.1测试套件工作区说明
3.1.1测试套件Edit区
大体分成4个部分。
(1)加载外部文件
Library:加载测试库,主要是[PYTHON目录]\Lib\site-packages里的测试库。具体操作可查看博文下方的“4.2第三方库”。
Resource:加载资源,主要是你工程相关的资源文件。具体操作可查看博文下方的“5.2.5导入Resource”。
Variables:加载变量文件,不怎么用,可暂时忽略。
(2)定义内部变量
Add Scalar:定义变量。
Add List:定义列表型变量。
Add Dict:
(3)元数据定义
Add Metadata:定义元数据。
(4)settings
一般settings是隐藏的,点击settings按钮,则会显示。
Documentation:文档,每一项都有。可以给当前的对象加入文档说明。
Suite Setup指的是测试套件启动的时候就执行某个关键字。(例:我在Suite Setup设置了Sleep | 5sec,表示等待5秒,要注意关键字的参数要使用 | 分隔)
Suite Teardown指的是测试套件结束的时候就执行某个关键字。
Test Setup指的就是案例启动的时候执行某个关键字。
Test Teardown指的就是案例结束的时候执行某个关键字。
Test Template:测试模版,这是可以指定某个关键字为这个测试套件下所有TestCase的模版,这样所有的TestCase就只需要设置这个关键字的传入参数即可。
Test Timeout:设置每一个测试案例的超时时间,只要超过这个时间就会失败,并停止案例运行。这是防止某些情况导致案例一直卡住不动,也不停止也不失败。
Force Tags:在文件型Suite这里还可以继续给子元素增加Force Tags,但是他不能删除父元素设置的tags。
Default Tags:默认标记,其实和Force Tags没啥区别的。
Arguments:传入参数。
Return Value:返回值。
3.1.2测试套件Text Edit区
测试套件测试用例文本信息。
3.1.3测试套件Run区
Execution Profile:选择运行方式,里面有pybot、jybot和custom script。默认pybot即可。
Start:运行案例。若该测试套件下的测试用例前无勾选,则默认执行该测试套件下所有的用例。若测试用例勾选,则执行该测试陶见下勾选的用例。
Stop:停止案例。
Report和Log: 报告和日志,要运行之后才能点击。他们的区别,报告更多是结果上的展示,日志更多是过程的记录,更多使用的还是日志。
Autosave: 自动保存,如果不勾选,在修改了案例之后如果没有保存的话,运行案例时会提示是否保存。勾选则在运行时自动保存了。
Arguments: pybot的参数(或者jybot等)。完整版的参数可以在doc命令行输入pybot.bat --help
Only Run Tests with these Tags: 只运行这些标记的测试案例。在case的setting里可以添加tag。
Skip Tests with these Tags: 跳过这些标记的测试案例。在case的setting里可以添加tag。
3.2测试用例工作区说明
3.2.1测试用例Edit区
(1)settings
Documentation:文档,每一项都有。可以给当前的对象加入文档说明。
Setup指的就是案例启动的时候执行某个关键字。
Teardown指的就是案例结束的时候执行某个关键字。
Tags:标记某个测试用例。在Run区中Only Run Tests with these Tags和Skip Tests with these Tags,会通过这个标志位来识别是否运行或跳过用例。
Timeout:设置每一个测试案例的超时时间,只要超过这个时间就会失败,并停止案例运行。这是防止某些情况导致案例一直卡住不动,也不停止也不失败。
Template:测试模版,这是可以指定某个关键字为这个测试套件下所有TestCase的模版,这样所有的TestCase就只需要设置这个关键字的传入参数即可。
(2)表格区
最重要的部分,编写测试用例。
第一列一般写的是关键词,关键词的来源包括BuiltIn库,第三方导入库,自己编写的导入库。详见博文下方关于库的说明:四,Robotframework库的介绍。
使用技巧:
通过ctrl+alt+space可以自动带出相关关键字。以及相关用法,里边有对入参的说明。
Ctrl+鼠标悬浮(即鼠标在某个关键字上),可以直接显示关键字的相关用法。
第二三四五列,一般是入参,红色的表示必填的入参。浅灰色表示选填的入参。深灰色表示无需填写。
输入sho再同时按住ctrl+alt+space键,则可以自动带出相关关键字,以及选中关键字的用法。
对于已输入的关键字,忘了其用法,可以点击输入框再同时按住ctrl+alt+space键,即可查看该关键字的用法。
3.2.2测试用例Text Edit区
同测试套件。
3.2.3测试用例Run区
同测试套件。
4.1BuiltIn内建库
首先先介绍下robotframework的库,通过点击F5快捷键。目前只有内建的库BuiltIn,关于内建的库BuiltIn的关键字说明请查看另外一篇博文:学习Robot Framework必须掌握的库—-BuiltIn库。
注:其实关键字就是方法名函数名而已。
只有内建的库往往还不能满足需求,还可以导入第三方库,如操作页面的Selenium2Library。
第三方库,主要是[PYTHON目录]\Lib\site-packages里的库,一般安装的库会在此目录下。Selenium2Library库的安装也可以详看笔者的另外一篇博文:Robot Framework的环境搭建。博文中有说明Selenium2Library库的安装。
在测试套件下的工作区的右方,点击Library,在弹出框的name栏输入“Selenium2Library”,点击OK即可。
当工作区的Library那一行黑色显示,说明导入成功(如果显示红色说明导入不成功,可自行百度解决)。
点击F5快捷键查看,可查看多了一个Selenium2Library的库。
4.3导入自己编写的库
比如说有些功能想自己编写,比如说如下代码,想要导入实现校验url的功能,文件名为Myimport.py(文件名随意取的,最好是英文的),该文件保存在D:\robotframework\MyLibrary,此时需要将该路径添加到[PYTHON目录]\Lib\site-packages下的后缀名为pth的文件(文件名随意取的,最好是英文的)中。
# -*- coding:utf-8 -*- """ 自己编写,验证获得一个URL地址的扩展名。 """ import re def Matchurl(str0): u''' 验证url的有效性 ''' str1=re.split("[.]",str0) listt = ['php','html','asp','jsp'] if str1[-1] in listt: return "TRUE" else: return "FAIL" if __name__=='__main__': str_input='hehe.php' print match_url(str_input)
然后重启ride,在测试套件的工作区的右方,点击Library,在弹出框的name栏输入“Myimport”,点击OK即可。
点击F5,即可看到导入自己编写的库。
注意,在Myimport.py文件中编写函数描述时,前面要加u,否则F5查看时,会乱码。
注意,在Myimport.py文件中函数命名为MatchUrl和Match_Url,在ride中都会解析为Match Url。
5.1编写百度搜索的测试案例。
关于selenium2Library的关键字使用,可自行百度“robot framework的selenium2Library的操作手册”,网上大把说明。
这里提一句,关于定位元素,可以通过id,name,xpath,link,css,tag等定位。
Id定位:id=kw
Name定位:name=wd
Xpath定位:xpath=//input[@id='kw']
Link定位:link=link_text
Css定位:css=#kw
Tag定位:tag=input
具体定位方式跟selenium的如出一辙,可以查看笔者另外一篇博文:Selenuim+Python之元素定位总结及实例说明。
5.2分层方法-案例层和流程层分离
如果想改变输入框的输入词,则需要不停的复制case,为了减少冗余,可以做一个简单的分层,把搜索流程剥离成一个关键字,然后再不同的case中调用这个关键字,然后传递不同的参数,以进行不同数据在同一流程下测试。
那如何分层呢?
5.2.1创建User Keyword
先选中case中所有的脚本,右键选择Extract Keyword。
此时左边区域会出现“搜索测试”User Keyword,该User Keyword在测试套件下,一般测试套件不放置User Keyword,建议User Keyword放置在Resource下。
5.2.2创建Resource
如果存在可以不需要创建。
右键项目Test,点击New Resource。
我这里新建的Resource叫做MyResource.txt.
5.2.3将User Keyword移至MyResource下。
5.2.4User Keyword入参设置
由于搜索数据可变,将其作为入参,变量用${}表示,在settings的Arguments设置,若是有多个入参,那么用|分隔,如${入参1}|${入参1}
需要在测试套件中导入Resource,才能使用该Resource下的User Keyword。这一步别忘了哦。如果之前导入过,则忽略。
在测试套件下的工作区的右方,点击Resource,在弹出框的name栏输入“MyResource.txt”,点击OK即可。
当工作区的Resource那一行蓝色显示,说明导入成功(如果显示红色说明导入不成功,可自行百度解决)。
点击F5快捷键查看,可查看多了一个MyResource.txt的库。
5.2.6查看测试用例
会发现原来的一串表格代码编程“搜索测试”User Keyword,且还有个必须输入的入参。
这样可以轻松的添加多个测试案例了。
5.3分层方法-流程层和元素层分离
将搜索测试中的内容继续分层,将底层的关键字继续拆分。
5.3.1创建Resource
如果存在可以不需要创建。
右键项目Test,点击New Resource。
我这里新建的Resource叫做ElementResource.txt。
创建之后,记得在MyResource.txt工作区下,导入ElementResource.txt资源哦。如何导入,详见“5.2.5导入Resource”。
5.3.2创建User Keyword
选中Open Browser那一行,右键选择Extract Keyword。
5.3.3将User Keyword移至ElementResource.txt下。
5.3.4将“打开浏览器”的入参值由“http://www.baidu.com”改为${url}
此时,搜索测试中,打开浏览器的入参输入框显示红色,说明必须有一个入参,可以填写“http://www.baidu.com”。
5.3.5剩余关键字
剩余关键字重复5.3.2-5.3.4操作。
输入搜索关键字
点击搜索
校验标题
关闭浏览器
而此时搜索测试页面如下:
5.4运行测试用例
选中需要运行的用例,点击运行按钮。
可以在Run区查看到用例执行情况。
点击Report(或者直接复制下方的url),可以查看到测试报告,绿底表示测试通过。
点击Log(或者直接复制下方的url)。