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
if self._control_files._lock_count == 1:
76
# do non-implementation specific cleanup
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
supports_versioned_directories = True
107
def get_format_string(self):
108
"""See WorkingTreeFormat.get_format_string()."""
109
return "Bazaar-NG Working Tree format 3"
111
def get_format_description(self):
112
"""See WorkingTreeFormat.get_format_description()."""
113
return "Working tree format 3"
115
_tree_class = WorkingTree3
117
def __get_matchingbzrdir(self):
118
return bzrdir.BzrDirMetaFormat1()
120
_matchingbzrdir = property(__get_matchingbzrdir)
122
def _open_control_files(self, a_bzrdir):
123
transport = a_bzrdir.get_workingtree_transport(None)
124
return LockableFiles(transport, 'lock', LockDir)
126
def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
127
accelerator_tree=None, hardlink=False):
128
"""See WorkingTreeFormat.initialize().
130
:param revision_id: if supplied, create a working tree at a different
131
revision than the branch is at.
132
:param accelerator_tree: A tree which can be used for retrieving file
133
contents more quickly than the revision tree, i.e. a workingtree.
134
The revision tree will be used for cases where accelerator_tree's
135
content is different.
136
:param hardlink: If true, hard-link files from accelerator_tree,
139
if not isinstance(a_bzrdir.transport, LocalTransport):
140
raise errors.NotLocalUrl(a_bzrdir.transport.base)
141
transport = a_bzrdir.get_workingtree_transport(self)
142
control_files = self._open_control_files(a_bzrdir)
143
control_files.create_lock()
144
control_files.lock_write()
145
transport.put_bytes('format', self.get_format_string(),
146
mode=a_bzrdir._get_file_mode())
147
if from_branch is not None:
150
branch = a_bzrdir.open_branch()
151
if revision_id is None:
152
revision_id = _mod_revision.ensure_null(branch.last_revision())
153
# WorkingTree3 can handle an inventory which has a unique root id.
154
# as of bzr 0.12. However, bzr 0.11 and earlier fail to handle
155
# those trees. And because there isn't a format bump inbetween, we
156
# are maintaining compatibility with older clients.
157
# inv = Inventory(root_id=gen_root_id())
158
inv = self._initial_inventory()
159
wt = self._tree_class(a_bzrdir.root_transport.local_abspath('.'),
165
_control_files=control_files)
168
basis_tree = branch.repository.revision_tree(revision_id)
169
# only set an explicit root id if there is one to set.
170
if basis_tree.inventory.root is not None:
171
wt.set_root_id(basis_tree.get_root_id())
172
if revision_id == _mod_revision.NULL_REVISION:
173
wt.set_parent_trees([])
175
wt.set_parent_trees([(revision_id, basis_tree)])
176
transform.build_tree(basis_tree, wt)
178
# Unlock in this order so that the unlock-triggers-flush in
179
# WorkingTree is given a chance to fire.
180
control_files.unlock()
184
def _initial_inventory(self):
185
return inventory.Inventory()
187
def open(self, a_bzrdir, _found=False):
188
"""Return the WorkingTree object for a_bzrdir
190
_found is a private parameter, do not use it. It is used to indicate
191
if format probing has already been done.
194
# we are being called directly and must probe.
195
raise NotImplementedError
196
if not isinstance(a_bzrdir.transport, LocalTransport):
197
raise errors.NotLocalUrl(a_bzrdir.transport.base)
198
wt = self._open(a_bzrdir, self._open_control_files(a_bzrdir))
201
def _open(self, a_bzrdir, control_files):
202
"""Open the tree itself.
204
:param a_bzrdir: the dir for the tree.
205
:param control_files: the control files for the tree.
207
return self._tree_class(a_bzrdir.root_transport.local_abspath('.'),
211
_control_files=control_files)
214
return self.get_format_string()