FilesExpand file tree

 develop

/

commit.py

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

109 lines (87 loc) · 3.52 KB

 develop

/

commit.py

Copy path

Top

File metadata and controls

• Code
• Blame

109 lines (87 loc) · 3.52 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

# -*- coding: utf-8 -*-

"""

github3.repos.commit

====================

This module contains the RepoCommit class alone

"""

from __future__ import unicode_literals

from . import status

from .comment import RepoComment

from .. import git

from .. import models

from .. import users

class RepoCommit(models.BaseCommit):

"""The :class:`RepoCommit <RepoCommit>` object. This represents a commit as

viewed by a :class:`Repository`. This is different from a Commit object

returned from the git data section.

Two commit instances can be checked like so::

c1 == c2

c1 != c2

And is equivalent to::

c1.sha == c2.sha

c1.sha != c2.sha

"""

def _update_attributes(self, commit):

super(RepoCommit, self)._update_attributes(commit)

#: :class:`User <github3.users.User>` who authored the commit.

self.author = commit.get('author')

if self.author:

self.author = users.User(self.author, self)

#: :class:`User <github3.users.User>` who committed the commit.

self.committer = commit.get('committer')

if self.committer:

self.committer = users.User(self.committer, self)

#: :class:`Commit <github3.git.Commit>`.

self.commit = commit.get('commit')

if self.commit:

self.commit = git.Commit(self.commit, self)

self.sha = commit.get('sha')

#: The number of additions made in the commit.

self.additions = 0

#: The number of deletions made in the commit.

self.deletions = 0

#: Total number of changes in the files.

self.total = 0

if commit.get('stats'):

self.additions = commit['stats'].get('additions')

self.deletions = commit['stats'].get('deletions')

self.total = commit['stats'].get('total')

#: The files that were modified by this commit.

self.files = commit.get('files', [])

self._uniq = self.sha

def _repr(self):

return '<Repository Commit [{0}]>'.format(self.sha[:7])

def diff(self):

"""Retrieve the diff for this commit.

:returns: the diff as a bytes object

:rtype: bytes

"""

resp = self._get(self._api,

headers={'Accept': 'application/vnd.github.diff'})

return resp.content if self._boolean(resp, 200, 404) else b''

def patch(self):

"""Retrieve the patch formatted diff for this commit.

:returns: the patch as a bytes object

:rtype: bytes

"""

resp = self._get(self._api,

headers={'Accept': 'application/vnd.github.patch'})

return resp.content if self._boolean(resp, 200, 404) else b''

def statuses(self):

"""Retrieve the statuses for this commit.

:returns: the statuses for this commit

:rtype: :class:`~github3.repos.status.Status`

"""

url = self._build_url('statuses', base_url=self._api)

return self._iter(-1, url, status.Status)

def comments(self, number=-1, etag=None):

"""Iterate over comments for this commit.

:param int number: (optional), number of comments to return. Default:

-1 returns all comments

:param str etag: (optional), ETag from a previous request to the same

endpoint

:returns: generator of

:class:`RepoComment <github3.repos.comment.RepoComment>`\ s

"""

url = self._build_url('comments', base_url=self._api)

return self._iter(int(number), url, RepoComment, etag=etag)