~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/workingtree.py

  • Committer: John Arbash Meinel
  • Date: 2011-09-26 12:12:40 UTC
  • mto: This revision was merged to the branch mainline in revision 6170.
  • Revision ID: john@arbash-meinel.com-20110926121240-vdlz94tgi2i6py0f
Jelmer caught that getsignal() only takes one parameter.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006 Canonical Ltd
 
1
# Copyright (C) 2005-2011 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
"""WorkingTree object and friends.
18
18
 
19
19
A WorkingTree represents the editable working copy of a branch.
20
 
Operations which represent the WorkingTree are also done here, 
21
 
such as renaming or adding files.  The WorkingTree has an inventory 
22
 
which is updated by these operations.  A commit produces a 
 
20
Operations which represent the WorkingTree are also done here,
 
21
such as renaming or adding files.  The WorkingTree has an inventory
 
22
which is updated by these operations.  A commit produces a
23
23
new revision based on the workingtree and its inventory.
24
24
 
25
25
At the moment every WorkingTree has its own branch.  Remote
29
29
WorkingTree.open(dir).
30
30
"""
31
31
 
32
 
# TODO: Give the workingtree sole responsibility for the working inventory;
33
 
# remove the variable and references to it from the branch.  This may require
34
 
# updating the commit code so as to update the inventory within the working
35
 
# copy, and making sure there's only one WorkingTree for any directory on disk.
36
 
# At the moment they may alias the inventory and have old copies of it in
37
 
# memory.  (Now done? -- mbp 20060309)
38
32
 
39
33
from cStringIO import StringIO
40
34
import os
 
35
import sys
41
36
 
42
37
from bzrlib.lazy_import import lazy_import
43
38
lazy_import(globals(), """
44
39
from bisect import bisect_left
45
40
import collections
46
 
from copy import deepcopy
47
41
import errno
48
42
import itertools
49
43
import operator
50
44
import stat
51
 
from time import time
52
 
import warnings
 
45
import re
53
46
 
54
 
import bzrlib
55
47
from bzrlib import (
 
48
    branch,
56
49
    bzrdir,
57
50
    conflicts as _mod_conflicts,
58
 
    dirstate,
 
51
    controldir,
59
52
    errors,
 
53
    filters as _mod_filters,
60
54
    generate_ids,
61
55
    globbing,
62
 
    hashcache,
 
56
    graph as _mod_graph,
63
57
    ignores,
 
58
    inventory,
64
59
    merge,
65
 
    osutils,
 
60
    revision as _mod_revision,
66
61
    revisiontree,
67
 
    textui,
 
62
    rio as _mod_rio,
68
63
    transform,
69
 
    urlutils,
 
64
    transport,
 
65
    ui,
 
66
    views,
70
67
    xml5,
71
 
    xml6,
 
68
    xml7,
72
69
    )
73
 
import bzrlib.branch
74
 
from bzrlib.transport import get_transport
75
 
import bzrlib.ui
76
 
from bzrlib.workingtree_4 import WorkingTreeFormat4
77
70
""")
78
71
 
79
72
from bzrlib import symbol_versioning
80
73
from bzrlib.decorators import needs_read_lock, needs_write_lock
81
 
from bzrlib.inventory import InventoryEntry, Inventory, ROOT_ID
82
 
from bzrlib.lockable_files import LockableFiles, TransportLock
83
 
from bzrlib.lockdir import LockDir
 
74
from bzrlib.i18n import gettext
 
75
from bzrlib.lock import LogicalLockResult
84
76
import bzrlib.mutabletree
85
77
from bzrlib.mutabletree import needs_tree_write_lock
 
78
from bzrlib import osutils
86
79
from bzrlib.osutils import (
87
 
    compact_date,
88
80
    file_kind,
89
81
    isdir,
90
82
    normpath,
91
83
    pathjoin,
92
 
    rand_chars,
93
84
    realpath,
94
85
    safe_unicode,
95
86
    splitpath,
96
87
    supports_executable,
97
88
    )
98
89
from bzrlib.trace import mutter, note
99
 
from bzrlib.transport.local import LocalTransport
100
 
from bzrlib.progress import DummyProgress, ProgressPhase
101
 
from bzrlib.revision import NULL_REVISION, CURRENT_REVISION
102
 
from bzrlib.rio import RioReader, rio_file, Stanza
103
 
from bzrlib.symbol_versioning import (deprecated_passed,
104
 
        deprecated_method,
105
 
        deprecated_function,
106
 
        DEPRECATED_PARAMETER,
107
 
        zero_eight,
108
 
        zero_eleven,
109
 
        zero_thirteen,
110
 
        )
 
90
from bzrlib.revision import CURRENT_REVISION
 
91
from bzrlib.symbol_versioning import (
 
92
    deprecated_passed,
 
93
    DEPRECATED_PARAMETER,
 
94
    )
111
95
 
112
96
 
113
97
MERGE_MODIFIED_HEADER_1 = "BZR merge-modified list format 1"
 
98
# TODO: Modifying the conflict objects or their type is currently nearly
 
99
# impossible as there is no clear relationship between the working tree format
 
100
# and the conflict list file format.
114
101
CONFLICT_HEADER_1 = "BZR conflict list format 1"
115
102
 
116
 
 
117
 
@deprecated_function(zero_thirteen)
118
 
def gen_file_id(name):
119
 
    """Return new file id for the basename 'name'.
120
 
 
121
 
    Use bzrlib.generate_ids.gen_file_id() instead
122
 
    """
123
 
    return generate_ids.gen_file_id(name)
124
 
 
125
 
 
126
 
@deprecated_function(zero_thirteen)
127
 
def gen_root_id():
128
 
    """Return a new tree-root file id.
129
 
 
130
 
    This has been deprecated in favor of bzrlib.generate_ids.gen_root_id()
131
 
    """
132
 
    return generate_ids.gen_root_id()
 
103
ERROR_PATH_NOT_FOUND = 3    # WindowsError errno code, equivalent to ENOENT
133
104
 
134
105
 
135
106
class TreeEntry(object):
136
107
    """An entry that implements the minimum interface used by commands.
137
108
 
138
 
    This needs further inspection, it may be better to have 
 
109
    This needs further inspection, it may be better to have
139
110
    InventoryEntries without ids - though that seems wrong. For now,
140
111
    this is a parallel hierarchy to InventoryEntry, and needs to become
141
112
    one of several things: decorates to that hierarchy, children of, or
144
115
    no InventoryEntry available - i.e. for unversioned objects.
145
116
    Perhaps they should be UnversionedEntry et al. ? - RBC 20051003
146
117
    """
147
 
 
 
118
 
148
119
    def __eq__(self, other):
149
120
        # yes, this us ugly, TODO: best practice __eq__ style.
150
121
        return (isinstance(other, TreeEntry)
151
122
                and other.__class__ == self.__class__)
152
 
 
 
123
 
153
124
    def kind_character(self):
154
125
        return "???"
155
126
 
187
158
        return ''
188
159
 
189
160
 
190
 
class WorkingTree(bzrlib.mutabletree.MutableTree):
 
161
class WorkingTree(bzrlib.mutabletree.MutableTree,
 
162
    controldir.ControlComponent):
191
163
    """Working copy tree.
192
164
 
193
 
    The inventory is held in the `Branch` working-inventory, and the
194
 
    files are in a directory on disk.
195
 
 
196
 
    It is possible for a `WorkingTree` to have a filename which is
197
 
    not listed in the Inventory and vice versa.
 
165
    :ivar basedir: The root of the tree on disk. This is a unicode path object
 
166
        (as opposed to a URL).
198
167
    """
199
168
 
 
169
    # override this to set the strategy for storing views
 
170
    def _make_views(self):
 
171
        return views.DisabledViews(self)
 
172
 
200
173
    def __init__(self, basedir='.',
201
174
                 branch=DEPRECATED_PARAMETER,
202
 
                 _inventory=None,
203
175
                 _control_files=None,
204
176
                 _internal=False,
205
177
                 _format=None,
206
178
                 _bzrdir=None):
207
 
        """Construct a WorkingTree for basedir.
 
179
        """Construct a WorkingTree instance. This is not a public API.
208
180
 
209
 
        If the branch is not supplied, it is opened automatically.
210
 
        If the branch is supplied, it must be the branch for this basedir.
211
 
        (branch.base is not cross checked, because for remote branches that
212
 
        would be meaningless).
 
181
        :param branch: A branch to override probing for the branch.
213
182
        """
214
183
        self._format = _format
215
184
        self.bzrdir = _bzrdir
216
185
        if not _internal:
217
 
            # not created via open etc.
218
 
            warnings.warn("WorkingTree() is deprecated as of bzr version 0.8. "
219
 
                 "Please use bzrdir.open_workingtree or WorkingTree.open().",
220
 
                 DeprecationWarning,
221
 
                 stacklevel=2)
222
 
            wt = WorkingTree.open(basedir)
223
 
            self._branch = wt.branch
224
 
            self.basedir = wt.basedir
225
 
            self._control_files = wt._control_files
226
 
            self._hashcache = wt._hashcache
227
 
            self._set_inventory(wt._inventory, dirty=False)
228
 
            self._format = wt._format
229
 
            self.bzrdir = wt.bzrdir
230
 
        assert isinstance(basedir, basestring), \
231
 
            "base directory %r is not a string" % basedir
 
186
            raise errors.BzrError("Please use bzrdir.open_workingtree or "
 
187
                "WorkingTree.open() to obtain a WorkingTree.")
232
188
        basedir = safe_unicode(basedir)
233
189
        mutter("opening working tree %r", basedir)
234
190
        if deprecated_passed(branch):
235
 
            if not _internal:
236
 
                warnings.warn("WorkingTree(..., branch=XXX) is deprecated"
237
 
                     " as of bzr 0.8. Please use bzrdir.open_workingtree() or"
238
 
                     " WorkingTree.open().",
239
 
                     DeprecationWarning,
240
 
                     stacklevel=2
241
 
                     )
242
191
            self._branch = branch
243
192
        else:
244
193
            self._branch = self.bzrdir.open_branch()
245
194
        self.basedir = realpath(basedir)
246
 
        # if branch is at our basedir and is a format 6 or less
247
 
        if isinstance(self._format, WorkingTreeFormat2):
248
 
            # share control object
249
 
            self._control_files = self.branch.control_files
250
 
        else:
251
 
            # assume all other formats have their own control files.
252
 
            assert isinstance(_control_files, LockableFiles), \
253
 
                    "_control_files must be a LockableFiles, not %r" \
254
 
                    % _control_files
255
 
            self._control_files = _control_files
256
 
        # update the whole cache up front and write to disk if anything changed;
257
 
        # in the future we might want to do this more selectively
258
 
        # two possible ways offer themselves : in self._unlock, write the cache
259
 
        # if needed, or, when the cache sees a change, append it to the hash
260
 
        # cache file, and have the parser take the most recent entry for a
261
 
        # given path only.
262
 
        wt_trans = self.bzrdir.get_workingtree_transport(None)
263
 
        cache_filename = wt_trans.local_abspath('stat-cache')
264
 
        self._hashcache = hashcache.HashCache(basedir, cache_filename,
265
 
                                              self._control_files._file_mode)
266
 
        hc = self._hashcache
267
 
        hc.read()
268
 
        # is this scan needed ? it makes things kinda slow.
269
 
        #hc.scan()
270
 
 
271
 
        if hc.needs_write:
272
 
            mutter("write hc")
273
 
            hc.write()
274
 
 
275
 
        if _inventory is None:
276
 
            self._inventory_is_modified = False
277
 
            self.read_working_inventory()
278
 
        else:
279
 
            # the caller of __init__ has provided an inventory,
280
 
            # we assume they know what they are doing - as its only
281
 
            # the Format factory and creation methods that are
282
 
            # permitted to do this.
283
 
            self._set_inventory(_inventory, dirty=False)
 
195
        self._control_files = _control_files
 
196
        self._transport = self._control_files._transport
 
197
        self._rules_searcher = None
 
198
        self.views = self._make_views()
 
199
 
 
200
    @property
 
201
    def user_transport(self):
 
202
        return self.bzrdir.user_transport
 
203
 
 
204
    @property
 
205
    def control_transport(self):
 
206
        return self._transport
 
207
 
 
208
    def is_control_filename(self, filename):
 
209
        """True if filename is the name of a control file in this tree.
 
210
 
 
211
        :param filename: A filename within the tree. This is a relative path
 
212
            from the root of this tree.
 
213
 
 
214
        This is true IF and ONLY IF the filename is part of the meta data
 
215
        that bzr controls in this tree. I.E. a random .bzr directory placed
 
216
        on disk will not be a control file for this tree.
 
217
        """
 
218
        return self.bzrdir.is_control_filename(filename)
284
219
 
285
220
    branch = property(
286
221
        fget=lambda self: self._branch,
290
225
            the working tree has been constructed from.
291
226
            """)
292
227
 
 
228
    def has_versioned_directories(self):
 
229
        """See `Tree.has_versioned_directories`."""
 
230
        return self._format.supports_versioned_directories
 
231
 
293
232
    def break_lock(self):
294
233
        """Break a lock if one is present from another instance.
295
234
 
301
240
        self._control_files.break_lock()
302
241
        self.branch.break_lock()
303
242
 
304
 
    def _set_inventory(self, inv, dirty):
305
 
        """Set the internal cached inventory.
306
 
 
307
 
        :param inv: The inventory to set.
308
 
        :param dirty: A boolean indicating whether the inventory is the same
309
 
            logical inventory as whats on disk. If True the inventory is not
310
 
            the same and should be written to disk or data will be lost, if
311
 
            False then the inventory is the same as that on disk and any
312
 
            serialisation would be unneeded overhead.
313
 
        """
314
 
        assert inv.root is not None
315
 
        self._inventory = inv
316
 
        self._inventory_is_modified = dirty
 
243
    def requires_rich_root(self):
 
244
        return self._format.requires_rich_root
 
245
 
 
246
    def supports_tree_reference(self):
 
247
        return False
 
248
 
 
249
    def supports_content_filtering(self):
 
250
        return self._format.supports_content_filtering()
 
251
 
 
252
    def supports_views(self):
 
253
        return self.views.supports_views()
317
254
 
318
255
    @staticmethod
319
256
    def open(path=None, _unsupported=False):
321
258
 
322
259
        """
323
260
        if path is None:
324
 
            path = os.path.getcwdu()
 
261
            path = osutils.getcwd()
325
262
        control = bzrdir.BzrDir.open(path, _unsupported)
326
263
        return control.open_workingtree(_unsupported)
327
 
        
 
264
 
328
265
    @staticmethod
329
266
    def open_containing(path=None):
330
267
        """Open an existing working tree which has its root about path.
331
 
        
 
268
 
332
269
        This probes for a working tree at path and searches upwards from there.
333
270
 
334
271
        Basically we keep looking up until we find the control directory or
341
278
        if path is None:
342
279
            path = osutils.getcwd()
343
280
        control, relpath = bzrdir.BzrDir.open_containing(path)
344
 
 
345
281
        return control.open_workingtree(), relpath
346
282
 
347
283
    @staticmethod
 
284
    def open_containing_paths(file_list, default_directory=None,
 
285
                              canonicalize=True, apply_view=True):
 
286
        """Open the WorkingTree that contains a set of paths.
 
287
 
 
288
        Fail if the paths given are not all in a single tree.
 
289
 
 
290
        This is used for the many command-line interfaces that take a list of
 
291
        any number of files and that require they all be in the same tree.
 
292
        """
 
293
        if default_directory is None:
 
294
            default_directory = u'.'
 
295
        # recommended replacement for builtins.internal_tree_files
 
296
        if file_list is None or len(file_list) == 0:
 
297
            tree = WorkingTree.open_containing(default_directory)[0]
 
298
            # XXX: doesn't really belong here, and seems to have the strange
 
299
            # side effect of making it return a bunch of files, not the whole
 
300
            # tree -- mbp 20100716
 
301
            if tree.supports_views() and apply_view:
 
302
                view_files = tree.views.lookup_view()
 
303
                if view_files:
 
304
                    file_list = view_files
 
305
                    view_str = views.view_display_str(view_files)
 
306
                    note(gettext("Ignoring files outside view. View is %s") % view_str)
 
307
            return tree, file_list
 
308
        if default_directory == u'.':
 
309
            seed = file_list[0]
 
310
        else:
 
311
            seed = default_directory
 
312
            file_list = [osutils.pathjoin(default_directory, f)
 
313
                         for f in file_list]
 
314
        tree = WorkingTree.open_containing(seed)[0]
 
315
        return tree, tree.safe_relpath_files(file_list, canonicalize,
 
316
                                             apply_view=apply_view)
 
317
 
 
318
    def safe_relpath_files(self, file_list, canonicalize=True, apply_view=True):
 
319
        """Convert file_list into a list of relpaths in tree.
 
320
 
 
321
        :param self: A tree to operate on.
 
322
        :param file_list: A list of user provided paths or None.
 
323
        :param apply_view: if True and a view is set, apply it or check that
 
324
            specified files are within it
 
325
        :return: A list of relative paths.
 
326
        :raises errors.PathNotChild: When a provided path is in a different self
 
327
            than self.
 
328
        """
 
329
        if file_list is None:
 
330
            return None
 
331
        if self.supports_views() and apply_view:
 
332
            view_files = self.views.lookup_view()
 
333
        else:
 
334
            view_files = []
 
335
        new_list = []
 
336
        # self.relpath exists as a "thunk" to osutils, but canonical_relpath
 
337
        # doesn't - fix that up here before we enter the loop.
 
338
        if canonicalize:
 
339
            fixer = lambda p: osutils.canonical_relpath(self.basedir, p)
 
340
        else:
 
341
            fixer = self.relpath
 
342
        for filename in file_list:
 
343
            relpath = fixer(osutils.dereference_path(filename))
 
344
            if view_files and not osutils.is_inside_any(view_files, relpath):
 
345
                raise errors.FileOutsideView(filename, view_files)
 
346
            new_list.append(relpath)
 
347
        return new_list
 
348
 
 
349
    @staticmethod
348
350
    def open_downlevel(path=None):
349
351
        """Open an unsupported working tree.
350
352
 
352
354
        """
353
355
        return WorkingTree.open(path, _unsupported=True)
354
356
 
355
 
    def __iter__(self):
356
 
        """Iterate through file_ids for this tree.
 
357
    @staticmethod
 
358
    def find_trees(location):
 
359
        def list_current(transport):
 
360
            return [d for d in transport.list_dir('') if d != '.bzr']
 
361
        def evaluate(bzrdir):
 
362
            try:
 
363
                tree = bzrdir.open_workingtree()
 
364
            except errors.NoWorkingTree:
 
365
                return True, None
 
366
            else:
 
367
                return True, tree
 
368
        t = transport.get_transport(location)
 
369
        iterator = bzrdir.BzrDir.find_bzrdirs(t, evaluate=evaluate,
 
370
                                              list_current=list_current)
 
371
        return [tr for tr in iterator if tr is not None]
357
372
 
358
 
        file_ids are in a WorkingTree if they are in the working inventory
359
 
        and the working file exists.
360
 
        """
361
 
        inv = self._inventory
362
 
        for path, ie in inv.iter_entries():
363
 
            if osutils.lexists(self.abspath(path)):
364
 
                yield ie.file_id
 
373
    def all_file_ids(self):
 
374
        """See Tree.iter_all_file_ids"""
 
375
        raise NotImplementedError(self.all_file_ids)
365
376
 
366
377
    def __repr__(self):
367
378
        return "<%s of %s>" % (self.__class__.__name__,
369
380
 
370
381
    def abspath(self, filename):
371
382
        return pathjoin(self.basedir, filename)
372
 
    
 
383
 
373
384
    def basis_tree(self):
374
385
        """Return RevisionTree for the current last revision.
375
 
        
 
386
 
376
387
        If the left most parent is a ghost then the returned tree will be an
377
 
        empty tree - one obtained by calling repository.revision_tree(None).
 
388
        empty tree - one obtained by calling
 
389
        repository.revision_tree(NULL_REVISION).
378
390
        """
379
391
        try:
380
392
            revision_id = self.get_parent_ids()[0]
382
394
            # no parents, return an empty revision tree.
383
395
            # in the future this should return the tree for
384
396
            # 'empty:' - the implicit root empty tree.
385
 
            return self.branch.repository.revision_tree(None)
 
397
            return self.branch.repository.revision_tree(
 
398
                       _mod_revision.NULL_REVISION)
386
399
        try:
387
400
            return self.revision_tree(revision_id)
388
401
        except errors.NoSuchRevision:
392
405
        # at this point ?
393
406
        try:
394
407
            return self.branch.repository.revision_tree(revision_id)
395
 
        except errors.RevisionNotPresent:
 
408
        except (errors.RevisionNotPresent, errors.NoSuchRevision):
396
409
            # the basis tree *may* be a ghost or a low level error may have
397
 
            # occured. If the revision is present, its a problem, if its not
 
410
            # occurred. If the revision is present, its a problem, if its not
398
411
            # its a ghost.
399
412
            if self.branch.repository.has_revision(revision_id):
400
413
                raise
401
414
            # the basis tree is a ghost so return an empty tree.
402
 
            return self.branch.repository.revision_tree(None)
403
 
 
404
 
    @staticmethod
405
 
    @deprecated_method(zero_eight)
406
 
    def create(branch, directory):
407
 
        """Create a workingtree for branch at directory.
408
 
 
409
 
        If existing_directory already exists it must have a .bzr directory.
410
 
        If it does not exist, it will be created.
411
 
 
412
 
        This returns a new WorkingTree object for the new checkout.
413
 
 
414
 
        TODO FIXME RBC 20060124 when we have checkout formats in place this
415
 
        should accept an optional revisionid to checkout [and reject this if
416
 
        checking out into the same dir as a pre-checkout-aware branch format.]
417
 
 
418
 
        XXX: When BzrDir is present, these should be created through that 
419
 
        interface instead.
420
 
        """
421
 
        warnings.warn('delete WorkingTree.create', stacklevel=3)
422
 
        transport = get_transport(directory)
423
 
        if branch.bzrdir.root_transport.base == transport.base:
424
 
            # same dir 
425
 
            return branch.bzrdir.create_workingtree()
426
 
        # different directory, 
427
 
        # create a branch reference
428
 
        # and now a working tree.
429
 
        raise NotImplementedError
430
 
 
431
 
    @staticmethod
432
 
    @deprecated_method(zero_eight)
433
 
    def create_standalone(directory):
434
 
        """Create a checkout and a branch and a repo at directory.
435
 
 
436
 
        Directory must exist and be empty.
437
 
 
438
 
        please use BzrDir.create_standalone_workingtree
439
 
        """
440
 
        return bzrdir.BzrDir.create_standalone_workingtree(directory)
 
415
            return self.branch.repository.revision_tree(
 
416
                       _mod_revision.NULL_REVISION)
 
417
 
 
418
    def _cleanup(self):
 
419
        self._flush_ignore_list_cache()
441
420
 
442
421
    def relpath(self, path):
443
422
        """Return the local path portion from a given path.
444
 
        
445
 
        The path may be absolute or relative. If its a relative path it is 
 
423
 
 
424
        The path may be absolute or relative. If its a relative path it is
446
425
        interpreted relative to the python current working directory.
447
426
        """
448
427
        return osutils.relpath(self.basedir, path)
450
429
    def has_filename(self, filename):
451
430
        return osutils.lexists(self.abspath(filename))
452
431
 
453
 
    def get_file(self, file_id):
454
 
        return self.get_file_byname(self.id2path(file_id))
455
 
 
456
 
    def get_file_text(self, file_id):
457
 
        return self.get_file(file_id).read()
458
 
 
459
 
    def get_file_byname(self, filename):
460
 
        return file(self.abspath(filename), 'rb')
461
 
 
462
 
    @needs_read_lock
463
 
    def annotate_iter(self, file_id):
464
 
        """See Tree.annotate_iter
465
 
 
466
 
        This implementation will use the basis tree implementation if possible.
467
 
        Lines not in the basis are attributed to CURRENT_REVISION
468
 
 
469
 
        If there are pending merges, lines added by those merges will be
470
 
        incorrectly attributed to CURRENT_REVISION (but after committing, the
471
 
        attribution will be correct).
472
 
        """
473
 
        basis = self.basis_tree()
474
 
        changes = self._iter_changes(basis, True, [file_id]).next()
475
 
        changed_content, kind = changes[2], changes[6]
476
 
        if not changed_content:
477
 
            return basis.annotate_iter(file_id)
478
 
        if kind[1] is None:
479
 
            return None
480
 
        import annotate
481
 
        if kind[0] != 'file':
482
 
            old_lines = []
 
432
    def get_file(self, file_id, path=None, filtered=True):
 
433
        return self.get_file_with_stat(file_id, path, filtered=filtered)[0]
 
434
 
 
435
    def get_file_with_stat(self, file_id, path=None, filtered=True,
 
436
                           _fstat=osutils.fstat):
 
437
        """See Tree.get_file_with_stat."""
 
438
        if path is None:
 
439
            path = self.id2path(file_id)
 
440
        file_obj = self.get_file_byname(path, filtered=False)
 
441
        stat_value = _fstat(file_obj.fileno())
 
442
        if filtered and self.supports_content_filtering():
 
443
            filters = self._content_filter_stack(path)
 
444
            file_obj = _mod_filters.filtered_input_file(file_obj, filters)
 
445
        return (file_obj, stat_value)
 
446
 
 
447
    def get_file_text(self, file_id, path=None, filtered=True):
 
448
        my_file = self.get_file(file_id, path=path, filtered=filtered)
 
449
        try:
 
450
            return my_file.read()
 
451
        finally:
 
452
            my_file.close()
 
453
 
 
454
    def get_file_byname(self, filename, filtered=True):
 
455
        path = self.abspath(filename)
 
456
        f = file(path, 'rb')
 
457
        if filtered and self.supports_content_filtering():
 
458
            filters = self._content_filter_stack(filename)
 
459
            return _mod_filters.filtered_input_file(f, filters)
483
460
        else:
484
 
            old_lines = list(basis.annotate_iter(file_id))
485
 
        old = [old_lines]
486
 
        for tree in self.branch.repository.revision_trees(
487
 
            self.get_parent_ids()[1:]):
488
 
            if file_id not in tree:
489
 
                continue
490
 
            old.append(list(tree.annotate_iter(file_id)))
491
 
        return annotate.reannotate(old, self.get_file(file_id).readlines(),
492
 
                                   CURRENT_REVISION)
 
461
            return f
 
462
 
 
463
    def get_file_lines(self, file_id, path=None, filtered=True):
 
464
        """See Tree.get_file_lines()"""
 
465
        file = self.get_file(file_id, path, filtered=filtered)
 
466
        try:
 
467
            return file.readlines()
 
468
        finally:
 
469
            file.close()
493
470
 
494
471
    def get_parent_ids(self):
495
472
        """See Tree.get_parent_ids.
496
 
        
 
473
 
497
474
        This implementation reads the pending merges list and last_revision
498
475
        value and uses that to decide what the parents list should be.
499
476
        """
500
 
        last_rev = self._last_revision()
501
 
        if last_rev is None:
 
477
        last_rev = _mod_revision.ensure_null(self._last_revision())
 
478
        if _mod_revision.NULL_REVISION == last_rev:
502
479
            parents = []
503
480
        else:
504
481
            parents = [last_rev]
505
482
        try:
506
 
            merges_file = self._control_files.get('pending-merges')
 
483
            merges_bytes = self._transport.get_bytes('pending-merges')
507
484
        except errors.NoSuchFile:
508
485
            pass
509
486
        else:
510
 
            for l in merges_file.readlines():
511
 
                revision_id = osutils.safe_revision_id(l.rstrip('\n'))
 
487
            for l in osutils.split_lines(merges_bytes):
 
488
                revision_id = l.rstrip('\n')
512
489
                parents.append(revision_id)
513
490
        return parents
514
491
 
515
 
    @needs_read_lock
516
492
    def get_root_id(self):
517
493
        """Return the id of this trees root"""
518
 
        return self._inventory.root.file_id
519
 
        
520
 
    def _get_store_filename(self, file_id):
521
 
        ## XXX: badly named; this is not in the store at all
522
 
        return self.abspath(self.id2path(file_id))
 
494
        raise NotImplementedError(self.get_root_id)
523
495
 
524
496
    @needs_read_lock
525
 
    def clone(self, to_bzrdir, revision_id=None, basis=None):
 
497
    def clone(self, to_bzrdir, revision_id=None):
526
498
        """Duplicate this working tree into to_bzr, including all state.
527
 
        
 
499
 
528
500
        Specifically modified files are kept as modified, but
529
501
        ignored and unknown files are discarded.
530
502
 
531
503
        If you want to make a new line of development, see bzrdir.sprout()
532
504
 
533
505
        revision
534
 
            If not None, the cloned tree will have its last revision set to 
535
 
            revision, and and difference between the source trees last revision
 
506
            If not None, the cloned tree will have its last revision set to
 
507
            revision, and difference between the source trees last revision
536
508
            and this one merged in.
537
 
 
538
 
        basis
539
 
            If not None, a closer copy of a tree which may have some files in
540
 
            common, and which file content should be preferentially copied from.
541
509
        """
542
510
        # assumes the target bzr dir format is compatible.
543
 
        result = self._format.initialize(to_bzrdir)
 
511
        result = to_bzrdir.create_workingtree()
544
512
        self.copy_content_into(result, revision_id)
545
513
        return result
546
514
 
559
527
    def id2abspath(self, file_id):
560
528
        return self.abspath(self.id2path(file_id))
561
529
 
562
 
    def has_id(self, file_id):
563
 
        # files that have been deleted are excluded
564
 
        inv = self.inventory
565
 
        if not inv.has_id(file_id):
566
 
            return False
567
 
        path = inv.id2path(file_id)
568
 
        return osutils.lexists(self.abspath(path))
569
 
 
570
 
    def has_or_had_id(self, file_id):
571
 
        if file_id == self.inventory.root.file_id:
572
 
            return True
573
 
        return self.inventory.has_id(file_id)
574
 
 
575
 
    __contains__ = has_id
 
530
    def _check_for_tree_references(self, iterator):
 
531
        """See if directories have become tree-references."""
 
532
        blocked_parent_ids = set()
 
533
        for path, ie in iterator:
 
534
            if ie.parent_id in blocked_parent_ids:
 
535
                # This entry was pruned because one of its parents became a
 
536
                # TreeReference. If this is a directory, mark it as blocked.
 
537
                if ie.kind == 'directory':
 
538
                    blocked_parent_ids.add(ie.file_id)
 
539
                continue
 
540
            if ie.kind == 'directory' and self._directory_is_tree_reference(path):
 
541
                # This InventoryDirectory needs to be a TreeReference
 
542
                ie = inventory.TreeReference(ie.file_id, ie.name, ie.parent_id)
 
543
                blocked_parent_ids.add(ie.file_id)
 
544
            yield path, ie
 
545
 
 
546
    def iter_entries_by_dir(self, specific_file_ids=None, yield_parents=False):
 
547
        """See Tree.iter_entries_by_dir()"""
 
548
        # The only trick here is that if we supports_tree_reference then we
 
549
        # need to detect if a directory becomes a tree-reference.
 
550
        iterator = super(WorkingTree, self).iter_entries_by_dir(
 
551
                specific_file_ids=specific_file_ids,
 
552
                yield_parents=yield_parents)
 
553
        if not self.supports_tree_reference():
 
554
            return iterator
 
555
        else:
 
556
            return self._check_for_tree_references(iterator)
576
557
 
577
558
    def get_file_size(self, file_id):
578
 
        return os.path.getsize(self.id2abspath(file_id))
579
 
 
580
 
    @needs_read_lock
581
 
    def get_file_sha1(self, file_id, path=None, stat_value=None):
582
 
        if not path:
583
 
            path = self._inventory.id2path(file_id)
584
 
        return self._hashcache.get_sha1(path, stat_value)
585
 
 
586
 
    def get_file_mtime(self, file_id, path=None):
587
 
        if not path:
588
 
            path = self._inventory.id2path(file_id)
589
 
        return os.lstat(self.abspath(path)).st_mtime
590
 
 
591
 
    if not supports_executable():
592
 
        def is_executable(self, file_id, path=None):
593
 
            return self._inventory[file_id].executable
594
 
    else:
595
 
        def is_executable(self, file_id, path=None):
596
 
            if not path:
597
 
                path = self.id2path(file_id)
598
 
            mode = os.lstat(self.abspath(path)).st_mode
599
 
            return bool(stat.S_ISREG(mode) and stat.S_IEXEC & mode)
600
 
 
601
 
    @needs_write_lock
602
 
    def _add(self, files, ids, kinds):
603
 
        """See MutableTree._add."""
604
 
        # TODO: Re-adding a file that is removed in the working copy
605
 
        # should probably put it back with the previous ID.
606
 
        # the read and write working inventory should not occur in this 
607
 
        # function - they should be part of lock_write and unlock.
608
 
        inv = self.read_working_inventory()
609
 
        for f, file_id, kind in zip(files, ids, kinds):
610
 
            assert kind is not None
611
 
            if file_id is None:
612
 
                inv.add_path(f, kind=kind)
 
559
        """See Tree.get_file_size"""
 
560
        # XXX: this returns the on-disk size; it should probably return the
 
561
        # canonical size
 
562
        try:
 
563
            return os.path.getsize(self.id2abspath(file_id))
 
564
        except OSError, e:
 
565
            if e.errno != errno.ENOENT:
 
566
                raise
613
567
            else:
614
 
                inv.add_path(f, kind=kind, file_id=file_id)
615
 
        self._write_inventory(inv)
 
568
                return None
616
569
 
617
570
    @needs_tree_write_lock
618
571
    def _gather_kinds(self, files, kinds):
634
587
        and setting the list to its value plus revision_id.
635
588
 
636
589
        :param revision_id: The revision id to add to the parent list. It may
637
 
        be a ghost revision as long as its not the first parent to be added,
638
 
        or the allow_leftmost_as_ghost parameter is set True.
 
590
            be a ghost revision as long as its not the first parent to be
 
591
            added, or the allow_leftmost_as_ghost parameter is set True.
639
592
        :param allow_leftmost_as_ghost: Allow the first parent to be a ghost.
640
593
        """
641
594
        parents = self.get_parent_ids() + [revision_id]
678
631
        if updated:
679
632
            self.set_parent_ids(parents, allow_leftmost_as_ghost=True)
680
633
 
681
 
    @deprecated_method(zero_eleven)
682
 
    @needs_read_lock
683
 
    def pending_merges(self):
684
 
        """Return a list of pending merges.
685
 
 
686
 
        These are revisions that have been merged into the working
687
 
        directory but not yet committed.
688
 
 
689
 
        As of 0.11 this is deprecated. Please see WorkingTree.get_parent_ids()
690
 
        instead - which is available on all tree objects.
691
 
        """
692
 
        return self.get_parent_ids()[1:]
 
634
    def path_content_summary(self, path, _lstat=os.lstat,
 
635
        _mapper=osutils.file_kind_from_stat_mode):
 
636
        """See Tree.path_content_summary."""
 
637
        abspath = self.abspath(path)
 
638
        try:
 
639
            stat_result = _lstat(abspath)
 
640
        except OSError, e:
 
641
            if getattr(e, 'errno', None) == errno.ENOENT:
 
642
                # no file.
 
643
                return ('missing', None, None, None)
 
644
            # propagate other errors
 
645
            raise
 
646
        kind = _mapper(stat_result.st_mode)
 
647
        if kind == 'file':
 
648
            return self._file_content_summary(path, stat_result)
 
649
        elif kind == 'directory':
 
650
            # perhaps it looks like a plain directory, but it's really a
 
651
            # reference.
 
652
            if self._directory_is_tree_reference(path):
 
653
                kind = 'tree-reference'
 
654
            return kind, None, None, None
 
655
        elif kind == 'symlink':
 
656
            target = osutils.readlink(abspath)
 
657
            return ('symlink', None, None, target)
 
658
        else:
 
659
            return (kind, None, None, None)
 
660
 
 
661
    def _file_content_summary(self, path, stat_result):
 
662
        size = stat_result.st_size
 
663
        executable = self._is_executable_from_path_and_stat(path, stat_result)
 
664
        # try for a stat cache lookup
 
665
        return ('file', size, executable, self._sha_from_stat(
 
666
            path, stat_result))
693
667
 
694
668
    def _check_parents_for_ghosts(self, revision_ids, allow_leftmost_as_ghost):
695
669
        """Common ghost checking functionality from set_parent_*.
705
679
 
706
680
    def _set_merges_from_parent_ids(self, parent_ids):
707
681
        merges = parent_ids[1:]
708
 
        self._control_files.put_utf8('pending-merges', '\n'.join(merges))
 
682
        self._transport.put_bytes('pending-merges', '\n'.join(merges),
 
683
            mode=self.bzrdir._get_file_mode())
 
684
 
 
685
    def _filter_parent_ids_by_ancestry(self, revision_ids):
 
686
        """Check that all merged revisions are proper 'heads'.
 
687
 
 
688
        This will always return the first revision_id, and any merged revisions
 
689
        which are
 
690
        """
 
691
        if len(revision_ids) == 0:
 
692
            return revision_ids
 
693
        graph = self.branch.repository.get_graph()
 
694
        heads = graph.heads(revision_ids)
 
695
        new_revision_ids = revision_ids[:1]
 
696
        for revision_id in revision_ids[1:]:
 
697
            if revision_id in heads and revision_id not in new_revision_ids:
 
698
                new_revision_ids.append(revision_id)
 
699
        if new_revision_ids != revision_ids:
 
700
            mutter('requested to set revision_ids = %s,'
 
701
                         ' but filtered to %s', revision_ids, new_revision_ids)
 
702
        return new_revision_ids
709
703
 
710
704
    @needs_tree_write_lock
711
705
    def set_parent_ids(self, revision_ids, allow_leftmost_as_ghost=False):
712
706
        """Set the parent ids to revision_ids.
713
 
        
 
707
 
714
708
        See also set_parent_trees. This api will try to retrieve the tree data
715
709
        for each element of revision_ids from the trees repository. If you have
716
710
        tree data already available, it is more efficient to use
720
714
        :param revision_ids: The revision_ids to set as the parent ids of this
721
715
            working tree. Any of these may be ghosts.
722
716
        """
723
 
        revision_ids = [osutils.safe_revision_id(r) for r in revision_ids]
724
717
        self._check_parents_for_ghosts(revision_ids,
725
718
            allow_leftmost_as_ghost=allow_leftmost_as_ghost)
 
719
        for revision_id in revision_ids:
 
720
            _mod_revision.check_not_reserved_id(revision_id)
 
721
 
 
722
        revision_ids = self._filter_parent_ids_by_ancestry(revision_ids)
726
723
 
727
724
        if len(revision_ids) > 0:
728
725
            self.set_last_revision(revision_ids[0])
729
726
        else:
730
 
            self.set_last_revision(None)
 
727
            self.set_last_revision(_mod_revision.NULL_REVISION)
731
728
 
732
729
        self._set_merges_from_parent_ids(revision_ids)
733
730
 
734
731
    @needs_tree_write_lock
735
 
    def set_parent_trees(self, parents_list, allow_leftmost_as_ghost=False):
736
 
        """See MutableTree.set_parent_trees."""
737
 
        parent_ids = [osutils.safe_revision_id(rev) for (rev, tree) in parents_list]
738
 
 
739
 
        self._check_parents_for_ghosts(parent_ids,
740
 
            allow_leftmost_as_ghost=allow_leftmost_as_ghost)
741
 
 
742
 
        if len(parent_ids) == 0:
743
 
            leftmost_parent_id = None
744
 
            leftmost_parent_tree = None
745
 
        else:
746
 
            leftmost_parent_id, leftmost_parent_tree = parents_list[0]
747
 
 
748
 
        if self._change_last_revision(leftmost_parent_id):
749
 
            if leftmost_parent_tree is None:
750
 
                # If we don't have a tree, fall back to reading the
751
 
                # parent tree from the repository.
752
 
                self._cache_basis_inventory(leftmost_parent_id)
753
 
            else:
754
 
                inv = leftmost_parent_tree.inventory
755
 
                xml = self._create_basis_xml_from_inventory(
756
 
                                        leftmost_parent_id, inv)
757
 
                self._write_basis_inventory(xml)
758
 
        self._set_merges_from_parent_ids(parent_ids)
759
 
 
760
 
    @needs_tree_write_lock
761
732
    def set_pending_merges(self, rev_list):
762
733
        parents = self.get_parent_ids()
763
734
        leftmost = parents[:1]
768
739
    def set_merge_modified(self, modified_hashes):
769
740
        def iter_stanzas():
770
741
            for file_id, hash in modified_hashes.iteritems():
771
 
                yield Stanza(file_id=file_id, hash=hash)
 
742
                yield _mod_rio.Stanza(file_id=file_id.decode('utf8'),
 
743
                    hash=hash)
772
744
        self._put_rio('merge-hashes', iter_stanzas(), MERGE_MODIFIED_HEADER_1)
773
745
 
774
 
    @needs_tree_write_lock
 
746
    def _sha_from_stat(self, path, stat_result):
 
747
        """Get a sha digest from the tree's stat cache.
 
748
 
 
749
        The default implementation assumes no stat cache is present.
 
750
 
 
751
        :param path: The path.
 
752
        :param stat_result: The stat result being looked up.
 
753
        """
 
754
        return None
 
755
 
775
756
    def _put_rio(self, filename, stanzas, header):
776
 
        my_file = rio_file(stanzas, header)
777
 
        self._control_files.put(filename, my_file)
 
757
        self._must_be_locked()
 
758
        my_file = _mod_rio.rio_file(stanzas, header)
 
759
        self._transport.put_file(filename, my_file,
 
760
            mode=self.bzrdir._get_file_mode())
778
761
 
779
762
    @needs_write_lock # because merge pulls data into the branch.
780
 
    def merge_from_branch(self, branch, to_revision=None):
 
763
    def merge_from_branch(self, branch, to_revision=None, from_revision=None,
 
764
                          merge_type=None, force=False):
781
765
        """Merge from a branch into this working tree.
782
766
 
783
767
        :param branch: The branch to merge from.
787
771
            branch.last_revision().
788
772
        """
789
773
        from bzrlib.merge import Merger, Merge3Merger
790
 
        pb = bzrlib.ui.ui_factory.nested_progress_bar()
791
 
        try:
792
 
            merger = Merger(self.branch, this_tree=self, pb=pb)
793
 
            merger.pp = ProgressPhase("Merge phase", 5, pb)
794
 
            merger.pp.next_phase()
795
 
            # check that there are no
796
 
            # local alterations
797
 
            merger.check_basis(check_clean=True, require_commits=False)
798
 
            if to_revision is None:
799
 
                to_revision = branch.last_revision()
800
 
            else:
801
 
                to_revision = osutils.safe_revision_id(to_revision)
802
 
            merger.other_rev_id = to_revision
803
 
            if merger.other_rev_id is None:
804
 
                raise error.NoCommits(branch)
805
 
            self.branch.fetch(branch, last_revision=merger.other_rev_id)
806
 
            merger.other_basis = merger.other_rev_id
807
 
            merger.other_tree = self.branch.repository.revision_tree(
808
 
                merger.other_rev_id)
809
 
            merger.pp.next_phase()
 
774
        merger = Merger(self.branch, this_tree=self)
 
775
        # check that there are no local alterations
 
776
        if not force and self.has_changes():
 
777
            raise errors.UncommittedChanges(self)
 
778
        if to_revision is None:
 
779
            to_revision = _mod_revision.ensure_null(branch.last_revision())
 
780
        merger.other_rev_id = to_revision
 
781
        if _mod_revision.is_null(merger.other_rev_id):
 
782
            raise errors.NoCommits(branch)
 
783
        self.branch.fetch(branch, last_revision=merger.other_rev_id)
 
784
        merger.other_basis = merger.other_rev_id
 
785
        merger.other_tree = self.branch.repository.revision_tree(
 
786
            merger.other_rev_id)
 
787
        merger.other_branch = branch
 
788
        if from_revision is None:
810
789
            merger.find_base()
811
 
            if merger.base_rev_id == merger.other_rev_id:
812
 
                raise errors.PointlessMerge
813
 
            merger.backup_files = False
 
790
        else:
 
791
            merger.set_base_revision(from_revision, branch)
 
792
        if merger.base_rev_id == merger.other_rev_id:
 
793
            raise errors.PointlessMerge
 
794
        merger.backup_files = False
 
795
        if merge_type is None:
814
796
            merger.merge_type = Merge3Merger
815
 
            merger.set_interesting_files(None)
816
 
            merger.show_base = False
817
 
            merger.reprocess = False
818
 
            conflicts = merger.do_merge()
819
 
            merger.set_pending()
820
 
        finally:
821
 
            pb.finished()
 
797
        else:
 
798
            merger.merge_type = merge_type
 
799
        merger.set_interesting_files(None)
 
800
        merger.show_base = False
 
801
        merger.reprocess = False
 
802
        conflicts = merger.do_merge()
 
803
        merger.set_pending()
822
804
        return conflicts
823
805
 
824
 
    @needs_read_lock
825
806
    def merge_modified(self):
826
 
        try:
827
 
            hashfile = self._control_files.get('merge-hashes')
828
 
        except errors.NoSuchFile:
829
 
            return {}
830
 
        merge_hashes = {}
831
 
        try:
832
 
            if hashfile.next() != MERGE_MODIFIED_HEADER_1 + '\n':
833
 
                raise errors.MergeModifiedFormatError()
834
 
        except StopIteration:
835
 
            raise errors.MergeModifiedFormatError()
836
 
        for s in RioReader(hashfile):
837
 
            file_id = s.get("file_id")
838
 
            if file_id not in self.inventory:
839
 
                continue
840
 
            hash = s.get("hash")
841
 
            if hash == self.get_file_sha1(file_id):
842
 
                merge_hashes[file_id] = hash
843
 
        return merge_hashes
 
807
        """Return a dictionary of files modified by a merge.
 
808
 
 
809
        The list is initialized by WorkingTree.set_merge_modified, which is
 
810
        typically called after we make some automatic updates to the tree
 
811
        because of a merge.
 
812
 
 
813
        This returns a map of file_id->sha1, containing only files which are
 
814
        still in the working inventory and have that text hash.
 
815
        """
 
816
        raise NotImplementedError(self.merge_modified)
844
817
 
845
818
    @needs_write_lock
846
819
    def mkdir(self, path, file_id=None):
851
824
        self.add(path, file_id, 'directory')
852
825
        return file_id
853
826
 
854
 
    def get_symlink_target(self, file_id):
855
 
        return os.readlink(self.id2abspath(file_id))
856
 
 
857
 
    def file_class(self, filename):
858
 
        if self.path2id(filename):
859
 
            return 'V'
860
 
        elif self.is_ignored(filename):
861
 
            return 'I'
862
 
        else:
863
 
            return '?'
 
827
    def get_symlink_target(self, file_id, path=None):
 
828
        if path is not None:
 
829
            abspath = self.abspath(path)
 
830
        else:
 
831
            abspath = self.id2abspath(file_id)
 
832
        target = osutils.readlink(abspath)
 
833
        return target
 
834
 
 
835
    def subsume(self, other_tree):
 
836
        raise NotImplementedError(self.subsume)
 
837
 
 
838
    def _setup_directory_is_tree_reference(self):
 
839
        if self._branch.repository._format.supports_tree_reference:
 
840
            self._directory_is_tree_reference = \
 
841
                self._directory_may_be_tree_reference
 
842
        else:
 
843
            self._directory_is_tree_reference = \
 
844
                self._directory_is_never_tree_reference
 
845
 
 
846
    def _directory_is_never_tree_reference(self, relpath):
 
847
        return False
 
848
 
 
849
    def _directory_may_be_tree_reference(self, relpath):
 
850
        # as a special case, if a directory contains control files then
 
851
        # it's a tree reference, except that the root of the tree is not
 
852
        return relpath and osutils.isdir(self.abspath(relpath) + u"/.bzr")
 
853
        # TODO: We could ask all the control formats whether they
 
854
        # recognize this directory, but at the moment there's no cheap api
 
855
        # to do that.  Since we probably can only nest bzr checkouts and
 
856
        # they always use this name it's ok for now.  -- mbp 20060306
 
857
        #
 
858
        # FIXME: There is an unhandled case here of a subdirectory
 
859
        # containing .bzr but not a branch; that will probably blow up
 
860
        # when you try to commit it.  It might happen if there is a
 
861
        # checkout in a subdirectory.  This can be avoided by not adding
 
862
        # it.  mbp 20070306
 
863
 
 
864
    def extract(self, file_id, format=None):
 
865
        """Extract a subtree from this tree.
 
866
 
 
867
        A new branch will be created, relative to the path for this tree.
 
868
        """
 
869
        raise NotImplementedError(self.extract)
864
870
 
865
871
    def flush(self):
866
 
        """Write the in memory inventory to disk."""
867
 
        # TODO: Maybe this should only write on dirty ?
868
 
        if self._control_files._lock_mode != 'w':
869
 
            raise errors.NotWriteLocked(self)
870
 
        sio = StringIO()
871
 
        xml5.serializer_v5.write_inventory(self._inventory, sio)
872
 
        sio.seek(0)
873
 
        self._control_files.put('inventory', sio)
874
 
        self._inventory_is_modified = False
875
 
 
876
 
    def list_files(self, include_root=False):
877
 
        """Recursively list all files as (path, class, kind, id, entry).
 
872
        """Write the in memory meta data to disk."""
 
873
        raise NotImplementedError(self.flush)
 
874
 
 
875
    def _kind(self, relpath):
 
876
        return osutils.file_kind(self.abspath(relpath))
 
877
 
 
878
    def list_files(self, include_root=False, from_dir=None, recursive=True):
 
879
        """List all files as (path, class, kind, id, entry).
878
880
 
879
881
        Lists, but does not descend into unversioned directories.
880
 
 
881
882
        This does not include files that have been deleted in this
882
 
        tree.
 
883
        tree. Skips the control directory.
883
884
 
884
 
        Skips the control directory.
 
885
        :param include_root: if True, return an entry for the root
 
886
        :param from_dir: start from this directory or None for the root
 
887
        :param recursive: whether to recurse into subdirectories or not
885
888
        """
886
 
        # list_files is an iterator, so @needs_read_lock doesn't work properly
887
 
        # with it. So callers should be careful to always read_lock the tree.
888
 
        if not self.is_locked():
889
 
            raise errors.ObjectNotLocked(self)
890
 
 
891
 
        inv = self.inventory
892
 
        if include_root is True:
893
 
            yield ('', 'V', 'directory', inv.root.file_id, inv.root)
894
 
        # Convert these into local objects to save lookup times
895
 
        pathjoin = osutils.pathjoin
896
 
        file_kind = osutils.file_kind
897
 
 
898
 
        # transport.base ends in a slash, we want the piece
899
 
        # between the last two slashes
900
 
        transport_base_dir = self.bzrdir.transport.base.rsplit('/', 2)[1]
901
 
 
902
 
        fk_entries = {'directory':TreeDirectory, 'file':TreeFile, 'symlink':TreeLink}
903
 
 
904
 
        # directory file_id, relative path, absolute path, reverse sorted children
905
 
        children = os.listdir(self.basedir)
906
 
        children.sort()
907
 
        # jam 20060527 The kernel sized tree seems equivalent whether we 
908
 
        # use a deque and popleft to keep them sorted, or if we use a plain
909
 
        # list and just reverse() them.
910
 
        children = collections.deque(children)
911
 
        stack = [(inv.root.file_id, u'', self.basedir, children)]
912
 
        while stack:
913
 
            from_dir_id, from_dir_relpath, from_dir_abspath, children = stack[-1]
914
 
 
915
 
            while children:
916
 
                f = children.popleft()
917
 
                ## TODO: If we find a subdirectory with its own .bzr
918
 
                ## directory, then that is a separate tree and we
919
 
                ## should exclude it.
920
 
 
921
 
                # the bzrdir for this tree
922
 
                if transport_base_dir == f:
923
 
                    continue
924
 
 
925
 
                # we know that from_dir_relpath and from_dir_abspath never end in a slash
926
 
                # and 'f' doesn't begin with one, we can do a string op, rather
927
 
                # than the checks of pathjoin(), all relative paths will have an extra slash
928
 
                # at the beginning
929
 
                fp = from_dir_relpath + '/' + f
930
 
 
931
 
                # absolute path
932
 
                fap = from_dir_abspath + '/' + f
933
 
                
934
 
                f_ie = inv.get_child(from_dir_id, f)
935
 
                if f_ie:
936
 
                    c = 'V'
937
 
                elif self.is_ignored(fp[1:]):
938
 
                    c = 'I'
939
 
                else:
940
 
                    # we may not have found this file, because of a unicode issue
941
 
                    f_norm, can_access = osutils.normalized_filename(f)
942
 
                    if f == f_norm or not can_access:
943
 
                        # No change, so treat this file normally
944
 
                        c = '?'
945
 
                    else:
946
 
                        # this file can be accessed by a normalized path
947
 
                        # check again if it is versioned
948
 
                        # these lines are repeated here for performance
949
 
                        f = f_norm
950
 
                        fp = from_dir_relpath + '/' + f
951
 
                        fap = from_dir_abspath + '/' + f
952
 
                        f_ie = inv.get_child(from_dir_id, f)
953
 
                        if f_ie:
954
 
                            c = 'V'
955
 
                        elif self.is_ignored(fp[1:]):
956
 
                            c = 'I'
957
 
                        else:
958
 
                            c = '?'
959
 
 
960
 
                fk = file_kind(fap)
961
 
 
962
 
                if f_ie:
963
 
                    if f_ie.kind != fk:
964
 
                        raise errors.BzrCheckError(
965
 
                            "file %r entered as kind %r id %r, now of kind %r"
966
 
                            % (fap, f_ie.kind, f_ie.file_id, fk))
967
 
 
968
 
                # make a last minute entry
969
 
                if f_ie:
970
 
                    yield fp[1:], c, fk, f_ie.file_id, f_ie
971
 
                else:
972
 
                    try:
973
 
                        yield fp[1:], c, fk, None, fk_entries[fk]()
974
 
                    except KeyError:
975
 
                        yield fp[1:], c, fk, None, TreeEntry()
976
 
                    continue
977
 
                
978
 
                if fk != 'directory':
979
 
                    continue
980
 
 
981
 
                # But do this child first
982
 
                new_children = os.listdir(fap)
983
 
                new_children.sort()
984
 
                new_children = collections.deque(new_children)
985
 
                stack.append((f_ie.file_id, fp, fap, new_children))
986
 
                # Break out of inner loop,
987
 
                # so that we start outer loop with child
988
 
                break
989
 
            else:
990
 
                # if we finished all children, pop it off the stack
991
 
                stack.pop()
992
 
 
993
 
    @needs_tree_write_lock
994
 
    def move(self, from_paths, to_dir=None, after=False, **kwargs):
 
889
        raise NotImplementedError(self.list_files)
 
890
 
 
891
    def move(self, from_paths, to_dir=None, after=False):
995
892
        """Rename files.
996
893
 
997
 
        to_dir must exist in the inventory.
 
894
        to_dir must be known to the working tree.
998
895
 
999
896
        If to_dir exists and is a directory, the files are moved into
1000
 
        it, keeping their old names.  
 
897
        it, keeping their old names.
1001
898
 
1002
899
        Note that to_dir is only the last component of the new name;
1003
900
        this doesn't change the directory.
1006
903
        independently.
1007
904
 
1008
905
        The first mode moves the file in the filesystem and updates the
1009
 
        inventory. The second mode only updates the inventory without
1010
 
        touching the file on the filesystem. This is the new mode introduced
1011
 
        in version 0.15.
 
906
        working tree metadata. The second mode only updates the working tree
 
907
        metadata without touching the file on the filesystem.
1012
908
 
1013
909
        move uses the second mode if 'after == True' and the target is not
1014
910
        versioned but present in the working tree.
1026
922
        This returns a list of (from_path, to_path) pairs for each
1027
923
        entry that is moved.
1028
924
        """
1029
 
        rename_entries = []
1030
 
        rename_tuples = []
1031
 
 
1032
 
        # check for deprecated use of signature
1033
 
        if to_dir is None:
1034
 
            to_dir = kwargs.get('to_name', None)
1035
 
            if to_dir is None:
1036
 
                raise TypeError('You must supply a target directory')
1037
 
            else:
1038
 
                symbol_versioning.warn('The parameter to_name was deprecated'
1039
 
                                       ' in version 0.13. Use to_dir instead',
1040
 
                                       DeprecationWarning)
1041
 
 
1042
 
        # check destination directory
1043
 
        assert not isinstance(from_paths, basestring)
1044
 
        inv = self.inventory
1045
 
        to_abs = self.abspath(to_dir)
1046
 
        if not isdir(to_abs):
1047
 
            raise errors.BzrMoveFailedError('',to_dir,
1048
 
                errors.NotADirectory(to_abs))
1049
 
        if not self.has_filename(to_dir):
1050
 
            raise errors.BzrMoveFailedError('',to_dir,
1051
 
                errors.NotInWorkingDirectory(to_dir))
1052
 
        to_dir_id = inv.path2id(to_dir)
1053
 
        if to_dir_id is None:
1054
 
            raise errors.BzrMoveFailedError('',to_dir,
1055
 
                errors.NotVersionedError(path=str(to_dir)))
1056
 
 
1057
 
        to_dir_ie = inv[to_dir_id]
1058
 
        if to_dir_ie.kind != 'directory':
1059
 
            raise errors.BzrMoveFailedError('',to_dir,
1060
 
                errors.NotADirectory(to_abs))
1061
 
 
1062
 
        # create rename entries and tuples
1063
 
        for from_rel in from_paths:
1064
 
            from_tail = splitpath(from_rel)[-1]
1065
 
            from_id = inv.path2id(from_rel)
1066
 
            if from_id is None:
1067
 
                raise errors.BzrMoveFailedError(from_rel,to_dir,
1068
 
                    errors.NotVersionedError(path=str(from_rel)))
1069
 
 
1070
 
            from_entry = inv[from_id]
1071
 
            from_parent_id = from_entry.parent_id
1072
 
            to_rel = pathjoin(to_dir, from_tail)
1073
 
            rename_entry = WorkingTree._RenameEntry(from_rel=from_rel,
1074
 
                                         from_id=from_id,
1075
 
                                         from_tail=from_tail,
1076
 
                                         from_parent_id=from_parent_id,
1077
 
                                         to_rel=to_rel, to_tail=from_tail,
1078
 
                                         to_parent_id=to_dir_id)
1079
 
            rename_entries.append(rename_entry)
1080
 
            rename_tuples.append((from_rel, to_rel))
1081
 
 
1082
 
        # determine which move mode to use. checks also for movability
1083
 
        rename_entries = self._determine_mv_mode(rename_entries, after)
1084
 
 
1085
 
        original_modified = self._inventory_is_modified
1086
 
        try:
1087
 
            if len(from_paths):
1088
 
                self._inventory_is_modified = True
1089
 
            self._move(rename_entries)
1090
 
        except:
1091
 
            # restore the inventory on error
1092
 
            self._inventory_is_modified = original_modified
1093
 
            raise
1094
 
        self._write_inventory(inv)
1095
 
        return rename_tuples
1096
 
 
1097
 
    def _determine_mv_mode(self, rename_entries, after=False):
1098
 
        """Determines for each from-to pair if both inventory and working tree
1099
 
        or only the inventory has to be changed.
1100
 
 
1101
 
        Also does basic plausability tests.
1102
 
        """
1103
 
        inv = self.inventory
1104
 
 
1105
 
        for rename_entry in rename_entries:
1106
 
            # store to local variables for easier reference
1107
 
            from_rel = rename_entry.from_rel
1108
 
            from_id = rename_entry.from_id
1109
 
            to_rel = rename_entry.to_rel
1110
 
            to_id = inv.path2id(to_rel)
1111
 
            only_change_inv = False
1112
 
 
1113
 
            # check the inventory for source and destination
1114
 
            if from_id is None:
1115
 
                raise errors.BzrMoveFailedError(from_rel,to_rel,
1116
 
                    errors.NotVersionedError(path=str(from_rel)))
1117
 
            if to_id is not None:
1118
 
                raise errors.BzrMoveFailedError(from_rel,to_rel,
1119
 
                    errors.AlreadyVersionedError(path=str(to_rel)))
1120
 
 
1121
 
            # try to determine the mode for rename (only change inv or change
1122
 
            # inv and file system)
1123
 
            if after:
1124
 
                if not self.has_filename(to_rel):
1125
 
                    raise errors.BzrMoveFailedError(from_id,to_rel,
1126
 
                        errors.NoSuchFile(path=str(to_rel),
1127
 
                        extra="New file has not been created yet"))
1128
 
                only_change_inv = True
1129
 
            elif not self.has_filename(from_rel) and self.has_filename(to_rel):
1130
 
                only_change_inv = True
1131
 
            elif self.has_filename(from_rel) and not self.has_filename(to_rel):
1132
 
                only_change_inv = False
1133
 
            else:
1134
 
                # something is wrong, so lets determine what exactly
1135
 
                if not self.has_filename(from_rel) and \
1136
 
                   not self.has_filename(to_rel):
1137
 
                    raise errors.BzrRenameFailedError(from_rel,to_rel,
1138
 
                        errors.PathsDoNotExist(paths=(str(from_rel),
1139
 
                        str(to_rel))))
1140
 
                else:
1141
 
                    raise errors.RenameFailedFilesExist(from_rel, to_rel,
1142
 
                        extra="(Use --after to update the Bazaar id)")
1143
 
            rename_entry.only_change_inv = only_change_inv
1144
 
        return rename_entries
1145
 
 
1146
 
    def _move(self, rename_entries):
1147
 
        """Moves a list of files.
1148
 
 
1149
 
        Depending on the value of the flag 'only_change_inv', the
1150
 
        file will be moved on the file system or not.
1151
 
        """
1152
 
        inv = self.inventory
1153
 
        moved = []
1154
 
 
1155
 
        for entry in rename_entries:
1156
 
            try:
1157
 
                self._move_entry(entry)
1158
 
            except:
1159
 
                self._rollback_move(moved)
1160
 
                raise
1161
 
            moved.append(entry)
1162
 
 
1163
 
    def _rollback_move(self, moved):
1164
 
        """Try to rollback a previous move in case of an filesystem error."""
1165
 
        inv = self.inventory
1166
 
        for entry in moved:
1167
 
            try:
1168
 
                self._move_entry(_RenameEntry(entry.to_rel, entry.from_id,
1169
 
                    entry.to_tail, entry.to_parent_id, entry.from_rel,
1170
 
                    entry.from_tail, entry.from_parent_id,
1171
 
                    entry.only_change_inv))
1172
 
            except errors.BzrMoveFailedError, e:
1173
 
                raise errors.BzrMoveFailedError( '', '', "Rollback failed."
1174
 
                        " The working tree is in an inconsistent state."
1175
 
                        " Please consider doing a 'bzr revert'."
1176
 
                        " Error message is: %s" % e)
1177
 
 
1178
 
    def _move_entry(self, entry):
1179
 
        inv = self.inventory
1180
 
        from_rel_abs = self.abspath(entry.from_rel)
1181
 
        to_rel_abs = self.abspath(entry.to_rel)
1182
 
        if from_rel_abs == to_rel_abs:
1183
 
            raise errors.BzrMoveFailedError(entry.from_rel, entry.to_rel,
1184
 
                "Source and target are identical.")
1185
 
 
1186
 
        if not entry.only_change_inv:
1187
 
            try:
1188
 
                osutils.rename(from_rel_abs, to_rel_abs)
1189
 
            except OSError, e:
1190
 
                raise errors.BzrMoveFailedError(entry.from_rel,
1191
 
                    entry.to_rel, e[1])
1192
 
        inv.rename(entry.from_id, entry.to_parent_id, entry.to_tail)
 
925
        raise NotImplementedError(self.move)
1193
926
 
1194
927
    @needs_tree_write_lock
1195
928
    def rename_one(self, from_rel, to_rel, after=False):
1199
932
 
1200
933
        rename_one has several 'modes' to work. First, it can rename a physical
1201
934
        file and change the file_id. That is the normal mode. Second, it can
1202
 
        only change the file_id without touching any physical file. This is
1203
 
        the new mode introduced in version 0.15.
 
935
        only change the file_id without touching any physical file.
1204
936
 
1205
 
        rename_one uses the second mode if 'after == True' and 'to_rel' is not
1206
 
        versioned but present in the working tree.
 
937
        rename_one uses the second mode if 'after == True' and 'to_rel' is
 
938
        either not versioned or newly added, and present in the working tree.
1207
939
 
1208
940
        rename_one uses the second mode if 'after == False' and 'from_rel' is
1209
941
        versioned but no longer in the working tree, and 'to_rel' is not
1215
947
 
1216
948
        Everything else results in an error.
1217
949
        """
1218
 
        inv = self.inventory
1219
 
        rename_entries = []
1220
 
 
1221
 
        # create rename entries and tuples
1222
 
        from_tail = splitpath(from_rel)[-1]
1223
 
        from_id = inv.path2id(from_rel)
1224
 
        if from_id is None:
1225
 
            raise errors.BzrRenameFailedError(from_rel,to_rel,
1226
 
                errors.NotVersionedError(path=str(from_rel)))
1227
 
        from_entry = inv[from_id]
1228
 
        from_parent_id = from_entry.parent_id
1229
 
        to_dir, to_tail = os.path.split(to_rel)
1230
 
        to_dir_id = inv.path2id(to_dir)
1231
 
        rename_entry = WorkingTree._RenameEntry(from_rel=from_rel,
1232
 
                                     from_id=from_id,
1233
 
                                     from_tail=from_tail,
1234
 
                                     from_parent_id=from_parent_id,
1235
 
                                     to_rel=to_rel, to_tail=to_tail,
1236
 
                                     to_parent_id=to_dir_id)
1237
 
        rename_entries.append(rename_entry)
1238
 
 
1239
 
        # determine which move mode to use. checks also for movability
1240
 
        rename_entries = self._determine_mv_mode(rename_entries, after)
1241
 
 
1242
 
        # check if the target changed directory and if the target directory is
1243
 
        # versioned
1244
 
        if to_dir_id is None:
1245
 
            raise errors.BzrMoveFailedError(from_rel,to_rel,
1246
 
                errors.NotVersionedError(path=str(to_dir)))
1247
 
 
1248
 
        # all checks done. now we can continue with our actual work
1249
 
        mutter('rename_one:\n'
1250
 
               '  from_id   {%s}\n'
1251
 
               '  from_rel: %r\n'
1252
 
               '  to_rel:   %r\n'
1253
 
               '  to_dir    %r\n'
1254
 
               '  to_dir_id {%s}\n',
1255
 
               from_id, from_rel, to_rel, to_dir, to_dir_id)
1256
 
 
1257
 
        self._move(rename_entries)
1258
 
        self._write_inventory(inv)
1259
 
 
1260
 
    class _RenameEntry(object):
1261
 
        def __init__(self, from_rel, from_id, from_tail, from_parent_id,
1262
 
                     to_rel, to_tail, to_parent_id, only_change_inv=False):
1263
 
            self.from_rel = from_rel
1264
 
            self.from_id = from_id
1265
 
            self.from_tail = from_tail
1266
 
            self.from_parent_id = from_parent_id
1267
 
            self.to_rel = to_rel
1268
 
            self.to_tail = to_tail
1269
 
            self.to_parent_id = to_parent_id
1270
 
            self.only_change_inv = only_change_inv
 
950
        raise NotImplementedError(self.rename_one)
1271
951
 
1272
952
    @needs_read_lock
1273
953
    def unknowns(self):
1276
956
        These are files in the working directory that are not versioned or
1277
957
        control files or ignored.
1278
958
        """
1279
 
        # force the extras method to be fully executed before returning, to 
 
959
        # force the extras method to be fully executed before returning, to
1280
960
        # prevent race conditions with the lock
1281
961
        return iter(
1282
962
            [subp for subp in self.extras() if not self.is_ignored(subp)])
1283
 
    
1284
 
    @needs_tree_write_lock
 
963
 
1285
964
    def unversion(self, file_ids):
1286
965
        """Remove the file ids in file_ids from the current versioned set.
1287
966
 
1291
970
        :param file_ids: The file ids to stop versioning.
1292
971
        :raises: NoSuchId if any fileid is not currently versioned.
1293
972
        """
1294
 
        for file_id in file_ids:
1295
 
            if self._inventory.has_id(file_id):
1296
 
                self._inventory.remove_recursive_id(file_id)
1297
 
            else:
1298
 
                raise errors.NoSuchId(self, file_id)
1299
 
        if len(file_ids):
1300
 
            # in the future this should just set a dirty bit to wait for the 
1301
 
            # final unlock. However, until all methods of workingtree start
1302
 
            # with the current in -memory inventory rather than triggering 
1303
 
            # a read, it is more complex - we need to teach read_inventory
1304
 
            # to know when to read, and when to not read first... and possibly
1305
 
            # to save first when the in memory one may be corrupted.
1306
 
            # so for now, we just only write it if it is indeed dirty.
1307
 
            # - RBC 20060907
1308
 
            self._write_inventory(self._inventory)
1309
 
    
1310
 
    @deprecated_method(zero_eight)
1311
 
    def iter_conflicts(self):
1312
 
        """List all files in the tree that have text or content conflicts.
1313
 
        DEPRECATED.  Use conflicts instead."""
1314
 
        return self._iter_conflicts()
1315
 
 
1316
 
    def _iter_conflicts(self):
1317
 
        conflicted = set()
1318
 
        for info in self.list_files():
1319
 
            path = info[0]
1320
 
            stem = get_conflicted_stem(path)
1321
 
            if stem is None:
1322
 
                continue
1323
 
            if stem not in conflicted:
1324
 
                conflicted.add(stem)
1325
 
                yield stem
 
973
        raise NotImplementedError(self.unversion)
1326
974
 
1327
975
    @needs_write_lock
1328
976
    def pull(self, source, overwrite=False, stop_revision=None,
1329
 
             change_reporter=None):
1330
 
        top_pb = bzrlib.ui.ui_factory.nested_progress_bar()
 
977
             change_reporter=None, possible_transports=None, local=False,
 
978
             show_base=False):
1331
979
        source.lock_read()
1332
980
        try:
1333
 
            pp = ProgressPhase("Pull phase", 2, top_pb)
1334
 
            pp.next_phase()
1335
981
            old_revision_info = self.branch.last_revision_info()
1336
982
            basis_tree = self.basis_tree()
1337
 
            count = self.branch.pull(source, overwrite, stop_revision)
 
983
            count = self.branch.pull(source, overwrite, stop_revision,
 
984
                                     possible_transports=possible_transports,
 
985
                                     local=local)
1338
986
            new_revision_info = self.branch.last_revision_info()
1339
987
            if new_revision_info != old_revision_info:
1340
 
                pp.next_phase()
1341
988
                repository = self.branch.repository
1342
 
                pb = bzrlib.ui.ui_factory.nested_progress_bar()
 
989
                if repository._format.fast_deltas:
 
990
                    parent_ids = self.get_parent_ids()
 
991
                    if parent_ids:
 
992
                        basis_id = parent_ids[0]
 
993
                        basis_tree = repository.revision_tree(basis_id)
1343
994
                basis_tree.lock_read()
1344
995
                try:
1345
996
                    new_basis_tree = self.branch.basis_tree()
1348
999
                                new_basis_tree,
1349
1000
                                basis_tree,
1350
1001
                                this_tree=self,
1351
 
                                pb=pb,
1352
 
                                change_reporter=change_reporter)
1353
 
                    if (basis_tree.inventory.root is None and
1354
 
                        new_basis_tree.inventory.root is not None):
1355
 
                        self.set_root_id(new_basis_tree.inventory.root.file_id)
 
1002
                                pb=None,
 
1003
                                change_reporter=change_reporter,
 
1004
                                show_base=show_base)
 
1005
                    basis_root_id = basis_tree.get_root_id()
 
1006
                    new_root_id = new_basis_tree.get_root_id()
 
1007
                    if basis_root_id != new_root_id:
 
1008
                        self.set_root_id(new_root_id)
1356
1009
                finally:
1357
 
                    pb.finished()
1358
1010
                    basis_tree.unlock()
1359
1011
                # TODO - dedup parents list with things merged by pull ?
1360
1012
                # reuse the revisiontree we merged against to set the new
1361
1013
                # tree data.
1362
1014
                parent_trees = [(self.branch.last_revision(), new_basis_tree)]
1363
 
                # we have to pull the merge trees out again, because 
1364
 
                # merge_inner has set the ids. - this corner is not yet 
 
1015
                # we have to pull the merge trees out again, because
 
1016
                # merge_inner has set the ids. - this corner is not yet
1365
1017
                # layered well enough to prevent double handling.
1366
1018
                # XXX TODO: Fix the double handling: telling the tree about
1367
1019
                # the already known parent data is wasteful.
1373
1025
            return count
1374
1026
        finally:
1375
1027
            source.unlock()
1376
 
            top_pb.finished()
1377
1028
 
1378
1029
    @needs_write_lock
1379
1030
    def put_file_bytes_non_atomic(self, file_id, bytes):
1383
1034
            stream.write(bytes)
1384
1035
        finally:
1385
1036
            stream.close()
1386
 
        # TODO: update the hashcache here ?
1387
1037
 
1388
1038
    def extras(self):
1389
 
        """Yield all unknown files in this WorkingTree.
 
1039
        """Yield all unversioned files in this WorkingTree.
1390
1040
 
1391
 
        If there are any unknown directories then only the directory is
1392
 
        returned, not all its children.  But if there are unknown files
 
1041
        If there are any unversioned directories then only the directory is
 
1042
        returned, not all its children.  But if there are unversioned files
1393
1043
        under a versioned subdirectory, they are returned.
1394
1044
 
1395
1045
        Currently returned depth-first, sorted by name within directories.
 
1046
        This is the same order used by 'osutils.walkdirs'.
1396
1047
        """
1397
 
        ## TODO: Work from given directory downwards
1398
 
        for path, dir_entry in self.inventory.directories():
1399
 
            # mutter("search for unknowns in %r", path)
1400
 
            dirabs = self.abspath(path)
1401
 
            if not isdir(dirabs):
1402
 
                # e.g. directory deleted
1403
 
                continue
1404
 
 
1405
 
            fl = []
1406
 
            for subf in os.listdir(dirabs):
1407
 
                if subf == '.bzr':
1408
 
                    continue
1409
 
                if subf not in dir_entry.children:
1410
 
                    subf_norm, can_access = osutils.normalized_filename(subf)
1411
 
                    if subf_norm != subf and can_access:
1412
 
                        if subf_norm not in dir_entry.children:
1413
 
                            fl.append(subf_norm)
1414
 
                    else:
1415
 
                        fl.append(subf)
1416
 
            
1417
 
            fl.sort()
1418
 
            for subf in fl:
1419
 
                subp = pathjoin(path, subf)
1420
 
                yield subp
 
1048
        raise NotImplementedError(self.extras)
1421
1049
 
1422
1050
    def ignored_files(self):
1423
1051
        """Yield list of PATH, IGNORE_PATTERN"""
1435
1063
        if ignoreset is not None:
1436
1064
            return ignoreset
1437
1065
 
1438
 
        ignore_globs = set(bzrlib.DEFAULT_IGNORE)
 
1066
        ignore_globs = set()
1439
1067
        ignore_globs.update(ignores.get_runtime_ignores())
1440
1068
        ignore_globs.update(ignores.get_user_ignores())
1441
1069
        if self.has_filename(bzrlib.IGNORE_FILENAME):
1456
1084
        r"""Check whether the filename matches an ignore pattern.
1457
1085
 
1458
1086
        Patterns containing '/' or '\' need to match the whole path;
1459
 
        others match against only the last component.
 
1087
        others match against only the last component.  Patterns starting
 
1088
        with '!' are ignore exceptions.  Exceptions take precedence
 
1089
        over regular patterns and cause the filename to not be ignored.
1460
1090
 
1461
1091
        If the file is ignored, returns the pattern which caused it to
1462
1092
        be ignored, otherwise None.  So this can simply be used as a
1463
1093
        boolean if desired."""
1464
1094
        if getattr(self, '_ignoreglobster', None) is None:
1465
 
            self._ignoreglobster = globbing.Globster(self.get_ignore_list())
 
1095
            self._ignoreglobster = globbing.ExceptionGlobster(self.get_ignore_list())
1466
1096
        return self._ignoreglobster.match(filename)
1467
1097
 
1468
1098
    def kind(self, file_id):
1469
1099
        return file_kind(self.id2abspath(file_id))
1470
1100
 
 
1101
    def stored_kind(self, file_id):
 
1102
        """See Tree.stored_kind"""
 
1103
        raise NotImplementedError(self.stored_kind)
 
1104
 
1471
1105
    def _comparison_data(self, entry, path):
1472
1106
        abspath = self.abspath(path)
1473
1107
        try:
1483
1117
            mode = stat_value.st_mode
1484
1118
            kind = osutils.file_kind_from_stat_mode(mode)
1485
1119
            if not supports_executable():
1486
 
                executable = entry.executable
 
1120
                executable = entry is not None and entry.executable
1487
1121
            else:
1488
1122
                executable = bool(stat.S_ISREG(mode) and stat.S_IEXEC & mode)
1489
1123
        return kind, executable, stat_value
1504
1138
    @needs_read_lock
1505
1139
    def _last_revision(self):
1506
1140
        """helper for get_parent_ids."""
1507
 
        return self.branch.last_revision()
 
1141
        return _mod_revision.ensure_null(self.branch.last_revision())
1508
1142
 
1509
1143
    def is_locked(self):
1510
1144
        return self._control_files.is_locked()
1511
1145
 
 
1146
    def _must_be_locked(self):
 
1147
        if not self.is_locked():
 
1148
            raise errors.ObjectNotLocked(self)
 
1149
 
1512
1150
    def lock_read(self):
1513
 
        """See Branch.lock_read, and WorkingTree.unlock."""
 
1151
        """Lock the tree for reading.
 
1152
 
 
1153
        This also locks the branch, and can be unlocked via self.unlock().
 
1154
 
 
1155
        :return: A bzrlib.lock.LogicalLockResult.
 
1156
        """
 
1157
        if not self.is_locked():
 
1158
            self._reset_data()
1514
1159
        self.branch.lock_read()
1515
1160
        try:
1516
 
            return self._control_files.lock_read()
 
1161
            self._control_files.lock_read()
 
1162
            return LogicalLockResult(self.unlock)
1517
1163
        except:
1518
1164
            self.branch.unlock()
1519
1165
            raise
1520
1166
 
1521
1167
    def lock_tree_write(self):
1522
 
        """See MutableTree.lock_tree_write, and WorkingTree.unlock."""
 
1168
        """See MutableTree.lock_tree_write, and WorkingTree.unlock.
 
1169
 
 
1170
        :return: A bzrlib.lock.LogicalLockResult.
 
1171
        """
 
1172
        if not self.is_locked():
 
1173
            self._reset_data()
1523
1174
        self.branch.lock_read()
1524
1175
        try:
1525
 
            return self._control_files.lock_write()
 
1176
            self._control_files.lock_write()
 
1177
            return LogicalLockResult(self.unlock)
1526
1178
        except:
1527
1179
            self.branch.unlock()
1528
1180
            raise
1529
1181
 
1530
1182
    def lock_write(self):
1531
 
        """See MutableTree.lock_write, and WorkingTree.unlock."""
 
1183
        """See MutableTree.lock_write, and WorkingTree.unlock.
 
1184
 
 
1185
        :return: A bzrlib.lock.LogicalLockResult.
 
1186
        """
 
1187
        if not self.is_locked():
 
1188
            self._reset_data()
1532
1189
        self.branch.lock_write()
1533
1190
        try:
1534
 
            return self._control_files.lock_write()
 
1191
            self._control_files.lock_write()
 
1192
            return LogicalLockResult(self.unlock)
1535
1193
        except:
1536
1194
            self.branch.unlock()
1537
1195
            raise
1539
1197
    def get_physical_lock_status(self):
1540
1198
        return self._control_files.get_physical_lock_status()
1541
1199
 
1542
 
    def _basis_inventory_name(self):
1543
 
        return 'basis-inventory-cache'
 
1200
    def _reset_data(self):
 
1201
        """Reset transient data that cannot be revalidated."""
 
1202
        raise NotImplementedError(self._reset_data)
1544
1203
 
1545
 
    @needs_tree_write_lock
1546
1204
    def set_last_revision(self, new_revision):
1547
1205
        """Change the last revision in the working tree."""
1548
 
        new_revision = osutils.safe_revision_id(new_revision)
1549
 
        if self._change_last_revision(new_revision):
1550
 
            self._cache_basis_inventory(new_revision)
 
1206
        raise NotImplementedError(self.set_last_revision)
1551
1207
 
1552
1208
    def _change_last_revision(self, new_revision):
1553
1209
        """Template method part of set_last_revision to perform the change.
1554
 
        
 
1210
 
1555
1211
        This is used to allow WorkingTree3 instances to not affect branch
1556
1212
        when their last revision is set.
1557
1213
        """
1558
 
        if new_revision is None:
1559
 
            self.branch.set_revision_history([])
 
1214
        if _mod_revision.is_null(new_revision):
 
1215
            self.branch.set_last_revision_info(0, new_revision)
1560
1216
            return False
 
1217
        _mod_revision.check_not_reserved_id(new_revision)
1561
1218
        try:
1562
1219
            self.branch.generate_revision_history(new_revision)
1563
1220
        except errors.NoSuchRevision:
1564
1221
            # not present in the repo - dont try to set it deeper than the tip
1565
 
            self.branch.set_revision_history([new_revision])
 
1222
            self.branch._set_revision_history([new_revision])
1566
1223
        return True
1567
1224
 
1568
 
    def _write_basis_inventory(self, xml):
1569
 
        """Write the basis inventory XML to the basis-inventory file"""
1570
 
        assert isinstance(xml, str), 'serialised xml must be bytestring.'
1571
 
        path = self._basis_inventory_name()
1572
 
        sio = StringIO(xml)
1573
 
        self._control_files.put(path, sio)
1574
 
 
1575
 
    def _create_basis_xml_from_inventory(self, revision_id, inventory):
1576
 
        """Create the text that will be saved in basis-inventory"""
1577
 
        # TODO: jam 20070209 This should be redundant, as the revision_id
1578
 
        #       as all callers should have already converted the revision_id to
1579
 
        #       utf8
1580
 
        inventory.revision_id = osutils.safe_revision_id(revision_id)
1581
 
        return xml6.serializer_v6.write_inventory_to_string(inventory)
1582
 
 
1583
 
    def _cache_basis_inventory(self, new_revision):
1584
 
        """Cache new_revision as the basis inventory."""
1585
 
        # TODO: this should allow the ready-to-use inventory to be passed in,
1586
 
        # as commit already has that ready-to-use [while the format is the
1587
 
        # same, that is].
1588
 
        try:
1589
 
            # this double handles the inventory - unpack and repack - 
1590
 
            # but is easier to understand. We can/should put a conditional
1591
 
            # in here based on whether the inventory is in the latest format
1592
 
            # - perhaps we should repack all inventories on a repository
1593
 
            # upgrade ?
1594
 
            # the fast path is to copy the raw xml from the repository. If the
1595
 
            # xml contains 'revision_id="', then we assume the right 
1596
 
            # revision_id is set. We must check for this full string, because a
1597
 
            # root node id can legitimately look like 'revision_id' but cannot
1598
 
            # contain a '"'.
1599
 
            xml = self.branch.repository.get_inventory_xml(new_revision)
1600
 
            firstline = xml.split('\n', 1)[0]
1601
 
            if (not 'revision_id="' in firstline or 
1602
 
                'format="6"' not in firstline):
1603
 
                inv = self.branch.repository.deserialise_inventory(
1604
 
                    new_revision, xml)
1605
 
                xml = self._create_basis_xml_from_inventory(new_revision, inv)
1606
 
            self._write_basis_inventory(xml)
1607
 
        except (errors.NoSuchRevision, errors.RevisionNotPresent):
1608
 
            pass
1609
 
 
1610
 
    def read_basis_inventory(self):
1611
 
        """Read the cached basis inventory."""
1612
 
        path = self._basis_inventory_name()
1613
 
        return self._control_files.get(path).read()
1614
 
        
1615
 
    @needs_read_lock
1616
 
    def read_working_inventory(self):
1617
 
        """Read the working inventory.
1618
 
        
1619
 
        :raises errors.InventoryModified: read_working_inventory will fail
1620
 
            when the current in memory inventory has been modified.
1621
 
        """
1622
 
        # conceptually this should be an implementation detail of the tree. 
1623
 
        # XXX: Deprecate this.
1624
 
        # ElementTree does its own conversion from UTF-8, so open in
1625
 
        # binary.
1626
 
        if self._inventory_is_modified:
1627
 
            raise errors.InventoryModified(self)
1628
 
        result = xml5.serializer_v5.read_inventory(
1629
 
            self._control_files.get('inventory'))
1630
 
        self._set_inventory(result, dirty=False)
1631
 
        return result
1632
 
 
1633
1225
    @needs_tree_write_lock
1634
 
    def remove(self, files, verbose=False, to_file=None):
1635
 
        """Remove nominated files from the working inventory..
1636
 
 
1637
 
        This does not remove their text.  This does not run on XXX on what? RBC
1638
 
 
1639
 
        TODO: Refuse to remove modified files unless --force is given?
1640
 
 
1641
 
        TODO: Do something useful with directories.
1642
 
 
1643
 
        TODO: Should this remove the text or not?  Tough call; not
1644
 
        removing may be useful and the user can just use use rm, and
1645
 
        is the opposite of add.  Removing it is consistent with most
1646
 
        other tools.  Maybe an option.
 
1226
    def remove(self, files, verbose=False, to_file=None, keep_files=True,
 
1227
        force=False):
 
1228
        """Remove nominated files from the working tree metadata.
 
1229
 
 
1230
        :files: File paths relative to the basedir.
 
1231
        :keep_files: If true, the files will also be kept.
 
1232
        :force: Delete files and directories, even if they are changed and
 
1233
            even if the directories are not empty.
1647
1234
        """
1648
 
        ## TODO: Normalize names
1649
 
        ## TODO: Remove nested loops; better scalability
1650
1235
        if isinstance(files, basestring):
1651
1236
            files = [files]
1652
1237
 
1653
 
        inv = self.inventory
1654
 
 
1655
 
        # do this before any modifications
 
1238
        inv_delta = []
 
1239
 
 
1240
        all_files = set() # specified and nested files 
 
1241
        unknown_nested_files=set()
 
1242
        if to_file is None:
 
1243
            to_file = sys.stdout
 
1244
 
 
1245
        files_to_backup = []
 
1246
 
 
1247
        def recurse_directory_to_add_files(directory):
 
1248
            # Recurse directory and add all files
 
1249
            # so we can check if they have changed.
 
1250
            for parent_info, file_infos in self.walkdirs(directory):
 
1251
                for relpath, basename, kind, lstat, fileid, kind in file_infos:
 
1252
                    # Is it versioned or ignored?
 
1253
                    if self.path2id(relpath):
 
1254
                        # Add nested content for deletion.
 
1255
                        all_files.add(relpath)
 
1256
                    else:
 
1257
                        # Files which are not versioned
 
1258
                        # should be treated as unknown.
 
1259
                        files_to_backup.append(relpath)
 
1260
 
 
1261
        for filename in files:
 
1262
            # Get file name into canonical form.
 
1263
            abspath = self.abspath(filename)
 
1264
            filename = self.relpath(abspath)
 
1265
            if len(filename) > 0:
 
1266
                all_files.add(filename)
 
1267
                recurse_directory_to_add_files(filename)
 
1268
 
 
1269
        files = list(all_files)
 
1270
 
 
1271
        if len(files) == 0:
 
1272
            return # nothing to do
 
1273
 
 
1274
        # Sort needed to first handle directory content before the directory
 
1275
        files.sort(reverse=True)
 
1276
 
 
1277
        # Bail out if we are going to delete files we shouldn't
 
1278
        if not keep_files and not force:
 
1279
            for (file_id, path, content_change, versioned, parent_id, name,
 
1280
                 kind, executable) in self.iter_changes(self.basis_tree(),
 
1281
                     include_unchanged=True, require_versioned=False,
 
1282
                     want_unversioned=True, specific_files=files):
 
1283
                if versioned[0] == False:
 
1284
                    # The record is unknown or newly added
 
1285
                    files_to_backup.append(path[1])
 
1286
                elif (content_change and (kind[1] is not None) and
 
1287
                        osutils.is_inside_any(files, path[1])):
 
1288
                    # Versioned and changed, but not deleted, and still
 
1289
                    # in one of the dirs to be deleted.
 
1290
                    files_to_backup.append(path[1])
 
1291
 
 
1292
        def backup(file_to_backup):
 
1293
            backup_name = self.bzrdir._available_backup_name(file_to_backup)
 
1294
            osutils.rename(abs_path, self.abspath(backup_name))
 
1295
            return "removed %s (but kept a copy: %s)" % (file_to_backup,
 
1296
                                                         backup_name)
 
1297
 
 
1298
        # Build inv_delta and delete files where applicable,
 
1299
        # do this before any modifications to meta data.
1656
1300
        for f in files:
1657
 
            fid = inv.path2id(f)
 
1301
            fid = self.path2id(f)
 
1302
            message = None
1658
1303
            if not fid:
1659
 
                note("%s is not versioned."%f)
 
1304
                message = "%s is not versioned." % (f,)
1660
1305
            else:
1661
1306
                if verbose:
1662
 
                    # having remove it, it must be either ignored or unknown
 
1307
                    # having removed it, it must be either ignored or unknown
1663
1308
                    if self.is_ignored(f):
1664
1309
                        new_status = 'I'
1665
1310
                    else:
1666
1311
                        new_status = '?'
1667
 
                    textui.show_status(new_status, inv[fid].kind, f,
1668
 
                                       to_file=to_file)
1669
 
                del inv[fid]
1670
 
 
1671
 
        self._write_inventory(inv)
 
1312
                    # XXX: Really should be a more abstract reporter interface
 
1313
                    kind_ch = osutils.kind_marker(self.kind(fid))
 
1314
                    to_file.write(new_status + '       ' + f + kind_ch + '\n')
 
1315
                # Unversion file
 
1316
                inv_delta.append((f, None, fid, None))
 
1317
                message = "removed %s" % (f,)
 
1318
 
 
1319
            if not keep_files:
 
1320
                abs_path = self.abspath(f)
 
1321
                if osutils.lexists(abs_path):
 
1322
                    if (osutils.isdir(abs_path) and
 
1323
                        len(os.listdir(abs_path)) > 0):
 
1324
                        if force:
 
1325
                            osutils.rmtree(abs_path)
 
1326
                            message = "deleted %s" % (f,)
 
1327
                        else:
 
1328
                            message = backup(f)
 
1329
                    else:
 
1330
                        if f in files_to_backup:
 
1331
                            message = backup(f)
 
1332
                        else:
 
1333
                            osutils.delete_any(abs_path)
 
1334
                            message = "deleted %s" % (f,)
 
1335
                elif message is not None:
 
1336
                    # Only care if we haven't done anything yet.
 
1337
                    message = "%s does not exist." % (f,)
 
1338
 
 
1339
            # Print only one message (if any) per file.
 
1340
            if message is not None:
 
1341
                note(message)
 
1342
        self.apply_inventory_delta(inv_delta)
1672
1343
 
1673
1344
    @needs_tree_write_lock
1674
 
    def revert(self, filenames, old_tree=None, backups=True, 
1675
 
               pb=DummyProgress(), report_changes=False):
 
1345
    def revert(self, filenames=None, old_tree=None, backups=True,
 
1346
               pb=None, report_changes=False):
1676
1347
        from bzrlib.conflicts import resolve
1677
1348
        if old_tree is None:
1678
 
            old_tree = self.basis_tree()
1679
 
        conflicts = transform.revert(self, old_tree, filenames, backups, pb,
1680
 
                                     report_changes)
1681
 
        if not len(filenames):
1682
 
            self.set_parent_ids(self.get_parent_ids()[:1])
1683
 
            resolve(self)
 
1349
            basis_tree = self.basis_tree()
 
1350
            basis_tree.lock_read()
 
1351
            old_tree = basis_tree
1684
1352
        else:
1685
 
            resolve(self, filenames, ignore_misses=True)
 
1353
            basis_tree = None
 
1354
        try:
 
1355
            conflicts = transform.revert(self, old_tree, filenames, backups, pb,
 
1356
                                         report_changes)
 
1357
            if filenames is None and len(self.get_parent_ids()) > 1:
 
1358
                parent_trees = []
 
1359
                last_revision = self.last_revision()
 
1360
                if last_revision != _mod_revision.NULL_REVISION:
 
1361
                    if basis_tree is None:
 
1362
                        basis_tree = self.basis_tree()
 
1363
                        basis_tree.lock_read()
 
1364
                    parent_trees.append((last_revision, basis_tree))
 
1365
                self.set_parent_trees(parent_trees)
 
1366
                resolve(self)
 
1367
            else:
 
1368
                resolve(self, filenames, ignore_misses=True, recursive=True)
 
1369
        finally:
 
1370
            if basis_tree is not None:
 
1371
                basis_tree.unlock()
1686
1372
        return conflicts
1687
1373
 
1688
1374
    def revision_tree(self, revision_id):
1691
1377
        WorkingTree can supply revision_trees for the basis revision only
1692
1378
        because there is only one cached inventory in the bzr directory.
1693
1379
        """
1694
 
        if revision_id == self.last_revision():
1695
 
            try:
1696
 
                xml = self.read_basis_inventory()
1697
 
            except errors.NoSuchFile:
1698
 
                pass
1699
 
            else:
1700
 
                try:
1701
 
                    inv = xml6.serializer_v6.read_inventory_from_string(xml)
1702
 
                    # dont use the repository revision_tree api because we want
1703
 
                    # to supply the inventory.
1704
 
                    if inv.revision_id == revision_id:
1705
 
                        return revisiontree.RevisionTree(self.branch.repository,
1706
 
                            inv, revision_id)
1707
 
                except errors.BadInventoryFormat:
1708
 
                    pass
1709
 
        # raise if there was no inventory, or if we read the wrong inventory.
1710
 
        raise errors.NoSuchRevisionInTree(self, revision_id)
1711
 
 
1712
 
    # XXX: This method should be deprecated in favour of taking in a proper
1713
 
    # new Inventory object.
1714
 
    @needs_tree_write_lock
1715
 
    def set_inventory(self, new_inventory_list):
1716
 
        from bzrlib.inventory import (Inventory,
1717
 
                                      InventoryDirectory,
1718
 
                                      InventoryEntry,
1719
 
                                      InventoryFile,
1720
 
                                      InventoryLink)
1721
 
        inv = Inventory(self.get_root_id())
1722
 
        for path, file_id, parent, kind in new_inventory_list:
1723
 
            name = os.path.basename(path)
1724
 
            if name == "":
1725
 
                continue
1726
 
            # fixme, there should be a factory function inv,add_?? 
1727
 
            if kind == 'directory':
1728
 
                inv.add(InventoryDirectory(file_id, name, parent))
1729
 
            elif kind == 'file':
1730
 
                inv.add(InventoryFile(file_id, name, parent))
1731
 
            elif kind == 'symlink':
1732
 
                inv.add(InventoryLink(file_id, name, parent))
1733
 
            else:
1734
 
                raise errors.BzrError("unknown kind %r" % kind)
1735
 
        self._write_inventory(inv)
 
1380
        raise NotImplementedError(self.revision_tree)
1736
1381
 
1737
1382
    @needs_tree_write_lock
1738
1383
    def set_root_id(self, file_id):
1739
1384
        """Set the root id for this tree."""
1740
 
        # for compatability 
 
1385
        # for compatability
1741
1386
        if file_id is None:
1742
 
            symbol_versioning.warn(symbol_versioning.zero_twelve
1743
 
                % 'WorkingTree.set_root_id with fileid=None',
1744
 
                DeprecationWarning,
1745
 
                stacklevel=3)
1746
 
            file_id = ROOT_ID
 
1387
            raise ValueError(
 
1388
                'WorkingTree.set_root_id with fileid=None')
 
1389
        file_id = osutils.safe_file_id(file_id)
1747
1390
        self._set_root_id(file_id)
1748
1391
 
1749
1392
    def _set_root_id(self, file_id):
1750
1393
        """Set the root id for this tree, in a format specific manner.
1751
1394
 
1752
 
        :param file_id: The file id to assign to the root. It must not be 
 
1395
        :param file_id: The file id to assign to the root. It must not be
1753
1396
            present in the current inventory or an error will occur. It must
1754
1397
            not be None, but rather a valid file id.
1755
1398
        """
1756
 
        inv = self._inventory
1757
 
        orig_root_id = inv.root.file_id
1758
 
        # TODO: it might be nice to exit early if there was nothing
1759
 
        # to do, saving us from trigger a sync on unlock.
1760
 
        self._inventory_is_modified = True
1761
 
        # we preserve the root inventory entry object, but
1762
 
        # unlinkit from the byid index
1763
 
        del inv._byid[inv.root.file_id]
1764
 
        inv.root.file_id = file_id
1765
 
        # and link it into the index with the new changed id.
1766
 
        inv._byid[inv.root.file_id] = inv.root
1767
 
        # and finally update all children to reference the new id.
1768
 
        # XXX: this should be safe to just look at the root.children
1769
 
        # list, not the WHOLE INVENTORY.
1770
 
        for fid in inv:
1771
 
            entry = inv[fid]
1772
 
            if entry.parent_id == orig_root_id:
1773
 
                entry.parent_id = inv.root.file_id
 
1399
        raise NotImplementedError(self._set_root_id)
1774
1400
 
1775
1401
    def unlock(self):
1776
1402
        """See Branch.unlock.
1777
 
        
 
1403
 
1778
1404
        WorkingTree locking just uses the Branch locking facilities.
1779
1405
        This is current because all working trees have an embedded branch
1780
1406
        within them. IF in the future, we were to make branch data shareable
1781
 
        between multiple working trees, i.e. via shared storage, then we 
 
1407
        between multiple working trees, i.e. via shared storage, then we
1782
1408
        would probably want to lock both the local tree, and the branch.
1783
1409
        """
1784
1410
        raise NotImplementedError(self.unlock)
1785
1411
 
1786
 
    def update(self):
 
1412
    _marker = object()
 
1413
 
 
1414
    def update(self, change_reporter=None, possible_transports=None,
 
1415
               revision=None, old_tip=_marker, show_base=False):
1787
1416
        """Update a working tree along its branch.
1788
1417
 
1789
1418
        This will update the branch if its bound too, which means we have
1804
1433
        - Restore the wt.basis->wt.state changes.
1805
1434
 
1806
1435
        There isn't a single operation at the moment to do that, so we:
 
1436
 
1807
1437
        - Merge current state -> basis tree of the master w.r.t. the old tree
1808
1438
          basis.
1809
1439
        - Do a 'normal' merge of the old branch basis if it is relevant.
 
1440
 
 
1441
        :param revision: The target revision to update to. Must be in the
 
1442
            revision history.
 
1443
        :param old_tip: If branch.update() has already been run, the value it
 
1444
            returned (old tip of the branch or None). _marker is used
 
1445
            otherwise.
1810
1446
        """
1811
 
        if self.branch.get_master_branch() is not None:
 
1447
        if self.branch.get_bound_location() is not None:
1812
1448
            self.lock_write()
1813
 
            update_branch = True
 
1449
            update_branch = (old_tip is self._marker)
1814
1450
        else:
1815
1451
            self.lock_tree_write()
1816
1452
            update_branch = False
1817
1453
        try:
1818
1454
            if update_branch:
1819
 
                old_tip = self.branch.update()
 
1455
                old_tip = self.branch.update(possible_transports)
1820
1456
            else:
1821
 
                old_tip = None
1822
 
            return self._update_tree(old_tip)
 
1457
                if old_tip is self._marker:
 
1458
                    old_tip = None
 
1459
            return self._update_tree(old_tip, change_reporter, revision, show_base)
1823
1460
        finally:
1824
1461
            self.unlock()
1825
1462
 
1826
1463
    @needs_tree_write_lock
1827
 
    def _update_tree(self, old_tip=None):
 
1464
    def _update_tree(self, old_tip=None, change_reporter=None, revision=None,
 
1465
                     show_base=False):
1828
1466
        """Update a tree to the master branch.
1829
1467
 
1830
1468
        :param old_tip: if supplied, the previous tip revision the branch,
1836
1474
        # cant set that until we update the working trees last revision to be
1837
1475
        # one from the new branch, because it will just get absorbed by the
1838
1476
        # parent de-duplication logic.
1839
 
        # 
 
1477
        #
1840
1478
        # We MUST save it even if an error occurs, because otherwise the users
1841
1479
        # local work is unreferenced and will appear to have been lost.
1842
 
        # 
1843
 
        result = 0
 
1480
        #
 
1481
        nb_conflicts = 0
1844
1482
        try:
1845
1483
            last_rev = self.get_parent_ids()[0]
1846
1484
        except IndexError:
1847
 
            last_rev = None
1848
 
        if last_rev != self.branch.last_revision():
1849
 
            # merge tree state up to new branch tip.
 
1485
            last_rev = _mod_revision.NULL_REVISION
 
1486
        if revision is None:
 
1487
            revision = self.branch.last_revision()
 
1488
 
 
1489
        old_tip = old_tip or _mod_revision.NULL_REVISION
 
1490
 
 
1491
        if not _mod_revision.is_null(old_tip) and old_tip != last_rev:
 
1492
            # the branch we are bound to was updated
 
1493
            # merge those changes in first
 
1494
            base_tree  = self.basis_tree()
 
1495
            other_tree = self.branch.repository.revision_tree(old_tip)
 
1496
            nb_conflicts = merge.merge_inner(self.branch, other_tree,
 
1497
                                             base_tree, this_tree=self,
 
1498
                                             change_reporter=change_reporter,
 
1499
                                             show_base=show_base)
 
1500
            if nb_conflicts:
 
1501
                self.add_parent_tree((old_tip, other_tree))
 
1502
                note(gettext('Rerun update after fixing the conflicts.'))
 
1503
                return nb_conflicts
 
1504
 
 
1505
        if last_rev != _mod_revision.ensure_null(revision):
 
1506
            # the working tree is up to date with the branch
 
1507
            # we can merge the specified revision from master
 
1508
            to_tree = self.branch.repository.revision_tree(revision)
 
1509
            to_root_id = to_tree.get_root_id()
 
1510
 
1850
1511
            basis = self.basis_tree()
1851
1512
            basis.lock_read()
1852
1513
            try:
1853
 
                to_tree = self.branch.basis_tree()
1854
 
                if basis.inventory.root is None:
1855
 
                    self.set_root_id(to_tree.inventory.root.file_id)
1856
 
                result += merge.merge_inner(
1857
 
                                      self.branch,
1858
 
                                      to_tree,
1859
 
                                      basis,
1860
 
                                      this_tree=self)
 
1514
                if (basis.get_root_id() is None or basis.get_root_id() != to_root_id):
 
1515
                    self.set_root_id(to_root_id)
 
1516
                    self.flush()
1861
1517
            finally:
1862
1518
                basis.unlock()
 
1519
 
 
1520
            # determine the branch point
 
1521
            graph = self.branch.repository.get_graph()
 
1522
            base_rev_id = graph.find_unique_lca(self.branch.last_revision(),
 
1523
                                                last_rev)
 
1524
            base_tree = self.branch.repository.revision_tree(base_rev_id)
 
1525
 
 
1526
            nb_conflicts = merge.merge_inner(self.branch, to_tree, base_tree,
 
1527
                                             this_tree=self,
 
1528
                                             change_reporter=change_reporter,
 
1529
                                             show_base=show_base)
 
1530
            self.set_last_revision(revision)
1863
1531
            # TODO - dedup parents list with things merged by pull ?
1864
1532
            # reuse the tree we've updated to to set the basis:
1865
 
            parent_trees = [(self.branch.last_revision(), to_tree)]
 
1533
            parent_trees = [(revision, to_tree)]
1866
1534
            merges = self.get_parent_ids()[1:]
1867
1535
            # Ideally we ask the tree for the trees here, that way the working
1868
 
            # tree can decide whether to give us teh entire tree or give us a
 
1536
            # tree can decide whether to give us the entire tree or give us a
1869
1537
            # lazy initialised tree. dirstate for instance will have the trees
1870
1538
            # in ram already, whereas a last-revision + basis-inventory tree
1871
1539
            # will not, but also does not need them when setting parents.
1872
1540
            for parent in merges:
1873
1541
                parent_trees.append(
1874
1542
                    (parent, self.branch.repository.revision_tree(parent)))
1875
 
            if old_tip is not None:
 
1543
            if not _mod_revision.is_null(old_tip):
1876
1544
                parent_trees.append(
1877
1545
                    (old_tip, self.branch.repository.revision_tree(old_tip)))
1878
1546
            self.set_parent_trees(parent_trees)
1879
1547
            last_rev = parent_trees[0][0]
1880
 
        else:
1881
 
            # the working tree had the same last-revision as the master
1882
 
            # branch did. We may still have pivot local work from the local
1883
 
            # branch into old_tip:
1884
 
            if old_tip is not None:
1885
 
                self.add_parent_tree_id(old_tip)
1886
 
        if old_tip and old_tip != last_rev:
1887
 
            # our last revision was not the prior branch last revision
1888
 
            # and we have converted that last revision to a pending merge.
1889
 
            # base is somewhere between the branch tip now
1890
 
            # and the now pending merge
1891
 
 
1892
 
            # Since we just modified the working tree and inventory, flush out
1893
 
            # the current state, before we modify it again.
1894
 
            # TODO: jam 20070214 WorkingTree3 doesn't require this, dirstate
1895
 
            #       requires it only because TreeTransform directly munges the
1896
 
            #       inventory and calls tree._write_inventory(). Ultimately we
1897
 
            #       should be able to remove this extra flush.
1898
 
            self.flush()
1899
 
            from bzrlib.revision import common_ancestor
1900
 
            try:
1901
 
                base_rev_id = common_ancestor(self.branch.last_revision(),
1902
 
                                              old_tip,
1903
 
                                              self.branch.repository)
1904
 
            except errors.NoCommonAncestor:
1905
 
                base_rev_id = None
1906
 
            base_tree = self.branch.repository.revision_tree(base_rev_id)
1907
 
            other_tree = self.branch.repository.revision_tree(old_tip)
1908
 
            result += merge.merge_inner(
1909
 
                                  self.branch,
1910
 
                                  other_tree,
1911
 
                                  base_tree,
1912
 
                                  this_tree=self)
1913
 
        return result
1914
 
 
1915
 
    def _write_hashcache_if_dirty(self):
1916
 
        """Write out the hashcache if it is dirty."""
1917
 
        if self._hashcache.needs_write:
1918
 
            try:
1919
 
                self._hashcache.write()
1920
 
            except OSError, e:
1921
 
                if e.errno not in (errno.EPERM, errno.EACCES):
1922
 
                    raise
1923
 
                # TODO: jam 20061219 Should this be a warning? A single line
1924
 
                #       warning might be sufficient to let the user know what
1925
 
                #       is going on.
1926
 
                mutter('Could not write hashcache for %s\nError: %s',
1927
 
                       self._hashcache.cache_file_name(), e)
1928
 
 
1929
 
    @needs_tree_write_lock
1930
 
    def _write_inventory(self, inv):
1931
 
        """Write inventory as the current inventory."""
1932
 
        self._set_inventory(inv, dirty=True)
1933
 
        self.flush()
 
1548
        return nb_conflicts
1934
1549
 
1935
1550
    def set_conflicts(self, arg):
1936
1551
        raise errors.UnsupportedOperation(self.set_conflicts, self)
1938
1553
    def add_conflicts(self, arg):
1939
1554
        raise errors.UnsupportedOperation(self.add_conflicts, self)
1940
1555
 
1941
 
    @needs_read_lock
1942
1556
    def conflicts(self):
1943
 
        conflicts = _mod_conflicts.ConflictList()
1944
 
        for conflicted in self._iter_conflicts():
1945
 
            text = True
1946
 
            try:
1947
 
                if file_kind(self.abspath(conflicted)) != "file":
1948
 
                    text = False
1949
 
            except errors.NoSuchFile:
1950
 
                text = False
1951
 
            if text is True:
1952
 
                for suffix in ('.THIS', '.OTHER'):
1953
 
                    try:
1954
 
                        kind = file_kind(self.abspath(conflicted+suffix))
1955
 
                        if kind != "file":
1956
 
                            text = False
1957
 
                    except errors.NoSuchFile:
1958
 
                        text = False
1959
 
                    if text == False:
1960
 
                        break
1961
 
            ctype = {True: 'text conflict', False: 'contents conflict'}[text]
1962
 
            conflicts.append(_mod_conflicts.Conflict.factory(ctype,
1963
 
                             path=conflicted,
1964
 
                             file_id=self.path2id(conflicted)))
1965
 
        return conflicts
 
1557
        raise NotImplementedError(self.conflicts)
1966
1558
 
1967
1559
    def walkdirs(self, prefix=""):
1968
1560
        """Walk the directories of this tree.
1969
1561
 
 
1562
        returns a generator which yields items in the form:
 
1563
                ((curren_directory_path, fileid),
 
1564
                 [(file1_path, file1_name, file1_kind, (lstat), file1_id,
 
1565
                   file1_kind), ... ])
 
1566
 
1970
1567
        This API returns a generator, which is only valid during the current
1971
1568
        tree transaction - within a single lock_read or lock_write duration.
1972
1569
 
1973
 
        If the tree is not locked, it may cause an error to be raised, depending
1974
 
        on the tree implementation.
 
1570
        If the tree is not locked, it may cause an error to be raised,
 
1571
        depending on the tree implementation.
1975
1572
        """
1976
1573
        disk_top = self.abspath(prefix)
1977
1574
        if disk_top.endswith('/'):
1983
1580
            current_disk = disk_iterator.next()
1984
1581
            disk_finished = False
1985
1582
        except OSError, e:
1986
 
            if e.errno != errno.ENOENT:
 
1583
            if not (e.errno == errno.ENOENT or
 
1584
                (sys.platform == 'win32' and e.errno == ERROR_PATH_NOT_FOUND)):
1987
1585
                raise
1988
1586
            current_disk = None
1989
1587
            disk_finished = True
1994
1592
            current_inv = None
1995
1593
            inv_finished = True
1996
1594
        while not inv_finished or not disk_finished:
 
1595
            if current_disk:
 
1596
                ((cur_disk_dir_relpath, cur_disk_dir_path_from_top),
 
1597
                    cur_disk_dir_content) = current_disk
 
1598
            else:
 
1599
                ((cur_disk_dir_relpath, cur_disk_dir_path_from_top),
 
1600
                    cur_disk_dir_content) = ((None, None), None)
1997
1601
            if not disk_finished:
1998
1602
                # strip out .bzr dirs
1999
 
                if current_disk[0][1][top_strip_len:] == '':
2000
 
                    # osutils.walkdirs can be made nicer - 
 
1603
                if (cur_disk_dir_path_from_top[top_strip_len:] == '' and
 
1604
                    len(cur_disk_dir_content) > 0):
 
1605
                    # osutils.walkdirs can be made nicer -
2001
1606
                    # yield the path-from-prefix rather than the pathjoined
2002
1607
                    # value.
2003
 
                    bzrdir_loc = bisect_left(current_disk[1], ('.bzr', '.bzr'))
2004
 
                    if current_disk[1][bzrdir_loc][0] == '.bzr':
 
1608
                    bzrdir_loc = bisect_left(cur_disk_dir_content,
 
1609
                        ('.bzr', '.bzr'))
 
1610
                    if (bzrdir_loc < len(cur_disk_dir_content)
 
1611
                        and self.bzrdir.is_control_filename(
 
1612
                            cur_disk_dir_content[bzrdir_loc][0])):
2005
1613
                        # we dont yield the contents of, or, .bzr itself.
2006
 
                        del current_disk[1][bzrdir_loc]
 
1614
                        del cur_disk_dir_content[bzrdir_loc]
2007
1615
            if inv_finished:
2008
1616
                # everything is unknown
2009
1617
                direction = 1
2011
1619
                # everything is missing
2012
1620
                direction = -1
2013
1621
            else:
2014
 
                direction = cmp(current_inv[0][0], current_disk[0][0])
 
1622
                direction = cmp(current_inv[0][0], cur_disk_dir_relpath)
2015
1623
            if direction > 0:
2016
1624
                # disk is before inventory - unknown
2017
1625
                dirblock = [(relpath, basename, kind, stat, None, None) for
2018
 
                    relpath, basename, kind, stat, top_path in current_disk[1]]
2019
 
                yield (current_disk[0][0], None), dirblock
 
1626
                    relpath, basename, kind, stat, top_path in
 
1627
                    cur_disk_dir_content]
 
1628
                yield (cur_disk_dir_relpath, None), dirblock
2020
1629
                try:
2021
1630
                    current_disk = disk_iterator.next()
2022
1631
                except StopIteration:
2024
1633
            elif direction < 0:
2025
1634
                # inventory is before disk - missing.
2026
1635
                dirblock = [(relpath, basename, 'unknown', None, fileid, kind)
2027
 
                    for relpath, basename, dkind, stat, fileid, kind in 
 
1636
                    for relpath, basename, dkind, stat, fileid, kind in
2028
1637
                    current_inv[1]]
2029
1638
                yield (current_inv[0][0], current_inv[0][1]), dirblock
2030
1639
                try:
2036
1645
                # merge the inventory and disk data together
2037
1646
                dirblock = []
2038
1647
                for relpath, subiterator in itertools.groupby(sorted(
2039
 
                    current_inv[1] + current_disk[1], key=operator.itemgetter(0)), operator.itemgetter(1)):
 
1648
                    current_inv[1] + cur_disk_dir_content,
 
1649
                    key=operator.itemgetter(0)), operator.itemgetter(1)):
2040
1650
                    path_elements = list(subiterator)
2041
1651
                    if len(path_elements) == 2:
2042
1652
                        inv_row, disk_row = path_elements
2068
1678
                    disk_finished = True
2069
1679
 
2070
1680
    def _walkdirs(self, prefix=""):
 
1681
        """Walk the directories of this tree.
 
1682
 
 
1683
        :param prefix: is used as the directrory to start with.
 
1684
        :returns: a generator which yields items in the form::
 
1685
 
 
1686
            ((curren_directory_path, fileid),
 
1687
             [(file1_path, file1_name, file1_kind, None, file1_id,
 
1688
               file1_kind), ... ])
 
1689
        """
 
1690
        raise NotImplementedError(self._walkdirs)
 
1691
 
 
1692
    @needs_tree_write_lock
 
1693
    def auto_resolve(self):
 
1694
        """Automatically resolve text conflicts according to contents.
 
1695
 
 
1696
        Only text conflicts are auto_resolvable. Files with no conflict markers
 
1697
        are considered 'resolved', because bzr always puts conflict markers
 
1698
        into files that have text conflicts.  The corresponding .THIS .BASE and
 
1699
        .OTHER files are deleted, as per 'resolve'.
 
1700
 
 
1701
        :return: a tuple of ConflictLists: (un_resolved, resolved).
 
1702
        """
 
1703
        un_resolved = _mod_conflicts.ConflictList()
 
1704
        resolved = _mod_conflicts.ConflictList()
 
1705
        conflict_re = re.compile('^(<{7}|={7}|>{7})')
 
1706
        for conflict in self.conflicts():
 
1707
            if (conflict.typestring != 'text conflict' or
 
1708
                self.kind(conflict.file_id) != 'file'):
 
1709
                un_resolved.append(conflict)
 
1710
                continue
 
1711
            my_file = open(self.id2abspath(conflict.file_id), 'rb')
 
1712
            try:
 
1713
                for line in my_file:
 
1714
                    if conflict_re.search(line):
 
1715
                        un_resolved.append(conflict)
 
1716
                        break
 
1717
                else:
 
1718
                    resolved.append(conflict)
 
1719
            finally:
 
1720
                my_file.close()
 
1721
        resolved.remove_files(self)
 
1722
        self.set_conflicts(un_resolved)
 
1723
        return un_resolved, resolved
 
1724
 
 
1725
    def _validate(self):
 
1726
        """Validate internal structures.
 
1727
 
 
1728
        This is meant mostly for the test suite. To give it a chance to detect
 
1729
        corruption after actions have occurred. The default implementation is a
 
1730
        just a no-op.
 
1731
 
 
1732
        :return: None. An exception should be raised if there is an error.
 
1733
        """
 
1734
        return
 
1735
 
 
1736
    def check_state(self):
 
1737
        """Check that the working state is/isn't valid."""
 
1738
        raise NotImplementedError(self.check_state)
 
1739
 
 
1740
    def reset_state(self, revision_ids=None):
 
1741
        """Reset the state of the working tree.
 
1742
 
 
1743
        This does a hard-reset to a last-known-good state. This is a way to
 
1744
        fix if something got corrupted (like the .bzr/checkout/dirstate file)
 
1745
        """
 
1746
        raise NotImplementedError(self.reset_state)
 
1747
 
 
1748
    def _get_rules_searcher(self, default_searcher):
 
1749
        """See Tree._get_rules_searcher."""
 
1750
        if self._rules_searcher is None:
 
1751
            self._rules_searcher = super(WorkingTree,
 
1752
                self)._get_rules_searcher(default_searcher)
 
1753
        return self._rules_searcher
 
1754
 
 
1755
    def get_shelf_manager(self):
 
1756
        """Return the ShelfManager for this WorkingTree."""
 
1757
        from bzrlib.shelf import ShelfManager
 
1758
        return ShelfManager(self, self._transport)
 
1759
 
 
1760
 
 
1761
class InventoryWorkingTree(WorkingTree,
 
1762
        bzrlib.mutabletree.MutableInventoryTree):
 
1763
    """Base class for working trees that are inventory-oriented.
 
1764
 
 
1765
    The inventory is held in the `Branch` working-inventory, and the
 
1766
    files are in a directory on disk.
 
1767
 
 
1768
    It is possible for a `WorkingTree` to have a filename which is
 
1769
    not listed in the Inventory and vice versa.
 
1770
    """
 
1771
 
 
1772
    def __init__(self, basedir='.',
 
1773
                 branch=DEPRECATED_PARAMETER,
 
1774
                 _inventory=None,
 
1775
                 _control_files=None,
 
1776
                 _internal=False,
 
1777
                 _format=None,
 
1778
                 _bzrdir=None):
 
1779
        """Construct a InventoryWorkingTree instance. This is not a public API.
 
1780
 
 
1781
        :param branch: A branch to override probing for the branch.
 
1782
        """
 
1783
        super(InventoryWorkingTree, self).__init__(basedir=basedir,
 
1784
            branch=branch, _control_files=_control_files, _internal=_internal,
 
1785
            _format=_format, _bzrdir=_bzrdir)
 
1786
 
 
1787
        self._detect_case_handling()
 
1788
 
 
1789
        if _inventory is None:
 
1790
            # This will be acquired on lock_read() or lock_write()
 
1791
            self._inventory_is_modified = False
 
1792
            self._inventory = None
 
1793
        else:
 
1794
            # the caller of __init__ has provided an inventory,
 
1795
            # we assume they know what they are doing - as its only
 
1796
            # the Format factory and creation methods that are
 
1797
            # permitted to do this.
 
1798
            self._set_inventory(_inventory, dirty=False)
 
1799
 
 
1800
    def _set_inventory(self, inv, dirty):
 
1801
        """Set the internal cached inventory.
 
1802
 
 
1803
        :param inv: The inventory to set.
 
1804
        :param dirty: A boolean indicating whether the inventory is the same
 
1805
            logical inventory as whats on disk. If True the inventory is not
 
1806
            the same and should be written to disk or data will be lost, if
 
1807
            False then the inventory is the same as that on disk and any
 
1808
            serialisation would be unneeded overhead.
 
1809
        """
 
1810
        self._inventory = inv
 
1811
        self._inventory_is_modified = dirty
 
1812
 
 
1813
    def _detect_case_handling(self):
 
1814
        wt_trans = self.bzrdir.get_workingtree_transport(None)
 
1815
        try:
 
1816
            wt_trans.stat(self._format.case_sensitive_filename)
 
1817
        except errors.NoSuchFile:
 
1818
            self.case_sensitive = True
 
1819
        else:
 
1820
            self.case_sensitive = False
 
1821
 
 
1822
        self._setup_directory_is_tree_reference()
 
1823
 
 
1824
    def _serialize(self, inventory, out_file):
 
1825
        xml5.serializer_v5.write_inventory(self._inventory, out_file,
 
1826
            working=True)
 
1827
 
 
1828
    def _deserialize(selt, in_file):
 
1829
        return xml5.serializer_v5.read_inventory(in_file)
 
1830
 
 
1831
    @needs_tree_write_lock
 
1832
    def _write_inventory(self, inv):
 
1833
        """Write inventory as the current inventory."""
 
1834
        self._set_inventory(inv, dirty=True)
 
1835
        self.flush()
 
1836
 
 
1837
    # XXX: This method should be deprecated in favour of taking in a proper
 
1838
    # new Inventory object.
 
1839
    @needs_tree_write_lock
 
1840
    def set_inventory(self, new_inventory_list):
 
1841
        from bzrlib.inventory import (Inventory,
 
1842
                                      InventoryDirectory,
 
1843
                                      InventoryFile,
 
1844
                                      InventoryLink)
 
1845
        inv = Inventory(self.get_root_id())
 
1846
        for path, file_id, parent, kind in new_inventory_list:
 
1847
            name = os.path.basename(path)
 
1848
            if name == "":
 
1849
                continue
 
1850
            # fixme, there should be a factory function inv,add_??
 
1851
            if kind == 'directory':
 
1852
                inv.add(InventoryDirectory(file_id, name, parent))
 
1853
            elif kind == 'file':
 
1854
                inv.add(InventoryFile(file_id, name, parent))
 
1855
            elif kind == 'symlink':
 
1856
                inv.add(InventoryLink(file_id, name, parent))
 
1857
            else:
 
1858
                raise errors.BzrError("unknown kind %r" % kind)
 
1859
        self._write_inventory(inv)
 
1860
 
 
1861
    def _write_basis_inventory(self, xml):
 
1862
        """Write the basis inventory XML to the basis-inventory file"""
 
1863
        path = self._basis_inventory_name()
 
1864
        sio = StringIO(xml)
 
1865
        self._transport.put_file(path, sio,
 
1866
            mode=self.bzrdir._get_file_mode())
 
1867
 
 
1868
    def _reset_data(self):
 
1869
        """Reset transient data that cannot be revalidated."""
 
1870
        self._inventory_is_modified = False
 
1871
        f = self._transport.get('inventory')
 
1872
        try:
 
1873
            result = self._deserialize(f)
 
1874
        finally:
 
1875
            f.close()
 
1876
        self._set_inventory(result, dirty=False)
 
1877
 
 
1878
    def _set_root_id(self, file_id):
 
1879
        """Set the root id for this tree, in a format specific manner.
 
1880
 
 
1881
        :param file_id: The file id to assign to the root. It must not be
 
1882
            present in the current inventory or an error will occur. It must
 
1883
            not be None, but rather a valid file id.
 
1884
        """
 
1885
        inv = self._inventory
 
1886
        orig_root_id = inv.root.file_id
 
1887
        # TODO: it might be nice to exit early if there was nothing
 
1888
        # to do, saving us from trigger a sync on unlock.
 
1889
        self._inventory_is_modified = True
 
1890
        # we preserve the root inventory entry object, but
 
1891
        # unlinkit from the byid index
 
1892
        del inv._byid[inv.root.file_id]
 
1893
        inv.root.file_id = file_id
 
1894
        # and link it into the index with the new changed id.
 
1895
        inv._byid[inv.root.file_id] = inv.root
 
1896
        # and finally update all children to reference the new id.
 
1897
        # XXX: this should be safe to just look at the root.children
 
1898
        # list, not the WHOLE INVENTORY.
 
1899
        for fid in inv:
 
1900
            entry = inv[fid]
 
1901
            if entry.parent_id == orig_root_id:
 
1902
                entry.parent_id = inv.root.file_id
 
1903
 
 
1904
    def all_file_ids(self):
 
1905
        """See Tree.iter_all_file_ids"""
 
1906
        return set(self.inventory)
 
1907
 
 
1908
    @needs_tree_write_lock
 
1909
    def set_parent_trees(self, parents_list, allow_leftmost_as_ghost=False):
 
1910
        """See MutableTree.set_parent_trees."""
 
1911
        parent_ids = [rev for (rev, tree) in parents_list]
 
1912
        for revision_id in parent_ids:
 
1913
            _mod_revision.check_not_reserved_id(revision_id)
 
1914
 
 
1915
        self._check_parents_for_ghosts(parent_ids,
 
1916
            allow_leftmost_as_ghost=allow_leftmost_as_ghost)
 
1917
 
 
1918
        parent_ids = self._filter_parent_ids_by_ancestry(parent_ids)
 
1919
 
 
1920
        if len(parent_ids) == 0:
 
1921
            leftmost_parent_id = _mod_revision.NULL_REVISION
 
1922
            leftmost_parent_tree = None
 
1923
        else:
 
1924
            leftmost_parent_id, leftmost_parent_tree = parents_list[0]
 
1925
 
 
1926
        if self._change_last_revision(leftmost_parent_id):
 
1927
            if leftmost_parent_tree is None:
 
1928
                # If we don't have a tree, fall back to reading the
 
1929
                # parent tree from the repository.
 
1930
                self._cache_basis_inventory(leftmost_parent_id)
 
1931
            else:
 
1932
                inv = leftmost_parent_tree.inventory
 
1933
                xml = self._create_basis_xml_from_inventory(
 
1934
                                        leftmost_parent_id, inv)
 
1935
                self._write_basis_inventory(xml)
 
1936
        self._set_merges_from_parent_ids(parent_ids)
 
1937
 
 
1938
    def _cache_basis_inventory(self, new_revision):
 
1939
        """Cache new_revision as the basis inventory."""
 
1940
        # TODO: this should allow the ready-to-use inventory to be passed in,
 
1941
        # as commit already has that ready-to-use [while the format is the
 
1942
        # same, that is].
 
1943
        try:
 
1944
            # this double handles the inventory - unpack and repack -
 
1945
            # but is easier to understand. We can/should put a conditional
 
1946
            # in here based on whether the inventory is in the latest format
 
1947
            # - perhaps we should repack all inventories on a repository
 
1948
            # upgrade ?
 
1949
            # the fast path is to copy the raw xml from the repository. If the
 
1950
            # xml contains 'revision_id="', then we assume the right
 
1951
            # revision_id is set. We must check for this full string, because a
 
1952
            # root node id can legitimately look like 'revision_id' but cannot
 
1953
            # contain a '"'.
 
1954
            xml = self.branch.repository._get_inventory_xml(new_revision)
 
1955
            firstline = xml.split('\n', 1)[0]
 
1956
            if (not 'revision_id="' in firstline or
 
1957
                'format="7"' not in firstline):
 
1958
                inv = self.branch.repository._serializer.read_inventory_from_string(
 
1959
                    xml, new_revision)
 
1960
                xml = self._create_basis_xml_from_inventory(new_revision, inv)
 
1961
            self._write_basis_inventory(xml)
 
1962
        except (errors.NoSuchRevision, errors.RevisionNotPresent):
 
1963
            pass
 
1964
 
 
1965
    def _basis_inventory_name(self):
 
1966
        return 'basis-inventory-cache'
 
1967
 
 
1968
    def _create_basis_xml_from_inventory(self, revision_id, inventory):
 
1969
        """Create the text that will be saved in basis-inventory"""
 
1970
        inventory.revision_id = revision_id
 
1971
        return xml7.serializer_v7.write_inventory_to_string(inventory)
 
1972
 
 
1973
    @needs_tree_write_lock
 
1974
    def set_conflicts(self, conflicts):
 
1975
        self._put_rio('conflicts', conflicts.to_stanzas(),
 
1976
                      CONFLICT_HEADER_1)
 
1977
 
 
1978
    @needs_tree_write_lock
 
1979
    def add_conflicts(self, new_conflicts):
 
1980
        conflict_set = set(self.conflicts())
 
1981
        conflict_set.update(set(list(new_conflicts)))
 
1982
        self.set_conflicts(_mod_conflicts.ConflictList(sorted(conflict_set,
 
1983
                                       key=_mod_conflicts.Conflict.sort_key)))
 
1984
 
 
1985
    @needs_read_lock
 
1986
    def conflicts(self):
 
1987
        try:
 
1988
            confile = self._transport.get('conflicts')
 
1989
        except errors.NoSuchFile:
 
1990
            return _mod_conflicts.ConflictList()
 
1991
        try:
 
1992
            try:
 
1993
                if confile.next() != CONFLICT_HEADER_1 + '\n':
 
1994
                    raise errors.ConflictFormatError()
 
1995
            except StopIteration:
 
1996
                raise errors.ConflictFormatError()
 
1997
            reader = _mod_rio.RioReader(confile)
 
1998
            return _mod_conflicts.ConflictList.from_stanzas(reader)
 
1999
        finally:
 
2000
            confile.close()
 
2001
 
 
2002
    def read_basis_inventory(self):
 
2003
        """Read the cached basis inventory."""
 
2004
        path = self._basis_inventory_name()
 
2005
        return self._transport.get_bytes(path)
 
2006
 
 
2007
    @needs_read_lock
 
2008
    def read_working_inventory(self):
 
2009
        """Read the working inventory.
 
2010
 
 
2011
        :raises errors.InventoryModified: read_working_inventory will fail
 
2012
            when the current in memory inventory has been modified.
 
2013
        """
 
2014
        # conceptually this should be an implementation detail of the tree.
 
2015
        # XXX: Deprecate this.
 
2016
        # ElementTree does its own conversion from UTF-8, so open in
 
2017
        # binary.
 
2018
        if self._inventory_is_modified:
 
2019
            raise errors.InventoryModified(self)
 
2020
        f = self._transport.get('inventory')
 
2021
        try:
 
2022
            result = self._deserialize(f)
 
2023
        finally:
 
2024
            f.close()
 
2025
        self._set_inventory(result, dirty=False)
 
2026
        return result
 
2027
 
 
2028
    @needs_read_lock
 
2029
    def get_root_id(self):
 
2030
        """Return the id of this trees root"""
 
2031
        return self._inventory.root.file_id
 
2032
 
 
2033
    def has_id(self, file_id):
 
2034
        # files that have been deleted are excluded
 
2035
        inv = self.inventory
 
2036
        if not inv.has_id(file_id):
 
2037
            return False
 
2038
        path = inv.id2path(file_id)
 
2039
        return osutils.lexists(self.abspath(path))
 
2040
 
 
2041
    def has_or_had_id(self, file_id):
 
2042
        if file_id == self.inventory.root.file_id:
 
2043
            return True
 
2044
        return self.inventory.has_id(file_id)
 
2045
 
 
2046
    @symbol_versioning.deprecated_method(symbol_versioning.deprecated_in((2, 4, 0)))
 
2047
    def __iter__(self):
 
2048
        """Iterate through file_ids for this tree.
 
2049
 
 
2050
        file_ids are in a WorkingTree if they are in the working inventory
 
2051
        and the working file exists.
 
2052
        """
 
2053
        inv = self._inventory
 
2054
        for path, ie in inv.iter_entries():
 
2055
            if osutils.lexists(self.abspath(path)):
 
2056
                yield ie.file_id
 
2057
 
 
2058
    @needs_tree_write_lock
 
2059
    def set_last_revision(self, new_revision):
 
2060
        """Change the last revision in the working tree."""
 
2061
        if self._change_last_revision(new_revision):
 
2062
            self._cache_basis_inventory(new_revision)
 
2063
 
 
2064
    def _get_check_refs(self):
 
2065
        """Return the references needed to perform a check of this tree.
 
2066
        
 
2067
        The default implementation returns no refs, and is only suitable for
 
2068
        trees that have no local caching and can commit on ghosts at any time.
 
2069
 
 
2070
        :seealso: bzrlib.check for details about check_refs.
 
2071
        """
 
2072
        return []
 
2073
 
 
2074
    @needs_read_lock
 
2075
    def _check(self, references):
 
2076
        """Check the tree for consistency.
 
2077
 
 
2078
        :param references: A dict with keys matching the items returned by
 
2079
            self._get_check_refs(), and values from looking those keys up in
 
2080
            the repository.
 
2081
        """
 
2082
        tree_basis = self.basis_tree()
 
2083
        tree_basis.lock_read()
 
2084
        try:
 
2085
            repo_basis = references[('trees', self.last_revision())]
 
2086
            if len(list(repo_basis.iter_changes(tree_basis))) > 0:
 
2087
                raise errors.BzrCheckError(
 
2088
                    "Mismatched basis inventory content.")
 
2089
            self._validate()
 
2090
        finally:
 
2091
            tree_basis.unlock()
 
2092
 
 
2093
    @needs_read_lock
 
2094
    def check_state(self):
 
2095
        """Check that the working state is/isn't valid."""
 
2096
        check_refs = self._get_check_refs()
 
2097
        refs = {}
 
2098
        for ref in check_refs:
 
2099
            kind, value = ref
 
2100
            if kind == 'trees':
 
2101
                refs[ref] = self.branch.repository.revision_tree(value)
 
2102
        self._check(refs)
 
2103
 
 
2104
    @needs_tree_write_lock
 
2105
    def reset_state(self, revision_ids=None):
 
2106
        """Reset the state of the working tree.
 
2107
 
 
2108
        This does a hard-reset to a last-known-good state. This is a way to
 
2109
        fix if something got corrupted (like the .bzr/checkout/dirstate file)
 
2110
        """
 
2111
        if revision_ids is None:
 
2112
            revision_ids = self.get_parent_ids()
 
2113
        if not revision_ids:
 
2114
            rt = self.branch.repository.revision_tree(
 
2115
                _mod_revision.NULL_REVISION)
 
2116
        else:
 
2117
            rt = self.branch.repository.revision_tree(revision_ids[0])
 
2118
        self._write_inventory(rt.inventory)
 
2119
        self.set_parent_ids(revision_ids)
 
2120
 
 
2121
    def flush(self):
 
2122
        """Write the in memory inventory to disk."""
 
2123
        # TODO: Maybe this should only write on dirty ?
 
2124
        if self._control_files._lock_mode != 'w':
 
2125
            raise errors.NotWriteLocked(self)
 
2126
        sio = StringIO()
 
2127
        self._serialize(self._inventory, sio)
 
2128
        sio.seek(0)
 
2129
        self._transport.put_file('inventory', sio,
 
2130
            mode=self.bzrdir._get_file_mode())
 
2131
        self._inventory_is_modified = False
 
2132
 
 
2133
    def get_file_mtime(self, file_id, path=None):
 
2134
        """See Tree.get_file_mtime."""
 
2135
        if not path:
 
2136
            path = self.inventory.id2path(file_id)
 
2137
        try:
 
2138
            return os.lstat(self.abspath(path)).st_mtime
 
2139
        except OSError, e:
 
2140
            if e.errno == errno.ENOENT:
 
2141
                raise errors.FileTimestampUnavailable(path)
 
2142
            raise
 
2143
 
 
2144
    def _is_executable_from_path_and_stat_from_basis(self, path, stat_result):
 
2145
        file_id = self.path2id(path)
 
2146
        if file_id is None:
 
2147
            # For unversioned files on win32, we just assume they are not
 
2148
            # executable
 
2149
            return False
 
2150
        return self._inventory[file_id].executable
 
2151
 
 
2152
    def _is_executable_from_path_and_stat_from_stat(self, path, stat_result):
 
2153
        mode = stat_result.st_mode
 
2154
        return bool(stat.S_ISREG(mode) and stat.S_IEXEC & mode)
 
2155
 
 
2156
    if not supports_executable():
 
2157
        def is_executable(self, file_id, path=None):
 
2158
            return self._inventory[file_id].executable
 
2159
 
 
2160
        _is_executable_from_path_and_stat = \
 
2161
            _is_executable_from_path_and_stat_from_basis
 
2162
    else:
 
2163
        def is_executable(self, file_id, path=None):
 
2164
            if not path:
 
2165
                path = self.id2path(file_id)
 
2166
            mode = os.lstat(self.abspath(path)).st_mode
 
2167
            return bool(stat.S_ISREG(mode) and stat.S_IEXEC & mode)
 
2168
 
 
2169
        _is_executable_from_path_and_stat = \
 
2170
            _is_executable_from_path_and_stat_from_stat
 
2171
 
 
2172
    @needs_tree_write_lock
 
2173
    def _add(self, files, ids, kinds):
 
2174
        """See MutableTree._add."""
 
2175
        # TODO: Re-adding a file that is removed in the working copy
 
2176
        # should probably put it back with the previous ID.
 
2177
        # the read and write working inventory should not occur in this
 
2178
        # function - they should be part of lock_write and unlock.
 
2179
        inv = self.inventory
 
2180
        for f, file_id, kind in zip(files, ids, kinds):
 
2181
            if file_id is None:
 
2182
                inv.add_path(f, kind=kind)
 
2183
            else:
 
2184
                inv.add_path(f, kind=kind, file_id=file_id)
 
2185
            self._inventory_is_modified = True
 
2186
 
 
2187
    def revision_tree(self, revision_id):
 
2188
        """See WorkingTree.revision_id."""
 
2189
        if revision_id == self.last_revision():
 
2190
            try:
 
2191
                xml = self.read_basis_inventory()
 
2192
            except errors.NoSuchFile:
 
2193
                pass
 
2194
            else:
 
2195
                try:
 
2196
                    inv = xml7.serializer_v7.read_inventory_from_string(xml)
 
2197
                    # dont use the repository revision_tree api because we want
 
2198
                    # to supply the inventory.
 
2199
                    if inv.revision_id == revision_id:
 
2200
                        return revisiontree.InventoryRevisionTree(
 
2201
                            self.branch.repository, inv, revision_id)
 
2202
                except errors.BadInventoryFormat:
 
2203
                    pass
 
2204
        # raise if there was no inventory, or if we read the wrong inventory.
 
2205
        raise errors.NoSuchRevisionInTree(self, revision_id)
 
2206
 
 
2207
    @needs_read_lock
 
2208
    def annotate_iter(self, file_id, default_revision=CURRENT_REVISION):
 
2209
        """See Tree.annotate_iter
 
2210
 
 
2211
        This implementation will use the basis tree implementation if possible.
 
2212
        Lines not in the basis are attributed to CURRENT_REVISION
 
2213
 
 
2214
        If there are pending merges, lines added by those merges will be
 
2215
        incorrectly attributed to CURRENT_REVISION (but after committing, the
 
2216
        attribution will be correct).
 
2217
        """
 
2218
        maybe_file_parent_keys = []
 
2219
        for parent_id in self.get_parent_ids():
 
2220
            try:
 
2221
                parent_tree = self.revision_tree(parent_id)
 
2222
            except errors.NoSuchRevisionInTree:
 
2223
                parent_tree = self.branch.repository.revision_tree(parent_id)
 
2224
            parent_tree.lock_read()
 
2225
            try:
 
2226
                if not parent_tree.has_id(file_id):
 
2227
                    continue
 
2228
                ie = parent_tree.inventory[file_id]
 
2229
                if ie.kind != 'file':
 
2230
                    # Note: this is slightly unnecessary, because symlinks and
 
2231
                    # directories have a "text" which is the empty text, and we
 
2232
                    # know that won't mess up annotations. But it seems cleaner
 
2233
                    continue
 
2234
                parent_text_key = (file_id, ie.revision)
 
2235
                if parent_text_key not in maybe_file_parent_keys:
 
2236
                    maybe_file_parent_keys.append(parent_text_key)
 
2237
            finally:
 
2238
                parent_tree.unlock()
 
2239
        graph = _mod_graph.Graph(self.branch.repository.texts)
 
2240
        heads = graph.heads(maybe_file_parent_keys)
 
2241
        file_parent_keys = []
 
2242
        for key in maybe_file_parent_keys:
 
2243
            if key in heads:
 
2244
                file_parent_keys.append(key)
 
2245
 
 
2246
        # Now we have the parents of this content
 
2247
        annotator = self.branch.repository.texts.get_annotator()
 
2248
        text = self.get_file_text(file_id)
 
2249
        this_key =(file_id, default_revision)
 
2250
        annotator.add_special_text(this_key, file_parent_keys, text)
 
2251
        annotations = [(key[-1], line)
 
2252
                       for key, line in annotator.annotate_flat(this_key)]
 
2253
        return annotations
 
2254
 
 
2255
    @needs_read_lock
 
2256
    def merge_modified(self):
 
2257
        """Return a dictionary of files modified by a merge.
 
2258
 
 
2259
        The list is initialized by WorkingTree.set_merge_modified, which is
 
2260
        typically called after we make some automatic updates to the tree
 
2261
        because of a merge.
 
2262
 
 
2263
        This returns a map of file_id->sha1, containing only files which are
 
2264
        still in the working inventory and have that text hash.
 
2265
        """
 
2266
        try:
 
2267
            hashfile = self._transport.get('merge-hashes')
 
2268
        except errors.NoSuchFile:
 
2269
            return {}
 
2270
        try:
 
2271
            merge_hashes = {}
 
2272
            try:
 
2273
                if hashfile.next() != MERGE_MODIFIED_HEADER_1 + '\n':
 
2274
                    raise errors.MergeModifiedFormatError()
 
2275
            except StopIteration:
 
2276
                raise errors.MergeModifiedFormatError()
 
2277
            for s in _mod_rio.RioReader(hashfile):
 
2278
                # RioReader reads in Unicode, so convert file_ids back to utf8
 
2279
                file_id = osutils.safe_file_id(s.get("file_id"), warn=False)
 
2280
                if not self.inventory.has_id(file_id):
 
2281
                    continue
 
2282
                text_hash = s.get("hash")
 
2283
                if text_hash == self.get_file_sha1(file_id):
 
2284
                    merge_hashes[file_id] = text_hash
 
2285
            return merge_hashes
 
2286
        finally:
 
2287
            hashfile.close()
 
2288
 
 
2289
    @needs_write_lock
 
2290
    def subsume(self, other_tree):
 
2291
        def add_children(inventory, entry):
 
2292
            for child_entry in entry.children.values():
 
2293
                inventory._byid[child_entry.file_id] = child_entry
 
2294
                if child_entry.kind == 'directory':
 
2295
                    add_children(inventory, child_entry)
 
2296
        if other_tree.get_root_id() == self.get_root_id():
 
2297
            raise errors.BadSubsumeSource(self, other_tree,
 
2298
                                          'Trees have the same root')
 
2299
        try:
 
2300
            other_tree_path = self.relpath(other_tree.basedir)
 
2301
        except errors.PathNotChild:
 
2302
            raise errors.BadSubsumeSource(self, other_tree,
 
2303
                'Tree is not contained by the other')
 
2304
        new_root_parent = self.path2id(osutils.dirname(other_tree_path))
 
2305
        if new_root_parent is None:
 
2306
            raise errors.BadSubsumeSource(self, other_tree,
 
2307
                'Parent directory is not versioned.')
 
2308
        # We need to ensure that the result of a fetch will have a
 
2309
        # versionedfile for the other_tree root, and only fetching into
 
2310
        # RepositoryKnit2 guarantees that.
 
2311
        if not self.branch.repository.supports_rich_root():
 
2312
            raise errors.SubsumeTargetNeedsUpgrade(other_tree)
 
2313
        other_tree.lock_tree_write()
 
2314
        try:
 
2315
            new_parents = other_tree.get_parent_ids()
 
2316
            other_root = other_tree.inventory.root
 
2317
            other_root.parent_id = new_root_parent
 
2318
            other_root.name = osutils.basename(other_tree_path)
 
2319
            self.inventory.add(other_root)
 
2320
            add_children(self.inventory, other_root)
 
2321
            self._write_inventory(self.inventory)
 
2322
            # normally we don't want to fetch whole repositories, but i think
 
2323
            # here we really do want to consolidate the whole thing.
 
2324
            for parent_id in other_tree.get_parent_ids():
 
2325
                self.branch.fetch(other_tree.branch, parent_id)
 
2326
                self.add_parent_tree_id(parent_id)
 
2327
        finally:
 
2328
            other_tree.unlock()
 
2329
        other_tree.bzrdir.retire_bzrdir()
 
2330
 
 
2331
    @needs_tree_write_lock
 
2332
    def extract(self, file_id, format=None):
 
2333
        """Extract a subtree from this tree.
 
2334
 
 
2335
        A new branch will be created, relative to the path for this tree.
 
2336
        """
 
2337
        self.flush()
 
2338
        def mkdirs(path):
 
2339
            segments = osutils.splitpath(path)
 
2340
            transport = self.branch.bzrdir.root_transport
 
2341
            for name in segments:
 
2342
                transport = transport.clone(name)
 
2343
                transport.ensure_base()
 
2344
            return transport
 
2345
 
 
2346
        sub_path = self.id2path(file_id)
 
2347
        branch_transport = mkdirs(sub_path)
 
2348
        if format is None:
 
2349
            format = self.bzrdir.cloning_metadir()
 
2350
        branch_transport.ensure_base()
 
2351
        branch_bzrdir = format.initialize_on_transport(branch_transport)
 
2352
        try:
 
2353
            repo = branch_bzrdir.find_repository()
 
2354
        except errors.NoRepositoryPresent:
 
2355
            repo = branch_bzrdir.create_repository()
 
2356
        if not repo.supports_rich_root():
 
2357
            raise errors.RootNotRich()
 
2358
        new_branch = branch_bzrdir.create_branch()
 
2359
        new_branch.pull(self.branch)
 
2360
        for parent_id in self.get_parent_ids():
 
2361
            new_branch.fetch(self.branch, parent_id)
 
2362
        tree_transport = self.bzrdir.root_transport.clone(sub_path)
 
2363
        if tree_transport.base != branch_transport.base:
 
2364
            tree_bzrdir = format.initialize_on_transport(tree_transport)
 
2365
            branch.BranchReferenceFormat().initialize(tree_bzrdir,
 
2366
                target_branch=new_branch)
 
2367
        else:
 
2368
            tree_bzrdir = branch_bzrdir
 
2369
        wt = tree_bzrdir.create_workingtree(_mod_revision.NULL_REVISION)
 
2370
        wt.set_parent_ids(self.get_parent_ids())
 
2371
        my_inv = self.inventory
 
2372
        child_inv = inventory.Inventory(root_id=None)
 
2373
        new_root = my_inv[file_id]
 
2374
        my_inv.remove_recursive_id(file_id)
 
2375
        new_root.parent_id = None
 
2376
        child_inv.add(new_root)
 
2377
        self._write_inventory(my_inv)
 
2378
        wt._write_inventory(child_inv)
 
2379
        return wt
 
2380
 
 
2381
    def list_files(self, include_root=False, from_dir=None, recursive=True):
 
2382
        """List all files as (path, class, kind, id, entry).
 
2383
 
 
2384
        Lists, but does not descend into unversioned directories.
 
2385
        This does not include files that have been deleted in this
 
2386
        tree. Skips the control directory.
 
2387
 
 
2388
        :param include_root: if True, return an entry for the root
 
2389
        :param from_dir: start from this directory or None for the root
 
2390
        :param recursive: whether to recurse into subdirectories or not
 
2391
        """
 
2392
        # list_files is an iterator, so @needs_read_lock doesn't work properly
 
2393
        # with it. So callers should be careful to always read_lock the tree.
 
2394
        if not self.is_locked():
 
2395
            raise errors.ObjectNotLocked(self)
 
2396
 
 
2397
        inv = self.inventory
 
2398
        if from_dir is None and include_root is True:
 
2399
            yield ('', 'V', 'directory', inv.root.file_id, inv.root)
 
2400
        # Convert these into local objects to save lookup times
 
2401
        pathjoin = osutils.pathjoin
 
2402
        file_kind = self._kind
 
2403
 
 
2404
        # transport.base ends in a slash, we want the piece
 
2405
        # between the last two slashes
 
2406
        transport_base_dir = self.bzrdir.transport.base.rsplit('/', 2)[1]
 
2407
 
 
2408
        fk_entries = {'directory':TreeDirectory, 'file':TreeFile, 'symlink':TreeLink}
 
2409
 
 
2410
        # directory file_id, relative path, absolute path, reverse sorted children
 
2411
        if from_dir is not None:
 
2412
            from_dir_id = inv.path2id(from_dir)
 
2413
            if from_dir_id is None:
 
2414
                # Directory not versioned
 
2415
                return
 
2416
            from_dir_abspath = pathjoin(self.basedir, from_dir)
 
2417
        else:
 
2418
            from_dir_id = inv.root.file_id
 
2419
            from_dir_abspath = self.basedir
 
2420
        children = os.listdir(from_dir_abspath)
 
2421
        children.sort()
 
2422
        # jam 20060527 The kernel sized tree seems equivalent whether we
 
2423
        # use a deque and popleft to keep them sorted, or if we use a plain
 
2424
        # list and just reverse() them.
 
2425
        children = collections.deque(children)
 
2426
        stack = [(from_dir_id, u'', from_dir_abspath, children)]
 
2427
        while stack:
 
2428
            from_dir_id, from_dir_relpath, from_dir_abspath, children = stack[-1]
 
2429
 
 
2430
            while children:
 
2431
                f = children.popleft()
 
2432
                ## TODO: If we find a subdirectory with its own .bzr
 
2433
                ## directory, then that is a separate tree and we
 
2434
                ## should exclude it.
 
2435
 
 
2436
                # the bzrdir for this tree
 
2437
                if transport_base_dir == f:
 
2438
                    continue
 
2439
 
 
2440
                # we know that from_dir_relpath and from_dir_abspath never end in a slash
 
2441
                # and 'f' doesn't begin with one, we can do a string op, rather
 
2442
                # than the checks of pathjoin(), all relative paths will have an extra slash
 
2443
                # at the beginning
 
2444
                fp = from_dir_relpath + '/' + f
 
2445
 
 
2446
                # absolute path
 
2447
                fap = from_dir_abspath + '/' + f
 
2448
 
 
2449
                dir_ie = inv[from_dir_id]
 
2450
                if dir_ie.kind == 'directory':
 
2451
                    f_ie = dir_ie.children.get(f)
 
2452
                else:
 
2453
                    f_ie = None
 
2454
                if f_ie:
 
2455
                    c = 'V'
 
2456
                elif self.is_ignored(fp[1:]):
 
2457
                    c = 'I'
 
2458
                else:
 
2459
                    # we may not have found this file, because of a unicode
 
2460
                    # issue, or because the directory was actually a symlink.
 
2461
                    f_norm, can_access = osutils.normalized_filename(f)
 
2462
                    if f == f_norm or not can_access:
 
2463
                        # No change, so treat this file normally
 
2464
                        c = '?'
 
2465
                    else:
 
2466
                        # this file can be accessed by a normalized path
 
2467
                        # check again if it is versioned
 
2468
                        # these lines are repeated here for performance
 
2469
                        f = f_norm
 
2470
                        fp = from_dir_relpath + '/' + f
 
2471
                        fap = from_dir_abspath + '/' + f
 
2472
                        f_ie = inv.get_child(from_dir_id, f)
 
2473
                        if f_ie:
 
2474
                            c = 'V'
 
2475
                        elif self.is_ignored(fp[1:]):
 
2476
                            c = 'I'
 
2477
                        else:
 
2478
                            c = '?'
 
2479
 
 
2480
                fk = file_kind(fap)
 
2481
 
 
2482
                # make a last minute entry
 
2483
                if f_ie:
 
2484
                    yield fp[1:], c, fk, f_ie.file_id, f_ie
 
2485
                else:
 
2486
                    try:
 
2487
                        yield fp[1:], c, fk, None, fk_entries[fk]()
 
2488
                    except KeyError:
 
2489
                        yield fp[1:], c, fk, None, TreeEntry()
 
2490
                    continue
 
2491
 
 
2492
                if fk != 'directory':
 
2493
                    continue
 
2494
 
 
2495
                # But do this child first if recursing down
 
2496
                if recursive:
 
2497
                    new_children = os.listdir(fap)
 
2498
                    new_children.sort()
 
2499
                    new_children = collections.deque(new_children)
 
2500
                    stack.append((f_ie.file_id, fp, fap, new_children))
 
2501
                    # Break out of inner loop,
 
2502
                    # so that we start outer loop with child
 
2503
                    break
 
2504
            else:
 
2505
                # if we finished all children, pop it off the stack
 
2506
                stack.pop()
 
2507
 
 
2508
    @needs_tree_write_lock
 
2509
    def move(self, from_paths, to_dir=None, after=False):
 
2510
        """Rename files.
 
2511
 
 
2512
        to_dir must exist in the inventory.
 
2513
 
 
2514
        If to_dir exists and is a directory, the files are moved into
 
2515
        it, keeping their old names.
 
2516
 
 
2517
        Note that to_dir is only the last component of the new name;
 
2518
        this doesn't change the directory.
 
2519
 
 
2520
        For each entry in from_paths the move mode will be determined
 
2521
        independently.
 
2522
 
 
2523
        The first mode moves the file in the filesystem and updates the
 
2524
        inventory. The second mode only updates the inventory without
 
2525
        touching the file on the filesystem.
 
2526
 
 
2527
        move uses the second mode if 'after == True' and the target is
 
2528
        either not versioned or newly added, and present in the working tree.
 
2529
 
 
2530
        move uses the second mode if 'after == False' and the source is
 
2531
        versioned but no longer in the working tree, and the target is not
 
2532
        versioned but present in the working tree.
 
2533
 
 
2534
        move uses the first mode if 'after == False' and the source is
 
2535
        versioned and present in the working tree, and the target is not
 
2536
        versioned and not present in the working tree.
 
2537
 
 
2538
        Everything else results in an error.
 
2539
 
 
2540
        This returns a list of (from_path, to_path) pairs for each
 
2541
        entry that is moved.
 
2542
        """
 
2543
        rename_entries = []
 
2544
        rename_tuples = []
 
2545
 
 
2546
        # check for deprecated use of signature
 
2547
        if to_dir is None:
 
2548
            raise TypeError('You must supply a target directory')
 
2549
        # check destination directory
 
2550
        if isinstance(from_paths, basestring):
 
2551
            raise ValueError()
 
2552
        inv = self.inventory
 
2553
        to_abs = self.abspath(to_dir)
 
2554
        if not isdir(to_abs):
 
2555
            raise errors.BzrMoveFailedError('',to_dir,
 
2556
                errors.NotADirectory(to_abs))
 
2557
        if not self.has_filename(to_dir):
 
2558
            raise errors.BzrMoveFailedError('',to_dir,
 
2559
                errors.NotInWorkingDirectory(to_dir))
 
2560
        to_dir_id = inv.path2id(to_dir)
 
2561
        if to_dir_id is None:
 
2562
            raise errors.BzrMoveFailedError('',to_dir,
 
2563
                errors.NotVersionedError(path=to_dir))
 
2564
 
 
2565
        to_dir_ie = inv[to_dir_id]
 
2566
        if to_dir_ie.kind != 'directory':
 
2567
            raise errors.BzrMoveFailedError('',to_dir,
 
2568
                errors.NotADirectory(to_abs))
 
2569
 
 
2570
        # create rename entries and tuples
 
2571
        for from_rel in from_paths:
 
2572
            from_tail = splitpath(from_rel)[-1]
 
2573
            from_id = inv.path2id(from_rel)
 
2574
            if from_id is None:
 
2575
                raise errors.BzrMoveFailedError(from_rel,to_dir,
 
2576
                    errors.NotVersionedError(path=from_rel))
 
2577
 
 
2578
            from_entry = inv[from_id]
 
2579
            from_parent_id = from_entry.parent_id
 
2580
            to_rel = pathjoin(to_dir, from_tail)
 
2581
            rename_entry = InventoryWorkingTree._RenameEntry(
 
2582
                from_rel=from_rel,
 
2583
                from_id=from_id,
 
2584
                from_tail=from_tail,
 
2585
                from_parent_id=from_parent_id,
 
2586
                to_rel=to_rel, to_tail=from_tail,
 
2587
                to_parent_id=to_dir_id)
 
2588
            rename_entries.append(rename_entry)
 
2589
            rename_tuples.append((from_rel, to_rel))
 
2590
 
 
2591
        # determine which move mode to use. checks also for movability
 
2592
        rename_entries = self._determine_mv_mode(rename_entries, after)
 
2593
 
 
2594
        original_modified = self._inventory_is_modified
 
2595
        try:
 
2596
            if len(from_paths):
 
2597
                self._inventory_is_modified = True
 
2598
            self._move(rename_entries)
 
2599
        except:
 
2600
            # restore the inventory on error
 
2601
            self._inventory_is_modified = original_modified
 
2602
            raise
 
2603
        self._write_inventory(inv)
 
2604
        return rename_tuples
 
2605
 
 
2606
    @needs_tree_write_lock
 
2607
    def rename_one(self, from_rel, to_rel, after=False):
 
2608
        """Rename one file.
 
2609
 
 
2610
        This can change the directory or the filename or both.
 
2611
 
 
2612
        rename_one has several 'modes' to work. First, it can rename a physical
 
2613
        file and change the file_id. That is the normal mode. Second, it can
 
2614
        only change the file_id without touching any physical file.
 
2615
 
 
2616
        rename_one uses the second mode if 'after == True' and 'to_rel' is not
 
2617
        versioned but present in the working tree.
 
2618
 
 
2619
        rename_one uses the second mode if 'after == False' and 'from_rel' is
 
2620
        versioned but no longer in the working tree, and 'to_rel' is not
 
2621
        versioned but present in the working tree.
 
2622
 
 
2623
        rename_one uses the first mode if 'after == False' and 'from_rel' is
 
2624
        versioned and present in the working tree, and 'to_rel' is not
 
2625
        versioned and not present in the working tree.
 
2626
 
 
2627
        Everything else results in an error.
 
2628
        """
 
2629
        inv = self.inventory
 
2630
        rename_entries = []
 
2631
 
 
2632
        # create rename entries and tuples
 
2633
        from_tail = splitpath(from_rel)[-1]
 
2634
        from_id = inv.path2id(from_rel)
 
2635
        if from_id is None:
 
2636
            # if file is missing in the inventory maybe it's in the basis_tree
 
2637
            basis_tree = self.branch.basis_tree()
 
2638
            from_id = basis_tree.path2id(from_rel)
 
2639
            if from_id is None:
 
2640
                raise errors.BzrRenameFailedError(from_rel,to_rel,
 
2641
                    errors.NotVersionedError(path=from_rel))
 
2642
            # put entry back in the inventory so we can rename it
 
2643
            from_entry = basis_tree.inventory[from_id].copy()
 
2644
            inv.add(from_entry)
 
2645
        else:
 
2646
            from_entry = inv[from_id]
 
2647
        from_parent_id = from_entry.parent_id
 
2648
        to_dir, to_tail = os.path.split(to_rel)
 
2649
        to_dir_id = inv.path2id(to_dir)
 
2650
        rename_entry = InventoryWorkingTree._RenameEntry(from_rel=from_rel,
 
2651
                                     from_id=from_id,
 
2652
                                     from_tail=from_tail,
 
2653
                                     from_parent_id=from_parent_id,
 
2654
                                     to_rel=to_rel, to_tail=to_tail,
 
2655
                                     to_parent_id=to_dir_id)
 
2656
        rename_entries.append(rename_entry)
 
2657
 
 
2658
        # determine which move mode to use. checks also for movability
 
2659
        rename_entries = self._determine_mv_mode(rename_entries, after)
 
2660
 
 
2661
        # check if the target changed directory and if the target directory is
 
2662
        # versioned
 
2663
        if to_dir_id is None:
 
2664
            raise errors.BzrMoveFailedError(from_rel,to_rel,
 
2665
                errors.NotVersionedError(path=to_dir))
 
2666
 
 
2667
        # all checks done. now we can continue with our actual work
 
2668
        mutter('rename_one:\n'
 
2669
               '  from_id   {%s}\n'
 
2670
               '  from_rel: %r\n'
 
2671
               '  to_rel:   %r\n'
 
2672
               '  to_dir    %r\n'
 
2673
               '  to_dir_id {%s}\n',
 
2674
               from_id, from_rel, to_rel, to_dir, to_dir_id)
 
2675
 
 
2676
        self._move(rename_entries)
 
2677
        self._write_inventory(inv)
 
2678
 
 
2679
    class _RenameEntry(object):
 
2680
        def __init__(self, from_rel, from_id, from_tail, from_parent_id,
 
2681
                     to_rel, to_tail, to_parent_id, only_change_inv=False,
 
2682
                     change_id=False):
 
2683
            self.from_rel = from_rel
 
2684
            self.from_id = from_id
 
2685
            self.from_tail = from_tail
 
2686
            self.from_parent_id = from_parent_id
 
2687
            self.to_rel = to_rel
 
2688
            self.to_tail = to_tail
 
2689
            self.to_parent_id = to_parent_id
 
2690
            self.change_id = change_id
 
2691
            self.only_change_inv = only_change_inv
 
2692
 
 
2693
    def _determine_mv_mode(self, rename_entries, after=False):
 
2694
        """Determines for each from-to pair if both inventory and working tree
 
2695
        or only the inventory has to be changed.
 
2696
 
 
2697
        Also does basic plausability tests.
 
2698
        """
 
2699
        inv = self.inventory
 
2700
 
 
2701
        for rename_entry in rename_entries:
 
2702
            # store to local variables for easier reference
 
2703
            from_rel = rename_entry.from_rel
 
2704
            from_id = rename_entry.from_id
 
2705
            to_rel = rename_entry.to_rel
 
2706
            to_id = inv.path2id(to_rel)
 
2707
            only_change_inv = False
 
2708
            change_id = False
 
2709
 
 
2710
            # check the inventory for source and destination
 
2711
            if from_id is None:
 
2712
                raise errors.BzrMoveFailedError(from_rel,to_rel,
 
2713
                    errors.NotVersionedError(path=from_rel))
 
2714
            if to_id is not None:
 
2715
                allowed = False
 
2716
                # allow it with --after but only if dest is newly added
 
2717
                if after:
 
2718
                    basis = self.basis_tree()
 
2719
                    basis.lock_read()
 
2720
                    try:
 
2721
                        if not basis.has_id(to_id):
 
2722
                            rename_entry.change_id = True
 
2723
                            allowed = True
 
2724
                    finally:
 
2725
                        basis.unlock()
 
2726
                if not allowed:
 
2727
                    raise errors.BzrMoveFailedError(from_rel,to_rel,
 
2728
                        errors.AlreadyVersionedError(path=to_rel))
 
2729
 
 
2730
            # try to determine the mode for rename (only change inv or change
 
2731
            # inv and file system)
 
2732
            if after:
 
2733
                if not self.has_filename(to_rel):
 
2734
                    raise errors.BzrMoveFailedError(from_id,to_rel,
 
2735
                        errors.NoSuchFile(path=to_rel,
 
2736
                        extra="New file has not been created yet"))
 
2737
                only_change_inv = True
 
2738
            elif not self.has_filename(from_rel) and self.has_filename(to_rel):
 
2739
                only_change_inv = True
 
2740
            elif self.has_filename(from_rel) and not self.has_filename(to_rel):
 
2741
                only_change_inv = False
 
2742
            elif (not self.case_sensitive
 
2743
                  and from_rel.lower() == to_rel.lower()
 
2744
                  and self.has_filename(from_rel)):
 
2745
                only_change_inv = False
 
2746
            else:
 
2747
                # something is wrong, so lets determine what exactly
 
2748
                if not self.has_filename(from_rel) and \
 
2749
                   not self.has_filename(to_rel):
 
2750
                    raise errors.BzrRenameFailedError(from_rel,to_rel,
 
2751
                        errors.PathsDoNotExist(paths=(str(from_rel),
 
2752
                        str(to_rel))))
 
2753
                else:
 
2754
                    raise errors.RenameFailedFilesExist(from_rel, to_rel)
 
2755
            rename_entry.only_change_inv = only_change_inv
 
2756
        return rename_entries
 
2757
 
 
2758
    def _move(self, rename_entries):
 
2759
        """Moves a list of files.
 
2760
 
 
2761
        Depending on the value of the flag 'only_change_inv', the
 
2762
        file will be moved on the file system or not.
 
2763
        """
 
2764
        inv = self.inventory
 
2765
        moved = []
 
2766
 
 
2767
        for entry in rename_entries:
 
2768
            try:
 
2769
                self._move_entry(entry)
 
2770
            except:
 
2771
                self._rollback_move(moved)
 
2772
                raise
 
2773
            moved.append(entry)
 
2774
 
 
2775
    def _rollback_move(self, moved):
 
2776
        """Try to rollback a previous move in case of an filesystem error."""
 
2777
        inv = self.inventory
 
2778
        for entry in moved:
 
2779
            try:
 
2780
                self._move_entry(WorkingTree._RenameEntry(
 
2781
                    entry.to_rel, entry.from_id,
 
2782
                    entry.to_tail, entry.to_parent_id, entry.from_rel,
 
2783
                    entry.from_tail, entry.from_parent_id,
 
2784
                    entry.only_change_inv))
 
2785
            except errors.BzrMoveFailedError, e:
 
2786
                raise errors.BzrMoveFailedError( '', '', "Rollback failed."
 
2787
                        " The working tree is in an inconsistent state."
 
2788
                        " Please consider doing a 'bzr revert'."
 
2789
                        " Error message is: %s" % e)
 
2790
 
 
2791
    def _move_entry(self, entry):
 
2792
        inv = self.inventory
 
2793
        from_rel_abs = self.abspath(entry.from_rel)
 
2794
        to_rel_abs = self.abspath(entry.to_rel)
 
2795
        if from_rel_abs == to_rel_abs:
 
2796
            raise errors.BzrMoveFailedError(entry.from_rel, entry.to_rel,
 
2797
                "Source and target are identical.")
 
2798
 
 
2799
        if not entry.only_change_inv:
 
2800
            try:
 
2801
                osutils.rename(from_rel_abs, to_rel_abs)
 
2802
            except OSError, e:
 
2803
                raise errors.BzrMoveFailedError(entry.from_rel,
 
2804
                    entry.to_rel, e[1])
 
2805
        if entry.change_id:
 
2806
            to_id = inv.path2id(entry.to_rel)
 
2807
            inv.remove_recursive_id(to_id)
 
2808
        inv.rename(entry.from_id, entry.to_parent_id, entry.to_tail)
 
2809
 
 
2810
    @needs_tree_write_lock
 
2811
    def unversion(self, file_ids):
 
2812
        """Remove the file ids in file_ids from the current versioned set.
 
2813
 
 
2814
        When a file_id is unversioned, all of its children are automatically
 
2815
        unversioned.
 
2816
 
 
2817
        :param file_ids: The file ids to stop versioning.
 
2818
        :raises: NoSuchId if any fileid is not currently versioned.
 
2819
        """
 
2820
        for file_id in file_ids:
 
2821
            if not self._inventory.has_id(file_id):
 
2822
                raise errors.NoSuchId(self, file_id)
 
2823
        for file_id in file_ids:
 
2824
            if self._inventory.has_id(file_id):
 
2825
                self._inventory.remove_recursive_id(file_id)
 
2826
        if len(file_ids):
 
2827
            # in the future this should just set a dirty bit to wait for the
 
2828
            # final unlock. However, until all methods of workingtree start
 
2829
            # with the current in -memory inventory rather than triggering
 
2830
            # a read, it is more complex - we need to teach read_inventory
 
2831
            # to know when to read, and when to not read first... and possibly
 
2832
            # to save first when the in memory one may be corrupted.
 
2833
            # so for now, we just only write it if it is indeed dirty.
 
2834
            # - RBC 20060907
 
2835
            self._write_inventory(self._inventory)
 
2836
 
 
2837
    def stored_kind(self, file_id):
 
2838
        """See Tree.stored_kind"""
 
2839
        return self.inventory[file_id].kind
 
2840
 
 
2841
    def extras(self):
 
2842
        """Yield all unversioned files in this WorkingTree.
 
2843
 
 
2844
        If there are any unversioned directories then only the directory is
 
2845
        returned, not all its children.  But if there are unversioned files
 
2846
        under a versioned subdirectory, they are returned.
 
2847
 
 
2848
        Currently returned depth-first, sorted by name within directories.
 
2849
        This is the same order used by 'osutils.walkdirs'.
 
2850
        """
 
2851
        ## TODO: Work from given directory downwards
 
2852
        for path, dir_entry in self.inventory.directories():
 
2853
            # mutter("search for unknowns in %r", path)
 
2854
            dirabs = self.abspath(path)
 
2855
            if not isdir(dirabs):
 
2856
                # e.g. directory deleted
 
2857
                continue
 
2858
 
 
2859
            fl = []
 
2860
            for subf in os.listdir(dirabs):
 
2861
                if self.bzrdir.is_control_filename(subf):
 
2862
                    continue
 
2863
                if subf not in dir_entry.children:
 
2864
                    try:
 
2865
                        (subf_norm,
 
2866
                         can_access) = osutils.normalized_filename(subf)
 
2867
                    except UnicodeDecodeError:
 
2868
                        path_os_enc = path.encode(osutils._fs_enc)
 
2869
                        relpath = path_os_enc + '/' + subf
 
2870
                        raise errors.BadFilenameEncoding(relpath,
 
2871
                                                         osutils._fs_enc)
 
2872
                    if subf_norm != subf and can_access:
 
2873
                        if subf_norm not in dir_entry.children:
 
2874
                            fl.append(subf_norm)
 
2875
                    else:
 
2876
                        fl.append(subf)
 
2877
 
 
2878
            fl.sort()
 
2879
            for subf in fl:
 
2880
                subp = pathjoin(path, subf)
 
2881
                yield subp
 
2882
 
 
2883
    def _walkdirs(self, prefix=""):
 
2884
        """Walk the directories of this tree.
 
2885
 
 
2886
        :param prefix: is used as the directrory to start with.
 
2887
        :returns: a generator which yields items in the form::
 
2888
 
 
2889
            ((curren_directory_path, fileid),
 
2890
             [(file1_path, file1_name, file1_kind, None, file1_id,
 
2891
               file1_kind), ... ])
 
2892
        """
2071
2893
        _directory = 'directory'
2072
2894
        # get the root in the inventory
2073
2895
        inv = self.inventory
2087
2909
                relroot = ""
2088
2910
            # FIXME: stash the node in pending
2089
2911
            entry = inv[top_id]
2090
 
            for name, child in entry.sorted_children():
2091
 
                dirblock.append((relroot + name, name, child.kind, None,
2092
 
                    child.file_id, child.kind
2093
 
                    ))
 
2912
            if entry.kind == 'directory':
 
2913
                for name, child in entry.sorted_children():
 
2914
                    dirblock.append((relroot + name, name, child.kind, None,
 
2915
                        child.file_id, child.kind
 
2916
                        ))
2094
2917
            yield (currentdir[0], entry.file_id), dirblock
2095
2918
            # push the user specified dirs from dirblock
2096
2919
            for dir in reversed(dirblock):
2098
2921
                    pending.append(dir)
2099
2922
 
2100
2923
 
2101
 
class WorkingTree2(WorkingTree):
2102
 
    """This is the Format 2 working tree.
2103
 
 
2104
 
    This was the first weave based working tree. 
2105
 
     - uses os locks for locking.
2106
 
     - uses the branch last-revision.
2107
 
    """
2108
 
 
2109
 
    def lock_tree_write(self):
2110
 
        """See WorkingTree.lock_tree_write().
2111
 
 
2112
 
        In Format2 WorkingTrees we have a single lock for the branch and tree
2113
 
        so lock_tree_write() degrades to lock_write().
2114
 
        """
2115
 
        self.branch.lock_write()
2116
 
        try:
2117
 
            return self._control_files.lock_write()
2118
 
        except:
2119
 
            self.branch.unlock()
2120
 
            raise
2121
 
 
2122
 
    def unlock(self):
2123
 
        # we share control files:
2124
 
        if self._control_files._lock_count == 3:
2125
 
            # _inventory_is_modified is always False during a read lock.
2126
 
            if self._inventory_is_modified:
2127
 
                self.flush()
2128
 
            self._write_hashcache_if_dirty()
2129
 
                    
2130
 
        # reverse order of locking.
2131
 
        try:
2132
 
            return self._control_files.unlock()
2133
 
        finally:
2134
 
            self.branch.unlock()
2135
 
 
2136
 
 
2137
 
class WorkingTree3(WorkingTree):
2138
 
    """This is the Format 3 working tree.
2139
 
 
2140
 
    This differs from the base WorkingTree by:
2141
 
     - having its own file lock
2142
 
     - having its own last-revision property.
2143
 
 
2144
 
    This is new in bzr 0.8
2145
 
    """
2146
 
 
2147
 
    @needs_read_lock
2148
 
    def _last_revision(self):
2149
 
        """See Mutable.last_revision."""
2150
 
        try:
2151
 
            return osutils.safe_revision_id(
2152
 
                        self._control_files.get('last-revision').read())
2153
 
        except errors.NoSuchFile:
2154
 
            return None
2155
 
 
2156
 
    def _change_last_revision(self, revision_id):
2157
 
        """See WorkingTree._change_last_revision."""
2158
 
        if revision_id is None or revision_id == NULL_REVISION:
2159
 
            try:
2160
 
                self._control_files._transport.delete('last-revision')
2161
 
            except errors.NoSuchFile:
2162
 
                pass
2163
 
            return False
2164
 
        else:
2165
 
            self._control_files.put_utf8('last-revision', revision_id)
2166
 
            return True
2167
 
 
2168
 
    @needs_tree_write_lock
2169
 
    def set_conflicts(self, conflicts):
2170
 
        self._put_rio('conflicts', conflicts.to_stanzas(), 
2171
 
                      CONFLICT_HEADER_1)
2172
 
 
2173
 
    @needs_tree_write_lock
2174
 
    def add_conflicts(self, new_conflicts):
2175
 
        conflict_set = set(self.conflicts())
2176
 
        conflict_set.update(set(list(new_conflicts)))
2177
 
        self.set_conflicts(_mod_conflicts.ConflictList(sorted(conflict_set,
2178
 
                                       key=_mod_conflicts.Conflict.sort_key)))
2179
 
 
2180
 
    @needs_read_lock
2181
 
    def conflicts(self):
2182
 
        try:
2183
 
            confile = self._control_files.get('conflicts')
2184
 
        except errors.NoSuchFile:
2185
 
            return _mod_conflicts.ConflictList()
2186
 
        try:
2187
 
            if confile.next() != CONFLICT_HEADER_1 + '\n':
2188
 
                raise errors.ConflictFormatError()
2189
 
        except StopIteration:
2190
 
            raise errors.ConflictFormatError()
2191
 
        return _mod_conflicts.ConflictList.from_stanzas(RioReader(confile))
2192
 
 
2193
 
    def unlock(self):
2194
 
        if self._control_files._lock_count == 1:
2195
 
            # _inventory_is_modified is always False during a read lock.
2196
 
            if self._inventory_is_modified:
2197
 
                self.flush()
2198
 
            self._write_hashcache_if_dirty()
2199
 
        # reverse order of locking.
2200
 
        try:
2201
 
            return self._control_files.unlock()
2202
 
        finally:
2203
 
            self.branch.unlock()
2204
 
 
2205
 
 
2206
 
def get_conflicted_stem(path):
2207
 
    for suffix in _mod_conflicts.CONFLICT_SUFFIXES:
2208
 
        if path.endswith(suffix):
2209
 
            return path[:-len(suffix)]
2210
 
 
2211
 
 
2212
 
@deprecated_function(zero_eight)
2213
 
def is_control_file(filename):
2214
 
    """See WorkingTree.is_control_filename(filename)."""
2215
 
    ## FIXME: better check
2216
 
    filename = normpath(filename)
2217
 
    while filename != '':
2218
 
        head, tail = os.path.split(filename)
2219
 
        ## mutter('check %r for control file' % ((head, tail),))
2220
 
        if tail == '.bzr':
2221
 
            return True
2222
 
        if filename == head:
2223
 
            break
2224
 
        filename = head
2225
 
    return False
2226
 
 
2227
 
 
2228
 
class WorkingTreeFormat(object):
 
2924
class WorkingTreeFormatRegistry(controldir.ControlComponentFormatRegistry):
 
2925
    """Registry for working tree formats."""
 
2926
 
 
2927
    def __init__(self, other_registry=None):
 
2928
        super(WorkingTreeFormatRegistry, self).__init__(other_registry)
 
2929
        self._default_format = None
 
2930
        self._default_format_key = None
 
2931
 
 
2932
    def get_default(self):
 
2933
        """Return the current default format."""
 
2934
        if (self._default_format_key is not None and
 
2935
            self._default_format is None):
 
2936
            self._default_format = self.get(self._default_format_key)
 
2937
        return self._default_format
 
2938
 
 
2939
    def set_default(self, format):
 
2940
        """Set the default format."""
 
2941
        self._default_format = format
 
2942
        self._default_format_key = None
 
2943
 
 
2944
    def set_default_key(self, format_string):
 
2945
        """Set the default format by its format string."""
 
2946
        self._default_format_key = format_string
 
2947
        self._default_format = None
 
2948
 
 
2949
 
 
2950
format_registry = WorkingTreeFormatRegistry()
 
2951
 
 
2952
 
 
2953
class WorkingTreeFormat(controldir.ControlComponentFormat):
2229
2954
    """An encapsulation of the initialization and open routines for a format.
2230
2955
 
2231
2956
    Formats provide three things:
2233
2958
     * a format string,
2234
2959
     * an open routine.
2235
2960
 
2236
 
    Formats are placed in an dict by their format string for reference 
 
2961
    Formats are placed in an dict by their format string for reference
2237
2962
    during workingtree opening. Its not required that these be instances, they
2238
 
    can be classes themselves with class methods - it simply depends on 
 
2963
    can be classes themselves with class methods - it simply depends on
2239
2964
    whether state is needed for a given format or not.
2240
2965
 
2241
2966
    Once a format is deprecated, just deprecate the initialize and open
2242
 
    methods on the format class. Do not deprecate the object, as the 
 
2967
    methods on the format class. Do not deprecate the object, as the
2243
2968
    object will be created every time regardless.
2244
2969
    """
2245
2970
 
2246
 
    _default_format = None
2247
 
    """The default format used for new trees."""
2248
 
 
2249
 
    _formats = {}
2250
 
    """The known formats."""
 
2971
    requires_rich_root = False
 
2972
 
 
2973
    upgrade_recommended = False
 
2974
 
 
2975
    requires_normalized_unicode_filenames = False
 
2976
 
 
2977
    case_sensitive_filename = "FoRMaT"
 
2978
 
 
2979
    missing_parent_conflicts = False
 
2980
    """If this format supports missing parent conflicts."""
 
2981
 
 
2982
    supports_versioned_directories = None
 
2983
 
 
2984
    @classmethod
 
2985
    def find_format_string(klass, a_bzrdir):
 
2986
        """Return format name for the working tree object in a_bzrdir."""
 
2987
        try:
 
2988
            transport = a_bzrdir.get_workingtree_transport(None)
 
2989
            return transport.get_bytes("format")
 
2990
        except errors.NoSuchFile:
 
2991
            raise errors.NoWorkingTree(base=transport.base)
2251
2992
 
2252
2993
    @classmethod
2253
2994
    def find_format(klass, a_bzrdir):
2254
2995
        """Return the format for the working tree object in a_bzrdir."""
2255
2996
        try:
2256
 
            transport = a_bzrdir.get_workingtree_transport(None)
2257
 
            format_string = transport.get("format").read()
2258
 
            return klass._formats[format_string]
2259
 
        except errors.NoSuchFile:
2260
 
            raise errors.NoWorkingTree(base=transport.base)
 
2997
            format_string = klass.find_format_string(a_bzrdir)
 
2998
            return format_registry.get(format_string)
2261
2999
        except KeyError:
2262
 
            raise errors.UnknownFormatError(format=format_string)
 
3000
            raise errors.UnknownFormatError(format=format_string,
 
3001
                                            kind="working tree")
 
3002
 
 
3003
    def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
 
3004
                   accelerator_tree=None, hardlink=False):
 
3005
        """Initialize a new working tree in a_bzrdir.
 
3006
 
 
3007
        :param a_bzrdir: BzrDir to initialize the working tree in.
 
3008
        :param revision_id: allows creating a working tree at a different
 
3009
            revision than the branch is at.
 
3010
        :param from_branch: Branch to checkout
 
3011
        :param accelerator_tree: A tree which can be used for retrieving file
 
3012
            contents more quickly than the revision tree, i.e. a workingtree.
 
3013
            The revision tree will be used for cases where accelerator_tree's
 
3014
            content is different.
 
3015
        :param hardlink: If true, hard-link files from accelerator_tree,
 
3016
            where possible.
 
3017
        """
 
3018
        raise NotImplementedError(self.initialize)
 
3019
 
 
3020
    def __eq__(self, other):
 
3021
        return self.__class__ is other.__class__
 
3022
 
 
3023
    def __ne__(self, other):
 
3024
        return not (self == other)
2263
3025
 
2264
3026
    @classmethod
 
3027
    @symbol_versioning.deprecated_method(
 
3028
        symbol_versioning.deprecated_in((2, 4, 0)))
2265
3029
    def get_default_format(klass):
2266
3030
        """Return the current default format."""
2267
 
        return klass._default_format
 
3031
        return format_registry.get_default()
2268
3032
 
2269
3033
    def get_format_string(self):
2270
3034
        """Return the ASCII format string that identifies this format."""
2278
3042
        """Is this format supported?
2279
3043
 
2280
3044
        Supported formats can be initialized and opened.
2281
 
        Unsupported formats may not support initialization or committing or 
 
3045
        Unsupported formats may not support initialization or committing or
2282
3046
        some other features depending on the reason for not being supported.
2283
3047
        """
2284
3048
        return True
2285
3049
 
 
3050
    def supports_content_filtering(self):
 
3051
        """True if this format supports content filtering."""
 
3052
        return False
 
3053
 
 
3054
    def supports_views(self):
 
3055
        """True if this format supports stored views."""
 
3056
        return False
 
3057
 
2286
3058
    @classmethod
 
3059
    @symbol_versioning.deprecated_method(
 
3060
        symbol_versioning.deprecated_in((2, 4, 0)))
2287
3061
    def register_format(klass, format):
2288
 
        klass._formats[format.get_format_string()] = format
2289
 
 
2290
 
    @classmethod
 
3062
        format_registry.register(format)
 
3063
 
 
3064
    @classmethod
 
3065
    @symbol_versioning.deprecated_method(
 
3066
        symbol_versioning.deprecated_in((2, 4, 0)))
 
3067
    def register_extra_format(klass, format):
 
3068
        format_registry.register_extra(format)
 
3069
 
 
3070
    @classmethod
 
3071
    @symbol_versioning.deprecated_method(
 
3072
        symbol_versioning.deprecated_in((2, 4, 0)))
 
3073
    def unregister_extra_format(klass, format):
 
3074
        format_registry.unregister_extra(format)
 
3075
 
 
3076
    @classmethod
 
3077
    @symbol_versioning.deprecated_method(
 
3078
        symbol_versioning.deprecated_in((2, 4, 0)))
 
3079
    def get_formats(klass):
 
3080
        return format_registry._get_all()
 
3081
 
 
3082
    @classmethod
 
3083
    @symbol_versioning.deprecated_method(
 
3084
        symbol_versioning.deprecated_in((2, 4, 0)))
2291
3085
    def set_default_format(klass, format):
2292
 
        klass._default_format = format
 
3086
        format_registry.set_default(format)
2293
3087
 
2294
3088
    @classmethod
 
3089
    @symbol_versioning.deprecated_method(
 
3090
        symbol_versioning.deprecated_in((2, 4, 0)))
2295
3091
    def unregister_format(klass, format):
2296
 
        assert klass._formats[format.get_format_string()] is format
2297
 
        del klass._formats[format.get_format_string()]
2298
 
 
2299
 
 
2300
 
 
2301
 
class WorkingTreeFormat2(WorkingTreeFormat):
2302
 
    """The second working tree format. 
2303
 
 
2304
 
    This format modified the hash cache from the format 1 hash cache.
2305
 
    """
2306
 
 
2307
 
    def get_format_description(self):
2308
 
        """See WorkingTreeFormat.get_format_description()."""
2309
 
        return "Working tree format 2"
2310
 
 
2311
 
    def stub_initialize_remote(self, control_files):
2312
 
        """As a special workaround create critical control files for a remote working tree
2313
 
        
2314
 
        This ensures that it can later be updated and dealt with locally,
2315
 
        since BzrDirFormat6 and BzrDirFormat5 cannot represent dirs with 
2316
 
        no working tree.  (See bug #43064).
2317
 
        """
2318
 
        sio = StringIO()
2319
 
        inv = Inventory()
2320
 
        xml5.serializer_v5.write_inventory(inv, sio)
2321
 
        sio.seek(0)
2322
 
        control_files.put('inventory', sio)
2323
 
 
2324
 
        control_files.put_utf8('pending-merges', '')
2325
 
        
2326
 
 
2327
 
    def initialize(self, a_bzrdir, revision_id=None):
2328
 
        """See WorkingTreeFormat.initialize()."""
2329
 
        if not isinstance(a_bzrdir.transport, LocalTransport):
2330
 
            raise errors.NotLocalUrl(a_bzrdir.transport.base)
2331
 
        branch = a_bzrdir.open_branch()
2332
 
        if revision_id is not None:
2333
 
            revision_id = osutils.safe_revision_id(revision_id)
2334
 
            branch.lock_write()
2335
 
            try:
2336
 
                revision_history = branch.revision_history()
2337
 
                try:
2338
 
                    position = revision_history.index(revision_id)
2339
 
                except ValueError:
2340
 
                    raise errors.NoSuchRevision(branch, revision_id)
2341
 
                branch.set_revision_history(revision_history[:position + 1])
2342
 
            finally:
2343
 
                branch.unlock()
2344
 
        revision = branch.last_revision()
2345
 
        inv = Inventory()
2346
 
        wt = WorkingTree2(a_bzrdir.root_transport.local_abspath('.'),
2347
 
                         branch,
2348
 
                         inv,
2349
 
                         _internal=True,
2350
 
                         _format=self,
2351
 
                         _bzrdir=a_bzrdir)
2352
 
        basis_tree = branch.repository.revision_tree(revision)
2353
 
        if basis_tree.inventory.root is not None:
2354
 
            wt.set_root_id(basis_tree.inventory.root.file_id)
2355
 
        # set the parent list and cache the basis tree.
2356
 
        wt.set_parent_trees([(revision, basis_tree)])
2357
 
        transform.build_tree(basis_tree, wt)
2358
 
        return wt
2359
 
 
2360
 
    def __init__(self):
2361
 
        super(WorkingTreeFormat2, self).__init__()
2362
 
        self._matchingbzrdir = bzrdir.BzrDirFormat6()
2363
 
 
2364
 
    def open(self, a_bzrdir, _found=False):
2365
 
        """Return the WorkingTree object for a_bzrdir
2366
 
 
2367
 
        _found is a private parameter, do not use it. It is used to indicate
2368
 
               if format probing has already been done.
2369
 
        """
2370
 
        if not _found:
2371
 
            # we are being called directly and must probe.
2372
 
            raise NotImplementedError
2373
 
        if not isinstance(a_bzrdir.transport, LocalTransport):
2374
 
            raise errors.NotLocalUrl(a_bzrdir.transport.base)
2375
 
        return WorkingTree2(a_bzrdir.root_transport.local_abspath('.'),
2376
 
                           _internal=True,
2377
 
                           _format=self,
2378
 
                           _bzrdir=a_bzrdir)
2379
 
 
2380
 
 
2381
 
class WorkingTreeFormat3(WorkingTreeFormat):
2382
 
    """The second working tree format updated to record a format marker.
2383
 
 
2384
 
    This format:
2385
 
        - exists within a metadir controlling .bzr
2386
 
        - includes an explicit version marker for the workingtree control
2387
 
          files, separate from the BzrDir format
2388
 
        - modifies the hash cache format
2389
 
        - is new in bzr 0.8
2390
 
        - uses a LockDir to guard access for writes.
2391
 
    """
2392
 
 
2393
 
    def get_format_string(self):
2394
 
        """See WorkingTreeFormat.get_format_string()."""
2395
 
        return "Bazaar-NG Working Tree format 3"
2396
 
 
2397
 
    def get_format_description(self):
2398
 
        """See WorkingTreeFormat.get_format_description()."""
2399
 
        return "Working tree format 3"
2400
 
 
2401
 
    _lock_file_name = 'lock'
2402
 
    _lock_class = LockDir
2403
 
 
2404
 
    def _open_control_files(self, a_bzrdir):
2405
 
        transport = a_bzrdir.get_workingtree_transport(None)
2406
 
        return LockableFiles(transport, self._lock_file_name, 
2407
 
                             self._lock_class)
2408
 
 
2409
 
    def initialize(self, a_bzrdir, revision_id=None):
2410
 
        """See WorkingTreeFormat.initialize().
2411
 
        
2412
 
        revision_id allows creating a working tree at a different
2413
 
        revision than the branch is at.
2414
 
        """
2415
 
        if not isinstance(a_bzrdir.transport, LocalTransport):
2416
 
            raise errors.NotLocalUrl(a_bzrdir.transport.base)
2417
 
        transport = a_bzrdir.get_workingtree_transport(self)
2418
 
        control_files = self._open_control_files(a_bzrdir)
2419
 
        control_files.create_lock()
2420
 
        control_files.lock_write()
2421
 
        control_files.put_utf8('format', self.get_format_string())
2422
 
        branch = a_bzrdir.open_branch()
2423
 
        if revision_id is None:
2424
 
            revision_id = branch.last_revision()
2425
 
        else:
2426
 
            revision_id = osutils.safe_revision_id(revision_id)
2427
 
        # WorkingTree3 can handle an inventory which has a unique root id.
2428
 
        # as of bzr 0.12. However, bzr 0.11 and earlier fail to handle
2429
 
        # those trees. And because there isn't a format bump inbetween, we
2430
 
        # are maintaining compatibility with older clients.
2431
 
        # inv = Inventory(root_id=gen_root_id())
2432
 
        inv = Inventory()
2433
 
        wt = WorkingTree3(a_bzrdir.root_transport.local_abspath('.'),
2434
 
                         branch,
2435
 
                         inv,
2436
 
                         _internal=True,
2437
 
                         _format=self,
2438
 
                         _bzrdir=a_bzrdir,
2439
 
                         _control_files=control_files)
2440
 
        wt.lock_tree_write()
2441
 
        try:
2442
 
            basis_tree = branch.repository.revision_tree(revision_id)
2443
 
            # only set an explicit root id if there is one to set.
2444
 
            if basis_tree.inventory.root is not None:
2445
 
                wt.set_root_id(basis_tree.inventory.root.file_id)
2446
 
            if revision_id == NULL_REVISION:
2447
 
                wt.set_parent_trees([])
2448
 
            else:
2449
 
                wt.set_parent_trees([(revision_id, basis_tree)])
2450
 
            transform.build_tree(basis_tree, wt)
2451
 
        finally:
2452
 
            # Unlock in this order so that the unlock-triggers-flush in
2453
 
            # WorkingTree is given a chance to fire.
2454
 
            control_files.unlock()
2455
 
            wt.unlock()
2456
 
        return wt
2457
 
 
2458
 
    def __init__(self):
2459
 
        super(WorkingTreeFormat3, self).__init__()
2460
 
        self._matchingbzrdir = bzrdir.BzrDirMetaFormat1()
2461
 
 
2462
 
    def open(self, a_bzrdir, _found=False):
2463
 
        """Return the WorkingTree object for a_bzrdir
2464
 
 
2465
 
        _found is a private parameter, do not use it. It is used to indicate
2466
 
               if format probing has already been done.
2467
 
        """
2468
 
        if not _found:
2469
 
            # we are being called directly and must probe.
2470
 
            raise NotImplementedError
2471
 
        if not isinstance(a_bzrdir.transport, LocalTransport):
2472
 
            raise errors.NotLocalUrl(a_bzrdir.transport.base)
2473
 
        return self._open(a_bzrdir, self._open_control_files(a_bzrdir))
2474
 
 
2475
 
    def _open(self, a_bzrdir, control_files):
2476
 
        """Open the tree itself.
2477
 
        
2478
 
        :param a_bzrdir: the dir for the tree.
2479
 
        :param control_files: the control files for the tree.
2480
 
        """
2481
 
        return WorkingTree3(a_bzrdir.root_transport.local_abspath('.'),
2482
 
                           _internal=True,
2483
 
                           _format=self,
2484
 
                           _bzrdir=a_bzrdir,
2485
 
                           _control_files=control_files)
2486
 
 
2487
 
    def __str__(self):
2488
 
        return self.get_format_string()
2489
 
 
2490
 
 
2491
 
__default_format = WorkingTreeFormat3()
2492
 
WorkingTreeFormat.register_format(__default_format)
2493
 
WorkingTreeFormat.register_format(WorkingTreeFormat4())
2494
 
WorkingTreeFormat.set_default_format(__default_format)
2495
 
# formats which have no format string are not discoverable
2496
 
# and not independently creatable, so are not registered.
2497
 
_legacy_formats = [WorkingTreeFormat2(),
2498
 
                   ]
2499
 
 
2500
 
 
2501
 
class WorkingTreeTestProviderAdapter(object):
2502
 
    """A tool to generate a suite testing multiple workingtree formats at once.
2503
 
 
2504
 
    This is done by copying the test once for each transport and injecting
2505
 
    the transport_server, transport_readonly_server, and workingtree_format
2506
 
    classes into each copy. Each copy is also given a new id() to make it
2507
 
    easy to identify.
2508
 
    """
2509
 
 
2510
 
    def __init__(self, transport_server, transport_readonly_server, formats):
2511
 
        self._transport_server = transport_server
2512
 
        self._transport_readonly_server = transport_readonly_server
2513
 
        self._formats = formats
2514
 
    
2515
 
    def _clone_test(self, test, bzrdir_format, workingtree_format, variation):
2516
 
        """Clone test for adaption."""
2517
 
        new_test = deepcopy(test)
2518
 
        new_test.transport_server = self._transport_server
2519
 
        new_test.transport_readonly_server = self._transport_readonly_server
2520
 
        new_test.bzrdir_format = bzrdir_format
2521
 
        new_test.workingtree_format = workingtree_format
2522
 
        def make_new_test_id():
2523
 
            new_id = "%s(%s)" % (test.id(), variation)
2524
 
            return lambda: new_id
2525
 
        new_test.id = make_new_test_id()
2526
 
        return new_test
2527
 
    
2528
 
    def adapt(self, test):
2529
 
        from bzrlib.tests import TestSuite
2530
 
        result = TestSuite()
2531
 
        for workingtree_format, bzrdir_format in self._formats:
2532
 
            new_test = self._clone_test(
2533
 
                test,
2534
 
                bzrdir_format,
2535
 
                workingtree_format, workingtree_format.__class__.__name__)
2536
 
            result.addTest(new_test)
2537
 
        return result
 
3092
        format_registry.remove(format)
 
3093
 
 
3094
 
 
3095
format_registry.register_lazy("Bazaar Working Tree Format 4 (bzr 0.15)\n",
 
3096
    "bzrlib.workingtree_4", "WorkingTreeFormat4")
 
3097
format_registry.register_lazy("Bazaar Working Tree Format 5 (bzr 1.11)\n",
 
3098
    "bzrlib.workingtree_4", "WorkingTreeFormat5")
 
3099
format_registry.register_lazy("Bazaar Working Tree Format 6 (bzr 1.14)\n",
 
3100
    "bzrlib.workingtree_4", "WorkingTreeFormat6")
 
3101
format_registry.register_lazy("Bazaar-NG Working Tree format 3",
 
3102
    "bzrlib.workingtree_3", "WorkingTreeFormat3")
 
3103
format_registry.set_default_key("Bazaar Working Tree Format 6 (bzr 1.14)\n")