Robot Framework 开发系统关键字详细

一月蔷薇_456

Robot Framework是一款python编写的功能自动化验收框架。具备良好的可扩展性，支持关键字驱
动，可以同时测试多种类型的客户端或者接口，可以进行分布式测试执行。主要用于轮次很多的验
收测试和验收测试驱动开发（ATDD）

项目源码地址：https://github.com/zhoujinjian/robotframework.git

在使用框架类时，经常性有一些特殊的实现需求往往依据框架本身或者第三方插件是无法满足需
求的，本文的目的，是分享如何开发自定义的库函数（又称之系统关键字）

具体操作方法：

1、首先在..\Python27\Lib\site-packages目录下创建自定义库目录如Verification_Library，用于放
自定义的library库。

2、在自定义文件夹Verification_Library中新建一个"version.py"文件,用于描述自定义测试库的版
本信息。
代码如下：

VERSION='1.0'
3、在自定义库的文件夹Verification_Library下，新建一个keywords类，如文件名：verification.py,
测试类别为：Verfication 详细如下:

（本实例的目的，实现对传入的json格式的data数据进行校验--应用场景，主要是针对http
request库返回的response中的data数据进行校验）：

1. __author__ = 'Administrator'
   
2. #coding=utf-8
   
3. #作用：公共json数据校验方法，遍历data数据，校验字符串及整型数值
   
4. 
   
5. import logging
   
6. data={"classify":
   
7.     [{
   
8.     "id":1,
   
9.     "name":"XX"
   
10.     }],
    
11.     "test":{},
    
12.     "hotSongs":[{
    
13.             "songId" : 2,
    
14.             "songName" :"ddd",
    
15.             "singerId" : 3,
    
16.             "singerName" :"aaa",
    
17.             "hash" : "435B50137E16526DFF5BB10DA13A2A4D",
    
18.             "climaxHash":"E0B5EA5454B5E651C609CE7B713E32F3",
    
19.             "startTime" : 104000,
    
20.             "endTime" : 125000,
    
21.             "krc" : "but I just can't make a sound",
    
22.             "singerImg" : "20111226113925990226.jpg"
    
23.       },
    
24.                 {
    
25.             "songId" : 3,
    
26.             "songName" :"ddd",
    
27.             "singerId" : 4,
    
28.             "singerName" :"aaa",
    
29.             "hash" : "435B50137E16526DFF5BB10DA13A2A4D",
    
30.             "climaxHash":"E0B5EA5454B5E651C609CE7B713E32F3",
    
31.             "startTime" : 104000,
    
32.             "endTime" : 125000,
    
33.             "krc" : "but I just can't make a sound",
    
34.             "singerImg" : "20111226113925990226.jpg"
    
35.       }]
    
36. }
    
37. 
    
38. data1={     "songId" : 2,
    
39.             "songName" :"ddd",
    
40.             "singerId" : 3,
    
41.             "singerName" :"aaa",
    
42.             "hash" : "435B50137E16526DFF5BB10DA13A2A4D",
    
43.             "climaxHash":"E0B5EA5454B5E651C609CE7B713E32F3",
    
44.             "startTime" : 104000,
    
45.             "endTime" : 125000,
    
46.             "krc" : "but I just can't make a sound",
    
47.             "singerImg" : "20111226113925990226.jpg"
    
48.       }
    
49. 
    
50. class Verfication(object):
    
51. 
    
52.     def verfication_data(self,data,msg=None):
    
53.         '''
    
54.         1、验证传入的参数，如果为字典，则遍历字典中的各个key，判断各个key值，如果为字符串型，则校验字符串为非空，如果为整型，则校验字符串大于0
    
55.         2、如果传入的参数为列表，则将列表中各个参数取出，如果列表中各个参数为字典，处理方法参照第1步。
    
56.         '''
    
57.         if isinstance(data,dict):
    
58.             logging.info("---基本信息获取---")
    
59.             logging.info("传入的data为json对象!")
    
60.             logging.info('传入过来的json对象主key的长度：%s'%len(data))
    
61.             keys=data.keys()
    
62.             logging.info(keys)
    
63.             logging.info('---开始进行校验---')
    
64.             #定义变量，计算遍历次数
    
65.             times=0
    
66.             for key,value in data.iteritems():
    
67.                 times=times+1
    
68.                 logging.info("")
    
69.                 logging.info("---传入的data数据，第%s对象元素,key值对应为:%s---"%(times,key))
    
70.                 logging.info('%s:%s' % (key, value))
    
71.                 self.analysis_subItem(value,msg)
    
72.         else:
    
73.             print type(data)
    
74.             logging.info("传入的data数据不是dict对象")
    
75. 
    
76.     #判断value值对应的类型，从而进行相应的处理，嵌入递归函数
    
77.     def analysis_subItem(self,item,msg):
    
78.         '''
    
79.         1、不管value值取出如何，最终还是拆解成最小单元，字符串或者是整型来进行判断
    
80.         :return:
    
81.         '''
    
82.         if isinstance(item,str):
    
83.             if self.get_length(item) == 0:
    
84.                 raise AssertionError(msg or "'%s' should not be empty." % str)
    
85.         elif isinstance(item,int):
    
86.             if int(item)<=0:
    
87.                 raise AssertionError("当前int型获取到的数字小于等于0")
    
88. 
    
89.         elif isinstance(item,list):
    
90.                value_list_len=len(item)
    
91.                logging.info('%s对应值的类型为list且长度为%s'%(item,value_list_len))
    
92.                for i in range(value_list_len):
    
93.                    logging.info("")
    
94.                    logging.info("内嵌的列表中，第%s个子元素"%(i+1))
    
95.                    self.analysis_subItem(item[i],msg)
    
96. 
    
97.         elif isinstance(item,dict):
    
98.                value_dict_len=len(item)
    
99.                logging.info('%s对应值的类型为dict且长度为%s'%(item,value_dict_len))
    
100.                times=0
     
101.                for subkey,subvalue in item.iteritems():
     
102.                     times=times+1
     
103.                     logging.info("")
     
104.                     logging.info("---内嵌的字典中,第%s对象元素,key值对应为:%s---"%(times,subkey))
     
105.                     logging.info('%s:%s' % (subkey, subvalue))
     
106.                     self.analysis_subItem(subvalue,msg)
     
107. 
     
108.     #计算字符串长度
     
109.     def get_length(self,item):
     
110.             length =self._get_length(item)
     
111.             logging.info('Length is %d' % length)
     
112.             logging.info("")
     
113.             return length
     
114. 
     
115.     def _get_length(self,item):
     
116.             try:
     
117.                 return len(item)
     
118.             except:
     
119.                 raise RuntimeError("Could not get length of '%s'." % item)
     
120. 
     
121. if __name__ == '__main__':
     
122.     run_object=Verfication()
     
123.     run_object.verfication_data(data)

复制代码

4、对于创建普通的模块来说这样已经ok了。但要想在robot framework启动后加载这个关键字，还需
要在自定义库目录Verification_Library下创建init.py文件，用于定义自定义库的相关信息和需要用到的
keywords调用继承和声明。

1. __author__ = 'Administrator'
   
2. from verification import Verfication
   
3. from version import VERSION
   
4. 
   
5. __version__=VERSION
   
6. 
   
7. class Verification_Library(Verfication):
   
8.     ROBOT_LIBRARY_SCOPE='GLOBAL'    #此句作用是指该库运行的时候会作用在全局。

复制代码

5、启动ride程序在setting部分添加library库信息，添加库名为Verification_Library ，即可成功导入自定义库。

注意:
库文件夹名称一定要和init文件中的类名称相同（Verification_Library），否则导入自定义库时会出错。

梦想家