1
# Copyright (C) 2007-2011 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
"""WorkingTree3 format and implementation.
25
revision as _mod_revision,
28
from bzrlib.decorators import (
31
from bzrlib.lockable_files import LockableFiles
32
from bzrlib.lockdir import LockDir
33
from bzrlib.transport.local import LocalTransport
34
from bzrlib.workingtree import (
39
class WorkingTree3(InventoryWorkingTree):
40
"""This is the Format 3 working tree.
42
This differs from the base WorkingTree by:
43
- having its own file lock
44
- having its own last-revision property.
46
This is new in bzr 0.8
50
def _last_revision(self):
51
"""See Mutable.last_revision."""
53
return self._transport.get_bytes('last-revision')
54
except errors.NoSuchFile:
55
return _mod_revision.NULL_REVISION
57
def _change_last_revision(self, revision_id):
58
"""See WorkingTree._change_last_revision."""
59
if revision_id is None or revision_id == _mod_revision.NULL_REVISION:
61
self._transport.delete('last-revision')
62
except errors.NoSuchFile:
66
self._transport.put_bytes('last-revision', revision_id,
67
mode=self.bzrdir._get_file_mode())
70
def _get_check_refs(self):
71
"""Return the references needed to perform a check of this tree."""
72
return [('trees', self.last_revision())]
75
# do non-implementation specific cleanup
77
if self._control_files._lock_count == 1:
78
# _inventory_is_modified is always False during a read lock.
79
if self._inventory_is_modified:
81
self._write_hashcache_if_dirty()
82
# reverse order of locking.
84
return self._control_files.unlock()
89
class WorkingTreeFormat3(WorkingTreeFormat):
90
"""The second working tree format updated to record a format marker.
93
- exists within a metadir controlling .bzr
94
- includes an explicit version marker for the workingtree control
95
files, separate from the BzrDir format
96
- modifies the hash cache format
98
- uses a LockDir to guard access for writes.
101
upgrade_recommended = True
103
missing_parent_conflicts = True
105
def get_format_string(self):
106
"""See WorkingTreeFormat.get_format_string()."""
107
return "Bazaar-NG Working Tree format 3"
109
def get_format_description(self):
110
"""See WorkingTreeFormat.get_format_description()."""
111
return "Working tree format 3"
113
_tree_class = WorkingTree3
115
def __get_matchingbzrdir(self):
116
return bzrdir.BzrDirMetaFormat1()
118
_matchingbzrdir = property(__get_matchingbzrdir)
120
def _open_control_files(self, a_bzrdir):
121
transport = a_bzrdir.get_workingtree_transport(None)
122
return LockableFiles(transport, 'lock', LockDir)
124
def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
125
accelerator_tree=None, hardlink=False):
126
"""See WorkingTreeFormat.initialize().
128
:param revision_id: if supplied, create a working tree at a different
129
revision than the branch is at.
130
:param accelerator_tree: A tree which can be used for retrieving file
131
contents more quickly than the revision tree, i.e. a workingtree.
132
The revision tree will be used for cases where accelerator_tree's
133
content is different.
134
:param hardlink: If true, hard-link files from accelerator_tree,
137
if not isinstance(a_bzrdir.transport, LocalTransport):
138
raise errors.NotLocalUrl(a_bzrdir.transport.base)
139
transport = a_bzrdir.get_workingtree_transport(self)
140
control_files = self._open_control_files(a_bzrdir)
141
control_files.create_lock()
142
control_files.lock_write()
143
transport.put_bytes('format', self.get_format_string(),
144
mode=a_bzrdir._get_file_mode())
145
if from_branch is not None:
148
branch = a_bzrdir.open_branch()
149
if revision_id is None:
150
revision_id = _mod_revision.ensure_null(branch.last_revision())
151
# WorkingTree3 can handle an inventory which has a unique root id.
152
# as of bzr 0.12. However, bzr 0.11 and earlier fail to handle
153
# those trees. And because there isn't a format bump inbetween, we
154
# are maintaining compatibility with older clients.
155
# inv = Inventory(root_id=gen_root_id())
156
inv = self._initial_inventory()
157
wt = self._tree_class(a_bzrdir.root_transport.local_abspath('.'),
163
_control_files=control_files)
166
basis_tree = branch.repository.revision_tree(revision_id)
167
# only set an explicit root id if there is one to set.
168
if basis_tree.inventory.root is not None:
169
wt.set_root_id(basis_tree.get_root_id())
170
if revision_id == _mod_revision.NULL_REVISION:
171
wt.set_parent_trees([])
173
wt.set_parent_trees([(revision_id, basis_tree)])
174
transform.build_tree(basis_tree, wt)
176
# Unlock in this order so that the unlock-triggers-flush in
177
# WorkingTree is given a chance to fire.
178
control_files.unlock()
182
def _initial_inventory(self):
183
return inventory.Inventory()
185
def open(self, a_bzrdir, _found=False):
186
"""Return the WorkingTree object for a_bzrdir
188
_found is a private parameter, do not use it. It is used to indicate
189
if format probing has already been done.
192
# we are being called directly and must probe.
193
raise NotImplementedError
194
if not isinstance(a_bzrdir.transport, LocalTransport):
195
raise errors.NotLocalUrl(a_bzrdir.transport.base)
196
wt = self._open(a_bzrdir, self._open_control_files(a_bzrdir))
199
def _open(self, a_bzrdir, control_files):
200
"""Open the tree itself.
202
:param a_bzrdir: the dir for the tree.
203
:param control_files: the control files for the tree.
205
return self._tree_class(a_bzrdir.root_transport.local_abspath('.'),
209
_control_files=control_files)
212
return self.get_format_string()