/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/workingtree.py

  • Committer: Ian Clatworthy
  • Date: 2008-04-17 08:21:14 UTC
  • mto: (4171.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 4173.
  • Revision ID: ian.clatworthy@canonical.com-20080417082114-76imbiarcbj16ov3
first cut at working tree content filtering

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2005, 2006, 2007 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  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)
32
38
 
33
39
from cStringIO import StringIO
34
40
import os
42
48
import itertools
43
49
import operator
44
50
import stat
 
51
from time import time
 
52
import warnings
45
53
import re
46
54
 
47
55
import bzrlib
49
57
    branch,
50
58
    bzrdir,
51
59
    conflicts as _mod_conflicts,
 
60
    dirstate,
52
61
    errors,
53
62
    generate_ids,
54
63
    globbing,
55
 
    graph as _mod_graph,
56
64
    hashcache,
57
65
    ignores,
58
 
    inventory,
59
66
    merge,
60
67
    revision as _mod_revision,
61
68
    revisiontree,
 
69
    repository,
 
70
    textui,
62
71
    trace,
63
72
    transform,
64
73
    ui,
65
 
    views,
 
74
    urlutils,
66
75
    xml5,
 
76
    xml6,
67
77
    xml7,
68
78
    )
69
79
import bzrlib.branch
70
80
from bzrlib.transport import get_transport
71
 
from bzrlib.workingtree_4 import (
72
 
    WorkingTreeFormat4,
73
 
    WorkingTreeFormat5,
74
 
    WorkingTreeFormat6,
75
 
    )
 
81
import bzrlib.ui
 
82
from bzrlib.workingtree_4 import WorkingTreeFormat4
76
83
""")
77
84
 
78
85
from bzrlib import symbol_versioning
79
86
from bzrlib.decorators import needs_read_lock, needs_write_lock
80
 
from bzrlib.lock import LogicalLockResult
81
 
from bzrlib.lockable_files import LockableFiles
 
87
from bzrlib.inventory import InventoryEntry, Inventory, ROOT_ID, TreeReference
 
88
from bzrlib.lockable_files import LockableFiles, TransportLock
82
89
from bzrlib.lockdir import LockDir
83
90
import bzrlib.mutabletree
84
91
from bzrlib.mutabletree import needs_tree_write_lock
85
92
from bzrlib import osutils
86
93
from bzrlib.osutils import (
 
94
    compact_date,
87
95
    file_kind,
88
96
    isdir,
89
97
    normpath,
90
98
    pathjoin,
 
99
    rand_chars,
91
100
    realpath,
92
101
    safe_unicode,
93
102
    splitpath,
94
103
    supports_executable,
95
104
    )
96
 
from bzrlib.filters import filtered_input_file
 
105
from bzrlib.filters import filtered_input, filters_for_path
97
106
from bzrlib.trace import mutter, note
98
107
from bzrlib.transport.local import LocalTransport
99
 
from bzrlib.revision import CURRENT_REVISION
 
108
from bzrlib.progress import DummyProgress, ProgressPhase
 
109
from bzrlib.revision import NULL_REVISION, CURRENT_REVISION
100
110
from bzrlib.rio import RioReader, rio_file, Stanza
101
 
from bzrlib.symbol_versioning import (
102
 
    deprecated_passed,
103
 
    DEPRECATED_PARAMETER,
104
 
    )
 
111
from bzrlib.symbol_versioning import (deprecated_passed,
 
112
        deprecated_method,
 
113
        deprecated_function,
 
114
        DEPRECATED_PARAMETER,
 
115
        zero_eight,
 
116
        zero_eleven,
 
117
        zero_thirteen,
 
118
        )
105
119
 
106
120
 
107
121
MERGE_MODIFIED_HEADER_1 = "BZR merge-modified list format 1"
108
 
# TODO: Modifying the conflict objects or their type is currently nearly
109
 
# impossible as there is no clear relationship between the working tree format
110
 
# and the conflict list file format.
111
122
CONFLICT_HEADER_1 = "BZR conflict list format 1"
112
123
 
113
124
ERROR_PATH_NOT_FOUND = 3    # WindowsError errno code, equivalent to ENOENT
114
125
 
115
126
 
 
127
@deprecated_function(zero_thirteen)
 
128
def gen_file_id(name):
 
129
    """Return new file id for the basename 'name'.
 
130
 
 
131
    Use bzrlib.generate_ids.gen_file_id() instead
 
132
    """
 
133
    return generate_ids.gen_file_id(name)
 
134
 
 
135
 
 
136
@deprecated_function(zero_thirteen)
 
137
def gen_root_id():
 
138
    """Return a new tree-root file id.
 
139
 
 
140
    This has been deprecated in favor of bzrlib.generate_ids.gen_root_id()
 
141
    """
 
142
    return generate_ids.gen_root_id()
 
143
 
 
144
 
116
145
class TreeEntry(object):
117
146
    """An entry that implements the minimum interface used by commands.
118
147
 
119
 
    This needs further inspection, it may be better to have
 
148
    This needs further inspection, it may be better to have 
120
149
    InventoryEntries without ids - though that seems wrong. For now,
121
150
    this is a parallel hierarchy to InventoryEntry, and needs to become
122
151
    one of several things: decorates to that hierarchy, children of, or
125
154
    no InventoryEntry available - i.e. for unversioned objects.
126
155
    Perhaps they should be UnversionedEntry et al. ? - RBC 20051003
127
156
    """
128
 
 
 
157
 
129
158
    def __eq__(self, other):
130
159
        # yes, this us ugly, TODO: best practice __eq__ style.
131
160
        return (isinstance(other, TreeEntry)
132
161
                and other.__class__ == self.__class__)
133
 
 
 
162
 
134
163
    def kind_character(self):
135
164
        return "???"
136
165
 
168
197
        return ''
169
198
 
170
199
 
171
 
class WorkingTree(bzrlib.mutabletree.MutableTree,
172
 
    bzrdir.ControlComponent):
 
200
class WorkingTree(bzrlib.mutabletree.MutableTree):
173
201
    """Working copy tree.
174
202
 
175
203
    The inventory is held in the `Branch` working-inventory, and the
179
207
    not listed in the Inventory and vice versa.
180
208
    """
181
209
 
182
 
    # override this to set the strategy for storing views
183
 
    def _make_views(self):
184
 
        return views.DisabledViews(self)
185
 
 
186
210
    def __init__(self, basedir='.',
187
211
                 branch=DEPRECATED_PARAMETER,
188
212
                 _inventory=None,
199
223
        if not _internal:
200
224
            raise errors.BzrError("Please use bzrdir.open_workingtree or "
201
225
                "WorkingTree.open() to obtain a WorkingTree.")
 
226
        assert isinstance(basedir, basestring), \
 
227
            "base directory %r is not a string" % basedir
202
228
        basedir = safe_unicode(basedir)
203
229
        mutter("opening working tree %r", basedir)
204
230
        if deprecated_passed(branch):
212
238
            self._control_files = self.branch.control_files
213
239
        else:
214
240
            # assume all other formats have their own control files.
 
241
            assert isinstance(_control_files, LockableFiles), \
 
242
                    "_control_files must be a LockableFiles, not %r" \
 
243
                    % _control_files
215
244
            self._control_files = _control_files
216
 
        self._transport = self._control_files._transport
217
245
        # update the whole cache up front and write to disk if anything changed;
218
246
        # in the future we might want to do this more selectively
219
247
        # two possible ways offer themselves : in self._unlock, write the cache
223
251
        wt_trans = self.bzrdir.get_workingtree_transport(None)
224
252
        cache_filename = wt_trans.local_abspath('stat-cache')
225
253
        self._hashcache = hashcache.HashCache(basedir, cache_filename,
226
 
            self.bzrdir._get_file_mode(),
227
 
            self._content_filter_stack_provider())
 
254
                                              self._control_files._file_mode)
228
255
        hc = self._hashcache
229
256
        hc.read()
230
257
        # is this scan needed ? it makes things kinda slow.
245
272
            # permitted to do this.
246
273
            self._set_inventory(_inventory, dirty=False)
247
274
        self._detect_case_handling()
248
 
        self._rules_searcher = None
249
 
        self.views = self._make_views()
250
 
 
251
 
    @property
252
 
    def user_transport(self):
253
 
        return self.bzrdir.user_transport
254
 
 
255
 
    @property
256
 
    def control_transport(self):
257
 
        return self._transport
258
275
 
259
276
    def _detect_case_handling(self):
260
277
        wt_trans = self.bzrdir.get_workingtree_transport(None)
286
303
        self._control_files.break_lock()
287
304
        self.branch.break_lock()
288
305
 
289
 
    def _get_check_refs(self):
290
 
        """Return the references needed to perform a check of this tree.
291
 
        
292
 
        The default implementation returns no refs, and is only suitable for
293
 
        trees that have no local caching and can commit on ghosts at any time.
294
 
 
295
 
        :seealso: bzrlib.check for details about check_refs.
296
 
        """
297
 
        return []
298
 
 
299
306
    def requires_rich_root(self):
300
307
        return self._format.requires_rich_root
301
308
 
302
309
    def supports_tree_reference(self):
303
310
        return False
304
311
 
305
 
    def supports_content_filtering(self):
306
 
        return self._format.supports_content_filtering()
307
 
 
308
 
    def supports_views(self):
309
 
        return self.views.supports_views()
310
 
 
311
312
    def _set_inventory(self, inv, dirty):
312
313
        """Set the internal cached inventory.
313
314
 
318
319
            False then the inventory is the same as that on disk and any
319
320
            serialisation would be unneeded overhead.
320
321
        """
 
322
        assert inv.root is not None
321
323
        self._inventory = inv
322
324
        self._inventory_is_modified = dirty
323
325
 
327
329
 
328
330
        """
329
331
        if path is None:
330
 
            path = osutils.getcwd()
 
332
            path = os.path.getcwdu()
331
333
        control = bzrdir.BzrDir.open(path, _unsupported)
332
334
        return control.open_workingtree(_unsupported)
333
 
 
 
335
        
334
336
    @staticmethod
335
337
    def open_containing(path=None):
336
338
        """Open an existing working tree which has its root about path.
337
 
 
 
339
        
338
340
        This probes for a working tree at path and searches upwards from there.
339
341
 
340
342
        Basically we keep looking up until we find the control directory or
401
403
 
402
404
    def basis_tree(self):
403
405
        """Return RevisionTree for the current last revision.
404
 
 
 
406
        
405
407
        If the left most parent is a ghost then the returned tree will be an
406
 
        empty tree - one obtained by calling
407
 
        repository.revision_tree(NULL_REVISION).
 
408
        empty tree - one obtained by calling repository.revision_tree(None).
408
409
        """
409
410
        try:
410
411
            revision_id = self.get_parent_ids()[0]
412
413
            # no parents, return an empty revision tree.
413
414
            # in the future this should return the tree for
414
415
            # 'empty:' - the implicit root empty tree.
415
 
            return self.branch.repository.revision_tree(
416
 
                       _mod_revision.NULL_REVISION)
 
416
            return self.branch.repository.revision_tree(None)
417
417
        try:
418
418
            return self.revision_tree(revision_id)
419
419
        except errors.NoSuchRevision:
423
423
        # at this point ?
424
424
        try:
425
425
            return self.branch.repository.revision_tree(revision_id)
426
 
        except (errors.RevisionNotPresent, errors.NoSuchRevision):
 
426
        except errors.RevisionNotPresent:
427
427
            # the basis tree *may* be a ghost or a low level error may have
428
 
            # occurred. If the revision is present, its a problem, if its not
 
428
            # occured. If the revision is present, its a problem, if its not
429
429
            # its a ghost.
430
430
            if self.branch.repository.has_revision(revision_id):
431
431
                raise
432
432
            # the basis tree is a ghost so return an empty tree.
433
 
            return self.branch.repository.revision_tree(
434
 
                       _mod_revision.NULL_REVISION)
 
433
            return self.branch.repository.revision_tree(None)
435
434
 
436
435
    def _cleanup(self):
437
436
        self._flush_ignore_list_cache()
438
437
 
 
438
    @staticmethod
 
439
    @deprecated_method(zero_eight)
 
440
    def create(branch, directory):
 
441
        """Create a workingtree for branch at directory.
 
442
 
 
443
        If existing_directory already exists it must have a .bzr directory.
 
444
        If it does not exist, it will be created.
 
445
 
 
446
        This returns a new WorkingTree object for the new checkout.
 
447
 
 
448
        TODO FIXME RBC 20060124 when we have checkout formats in place this
 
449
        should accept an optional revisionid to checkout [and reject this if
 
450
        checking out into the same dir as a pre-checkout-aware branch format.]
 
451
 
 
452
        XXX: When BzrDir is present, these should be created through that 
 
453
        interface instead.
 
454
        """
 
455
        warnings.warn('delete WorkingTree.create', stacklevel=3)
 
456
        transport = get_transport(directory)
 
457
        if branch.bzrdir.root_transport.base == transport.base:
 
458
            # same dir 
 
459
            return branch.bzrdir.create_workingtree()
 
460
        # different directory, 
 
461
        # create a branch reference
 
462
        # and now a working tree.
 
463
        raise NotImplementedError
 
464
 
 
465
    @staticmethod
 
466
    @deprecated_method(zero_eight)
 
467
    def create_standalone(directory):
 
468
        """Create a checkout and a branch and a repo at directory.
 
469
 
 
470
        Directory must exist and be empty.
 
471
 
 
472
        please use BzrDir.create_standalone_workingtree
 
473
        """
 
474
        return bzrdir.BzrDir.create_standalone_workingtree(directory)
 
475
 
439
476
    def relpath(self, path):
440
477
        """Return the local path portion from a given path.
441
 
 
442
 
        The path may be absolute or relative. If its a relative path it is
 
478
        
 
479
        The path may be absolute or relative. If its a relative path it is 
443
480
        interpreted relative to the python current working directory.
444
481
        """
445
482
        return osutils.relpath(self.basedir, path)
447
484
    def has_filename(self, filename):
448
485
        return osutils.lexists(self.abspath(filename))
449
486
 
450
 
    def get_file(self, file_id, path=None, filtered=True):
451
 
        return self.get_file_with_stat(file_id, path, filtered=filtered)[0]
452
 
 
453
 
    def get_file_with_stat(self, file_id, path=None, filtered=True,
454
 
        _fstat=os.fstat):
455
 
        """See Tree.get_file_with_stat."""
 
487
    def get_file(self, file_id, path=None):
456
488
        if path is None:
457
489
            path = self.id2path(file_id)
458
 
        file_obj = self.get_file_byname(path, filtered=False)
459
 
        stat_value = _fstat(file_obj.fileno())
460
 
        if filtered and self.supports_content_filtering():
461
 
            filters = self._content_filter_stack(path)
462
 
            file_obj = filtered_input_file(file_obj, filters)
463
 
        return (file_obj, stat_value)
464
 
 
465
 
    def get_file_text(self, file_id, path=None, filtered=True):
466
 
        return self.get_file(file_id, path=path, filtered=filtered).read()
467
 
 
468
 
    def get_file_byname(self, filename, filtered=True):
 
490
        return self.get_file_byname(path)
 
491
 
 
492
    def get_file_text(self, file_id):
 
493
        return self.get_file(file_id).read()
 
494
 
 
495
    def get_file_byname(self, filename):
469
496
        path = self.abspath(filename)
470
 
        f = file(path, 'rb')
471
 
        if filtered and self.supports_content_filtering():
472
 
            filters = self._content_filter_stack(filename)
473
 
            return filtered_input_file(f, filters)
474
 
        else:
475
 
            return f
476
 
 
477
 
    def get_file_lines(self, file_id, path=None, filtered=True):
478
 
        """See Tree.get_file_lines()"""
479
 
        file = self.get_file(file_id, path, filtered=filtered)
480
 
        try:
481
 
            return file.readlines()
482
 
        finally:
483
 
            file.close()
 
497
        filters = filters_for_path(path)
 
498
        return filtered_input(file(path, 'rb'), filters)
484
499
 
485
500
    @needs_read_lock
486
501
    def annotate_iter(self, file_id, default_revision=CURRENT_REVISION):
493
508
        incorrectly attributed to CURRENT_REVISION (but after committing, the
494
509
        attribution will be correct).
495
510
        """
496
 
        maybe_file_parent_keys = []
497
 
        for parent_id in self.get_parent_ids():
498
 
            try:
499
 
                parent_tree = self.revision_tree(parent_id)
500
 
            except errors.NoSuchRevisionInTree:
501
 
                parent_tree = self.branch.repository.revision_tree(parent_id)
502
 
            parent_tree.lock_read()
503
 
            try:
504
 
                if file_id not in parent_tree:
505
 
                    continue
506
 
                ie = parent_tree.inventory[file_id]
507
 
                if ie.kind != 'file':
508
 
                    # Note: this is slightly unnecessary, because symlinks and
509
 
                    # directories have a "text" which is the empty text, and we
510
 
                    # know that won't mess up annotations. But it seems cleaner
511
 
                    continue
512
 
                parent_text_key = (file_id, ie.revision)
513
 
                if parent_text_key not in maybe_file_parent_keys:
514
 
                    maybe_file_parent_keys.append(parent_text_key)
515
 
            finally:
516
 
                parent_tree.unlock()
517
 
        graph = _mod_graph.Graph(self.branch.repository.texts)
518
 
        heads = graph.heads(maybe_file_parent_keys)
519
 
        file_parent_keys = []
520
 
        for key in maybe_file_parent_keys:
521
 
            if key in heads:
522
 
                file_parent_keys.append(key)
523
 
 
524
 
        # Now we have the parents of this content
525
 
        annotator = self.branch.repository.texts.get_annotator()
526
 
        text = self.get_file(file_id).read()
527
 
        this_key =(file_id, default_revision)
528
 
        annotator.add_special_text(this_key, file_parent_keys, text)
529
 
        annotations = [(key[-1], line)
530
 
                       for key, line in annotator.annotate_flat(this_key)]
531
 
        return annotations
 
511
        basis = self.basis_tree()
 
512
        basis.lock_read()
 
513
        try:
 
514
            changes = self.iter_changes(basis, True, [self.id2path(file_id)],
 
515
                require_versioned=True).next()
 
516
            changed_content, kind = changes[2], changes[6]
 
517
            if not changed_content:
 
518
                return basis.annotate_iter(file_id)
 
519
            if kind[1] is None:
 
520
                return None
 
521
            import annotate
 
522
            if kind[0] != 'file':
 
523
                old_lines = []
 
524
            else:
 
525
                old_lines = list(basis.annotate_iter(file_id))
 
526
            old = [old_lines]
 
527
            for tree in self.branch.repository.revision_trees(
 
528
                self.get_parent_ids()[1:]):
 
529
                if file_id not in tree:
 
530
                    continue
 
531
                old.append(list(tree.annotate_iter(file_id)))
 
532
            return annotate.reannotate(old, self.get_file(file_id).readlines(),
 
533
                                       default_revision)
 
534
        finally:
 
535
            basis.unlock()
532
536
 
533
537
    def _get_ancestors(self, default_revision):
534
538
        ancestors = set([default_revision])
539
543
 
540
544
    def get_parent_ids(self):
541
545
        """See Tree.get_parent_ids.
542
 
 
 
546
        
543
547
        This implementation reads the pending merges list and last_revision
544
548
        value and uses that to decide what the parents list should be.
545
549
        """
549
553
        else:
550
554
            parents = [last_rev]
551
555
        try:
552
 
            merges_bytes = self._transport.get_bytes('pending-merges')
 
556
            merges_file = self._control_files.get('pending-merges')
553
557
        except errors.NoSuchFile:
554
558
            pass
555
559
        else:
556
 
            for l in osutils.split_lines(merges_bytes):
 
560
            for l in merges_file.readlines():
557
561
                revision_id = l.rstrip('\n')
558
562
                parents.append(revision_id)
559
563
        return parents
562
566
    def get_root_id(self):
563
567
        """Return the id of this trees root"""
564
568
        return self._inventory.root.file_id
565
 
 
 
569
        
566
570
    def _get_store_filename(self, file_id):
567
571
        ## XXX: badly named; this is not in the store at all
568
572
        return self.abspath(self.id2path(file_id))
570
574
    @needs_read_lock
571
575
    def clone(self, to_bzrdir, revision_id=None):
572
576
        """Duplicate this working tree into to_bzr, including all state.
573
 
 
 
577
        
574
578
        Specifically modified files are kept as modified, but
575
579
        ignored and unknown files are discarded.
576
580
 
577
581
        If you want to make a new line of development, see bzrdir.sprout()
578
582
 
579
583
        revision
580
 
            If not None, the cloned tree will have its last revision set to
581
 
            revision, and difference between the source trees last revision
 
584
            If not None, the cloned tree will have its last revision set to 
 
585
            revision, and and difference between the source trees last revision
582
586
            and this one merged in.
583
587
        """
584
588
        # assumes the target bzr dir format is compatible.
585
 
        result = to_bzrdir.create_workingtree()
 
589
        result = self._format.initialize(to_bzrdir)
586
590
        self.copy_content_into(result, revision_id)
587
591
        return result
588
592
 
617
621
    __contains__ = has_id
618
622
 
619
623
    def get_file_size(self, file_id):
620
 
        """See Tree.get_file_size"""
621
 
        # XXX: this returns the on-disk size; it should probably return the
622
 
        # canonical size
623
 
        try:
624
 
            return os.path.getsize(self.id2abspath(file_id))
625
 
        except OSError, e:
626
 
            if e.errno != errno.ENOENT:
627
 
                raise
628
 
            else:
629
 
                return None
 
624
        return os.path.getsize(self.id2abspath(file_id))
630
625
 
631
626
    @needs_read_lock
632
627
    def get_file_sha1(self, file_id, path=None, stat_value=None):
641
636
 
642
637
    def _is_executable_from_path_and_stat_from_basis(self, path, stat_result):
643
638
        file_id = self.path2id(path)
644
 
        if file_id is None:
645
 
            # For unversioned files on win32, we just assume they are not
646
 
            # executable
647
 
            return False
648
639
        return self._inventory[file_id].executable
649
640
 
650
641
    def _is_executable_from_path_and_stat_from_stat(self, path, stat_result):
672
663
        """See MutableTree._add."""
673
664
        # TODO: Re-adding a file that is removed in the working copy
674
665
        # should probably put it back with the previous ID.
675
 
        # the read and write working inventory should not occur in this
 
666
        # the read and write working inventory should not occur in this 
676
667
        # function - they should be part of lock_write and unlock.
677
668
        inv = self.inventory
678
669
        for f, file_id, kind in zip(files, ids, kinds):
 
670
            assert kind is not None
679
671
            if file_id is None:
680
672
                inv.add_path(f, kind=kind)
681
673
            else:
760
752
            raise
761
753
        kind = _mapper(stat_result.st_mode)
762
754
        if kind == 'file':
763
 
            return self._file_content_summary(path, stat_result)
 
755
            size = stat_result.st_size
 
756
            # try for a stat cache lookup
 
757
            executable = self._is_executable_from_path_and_stat(path, stat_result)
 
758
            return (kind, size, executable, self._sha_from_stat(
 
759
                path, stat_result))
764
760
        elif kind == 'directory':
765
761
            # perhaps it looks like a plain directory, but it's really a
766
762
            # reference.
768
764
                kind = 'tree-reference'
769
765
            return kind, None, None, None
770
766
        elif kind == 'symlink':
771
 
            target = osutils.readlink(abspath)
772
 
            return ('symlink', None, None, target)
 
767
            return ('symlink', None, None, os.readlink(abspath))
773
768
        else:
774
769
            return (kind, None, None, None)
775
770
 
776
 
    def _file_content_summary(self, path, stat_result):
777
 
        size = stat_result.st_size
778
 
        executable = self._is_executable_from_path_and_stat(path, stat_result)
779
 
        # try for a stat cache lookup
780
 
        return ('file', size, executable, self._sha_from_stat(
781
 
            path, stat_result))
 
771
    @deprecated_method(zero_eleven)
 
772
    @needs_read_lock
 
773
    def pending_merges(self):
 
774
        """Return a list of pending merges.
 
775
 
 
776
        These are revisions that have been merged into the working
 
777
        directory but not yet committed.
 
778
 
 
779
        As of 0.11 this is deprecated. Please see WorkingTree.get_parent_ids()
 
780
        instead - which is available on all tree objects.
 
781
        """
 
782
        return self.get_parent_ids()[1:]
782
783
 
783
784
    def _check_parents_for_ghosts(self, revision_ids, allow_leftmost_as_ghost):
784
785
        """Common ghost checking functionality from set_parent_*.
794
795
 
795
796
    def _set_merges_from_parent_ids(self, parent_ids):
796
797
        merges = parent_ids[1:]
797
 
        self._transport.put_bytes('pending-merges', '\n'.join(merges),
798
 
            mode=self.bzrdir._get_file_mode())
799
 
 
800
 
    def _filter_parent_ids_by_ancestry(self, revision_ids):
801
 
        """Check that all merged revisions are proper 'heads'.
802
 
 
803
 
        This will always return the first revision_id, and any merged revisions
804
 
        which are
805
 
        """
806
 
        if len(revision_ids) == 0:
807
 
            return revision_ids
808
 
        graph = self.branch.repository.get_graph()
809
 
        heads = graph.heads(revision_ids)
810
 
        new_revision_ids = revision_ids[:1]
811
 
        for revision_id in revision_ids[1:]:
812
 
            if revision_id in heads and revision_id not in new_revision_ids:
813
 
                new_revision_ids.append(revision_id)
814
 
        if new_revision_ids != revision_ids:
815
 
            trace.mutter('requested to set revision_ids = %s,'
816
 
                         ' but filtered to %s', revision_ids, new_revision_ids)
817
 
        return new_revision_ids
 
798
        self._control_files.put_bytes('pending-merges', '\n'.join(merges))
818
799
 
819
800
    @needs_tree_write_lock
820
801
    def set_parent_ids(self, revision_ids, allow_leftmost_as_ghost=False):
821
802
        """Set the parent ids to revision_ids.
822
 
 
 
803
        
823
804
        See also set_parent_trees. This api will try to retrieve the tree data
824
805
        for each element of revision_ids from the trees repository. If you have
825
806
        tree data already available, it is more efficient to use
834
815
        for revision_id in revision_ids:
835
816
            _mod_revision.check_not_reserved_id(revision_id)
836
817
 
837
 
        revision_ids = self._filter_parent_ids_by_ancestry(revision_ids)
838
 
 
839
818
        if len(revision_ids) > 0:
840
819
            self.set_last_revision(revision_ids[0])
841
820
        else:
853
832
        self._check_parents_for_ghosts(parent_ids,
854
833
            allow_leftmost_as_ghost=allow_leftmost_as_ghost)
855
834
 
856
 
        parent_ids = self._filter_parent_ids_by_ancestry(parent_ids)
857
 
 
858
835
        if len(parent_ids) == 0:
859
836
            leftmost_parent_id = _mod_revision.NULL_REVISION
860
837
            leftmost_parent_tree = None
900
877
    def _put_rio(self, filename, stanzas, header):
901
878
        self._must_be_locked()
902
879
        my_file = rio_file(stanzas, header)
903
 
        self._transport.put_file(filename, my_file,
904
 
            mode=self.bzrdir._get_file_mode())
 
880
        self._control_files.put(filename, my_file)
905
881
 
906
882
    @needs_write_lock # because merge pulls data into the branch.
907
883
    def merge_from_branch(self, branch, to_revision=None, from_revision=None,
908
 
                          merge_type=None, force=False):
 
884
        merge_type=None):
909
885
        """Merge from a branch into this working tree.
910
886
 
911
887
        :param branch: The branch to merge from.
915
891
            branch.last_revision().
916
892
        """
917
893
        from bzrlib.merge import Merger, Merge3Merger
918
 
        merger = Merger(self.branch, this_tree=self)
919
 
        # check that there are no local alterations
920
 
        if not force and self.has_changes():
921
 
            raise errors.UncommittedChanges(self)
922
 
        if to_revision is None:
923
 
            to_revision = _mod_revision.ensure_null(branch.last_revision())
924
 
        merger.other_rev_id = to_revision
925
 
        if _mod_revision.is_null(merger.other_rev_id):
926
 
            raise errors.NoCommits(branch)
927
 
        self.branch.fetch(branch, last_revision=merger.other_rev_id)
928
 
        merger.other_basis = merger.other_rev_id
929
 
        merger.other_tree = self.branch.repository.revision_tree(
930
 
            merger.other_rev_id)
931
 
        merger.other_branch = branch
932
 
        if from_revision is None:
933
 
            merger.find_base()
934
 
        else:
935
 
            merger.set_base_revision(from_revision, branch)
936
 
        if merger.base_rev_id == merger.other_rev_id:
937
 
            raise errors.PointlessMerge
938
 
        merger.backup_files = False
939
 
        if merge_type is None:
940
 
            merger.merge_type = Merge3Merger
941
 
        else:
942
 
            merger.merge_type = merge_type
943
 
        merger.set_interesting_files(None)
944
 
        merger.show_base = False
945
 
        merger.reprocess = False
946
 
        conflicts = merger.do_merge()
947
 
        merger.set_pending()
 
894
        pb = bzrlib.ui.ui_factory.nested_progress_bar()
 
895
        try:
 
896
            merger = Merger(self.branch, this_tree=self, pb=pb)
 
897
            merger.pp = ProgressPhase("Merge phase", 5, pb)
 
898
            merger.pp.next_phase()
 
899
            # check that there are no
 
900
            # local alterations
 
901
            merger.check_basis(check_clean=True, require_commits=False)
 
902
            if to_revision is None:
 
903
                to_revision = _mod_revision.ensure_null(branch.last_revision())
 
904
            merger.other_rev_id = to_revision
 
905
            if _mod_revision.is_null(merger.other_rev_id):
 
906
                raise errors.NoCommits(branch)
 
907
            self.branch.fetch(branch, last_revision=merger.other_rev_id)
 
908
            merger.other_basis = merger.other_rev_id
 
909
            merger.other_tree = self.branch.repository.revision_tree(
 
910
                merger.other_rev_id)
 
911
            merger.other_branch = branch
 
912
            merger.pp.next_phase()
 
913
            if from_revision is None:
 
914
                merger.find_base()
 
915
            else:
 
916
                merger.set_base_revision(from_revision, branch)
 
917
            if merger.base_rev_id == merger.other_rev_id:
 
918
                raise errors.PointlessMerge
 
919
            merger.backup_files = False
 
920
            if merge_type is None:
 
921
                merger.merge_type = Merge3Merger
 
922
            else:
 
923
                merger.merge_type = merge_type
 
924
            merger.set_interesting_files(None)
 
925
            merger.show_base = False
 
926
            merger.reprocess = False
 
927
            conflicts = merger.do_merge()
 
928
            merger.set_pending()
 
929
        finally:
 
930
            pb.finished()
948
931
        return conflicts
949
932
 
950
933
    @needs_read_lock
951
934
    def merge_modified(self):
952
935
        """Return a dictionary of files modified by a merge.
953
936
 
954
 
        The list is initialized by WorkingTree.set_merge_modified, which is
 
937
        The list is initialized by WorkingTree.set_merge_modified, which is 
955
938
        typically called after we make some automatic updates to the tree
956
939
        because of a merge.
957
940
 
959
942
        still in the working inventory and have that text hash.
960
943
        """
961
944
        try:
962
 
            hashfile = self._transport.get('merge-hashes')
 
945
            hashfile = self._control_files.get('merge-hashes')
963
946
        except errors.NoSuchFile:
964
947
            return {}
 
948
        merge_hashes = {}
965
949
        try:
966
 
            merge_hashes = {}
967
 
            try:
968
 
                if hashfile.next() != MERGE_MODIFIED_HEADER_1 + '\n':
969
 
                    raise errors.MergeModifiedFormatError()
970
 
            except StopIteration:
 
950
            if hashfile.next() != MERGE_MODIFIED_HEADER_1 + '\n':
971
951
                raise errors.MergeModifiedFormatError()
972
 
            for s in RioReader(hashfile):
973
 
                # RioReader reads in Unicode, so convert file_ids back to utf8
974
 
                file_id = osutils.safe_file_id(s.get("file_id"), warn=False)
975
 
                if file_id not in self.inventory:
976
 
                    continue
977
 
                text_hash = s.get("hash")
978
 
                if text_hash == self.get_file_sha1(file_id):
979
 
                    merge_hashes[file_id] = text_hash
980
 
            return merge_hashes
981
 
        finally:
982
 
            hashfile.close()
 
952
        except StopIteration:
 
953
            raise errors.MergeModifiedFormatError()
 
954
        for s in RioReader(hashfile):
 
955
            # RioReader reads in Unicode, so convert file_ids back to utf8
 
956
            file_id = osutils.safe_file_id(s.get("file_id"), warn=False)
 
957
            if file_id not in self.inventory:
 
958
                continue
 
959
            text_hash = s.get("hash")
 
960
            if text_hash == self.get_file_sha1(file_id):
 
961
                merge_hashes[file_id] = text_hash
 
962
        return merge_hashes
983
963
 
984
964
    @needs_write_lock
985
965
    def mkdir(self, path, file_id=None):
991
971
        return file_id
992
972
 
993
973
    def get_symlink_target(self, file_id):
994
 
        abspath = self.id2abspath(file_id)
995
 
        target = osutils.readlink(abspath)
996
 
        return target
 
974
        return os.readlink(self.id2abspath(file_id))
997
975
 
998
976
    @needs_write_lock
999
977
    def subsume(self, other_tree):
1049
1027
        return False
1050
1028
 
1051
1029
    def _directory_may_be_tree_reference(self, relpath):
1052
 
        # as a special case, if a directory contains control files then
 
1030
        # as a special case, if a directory contains control files then 
1053
1031
        # it's a tree reference, except that the root of the tree is not
1054
1032
        return relpath and osutils.isdir(self.abspath(relpath) + u"/.bzr")
1055
1033
        # TODO: We could ask all the control formats whether they
1066
1044
    @needs_tree_write_lock
1067
1045
    def extract(self, file_id, format=None):
1068
1046
        """Extract a subtree from this tree.
1069
 
 
 
1047
        
1070
1048
        A new branch will be created, relative to the path for this tree.
1071
1049
        """
1072
1050
        self.flush()
1077
1055
                transport = transport.clone(name)
1078
1056
                transport.ensure_base()
1079
1057
            return transport
1080
 
 
 
1058
            
1081
1059
        sub_path = self.id2path(file_id)
1082
1060
        branch_transport = mkdirs(sub_path)
1083
1061
        if format is None:
1097
1075
        tree_transport = self.bzrdir.root_transport.clone(sub_path)
1098
1076
        if tree_transport.base != branch_transport.base:
1099
1077
            tree_bzrdir = format.initialize_on_transport(tree_transport)
1100
 
            branch.BranchReferenceFormat().initialize(tree_bzrdir,
1101
 
                target_branch=new_branch)
 
1078
            branch.BranchReferenceFormat().initialize(tree_bzrdir, new_branch)
1102
1079
        else:
1103
1080
            tree_bzrdir = branch_bzrdir
1104
 
        wt = tree_bzrdir.create_workingtree(_mod_revision.NULL_REVISION)
 
1081
        wt = tree_bzrdir.create_workingtree(NULL_REVISION)
1105
1082
        wt.set_parent_ids(self.get_parent_ids())
1106
1083
        my_inv = self.inventory
1107
 
        child_inv = inventory.Inventory(root_id=None)
 
1084
        child_inv = Inventory(root_id=None)
1108
1085
        new_root = my_inv[file_id]
1109
1086
        my_inv.remove_recursive_id(file_id)
1110
1087
        new_root.parent_id = None
1128
1105
        sio = StringIO()
1129
1106
        self._serialize(self._inventory, sio)
1130
1107
        sio.seek(0)
1131
 
        self._transport.put_file('inventory', sio,
1132
 
            mode=self.bzrdir._get_file_mode())
 
1108
        self._control_files.put('inventory', sio)
1133
1109
        self._inventory_is_modified = False
1134
1110
 
1135
1111
    def _kind(self, relpath):
1136
1112
        return osutils.file_kind(self.abspath(relpath))
1137
1113
 
1138
 
    def list_files(self, include_root=False, from_dir=None, recursive=True):
1139
 
        """List all files as (path, class, kind, id, entry).
 
1114
    def list_files(self, include_root=False):
 
1115
        """Recursively list all files as (path, class, kind, id, entry).
1140
1116
 
1141
1117
        Lists, but does not descend into unversioned directories.
 
1118
 
1142
1119
        This does not include files that have been deleted in this
1143
 
        tree. Skips the control directory.
 
1120
        tree.
1144
1121
 
1145
 
        :param include_root: if True, return an entry for the root
1146
 
        :param from_dir: start from this directory or None for the root
1147
 
        :param recursive: whether to recurse into subdirectories or not
 
1122
        Skips the control directory.
1148
1123
        """
1149
1124
        # list_files is an iterator, so @needs_read_lock doesn't work properly
1150
1125
        # with it. So callers should be careful to always read_lock the tree.
1152
1127
            raise errors.ObjectNotLocked(self)
1153
1128
 
1154
1129
        inv = self.inventory
1155
 
        if from_dir is None and include_root is True:
 
1130
        if include_root is True:
1156
1131
            yield ('', 'V', 'directory', inv.root.file_id, inv.root)
1157
1132
        # Convert these into local objects to save lookup times
1158
1133
        pathjoin = osutils.pathjoin
1165
1140
        fk_entries = {'directory':TreeDirectory, 'file':TreeFile, 'symlink':TreeLink}
1166
1141
 
1167
1142
        # directory file_id, relative path, absolute path, reverse sorted children
1168
 
        if from_dir is not None:
1169
 
            from_dir_id = inv.path2id(from_dir)
1170
 
            if from_dir_id is None:
1171
 
                # Directory not versioned
1172
 
                return
1173
 
            from_dir_abspath = pathjoin(self.basedir, from_dir)
1174
 
        else:
1175
 
            from_dir_id = inv.root.file_id
1176
 
            from_dir_abspath = self.basedir
1177
 
        children = os.listdir(from_dir_abspath)
 
1143
        children = os.listdir(self.basedir)
1178
1144
        children.sort()
1179
 
        # jam 20060527 The kernel sized tree seems equivalent whether we
 
1145
        # jam 20060527 The kernel sized tree seems equivalent whether we 
1180
1146
        # use a deque and popleft to keep them sorted, or if we use a plain
1181
1147
        # list and just reverse() them.
1182
1148
        children = collections.deque(children)
1183
 
        stack = [(from_dir_id, u'', from_dir_abspath, children)]
 
1149
        stack = [(inv.root.file_id, u'', self.basedir, children)]
1184
1150
        while stack:
1185
1151
            from_dir_id, from_dir_relpath, from_dir_abspath, children = stack[-1]
1186
1152
 
1202
1168
 
1203
1169
                # absolute path
1204
1170
                fap = from_dir_abspath + '/' + f
1205
 
 
 
1171
                
1206
1172
                f_ie = inv.get_child(from_dir_id, f)
1207
1173
                if f_ie:
1208
1174
                    c = 'V'
1240
1206
                    except KeyError:
1241
1207
                        yield fp[1:], c, fk, None, TreeEntry()
1242
1208
                    continue
1243
 
 
 
1209
                
1244
1210
                if fk != 'directory':
1245
1211
                    continue
1246
1212
 
1247
 
                # But do this child first if recursing down
1248
 
                if recursive:
1249
 
                    new_children = os.listdir(fap)
1250
 
                    new_children.sort()
1251
 
                    new_children = collections.deque(new_children)
1252
 
                    stack.append((f_ie.file_id, fp, fap, new_children))
1253
 
                    # Break out of inner loop,
1254
 
                    # so that we start outer loop with child
1255
 
                    break
 
1213
                # But do this child first
 
1214
                new_children = os.listdir(fap)
 
1215
                new_children.sort()
 
1216
                new_children = collections.deque(new_children)
 
1217
                stack.append((f_ie.file_id, fp, fap, new_children))
 
1218
                # Break out of inner loop,
 
1219
                # so that we start outer loop with child
 
1220
                break
1256
1221
            else:
1257
1222
                # if we finished all children, pop it off the stack
1258
1223
                stack.pop()
1264
1229
        to_dir must exist in the inventory.
1265
1230
 
1266
1231
        If to_dir exists and is a directory, the files are moved into
1267
 
        it, keeping their old names.
 
1232
        it, keeping their old names.  
1268
1233
 
1269
1234
        Note that to_dir is only the last component of the new name;
1270
1235
        this doesn't change the directory.
1307
1272
                                       DeprecationWarning)
1308
1273
 
1309
1274
        # check destination directory
1310
 
        if isinstance(from_paths, basestring):
1311
 
            raise ValueError()
 
1275
        assert not isinstance(from_paths, basestring)
1312
1276
        inv = self.inventory
1313
1277
        to_abs = self.abspath(to_dir)
1314
1278
        if not isdir(to_abs):
1398
1362
                only_change_inv = True
1399
1363
            elif self.has_filename(from_rel) and not self.has_filename(to_rel):
1400
1364
                only_change_inv = False
1401
 
            elif (not self.case_sensitive
1402
 
                  and from_rel.lower() == to_rel.lower()
1403
 
                  and self.has_filename(from_rel)):
 
1365
            elif (sys.platform == 'win32'
 
1366
                and from_rel.lower() == to_rel.lower()
 
1367
                and self.has_filename(from_rel)):
1404
1368
                only_change_inv = False
1405
1369
            else:
1406
1370
                # something is wrong, so lets determine what exactly
1436
1400
        inv = self.inventory
1437
1401
        for entry in moved:
1438
1402
            try:
1439
 
                self._move_entry(WorkingTree._RenameEntry(
1440
 
                    entry.to_rel, entry.from_id,
 
1403
                self._move_entry(_RenameEntry(entry.to_rel, entry.from_id,
1441
1404
                    entry.to_tail, entry.to_parent_id, entry.from_rel,
1442
1405
                    entry.from_tail, entry.from_parent_id,
1443
1406
                    entry.only_change_inv))
1494
1457
        from_tail = splitpath(from_rel)[-1]
1495
1458
        from_id = inv.path2id(from_rel)
1496
1459
        if from_id is None:
1497
 
            # if file is missing in the inventory maybe it's in the basis_tree
1498
 
            basis_tree = self.branch.basis_tree()
1499
 
            from_id = basis_tree.path2id(from_rel)
1500
 
            if from_id is None:
1501
 
                raise errors.BzrRenameFailedError(from_rel,to_rel,
1502
 
                    errors.NotVersionedError(path=str(from_rel)))
1503
 
            # put entry back in the inventory so we can rename it
1504
 
            from_entry = basis_tree.inventory[from_id].copy()
1505
 
            inv.add(from_entry)
1506
 
        else:
1507
 
            from_entry = inv[from_id]
 
1460
            raise errors.BzrRenameFailedError(from_rel,to_rel,
 
1461
                errors.NotVersionedError(path=str(from_rel)))
 
1462
        from_entry = inv[from_id]
1508
1463
        from_parent_id = from_entry.parent_id
1509
1464
        to_dir, to_tail = os.path.split(to_rel)
1510
1465
        to_dir_id = inv.path2id(to_dir)
1556
1511
        These are files in the working directory that are not versioned or
1557
1512
        control files or ignored.
1558
1513
        """
1559
 
        # force the extras method to be fully executed before returning, to
 
1514
        # force the extras method to be fully executed before returning, to 
1560
1515
        # prevent race conditions with the lock
1561
1516
        return iter(
1562
1517
            [subp for subp in self.extras() if not self.is_ignored(subp)])
1572
1527
        :raises: NoSuchId if any fileid is not currently versioned.
1573
1528
        """
1574
1529
        for file_id in file_ids:
1575
 
            if file_id not in self._inventory:
1576
 
                raise errors.NoSuchId(self, file_id)
1577
 
        for file_id in file_ids:
1578
1530
            if self._inventory.has_id(file_id):
1579
1531
                self._inventory.remove_recursive_id(file_id)
 
1532
            else:
 
1533
                raise errors.NoSuchId(self, file_id)
1580
1534
        if len(file_ids):
1581
 
            # in the future this should just set a dirty bit to wait for the
 
1535
            # in the future this should just set a dirty bit to wait for the 
1582
1536
            # final unlock. However, until all methods of workingtree start
1583
 
            # with the current in -memory inventory rather than triggering
 
1537
            # with the current in -memory inventory rather than triggering 
1584
1538
            # a read, it is more complex - we need to teach read_inventory
1585
1539
            # to know when to read, and when to not read first... and possibly
1586
1540
            # to save first when the in memory one may be corrupted.
1587
1541
            # so for now, we just only write it if it is indeed dirty.
1588
1542
            # - RBC 20060907
1589
1543
            self._write_inventory(self._inventory)
 
1544
    
 
1545
    @deprecated_method(zero_eight)
 
1546
    def iter_conflicts(self):
 
1547
        """List all files in the tree that have text or content conflicts.
 
1548
        DEPRECATED.  Use conflicts instead."""
 
1549
        return self._iter_conflicts()
1590
1550
 
1591
1551
    def _iter_conflicts(self):
1592
1552
        conflicted = set()
1601
1561
 
1602
1562
    @needs_write_lock
1603
1563
    def pull(self, source, overwrite=False, stop_revision=None,
1604
 
             change_reporter=None, possible_transports=None, local=False):
 
1564
             change_reporter=None, possible_transports=None):
 
1565
        top_pb = bzrlib.ui.ui_factory.nested_progress_bar()
1605
1566
        source.lock_read()
1606
1567
        try:
 
1568
            pp = ProgressPhase("Pull phase", 2, top_pb)
 
1569
            pp.next_phase()
1607
1570
            old_revision_info = self.branch.last_revision_info()
1608
1571
            basis_tree = self.basis_tree()
1609
1572
            count = self.branch.pull(source, overwrite, stop_revision,
1610
 
                                     possible_transports=possible_transports,
1611
 
                                     local=local)
 
1573
                                     possible_transports=possible_transports)
1612
1574
            new_revision_info = self.branch.last_revision_info()
1613
1575
            if new_revision_info != old_revision_info:
 
1576
                pp.next_phase()
1614
1577
                repository = self.branch.repository
 
1578
                pb = bzrlib.ui.ui_factory.nested_progress_bar()
1615
1579
                basis_tree.lock_read()
1616
1580
                try:
1617
1581
                    new_basis_tree = self.branch.basis_tree()
1620
1584
                                new_basis_tree,
1621
1585
                                basis_tree,
1622
1586
                                this_tree=self,
1623
 
                                pb=None,
 
1587
                                pb=pb,
1624
1588
                                change_reporter=change_reporter)
1625
 
                    basis_root_id = basis_tree.get_root_id()
1626
 
                    new_root_id = new_basis_tree.get_root_id()
1627
 
                    if basis_root_id != new_root_id:
1628
 
                        self.set_root_id(new_root_id)
 
1589
                    if (basis_tree.inventory.root is None and
 
1590
                        new_basis_tree.inventory.root is not None):
 
1591
                        self.set_root_id(new_basis_tree.get_root_id())
1629
1592
                finally:
 
1593
                    pb.finished()
1630
1594
                    basis_tree.unlock()
1631
1595
                # TODO - dedup parents list with things merged by pull ?
1632
1596
                # reuse the revisiontree we merged against to set the new
1633
1597
                # tree data.
1634
1598
                parent_trees = [(self.branch.last_revision(), new_basis_tree)]
1635
 
                # we have to pull the merge trees out again, because
1636
 
                # merge_inner has set the ids. - this corner is not yet
 
1599
                # we have to pull the merge trees out again, because 
 
1600
                # merge_inner has set the ids. - this corner is not yet 
1637
1601
                # layered well enough to prevent double handling.
1638
1602
                # XXX TODO: Fix the double handling: telling the tree about
1639
1603
                # the already known parent data is wasteful.
1645
1609
            return count
1646
1610
        finally:
1647
1611
            source.unlock()
 
1612
            top_pb.finished()
1648
1613
 
1649
1614
    @needs_write_lock
1650
1615
    def put_file_bytes_non_atomic(self, file_id, bytes):
1676
1641
 
1677
1642
            fl = []
1678
1643
            for subf in os.listdir(dirabs):
1679
 
                if self.bzrdir.is_control_filename(subf):
 
1644
                if subf == '.bzr':
1680
1645
                    continue
1681
1646
                if subf not in dir_entry.children:
1682
 
                    try:
1683
 
                        (subf_norm,
1684
 
                         can_access) = osutils.normalized_filename(subf)
1685
 
                    except UnicodeDecodeError:
1686
 
                        path_os_enc = path.encode(osutils._fs_enc)
1687
 
                        relpath = path_os_enc + '/' + subf
1688
 
                        raise errors.BadFilenameEncoding(relpath,
1689
 
                                                         osutils._fs_enc)
 
1647
                    subf_norm, can_access = osutils.normalized_filename(subf)
1690
1648
                    if subf_norm != subf and can_access:
1691
1649
                        if subf_norm not in dir_entry.children:
1692
1650
                            fl.append(subf_norm)
1693
1651
                    else:
1694
1652
                        fl.append(subf)
1695
 
 
 
1653
            
1696
1654
            fl.sort()
1697
1655
            for subf in fl:
1698
1656
                subp = pathjoin(path, subf)
1735
1693
        r"""Check whether the filename matches an ignore pattern.
1736
1694
 
1737
1695
        Patterns containing '/' or '\' need to match the whole path;
1738
 
        others match against only the last component.  Patterns starting
1739
 
        with '!' are ignore exceptions.  Exceptions take precedence
1740
 
        over regular patterns and cause the filename to not be ignored.
 
1696
        others match against only the last component.
1741
1697
 
1742
1698
        If the file is ignored, returns the pattern which caused it to
1743
1699
        be ignored, otherwise None.  So this can simply be used as a
1744
1700
        boolean if desired."""
1745
1701
        if getattr(self, '_ignoreglobster', None) is None:
1746
 
            self._ignoreglobster = globbing.ExceptionGlobster(self.get_ignore_list())
 
1702
            self._ignoreglobster = globbing.Globster(self.get_ignore_list())
1747
1703
        return self._ignoreglobster.match(filename)
1748
1704
 
1749
1705
    def kind(self, file_id):
1799
1755
            raise errors.ObjectNotLocked(self)
1800
1756
 
1801
1757
    def lock_read(self):
1802
 
        """Lock the tree for reading.
1803
 
 
1804
 
        This also locks the branch, and can be unlocked via self.unlock().
1805
 
 
1806
 
        :return: A bzrlib.lock.LogicalLockResult.
1807
 
        """
 
1758
        """See Branch.lock_read, and WorkingTree.unlock."""
1808
1759
        if not self.is_locked():
1809
1760
            self._reset_data()
1810
1761
        self.branch.lock_read()
1811
1762
        try:
1812
 
            self._control_files.lock_read()
1813
 
            return LogicalLockResult(self.unlock)
 
1763
            return self._control_files.lock_read()
1814
1764
        except:
1815
1765
            self.branch.unlock()
1816
1766
            raise
1817
1767
 
1818
1768
    def lock_tree_write(self):
1819
 
        """See MutableTree.lock_tree_write, and WorkingTree.unlock.
1820
 
 
1821
 
        :return: A bzrlib.lock.LogicalLockResult.
1822
 
        """
 
1769
        """See MutableTree.lock_tree_write, and WorkingTree.unlock."""
1823
1770
        if not self.is_locked():
1824
1771
            self._reset_data()
1825
1772
        self.branch.lock_read()
1826
1773
        try:
1827
 
            self._control_files.lock_write()
1828
 
            return LogicalLockResult(self.unlock)
 
1774
            return self._control_files.lock_write()
1829
1775
        except:
1830
1776
            self.branch.unlock()
1831
1777
            raise
1832
1778
 
1833
1779
    def lock_write(self):
1834
 
        """See MutableTree.lock_write, and WorkingTree.unlock.
1835
 
 
1836
 
        :return: A bzrlib.lock.LogicalLockResult.
1837
 
        """
 
1780
        """See MutableTree.lock_write, and WorkingTree.unlock."""
1838
1781
        if not self.is_locked():
1839
1782
            self._reset_data()
1840
1783
        self.branch.lock_write()
1841
1784
        try:
1842
 
            self._control_files.lock_write()
1843
 
            return LogicalLockResult(self.unlock)
 
1785
            return self._control_files.lock_write()
1844
1786
        except:
1845
1787
            self.branch.unlock()
1846
1788
            raise
1854
1796
    def _reset_data(self):
1855
1797
        """Reset transient data that cannot be revalidated."""
1856
1798
        self._inventory_is_modified = False
1857
 
        f = self._transport.get('inventory')
1858
 
        try:
1859
 
            result = self._deserialize(f)
1860
 
        finally:
1861
 
            f.close()
 
1799
        result = self._deserialize(self._control_files.get('inventory'))
1862
1800
        self._set_inventory(result, dirty=False)
1863
1801
 
1864
1802
    @needs_tree_write_lock
1869
1807
 
1870
1808
    def _change_last_revision(self, new_revision):
1871
1809
        """Template method part of set_last_revision to perform the change.
1872
 
 
 
1810
        
1873
1811
        This is used to allow WorkingTree3 instances to not affect branch
1874
1812
        when their last revision is set.
1875
1813
        """
1885
1823
 
1886
1824
    def _write_basis_inventory(self, xml):
1887
1825
        """Write the basis inventory XML to the basis-inventory file"""
 
1826
        assert isinstance(xml, str), 'serialised xml must be bytestring.'
1888
1827
        path = self._basis_inventory_name()
1889
1828
        sio = StringIO(xml)
1890
 
        self._transport.put_file(path, sio,
1891
 
            mode=self.bzrdir._get_file_mode())
 
1829
        self._control_files.put(path, sio)
1892
1830
 
1893
1831
    def _create_basis_xml_from_inventory(self, revision_id, inventory):
1894
1832
        """Create the text that will be saved in basis-inventory"""
1901
1839
        # as commit already has that ready-to-use [while the format is the
1902
1840
        # same, that is].
1903
1841
        try:
1904
 
            # this double handles the inventory - unpack and repack -
 
1842
            # this double handles the inventory - unpack and repack - 
1905
1843
            # but is easier to understand. We can/should put a conditional
1906
1844
            # in here based on whether the inventory is in the latest format
1907
1845
            # - perhaps we should repack all inventories on a repository
1908
1846
            # upgrade ?
1909
1847
            # the fast path is to copy the raw xml from the repository. If the
1910
 
            # xml contains 'revision_id="', then we assume the right
 
1848
            # xml contains 'revision_id="', then we assume the right 
1911
1849
            # revision_id is set. We must check for this full string, because a
1912
1850
            # root node id can legitimately look like 'revision_id' but cannot
1913
1851
            # contain a '"'.
1914
 
            xml = self.branch.repository._get_inventory_xml(new_revision)
 
1852
            xml = self.branch.repository.get_inventory_xml(new_revision)
1915
1853
            firstline = xml.split('\n', 1)[0]
1916
 
            if (not 'revision_id="' in firstline or
 
1854
            if (not 'revision_id="' in firstline or 
1917
1855
                'format="7"' not in firstline):
1918
 
                inv = self.branch.repository._serializer.read_inventory_from_string(
1919
 
                    xml, new_revision)
 
1856
                inv = self.branch.repository.deserialise_inventory(
 
1857
                    new_revision, xml)
1920
1858
                xml = self._create_basis_xml_from_inventory(new_revision, inv)
1921
1859
            self._write_basis_inventory(xml)
1922
1860
        except (errors.NoSuchRevision, errors.RevisionNotPresent):
1925
1863
    def read_basis_inventory(self):
1926
1864
        """Read the cached basis inventory."""
1927
1865
        path = self._basis_inventory_name()
1928
 
        return self._transport.get_bytes(path)
1929
 
 
 
1866
        return self._control_files.get(path).read()
 
1867
        
1930
1868
    @needs_read_lock
1931
1869
    def read_working_inventory(self):
1932
1870
        """Read the working inventory.
1933
 
 
 
1871
        
1934
1872
        :raises errors.InventoryModified: read_working_inventory will fail
1935
1873
            when the current in memory inventory has been modified.
1936
1874
        """
1937
 
        # conceptually this should be an implementation detail of the tree.
 
1875
        # conceptually this should be an implementation detail of the tree. 
1938
1876
        # XXX: Deprecate this.
1939
1877
        # ElementTree does its own conversion from UTF-8, so open in
1940
1878
        # binary.
1941
1879
        if self._inventory_is_modified:
1942
1880
            raise errors.InventoryModified(self)
1943
 
        f = self._transport.get('inventory')
1944
 
        try:
1945
 
            result = self._deserialize(f)
1946
 
        finally:
1947
 
            f.close()
 
1881
        result = self._deserialize(self._control_files.get('inventory'))
1948
1882
        self._set_inventory(result, dirty=False)
1949
1883
        return result
1950
1884
 
1965
1899
 
1966
1900
        new_files=set()
1967
1901
        unknown_nested_files=set()
1968
 
        if to_file is None:
1969
 
            to_file = sys.stdout
1970
1902
 
1971
1903
        def recurse_directory_to_add_files(directory):
1972
1904
            # Recurse directory and add all files
1973
1905
            # so we can check if they have changed.
1974
 
            for parent_info, file_infos in self.walkdirs(directory):
1975
 
                for relpath, basename, kind, lstat, fileid, kind in file_infos:
 
1906
            for parent_info, file_infos in\
 
1907
                osutils.walkdirs(self.abspath(directory),
 
1908
                    directory):
 
1909
                for relpath, basename, kind, lstat, abspath in file_infos:
1976
1910
                    # Is it versioned or ignored?
1977
1911
                    if self.path2id(relpath) or self.is_ignored(relpath):
1978
1912
                        # Add nested content for deletion.
1988
1922
            filename = self.relpath(abspath)
1989
1923
            if len(filename) > 0:
1990
1924
                new_files.add(filename)
1991
 
                recurse_directory_to_add_files(filename)
 
1925
                if osutils.isdir(abspath):
 
1926
                    recurse_directory_to_add_files(filename)
1992
1927
 
1993
1928
        files = list(new_files)
1994
1929
 
2012
1947
                            # ... but not ignored
2013
1948
                            has_changed_files = True
2014
1949
                            break
2015
 
                    elif (content_change and (kind[1] is not None) and
2016
 
                            osutils.is_inside_any(files, path[1])):
2017
 
                        # Versioned and changed, but not deleted, and still
2018
 
                        # in one of the dirs to be deleted.
 
1950
                    elif content_change and (kind[1] != None):
 
1951
                        # Versioned and changed, but not deleted
2019
1952
                        has_changed_files = True
2020
1953
                        break
2021
1954
 
2029
1962
                        tree_delta.unversioned.extend((unknown_file,))
2030
1963
                raise errors.BzrRemoveChangedFilesError(tree_delta)
2031
1964
 
2032
 
        # Build inv_delta and delete files where applicable,
 
1965
        # Build inv_delta and delete files where applicaple,
2033
1966
        # do this before any modifications to inventory.
2034
1967
        for f in files:
2035
1968
            fid = self.path2id(f)
2043
1976
                        new_status = 'I'
2044
1977
                    else:
2045
1978
                        new_status = '?'
2046
 
                    # XXX: Really should be a more abstract reporter interface
2047
 
                    kind_ch = osutils.kind_marker(self.kind(fid))
2048
 
                    to_file.write(new_status + '       ' + f + kind_ch + '\n')
 
1979
                    textui.show_status(new_status, self.kind(fid), f,
 
1980
                                       to_file=to_file)
2049
1981
                # Unversion file
2050
1982
                inv_delta.append((f, None, fid, None))
2051
1983
                message = "removed %s" % (f,)
2074
2006
 
2075
2007
    @needs_tree_write_lock
2076
2008
    def revert(self, filenames=None, old_tree=None, backups=True,
2077
 
               pb=None, report_changes=False):
 
2009
               pb=DummyProgress(), report_changes=False):
2078
2010
        from bzrlib.conflicts import resolve
2079
2011
        if filenames == []:
2080
2012
            filenames = None
2093
2025
            if filenames is None and len(self.get_parent_ids()) > 1:
2094
2026
                parent_trees = []
2095
2027
                last_revision = self.last_revision()
2096
 
                if last_revision != _mod_revision.NULL_REVISION:
 
2028
                if last_revision != NULL_REVISION:
2097
2029
                    if basis_tree is None:
2098
2030
                        basis_tree = self.basis_tree()
2099
2031
                        basis_tree.lock_read()
2137
2069
    def set_inventory(self, new_inventory_list):
2138
2070
        from bzrlib.inventory import (Inventory,
2139
2071
                                      InventoryDirectory,
 
2072
                                      InventoryEntry,
2140
2073
                                      InventoryFile,
2141
2074
                                      InventoryLink)
2142
2075
        inv = Inventory(self.get_root_id())
2144
2077
            name = os.path.basename(path)
2145
2078
            if name == "":
2146
2079
                continue
2147
 
            # fixme, there should be a factory function inv,add_??
 
2080
            # fixme, there should be a factory function inv,add_?? 
2148
2081
            if kind == 'directory':
2149
2082
                inv.add(InventoryDirectory(file_id, name, parent))
2150
2083
            elif kind == 'file':
2158
2091
    @needs_tree_write_lock
2159
2092
    def set_root_id(self, file_id):
2160
2093
        """Set the root id for this tree."""
2161
 
        # for compatability
 
2094
        # for compatability 
2162
2095
        if file_id is None:
2163
 
            raise ValueError(
2164
 
                'WorkingTree.set_root_id with fileid=None')
2165
 
        file_id = osutils.safe_file_id(file_id)
 
2096
            symbol_versioning.warn(symbol_versioning.zero_twelve
 
2097
                % 'WorkingTree.set_root_id with fileid=None',
 
2098
                DeprecationWarning,
 
2099
                stacklevel=3)
 
2100
            file_id = ROOT_ID
 
2101
        else:
 
2102
            file_id = osutils.safe_file_id(file_id)
2166
2103
        self._set_root_id(file_id)
2167
2104
 
2168
2105
    def _set_root_id(self, file_id):
2169
2106
        """Set the root id for this tree, in a format specific manner.
2170
2107
 
2171
 
        :param file_id: The file id to assign to the root. It must not be
 
2108
        :param file_id: The file id to assign to the root. It must not be 
2172
2109
            present in the current inventory or an error will occur. It must
2173
2110
            not be None, but rather a valid file id.
2174
2111
        """
2193
2130
 
2194
2131
    def unlock(self):
2195
2132
        """See Branch.unlock.
2196
 
 
 
2133
        
2197
2134
        WorkingTree locking just uses the Branch locking facilities.
2198
2135
        This is current because all working trees have an embedded branch
2199
2136
        within them. IF in the future, we were to make branch data shareable
2200
 
        between multiple working trees, i.e. via shared storage, then we
 
2137
        between multiple working trees, i.e. via shared storage, then we 
2201
2138
        would probably want to lock both the local tree, and the branch.
2202
2139
        """
2203
2140
        raise NotImplementedError(self.unlock)
2204
2141
 
2205
 
    _marker = object()
2206
 
 
2207
 
    def update(self, change_reporter=None, possible_transports=None,
2208
 
               revision=None, old_tip=_marker):
 
2142
    def update(self, change_reporter=None, possible_transports=None):
2209
2143
        """Update a working tree along its branch.
2210
2144
 
2211
2145
        This will update the branch if its bound too, which means we have
2229
2163
        - Merge current state -> basis tree of the master w.r.t. the old tree
2230
2164
          basis.
2231
2165
        - Do a 'normal' merge of the old branch basis if it is relevant.
2232
 
 
2233
 
        :param revision: The target revision to update to. Must be in the
2234
 
            revision history.
2235
 
        :param old_tip: If branch.update() has already been run, the value it
2236
 
            returned (old tip of the branch or None). _marker is used
2237
 
            otherwise.
2238
2166
        """
2239
2167
        if self.branch.get_bound_location() is not None:
2240
2168
            self.lock_write()
2241
 
            update_branch = (old_tip is self._marker)
 
2169
            update_branch = True
2242
2170
        else:
2243
2171
            self.lock_tree_write()
2244
2172
            update_branch = False
2246
2174
            if update_branch:
2247
2175
                old_tip = self.branch.update(possible_transports)
2248
2176
            else:
2249
 
                if old_tip is self._marker:
2250
 
                    old_tip = None
2251
 
            return self._update_tree(old_tip, change_reporter, revision)
 
2177
                old_tip = None
 
2178
            return self._update_tree(old_tip, change_reporter)
2252
2179
        finally:
2253
2180
            self.unlock()
2254
2181
 
2255
2182
    @needs_tree_write_lock
2256
 
    def _update_tree(self, old_tip=None, change_reporter=None, revision=None):
 
2183
    def _update_tree(self, old_tip=None, change_reporter=None):
2257
2184
        """Update a tree to the master branch.
2258
2185
 
2259
2186
        :param old_tip: if supplied, the previous tip revision the branch,
2265
2192
        # cant set that until we update the working trees last revision to be
2266
2193
        # one from the new branch, because it will just get absorbed by the
2267
2194
        # parent de-duplication logic.
2268
 
        #
 
2195
        # 
2269
2196
        # We MUST save it even if an error occurs, because otherwise the users
2270
2197
        # local work is unreferenced and will appear to have been lost.
2271
 
        #
2272
 
        nb_conflicts = 0
 
2198
        # 
 
2199
        result = 0
2273
2200
        try:
2274
2201
            last_rev = self.get_parent_ids()[0]
2275
2202
        except IndexError:
2276
2203
            last_rev = _mod_revision.NULL_REVISION
2277
 
        if revision is None:
2278
 
            revision = self.branch.last_revision()
2279
 
 
2280
 
        old_tip = old_tip or _mod_revision.NULL_REVISION
2281
 
 
2282
 
        if not _mod_revision.is_null(old_tip) and old_tip != last_rev:
2283
 
            # the branch we are bound to was updated
2284
 
            # merge those changes in first
2285
 
            base_tree  = self.basis_tree()
2286
 
            other_tree = self.branch.repository.revision_tree(old_tip)
2287
 
            nb_conflicts = merge.merge_inner(self.branch, other_tree,
2288
 
                                             base_tree, this_tree=self,
2289
 
                                             change_reporter=change_reporter)
2290
 
            if nb_conflicts:
2291
 
                self.add_parent_tree((old_tip, other_tree))
2292
 
                trace.note('Rerun update after fixing the conflicts.')
2293
 
                return nb_conflicts
2294
 
 
2295
 
        if last_rev != _mod_revision.ensure_null(revision):
2296
 
            # the working tree is up to date with the branch
2297
 
            # we can merge the specified revision from master
2298
 
            to_tree = self.branch.repository.revision_tree(revision)
2299
 
            to_root_id = to_tree.get_root_id()
2300
 
 
 
2204
        if last_rev != _mod_revision.ensure_null(self.branch.last_revision()):
 
2205
            # merge tree state up to new branch tip.
2301
2206
            basis = self.basis_tree()
2302
2207
            basis.lock_read()
2303
2208
            try:
2304
 
                if (basis.inventory.root is None
2305
 
                    or basis.inventory.root.file_id != to_root_id):
2306
 
                    self.set_root_id(to_root_id)
 
2209
                to_tree = self.branch.basis_tree()
 
2210
                if basis.inventory.root is None:
 
2211
                    self.set_root_id(to_tree.get_root_id())
2307
2212
                    self.flush()
 
2213
                result += merge.merge_inner(
 
2214
                                      self.branch,
 
2215
                                      to_tree,
 
2216
                                      basis,
 
2217
                                      this_tree=self,
 
2218
                                      change_reporter=change_reporter)
2308
2219
            finally:
2309
2220
                basis.unlock()
2310
 
 
2311
 
            # determine the branch point
2312
 
            graph = self.branch.repository.get_graph()
2313
 
            base_rev_id = graph.find_unique_lca(self.branch.last_revision(),
2314
 
                                                last_rev)
2315
 
            base_tree = self.branch.repository.revision_tree(base_rev_id)
2316
 
 
2317
 
            nb_conflicts = merge.merge_inner(self.branch, to_tree, base_tree,
2318
 
                                             this_tree=self,
2319
 
                                             change_reporter=change_reporter)
2320
 
            self.set_last_revision(revision)
2321
2221
            # TODO - dedup parents list with things merged by pull ?
2322
2222
            # reuse the tree we've updated to to set the basis:
2323
 
            parent_trees = [(revision, to_tree)]
 
2223
            parent_trees = [(self.branch.last_revision(), to_tree)]
2324
2224
            merges = self.get_parent_ids()[1:]
2325
2225
            # Ideally we ask the tree for the trees here, that way the working
2326
 
            # tree can decide whether to give us the entire tree or give us a
 
2226
            # tree can decide whether to give us teh entire tree or give us a
2327
2227
            # lazy initialised tree. dirstate for instance will have the trees
2328
2228
            # in ram already, whereas a last-revision + basis-inventory tree
2329
2229
            # will not, but also does not need them when setting parents.
2330
2230
            for parent in merges:
2331
2231
                parent_trees.append(
2332
2232
                    (parent, self.branch.repository.revision_tree(parent)))
2333
 
            if not _mod_revision.is_null(old_tip):
 
2233
            if (old_tip is not None and not _mod_revision.is_null(old_tip)):
2334
2234
                parent_trees.append(
2335
2235
                    (old_tip, self.branch.repository.revision_tree(old_tip)))
2336
2236
            self.set_parent_trees(parent_trees)
2337
2237
            last_rev = parent_trees[0][0]
2338
 
        return nb_conflicts
 
2238
        else:
 
2239
            # the working tree had the same last-revision as the master
 
2240
            # branch did. We may still have pivot local work from the local
 
2241
            # branch into old_tip:
 
2242
            if (old_tip is not None and not _mod_revision.is_null(old_tip)):
 
2243
                self.add_parent_tree_id(old_tip)
 
2244
        if (old_tip is not None and not _mod_revision.is_null(old_tip)
 
2245
            and old_tip != last_rev):
 
2246
            # our last revision was not the prior branch last revision
 
2247
            # and we have converted that last revision to a pending merge.
 
2248
            # base is somewhere between the branch tip now
 
2249
            # and the now pending merge
 
2250
 
 
2251
            # Since we just modified the working tree and inventory, flush out
 
2252
            # the current state, before we modify it again.
 
2253
            # TODO: jam 20070214 WorkingTree3 doesn't require this, dirstate
 
2254
            #       requires it only because TreeTransform directly munges the
 
2255
            #       inventory and calls tree._write_inventory(). Ultimately we
 
2256
            #       should be able to remove this extra flush.
 
2257
            self.flush()
 
2258
            graph = self.branch.repository.get_graph()
 
2259
            base_rev_id = graph.find_unique_lca(self.branch.last_revision(),
 
2260
                                                old_tip)
 
2261
            base_tree = self.branch.repository.revision_tree(base_rev_id)
 
2262
            other_tree = self.branch.repository.revision_tree(old_tip)
 
2263
            result += merge.merge_inner(
 
2264
                                  self.branch,
 
2265
                                  other_tree,
 
2266
                                  base_tree,
 
2267
                                  this_tree=self,
 
2268
                                  change_reporter=change_reporter)
 
2269
        return result
2339
2270
 
2340
2271
    def _write_hashcache_if_dirty(self):
2341
2272
        """Write out the hashcache if it is dirty."""
2440
2371
                    # value.
2441
2372
                    bzrdir_loc = bisect_left(cur_disk_dir_content,
2442
2373
                        ('.bzr', '.bzr'))
2443
 
                    if (bzrdir_loc < len(cur_disk_dir_content)
2444
 
                        and self.bzrdir.is_control_filename(
2445
 
                            cur_disk_dir_content[bzrdir_loc][0])):
 
2374
                    if cur_disk_dir_content[bzrdir_loc][0] == '.bzr':
2446
2375
                        # we dont yield the contents of, or, .bzr itself.
2447
2376
                        del cur_disk_dir_content[bzrdir_loc]
2448
2377
            if inv_finished:
2538
2467
                relroot = ""
2539
2468
            # FIXME: stash the node in pending
2540
2469
            entry = inv[top_id]
2541
 
            if entry.kind == 'directory':
2542
 
                for name, child in entry.sorted_children():
2543
 
                    dirblock.append((relroot + name, name, child.kind, None,
2544
 
                        child.file_id, child.kind
2545
 
                        ))
 
2470
            for name, child in entry.sorted_children():
 
2471
                dirblock.append((relroot + name, name, child.kind, None,
 
2472
                    child.file_id, child.kind
 
2473
                    ))
2546
2474
            yield (currentdir[0], entry.file_id), dirblock
2547
2475
            # push the user specified dirs from dirblock
2548
2476
            for dir in reversed(dirblock):
2581
2509
        self.set_conflicts(un_resolved)
2582
2510
        return un_resolved, resolved
2583
2511
 
2584
 
    @needs_read_lock
2585
 
    def _check(self, references):
2586
 
        """Check the tree for consistency.
2587
 
 
2588
 
        :param references: A dict with keys matching the items returned by
2589
 
            self._get_check_refs(), and values from looking those keys up in
2590
 
            the repository.
2591
 
        """
2592
 
        tree_basis = self.basis_tree()
2593
 
        tree_basis.lock_read()
2594
 
        try:
2595
 
            repo_basis = references[('trees', self.last_revision())]
2596
 
            if len(list(repo_basis.iter_changes(tree_basis))) > 0:
2597
 
                raise errors.BzrCheckError(
2598
 
                    "Mismatched basis inventory content.")
2599
 
            self._validate()
2600
 
        finally:
2601
 
            tree_basis.unlock()
2602
 
 
2603
2512
    def _validate(self):
2604
2513
        """Validate internal structures.
2605
2514
 
2611
2520
        """
2612
2521
        return
2613
2522
 
2614
 
    def _get_rules_searcher(self, default_searcher):
2615
 
        """See Tree._get_rules_searcher."""
2616
 
        if self._rules_searcher is None:
2617
 
            self._rules_searcher = super(WorkingTree,
2618
 
                self)._get_rules_searcher(default_searcher)
2619
 
        return self._rules_searcher
2620
 
 
2621
 
    def get_shelf_manager(self):
2622
 
        """Return the ShelfManager for this WorkingTree."""
2623
 
        from bzrlib.shelf import ShelfManager
2624
 
        return ShelfManager(self, self._transport)
2625
 
 
2626
2523
 
2627
2524
class WorkingTree2(WorkingTree):
2628
2525
    """This is the Format 2 working tree.
2629
2526
 
2630
 
    This was the first weave based working tree.
 
2527
    This was the first weave based working tree. 
2631
2528
     - uses os locks for locking.
2632
2529
     - uses the branch last-revision.
2633
2530
    """
2643
2540
        if self._inventory is None:
2644
2541
            self.read_working_inventory()
2645
2542
 
2646
 
    def _get_check_refs(self):
2647
 
        """Return the references needed to perform a check of this tree."""
2648
 
        return [('trees', self.last_revision())]
2649
 
 
2650
2543
    def lock_tree_write(self):
2651
2544
        """See WorkingTree.lock_tree_write().
2652
2545
 
2653
2546
        In Format2 WorkingTrees we have a single lock for the branch and tree
2654
2547
        so lock_tree_write() degrades to lock_write().
2655
 
 
2656
 
        :return: An object with an unlock method which will release the lock
2657
 
            obtained.
2658
2548
        """
2659
2549
        self.branch.lock_write()
2660
2550
        try:
2661
 
            self._control_files.lock_write()
2662
 
            return self
 
2551
            return self._control_files.lock_write()
2663
2552
        except:
2664
2553
            self.branch.unlock()
2665
2554
            raise
2674
2563
            if self._inventory_is_modified:
2675
2564
                self.flush()
2676
2565
            self._write_hashcache_if_dirty()
2677
 
 
 
2566
                    
2678
2567
        # reverse order of locking.
2679
2568
        try:
2680
2569
            return self._control_files.unlock()
2696
2585
    def _last_revision(self):
2697
2586
        """See Mutable.last_revision."""
2698
2587
        try:
2699
 
            return self._transport.get_bytes('last-revision')
 
2588
            return self._control_files.get('last-revision').read()
2700
2589
        except errors.NoSuchFile:
2701
2590
            return _mod_revision.NULL_REVISION
2702
2591
 
2703
2592
    def _change_last_revision(self, revision_id):
2704
2593
        """See WorkingTree._change_last_revision."""
2705
 
        if revision_id is None or revision_id == _mod_revision.NULL_REVISION:
 
2594
        if revision_id is None or revision_id == NULL_REVISION:
2706
2595
            try:
2707
 
                self._transport.delete('last-revision')
 
2596
                self._control_files._transport.delete('last-revision')
2708
2597
            except errors.NoSuchFile:
2709
2598
                pass
2710
2599
            return False
2711
2600
        else:
2712
 
            self._transport.put_bytes('last-revision', revision_id,
2713
 
                mode=self.bzrdir._get_file_mode())
 
2601
            self._control_files.put_bytes('last-revision', revision_id)
2714
2602
            return True
2715
2603
 
2716
 
    def _get_check_refs(self):
2717
 
        """Return the references needed to perform a check of this tree."""
2718
 
        return [('trees', self.last_revision())]
2719
 
 
2720
2604
    @needs_tree_write_lock
2721
2605
    def set_conflicts(self, conflicts):
2722
 
        self._put_rio('conflicts', conflicts.to_stanzas(),
 
2606
        self._put_rio('conflicts', conflicts.to_stanzas(), 
2723
2607
                      CONFLICT_HEADER_1)
2724
2608
 
2725
2609
    @needs_tree_write_lock
2732
2616
    @needs_read_lock
2733
2617
    def conflicts(self):
2734
2618
        try:
2735
 
            confile = self._transport.get('conflicts')
 
2619
            confile = self._control_files.get('conflicts')
2736
2620
        except errors.NoSuchFile:
2737
2621
            return _mod_conflicts.ConflictList()
2738
2622
        try:
2739
 
            try:
2740
 
                if confile.next() != CONFLICT_HEADER_1 + '\n':
2741
 
                    raise errors.ConflictFormatError()
2742
 
            except StopIteration:
 
2623
            if confile.next() != CONFLICT_HEADER_1 + '\n':
2743
2624
                raise errors.ConflictFormatError()
2744
 
            return _mod_conflicts.ConflictList.from_stanzas(RioReader(confile))
2745
 
        finally:
2746
 
            confile.close()
 
2625
        except StopIteration:
 
2626
            raise errors.ConflictFormatError()
 
2627
        return _mod_conflicts.ConflictList.from_stanzas(RioReader(confile))
2747
2628
 
2748
2629
    def unlock(self):
2749
2630
        # do non-implementation specific cleanup
2766
2647
            return path[:-len(suffix)]
2767
2648
 
2768
2649
 
 
2650
@deprecated_function(zero_eight)
 
2651
def is_control_file(filename):
 
2652
    """See WorkingTree.is_control_filename(filename)."""
 
2653
    ## FIXME: better check
 
2654
    filename = normpath(filename)
 
2655
    while filename != '':
 
2656
        head, tail = os.path.split(filename)
 
2657
        ## mutter('check %r for control file' % ((head, tail),))
 
2658
        if tail == '.bzr':
 
2659
            return True
 
2660
        if filename == head:
 
2661
            break
 
2662
        filename = head
 
2663
    return False
 
2664
 
 
2665
 
2769
2666
class WorkingTreeFormat(object):
2770
2667
    """An encapsulation of the initialization and open routines for a format.
2771
2668
 
2774
2671
     * a format string,
2775
2672
     * an open routine.
2776
2673
 
2777
 
    Formats are placed in an dict by their format string for reference
 
2674
    Formats are placed in an dict by their format string for reference 
2778
2675
    during workingtree opening. Its not required that these be instances, they
2779
 
    can be classes themselves with class methods - it simply depends on
 
2676
    can be classes themselves with class methods - it simply depends on 
2780
2677
    whether state is needed for a given format or not.
2781
2678
 
2782
2679
    Once a format is deprecated, just deprecate the initialize and open
2783
 
    methods on the format class. Do not deprecate the object, as the
 
2680
    methods on the format class. Do not deprecate the object, as the 
2784
2681
    object will be created every time regardless.
2785
2682
    """
2786
2683
 
2799
2696
        """Return the format for the working tree object in a_bzrdir."""
2800
2697
        try:
2801
2698
            transport = a_bzrdir.get_workingtree_transport(None)
2802
 
            format_string = transport.get_bytes("format")
 
2699
            format_string = transport.get("format").read()
2803
2700
            return klass._formats[format_string]
2804
2701
        except errors.NoSuchFile:
2805
2702
            raise errors.NoWorkingTree(base=transport.base)
2830
2727
        """Is this format supported?
2831
2728
 
2832
2729
        Supported formats can be initialized and opened.
2833
 
        Unsupported formats may not support initialization or committing or
 
2730
        Unsupported formats may not support initialization or committing or 
2834
2731
        some other features depending on the reason for not being supported.
2835
2732
        """
2836
2733
        return True
2837
2734
 
2838
 
    def supports_content_filtering(self):
2839
 
        """True if this format supports content filtering."""
2840
 
        return False
2841
 
 
2842
 
    def supports_views(self):
2843
 
        """True if this format supports stored views."""
2844
 
        return False
2845
 
 
2846
2735
    @classmethod
2847
2736
    def register_format(klass, format):
2848
2737
        klass._formats[format.get_format_string()] = format
2853
2742
 
2854
2743
    @classmethod
2855
2744
    def unregister_format(klass, format):
 
2745
        assert klass._formats[format.get_format_string()] is format
2856
2746
        del klass._formats[format.get_format_string()]
2857
2747
 
2858
2748
 
2859
2749
class WorkingTreeFormat2(WorkingTreeFormat):
2860
 
    """The second working tree format.
 
2750
    """The second working tree format. 
2861
2751
 
2862
2752
    This format modified the hash cache from the format 1 hash cache.
2863
2753
    """
2868
2758
        """See WorkingTreeFormat.get_format_description()."""
2869
2759
        return "Working tree format 2"
2870
2760
 
2871
 
    def _stub_initialize_on_transport(self, transport, file_mode):
2872
 
        """Workaround: create control files for a remote working tree.
2873
 
 
 
2761
    def stub_initialize_remote(self, control_files):
 
2762
        """As a special workaround create critical control files for a remote working tree
 
2763
        
2874
2764
        This ensures that it can later be updated and dealt with locally,
2875
 
        since BzrDirFormat6 and BzrDirFormat5 cannot represent dirs with
 
2765
        since BzrDirFormat6 and BzrDirFormat5 cannot represent dirs with 
2876
2766
        no working tree.  (See bug #43064).
2877
2767
        """
2878
2768
        sio = StringIO()
2879
 
        inv = inventory.Inventory()
 
2769
        inv = Inventory()
2880
2770
        xml5.serializer_v5.write_inventory(inv, sio, working=True)
2881
2771
        sio.seek(0)
2882
 
        transport.put_file('inventory', sio, file_mode)
2883
 
        transport.put_bytes('pending-merges', '', file_mode)
 
2772
        control_files.put('inventory', sio)
 
2773
 
 
2774
        control_files.put_bytes('pending-merges', '')
 
2775
        
2884
2776
 
2885
2777
    def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
2886
2778
                   accelerator_tree=None, hardlink=False):
2898
2790
            branch.generate_revision_history(revision_id)
2899
2791
        finally:
2900
2792
            branch.unlock()
2901
 
        inv = inventory.Inventory()
 
2793
        inv = Inventory()
2902
2794
        wt = WorkingTree2(a_bzrdir.root_transport.local_abspath('.'),
2903
2795
                         branch,
2904
2796
                         inv,
2949
2841
        - is new in bzr 0.8
2950
2842
        - uses a LockDir to guard access for writes.
2951
2843
    """
2952
 
 
 
2844
    
2953
2845
    upgrade_recommended = True
2954
2846
 
2955
2847
    def get_format_string(self):
2972
2864
 
2973
2865
    def _open_control_files(self, a_bzrdir):
2974
2866
        transport = a_bzrdir.get_workingtree_transport(None)
2975
 
        return LockableFiles(transport, self._lock_file_name,
 
2867
        return LockableFiles(transport, self._lock_file_name, 
2976
2868
                             self._lock_class)
2977
2869
 
2978
2870
    def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
2979
2871
                   accelerator_tree=None, hardlink=False):
2980
2872
        """See WorkingTreeFormat.initialize().
2981
 
 
 
2873
        
2982
2874
        :param revision_id: if supplied, create a working tree at a different
2983
2875
            revision than the branch is at.
2984
2876
        :param accelerator_tree: A tree which can be used for retrieving file
2994
2886
        control_files = self._open_control_files(a_bzrdir)
2995
2887
        control_files.create_lock()
2996
2888
        control_files.lock_write()
2997
 
        transport.put_bytes('format', self.get_format_string(),
2998
 
            mode=a_bzrdir._get_file_mode())
 
2889
        control_files.put_utf8('format', self.get_format_string())
2999
2890
        if from_branch is not None:
3000
2891
            branch = from_branch
3001
2892
        else:
3021
2912
            # only set an explicit root id if there is one to set.
3022
2913
            if basis_tree.inventory.root is not None:
3023
2914
                wt.set_root_id(basis_tree.get_root_id())
3024
 
            if revision_id == _mod_revision.NULL_REVISION:
 
2915
            if revision_id == NULL_REVISION:
3025
2916
                wt.set_parent_trees([])
3026
2917
            else:
3027
2918
                wt.set_parent_trees([(revision_id, basis_tree)])
3034
2925
        return wt
3035
2926
 
3036
2927
    def _initial_inventory(self):
3037
 
        return inventory.Inventory()
 
2928
        return Inventory()
3038
2929
 
3039
2930
    def __init__(self):
3040
2931
        super(WorkingTreeFormat3, self).__init__()
3055
2946
 
3056
2947
    def _open(self, a_bzrdir, control_files):
3057
2948
        """Open the tree itself.
3058
 
 
 
2949
        
3059
2950
        :param a_bzrdir: the dir for the tree.
3060
2951
        :param control_files: the control files for the tree.
3061
2952
        """
3069
2960
        return self.get_format_string()
3070
2961
 
3071
2962
 
3072
 
__default_format = WorkingTreeFormat6()
 
2963
__default_format = WorkingTreeFormat4()
3073
2964
WorkingTreeFormat.register_format(__default_format)
3074
 
WorkingTreeFormat.register_format(WorkingTreeFormat5())
3075
 
WorkingTreeFormat.register_format(WorkingTreeFormat4())
3076
2965
WorkingTreeFormat.register_format(WorkingTreeFormat3())
3077
2966
WorkingTreeFormat.set_default_format(__default_format)
3078
2967
# formats which have no format string are not discoverable