Robot framework(RF)基本使用

上一章我们介绍了如何搭建RF+WD的基本环境，那么这一章主要介绍RIDE的基本使用。

1.1 第一个测试项目

3.1.1 第一个测试用例

创建项目涉及到一系列相关的操作，包括新建项目、新建测试套件、新建测试用例等，下面用一个例子来介绍RIDE的这方面的使用。

创建项目步骤：

1、单击“File;New Project” 创建项目。

2、在弹出的新建项目对话框中输入项目名。

A、 Name：项目名

B、 Parent Directory：项目父文件夹，可以通过“Browse”更改

C、 Type：项目的类型（对于项目我们建议Type选择Directory）

File：把项目作为一个文件管理

Directory：把项目作为一个目录管理

File下面可以直接创建测试用例，Directory下面不可以直接创建用例，可以创建测试套件（Suite）

D、 Format：文件的类型

E、 Created Path：如果Type选择的是File，created path保存成”项目名.txt”

如果Type选择的是Directory，created path保存成“项目名\__init__.txt”

3、项目的编辑区

4、新建Test Suite。

5、在编辑区，可以增加库。测试web项目需要增加selenium库。

6、写入suite名，Type选择File。

7、新建测试用例。

8、填入用例名。

9、编辑测试用例。

10、在表格中编写测试用例。

11、执行测试。

快捷键按F8

3.1.2 从F5 开始学习

Robot Framework 并没有像其它框架一样提供一份完整的API 文档，所以，我们没办法通过官方API文档进行习。RIDE 提供了F5 快捷键来打开帮助文档。

【search term】: 用于搜索关键字。

【source】：用于选择相关库，默认在所有库下搜索关键字。

3.1.3 测试项目与测试套件的概念

如果你查看当前所创建的项目会发现，“测试项目”是一个目录。

“测试套件”则是一个txt 文件。

“测试项目”和“测试套件”本质上并没有什么区别，如果你愿意，也可以把测试项目创建成一个文件：

如果你把“测试项目”创建成一个文件后，那么在这个“测试项目”下就不能再创建“测试套件”了，只能创建测试用例。

除非我们所创建的“测试项目”非常小，只需要几个用例。一般情况下，我们会选择将其定义成一个目录，这样它就可以分成多个套件，套件可定义为不同的业务，不同的业务下再分用例，结构会更加清晰。

当然，你同样也可以把“测试套件”创建成一个目录。

如果你把“测试套件”创建成了一个目录后，就不能直接在其下面创建用例了，还需要再创建的“File”类型的“子测试套件”。说白了就是用例只能创建在file 类型的套件中。

下面用一张图来表述他们的关系：

1.2 Edit 标签

下面我们来看一看测试项目和测试套件所提供的Edit 标签。

从而“测试项目”和“测试套件”所提供的Edit 标签的功能也可看出两者是一样的。

测试项目图如下：

测试套件图如下：

在Edit 标签页中主要分：加载外部文件、定义内部变量、定义元数据等三个部分。

（1）加载外部文件

Add Library：加载测试库，主要是[PYTHON 目录]\Lib\site-packages 里的测试库

Add Resource：加载资源，主要是你工程相关的资源文件

Add Variables：加载变量文件。

（2）定义内部变量

Add Scalar：定义变量

Add List：定义列表型变量

（3）定义元数据

Add Metadata：定义元数据。我是直接翻译的，这个是新增加的部分，大概看了一下作用是在report和log 里显示定义好的内容，格式和document 一样。

3.2.1 导入库

点击Edit 标签页右侧的“Library”按钮，来添加库。在添加库之前，首先库已经在Python 下进行了安装。如，添加“Selenium2Library”库。

如果添加的库不存在或库名错误，将会红色显示，黑库正常表示正常。

如果你是在“测试套件”中添加的库，那么这个库中所提供的关键字可以被当前测试套件下的用例使用。

如果你是在“测试项目”中添加的库，当前项目下的测试用例不能使用库中的关键字，需要在用例相应的“测试套件”中再次添加库。

现在按F5 就可以查看库中所提供的关键字。

3.2.2 导入资源

点击Edit 标签页右侧的“Resource”按钮来添加资源。这个资源一般为项目关的文件。比如，项目的自定义关键字文件。

下面我们就来添加一个“mykeywork.txt”文件。

关于添加资源的作用域与库一样。我这里是添加到的测试套件中，那么它的作用域就是当前测试套件下的所有用例。

查看RIDE 左侧项目列表，会发现“External Resource”下多了一下“mykeywork.txt”的资源。展开关键字会看到文件中定义的打开浏览器、最大化浏览器、输入用户名、输入密码、点击登录、关闭浏览器等关键字。导入资源之后就可以在用例中使用这些关键字。

3.2.3 定义变量

点击Edit 标签页右侧的“Add Scalar”按钮来创建变量。这里创建的变量可以被整个测试套件中的用例所使用。也可以认为是一个“公共变量”。

Name 用于定义变量名：${url}

Value 用于给变量赋值。http://127.0.0.1:8090/recruit.students/login/view

下面就可以在测试用例中来使用这个变量。

用例中是两个打印信息，分别使用了${url}变量。

相信从用例的执行结果中我们已经体会到了“公共变量”的作用。

3.2.4 定义列表变量

列表变量可以用来定义一维或二维数组。下面我们就来创建一个列表变量。点击Edit 标签页右侧的“Add List”按钮来创建登录用户的一组变量@{username}

Name 定义变量名为：@{username}

Value 填写列表变量的值：admin、zhangsan、lisi、wangwu。

在测试用例中可以对这个一维数组进行遍历。

运行结果：

1.3 Text Edit 标签

我们在Edit 标签页完成的工作，都可以在Text Edit 标签页上完成。它们之间是对应关系，Edit 可视化的提供的按钮输入框，对于用户来说更容易知道我要怎么做；而在Text Edit 中只是一个空当当的文本，我们跟本不知道如何下手。

好在我们已经在Edit 中做了很多事情。切换到Text Edit 将会看到这些信息的展示。

或者切换到“D:\project\Educational\test_project1”目录下，通过记事本打开“Selenium2Library_库的关键字练习.txt”。

测试用例的本来面目也是这个样子的，只是在RIDE 中对它进行的“美化”。

其实在这个在Text Edit 下或第三方编辑器下编写Robot Framework 测试的效率要远远高于Edit 标签中的“填表格”式编写。读者可以在两种标签页之间切换来提高用例的开发效率。

1.4 Run 标签

3.4.1 导入库

下面是Run 标签的截图：

第一眼看上去，Run 标签提供了丰富的操作和日志。按照截图我们依次来说明Run 标签上的按钮和输入框的作用：

【Execution Profile】：选择运行方式，里面有pybot、jybot 和custom script。其中我们默认是用pybot来运行案例，pybot 的运行Python 编译器完成。jybot 需要安装Jython 的支持。custom script 是选择自定义的脚本来运行。

【Start和Stop】：用例的运行和停止。

【Report和Log】：报告和日志，要运行之后才能点击。他们之间的区别：报告更多是结果上的展示，日志更多是过程的记录，在测试用例调试的过程中更多使用日志来查看执行错误。当只想知道测试用例的最终执行情况时用报告。

【Autosave】：自动保存，如果不勾选，在修改了用例之后如果没有保存的话，运行案例时会提示是否保存。勾选则在运行时自动保存了。

【Arguments】：pybot 的参数（或者jybot 等），可以在这里输入pybot 的命令完成相应的操作。

【Only Run Tests with these Tags】：只运行这些标记的测试案例。

【Skip Tests with these Tags】： 跳过这些标记的测试案例。

下面的两个区域，中间区域记录用例的执行过程，底部的区域输出用例的执行结果。

3.4.2 运行与停止

在Run 标签页提供了运行与停止的按钮，使用很简单。点击“运行”按钮就可以运行，在C:\Python27\Lib\site-packages\robotide\run 目录下，有个process.py 文件，RIDE就是通过这个文件去执行测试的，大家如果想了解原理，可以去读下相关代码。

3.4.3 报告与日志

当用例运行结束，Robot Framework 生成三个文件：output.xml、log.html 和report.html。

output.xml 记录的测试结果是xml 文件，这个文件不够直观。根据特定的需要可以编写脚本读取xml文件并生成特定的测试报告。

相比较而言log.html 和report.html 报告要直观得多，因为是html格式。

查看log.html 文件，点击Run 标签而上的“Log”按钮，通过默认浏览器打开。

在log.html 文件中可以查看用例执行的每一步，适合跟踪定义问题。

查看report.html，点击Run 标签而上的“Report”按钮，通过默认浏览器打开。

report.html 用于最终结果的展示，适合了解测试用例的执行情况：测试了哪些模块，用例数、失败率等。

3.4.4 筛选执行用例

这一节来探讨一下，几中方式可以筛选要运行的运用例。

第一种：勾选

这种方法最简单和直观，要运行哪条用例就勾选哪一条。如果全部不勾选，点击“运行”按钮会运行所有用例。

也可以在“测试套件”上右键选择：

Select All Test：选择当前套件的所有用例。

Select Only Failed Test：选择当前套件下运行失败的用例。

Select Only Passed Test：选择当前套件下运行成功的用例。

对于一个测试套件下有几十上百个用例来说，这几选项将非常有用。

第二种：用命令

这就用到Run 标签中的Arguments 功能。

在Arguments 的输入框内输入“-t test_add_list”。点击“Start”按钮，只执行了-t test_add_list 这一条用例。

Arguments 能做的事情可不止于此。想了解更多多命令。可以在cmd.exe 下执行“pybot.bat --help”。

第三种：筛选标记

这种方式就非常有意思的，对于不同的人来说会有一些标记，比如某富二代的标记就是“任性”。对于用例来说也可以打上标记。比如“重要”、“一般”、“基础”等。

点击某个用例，你会看到“Setting>>”的按钮，点击按钮展开：

在最下面将会看到“Tags”的选项，在“<Add New>”的输入框内输入“v1.0”。这条用例就打上了版本“v1.0”的标记。

现在切换到Run 标签，我要运行带“v1.0”标记的用例了，如何去做了？这就要用到：

Only Run Tests with these Tags：只运行这些标记的测试案例。

Skip Tests with these Tags： 跳过这些标记的测试案例。

因为“test_add_list”被打上了“重要”的标记，所以它被执行了。

对于一个用例来说，我们可以为它添加多个标记。勾选“Skip Tests with these Tags”选项可以跳过某些标记的用例。

3.5 Settings

不管是测试套件还是测试用例都会有一个“Setting>>”的按钮，因为它默认是被折叠起来的，所以，一般不太容易发现它，更不知道点击它之后是可以展开的。

3.5.1 测试用例的Settings

点击测试用例上的“Settings>>”按钮，会看到下面的选项。

Documentation：用于描述用例的一个小文本，如果是URL 地址转换为可点击的链接。

Setup 和Teardown：如果你了解unittest 单元测试框架的话，一定对这两个单词不陌生。

setUp 用于设置初始化工作，在每一个测试用例前先被执行

tearDown 方法在每个测试方法执行后调用，这个方法用于完成测试用例执行后的清理工作，如执行

“close browser”关闭浏览器等。

TimeOut：用于设置用例的超时时间。如“1 min 10s”、“ 2 hours”等。

Template：指定模板使用的关键字。

Tags ：用于给用例添加标记。在上一小节中有用到这个功能。

3.5.2 测试套件的Settings

这里的Setup 和Teardown 分测试套件的和测试用例的。“Suite Setup”和“Suite Teardown”用于当前套件的开始和结束所要做的事情。“Test Setup”和“Test Teardown”会作用于套件下每一个测试用例开始和结束所要做的事情。

Force Tags：表示当前测试套件下测试用例强制的标记。

Default Tags：表示当前测试套件下测试用例默认的标记。