python-bitbucket /

# -*- coding: utf-8 -*-
import cookielib
import urllib2
import base64
import json
from urllib import urlencode
import datetime

class Repository(object):
    name = None
    scm = "hg"
    is_private = False
    def __init__(self, api, username, repository, data=None):
        self.api = api
        self.url = 'repositories/%s/%s/' % (username, repository)
        if data is not None:
	    for i in data:
	        if i not in ['last_updated', 'created_on']:
	            setattr(self, i, data[i])
		    setattr(self, i, datetime.datetime.strptime(data[i], "%Y-%m-%d %H:%M:%S"))

    def __repr__(self):
        return "<Repository: %s>" %

    def get_issues(self):
        if self.has_issues:
	    return self.api.get_issues(self.owner, self.slug)

    def get_changesets(self, limit=15):
        return self.api.get_changesets(self.owner, self.slug, limit)

    def get_changeset(self, changeset):
        return self.api.get_changesets(self.owner, self.slug, changeset)
    def get_file(self, filename, revision="tip"):
        return self.api.get_file(self.owner, self.slug, filename, revision)
    def new_issue(self):
        return self.api.new_issue(self.owner, self.slug)

class BBFile(object):
    # Additional functionality will be added to this class in the future.  For now it is a placeholder class.
    def __init__(self, api, username, repository, rev, data):
        self.url = 'repositories/%s/%s/raw/%s/%s' % (username, repository, rev, data['file'])
        # Python variables "type" and "file" are reserved, and incompatible with the BB API ones.
        # Any suggestions on other names are welcome, but I believe "action" and "filename" suit it well.
        self.action = data['type']
        self.filename = data['file']
        self.api = api
        self._handler = None
    def __repr__(self):
        return "<BBFile: %s>" % self.filename
    def __getattr__(self, name):
        if name == 'handler':
	    if self._handler == None:
	        self._handler = self.api.get_raw(self.url)
	    return self._handler
	raise AttributeError

    def read(self, size=-1):
    def readline(self, size=-1):
        return self.handler.readline(size)

class Changeset(object):
    def __init__(self, api, username, repository, data):
        for i in data:
	    if i not in ['files', 'timestamp']:
	        setattr(self, i, data[i])
	self.timestamp = datetime.datetime.strptime(data['timestamp'], "%Y-%m-%d %H:%M:%S")
	self.files = []
	for f in data['files']:
	    self.files.append(BBFile(api, username, repository, data['node'], f))

    def __repr__(self):
        return "<Changeset: %s>" % self.node

class Issue(object):
    title = ""
    content = ""
    component = None
    milestone = None
    version = None
    responsible = None
    priority = "major"
    status = "new"
    kind = "bug"
    def __init__(self, api, username, repository, data=None):
        self.api = api
        self.responsible = username
        self.url = 'repositories/%s/%s/issues/' % (username, repository)
        if data:
	    self.url = 'repositories/%s/%s/issues/%s/' % (username, repository, data['local_id'])
	    self.title = data['title']
	    self.content = data['content']
	    self.component = data['metadata']['component']
	    self.milestone = data['metadata']['milestone']
	    self.version = data['metadata']['version']
	        self.responsible = data['responsible']['username']
	    except KeyError:
	        self.responsible = None
	    self.priority = data['priority']
	    self.status = data['status']
	    self.kind = data['metadata']['kind']

    def __repr__(self):
        return "<Issue: %s>" % self.title

    def as_dict(self):
        data = {'title':self.title, 'content':self.content, 'priority':self.priority, 'status':self.status, 'kind':self.kind}
        if self.component:
	if self.milestone:
	if self.version:
	return data

    def save(self):
        self.json =, self.as_dict())
        return self.json

class API(object):
    api_url = ''

    def __init__(self, username, password, proxy=None):
        encodedstring = base64.encodestring("%s:%s" % (username, password))[:-1]
        self._auth = "Basic %s" % encodedstring
        self._opener = self._create_opener(proxy)

    def _create_opener(self, proxy=None):
        cj = cookielib.LWPCookieJar()
        cookie_handler = urllib2.HTTPCookieProcessor(cj)
        if proxy:
            proxy_handler = urllib2.ProxyHandler(proxy)
            opener = urllib2.build_opener(cookie_handler, proxy_handler)
            opener = urllib2.build_opener(cookie_handler)
        return opener

    def _raw_request(self, url, data=None):
        query_url = self.api_url + url
        if data:
	  data = urlencode(data)
	    req = urllib2.Request(query_url, data, {"Authorization": self._auth })
	    handler =
	except urllib2.HTTPError, e:
	    print e.headers
	    raise e
	return handler

    def _request(self, url, data=None):
	return json.load(self._raw_request(url, data))

    def post(self, url, data):
        return self._request(url, data)

    def get(self, url):
        return self._request(url, None)
    def get_raw(self, url):
        return self._raw_request(url, None)
    def get_issues(self, username, repository):
        json = self.get('repositories/%s/%s/issues/' % (username, repository))
        issues = []
        for i in json['issues']:
	    issue = Issue(self, username, repository, i)
	return issues
    def new_issue(self, username, repository):
        return Issue(self, username, repository)
    def get_changesets(self, username, repository, limit=15):
        json = self.get('repositories/%s/%s/changesets?limit=%s' % (username, repository, limit))
        changesets = []
        for i in json['changesets']:
	    changesets.append(Changeset(self, username, repository, i))
	return changesets

    def get_changeset(self, username, repository, changeset):
        json = self.get('repositories/%s/%s/changesets/%s' % (username, repository, changeset))
        return Changeset(self, username, repository, json)

    def get_file(self, username, repository, filename, revision="tip"):
        return BBFile(self, username, repository, revision, {'type':'source', 'file':filename})

    def get_repository(self, username, repository):
        json = self.get('repositories/%s/%s/' % (username, repository))
        return Repository(self, username, repository, json)

    def get_repositories(self, username=None):
        repos = []
        if username == None:
	    json = self.get('user/repositories/')
	    for repo in json:
	        repos.append(self.get_repository(repo['owner'], repo['slug']))
	    repo_list = self.get('users/%s/' % username)['repositories']
	    for repo in repo_list:
	        repos.append(self.get_repository(username, repo['slug']))
	return repos