~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/workingtree_3.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2011-05-05 03:14:25 UTC
  • mfrom: (5816.5.7 workingtree-3)
  • Revision ID: pqm@pqm.ubuntu.com-20110505031425-f1pyxrpf6wu8jads
(jelmer) Split WorkingTree3 out into a separate file. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2007-2011 Canonical Ltd
 
2
#
 
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.
 
7
#
 
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.
 
12
#
 
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
 
16
 
 
17
"""WorkingTree3 format and implementation.
 
18
 
 
19
"""
 
20
 
 
21
from bzrlib import (
 
22
    bzrdir,
 
23
    errors,
 
24
    inventory,
 
25
    revision as _mod_revision,
 
26
    transform,
 
27
    )
 
28
from bzrlib.decorators import (
 
29
    needs_read_lock,
 
30
    )
 
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 (
 
35
    InventoryWorkingTree,
 
36
    WorkingTreeFormat,
 
37
    )
 
38
 
 
39
class WorkingTree3(InventoryWorkingTree):
 
40
    """This is the Format 3 working tree.
 
41
 
 
42
    This differs from the base WorkingTree by:
 
43
     - having its own file lock
 
44
     - having its own last-revision property.
 
45
 
 
46
    This is new in bzr 0.8
 
47
    """
 
48
 
 
49
    @needs_read_lock
 
50
    def _last_revision(self):
 
51
        """See Mutable.last_revision."""
 
52
        try:
 
53
            return self._transport.get_bytes('last-revision')
 
54
        except errors.NoSuchFile:
 
55
            return _mod_revision.NULL_REVISION
 
56
 
 
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:
 
60
            try:
 
61
                self._transport.delete('last-revision')
 
62
            except errors.NoSuchFile:
 
63
                pass
 
64
            return False
 
65
        else:
 
66
            self._transport.put_bytes('last-revision', revision_id,
 
67
                mode=self.bzrdir._get_file_mode())
 
68
            return True
 
69
 
 
70
    def _get_check_refs(self):
 
71
        """Return the references needed to perform a check of this tree."""
 
72
        return [('trees', self.last_revision())]
 
73
 
 
74
    def unlock(self):
 
75
        # do non-implementation specific cleanup
 
76
        self._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:
 
80
                self.flush()
 
81
            self._write_hashcache_if_dirty()
 
82
        # reverse order of locking.
 
83
        try:
 
84
            return self._control_files.unlock()
 
85
        finally:
 
86
            self.branch.unlock()
 
87
 
 
88
 
 
89
class WorkingTreeFormat3(WorkingTreeFormat):
 
90
    """The second working tree format updated to record a format marker.
 
91
 
 
92
    This format:
 
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
 
97
        - is new in bzr 0.8
 
98
        - uses a LockDir to guard access for writes.
 
99
    """
 
100
 
 
101
    upgrade_recommended = True
 
102
 
 
103
    missing_parent_conflicts = True
 
104
 
 
105
    def get_format_string(self):
 
106
        """See WorkingTreeFormat.get_format_string()."""
 
107
        return "Bazaar-NG Working Tree format 3"
 
108
 
 
109
    def get_format_description(self):
 
110
        """See WorkingTreeFormat.get_format_description()."""
 
111
        return "Working tree format 3"
 
112
 
 
113
    _tree_class = WorkingTree3
 
114
 
 
115
    def __get_matchingbzrdir(self):
 
116
        return bzrdir.BzrDirMetaFormat1()
 
117
 
 
118
    _matchingbzrdir = property(__get_matchingbzrdir)
 
119
 
 
120
    def _open_control_files(self, a_bzrdir):
 
121
        transport = a_bzrdir.get_workingtree_transport(None)
 
122
        return LockableFiles(transport, 'lock', LockDir)
 
123
 
 
124
    def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
 
125
                   accelerator_tree=None, hardlink=False):
 
126
        """See WorkingTreeFormat.initialize().
 
127
 
 
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,
 
135
            where possible.
 
136
        """
 
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:
 
146
            branch = from_branch
 
147
        else:
 
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('.'),
 
158
                         branch,
 
159
                         inv,
 
160
                         _internal=True,
 
161
                         _format=self,
 
162
                         _bzrdir=a_bzrdir,
 
163
                         _control_files=control_files)
 
164
        wt.lock_tree_write()
 
165
        try:
 
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([])
 
172
            else:
 
173
                wt.set_parent_trees([(revision_id, basis_tree)])
 
174
            transform.build_tree(basis_tree, wt)
 
175
        finally:
 
176
            # Unlock in this order so that the unlock-triggers-flush in
 
177
            # WorkingTree is given a chance to fire.
 
178
            control_files.unlock()
 
179
            wt.unlock()
 
180
        return wt
 
181
 
 
182
    def _initial_inventory(self):
 
183
        return inventory.Inventory()
 
184
 
 
185
    def open(self, a_bzrdir, _found=False):
 
186
        """Return the WorkingTree object for a_bzrdir
 
187
 
 
188
        _found is a private parameter, do not use it. It is used to indicate
 
189
               if format probing has already been done.
 
190
        """
 
191
        if not _found:
 
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))
 
197
        return wt
 
198
 
 
199
    def _open(self, a_bzrdir, control_files):
 
200
        """Open the tree itself.
 
201
 
 
202
        :param a_bzrdir: the dir for the tree.
 
203
        :param control_files: the control files for the tree.
 
204
        """
 
205
        return self._tree_class(a_bzrdir.root_transport.local_abspath('.'),
 
206
                                _internal=True,
 
207
                                _format=self,
 
208
                                _bzrdir=a_bzrdir,
 
209
                                _control_files=control_files)
 
210
 
 
211
    def __str__(self):
 
212
        return self.get_format_string()