RobotFramework自动化测试框架（2）- RobotFramework语法
- RobotFramework测试用例是由四部分组成的，下面就从这四个部分简单介绍语法：
- 关键字表 *** Keywords ***
- 设置表 *** Settings ***
- 变量表 *** Variables ***
- 测试用例表 *** Testcases ***
1、关键字表
关键字表是干什么用的？
组合已有的关键字（包括库关键字和其他用户关键字）来创建新的高层次的关键字，也就是用户关键字。因此，关键字表是存放用户关键字的。
用户关键字的组成：
1、用户关键字的名称
应该具备描述性，使用很长的关键字名称也是可以的。
2、用户关键字的设置项
- 用户关键字的文档：通过 [Documentation] 设置。在关键字文档的开始部分使用 *DEPRECATED* 可以标记该用户关键字已经不建议使用，如果使用则会触发一个警告。
- 用户关键字的标签：通过 [Tags] 设置。带 robot- 前缀的标签名将作为保留。普通用户需避免使用 robot- 前缀的标签。
- 用户关键字的参数：通过 [Arguments] 设置。参数名称的语法格式和变量一样，如 ${arg}。
下面是用户关键字的参数说明：
- 首先是 [Arguments]，后面是声明的参数名称。每个参数占一个单元格，参数名称的语法格式和变量一样。
- 当关键字被调用时，需要传递和此处定义相同数量的参数。
- 参数的名称推荐使用小写字母作为名称，如：${my_arg}，${my arg} 或 ${myArg}。
- 为参数添加默认值只需要在参数名后面跟上等号(=)，然后跟上默认值即可。例如 ${arg}=default。
- 可以为多个参数指定默认值，指定默认值的参数必须跟在普通的位置参数后面。
- 默认值的语法是对空格敏感的。等号 = 前面不允许有空格，而等号后面的空格则被视作默认值的一部分。
- 只需在关键字的参数签名中使用列表变量如 @{varargs} 作为参数声明。
- 同时不定数量的参数可以和默认值参数混用，前面的参数先进行匹配，列表参数最终接受所有剩余的参数，数量可以是0个到任意个。
- 只需在参数列表的最后，在位置参数和任意数量参数的后面，使用字典变量，如 &{kwargs}。
- 当该关键字被调用时，前面没有被匹配的 命名参数 都会传递给该参数。
- 用户关键字返回值：通过 [Return] 设置。
最常见的情况是用户关键字返回一个值，并且赋值给一个标量变量。直接将返回值放在 [Return] 设置后面的单元格内。
用户关键字还可以返回多个值，这些值可以一次性赋给多个标量、或者一个列表变量、或者两者混合。多个值只需依次跟在 [Return] 后面的单元格中即可。
- 用户关键字的 Teardown：通过 [Teardown] 设置 。
teardown 在当前关键字执行失败时也会被调用。此外，teardown 内的所有步骤都会执行到，即使其中某个步骤失败。不过，teardown 的失败会导致当前用例执行失败，并且该用例余下的步骤将不再执行。
例子：
1 *** Keywords *** 2 f1 3 [Documentation] Demo 4 [Tags] one two 5 [Arguments] ${a} ${b}=default value 6 Log ${a}+${b} 7 [Return] ${a} 8 [Teardown] Log ${b}
3、调用的其他关键字
也就是，已有的关键字（包括库关键字和其他用户关键字）。
2、设置表
作用：
导入普通标准库：Library
导入远程库：Library
导入资源文件：Resource
导入变量文件：Variables
导入扩展测试库：Library
1 *** Settings *** 2 Library Selenium2Library 3 Library OperatingSystem 4 Library Remote http://200.200.131.126:8080/RPC2 WITH NAME a1 5 Resource a.robot 6 Variables ../robot_xml.py 7 Library b
3、变量表
作用：
创建变量
变量的分类：
注意：变量是不区分大小写的，同时，其中的下划线和空格也会被忽略。
- 标量变量：${SCALAR}。$：表示标量变量的标识符，{ }：一对花括号，SCALAR：变量名。
- 列表变量：@{LIST}。@：表示列表变量的标识符，{ }：一对花括号，LIST：变量名。
- 字典变量：&{USER}。&：表示字典变量的标识符，{ }：一对花括号，USER：变量名。
1 *** Variables *** 2 ${aa1} 2 3 ${NAME} Robot Framework 4 @{NAMES2} @{NAME} Seppo 5 &{MANY} first=1 second=${2} ${3}=third
4、测试用例表
作用：
编写测试用例
构成：
1、测试用例名称：
位于测试用例表格的第一列。一个用例始于测试用例名，直到遇到下一个用例名，或者到表格的结束。
2、关键字名称：
一般情况下位于第二列。不论关键字名称位于第几列，跟在其后的列包含的是要传递给该关键字的参数。
3、测试用例配置项：
每个测试用例都可以有自己的相关设置。设置项的名称使用方括号（[]）括起来，以区别于关键字。
下面列出了可设置的配置项：
测试用例文档（[Documentation]）
为用例设置一段文档说明。这个说明会显示在命令行的输出中，以及后续的测试日志和测试报告中。
测试用例标签（[Tags]）
一个测试套件中的用例标签必须唯一。
测试用例前（后）置条件（[Setup] / [Teardown]）
- 有两种设置方法：
- 在测试用例文件的设置表中设置Test Setup 和 Test Teardown。这种情况下，该文件中的所有测试用例都会使用该前（后）置条件。
- 对单个测试用例通过设置 [Setup]、[Teardown]设置前（后）置条件。
- 注意事项：
- 在Robot Framework中，setup和teardown都是带参数的普通关键字而已，并且各自只能指定一个关键字。如果涉及到多个步骤，只能创造一个更高层的 user keywords。
- Setup在测试用例之前执行，Teardown在测试用例之后执行。Teardown在以下两个方面比较特殊：首先，它在测试用例执行失败的时候也会被执行，所以常常用来作为测试环境的清理工作。其次，teardown中所有的关键字都会被执行，哪怕其中有的执行失败。
- 如果用例单独设置了 [Setup] 或 [Teardown]，则会覆盖文件中的 Test Setup 或 Test Teardown。进而可以为 [Setup] 或 [Teardown]设置空值（空格或 NONE），表示当前用例没有前（后）置条件，即使测试文件设置表中已有设置。
测试用例模板（[Template]）
- 有两种设置方法：
- 在测试用例文件的设置表中设置 Test Template。这种情况下，该文件中的所有测试用例都会应用该模板。
- 对单个测试用例通过设置 [Template] 指定一个模板。
- 注意事项：
- 如果一个模板用例的内容有多行数据，该模板会逐行应用于这些数据。也就是说，该模板关键字会被调用多次，每次使用其中一行的数据作为参数。如果用例单独设置了 [Template]，则会覆盖文件中的 Test Template。进而可以为 [Template] 设置空值（空格或 NONE），表示当前用例没有模板，即使测试文件设置表中已有设置。
- 模板测试用例在执行过程中，如果有某一轮次执行失败也不会影响下面轮次继续执行。
- 当模板中使用了嵌入式的参数，模板关键字中参数的个数必须和传入的参数个数一致，但是参数的名称不一定非要和原关键字保持一致。甚至还可以添加或减少参数。
需要注意的是：
在测试用例中使用的变量，必须声明。
1 *** Testcases *** 2 Test1 3 [Documentation] Demo2 4 [Tags] ooo 5 [Setup] ${aa1} 6 [Teardown] ${mn} 7 [Timeout] 20 8 Should Be Equal As Integers ${aa1} 2
