1
# Copyright (C) 2007 Canonical Ltd
2
# Copyright (C) 2010 Jelmer Vernooij
4
# This program is free software; you can redistribute it and/or modify
5
# it under the terms of the GNU General Public License as published by
6
# the Free Software Foundation; either version 2 of the License, or
7
# (at your option) any later version.
9
# This program is distributed in the hope that it will be useful,
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
# GNU General Public License for more details.
14
# You should have received a copy of the GNU General Public License
15
# along with this program; if not, write to the Free Software
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18
"""An adapter between a Git control dir and a Bazaar ControlDir."""
29
from bzrlib.bzrdir import CreateRepository
30
from bzrlib.transport import do_catching_redirections
32
LockWarner = getattr(lockable_files, "_LockWarner", None)
34
from bzrlib.controldir import (
41
class GitLock(object):
42
"""A lock that thunks through to Git."""
45
self.lock_name = "git lock"
47
def lock_write(self, token=None):
59
def validate_token(self, token):
63
raise NotImplementedError(self.break_lock)
65
def dont_leave_in_place(self):
66
raise NotImplementedError(self.dont_leave_in_place)
68
def leave_in_place(self):
69
raise NotImplementedError(self.leave_in_place)
72
class GitLockableFiles(lockable_files.LockableFiles):
73
"""Git specific lockable files abstraction."""
75
def __init__(self, transport, lock):
77
self._transaction = None
78
self._lock_mode = None
79
self._transport = transport
80
if LockWarner is None:
84
self._lock_warner = LockWarner(repr(self))
87
class GitDirConfig(object):
89
def get_default_stack_on(self):
92
def set_default_stack_on(self, value):
93
raise bzr_errors.BzrError("Cannot set configuration")
96
class GitControlDirFormat(ControlDirFormat):
98
_lock_class = lockable_files.TransportLock
100
colocated_branches = True
101
fixed_components = True
103
def __eq__(self, other):
104
return type(self) == type(other)
106
def is_supported(self):
109
def network_name(self):
113
class GitDir(ControlDir):
114
"""An adapter to the '.git' dir used by git."""
116
def is_supported(self):
119
def can_convert_format(self):
122
def break_lock(self):
125
def cloning_metadir(self, stacked=False):
126
return format_registry.make_bzrdir("default")
128
def checkout_metadir(self, stacked=False):
129
return format_registry.make_bzrdir("default")
131
def _get_selected_ref(self, branch):
132
if branch is None and getattr(self, "_get_selected_branch", False):
133
branch = self._get_selected_branch()
134
if branch is not None:
135
from bzrlib.plugins.git.refs import branch_name_to_ref
136
return branch_name_to_ref(branch, None)
137
segment_parameters = getattr(
138
self.user_transport, "get_segment_parameters", lambda: {})()
139
ref = segment_parameters.get("ref")
141
ref = urlutils.unescape(ref)
144
def get_config(self):
145
return GitDirConfig()
147
def _available_backup_name(self, base):
148
return osutils.available_backup_name(base, self.root_transport.has)
150
def sprout(self, url, revision_id=None, force_new_repo=False,
151
recurse='down', possible_transports=None,
152
accelerator_tree=None, hardlink=False, stacked=False,
153
source_branch=None, create_tree_if_local=True):
154
from bzrlib.repository import InterRepository
155
from bzrlib.transport.local import LocalTransport
156
from bzrlib.transport import get_transport
157
target_transport = get_transport(url, possible_transports)
158
target_transport.ensure_base()
159
cloning_format = self.cloning_metadir()
160
# Create/update the result branch
161
result = cloning_format.initialize_on_transport(target_transport)
162
source_branch = self.open_branch()
163
source_repository = self.find_repository()
165
result_repo = result.find_repository()
166
except bzr_errors.NoRepositoryPresent:
167
result_repo = result.create_repository()
168
target_is_empty = True
170
target_is_empty = None # Unknown
172
raise bzr_errors.IncompatibleRepositories(source_repository, result_repo)
173
interrepo = InterRepository.get(source_repository, result_repo)
175
if revision_id is not None:
176
determine_wants = interrepo.get_determine_wants_revids(
177
[revision_id], include_tags=True)
179
determine_wants = interrepo.determine_wants_all
180
interrepo.fetch_objects(determine_wants=determine_wants,
181
mapping=source_branch.mapping)
182
result_branch = source_branch.sprout(result,
183
revision_id=revision_id, repository=result_repo)
184
if (create_tree_if_local
185
and isinstance(target_transport, LocalTransport)
186
and (result_repo is None or result_repo.make_working_trees())):
187
wt = result.create_workingtree(accelerator_tree=accelerator_tree,
188
hardlink=hardlink, from_branch=result_branch)
191
if wt.path2id('') is None:
193
wt.set_root_id(self.open_workingtree.get_root_id())
194
except bzr_errors.NoWorkingTree:
200
def clone_on_transport(self, transport, revision_id=None,
201
force_new_repo=False, preserve_stacking=False, stacked_on=None,
202
create_prefix=False, use_existing_dir=True, no_tree=False):
203
"""See ControlDir.clone_on_transport."""
204
from bzrlib.repository import InterRepository
205
from bzrlib.plugins.git.mapping import default_mapping
207
format = BareLocalGitControlDirFormat()
209
format = LocalGitControlDirFormat()
210
(target_repo, target_controldir, stacking, repo_policy) = format.initialize_on_transport_ex(transport, use_existing_dir=use_existing_dir, create_prefix=create_prefix, force_new_repo=force_new_repo)
211
target_git_repo = target_repo._git
212
source_repo = self.open_repository()
213
source_git_repo = source_repo._git
214
interrepo = InterRepository.get(source_repo, target_repo)
215
if revision_id is not None:
216
determine_wants = interrepo.get_determine_wants_revids([revision_id], include_tags=True)
218
determine_wants = interrepo.determine_wants_all
219
(pack_hint, _, refs) = interrepo.fetch_objects(determine_wants,
220
mapping=default_mapping)
221
for name, val in refs.iteritems():
222
target_git_repo.refs[name] = val
223
lockfiles = GitLockableFiles(transport, GitLock())
224
return self.__class__(transport, lockfiles, target_git_repo, format)
226
def find_repository(self):
227
"""Find the repository that should be used.
229
This does not require a branch as we use it to find the repo for
230
new branches as well as to hook existing branches up to their
233
return self.open_repository()
236
class LocalGitControlDirFormat(GitControlDirFormat):
237
"""The .git directory control format."""
242
def _known_formats(self):
243
return set([LocalGitControlDirFormat()])
246
def repository_format(self):
247
from bzrlib.plugins.git.repository import GitRepositoryFormat
248
return GitRepositoryFormat()
250
def get_branch_format(self):
251
from bzrlib.plugins.git.branch import GitBranchFormat
252
return GitBranchFormat()
254
def open(self, transport, _found=None):
255
"""Open this directory.
258
from bzrlib.plugins.git.transportgit import TransportRepo
259
gitrepo = TransportRepo(transport, self.bare)
260
lockfiles = GitLockableFiles(transport, GitLock())
261
return LocalGitDir(transport, lockfiles, gitrepo, self)
263
def get_format_description(self):
264
return "Local Git Repository"
266
def initialize_on_transport(self, transport):
267
from bzrlib.plugins.git.transportgit import TransportRepo
268
TransportRepo.init(transport, bare=self.bare)
269
return self.open(transport)
271
def initialize_on_transport_ex(self, transport, use_existing_dir=False,
272
create_prefix=False, force_new_repo=False, stacked_on=None,
273
stack_on_pwd=None, repo_format_name=None, make_working_trees=None,
274
shared_repo=False, vfs_only=False):
275
def make_directory(transport):
278
def redirected(transport, e, redirection_notice):
279
trace.note(redirection_notice)
280
return transport._redirected_to(e.source, e.target)
282
transport = do_catching_redirections(make_directory, transport,
284
except bzr_errors.FileExists:
285
if not use_existing_dir:
287
except bzr_errors.NoSuchFile:
288
if not create_prefix:
290
transport.create_prefix()
291
controldir = self.initialize_on_transport(transport)
292
repository = controldir.open_repository()
293
repository.lock_write()
294
return (repository, controldir, False, CreateRepository(controldir))
296
def is_supported(self):
300
class BareLocalGitControlDirFormat(LocalGitControlDirFormat):
303
supports_workingtrees = False
305
def get_format_description(self):
306
return "Local Git Repository (bare)"
309
class LocalGitDir(GitDir):
310
"""An adapter to the '.git' dir used by git."""
312
def _get_gitrepository_class(self):
313
from bzrlib.plugins.git.repository import LocalGitRepository
314
return LocalGitRepository
317
return "<%s at %r>" % (
318
self.__class__.__name__, self.root_transport.base)
320
_gitrepository_class = property(_get_gitrepository_class)
323
def user_transport(self):
324
return self.root_transport
327
def control_transport(self):
328
return self.transport
330
def __init__(self, transport, lockfiles, gitrepo, format):
331
self._format = format
332
self.root_transport = transport
333
self._mode_check_done = False
336
self.transport = transport
338
self.transport = transport.clone('.git')
339
self._lockfiles = lockfiles
340
self._mode_check_done = None
342
def is_control_filename(self, filename):
343
return (filename == '.git' or filename.startswith('.git/'))
345
def _get_symref(self, ref):
346
from dulwich.repo import SYMREF
347
refcontents = self._git.refs.read_ref(ref)
348
if refcontents is None: # no such ref
350
if refcontents.startswith(SYMREF):
351
return refcontents[len(SYMREF):].rstrip("\n")
354
def set_branch_reference(self, name, target):
355
ref = self._get_selected_ref(name)
358
if not getattr(target, "ref", None):
359
raise bzr_errors.BzrError("Can only set symrefs to Git refs")
360
self._git.refs.set_symbolic_ref(ref, target.ref)
362
def get_branch_reference(self, name=None):
363
ref = self._get_selected_ref(name)
366
target_ref = self._get_symref(ref)
367
if target_ref is not None:
368
return urlutils.join_segment_parameters(
369
self.user_url.rstrip("/"), {"ref": urllib.quote(target_ref, '')})
372
def find_branch_format(self, name=None):
373
from bzrlib.plugins.git.branch import (
375
GitSymrefBranchFormat,
377
ref = self._get_selected_ref(name)
380
if self._get_symref(ref) is not None:
381
return GitSymrefBranchFormat()
383
return GitBranchFormat()
385
def get_branch_transport(self, branch_format, name=None):
386
if branch_format is None:
387
return self.transport
388
if isinstance(branch_format, LocalGitControlDirFormat):
389
return self.transport
390
raise bzr_errors.IncompatibleFormat(branch_format, self._format)
392
def get_repository_transport(self, format):
394
return self.transport
395
if isinstance(format, LocalGitControlDirFormat):
396
return self.transport
397
raise bzr_errors.IncompatibleFormat(format, self._format)
399
def get_workingtree_transport(self, format):
401
return self.transport
402
if isinstance(format, LocalGitControlDirFormat):
403
return self.transport
404
raise bzr_errors.IncompatibleFormat(format, self._format)
406
def open_branch(self, name=None, unsupported=False, ignore_fallbacks=None):
407
"""'create' a branch for this dir."""
408
repo = self.open_repository()
409
from bzrlib.plugins.git.branch import LocalGitBranch
410
ref = self._get_selected_ref(name)
413
ref, sha = self._git.refs._follow(ref)
414
if not ref in self._git.refs:
415
raise bzr_errors.NotBranchError(self.root_transport.base,
417
return LocalGitBranch(self, repo, ref, self._lockfiles)
419
def destroy_branch(self, name=None):
420
refname = self._get_selected_ref(name)
422
refname = "refs/heads/master"
424
del self._git.refs[refname]
426
raise bzr_errors.NotBranchError(self.root_transport.base,
429
def destroy_repository(self):
430
raise bzr_errors.UnsupportedOperation(self.destroy_repository, self)
432
def destroy_workingtree(self):
433
raise bzr_errors.UnsupportedOperation(self.destroy_workingtree, self)
435
def needs_format_conversion(self, format=None):
436
return not isinstance(self._format, format.__class__)
438
def list_branches(self):
440
for name in self._git.refs.keys():
441
if name.startswith("refs/heads/"):
442
ret.append(self.open_branch(name=name))
445
def open_repository(self):
446
"""'open' a repository for this dir."""
447
return self._gitrepository_class(self, self._lockfiles)
449
def open_workingtree(self, recommend_upgrade=True):
450
if not self._git.bare:
451
from dulwich.errors import NoIndexPresent
452
repo = self.open_repository()
454
index = repo._git.open_index()
455
except NoIndexPresent:
458
from bzrlib.plugins.git.workingtree import GitWorkingTree
460
branch = self.open_branch()
461
except bzr_errors.NotBranchError:
464
return GitWorkingTree(self, repo, branch, index)
465
loc = urlutils.unescape_for_display(self.root_transport.base, 'ascii')
466
raise bzr_errors.NoWorkingTree(loc)
468
def create_repository(self, shared=False):
469
from bzrlib.plugins.git.repository import GitRepositoryFormat
471
raise bzr_errors.IncompatibleFormat(GitRepositoryFormat(), self._format)
472
return self.open_repository()
474
def create_branch(self, name=None, repository=None,
475
append_revisions_only=None):
476
refname = self._get_selected_ref(name)
477
from dulwich.protocol import ZERO_SHA
478
# FIXME: This is a bit awkward. Perhaps we should have a
479
# a separate method for changing the default branch?
481
refname = "refs/heads/master"
486
if refname in self._git.refs:
487
raise bzr_errors.AlreadyBranchError(self.base)
488
self._git.refs[refname] = ZERO_SHA
490
self._git.refs.set_symbolic_ref("HEAD", refname)
491
branch = self.open_branch(name)
492
if append_revisions_only:
493
branch.set_append_revisions_only(append_revisions_only)
496
def backup_bzrdir(self):
498
self.root_transport.copy_tree(".git", ".git.backup")
499
return (self.root_transport.abspath(".git"),
500
self.root_transport.abspath(".git.backup"))
502
raise bzr_errors.BzrError("Unable to backup bare repositories")
504
def create_workingtree(self, revision_id=None, from_branch=None,
505
accelerator_tree=None, hardlink=False):
507
raise bzr_errors.UnsupportedOperation(self.create_workingtree, self)
508
from dulwich.index import write_index
509
from dulwich.pack import SHA1Writer
510
f = open(self.transport.local_abspath("index"), 'w+')
516
return self.open_workingtree()
518
def _find_or_create_repository(self, force_new_repo=None):
519
return self.create_repository(shared=False)
521
def _find_creation_modes(self):
522
"""Determine the appropriate modes for files and directories.
524
They're always set to be consistent with the base directory,
525
assuming that this transport allows setting modes.
527
# TODO: Do we need or want an option (maybe a config setting) to turn
528
# this off or override it for particular locations? -- mbp 20080512
529
if self._mode_check_done:
531
self._mode_check_done = True
533
st = self.transport.stat('.')
534
except bzr_errors.TransportNotPossible:
535
self._dir_mode = None
536
self._file_mode = None
538
# Check the directory mode, but also make sure the created
539
# directories and files are read-write for this user. This is
540
# mostly a workaround for filesystems which lie about being able to
541
# write to a directory (cygwin & win32)
542
if (st.st_mode & 07777 == 00000):
543
# FTP allows stat but does not return dir/file modes
544
self._dir_mode = None
545
self._file_mode = None
547
self._dir_mode = (st.st_mode & 07777) | 00700
548
# Remove the sticky and execute bits for files
549
self._file_mode = self._dir_mode & ~07111
551
def _get_file_mode(self):
552
"""Return Unix mode for newly created files, or None.
554
if not self._mode_check_done:
555
self._find_creation_modes()
556
return self._file_mode
558
def _get_dir_mode(self):
559
"""Return Unix mode for newly created directories, or None.
561
if not self._mode_check_done:
562
self._find_creation_modes()
563
return self._dir_mode