03_RobotFramework的官方示例阅读（自定义库）

• 自定义库demo地址：https://bitbucket.org/robotframework/robotdemo

1、为什么要自定义库

• RobotFramework中所有的keyworks都来自于Library，当所有存在的内置Libraries、第三方Libraries中都没有你要的keywords时，你就可以自己动手造一个啦。

2、下载官方示例robotdemo

• robotdemo中自定义了一个CalculatorLibrary库，作用是对加减乘除的输入表达式和计算结果进行判断
• 举个例子：

1. 输入‘k + 1’，则‘k’为非法输入，需要判断出‘k’为Invalid button；
   2.输入的表达式为空，则需要判断为Invalid expression；
   3.表达式的结果不合法的情况下，也应该进行判断，如‘1/0’，应该判断为Division by zero

• 了解了CalculatorLibrary库的功能，接下来就运行用例查看结果

3、运行用例

• robotdemo中包含3个robot文件：data_driven、gherkin、keyword_driven
• 这3个用例集分别包含了：数据驱动、关键字驱动、gherkin语法(Given, When, Then. Step Organization)
• 运行用例文件查看结果：

robot data_driven.robot

4、读用例

4.1 data_driven.robot

• data_driven.robot是数据驱动，从用例文件中可以看出，主要是通过定义模板后，按正确的结果、错误结果、异常结果这3类去构造数据进行测试
• data_drivern.robot文件模块解析：模块中的数据分为3部分：Settings\Test cases\Keywords

4.1.1 Settings

• Settings中包含3个内容：
  1.Documention中的第一行是整个用例集的描述，在执行用例文件时，会打印在结果中；
  2.Test Template 定义了测试用例的模板，所有的Test cases都会按照Calculate模板进行执行
  3.Library：导入了自定义库，注意自定义库的导入和第三方库导入的区别哟，自定义所在的文件夹不在sitepackages，所以要加上py后缀哟

image.png

4.1.2 Test cases

• Test cases采用的数据驱动方式，可以看到用例中，直接输入了测试数据，为什么没有进行用例步骤的描述呢？

前面在Settings中有描述到 Test template，为所有的cases都定义了模板，所以用例都会按照这个模板的步骤进行，就不需要再次进行描述啦

• 在用例Calculation error中定义了一个新的模板，这时，这个用例就不会再采用Settings中模板了，那么模板的优先级应该是：用例内的大于Settings中的
• ${EMPTY}是RobotFramework的内置变量

image.png

4.1.3 Keywords

• Keywords中定义了2个关键字：Calculate和Calculation should fail。
• Calculate就是前面提到定义的模板，Calculate中定义了2个参数，定义模板后，直接输入参数就可以按照Calculate的步骤执行了，从而实现了数据驱动
• Push buttions是CalculateLibrary.py定义的关键字，在CalculateLibrary.py的同名类中，定义了一个push_buttons(self,expression)方法
• C${expression}=，这个类型的表达式是什么意思呢？经过验证 C应该是concat的意思，将2个字符串进行连接，就是在${expression}后再加一个=号，如:${expression}的值为1+2，则C${expression}=的值为1+2=
• Calculatuion should fail关键字中，用到了一个表达式${error} = Should cause error C${expression}=，这个表达式是将Should cause error C${expression}=的值赋给了${error},这里相当于是定义了一个变量

image.png

4.1.4 通过阅读用例，理解不了每个关键字的实现过程怎么办？

• 查看CalculateLibrary.py源码，用python的打断点方式，去理解下每个关键字的作用和执行过程哟：

  
  image.png

4.2 没有啦

• gherkin、keyword_driven就不写啦，可以自己去读哟

5、总结

• 刚开始读这个用例的时候，还是比较懵逼的，比如：C${expression}=这个表达式的用法就想了好一会儿，不知道是啥意思
• 还有每个关键字的具体执行过程是怎样的，看用例的过程也很懵。我的方法就是，看到用例中的一个关键字，然后带入参数去看源码，一点点追溯过去，就能理解这个过程了，举个例子：

keyword_driven.robot中用到的关键字为Push button和Result should be，连续输入几个数据字符，最后也能和Result should be中输入的预期结果进行比较，这个为什么呢？每个Push button的结果是存在哪里呢？

• 去看下CalculatorLibrary.py的源码，可以看到push_button方法中是把结果存在__init__中定义的self._result中的
• 为什么在库中定义的方法为push_button在写用例时是用Push button呢？大胆想象，RobotFramework应该是对方法名到关键字之间的转换做了处理。

RobotFramework的关键字是不区分大小写的喔

写在最后

• 通过阅读自定义库的这个示例，可以了解到如何去自定义库，自定义库的语法有没有什么特别的，在后续工作中也是很有帮助的
• 实践出真知