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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
# vim: set fileencoding=utf-8 :
#
# (C) 2006,2007,2008 Guido Guenther <agx@sigxcpu.org>
"""provides some git repository related helpers"""
import subprocess
import os.path
from command_wrappers import (GitAdd, GitRm, GitCheckoutBranch, GitInit, copy_from)
import dateutil.parser
import calendar
class GitRepositoryError(Exception):
"""Exception thrown by GitRepository"""
pass
class GitRepository(object):
"""Represents a git repository at path"""
def __init__(self, path):
try:
os.stat(os.path.join(path,'.git'))
except:
raise GitRepositoryError
self.path = os.path.abspath(path)
def __check_path(self):
if os.getcwd() != self.path:
raise GitRepositoryError
def __git_getoutput(self, command, args=[]):
"""exec a git command and return the output"""
output = []
popen = subprocess.Popen(['git', command] + args, stdout=subprocess.PIPE)
while popen.poll() == None:
output += popen.stdout.readlines()
ret = popen.poll()
output += popen.stdout.readlines()
return output, ret
def has_branch(self, branch):
"""check if the repository has branch 'branch'"""
self.__check_path()
for line in self.__git_getoutput('branch', [ '--no-color' ])[0]:
if line.split(' ', 1)[1].strip() == branch:
return True
return False
def has_treeish(self, treeish):
"""check if the repository has the treeish object treeish"""
self.__check_path()
out, ret = self.__git_getoutput('ls-tree', [ treeish ])
return [ True, False ][ret != 0]
def has_tag(self, tag):
"""check if the repository has the given tag"""
self.__check_path()
out, ret = self.__git_getoutput('tag', [ '-l', tag ])
return [ False, True ][len(out)]
def get_branch(self):
"""on what branch is the current working copy"""
self.__check_path()
for line in self.__git_getoutput('branch', [ '--no-color' ])[0]:
if line.startswith('*'):
return line.split(' ', 1)[1].strip()
def set_branch(self, branch):
"""switch to branch 'branch'"""
self.__check_path()
if self.get_branch() != branch:
GitCheckoutBranch(branch)()
def is_clean(self):
"""does the repository contain any uncommitted modifications"""
self.__check_path()
clean_msg = 'nothing to commit'
out = self.__git_getoutput('status')[0]
ret = False
for line in out:
if line.startswith('#'):
continue
if line.startswith(clean_msg):
ret = True
break
return (ret, "".join(out))
def is_empty(self):
"""returns True if repo is empty (doesn't have any commits)"""
# an empty repo has no branches:
if self.get_branch():
return False
else:
return True
def index_files(self):
"""List files in the index"""
out, ret = self.__git_getoutput('ls-files', ['-z'])
if ret:
raise GitRepositoryError, "Error listing files %d" % ret
if out:
return [ file for file in out[0].split('\0') if file ]
else:
return []
def commits(self, start, end, paths, options):
"""get commits from start to end touching pathds"""
commits, ret = self.__git_getoutput('log',
['--pretty=format:%H'] + options +
['%s..%s' % (start, end), '--', paths])
if ret:
raise GitRepositoryError, "Error getting commits %s..%s%s" % (start, end, ["", " on %s" % paths][len(paths) > 0] )
return [ commit.strip() for commit in commits[::-1] ]
def show(self, id):
"""git-show id"""
commit, ret = self.__git_getoutput('show', [ "--pretty=medium", id ])
if ret:
raise GitRepositoryError, "can't get %s" % id
for line in commit:
yield line
def find_tag(self, branch):
"find the closest tag to a branch's head"
tag, ret = self.__git_getoutput('describe', [ "--abbrev=0", branch ])
if ret:
raise GitRepositoryError, "can't find tag for %s" % branch
return tag[0].strip()
def rev_parse(self, name):
"find the SHA1"
sha, ret = self.__git_getoutput('rev-parse', [ "--verify", name])
if ret:
raise GitRepositoryError, "can't find SHA1 for %s" % name
return sha[0].strip()
def write_tree(self):
"""write out the current index, return the SHA1"""
tree, ret = self.__git_getoutput('write-tree')
if ret:
raise GitRepositoryError, "can't write out current index"
return tree[0].strip()
def replace_tree(self, src_dir, filters, verbose=False):
"""
make the current wc match what's in src_dir
@return: True if wc was modified
@rtype: boolean
"""
old = set(self.index_files())
new = set(copy_from(src_dir, filters))
GitAdd()(['-f', '.'])
files = [ obj for obj in old - new if not os.path.isdir(obj)]
if files:
GitRm(verbose=verbose)(files)
return not self.is_clean()[0]
def get_config(self, name):
"""Gets the config value associated with name"""
self.__check_path()
value, ret = self.__git_getoutput('config', [ name ])
if ret: raise KeyError
return value[0][:-1] # first line with \n ending removed
def get_author_info(self):
try:
name = self.get_config("user.email")
except KeyError:
name = os.getenv("USER")
try:
email = self.get_config("user.email")
except KeyError:
email = os.getenv("EMAIL")
email = os.getenv("GIT_AUTHOR_EMAIL", email)
name = os.getenv("GIT_AUTHOR_NAME", name)
return (name, email)
def create_repo(path):
"""create a repository at path"""
abspath = os.path.abspath(path)
pwd = os.path.abspath(os.curdir)
try:
os.makedirs(abspath)
os.chdir(abspath)
GitInit()()
return GitRepository(abspath)
except OSError, err:
raise GitRepositoryError, "Cannot create Git repository at %s: %s " % (path, err[1])
finally:
os.chdir(pwd)
return None
def build_tag(format, version):
"""Generate a tag from a given format and a version"""
return format % dict(version=sanitize_version(version))
def sanitize_version(version):
"""sanitize a version so git accepts it as a tag"""
if ':' in version: # strip of any epochs
version = version.split(':', 1)[1]
return version.replace('~', '.')
def rfc822_date_to_git(rfc822_date):
"""Parse a date in RFC822 format, and convert to a 'seconds tz' string.
>>> rfc822_date_to_git('Thu, 1 Jan 1970 00:00:01 +0000')
'1 +0000'
>>> rfc822_date_to_git('Thu, 20 Mar 2008 01:12:57 -0700')
'1206000777 -0700'
>>> rfc822_date_to_git('Sat, 5 Apr 2008 17:01:32 +0200')
'1207407692 +0200'
"""
d = dateutil.parser.parse(rfc822_date)
seconds = calendar.timegm(d.utctimetuple())
tz = d.strftime("%z")
return '%d %s' % (seconds, tz)
def _test():
import doctest
doctest.testmod()
if __name__ == '__main__':
_test()
# vim:et:ts=4:sw=4:et:sts=4:ai:set list listchars=tab\:»·,trail\:·:
|
