背景是这样的:
  这个组的测试人员每跑一个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")