class IterationService:
"""
Provides services to interact with Project iteration, handle operaions of list, create and retrieve iteration Resources
"""
def __init__(self, base_url, usrname = None, apikey = None):
self.restclient = RestClient(base_url)
self.username = usrname
self.apikey = apikey
def get(self, projectid, iterationid):
"""
Retrieve a specified Iteration Resource on Flies server
@param projectid: Id of Project Resource
@param iterationid: Id of Iteration Resource
@return: Iteration object
@raise NoSuchProjectException:
"""
res, content = self.restclient.request_get('/seam/resource/restv1/projects/p/%s/iterations/i/%s'%(projectid,iterationid))
if res['status'] == '200' or res['status'] == '304':
server_return = json.loads(content)
if server_return.has_key('status'):
if server_return['status'] == "Retired":
print "Warning: The version %s is retired!"%iterationid
return Iteration(server_return)
elif res['status'] == '404':
raise NoSuchProjectException('Error 404', content)
def create(self, projectid, iteration):
"""
Create a Iteration Resource on Flies Server
@param projectid: Id of Project Resource
@param iteration: Iteration object
@return: Success if status of response is 201
@raise ProjectExistException:
@raise NoSuchProjectException:
@raise UnAuthorizedException:
@raise BadRequestException:
"""
headers = {}
headers['X-Auth-User'] = self.username
headers['X-Auth-Token'] = self.apikey
body = '''{"name":"%s","id":"%s","description":"%s"}'''%(iteration.name, iteration.id, iteration.desc)
res, content = self.restclient.request_put('/seam/resource/restv1/projects/p/%s/iterations/i/%s'%(projectid,iteration.id), args=body, headers=headers)
if res['status'] == '201':
return "Success"
elif res['status'] == '200':
raise ProjectExistException('Status 200', "The version is already exist on server")
elif res['status'] == '404':
raise NoSuchProjectException('Error 404', content)
elif res['status'] == '401':
raise UnAuthorizedException('Error 401', 'This operation is not authorized, please check username and apikey')
elif res['status'] == '405':
raise NotAllowedException('Error 405', 'The requested method is not allowed')
def delete(self):
pass
class ProjectService:
"""
Provides services to interact with Project, handle operaions of list, create and retrieve Project Resources
"""
def __init__(self, base_url, usrname, apikey):
self.restclient = RestClient(base_url)
self.iterations = IterationService(base_url, usrname, apikey)
self.username = usrname
self.apikey = apikey
def list(self):
"""
List the Project Resources on the Flies server
@return: list of Project object
"""
res, content = self.restclient.request_get('/seam/resource/restv1/projects')
if res['status'] == '200':
projects = []
projects_json = json.loads(content)
for p in projects_json:
projects.append(Project(p))
return projects
def get(self, projectid):
"""
Retrieve a specified Project Resource on Flies server
@param projectid: Id of Project Resource
@return: Project object
@raise NoSuchProjectException:
"""
res, content = self.restclient.request_get('/seam/resource/restv1/projects/p/%s'%projectid)
if res['status'] == '200' or res['status'] == '304':
project = Project(json.loads(content))
project.set_iteration(self.iterations)
return project
elif res['status'] == '404':
raise NoSuchProjectException('Error 404', content)
def create(self, project):
"""
Create a Project Resource on Flies Server
@param project: Project object
@return: Success if status of response is 201
@raise ProjectExistException:
@raise NoSuchProjectException:
@raise UnAuthorizedException:
@raise BadRequestException:
"""
headers = {}
headers['X-Auth-User'] = self.username
headers['X-Auth-Token'] = self.apikey
body ='''{"name":"%s","id":"%s","description":"%s","type":"IterationProject"}'''%(project.name,project.id,project.desc)
res, content = self.restclient.request_put('/seam/resource/restv1/projects/p/%s'%project.id, args=body, headers=headers)
if res['status'] == '201':
return "Success"
elif res['status'] == '200':
raise ProjectExistException('Status 200', "The project is already exist on server")
elif res['status'] == '404':
raise NoSuchProjectException('Error 404', content)
elif res['status'] == '401':
raise UnAuthorizedException('Error 401', 'This operation is not authorized, please check username and apikey')
elif res['status'] == '400':
raise BadRequestException('Error 400', content)
def delete(self):
pass
def status(self):
pass