~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/workingtree.py

  • Committer: Matthew Revell
  • Date: 2008-03-05 14:11:35 UTC
  • mto: This revision was merged to the branch mainline in revision 3263.
  • Revision ID: matthew.revell@canonical.com-20080305141135-96jf8j24b9crru6v
Added an admin-guide directory to doc/en and outlined headings for the admin guide in index.txt

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
48
48
import itertools
49
49
import operator
50
50
import stat
 
51
from time import time
 
52
import warnings
51
53
import re
52
54
 
53
55
import bzrlib
55
57
    branch,
56
58
    bzrdir,
57
59
    conflicts as _mod_conflicts,
 
60
    dirstate,
58
61
    errors,
59
62
    generate_ids,
60
63
    globbing,
61
 
    graph as _mod_graph,
62
64
    hashcache,
63
65
    ignores,
64
 
    inventory,
65
66
    merge,
66
67
    revision as _mod_revision,
67
68
    revisiontree,
 
69
    repository,
 
70
    textui,
68
71
    trace,
69
72
    transform,
70
73
    ui,
71
 
    views,
 
74
    urlutils,
72
75
    xml5,
 
76
    xml6,
73
77
    xml7,
74
78
    )
75
79
import bzrlib.branch
76
80
from bzrlib.transport import get_transport
77
 
from bzrlib.workingtree_4 import (
78
 
    WorkingTreeFormat4,
79
 
    WorkingTreeFormat5,
80
 
    WorkingTreeFormat6,
81
 
    )
 
81
import bzrlib.ui
 
82
from bzrlib.workingtree_4 import WorkingTreeFormat4
82
83
""")
83
84
 
84
85
from bzrlib import symbol_versioning
85
86
from bzrlib.decorators import needs_read_lock, needs_write_lock
86
 
from bzrlib.lockable_files import LockableFiles
 
87
from bzrlib.inventory import InventoryEntry, Inventory, ROOT_ID, TreeReference
 
88
from bzrlib.lockable_files import LockableFiles, TransportLock
87
89
from bzrlib.lockdir import LockDir
88
90
import bzrlib.mutabletree
89
91
from bzrlib.mutabletree import needs_tree_write_lock
90
92
from bzrlib import osutils
91
93
from bzrlib.osutils import (
 
94
    compact_date,
92
95
    file_kind,
93
96
    isdir,
94
97
    normpath,
95
98
    pathjoin,
 
99
    rand_chars,
96
100
    realpath,
97
101
    safe_unicode,
98
102
    splitpath,
99
103
    supports_executable,
100
104
    )
101
 
from bzrlib.filters import filtered_input_file
102
105
from bzrlib.trace import mutter, note
103
106
from bzrlib.transport.local import LocalTransport
104
 
from bzrlib.progress import ProgressPhase
105
 
from bzrlib.revision import CURRENT_REVISION
 
107
from bzrlib.progress import DummyProgress, ProgressPhase
 
108
from bzrlib.revision import NULL_REVISION, CURRENT_REVISION
106
109
from bzrlib.rio import RioReader, rio_file, Stanza
107
 
from bzrlib.symbol_versioning import (
108
 
    deprecated_passed,
109
 
    DEPRECATED_PARAMETER,
110
 
    )
 
110
from bzrlib.symbol_versioning import (deprecated_passed,
 
111
        deprecated_method,
 
112
        deprecated_function,
 
113
        DEPRECATED_PARAMETER,
 
114
        zero_eight,
 
115
        zero_eleven,
 
116
        zero_thirteen,
 
117
        )
111
118
 
112
119
 
113
120
MERGE_MODIFIED_HEADER_1 = "BZR merge-modified list format 1"
114
 
# TODO: Modifying the conflict objects or their type is currently nearly
115
 
# impossible as there is no clear relationship between the working tree format
116
 
# and the conflict list file format.
117
121
CONFLICT_HEADER_1 = "BZR conflict list format 1"
118
122
 
119
123
ERROR_PATH_NOT_FOUND = 3    # WindowsError errno code, equivalent to ENOENT
120
124
 
121
125
 
 
126
@deprecated_function(zero_thirteen)
 
127
def gen_file_id(name):
 
128
    """Return new file id for the basename 'name'.
 
129
 
 
130
    Use bzrlib.generate_ids.gen_file_id() instead
 
131
    """
 
132
    return generate_ids.gen_file_id(name)
 
133
 
 
134
 
 
135
@deprecated_function(zero_thirteen)
 
136
def gen_root_id():
 
137
    """Return a new tree-root file id.
 
138
 
 
139
    This has been deprecated in favor of bzrlib.generate_ids.gen_root_id()
 
140
    """
 
141
    return generate_ids.gen_root_id()
 
142
 
 
143
 
122
144
class TreeEntry(object):
123
145
    """An entry that implements the minimum interface used by commands.
124
146
 
125
 
    This needs further inspection, it may be better to have
 
147
    This needs further inspection, it may be better to have 
126
148
    InventoryEntries without ids - though that seems wrong. For now,
127
149
    this is a parallel hierarchy to InventoryEntry, and needs to become
128
150
    one of several things: decorates to that hierarchy, children of, or
131
153
    no InventoryEntry available - i.e. for unversioned objects.
132
154
    Perhaps they should be UnversionedEntry et al. ? - RBC 20051003
133
155
    """
134
 
 
 
156
 
135
157
    def __eq__(self, other):
136
158
        # yes, this us ugly, TODO: best practice __eq__ style.
137
159
        return (isinstance(other, TreeEntry)
138
160
                and other.__class__ == self.__class__)
139
 
 
 
161
 
140
162
    def kind_character(self):
141
163
        return "???"
142
164
 
184
206
    not listed in the Inventory and vice versa.
185
207
    """
186
208
 
187
 
    # override this to set the strategy for storing views
188
 
    def _make_views(self):
189
 
        return views.DisabledViews(self)
190
 
 
191
209
    def __init__(self, basedir='.',
192
210
                 branch=DEPRECATED_PARAMETER,
193
211
                 _inventory=None,
204
222
        if not _internal:
205
223
            raise errors.BzrError("Please use bzrdir.open_workingtree or "
206
224
                "WorkingTree.open() to obtain a WorkingTree.")
 
225
        assert isinstance(basedir, basestring), \
 
226
            "base directory %r is not a string" % basedir
207
227
        basedir = safe_unicode(basedir)
208
228
        mutter("opening working tree %r", basedir)
209
229
        if deprecated_passed(branch):
217
237
            self._control_files = self.branch.control_files
218
238
        else:
219
239
            # assume all other formats have their own control files.
 
240
            assert isinstance(_control_files, LockableFiles), \
 
241
                    "_control_files must be a LockableFiles, not %r" \
 
242
                    % _control_files
220
243
            self._control_files = _control_files
221
 
        self._transport = self._control_files._transport
222
244
        # update the whole cache up front and write to disk if anything changed;
223
245
        # in the future we might want to do this more selectively
224
246
        # two possible ways offer themselves : in self._unlock, write the cache
228
250
        wt_trans = self.bzrdir.get_workingtree_transport(None)
229
251
        cache_filename = wt_trans.local_abspath('stat-cache')
230
252
        self._hashcache = hashcache.HashCache(basedir, cache_filename,
231
 
            self.bzrdir._get_file_mode(),
232
 
            self._content_filter_stack_provider())
 
253
                                              self._control_files._file_mode)
233
254
        hc = self._hashcache
234
255
        hc.read()
235
256
        # is this scan needed ? it makes things kinda slow.
250
271
            # permitted to do this.
251
272
            self._set_inventory(_inventory, dirty=False)
252
273
        self._detect_case_handling()
253
 
        self._rules_searcher = None
254
 
        self.views = self._make_views()
255
274
 
256
275
    def _detect_case_handling(self):
257
276
        wt_trans = self.bzrdir.get_workingtree_transport(None)
283
302
        self._control_files.break_lock()
284
303
        self.branch.break_lock()
285
304
 
286
 
    def _get_check_refs(self):
287
 
        """Return the references needed to perform a check of this tree.
288
 
        
289
 
        The default implementation returns no refs, and is only suitable for
290
 
        trees that have no local caching and can commit on ghosts at any time.
291
 
 
292
 
        :seealso: bzrlib.check for details about check_refs.
293
 
        """
294
 
        return []
295
 
 
296
305
    def requires_rich_root(self):
297
306
        return self._format.requires_rich_root
298
307
 
299
308
    def supports_tree_reference(self):
300
309
        return False
301
310
 
302
 
    def supports_content_filtering(self):
303
 
        return self._format.supports_content_filtering()
304
 
 
305
 
    def supports_views(self):
306
 
        return self.views.supports_views()
307
 
 
308
311
    def _set_inventory(self, inv, dirty):
309
312
        """Set the internal cached inventory.
310
313
 
315
318
            False then the inventory is the same as that on disk and any
316
319
            serialisation would be unneeded overhead.
317
320
        """
 
321
        assert inv.root is not None
318
322
        self._inventory = inv
319
323
        self._inventory_is_modified = dirty
320
324
 
324
328
 
325
329
        """
326
330
        if path is None:
327
 
            path = osutils.getcwd()
 
331
            path = os.path.getcwdu()
328
332
        control = bzrdir.BzrDir.open(path, _unsupported)
329
333
        return control.open_workingtree(_unsupported)
330
 
 
 
334
        
331
335
    @staticmethod
332
336
    def open_containing(path=None):
333
337
        """Open an existing working tree which has its root about path.
334
 
 
 
338
        
335
339
        This probes for a working tree at path and searches upwards from there.
336
340
 
337
341
        Basically we keep looking up until we find the control directory or
398
402
 
399
403
    def basis_tree(self):
400
404
        """Return RevisionTree for the current last revision.
401
 
 
 
405
        
402
406
        If the left most parent is a ghost then the returned tree will be an
403
 
        empty tree - one obtained by calling
404
 
        repository.revision_tree(NULL_REVISION).
 
407
        empty tree - one obtained by calling repository.revision_tree(None).
405
408
        """
406
409
        try:
407
410
            revision_id = self.get_parent_ids()[0]
409
412
            # no parents, return an empty revision tree.
410
413
            # in the future this should return the tree for
411
414
            # 'empty:' - the implicit root empty tree.
412
 
            return self.branch.repository.revision_tree(
413
 
                       _mod_revision.NULL_REVISION)
 
415
            return self.branch.repository.revision_tree(None)
414
416
        try:
415
417
            return self.revision_tree(revision_id)
416
418
        except errors.NoSuchRevision:
420
422
        # at this point ?
421
423
        try:
422
424
            return self.branch.repository.revision_tree(revision_id)
423
 
        except (errors.RevisionNotPresent, errors.NoSuchRevision):
 
425
        except errors.RevisionNotPresent:
424
426
            # the basis tree *may* be a ghost or a low level error may have
425
 
            # occurred. If the revision is present, its a problem, if its not
 
427
            # occured. If the revision is present, its a problem, if its not
426
428
            # its a ghost.
427
429
            if self.branch.repository.has_revision(revision_id):
428
430
                raise
429
431
            # the basis tree is a ghost so return an empty tree.
430
 
            return self.branch.repository.revision_tree(
431
 
                       _mod_revision.NULL_REVISION)
 
432
            return self.branch.repository.revision_tree(None)
432
433
 
433
434
    def _cleanup(self):
434
435
        self._flush_ignore_list_cache()
435
436
 
 
437
    @staticmethod
 
438
    @deprecated_method(zero_eight)
 
439
    def create(branch, directory):
 
440
        """Create a workingtree for branch at directory.
 
441
 
 
442
        If existing_directory already exists it must have a .bzr directory.
 
443
        If it does not exist, it will be created.
 
444
 
 
445
        This returns a new WorkingTree object for the new checkout.
 
446
 
 
447
        TODO FIXME RBC 20060124 when we have checkout formats in place this
 
448
        should accept an optional revisionid to checkout [and reject this if
 
449
        checking out into the same dir as a pre-checkout-aware branch format.]
 
450
 
 
451
        XXX: When BzrDir is present, these should be created through that 
 
452
        interface instead.
 
453
        """
 
454
        warnings.warn('delete WorkingTree.create', stacklevel=3)
 
455
        transport = get_transport(directory)
 
456
        if branch.bzrdir.root_transport.base == transport.base:
 
457
            # same dir 
 
458
            return branch.bzrdir.create_workingtree()
 
459
        # different directory, 
 
460
        # create a branch reference
 
461
        # and now a working tree.
 
462
        raise NotImplementedError
 
463
 
 
464
    @staticmethod
 
465
    @deprecated_method(zero_eight)
 
466
    def create_standalone(directory):
 
467
        """Create a checkout and a branch and a repo at directory.
 
468
 
 
469
        Directory must exist and be empty.
 
470
 
 
471
        please use BzrDir.create_standalone_workingtree
 
472
        """
 
473
        return bzrdir.BzrDir.create_standalone_workingtree(directory)
 
474
 
436
475
    def relpath(self, path):
437
476
        """Return the local path portion from a given path.
438
 
 
439
 
        The path may be absolute or relative. If its a relative path it is
 
477
        
 
478
        The path may be absolute or relative. If its a relative path it is 
440
479
        interpreted relative to the python current working directory.
441
480
        """
442
481
        return osutils.relpath(self.basedir, path)
444
483
    def has_filename(self, filename):
445
484
        return osutils.lexists(self.abspath(filename))
446
485
 
447
 
    def get_file(self, file_id, path=None, filtered=True):
448
 
        return self.get_file_with_stat(file_id, path, filtered=filtered)[0]
449
 
 
450
 
    def get_file_with_stat(self, file_id, path=None, filtered=True,
451
 
        _fstat=os.fstat):
452
 
        """See Tree.get_file_with_stat."""
 
486
    def get_file(self, file_id, path=None):
453
487
        if path is None:
454
488
            path = self.id2path(file_id)
455
 
        file_obj = self.get_file_byname(path, filtered=False)
456
 
        stat_value = _fstat(file_obj.fileno())
457
 
        if filtered and self.supports_content_filtering():
458
 
            filters = self._content_filter_stack(path)
459
 
            file_obj = filtered_input_file(file_obj, filters)
460
 
        return (file_obj, stat_value)
461
 
 
462
 
    def get_file_text(self, file_id, path=None, filtered=True):
463
 
        return self.get_file(file_id, path=path, filtered=filtered).read()
464
 
 
465
 
    def get_file_byname(self, filename, filtered=True):
466
 
        path = self.abspath(filename)
467
 
        f = file(path, 'rb')
468
 
        if filtered and self.supports_content_filtering():
469
 
            filters = self._content_filter_stack(filename)
470
 
            return filtered_input_file(f, filters)
471
 
        else:
472
 
            return f
473
 
 
474
 
    def get_file_lines(self, file_id, path=None, filtered=True):
475
 
        """See Tree.get_file_lines()"""
476
 
        file = self.get_file(file_id, path, filtered=filtered)
477
 
        try:
478
 
            return file.readlines()
479
 
        finally:
480
 
            file.close()
 
489
        return self.get_file_byname(path)
 
490
 
 
491
    def get_file_text(self, file_id):
 
492
        return self.get_file(file_id).read()
 
493
 
 
494
    def get_file_byname(self, filename):
 
495
        return file(self.abspath(filename), 'rb')
481
496
 
482
497
    @needs_read_lock
483
498
    def annotate_iter(self, file_id, default_revision=CURRENT_REVISION):
490
505
        incorrectly attributed to CURRENT_REVISION (but after committing, the
491
506
        attribution will be correct).
492
507
        """
493
 
        maybe_file_parent_keys = []
494
 
        for parent_id in self.get_parent_ids():
495
 
            try:
496
 
                parent_tree = self.revision_tree(parent_id)
497
 
            except errors.NoSuchRevisionInTree:
498
 
                parent_tree = self.branch.repository.revision_tree(parent_id)
499
 
            parent_tree.lock_read()
500
 
            try:
501
 
                if file_id not in parent_tree:
502
 
                    continue
503
 
                ie = parent_tree.inventory[file_id]
504
 
                if ie.kind != 'file':
505
 
                    # Note: this is slightly unnecessary, because symlinks and
506
 
                    # directories have a "text" which is the empty text, and we
507
 
                    # know that won't mess up annotations. But it seems cleaner
508
 
                    continue
509
 
                parent_text_key = (file_id, ie.revision)
510
 
                if parent_text_key not in maybe_file_parent_keys:
511
 
                    maybe_file_parent_keys.append(parent_text_key)
512
 
            finally:
513
 
                parent_tree.unlock()
514
 
        graph = _mod_graph.Graph(self.branch.repository.texts)
515
 
        heads = graph.heads(maybe_file_parent_keys)
516
 
        file_parent_keys = []
517
 
        for key in maybe_file_parent_keys:
518
 
            if key in heads:
519
 
                file_parent_keys.append(key)
520
 
 
521
 
        # Now we have the parents of this content
522
 
        annotator = self.branch.repository.texts.get_annotator()
523
 
        text = self.get_file(file_id).read()
524
 
        this_key =(file_id, default_revision)
525
 
        annotator.add_special_text(this_key, file_parent_keys, text)
526
 
        annotations = [(key[-1], line)
527
 
                       for key, line in annotator.annotate_flat(this_key)]
528
 
        return annotations
 
508
        basis = self.basis_tree()
 
509
        basis.lock_read()
 
510
        try:
 
511
            changes = self._iter_changes(basis, True, [self.id2path(file_id)],
 
512
                require_versioned=True).next()
 
513
            changed_content, kind = changes[2], changes[6]
 
514
            if not changed_content:
 
515
                return basis.annotate_iter(file_id)
 
516
            if kind[1] is None:
 
517
                return None
 
518
            import annotate
 
519
            if kind[0] != 'file':
 
520
                old_lines = []
 
521
            else:
 
522
                old_lines = list(basis.annotate_iter(file_id))
 
523
            old = [old_lines]
 
524
            for tree in self.branch.repository.revision_trees(
 
525
                self.get_parent_ids()[1:]):
 
526
                if file_id not in tree:
 
527
                    continue
 
528
                old.append(list(tree.annotate_iter(file_id)))
 
529
            return annotate.reannotate(old, self.get_file(file_id).readlines(),
 
530
                                       default_revision)
 
531
        finally:
 
532
            basis.unlock()
529
533
 
530
534
    def _get_ancestors(self, default_revision):
531
535
        ancestors = set([default_revision])
536
540
 
537
541
    def get_parent_ids(self):
538
542
        """See Tree.get_parent_ids.
539
 
 
 
543
        
540
544
        This implementation reads the pending merges list and last_revision
541
545
        value and uses that to decide what the parents list should be.
542
546
        """
546
550
        else:
547
551
            parents = [last_rev]
548
552
        try:
549
 
            merges_bytes = self._transport.get_bytes('pending-merges')
 
553
            merges_file = self._control_files.get('pending-merges')
550
554
        except errors.NoSuchFile:
551
555
            pass
552
556
        else:
553
 
            for l in osutils.split_lines(merges_bytes):
 
557
            for l in merges_file.readlines():
554
558
                revision_id = l.rstrip('\n')
555
559
                parents.append(revision_id)
556
560
        return parents
559
563
    def get_root_id(self):
560
564
        """Return the id of this trees root"""
561
565
        return self._inventory.root.file_id
562
 
 
 
566
        
563
567
    def _get_store_filename(self, file_id):
564
568
        ## XXX: badly named; this is not in the store at all
565
569
        return self.abspath(self.id2path(file_id))
567
571
    @needs_read_lock
568
572
    def clone(self, to_bzrdir, revision_id=None):
569
573
        """Duplicate this working tree into to_bzr, including all state.
570
 
 
 
574
        
571
575
        Specifically modified files are kept as modified, but
572
576
        ignored and unknown files are discarded.
573
577
 
574
578
        If you want to make a new line of development, see bzrdir.sprout()
575
579
 
576
580
        revision
577
 
            If not None, the cloned tree will have its last revision set to
578
 
            revision, and difference between the source trees last revision
 
581
            If not None, the cloned tree will have its last revision set to 
 
582
            revision, and and difference between the source trees last revision
579
583
            and this one merged in.
580
584
        """
581
585
        # assumes the target bzr dir format is compatible.
582
 
        result = to_bzrdir.create_workingtree()
 
586
        result = self._format.initialize(to_bzrdir)
583
587
        self.copy_content_into(result, revision_id)
584
588
        return result
585
589
 
614
618
    __contains__ = has_id
615
619
 
616
620
    def get_file_size(self, file_id):
617
 
        """See Tree.get_file_size"""
618
 
        # XXX: this returns the on-disk size; it should probably return the
619
 
        # canonical size
620
 
        try:
621
 
            return os.path.getsize(self.id2abspath(file_id))
622
 
        except OSError, e:
623
 
            if e.errno != errno.ENOENT:
624
 
                raise
625
 
            else:
626
 
                return None
 
621
        return os.path.getsize(self.id2abspath(file_id))
627
622
 
628
623
    @needs_read_lock
629
624
    def get_file_sha1(self, file_id, path=None, stat_value=None):
638
633
 
639
634
    def _is_executable_from_path_and_stat_from_basis(self, path, stat_result):
640
635
        file_id = self.path2id(path)
641
 
        if file_id is None:
642
 
            # For unversioned files on win32, we just assume they are not
643
 
            # executable
644
 
            return False
645
636
        return self._inventory[file_id].executable
646
637
 
647
638
    def _is_executable_from_path_and_stat_from_stat(self, path, stat_result):
669
660
        """See MutableTree._add."""
670
661
        # TODO: Re-adding a file that is removed in the working copy
671
662
        # should probably put it back with the previous ID.
672
 
        # the read and write working inventory should not occur in this
 
663
        # the read and write working inventory should not occur in this 
673
664
        # function - they should be part of lock_write and unlock.
674
665
        inv = self.inventory
675
666
        for f, file_id, kind in zip(files, ids, kinds):
 
667
            assert kind is not None
676
668
            if file_id is None:
677
669
                inv.add_path(f, kind=kind)
678
670
            else:
757
749
            raise
758
750
        kind = _mapper(stat_result.st_mode)
759
751
        if kind == 'file':
760
 
            return self._file_content_summary(path, stat_result)
 
752
            size = stat_result.st_size
 
753
            # try for a stat cache lookup
 
754
            executable = self._is_executable_from_path_and_stat(path, stat_result)
 
755
            return (kind, size, executable, self._sha_from_stat(
 
756
                path, stat_result))
761
757
        elif kind == 'directory':
762
758
            # perhaps it looks like a plain directory, but it's really a
763
759
            # reference.
765
761
                kind = 'tree-reference'
766
762
            return kind, None, None, None
767
763
        elif kind == 'symlink':
768
 
            target = osutils.readlink(abspath)
769
 
            return ('symlink', None, None, target)
 
764
            return ('symlink', None, None, os.readlink(abspath))
770
765
        else:
771
766
            return (kind, None, None, None)
772
767
 
773
 
    def _file_content_summary(self, path, stat_result):
774
 
        size = stat_result.st_size
775
 
        executable = self._is_executable_from_path_and_stat(path, stat_result)
776
 
        # try for a stat cache lookup
777
 
        return ('file', size, executable, self._sha_from_stat(
778
 
            path, stat_result))
 
768
    @deprecated_method(zero_eleven)
 
769
    @needs_read_lock
 
770
    def pending_merges(self):
 
771
        """Return a list of pending merges.
 
772
 
 
773
        These are revisions that have been merged into the working
 
774
        directory but not yet committed.
 
775
 
 
776
        As of 0.11 this is deprecated. Please see WorkingTree.get_parent_ids()
 
777
        instead - which is available on all tree objects.
 
778
        """
 
779
        return self.get_parent_ids()[1:]
779
780
 
780
781
    def _check_parents_for_ghosts(self, revision_ids, allow_leftmost_as_ghost):
781
782
        """Common ghost checking functionality from set_parent_*.
791
792
 
792
793
    def _set_merges_from_parent_ids(self, parent_ids):
793
794
        merges = parent_ids[1:]
794
 
        self._transport.put_bytes('pending-merges', '\n'.join(merges),
795
 
            mode=self.bzrdir._get_file_mode())
796
 
 
797
 
    def _filter_parent_ids_by_ancestry(self, revision_ids):
798
 
        """Check that all merged revisions are proper 'heads'.
799
 
 
800
 
        This will always return the first revision_id, and any merged revisions
801
 
        which are
802
 
        """
803
 
        if len(revision_ids) == 0:
804
 
            return revision_ids
805
 
        graph = self.branch.repository.get_graph()
806
 
        heads = graph.heads(revision_ids)
807
 
        new_revision_ids = revision_ids[:1]
808
 
        for revision_id in revision_ids[1:]:
809
 
            if revision_id in heads and revision_id not in new_revision_ids:
810
 
                new_revision_ids.append(revision_id)
811
 
        if new_revision_ids != revision_ids:
812
 
            trace.mutter('requested to set revision_ids = %s,'
813
 
                         ' but filtered to %s', revision_ids, new_revision_ids)
814
 
        return new_revision_ids
 
795
        self._control_files.put_bytes('pending-merges', '\n'.join(merges))
815
796
 
816
797
    @needs_tree_write_lock
817
798
    def set_parent_ids(self, revision_ids, allow_leftmost_as_ghost=False):
818
799
        """Set the parent ids to revision_ids.
819
 
 
 
800
        
820
801
        See also set_parent_trees. This api will try to retrieve the tree data
821
802
        for each element of revision_ids from the trees repository. If you have
822
803
        tree data already available, it is more efficient to use
831
812
        for revision_id in revision_ids:
832
813
            _mod_revision.check_not_reserved_id(revision_id)
833
814
 
834
 
        revision_ids = self._filter_parent_ids_by_ancestry(revision_ids)
835
 
 
836
815
        if len(revision_ids) > 0:
837
816
            self.set_last_revision(revision_ids[0])
838
817
        else:
850
829
        self._check_parents_for_ghosts(parent_ids,
851
830
            allow_leftmost_as_ghost=allow_leftmost_as_ghost)
852
831
 
853
 
        parent_ids = self._filter_parent_ids_by_ancestry(parent_ids)
854
 
 
855
832
        if len(parent_ids) == 0:
856
833
            leftmost_parent_id = _mod_revision.NULL_REVISION
857
834
            leftmost_parent_tree = None
897
874
    def _put_rio(self, filename, stanzas, header):
898
875
        self._must_be_locked()
899
876
        my_file = rio_file(stanzas, header)
900
 
        self._transport.put_file(filename, my_file,
901
 
            mode=self.bzrdir._get_file_mode())
 
877
        self._control_files.put(filename, my_file)
902
878
 
903
879
    @needs_write_lock # because merge pulls data into the branch.
904
880
    def merge_from_branch(self, branch, to_revision=None, from_revision=None,
905
 
                          merge_type=None, force=False):
 
881
        merge_type=None):
906
882
        """Merge from a branch into this working tree.
907
883
 
908
884
        :param branch: The branch to merge from.
912
888
            branch.last_revision().
913
889
        """
914
890
        from bzrlib.merge import Merger, Merge3Merger
915
 
        merger = Merger(self.branch, this_tree=self)
916
 
        # check that there are no local alterations
917
 
        if not force and self.has_changes():
918
 
            raise errors.UncommittedChanges(self)
919
 
        if to_revision is None:
920
 
            to_revision = _mod_revision.ensure_null(branch.last_revision())
921
 
        merger.other_rev_id = to_revision
922
 
        if _mod_revision.is_null(merger.other_rev_id):
923
 
            raise errors.NoCommits(branch)
924
 
        self.branch.fetch(branch, last_revision=merger.other_rev_id)
925
 
        merger.other_basis = merger.other_rev_id
926
 
        merger.other_tree = self.branch.repository.revision_tree(
927
 
            merger.other_rev_id)
928
 
        merger.other_branch = branch
929
 
        if from_revision is None:
930
 
            merger.find_base()
931
 
        else:
932
 
            merger.set_base_revision(from_revision, branch)
933
 
        if merger.base_rev_id == merger.other_rev_id:
934
 
            raise errors.PointlessMerge
935
 
        merger.backup_files = False
936
 
        if merge_type is None:
937
 
            merger.merge_type = Merge3Merger
938
 
        else:
939
 
            merger.merge_type = merge_type
940
 
        merger.set_interesting_files(None)
941
 
        merger.show_base = False
942
 
        merger.reprocess = False
943
 
        conflicts = merger.do_merge()
944
 
        merger.set_pending()
 
891
        pb = bzrlib.ui.ui_factory.nested_progress_bar()
 
892
        try:
 
893
            merger = Merger(self.branch, this_tree=self, pb=pb)
 
894
            merger.pp = ProgressPhase("Merge phase", 5, pb)
 
895
            merger.pp.next_phase()
 
896
            # check that there are no
 
897
            # local alterations
 
898
            merger.check_basis(check_clean=True, require_commits=False)
 
899
            if to_revision is None:
 
900
                to_revision = _mod_revision.ensure_null(branch.last_revision())
 
901
            merger.other_rev_id = to_revision
 
902
            if _mod_revision.is_null(merger.other_rev_id):
 
903
                raise errors.NoCommits(branch)
 
904
            self.branch.fetch(branch, last_revision=merger.other_rev_id)
 
905
            merger.other_basis = merger.other_rev_id
 
906
            merger.other_tree = self.branch.repository.revision_tree(
 
907
                merger.other_rev_id)
 
908
            merger.other_branch = branch
 
909
            merger.pp.next_phase()
 
910
            if from_revision is None:
 
911
                merger.find_base()
 
912
            else:
 
913
                merger.set_base_revision(from_revision, branch)
 
914
            if merger.base_rev_id == merger.other_rev_id:
 
915
                raise errors.PointlessMerge
 
916
            merger.backup_files = False
 
917
            if merge_type is None:
 
918
                merger.merge_type = Merge3Merger
 
919
            else:
 
920
                merger.merge_type = merge_type
 
921
            merger.set_interesting_files(None)
 
922
            merger.show_base = False
 
923
            merger.reprocess = False
 
924
            conflicts = merger.do_merge()
 
925
            merger.set_pending()
 
926
        finally:
 
927
            pb.finished()
945
928
        return conflicts
946
929
 
947
930
    @needs_read_lock
948
931
    def merge_modified(self):
949
932
        """Return a dictionary of files modified by a merge.
950
933
 
951
 
        The list is initialized by WorkingTree.set_merge_modified, which is
 
934
        The list is initialized by WorkingTree.set_merge_modified, which is 
952
935
        typically called after we make some automatic updates to the tree
953
936
        because of a merge.
954
937
 
956
939
        still in the working inventory and have that text hash.
957
940
        """
958
941
        try:
959
 
            hashfile = self._transport.get('merge-hashes')
 
942
            hashfile = self._control_files.get('merge-hashes')
960
943
        except errors.NoSuchFile:
961
944
            return {}
 
945
        merge_hashes = {}
962
946
        try:
963
 
            merge_hashes = {}
964
 
            try:
965
 
                if hashfile.next() != MERGE_MODIFIED_HEADER_1 + '\n':
966
 
                    raise errors.MergeModifiedFormatError()
967
 
            except StopIteration:
 
947
            if hashfile.next() != MERGE_MODIFIED_HEADER_1 + '\n':
968
948
                raise errors.MergeModifiedFormatError()
969
 
            for s in RioReader(hashfile):
970
 
                # RioReader reads in Unicode, so convert file_ids back to utf8
971
 
                file_id = osutils.safe_file_id(s.get("file_id"), warn=False)
972
 
                if file_id not in self.inventory:
973
 
                    continue
974
 
                text_hash = s.get("hash")
975
 
                if text_hash == self.get_file_sha1(file_id):
976
 
                    merge_hashes[file_id] = text_hash
977
 
            return merge_hashes
978
 
        finally:
979
 
            hashfile.close()
 
949
        except StopIteration:
 
950
            raise errors.MergeModifiedFormatError()
 
951
        for s in RioReader(hashfile):
 
952
            # RioReader reads in Unicode, so convert file_ids back to utf8
 
953
            file_id = osutils.safe_file_id(s.get("file_id"), warn=False)
 
954
            if file_id not in self.inventory:
 
955
                continue
 
956
            text_hash = s.get("hash")
 
957
            if text_hash == self.get_file_sha1(file_id):
 
958
                merge_hashes[file_id] = text_hash
 
959
        return merge_hashes
980
960
 
981
961
    @needs_write_lock
982
962
    def mkdir(self, path, file_id=None):
988
968
        return file_id
989
969
 
990
970
    def get_symlink_target(self, file_id):
991
 
        abspath = self.id2abspath(file_id)
992
 
        target = osutils.readlink(abspath)
993
 
        return target
 
971
        return os.readlink(self.id2abspath(file_id))
994
972
 
995
973
    @needs_write_lock
996
974
    def subsume(self, other_tree):
1046
1024
        return False
1047
1025
 
1048
1026
    def _directory_may_be_tree_reference(self, relpath):
1049
 
        # as a special case, if a directory contains control files then
 
1027
        # as a special case, if a directory contains control files then 
1050
1028
        # it's a tree reference, except that the root of the tree is not
1051
1029
        return relpath and osutils.isdir(self.abspath(relpath) + u"/.bzr")
1052
1030
        # TODO: We could ask all the control formats whether they
1063
1041
    @needs_tree_write_lock
1064
1042
    def extract(self, file_id, format=None):
1065
1043
        """Extract a subtree from this tree.
1066
 
 
 
1044
        
1067
1045
        A new branch will be created, relative to the path for this tree.
1068
1046
        """
1069
1047
        self.flush()
1074
1052
                transport = transport.clone(name)
1075
1053
                transport.ensure_base()
1076
1054
            return transport
1077
 
 
 
1055
            
1078
1056
        sub_path = self.id2path(file_id)
1079
1057
        branch_transport = mkdirs(sub_path)
1080
1058
        if format is None:
1097
1075
            branch.BranchReferenceFormat().initialize(tree_bzrdir, new_branch)
1098
1076
        else:
1099
1077
            tree_bzrdir = branch_bzrdir
1100
 
        wt = tree_bzrdir.create_workingtree(_mod_revision.NULL_REVISION)
 
1078
        wt = tree_bzrdir.create_workingtree(NULL_REVISION)
1101
1079
        wt.set_parent_ids(self.get_parent_ids())
1102
1080
        my_inv = self.inventory
1103
 
        child_inv = inventory.Inventory(root_id=None)
 
1081
        child_inv = Inventory(root_id=None)
1104
1082
        new_root = my_inv[file_id]
1105
1083
        my_inv.remove_recursive_id(file_id)
1106
1084
        new_root.parent_id = None
1124
1102
        sio = StringIO()
1125
1103
        self._serialize(self._inventory, sio)
1126
1104
        sio.seek(0)
1127
 
        self._transport.put_file('inventory', sio,
1128
 
            mode=self.bzrdir._get_file_mode())
 
1105
        self._control_files.put('inventory', sio)
1129
1106
        self._inventory_is_modified = False
1130
1107
 
1131
1108
    def _kind(self, relpath):
1132
1109
        return osutils.file_kind(self.abspath(relpath))
1133
1110
 
1134
 
    def list_files(self, include_root=False, from_dir=None, recursive=True):
1135
 
        """List all files as (path, class, kind, id, entry).
 
1111
    def list_files(self, include_root=False):
 
1112
        """Recursively list all files as (path, class, kind, id, entry).
1136
1113
 
1137
1114
        Lists, but does not descend into unversioned directories.
 
1115
 
1138
1116
        This does not include files that have been deleted in this
1139
 
        tree. Skips the control directory.
 
1117
        tree.
1140
1118
 
1141
 
        :param include_root: if True, do not return an entry for the root
1142
 
        :param from_dir: start from this directory or None for the root
1143
 
        :param recursive: whether to recurse into subdirectories or not
 
1119
        Skips the control directory.
1144
1120
        """
1145
1121
        # list_files is an iterator, so @needs_read_lock doesn't work properly
1146
1122
        # with it. So callers should be careful to always read_lock the tree.
1148
1124
            raise errors.ObjectNotLocked(self)
1149
1125
 
1150
1126
        inv = self.inventory
1151
 
        if from_dir is None and include_root is True:
 
1127
        if include_root is True:
1152
1128
            yield ('', 'V', 'directory', inv.root.file_id, inv.root)
1153
1129
        # Convert these into local objects to save lookup times
1154
1130
        pathjoin = osutils.pathjoin
1161
1137
        fk_entries = {'directory':TreeDirectory, 'file':TreeFile, 'symlink':TreeLink}
1162
1138
 
1163
1139
        # directory file_id, relative path, absolute path, reverse sorted children
1164
 
        if from_dir is not None:
1165
 
            from_dir_id = inv.path2id(from_dir)
1166
 
            if from_dir_id is None:
1167
 
                # Directory not versioned
1168
 
                return
1169
 
            from_dir_abspath = pathjoin(self.basedir, from_dir)
1170
 
        else:
1171
 
            from_dir_id = inv.root.file_id
1172
 
            from_dir_abspath = self.basedir
1173
 
        children = os.listdir(from_dir_abspath)
 
1140
        children = os.listdir(self.basedir)
1174
1141
        children.sort()
1175
 
        # jam 20060527 The kernel sized tree seems equivalent whether we
 
1142
        # jam 20060527 The kernel sized tree seems equivalent whether we 
1176
1143
        # use a deque and popleft to keep them sorted, or if we use a plain
1177
1144
        # list and just reverse() them.
1178
1145
        children = collections.deque(children)
1179
 
        stack = [(from_dir_id, u'', from_dir_abspath, children)]
 
1146
        stack = [(inv.root.file_id, u'', self.basedir, children)]
1180
1147
        while stack:
1181
1148
            from_dir_id, from_dir_relpath, from_dir_abspath, children = stack[-1]
1182
1149
 
1198
1165
 
1199
1166
                # absolute path
1200
1167
                fap = from_dir_abspath + '/' + f
1201
 
 
 
1168
                
1202
1169
                f_ie = inv.get_child(from_dir_id, f)
1203
1170
                if f_ie:
1204
1171
                    c = 'V'
1236
1203
                    except KeyError:
1237
1204
                        yield fp[1:], c, fk, None, TreeEntry()
1238
1205
                    continue
1239
 
 
 
1206
                
1240
1207
                if fk != 'directory':
1241
1208
                    continue
1242
1209
 
1243
 
                # But do this child first if recursing down
1244
 
                if recursive:
1245
 
                    new_children = os.listdir(fap)
1246
 
                    new_children.sort()
1247
 
                    new_children = collections.deque(new_children)
1248
 
                    stack.append((f_ie.file_id, fp, fap, new_children))
1249
 
                    # Break out of inner loop,
1250
 
                    # so that we start outer loop with child
1251
 
                    break
 
1210
                # But do this child first
 
1211
                new_children = os.listdir(fap)
 
1212
                new_children.sort()
 
1213
                new_children = collections.deque(new_children)
 
1214
                stack.append((f_ie.file_id, fp, fap, new_children))
 
1215
                # Break out of inner loop,
 
1216
                # so that we start outer loop with child
 
1217
                break
1252
1218
            else:
1253
1219
                # if we finished all children, pop it off the stack
1254
1220
                stack.pop()
1260
1226
        to_dir must exist in the inventory.
1261
1227
 
1262
1228
        If to_dir exists and is a directory, the files are moved into
1263
 
        it, keeping their old names.
 
1229
        it, keeping their old names.  
1264
1230
 
1265
1231
        Note that to_dir is only the last component of the new name;
1266
1232
        this doesn't change the directory.
1303
1269
                                       DeprecationWarning)
1304
1270
 
1305
1271
        # check destination directory
1306
 
        if isinstance(from_paths, basestring):
1307
 
            raise ValueError()
 
1272
        assert not isinstance(from_paths, basestring)
1308
1273
        inv = self.inventory
1309
1274
        to_abs = self.abspath(to_dir)
1310
1275
        if not isdir(to_abs):
1394
1359
                only_change_inv = True
1395
1360
            elif self.has_filename(from_rel) and not self.has_filename(to_rel):
1396
1361
                only_change_inv = False
1397
 
            elif (not self.case_sensitive
1398
 
                  and from_rel.lower() == to_rel.lower()
1399
 
                  and self.has_filename(from_rel)):
 
1362
            elif (sys.platform == 'win32'
 
1363
                and from_rel.lower() == to_rel.lower()
 
1364
                and self.has_filename(from_rel)):
1400
1365
                only_change_inv = False
1401
1366
            else:
1402
1367
                # something is wrong, so lets determine what exactly
1432
1397
        inv = self.inventory
1433
1398
        for entry in moved:
1434
1399
            try:
1435
 
                self._move_entry(WorkingTree._RenameEntry(
1436
 
                    entry.to_rel, entry.from_id,
 
1400
                self._move_entry(_RenameEntry(entry.to_rel, entry.from_id,
1437
1401
                    entry.to_tail, entry.to_parent_id, entry.from_rel,
1438
1402
                    entry.from_tail, entry.from_parent_id,
1439
1403
                    entry.only_change_inv))
1490
1454
        from_tail = splitpath(from_rel)[-1]
1491
1455
        from_id = inv.path2id(from_rel)
1492
1456
        if from_id is None:
1493
 
            # if file is missing in the inventory maybe it's in the basis_tree
1494
 
            basis_tree = self.branch.basis_tree()
1495
 
            from_id = basis_tree.path2id(from_rel)
1496
 
            if from_id is None:
1497
 
                raise errors.BzrRenameFailedError(from_rel,to_rel,
1498
 
                    errors.NotVersionedError(path=str(from_rel)))
1499
 
            # put entry back in the inventory so we can rename it
1500
 
            from_entry = basis_tree.inventory[from_id].copy()
1501
 
            inv.add(from_entry)
1502
 
        else:
1503
 
            from_entry = inv[from_id]
 
1457
            raise errors.BzrRenameFailedError(from_rel,to_rel,
 
1458
                errors.NotVersionedError(path=str(from_rel)))
 
1459
        from_entry = inv[from_id]
1504
1460
        from_parent_id = from_entry.parent_id
1505
1461
        to_dir, to_tail = os.path.split(to_rel)
1506
1462
        to_dir_id = inv.path2id(to_dir)
1552
1508
        These are files in the working directory that are not versioned or
1553
1509
        control files or ignored.
1554
1510
        """
1555
 
        # force the extras method to be fully executed before returning, to
 
1511
        # force the extras method to be fully executed before returning, to 
1556
1512
        # prevent race conditions with the lock
1557
1513
        return iter(
1558
1514
            [subp for subp in self.extras() if not self.is_ignored(subp)])
1568
1524
        :raises: NoSuchId if any fileid is not currently versioned.
1569
1525
        """
1570
1526
        for file_id in file_ids:
1571
 
            if file_id not in self._inventory:
1572
 
                raise errors.NoSuchId(self, file_id)
1573
 
        for file_id in file_ids:
1574
1527
            if self._inventory.has_id(file_id):
1575
1528
                self._inventory.remove_recursive_id(file_id)
 
1529
            else:
 
1530
                raise errors.NoSuchId(self, file_id)
1576
1531
        if len(file_ids):
1577
 
            # in the future this should just set a dirty bit to wait for the
 
1532
            # in the future this should just set a dirty bit to wait for the 
1578
1533
            # final unlock. However, until all methods of workingtree start
1579
 
            # with the current in -memory inventory rather than triggering
 
1534
            # with the current in -memory inventory rather than triggering 
1580
1535
            # a read, it is more complex - we need to teach read_inventory
1581
1536
            # to know when to read, and when to not read first... and possibly
1582
1537
            # to save first when the in memory one may be corrupted.
1583
1538
            # so for now, we just only write it if it is indeed dirty.
1584
1539
            # - RBC 20060907
1585
1540
            self._write_inventory(self._inventory)
 
1541
    
 
1542
    @deprecated_method(zero_eight)
 
1543
    def iter_conflicts(self):
 
1544
        """List all files in the tree that have text or content conflicts.
 
1545
        DEPRECATED.  Use conflicts instead."""
 
1546
        return self._iter_conflicts()
1586
1547
 
1587
1548
    def _iter_conflicts(self):
1588
1549
        conflicted = set()
1597
1558
 
1598
1559
    @needs_write_lock
1599
1560
    def pull(self, source, overwrite=False, stop_revision=None,
1600
 
             change_reporter=None, possible_transports=None, local=False):
 
1561
             change_reporter=None, possible_transports=None):
 
1562
        top_pb = bzrlib.ui.ui_factory.nested_progress_bar()
1601
1563
        source.lock_read()
1602
1564
        try:
 
1565
            pp = ProgressPhase("Pull phase", 2, top_pb)
 
1566
            pp.next_phase()
1603
1567
            old_revision_info = self.branch.last_revision_info()
1604
1568
            basis_tree = self.basis_tree()
1605
1569
            count = self.branch.pull(source, overwrite, stop_revision,
1606
 
                                     possible_transports=possible_transports,
1607
 
                                     local=local)
 
1570
                                     possible_transports=possible_transports)
1608
1571
            new_revision_info = self.branch.last_revision_info()
1609
1572
            if new_revision_info != old_revision_info:
 
1573
                pp.next_phase()
1610
1574
                repository = self.branch.repository
 
1575
                pb = bzrlib.ui.ui_factory.nested_progress_bar()
1611
1576
                basis_tree.lock_read()
1612
1577
                try:
1613
1578
                    new_basis_tree = self.branch.basis_tree()
1616
1581
                                new_basis_tree,
1617
1582
                                basis_tree,
1618
1583
                                this_tree=self,
1619
 
                                pb=None,
 
1584
                                pb=pb,
1620
1585
                                change_reporter=change_reporter)
1621
 
                    basis_root_id = basis_tree.get_root_id()
1622
 
                    new_root_id = new_basis_tree.get_root_id()
1623
 
                    if basis_root_id != new_root_id:
1624
 
                        self.set_root_id(new_root_id)
 
1586
                    if (basis_tree.inventory.root is None and
 
1587
                        new_basis_tree.inventory.root is not None):
 
1588
                        self.set_root_id(new_basis_tree.get_root_id())
1625
1589
                finally:
 
1590
                    pb.finished()
1626
1591
                    basis_tree.unlock()
1627
1592
                # TODO - dedup parents list with things merged by pull ?
1628
1593
                # reuse the revisiontree we merged against to set the new
1629
1594
                # tree data.
1630
1595
                parent_trees = [(self.branch.last_revision(), new_basis_tree)]
1631
 
                # we have to pull the merge trees out again, because
1632
 
                # merge_inner has set the ids. - this corner is not yet
 
1596
                # we have to pull the merge trees out again, because 
 
1597
                # merge_inner has set the ids. - this corner is not yet 
1633
1598
                # layered well enough to prevent double handling.
1634
1599
                # XXX TODO: Fix the double handling: telling the tree about
1635
1600
                # the already known parent data is wasteful.
1641
1606
            return count
1642
1607
        finally:
1643
1608
            source.unlock()
 
1609
            top_pb.finished()
1644
1610
 
1645
1611
    @needs_write_lock
1646
1612
    def put_file_bytes_non_atomic(self, file_id, bytes):
1672
1638
 
1673
1639
            fl = []
1674
1640
            for subf in os.listdir(dirabs):
1675
 
                if self.bzrdir.is_control_filename(subf):
 
1641
                if subf == '.bzr':
1676
1642
                    continue
1677
1643
                if subf not in dir_entry.children:
1678
 
                    try:
1679
 
                        (subf_norm,
1680
 
                         can_access) = osutils.normalized_filename(subf)
1681
 
                    except UnicodeDecodeError:
1682
 
                        path_os_enc = path.encode(osutils._fs_enc)
1683
 
                        relpath = path_os_enc + '/' + subf
1684
 
                        raise errors.BadFilenameEncoding(relpath,
1685
 
                                                         osutils._fs_enc)
 
1644
                    subf_norm, can_access = osutils.normalized_filename(subf)
1686
1645
                    if subf_norm != subf and can_access:
1687
1646
                        if subf_norm not in dir_entry.children:
1688
1647
                            fl.append(subf_norm)
1689
1648
                    else:
1690
1649
                        fl.append(subf)
1691
 
 
 
1650
            
1692
1651
            fl.sort()
1693
1652
            for subf in fl:
1694
1653
                subp = pathjoin(path, subf)
1731
1690
        r"""Check whether the filename matches an ignore pattern.
1732
1691
 
1733
1692
        Patterns containing '/' or '\' need to match the whole path;
1734
 
        others match against only the last component.  Patterns starting
1735
 
        with '!' are ignore exceptions.  Exceptions take precedence
1736
 
        over regular patterns and cause the filename to not be ignored.
 
1693
        others match against only the last component.
1737
1694
 
1738
1695
        If the file is ignored, returns the pattern which caused it to
1739
1696
        be ignored, otherwise None.  So this can simply be used as a
1740
1697
        boolean if desired."""
1741
1698
        if getattr(self, '_ignoreglobster', None) is None:
1742
 
            self._ignoreglobster = globbing.ExceptionGlobster(self.get_ignore_list())
 
1699
            self._ignoreglobster = globbing.Globster(self.get_ignore_list())
1743
1700
        return self._ignoreglobster.match(filename)
1744
1701
 
1745
1702
    def kind(self, file_id):
1836
1793
    def _reset_data(self):
1837
1794
        """Reset transient data that cannot be revalidated."""
1838
1795
        self._inventory_is_modified = False
1839
 
        f = self._transport.get('inventory')
1840
 
        try:
1841
 
            result = self._deserialize(f)
1842
 
        finally:
1843
 
            f.close()
 
1796
        result = self._deserialize(self._control_files.get('inventory'))
1844
1797
        self._set_inventory(result, dirty=False)
1845
1798
 
1846
1799
    @needs_tree_write_lock
1851
1804
 
1852
1805
    def _change_last_revision(self, new_revision):
1853
1806
        """Template method part of set_last_revision to perform the change.
1854
 
 
 
1807
        
1855
1808
        This is used to allow WorkingTree3 instances to not affect branch
1856
1809
        when their last revision is set.
1857
1810
        """
1867
1820
 
1868
1821
    def _write_basis_inventory(self, xml):
1869
1822
        """Write the basis inventory XML to the basis-inventory file"""
 
1823
        assert isinstance(xml, str), 'serialised xml must be bytestring.'
1870
1824
        path = self._basis_inventory_name()
1871
1825
        sio = StringIO(xml)
1872
 
        self._transport.put_file(path, sio,
1873
 
            mode=self.bzrdir._get_file_mode())
 
1826
        self._control_files.put(path, sio)
1874
1827
 
1875
1828
    def _create_basis_xml_from_inventory(self, revision_id, inventory):
1876
1829
        """Create the text that will be saved in basis-inventory"""
1883
1836
        # as commit already has that ready-to-use [while the format is the
1884
1837
        # same, that is].
1885
1838
        try:
1886
 
            # this double handles the inventory - unpack and repack -
 
1839
            # this double handles the inventory - unpack and repack - 
1887
1840
            # but is easier to understand. We can/should put a conditional
1888
1841
            # in here based on whether the inventory is in the latest format
1889
1842
            # - perhaps we should repack all inventories on a repository
1890
1843
            # upgrade ?
1891
1844
            # the fast path is to copy the raw xml from the repository. If the
1892
 
            # xml contains 'revision_id="', then we assume the right
 
1845
            # xml contains 'revision_id="', then we assume the right 
1893
1846
            # revision_id is set. We must check for this full string, because a
1894
1847
            # root node id can legitimately look like 'revision_id' but cannot
1895
1848
            # contain a '"'.
1896
 
            xml = self.branch.repository._get_inventory_xml(new_revision)
 
1849
            xml = self.branch.repository.get_inventory_xml(new_revision)
1897
1850
            firstline = xml.split('\n', 1)[0]
1898
 
            if (not 'revision_id="' in firstline or
 
1851
            if (not 'revision_id="' in firstline or 
1899
1852
                'format="7"' not in firstline):
1900
 
                inv = self.branch.repository._serializer.read_inventory_from_string(
1901
 
                    xml, new_revision)
 
1853
                inv = self.branch.repository.deserialise_inventory(
 
1854
                    new_revision, xml)
1902
1855
                xml = self._create_basis_xml_from_inventory(new_revision, inv)
1903
1856
            self._write_basis_inventory(xml)
1904
1857
        except (errors.NoSuchRevision, errors.RevisionNotPresent):
1907
1860
    def read_basis_inventory(self):
1908
1861
        """Read the cached basis inventory."""
1909
1862
        path = self._basis_inventory_name()
1910
 
        return self._transport.get_bytes(path)
1911
 
 
 
1863
        return self._control_files.get(path).read()
 
1864
        
1912
1865
    @needs_read_lock
1913
1866
    def read_working_inventory(self):
1914
1867
        """Read the working inventory.
1915
 
 
 
1868
        
1916
1869
        :raises errors.InventoryModified: read_working_inventory will fail
1917
1870
            when the current in memory inventory has been modified.
1918
1871
        """
1919
 
        # conceptually this should be an implementation detail of the tree.
 
1872
        # conceptually this should be an implementation detail of the tree. 
1920
1873
        # XXX: Deprecate this.
1921
1874
        # ElementTree does its own conversion from UTF-8, so open in
1922
1875
        # binary.
1923
1876
        if self._inventory_is_modified:
1924
1877
            raise errors.InventoryModified(self)
1925
 
        f = self._transport.get('inventory')
1926
 
        try:
1927
 
            result = self._deserialize(f)
1928
 
        finally:
1929
 
            f.close()
 
1878
        result = self._deserialize(self._control_files.get('inventory'))
1930
1879
        self._set_inventory(result, dirty=False)
1931
1880
        return result
1932
1881
 
1947
1896
 
1948
1897
        new_files=set()
1949
1898
        unknown_nested_files=set()
1950
 
        if to_file is None:
1951
 
            to_file = sys.stdout
1952
1899
 
1953
1900
        def recurse_directory_to_add_files(directory):
1954
1901
            # Recurse directory and add all files
1955
1902
            # so we can check if they have changed.
1956
1903
            for parent_info, file_infos in\
1957
 
                self.walkdirs(directory):
1958
 
                for relpath, basename, kind, lstat, fileid, kind in file_infos:
 
1904
                osutils.walkdirs(self.abspath(directory),
 
1905
                    directory):
 
1906
                for relpath, basename, kind, lstat, abspath in file_infos:
1959
1907
                    # Is it versioned or ignored?
1960
1908
                    if self.path2id(relpath) or self.is_ignored(relpath):
1961
1909
                        # Add nested content for deletion.
1971
1919
            filename = self.relpath(abspath)
1972
1920
            if len(filename) > 0:
1973
1921
                new_files.add(filename)
1974
 
                recurse_directory_to_add_files(filename)
 
1922
                if osutils.isdir(abspath):
 
1923
                    recurse_directory_to_add_files(filename)
1975
1924
 
1976
1925
        files = list(new_files)
1977
1926
 
1986
1935
            has_changed_files = len(unknown_nested_files) > 0
1987
1936
            if not has_changed_files:
1988
1937
                for (file_id, path, content_change, versioned, parent_id, name,
1989
 
                     kind, executable) in self.iter_changes(self.basis_tree(),
 
1938
                     kind, executable) in self._iter_changes(self.basis_tree(),
1990
1939
                         include_unchanged=True, require_versioned=False,
1991
1940
                         want_unversioned=True, specific_files=files):
1992
1941
                    if versioned == (False, False):
1995
1944
                            # ... but not ignored
1996
1945
                            has_changed_files = True
1997
1946
                            break
1998
 
                    elif content_change and (kind[1] is not None):
 
1947
                    elif content_change and (kind[1] != None):
1999
1948
                        # Versioned and changed, but not deleted
2000
1949
                        has_changed_files = True
2001
1950
                        break
2010
1959
                        tree_delta.unversioned.extend((unknown_file,))
2011
1960
                raise errors.BzrRemoveChangedFilesError(tree_delta)
2012
1961
 
2013
 
        # Build inv_delta and delete files where applicable,
 
1962
        # Build inv_delta and delete files where applicaple,
2014
1963
        # do this before any modifications to inventory.
2015
1964
        for f in files:
2016
1965
            fid = self.path2id(f)
2024
1973
                        new_status = 'I'
2025
1974
                    else:
2026
1975
                        new_status = '?'
2027
 
                    # XXX: Really should be a more abstract reporter interface
2028
 
                    kind_ch = osutils.kind_marker(self.kind(fid))
2029
 
                    to_file.write(new_status + '       ' + f + kind_ch + '\n')
 
1976
                    textui.show_status(new_status, self.kind(fid), f,
 
1977
                                       to_file=to_file)
2030
1978
                # Unversion file
2031
1979
                inv_delta.append((f, None, fid, None))
2032
1980
                message = "removed %s" % (f,)
2055
2003
 
2056
2004
    @needs_tree_write_lock
2057
2005
    def revert(self, filenames=None, old_tree=None, backups=True,
2058
 
               pb=None, report_changes=False):
 
2006
               pb=DummyProgress(), report_changes=False):
2059
2007
        from bzrlib.conflicts import resolve
2060
2008
        if filenames == []:
2061
2009
            filenames = None
2074
2022
            if filenames is None and len(self.get_parent_ids()) > 1:
2075
2023
                parent_trees = []
2076
2024
                last_revision = self.last_revision()
2077
 
                if last_revision != _mod_revision.NULL_REVISION:
 
2025
                if last_revision != NULL_REVISION:
2078
2026
                    if basis_tree is None:
2079
2027
                        basis_tree = self.basis_tree()
2080
2028
                        basis_tree.lock_read()
2118
2066
    def set_inventory(self, new_inventory_list):
2119
2067
        from bzrlib.inventory import (Inventory,
2120
2068
                                      InventoryDirectory,
 
2069
                                      InventoryEntry,
2121
2070
                                      InventoryFile,
2122
2071
                                      InventoryLink)
2123
2072
        inv = Inventory(self.get_root_id())
2125
2074
            name = os.path.basename(path)
2126
2075
            if name == "":
2127
2076
                continue
2128
 
            # fixme, there should be a factory function inv,add_??
 
2077
            # fixme, there should be a factory function inv,add_?? 
2129
2078
            if kind == 'directory':
2130
2079
                inv.add(InventoryDirectory(file_id, name, parent))
2131
2080
            elif kind == 'file':
2139
2088
    @needs_tree_write_lock
2140
2089
    def set_root_id(self, file_id):
2141
2090
        """Set the root id for this tree."""
2142
 
        # for compatability
 
2091
        # for compatability 
2143
2092
        if file_id is None:
2144
 
            raise ValueError(
2145
 
                'WorkingTree.set_root_id with fileid=None')
2146
 
        file_id = osutils.safe_file_id(file_id)
 
2093
            symbol_versioning.warn(symbol_versioning.zero_twelve
 
2094
                % 'WorkingTree.set_root_id with fileid=None',
 
2095
                DeprecationWarning,
 
2096
                stacklevel=3)
 
2097
            file_id = ROOT_ID
 
2098
        else:
 
2099
            file_id = osutils.safe_file_id(file_id)
2147
2100
        self._set_root_id(file_id)
2148
2101
 
2149
2102
    def _set_root_id(self, file_id):
2150
2103
        """Set the root id for this tree, in a format specific manner.
2151
2104
 
2152
 
        :param file_id: The file id to assign to the root. It must not be
 
2105
        :param file_id: The file id to assign to the root. It must not be 
2153
2106
            present in the current inventory or an error will occur. It must
2154
2107
            not be None, but rather a valid file id.
2155
2108
        """
2174
2127
 
2175
2128
    def unlock(self):
2176
2129
        """See Branch.unlock.
2177
 
 
 
2130
        
2178
2131
        WorkingTree locking just uses the Branch locking facilities.
2179
2132
        This is current because all working trees have an embedded branch
2180
2133
        within them. IF in the future, we were to make branch data shareable
2181
 
        between multiple working trees, i.e. via shared storage, then we
 
2134
        between multiple working trees, i.e. via shared storage, then we 
2182
2135
        would probably want to lock both the local tree, and the branch.
2183
2136
        """
2184
2137
        raise NotImplementedError(self.unlock)
2185
2138
 
2186
 
    _marker = object()
2187
 
 
2188
 
    def update(self, change_reporter=None, possible_transports=None,
2189
 
               revision=None, old_tip=_marker):
 
2139
    def update(self, change_reporter=None, possible_transports=None):
2190
2140
        """Update a working tree along its branch.
2191
2141
 
2192
2142
        This will update the branch if its bound too, which means we have
2210
2160
        - Merge current state -> basis tree of the master w.r.t. the old tree
2211
2161
          basis.
2212
2162
        - Do a 'normal' merge of the old branch basis if it is relevant.
2213
 
 
2214
 
        :param revision: The target revision to update to. Must be in the
2215
 
            revision history.
2216
 
        :param old_tip: If branch.update() has already been run, the value it
2217
 
            returned (old tip of the branch or None). _marker is used
2218
 
            otherwise.
2219
2163
        """
2220
 
        if self.branch.get_bound_location() is not None:
 
2164
        if self.branch.get_master_branch(possible_transports) is not None:
2221
2165
            self.lock_write()
2222
 
            update_branch = (old_tip is self._marker)
 
2166
            update_branch = True
2223
2167
        else:
2224
2168
            self.lock_tree_write()
2225
2169
            update_branch = False
2227
2171
            if update_branch:
2228
2172
                old_tip = self.branch.update(possible_transports)
2229
2173
            else:
2230
 
                if old_tip is self._marker:
2231
 
                    old_tip = None
2232
 
            return self._update_tree(old_tip, change_reporter, revision)
 
2174
                old_tip = None
 
2175
            return self._update_tree(old_tip, change_reporter)
2233
2176
        finally:
2234
2177
            self.unlock()
2235
2178
 
2236
2179
    @needs_tree_write_lock
2237
 
    def _update_tree(self, old_tip=None, change_reporter=None, revision=None):
 
2180
    def _update_tree(self, old_tip=None, change_reporter=None):
2238
2181
        """Update a tree to the master branch.
2239
2182
 
2240
2183
        :param old_tip: if supplied, the previous tip revision the branch,
2246
2189
        # cant set that until we update the working trees last revision to be
2247
2190
        # one from the new branch, because it will just get absorbed by the
2248
2191
        # parent de-duplication logic.
2249
 
        #
 
2192
        # 
2250
2193
        # We MUST save it even if an error occurs, because otherwise the users
2251
2194
        # local work is unreferenced and will appear to have been lost.
2252
 
        #
2253
 
        nb_conflicts = 0
 
2195
        # 
 
2196
        result = 0
2254
2197
        try:
2255
2198
            last_rev = self.get_parent_ids()[0]
2256
2199
        except IndexError:
2257
2200
            last_rev = _mod_revision.NULL_REVISION
2258
 
        if revision is None:
2259
 
            revision = self.branch.last_revision()
2260
 
        else:
2261
 
            if revision not in self.branch.revision_history():
2262
 
                raise errors.NoSuchRevision(self.branch, revision)
2263
 
 
2264
 
        old_tip = old_tip or _mod_revision.NULL_REVISION
2265
 
 
2266
 
        if not _mod_revision.is_null(old_tip) and old_tip != last_rev:
2267
 
            # the branch we are bound to was updated
2268
 
            # merge those changes in first
2269
 
            base_tree  = self.basis_tree()
2270
 
            other_tree = self.branch.repository.revision_tree(old_tip)
2271
 
            nb_conflicts = merge.merge_inner(self.branch, other_tree,
2272
 
                                             base_tree, this_tree=self,
2273
 
                                             change_reporter=change_reporter)
2274
 
            if nb_conflicts:
2275
 
                self.add_parent_tree((old_tip, other_tree))
2276
 
                trace.note('Rerun update after fixing the conflicts.')
2277
 
                return nb_conflicts
2278
 
 
2279
 
        if last_rev != _mod_revision.ensure_null(revision):
2280
 
            # the working tree is up to date with the branch
2281
 
            # we can merge the specified revision from master
2282
 
            to_tree = self.branch.repository.revision_tree(revision)
2283
 
            to_root_id = to_tree.get_root_id()
2284
 
 
 
2201
        if last_rev != _mod_revision.ensure_null(self.branch.last_revision()):
 
2202
            # merge tree state up to new branch tip.
2285
2203
            basis = self.basis_tree()
2286
2204
            basis.lock_read()
2287
2205
            try:
2288
 
                if (basis.inventory.root is None
2289
 
                    or basis.inventory.root.file_id != to_root_id):
2290
 
                    self.set_root_id(to_root_id)
 
2206
                to_tree = self.branch.basis_tree()
 
2207
                if basis.inventory.root is None:
 
2208
                    self.set_root_id(to_tree.get_root_id())
2291
2209
                    self.flush()
 
2210
                result += merge.merge_inner(
 
2211
                                      self.branch,
 
2212
                                      to_tree,
 
2213
                                      basis,
 
2214
                                      this_tree=self,
 
2215
                                      change_reporter=change_reporter)
2292
2216
            finally:
2293
2217
                basis.unlock()
2294
 
 
2295
 
            # determine the branch point
2296
 
            graph = self.branch.repository.get_graph()
2297
 
            base_rev_id = graph.find_unique_lca(self.branch.last_revision(),
2298
 
                                                last_rev)
2299
 
            base_tree = self.branch.repository.revision_tree(base_rev_id)
2300
 
 
2301
 
            nb_conflicts = merge.merge_inner(self.branch, to_tree, base_tree,
2302
 
                                             this_tree=self,
2303
 
                                             change_reporter=change_reporter)
2304
 
            self.set_last_revision(revision)
2305
2218
            # TODO - dedup parents list with things merged by pull ?
2306
2219
            # reuse the tree we've updated to to set the basis:
2307
 
            parent_trees = [(revision, to_tree)]
 
2220
            parent_trees = [(self.branch.last_revision(), to_tree)]
2308
2221
            merges = self.get_parent_ids()[1:]
2309
2222
            # Ideally we ask the tree for the trees here, that way the working
2310
 
            # tree can decide whether to give us the entire tree or give us a
 
2223
            # tree can decide whether to give us teh entire tree or give us a
2311
2224
            # lazy initialised tree. dirstate for instance will have the trees
2312
2225
            # in ram already, whereas a last-revision + basis-inventory tree
2313
2226
            # will not, but also does not need them when setting parents.
2314
2227
            for parent in merges:
2315
2228
                parent_trees.append(
2316
2229
                    (parent, self.branch.repository.revision_tree(parent)))
2317
 
            if not _mod_revision.is_null(old_tip):
 
2230
            if (old_tip is not None and not _mod_revision.is_null(old_tip)):
2318
2231
                parent_trees.append(
2319
2232
                    (old_tip, self.branch.repository.revision_tree(old_tip)))
2320
2233
            self.set_parent_trees(parent_trees)
2321
2234
            last_rev = parent_trees[0][0]
2322
 
        return nb_conflicts
 
2235
        else:
 
2236
            # the working tree had the same last-revision as the master
 
2237
            # branch did. We may still have pivot local work from the local
 
2238
            # branch into old_tip:
 
2239
            if (old_tip is not None and not _mod_revision.is_null(old_tip)):
 
2240
                self.add_parent_tree_id(old_tip)
 
2241
        if (old_tip is not None and not _mod_revision.is_null(old_tip)
 
2242
            and old_tip != last_rev):
 
2243
            # our last revision was not the prior branch last revision
 
2244
            # and we have converted that last revision to a pending merge.
 
2245
            # base is somewhere between the branch tip now
 
2246
            # and the now pending merge
 
2247
 
 
2248
            # Since we just modified the working tree and inventory, flush out
 
2249
            # the current state, before we modify it again.
 
2250
            # TODO: jam 20070214 WorkingTree3 doesn't require this, dirstate
 
2251
            #       requires it only because TreeTransform directly munges the
 
2252
            #       inventory and calls tree._write_inventory(). Ultimately we
 
2253
            #       should be able to remove this extra flush.
 
2254
            self.flush()
 
2255
            graph = self.branch.repository.get_graph()
 
2256
            base_rev_id = graph.find_unique_lca(self.branch.last_revision(),
 
2257
                                                old_tip)
 
2258
            base_tree = self.branch.repository.revision_tree(base_rev_id)
 
2259
            other_tree = self.branch.repository.revision_tree(old_tip)
 
2260
            result += merge.merge_inner(
 
2261
                                  self.branch,
 
2262
                                  other_tree,
 
2263
                                  base_tree,
 
2264
                                  this_tree=self,
 
2265
                                  change_reporter=change_reporter)
 
2266
        return result
2323
2267
 
2324
2268
    def _write_hashcache_if_dirty(self):
2325
2269
        """Write out the hashcache if it is dirty."""
2424
2368
                    # value.
2425
2369
                    bzrdir_loc = bisect_left(cur_disk_dir_content,
2426
2370
                        ('.bzr', '.bzr'))
2427
 
                    if (bzrdir_loc < len(cur_disk_dir_content)
2428
 
                        and self.bzrdir.is_control_filename(
2429
 
                            cur_disk_dir_content[bzrdir_loc][0])):
 
2371
                    if cur_disk_dir_content[bzrdir_loc][0] == '.bzr':
2430
2372
                        # we dont yield the contents of, or, .bzr itself.
2431
2373
                        del cur_disk_dir_content[bzrdir_loc]
2432
2374
            if inv_finished:
2522
2464
                relroot = ""
2523
2465
            # FIXME: stash the node in pending
2524
2466
            entry = inv[top_id]
2525
 
            if entry.kind == 'directory':
2526
 
                for name, child in entry.sorted_children():
2527
 
                    dirblock.append((relroot + name, name, child.kind, None,
2528
 
                        child.file_id, child.kind
2529
 
                        ))
 
2467
            for name, child in entry.sorted_children():
 
2468
                dirblock.append((relroot + name, name, child.kind, None,
 
2469
                    child.file_id, child.kind
 
2470
                    ))
2530
2471
            yield (currentdir[0], entry.file_id), dirblock
2531
2472
            # push the user specified dirs from dirblock
2532
2473
            for dir in reversed(dirblock):
2565
2506
        self.set_conflicts(un_resolved)
2566
2507
        return un_resolved, resolved
2567
2508
 
2568
 
    @needs_read_lock
2569
 
    def _check(self, references):
2570
 
        """Check the tree for consistency.
2571
 
 
2572
 
        :param references: A dict with keys matching the items returned by
2573
 
            self._get_check_refs(), and values from looking those keys up in
2574
 
            the repository.
2575
 
        """
2576
 
        tree_basis = self.basis_tree()
2577
 
        tree_basis.lock_read()
2578
 
        try:
2579
 
            repo_basis = references[('trees', self.last_revision())]
2580
 
            if len(list(repo_basis.iter_changes(tree_basis))) > 0:
2581
 
                raise errors.BzrCheckError(
2582
 
                    "Mismatched basis inventory content.")
2583
 
            self._validate()
2584
 
        finally:
2585
 
            tree_basis.unlock()
2586
 
 
2587
2509
    def _validate(self):
2588
2510
        """Validate internal structures.
2589
2511
 
2595
2517
        """
2596
2518
        return
2597
2519
 
2598
 
    def _get_rules_searcher(self, default_searcher):
2599
 
        """See Tree._get_rules_searcher."""
2600
 
        if self._rules_searcher is None:
2601
 
            self._rules_searcher = super(WorkingTree,
2602
 
                self)._get_rules_searcher(default_searcher)
2603
 
        return self._rules_searcher
2604
 
 
2605
 
    def get_shelf_manager(self):
2606
 
        """Return the ShelfManager for this WorkingTree."""
2607
 
        from bzrlib.shelf import ShelfManager
2608
 
        return ShelfManager(self, self._transport)
2609
 
 
2610
2520
 
2611
2521
class WorkingTree2(WorkingTree):
2612
2522
    """This is the Format 2 working tree.
2613
2523
 
2614
 
    This was the first weave based working tree.
 
2524
    This was the first weave based working tree. 
2615
2525
     - uses os locks for locking.
2616
2526
     - uses the branch last-revision.
2617
2527
    """
2627
2537
        if self._inventory is None:
2628
2538
            self.read_working_inventory()
2629
2539
 
2630
 
    def _get_check_refs(self):
2631
 
        """Return the references needed to perform a check of this tree."""
2632
 
        return [('trees', self.last_revision())]
2633
 
 
2634
2540
    def lock_tree_write(self):
2635
2541
        """See WorkingTree.lock_tree_write().
2636
2542
 
2654
2560
            if self._inventory_is_modified:
2655
2561
                self.flush()
2656
2562
            self._write_hashcache_if_dirty()
2657
 
 
 
2563
                    
2658
2564
        # reverse order of locking.
2659
2565
        try:
2660
2566
            return self._control_files.unlock()
2676
2582
    def _last_revision(self):
2677
2583
        """See Mutable.last_revision."""
2678
2584
        try:
2679
 
            return self._transport.get_bytes('last-revision')
 
2585
            return self._control_files.get('last-revision').read()
2680
2586
        except errors.NoSuchFile:
2681
2587
            return _mod_revision.NULL_REVISION
2682
2588
 
2683
2589
    def _change_last_revision(self, revision_id):
2684
2590
        """See WorkingTree._change_last_revision."""
2685
 
        if revision_id is None or revision_id == _mod_revision.NULL_REVISION:
 
2591
        if revision_id is None or revision_id == NULL_REVISION:
2686
2592
            try:
2687
 
                self._transport.delete('last-revision')
 
2593
                self._control_files._transport.delete('last-revision')
2688
2594
            except errors.NoSuchFile:
2689
2595
                pass
2690
2596
            return False
2691
2597
        else:
2692
 
            self._transport.put_bytes('last-revision', revision_id,
2693
 
                mode=self.bzrdir._get_file_mode())
 
2598
            self._control_files.put_bytes('last-revision', revision_id)
2694
2599
            return True
2695
2600
 
2696
 
    def _get_check_refs(self):
2697
 
        """Return the references needed to perform a check of this tree."""
2698
 
        return [('trees', self.last_revision())]
2699
 
 
2700
2601
    @needs_tree_write_lock
2701
2602
    def set_conflicts(self, conflicts):
2702
 
        self._put_rio('conflicts', conflicts.to_stanzas(),
 
2603
        self._put_rio('conflicts', conflicts.to_stanzas(), 
2703
2604
                      CONFLICT_HEADER_1)
2704
2605
 
2705
2606
    @needs_tree_write_lock
2712
2613
    @needs_read_lock
2713
2614
    def conflicts(self):
2714
2615
        try:
2715
 
            confile = self._transport.get('conflicts')
 
2616
            confile = self._control_files.get('conflicts')
2716
2617
        except errors.NoSuchFile:
2717
2618
            return _mod_conflicts.ConflictList()
2718
2619
        try:
2719
 
            try:
2720
 
                if confile.next() != CONFLICT_HEADER_1 + '\n':
2721
 
                    raise errors.ConflictFormatError()
2722
 
            except StopIteration:
 
2620
            if confile.next() != CONFLICT_HEADER_1 + '\n':
2723
2621
                raise errors.ConflictFormatError()
2724
 
            return _mod_conflicts.ConflictList.from_stanzas(RioReader(confile))
2725
 
        finally:
2726
 
            confile.close()
 
2622
        except StopIteration:
 
2623
            raise errors.ConflictFormatError()
 
2624
        return _mod_conflicts.ConflictList.from_stanzas(RioReader(confile))
2727
2625
 
2728
2626
    def unlock(self):
2729
2627
        # do non-implementation specific cleanup
2746
2644
            return path[:-len(suffix)]
2747
2645
 
2748
2646
 
 
2647
@deprecated_function(zero_eight)
 
2648
def is_control_file(filename):
 
2649
    """See WorkingTree.is_control_filename(filename)."""
 
2650
    ## FIXME: better check
 
2651
    filename = normpath(filename)
 
2652
    while filename != '':
 
2653
        head, tail = os.path.split(filename)
 
2654
        ## mutter('check %r for control file' % ((head, tail),))
 
2655
        if tail == '.bzr':
 
2656
            return True
 
2657
        if filename == head:
 
2658
            break
 
2659
        filename = head
 
2660
    return False
 
2661
 
 
2662
 
2749
2663
class WorkingTreeFormat(object):
2750
2664
    """An encapsulation of the initialization and open routines for a format.
2751
2665
 
2754
2668
     * a format string,
2755
2669
     * an open routine.
2756
2670
 
2757
 
    Formats are placed in an dict by their format string for reference
 
2671
    Formats are placed in an dict by their format string for reference 
2758
2672
    during workingtree opening. Its not required that these be instances, they
2759
 
    can be classes themselves with class methods - it simply depends on
 
2673
    can be classes themselves with class methods - it simply depends on 
2760
2674
    whether state is needed for a given format or not.
2761
2675
 
2762
2676
    Once a format is deprecated, just deprecate the initialize and open
2763
 
    methods on the format class. Do not deprecate the object, as the
 
2677
    methods on the format class. Do not deprecate the object, as the 
2764
2678
    object will be created every time regardless.
2765
2679
    """
2766
2680
 
2779
2693
        """Return the format for the working tree object in a_bzrdir."""
2780
2694
        try:
2781
2695
            transport = a_bzrdir.get_workingtree_transport(None)
2782
 
            format_string = transport.get_bytes("format")
 
2696
            format_string = transport.get("format").read()
2783
2697
            return klass._formats[format_string]
2784
2698
        except errors.NoSuchFile:
2785
2699
            raise errors.NoWorkingTree(base=transport.base)
2786
2700
        except KeyError:
2787
 
            raise errors.UnknownFormatError(format=format_string,
2788
 
                                            kind="working tree")
 
2701
            raise errors.UnknownFormatError(format=format_string)
2789
2702
 
2790
2703
    def __eq__(self, other):
2791
2704
        return self.__class__ is other.__class__
2810
2723
        """Is this format supported?
2811
2724
 
2812
2725
        Supported formats can be initialized and opened.
2813
 
        Unsupported formats may not support initialization or committing or
 
2726
        Unsupported formats may not support initialization or committing or 
2814
2727
        some other features depending on the reason for not being supported.
2815
2728
        """
2816
2729
        return True
2817
2730
 
2818
 
    def supports_content_filtering(self):
2819
 
        """True if this format supports content filtering."""
2820
 
        return False
2821
 
 
2822
 
    def supports_views(self):
2823
 
        """True if this format supports stored views."""
2824
 
        return False
2825
 
 
2826
2731
    @classmethod
2827
2732
    def register_format(klass, format):
2828
2733
        klass._formats[format.get_format_string()] = format
2833
2738
 
2834
2739
    @classmethod
2835
2740
    def unregister_format(klass, format):
 
2741
        assert klass._formats[format.get_format_string()] is format
2836
2742
        del klass._formats[format.get_format_string()]
2837
2743
 
2838
2744
 
2839
2745
class WorkingTreeFormat2(WorkingTreeFormat):
2840
 
    """The second working tree format.
 
2746
    """The second working tree format. 
2841
2747
 
2842
2748
    This format modified the hash cache from the format 1 hash cache.
2843
2749
    """
2848
2754
        """See WorkingTreeFormat.get_format_description()."""
2849
2755
        return "Working tree format 2"
2850
2756
 
2851
 
    def _stub_initialize_on_transport(self, transport, file_mode):
2852
 
        """Workaround: create control files for a remote working tree.
2853
 
 
 
2757
    def stub_initialize_remote(self, control_files):
 
2758
        """As a special workaround create critical control files for a remote working tree
 
2759
        
2854
2760
        This ensures that it can later be updated and dealt with locally,
2855
 
        since BzrDirFormat6 and BzrDirFormat5 cannot represent dirs with
 
2761
        since BzrDirFormat6 and BzrDirFormat5 cannot represent dirs with 
2856
2762
        no working tree.  (See bug #43064).
2857
2763
        """
2858
2764
        sio = StringIO()
2859
 
        inv = inventory.Inventory()
 
2765
        inv = Inventory()
2860
2766
        xml5.serializer_v5.write_inventory(inv, sio, working=True)
2861
2767
        sio.seek(0)
2862
 
        transport.put_file('inventory', sio, file_mode)
2863
 
        transport.put_bytes('pending-merges', '', file_mode)
 
2768
        control_files.put('inventory', sio)
 
2769
 
 
2770
        control_files.put_bytes('pending-merges', '')
 
2771
        
2864
2772
 
2865
2773
    def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
2866
2774
                   accelerator_tree=None, hardlink=False):
2878
2786
            branch.generate_revision_history(revision_id)
2879
2787
        finally:
2880
2788
            branch.unlock()
2881
 
        inv = inventory.Inventory()
 
2789
        inv = Inventory()
2882
2790
        wt = WorkingTree2(a_bzrdir.root_transport.local_abspath('.'),
2883
2791
                         branch,
2884
2792
                         inv,
2929
2837
        - is new in bzr 0.8
2930
2838
        - uses a LockDir to guard access for writes.
2931
2839
    """
2932
 
 
 
2840
    
2933
2841
    upgrade_recommended = True
2934
2842
 
2935
2843
    def get_format_string(self):
2952
2860
 
2953
2861
    def _open_control_files(self, a_bzrdir):
2954
2862
        transport = a_bzrdir.get_workingtree_transport(None)
2955
 
        return LockableFiles(transport, self._lock_file_name,
 
2863
        return LockableFiles(transport, self._lock_file_name, 
2956
2864
                             self._lock_class)
2957
2865
 
2958
2866
    def initialize(self, a_bzrdir, revision_id=None, from_branch=None,
2959
2867
                   accelerator_tree=None, hardlink=False):
2960
2868
        """See WorkingTreeFormat.initialize().
2961
 
 
 
2869
        
2962
2870
        :param revision_id: if supplied, create a working tree at a different
2963
2871
            revision than the branch is at.
2964
2872
        :param accelerator_tree: A tree which can be used for retrieving file
2974
2882
        control_files = self._open_control_files(a_bzrdir)
2975
2883
        control_files.create_lock()
2976
2884
        control_files.lock_write()
2977
 
        transport.put_bytes('format', self.get_format_string(),
2978
 
            mode=a_bzrdir._get_file_mode())
 
2885
        control_files.put_utf8('format', self.get_format_string())
2979
2886
        if from_branch is not None:
2980
2887
            branch = from_branch
2981
2888
        else:
3001
2908
            # only set an explicit root id if there is one to set.
3002
2909
            if basis_tree.inventory.root is not None:
3003
2910
                wt.set_root_id(basis_tree.get_root_id())
3004
 
            if revision_id == _mod_revision.NULL_REVISION:
 
2911
            if revision_id == NULL_REVISION:
3005
2912
                wt.set_parent_trees([])
3006
2913
            else:
3007
2914
                wt.set_parent_trees([(revision_id, basis_tree)])
3014
2921
        return wt
3015
2922
 
3016
2923
    def _initial_inventory(self):
3017
 
        return inventory.Inventory()
 
2924
        return Inventory()
3018
2925
 
3019
2926
    def __init__(self):
3020
2927
        super(WorkingTreeFormat3, self).__init__()
3035
2942
 
3036
2943
    def _open(self, a_bzrdir, control_files):
3037
2944
        """Open the tree itself.
3038
 
 
 
2945
        
3039
2946
        :param a_bzrdir: the dir for the tree.
3040
2947
        :param control_files: the control files for the tree.
3041
2948
        """
3049
2956
        return self.get_format_string()
3050
2957
 
3051
2958
 
3052
 
__default_format = WorkingTreeFormat6()
 
2959
__default_format = WorkingTreeFormat4()
3053
2960
WorkingTreeFormat.register_format(__default_format)
3054
 
WorkingTreeFormat.register_format(WorkingTreeFormat5())
3055
 
WorkingTreeFormat.register_format(WorkingTreeFormat4())
3056
2961
WorkingTreeFormat.register_format(WorkingTreeFormat3())
3057
2962
WorkingTreeFormat.set_default_format(__default_format)
3058
2963
# formats which have no format string are not discoverable