#!/usr/bin/python # -*- coding: utf-8 -*- # # Copyright (C) 2013 Gauvain Pocentek # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . import requests class GitlabConnectionError(Exception): pass class GitlabGetError(Exception): pass class GitlabCreateError(Exception): pass class GitlabUpdateError(Exception): pass class Gitlab(object): def __init__(self, url, private_token): self.url = '%s/api/v3'%url self.private_token = private_token def list(self, objClass, **kwargs): url = objClass.url if kwargs: url = objClass.url % kwargs url = '%s%s?private_token=%s'%(self.url, url, self.private_token) if kwargs: url += "&%s"%("&".join(["%s=%s"%(k,v) for k,v in kwargs.items()])) try: r = requests.get(url) except: raise GitlabConnectionError('Can\'t connect to GitLab server (%s)'%self.url) if r.status_code == 200: cls = objClass if objClass.returnClass: cls = objClass.returnClass return [cls(item) for item in r.json] else: raise GitlabGetError('%d: %s'%(r.status_code, r.text)) def get(self, objClass, id, **kwargs): url = objClass.url if kwargs: url = objClass.url % kwargs url = '%s%s/%d?private_token=%s'%(self.url, url, id, self.private_token) try: r = requests.get(url) except: raise GitlabConnectionError('Can\'t connect to GitLab server (%s)'%self.url) if r.status_code == 200: cls = objClass if objClass.returnClass: cls = objClass.returnClass return cls(r.json) else: raise GitlabGetError('%d: %s'%(r.status_code, r.text)) def delete(self, objClass, id, **kwargs): # FIXME: not working for project members, gitlab bug or not? url = objClass.url if kwargs: url = objClass.url % kwargs url = '%s%s/%d?private_token=%s'%(self.url, url, id, self.private_token) try: r = requests.delete(url) except: raise GitlabConnectionError('Can\'t connect to GitLab server (%s)'%self.url) if r.status_code == 200: return True return False def create(self, objClass, objData, **kwargs): url = objClass.url if kwargs: url = objClass.url % kwargs url = '%s%s?private_token=%s'%(self.url, url, self.private_token) try: r = requests.post(url, objData) except: raise GitlabConnectionError('Can\'t connect to GitLab server (%s)'%self.url) if r.status_code == 201: cls = objClass if objClass.returnClass: cls = objClass.returnClass return cls(r.json) else: raise GitlabCreateError('%d: %s'%(r.status_code, r.text)) def update(self, objClass, id, objData, **kwargs): url = objClass.url if kwargs: url = objClass.url % kwargs url = '%s%s/%d?private_token=%s'%(self.url, url, id, self.private_token) try: r = requests.put(url, objData) except: raise GitlabConnectionError('Can\'t connect to GitLab server (%s)'%self.url) if r.status_code == 200: cls = objClass if objClass.returnClass: cls = objClass.returnClass return cls(r.json) else: raise GitlabUpdateError('%d: %s'%(r.status_code, r.text)) class GitlabObject(object): url = None returnClass = None constructorTypes = None canGet = True canGetList = True canCreate = True canUpdate = True canDelete = True @classmethod def update(cls, gl, id, data, **kwargs): if not cls.canUpdate: raise NotImplementedError if not cls.url: raise NotImplementedError return gl.update(cls, id, data, **kwargs) @classmethod def create(cls, gl, data, **kwargs): if not cls.canCreate: raise NotImplementedError if not cls.url: raise NotImplementedError return gl.create(cls, data, **kwargs) @classmethod def list(cls, gl, **kwargs): if not cls.canGetList: raise NotImplementedError if not cls.url: raise NotImplementedError return gl.list(cls, **kwargs) @classmethod def get(cls, gl, id, **kwargs): if not cls.canGet: raise NotImplementedError if not cls.url: raise NotImplementedError return gl.get(cls, id, **kwargs) @classmethod def delete(cls, gl, id, **kwargs): if not cls.canDelete: raise NotImplementedError if not cls.url: raise NotImplementedError return gl.delete(cls, id, **kwargs) def __init__(self, data): for k, v in data.items(): if self.constructorTypes and k in self.constructorTypes: self.__dict__[k] = self.constructorTypes[k](v) else: self.__dict__[k] = v def __str__(self): return '%s => %s'%(type(self), str(self.__dict__)) class User(GitlabObject): url = '/users' class Project(GitlabObject): url = '/projects' constructorTypes = {'owner': User} canUpdate = False canDelete = False class ProjectMember(GitlabObject): url = '/projects/%(project_id)d/members' returnClass = User class ProjectHook(GitlabObject): url = '/projects/%(project_id)d/hooks' class ProjectBranch(GitlabObject): url = '/projects/%(project_id)d/repository/branches' canDelete = False canUpdate = False canCreate = False class ProjectTag(GitlabObject): url = '/projects/%(project_id)d/repository/tags' canGet = False canDelete = False canUpdate = False canCreate = False class ProjectCommit(GitlabObject): url = '/projects/%(project_id)d/repository/commits' canGet = False canDelete = False canUpdate = False canCreate = False class ProjectMilestone(GitlabObject): url = '/projects/%(project_id)s/milestones' canDelete = False class ProjectMergeRequest(GitlabObject): url = '/projects/%(project_id)d/merge_request' canDelete = False class Issue(GitlabObject): url = '/issues' canGet = False canDelete = False canUpdate = False canCreate = False class ProjectIssue(GitlabObject): url = '/projects/%(project_id)s/issues/' returnClass = Issue canDelete = False class Group(GitlabObject): url = '/groups' class Session(object): def __init__(self): raise NotImplementedError class Snippet(GitlabObject): url = '/projects/%(project_id)d/snippets' class User(GitlabObject): url = '/users' class CurrentUser(GitlabObject): url = '/user' canGetList = False canCreate = False canUpdate = False canDelete = False class CurrentUserKey(GitlabObject): url = '/user/keys' canUpdate = False if __name__ == '__main__': # quick "doc" # # See https://github.com/gitlabhq/gitlabhq/tree/master/doc/api for the # source # register a connection to a gitlab instance, using its URL and a user # private token gl = Gitlab('http://192.168.123.107:8080', 'JVNSESs8EwWRx5yDxM5q') # get a list of projects for p in Project.list(gl): print p.name # get associated issues issues = ProjectIssue.list(gl, project_id=p.id) for issue in issues: print " %d => %s (closed: %d)"%(issue.id, issue.title, issue.closed) # and close them all ProjectIssue.update(gl, issue.id, {'closed': 1}, project_id=p.id)