项目背景
公司的测试用例采用Testlink进行管理,项目组的成员习惯不同,有些喜欢直接在testlink上写case,有些又喜欢先在excel写了再导入,公司已经提供了一个用例转化的工具,不过是适用于windows的,现在都切换到mac办公以后,就没法适用了,就想着自己写一个吧,惠己及人,真拿这群孩子没办法(手动摊手~)
需求分析
简言之,就是:将excel写的用例文件转化成testlink支持上传的格式文件,批量导入到testlink
需求肢解:
1.testlink支持上传的文件类型是什么------XML
我们在testlink上创建好项目计划-版本后,新建一个测试用例集,点击用例集的设置按钮,有一些操作,其中一个叫“导入用例集”,点击导入用例集,进入到的页面,可以看到可选的导入文件类型为XML,如图:
2.明确了支持导入的文件类型,接下来就需要明确具体以怎样的格式才能正确导入。
我们点击“查看支持文件格式”,查看官方给出的file-formats:
可以看到,文档中明确给出了可以导入和导出测试项目、测试用例集、单个测试用例等等...我这里要做的就是导入测试用例集,先就Test suite进行分析,其他类型的续签可以类推...
这里有2种方式,一种带keywords,一种不带keywords,就拿带keywords的来说:
根元素必须是testsuite,它标识这是一个测试用例集,每对testcase子元素代表一条测试用例case,每个case包含子元素:summary描述、steps操作步骤、expectedresults预期结果、keywords关键词等。由于官方文档维护记录最近只到10年,这个应该是比较老的结构了,我在做的时候遇到了些坑,按着搞了半天都不对,最后直接简单粗暴现在testlink上创建一个用例集,内建几条case,然后再导出来对它的xml格式进行分析,拿到我想要的形式。嗯...我的excel用例模板like this:
testlink导出的xml模板like this:
这里面有很多是我不需要的,将之剔除,只保留关键的精华部分,整理了一下,我需要的格式like this:
这就是我最终要转化成的格式~
明确了要实现什么,接下来就是怎么实现的问题了~
实现
解决一个问题的方法有千万种,每种都有各自的优缺点,关键是看你想怎么做,具体问题具体分析,这里我语言选择python(暂时只会这个和shell哈哈~)。
要用到的库:
1.操作excel,读取数据:xlrd
2.处理xml:python内置的xml模块
3.我要如何提供友好的交互性供团队成员使用?这里用到:Tkinter。支持本地选择文件
简单粗暴,上代码:
#!/usr/bin/python
# -*- coding:utf-8 -*-
import sys
reload(sys)
sys.setdefaultencoding("utf-8")
import xlrd
from xml.dom.minidom import Document
import Tkinter,tkFileDialog
import os
class excel_to_xml():
def __init__(self):
pass
def get_filepath(self):
"""
提供文件选择对话框,从本地选择要转化的excel文件,返回文件路径
"""
root = Tkinter.Tk()
root.withdraw()
filepath = tkFileDialog.askopenfilename()
return filepath
def read_excel(self,path):
"""
读取excel内容,返回所有用例值
"""
# 打开文件
file = xlrd.open_workbook(path)
# 获取第一个sheet(按索引)
sheet1 = file.sheet_by_index(0)
# 获取行数和列数
nrows = sheet1.nrows
ncols = sheet1.ncols
print nrows,ncols
# 获取单元格内容
nclosvalue = []
for j in range(1,nrows):
nrowsvalue = []
for i in range(ncols):
cellvalue = sheet1.cell(j,i)
nrowsvalue.append(cellvalue)
i +=1
nclosvalue.append(nrowsvalue)
j += 1
return nclosvalue
def to_xml(self):
"""
处理数据,转化成xml格式,并将文件保存在用例同路径下
"""
path1 = self.get_filepath()
doc = Document() # 创建DOM文档对象
testcases = doc.createElement('testcases')
doc.appendChild(testcases)
excle_results = self.read_excel(path1)
print(len(excle_results))
for i in range(len(excle_results)):
print"第"+str(i+1)+"个用例为:\n"
print(excle_results[i])
testcase = doc.createElement('testcase')
testcase.setAttribute('name', "%s" % excle_results[i][0].value)
testcases.appendChild(testcase)
summary = doc.createElement('summary')
summary_text = doc.createTextNode('%s' % excle_results[i][1].value)
summary.appendChild(summary_text)
testcase.appendChild(summary)
steps = doc.createElement('steps')
testcase.appendChild(steps)
step = doc.createElement('step')
steps.appendChild(step)
step_number = doc.createElement('step_number')
step_number_text = doc.createTextNode('1')
step_number.appendChild(step_number_text)
step.appendChild(step_number)
actions = doc.createElement('actions')
actions_text = doc.createTextNode('%s' % excle_results[i][2].value)
actions.appendChild(actions_text)
step.appendChild(actions)
expectedresults = doc.createElement('expectedresults')
expectedresults_text = doc.createTextNode('%s' % excle_results[i][3].value)
expectedresults.appendChild(expectedresults_text)
step.appendChild(expectedresults)
i += 1
# 要生成的xml文件名
xml_name = path1.strip().split('.')[0] + '.xml'
# 要生成的xml文件到目录(绝对路径)
dir = path1.strip().split('/')[-2]
xml_dir = os.path.join(('%s') % dir,xml_name)
try:
f = open(xml_dir,'w')
doc.writexml(f, indent='\t', newl='\n', addindent='\t', encoding='utf-8')
f.close()
except:
print("您没有选择任何文件!")
change = excel_to_xml()
change.to_xml()
最后,要以怎样的形式供团队成员使用?
扔给成员一个脚本?可以,但是需要成员也配置环境、安装库,操作麻烦;
这里我选择打包成一个mac端的dmg应用程序,成员只需双击即可从本地文件选择要转化的文件。方法有很多,这里不赘述,我用的py2app,打包后生产dmg包:
添加到电脑应用程序就可以双击使用啦~
写在最后,要做一个东西真不容易啊~
呼呼~完