python小工具：用python操作HP的Quality Center
背景是这样的： 这个组的测试人员每跑一个case都要上传测试结果附件到QC。每个待测功能模块可能包含几十上百的case。于是手工上传测试结果变成了繁重的体力劳动。令人惊讶的是我们的工具开发组竟然说做不了QC的测试结果附件上传。更让我惊讶的是，测试人员竟然真的手工上传结果上传了大半年了。 以下我写了个小工具解决这个问题： 思路很简单，调用hp提供的ALM Rest api接口。把一个个用户操作转化成http请求。然后按照接口要求，把附件一个一个上传到指定的QC test instance上。 主要用的库是： requests：负责发送http请求 BeautifulSoup4：负责解析QC服务器返回的响应。 整个工具非常简单。 具体步骤如下： 先让用户登录进QC [2017-05-17 13:57:25，023] Starting new HTTP connection (1): XXXXX.com [2017-05-17 13:57:25，430] post http://XXXXX.com:80/qcbin/authentication-point/authenticate [2017-05-17 13:57:25，430] headers = {'Authorization': 'Basic XXXXXXX'} [2017-05-17 13:57:25，430] 200 OK [2017-05-17 13:57:25，430] --------------------请在文本框输入文字 （上面这个带了时间戳的东西是我的log。每个请求都会自己记下来发了些啥。） 然后按照用户给定的的test_set_id去QC里搜索一下这个test set下的test instance有哪些。 [2017-05-17 13:57:25，430] -------------------- [2017-05-17 13:57:26，303] get http://XXXXX.com:80/qcbin/rest/domains/｛Domain name｝/projects/｛Project name｝/test-instances?query={contains-test-set.id[XXXXXX]}&fields=id，test-id&page-size=2000 [2017-05-17 13:57:26，303] 200 OK [2017-05-17 13:57:26，303] -------------------- 然后每个test instance id去查一下qc里对应的test id，也是测试用例的id，再根据这个id，从qc里查出测试用例的名字。 搜索的时候，这样指定返回值的字段名，以下是搜索某个test set id下的test-instance，并且要求返回值只包含test instance id和 test id test-instances?query={contains-test-set.id[XXX]}&fields=id，test-id&page-size=2000 [2017-05-17 13:57:26，303] -------------------- [2017-05-17 13:57:26，516] get http://XXXXX.com:80/qcbin/rest/domains/XXX/projects/XXX/tests?query={id[XXXXXX]}&fields=name&page-size=2000 [2017-05-17 13:57:26，516] 200 OK [2017-05-17 13:57:26，516] -------------------- 根据上面查出来的test-id再次查询，得到这个test的name字段值 查出了测试用例的名字是用来和我要上传的附件做匹配的，这两个名字对上了，会把某个附件传到这个用例对应的test-instance上。 上传文件部分调用的是这样的一个requests请求： data = { 'filename': (""， attachment_name)， 'override-existing-attachment':(""，"y") } file = { 'file': open(attachmentpath+attachment_name， 'rb') } response = self.session.post(url， files=file，data=data) 后附上一些代码，供参考： 这个类是用来做get请求和post请求的。auto_log装饰器会把发了什么请求打成log。 不像某些QC操作的库里一样满屏的打log import logging as log import requests class RestClient: def __init__(self): self.headers={} self.session = requests.Session() log.basicConfig(level=log.INFO， format='[%(asctime)s] %(message)s') def auto_log(func): def wrapper(*args， **kw): r = func(*args， **kw) log.info("%s %s"， func.func_name， args[1]) for key in kw: log.info("%s = %s"，key， kw[key]) log.info("%s %s"，r.status_code，r.reason) log.info("--------------------") return r return wrapper @auto_log def get(self， url): return self.session.get(url) @auto_log def post(self， url， files=None， data=None，headers=None): if headers is None: headers = self.headers return self.session.post(url， headers=headers，files=files，data=data) 第二个类是用来操作QC的，现在我做了用户登录、搜索entity、添加附件三个功能。后续还会加上更新entity和创建entity等，把参考文档里的common tasks全都实现在这个类里。 class QCSession: def __init__(self， username， password， qc_url): self.api_client=RestClient() auth = base64.b64encode("{}:{}".format(username， password)) self.api_client.session.headers['Authorization'] = "Basic {}".format(auth) self.qc_url = qc_url self.login() def login(self): r = self.api_client.post(self.qc_url.auth， headers=self.api_client.session.headers) assert(r.status_code is 200) def get(self， *args): r = self.api_client.get(self.qc_url.path(*args)) assert (r.status_code is 200 or r.status_code is 201) return r def add_attachment(self， filename， over_ride，*args): data = { 'filename': (""， filename)， 'override-existing-attachment': (""， over_ride) } files = { 'file': open(filename， 'rb') } r = self.api_client.post(self.qc_url.path(*args)，data=data，files=files) assert (r.status_code is 200 or r.status_code is 201) return r def query_entitys(self， entity_name， query_expression， fields=None， page_size="2000"): """ :param entity_name: the entity to query :param query_expression: the query expression :param fields: the files to return in results :param page_size: the result page size， by default is 2000 which is the max value :return: resturn the BeautifulSoup parsed result """ query_url=u"%s?query={%s}&fields=%s&page-size=%s" %(entity_name，query_expression，fields，page_size) r = self.get(query_url) res = BeautifulSoup(r.content， "lxml") return res 还有一个保存和生成QC的各种url地址的类： class QCURL: def __init__(self， hostname， domain， project， port='80'): self.__base = u'http://{}:{}/qcbin/'.format(hostname，port) self.__work = self.__base + u'rest/domains/{}/projects/{}/'.format(domain，project) self.auth = self.__base + u'authentication-point/authenticate' self.logout = self.__base + u'authentication-point/logout/' def path(self， *args): return self.__work + '/'.join([str(arg) for arg in args]) 还有第四个类是用QC Session类来实现我要的业务功能了。具体代码不贴了，里面没什么可以让别人重用的东西。 拿上面三个类可以用了。 给个例子： 登录QC，并查询指定的testset_id下所有的test-instances，并返回其id和test-id 下面所有没赋值的变量都换成自己环境的真实值的字符串行了。 qc_url = QCURL(hostname， domain， project， port) qc_session = QCSession(username， password， qc_url) qc_session.query_entitys('test-instances'， 'contains-test-set.id[%s]' % testset_id， "id，test-id")
