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
|
# Copyright (C) 2013 Codethink Limited
#
# 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; version 2 of the License.
#
# 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, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
#
# =*= License: GPL-2 =*=
import cliapp
import morphlib
class GitDirectory(object):
'''Represent a git working tree + .git directory.
This class represents a directory that is the result of a
"git clone". It includes both the .git subdirectory and
the working tree. It is a thin abstraction, meant to make
it easier to do certain git operations.
'''
def __init__(self, dirname):
self.dirname = dirname
def _runcmd(self, argv, **kwargs):
'''Run a command at the root of the git directory.
See cliapp.runcmd for arguments.
Do NOT use this from outside the class. Add more public
methods for specific git operations instead.
'''
return cliapp.runcmd(argv, cwd=self.dirname, **kwargs)
def checkout(self, branch_name): # pragma: no cover
'''Check out a git branch.'''
self._runcmd(['git', 'checkout', branch_name])
def branch(self, new_branch_name, base_ref): # pragma: no cover
'''Create a git branch based on an existing ref.
This does not automatically check out the branch.
base_ref may be None, in which case the current branch is used.
'''
argv = ['git', 'branch', new_branch_name]
if base_ref is not None:
argv.append(base_ref)
self._runcmd(argv)
def update_remotes(self): # pragma: no cover
'''Update remotes.'''
self._runcmd(['git', 'remote', 'update', '--prune'])
def update_submodules(self, app): # pragma: no cover
'''Change .gitmodules URLs, and checkout submodules.'''
morphlib.git.update_submodules(app, self.dirname)
def set_config(self, key, value):
'''Set a git repository configuration variable.
The key must have at least one period in it: foo.bar for example,
not just foo. The part before the first period is interpreted
by git as a section name.
'''
self._runcmd(['git', 'config', key, value])
def get_config(self, key):
'''Return value for a git repository configuration variable.'''
value = self._runcmd(['git', 'config', key])
return value.strip()
def set_remote_fetch_url(self, remote_name, url):
'''Set the fetch URL for a remote.'''
self._runcmd(['git', 'remote', 'set-url', remote_name, url])
def get_remote_fetch_url(self, remote_name):
'''Return the fetch URL for a given remote.'''
output = self._runcmd(['git', 'remote', '-v'])
for line in output.splitlines():
words = line.split()
if (len(words) == 3 and
words[0] == remote_name and
words[2] == '(fetch)'):
return words[1]
return None
def update_remotes(self): # pragma: no cover
'''Run "git remote update --prune".'''
self._runcmd(['git', 'remote', 'update', '--prune'])
def init(dirname):
'''Initialise a new git repository.'''
gd = GitDirectory(dirname)
gd._runcmd(['git', 'init'])
return gd
def clone_from_cached_repo(cached_repo, dirname, ref): # pragma: no cover
'''Clone a CachedRepo into the desired directory.
The given ref is checked out (or git's default branch is checked out
if ref is None).
'''
cached_repo.clone_checkout(ref, dirname)
return GitDirectory(dirname)
|
