1、为什么要自定义库
- RobotFramework中所有的keyworks都来自于Library，当所有存在的内置Libraries、第三方Libraries中都没有你要的keywords时，你就可以自己动手造一个啦。
2、下载官方示例robotdemo
- robotdemo中自定义了一个CalculatorLibrary库，作用是对加减乘除的输入表达式和计算结果进行判断
- 举个例子：
- 输入‘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的关键字是不区分大小写的喔
写在最后
- 通过阅读自定义库的这个示例，可以了解到如何去自定义库，自定义库的语法有没有什么特别的，在后续工作中也是很有帮助的
- 实践出真知
