85 lines
2.0 KiB
Python
85 lines
2.0 KiB
Python
#
|
|
# TestRail API binding for Python 2.x (API v2, available since
|
|
# TestRail 3.0)
|
|
#
|
|
# Learn more:
|
|
#
|
|
# http://docs.gurock.com/testrail-api2/start
|
|
# http://docs.gurock.com/testrail-api2/accessing
|
|
#
|
|
# Copyright Gurock Software GmbH. See license.md for details.
|
|
#
|
|
|
|
import urllib2, json, base64
|
|
|
|
class APIClient:
|
|
def __init__(self, base_url):
|
|
self.user = ''
|
|
self.password = ''
|
|
if not base_url.endswith('/'):
|
|
base_url += '/'
|
|
self.__url = base_url + 'index.php?/api/v2/'
|
|
|
|
#
|
|
# Send Get
|
|
#
|
|
# Issues a GET request (read) against the API and returns the result
|
|
# (as Python dict).
|
|
#
|
|
# Arguments:0
|
|
#
|
|
# uri The API method to call including parameters
|
|
# (e.g. get_case/1)
|
|
#
|
|
def send_get(self, uri):
|
|
return self.__send_request('GET', uri, None)
|
|
|
|
#
|
|
# Send POST
|
|
#
|
|
# Issues a POST request (write) against the API and returns the result
|
|
# (as Python dict).
|
|
#
|
|
# Arguments:
|
|
#
|
|
# uri The API method to call including parameters
|
|
# (e.g. add_case/1)
|
|
# data The data to submit as part of the request (as
|
|
# Python dict, strings must be UTF-8 encoded)
|
|
#
|
|
def send_post(self, uri, data):
|
|
return self.__send_request('POST', uri, data)
|
|
|
|
def __send_request(self, method, uri, data):
|
|
url = self.__url + uri
|
|
request = urllib2.Request(url)
|
|
if (method == 'POST'):
|
|
request.add_data(json.dumps(data))
|
|
auth = base64.b64encode('%s:%s' % (self.user, self.password))
|
|
request.add_header('Authorization', 'Basic %s' % auth)
|
|
request.add_header('Content-Type', 'application/json')
|
|
|
|
e = None
|
|
try:
|
|
response = urllib2.urlopen(request).read()
|
|
except urllib2.HTTPError as e:
|
|
response = e.read()
|
|
|
|
if response:
|
|
result = json.loads(response)
|
|
else:
|
|
result = {}
|
|
|
|
if e != None:
|
|
if result and 'error' in result:
|
|
error = '"' + result['error'] + '"'
|
|
else:
|
|
error = 'No additional error message received'
|
|
raise APIError('TestRail API returned HTTP %s (%s)' %
|
|
(e.code, error))
|
|
|
|
return result
|
|
|
|
class APIError(Exception):
|
|
pass
|