iframe-proxy | Sunbelt Computer Software

245 lines (161 loc) · 6.55 KB
# -*- coding: utf-8 -*-
github3.git
===========
This module contains all the classes relating to Git Data.
See also: http://developer.github.com/v3/git/
from __future__ import unicode_literals
from json import dumps
from base64 import b64decode
from .models import GitHubCore, BaseCommit
from .decorators import requires_auth
class Blob(GitHubCore):
    """The :class:`Blob <Blob>` object.
    See also: http://developer.github.com/v3/git/blobs/
    def _update_attributes(self, blob):
        self._api = self._get_attribute(blob, 'url')
        #: Raw content of the blob.
        self.content = self._get_attribute(blob, 'content')
        if self.content is not None:
            self.content = self.content.encode()
        #: Encoding of the raw content.
        self.encoding = self._get_attribute(blob, 'encoding')
        #: Decoded content of the blob.
        self.decoded = self.content
        if self.encoding == 'base64':
            self.decoded = b64decode(self.content)
        #: Size of the blob in bytes
        self.size = self._get_attribute(blob, 'size')
        #: SHA1 of the blob
        self.sha = self._get_attribute(blob, 'sha')
    def _repr(self):
        return '<Blob [{0:.10}]>'.format(self.sha)
class GitData(GitHubCore):
    """The :class:`GitData <GitData>` object. This isn't directly returned to
    the user (developer) ever. This is used to prevent duplication of some
    common items among other Git Data objects.
    def _update_attributes(self, data):
        #: SHA of the object
        self.sha = self._get_attribute(data, 'sha')
        self._api = self._get_attribute(data, 'url')
class Commit(BaseCommit):
    """The :class:`Commit <Commit>` object. This represents a commit made in a
    repository.
    See also: http://developer.github.com/v3/git/commits/
    def _update_attributes(self, commit):
        super(Commit, self)._update_attributes(commit)
        #: dict containing at least the name, email and date the commit was
        #: created
        self.author = self._get_attribute(commit, 'author', {})
        # If GH returns nil/None then make sure author is a dict
        self._author_name = self._get_attribute(self.author, 'name')
        #: dict containing similar information to the author attribute
        self.committer = self._get_attribute(commit, 'committer', {})
        # blank the data if GH returns no data
        self._commit_name = self._get_attribute(self.committer, 'name')
        #: :class:`Tree <Tree>` the commit belongs to.
        self.tree = self._class_attribute(commit, 'tree', Tree, self)
    def _repr(self):
        return '<Commit [{0}:{1}]>'.format(self._author_name, self.sha)
class Reference(GitHubCore):
    """The :class:`Reference <Reference>` object. This represents a reference
    created on a repository.
    See also: http://developer.github.com/v3/git/refs/
    def _update_attributes(self, ref):
        self._api = self._get_attribute(ref, 'url')
        #: The reference path, e.g., refs/heads/sc/featureA
        self.ref = self._get_attribute(ref, 'ref')
        #: :class:`GitObject <GitObject>` the reference points to
        self.object = self._class_attribute(ref, 'object', GitObject)
    def _repr(self):
        return '<Reference [{0}]>'.format(self.ref)
    @requires_auth
    def delete(self):
        """Delete this reference.
        :returns: bool
        """
        return self._boolean(self._delete(self._api), 204, 404)
    @requires_auth
    def update(self, sha, force=False):
        """Update this reference.
        :param str sha: (required), sha of the reference
        :param bool force: (optional), force the update or not
        :returns: bool
        """
        data = {'sha': sha, 'force': force}
        json = self._json(self._patch(self._api, data=dumps(data)), 200)
        if json:
            self._update_attributes(json)
            return True
        return False
class GitObject(GitData):
    """The :class:`GitObject <GitObject>` object."""
    def _update_attributes(self, obj):
        super(GitObject, self)._update_attributes(obj)
        #: The type of object.
        self.type = self._get_attribute(obj, 'type')
    def _repr(self):
        return '<Git Object [{0}]>'.format(self.sha)
class Tag(GitData):
    """The :class:`Tag <Tag>` object.
    See also: http://developer.github.com/v3/git/tags/
    def _update_attributes(self, tag):
        super(Tag, self)._update_attributes(tag)
        #: String of the tag
        self.tag = self._get_attribute(tag, 'tag')
        #: Commit message for the tag
        self.message = self._get_attribute(tag, 'message')
        #: dict containing the name and email of the person
        self.tagger = self._get_attribute(tag, 'tagger')
        #: :class:`GitObject <GitObject>` for the tag
        self.object = self._class_attribute(tag, 'object', GitObject)
    def _repr(self):
        return '<Tag [{0}]>'.format(self.tag)
class Tree(GitData):
    """The :class:`Tree <Tree>` object.
    See also: http://developer.github.com/v3/git/trees/
    def _update_attributes(self, tree):
        super(Tree, self)._update_attributes(tree)
        #: list of :class:`Hash <Hash>` objects
        self.tree = self._get_attribute(tree, 'tree', [])
        if self.tree:
            self.tree = [Hash(t) for t in self.tree]
    def _repr(self):
        return '<Tree [{0}]>'.format(self.sha)
    def __eq__(self, other):
        return self.as_dict() == other.as_dict()
    def __ne__(self, other):
        return self.as_dict() != other.as_dict()
    def recurse(self):
        """Recurse into the tree.
        :returns: :class:`Tree <Tree>`
        """
        json = self._json(self._get(self._api, params={'recursive': '1'}),
        return self._instance_or_null(Tree, json)
class Hash(GitHubCore):
    """The :class:`Hash <Hash>` object.
    See also: http://developer.github.com/v3/git/trees/#create-a-tree
    def _update_attributes(self, info):
        #: Path to file
        self.path = self._get_attribute(info, 'path')
        #: File mode
        self.mode = self._get_attribute(info, 'mode')
        #: Type of hash, e.g., blob
        self.type = self._get_attribute(info, 'type')
        #: Size of hash
        self.size = self._get_attribute(info, 'size')
        #: SHA of the hash
        self.sha = self._get_attribute(info, 'sha')
        #: URL of this object in the GitHub API
        self.url = self._get_attribute(info, 'url')
    def _repr(self):
        return '<Hash [{0}]>'.format(self.sha)
Sunbelt Computer Software

PL/B Language Development and Support

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Sunbelt Computer Software

PL/B Language Development and Support

FilesExpand file tree

git.py

Latest commit

History

git.py

File metadata and controls
