~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tree.py

(gz) Remove bzrlib/util/elementtree/ package (Martin Packman)

Show diffs side-by-side

added added

removed removed

Lines of Context:
17
17
"""Tree classes, representing directory at point in time.
18
18
"""
19
19
 
 
20
from __future__ import absolute_import
 
21
 
20
22
import os
21
23
 
22
24
from bzrlib.lazy_import import lazy_import
35
37
    rules,
36
38
    trace,
37
39
    )
 
40
from bzrlib.i18n import gettext
38
41
""")
39
42
 
40
43
from bzrlib.decorators import needs_read_lock
58
61
    trees or versioned trees.
59
62
    """
60
63
 
 
64
    def has_versioned_directories(self):
 
65
        """Whether this tree can contain explicitly versioned directories.
 
66
 
 
67
        This defaults to True, but some implementations may want to override
 
68
        it.
 
69
        """
 
70
        return True
 
71
 
61
72
    def changes_from(self, other, want_unchanged=False, specific_files=None,
62
73
        extra_trees=None, require_versioned=False, include_root=False,
63
74
        want_unversioned=False):
127
138
    def has_id(self, file_id):
128
139
        raise NotImplementedError(self.has_id)
129
140
 
 
141
    @deprecated_method(deprecated_in((2, 4, 0)))
130
142
    def __contains__(self, file_id):
131
143
        return self.has_id(file_id)
132
144
 
276
288
 
277
289
        :param file_id: The file_id of the file.
278
290
        :param path: The path of the file.
 
291
 
279
292
        If both file_id and path are supplied, an implementation may use
280
293
        either one.
 
294
 
 
295
        :returns: A single byte string for the whole file.
281
296
        """
282
297
        my_file = self.get_file(file_id, path)
283
298
        try:
296
311
        """
297
312
        return osutils.split_lines(self.get_file_text(file_id, path))
298
313
 
 
314
    def get_file_verifier(self, file_id, path=None, stat_value=None):
 
315
        """Return a verifier for a file.
 
316
 
 
317
        The default implementation returns a sha1.
 
318
 
 
319
        :param file_id: The handle for this file.
 
320
        :param path: The path that this file can be found at.
 
321
            These must point to the same object.
 
322
        :param stat_value: Optional stat value for the object
 
323
        :return: Tuple with verifier name and verifier data
 
324
        """
 
325
        return ("SHA1", self.get_file_sha1(file_id, path=path,
 
326
            stat_value=stat_value))
 
327
 
299
328
    def get_file_sha1(self, file_id, path=None, stat_value=None):
300
329
        """Return the SHA1 file for a file.
301
330
 
 
331
        :note: callers should use get_file_verifier instead
 
332
            where possible, as the underlying repository implementation may
 
333
            have quicker access to a non-sha1 verifier.
 
334
 
302
335
        :param file_id: The handle for this file.
303
336
        :param path: The path that this file can be found at.
304
337
            These must point to the same object.
324
357
        """
325
358
        raise NotImplementedError(self.get_file_size)
326
359
 
327
 
    def get_file_by_path(self, path):
328
 
        raise NotImplementedError(self.get_file_by_path)
329
 
 
330
360
    def is_executable(self, file_id, path=None):
331
361
        """Check if a file is executable.
332
362
 
601
631
        prefs = self.iter_search_rules([path], filter_pref_names).next()
602
632
        stk = filters._get_filter_stack_for(prefs)
603
633
        if 'filters' in debug.debug_flags:
604
 
            trace.note("*** %s content-filter: %s => %r" % (path,prefs,stk))
 
634
            trace.note(gettext("*** {0} content-filter: {1} => {2!r}").format(path,prefs,stk))
605
635
        return stk
606
636
 
607
637
    def _content_filter_stack_provider(self):
796
826
        return self.inventory.iter_entries_by_dir(
797
827
            specific_file_ids=specific_file_ids, yield_parents=yield_parents)
798
828
 
 
829
    @deprecated_method(deprecated_in((2, 5, 0)))
799
830
    def get_file_by_path(self, path):
800
 
        return self.get_file(self._inventory.path2id(path), path)
801
 
 
802
 
 
803
 
######################################################################
804
 
# diff
805
 
 
806
 
# TODO: Merge these two functions into a single one that can operate
807
 
# on either a whole tree or a set of files.
808
 
 
809
 
# TODO: Return the diff in order by filename, not by category or in
810
 
# random order.  Can probably be done by lock-stepping through the
811
 
# filenames from both trees.
812
 
 
813
 
 
814
 
def file_status(filename, old_tree, new_tree):
815
 
    """Return single-letter status, old and new names for a file.
816
 
 
817
 
    The complexity here is in deciding how to represent renames;
818
 
    many complex cases are possible.
819
 
    """
820
 
    old_inv = old_tree.inventory
821
 
    new_inv = new_tree.inventory
822
 
    new_id = new_inv.path2id(filename)
823
 
    old_id = old_inv.path2id(filename)
824
 
 
825
 
    if not new_id and not old_id:
826
 
        # easy: doesn't exist in either; not versioned at all
827
 
        if new_tree.is_ignored(filename):
828
 
            return 'I', None, None
829
 
        else:
830
 
            return '?', None, None
831
 
    elif new_id:
832
 
        # There is now a file of this name, great.
833
 
        pass
834
 
    else:
835
 
        # There is no longer a file of this name, but we can describe
836
 
        # what happened to the file that used to have
837
 
        # this name.  There are two possibilities: either it was
838
 
        # deleted entirely, or renamed.
839
 
        if new_inv.has_id(old_id):
840
 
            return 'X', old_inv.id2path(old_id), new_inv.id2path(old_id)
841
 
        else:
842
 
            return 'D', old_inv.id2path(old_id), None
843
 
 
844
 
    # if the file_id is new in this revision, it is added
845
 
    if new_id and not old_inv.has_id(new_id):
846
 
        return 'A'
847
 
 
848
 
    # if there used to be a file of this name, but that ID has now
849
 
    # disappeared, it is deleted
850
 
    if old_id and not new_inv.has_id(old_id):
851
 
        return 'D'
852
 
 
853
 
    return 'wtf?'
 
831
        return self.get_file(self.path2id(path), path)
854
832
 
855
833
 
856
834
def find_ids_across_trees(filenames, trees, require_versioned=True):
1004
982
        if source_kind != target_kind:
1005
983
            changed_content = True
1006
984
        elif source_kind == 'file':
1007
 
            if (self.source.get_file_sha1(file_id, source_path, source_stat) !=
1008
 
                self.target.get_file_sha1(file_id, target_path, target_stat)):
 
985
            if not self.file_content_matches(file_id, file_id, source_path,
 
986
                    target_path, source_stat, target_stat):
1009
987
                changed_content = True
1010
988
        elif source_kind == 'symlink':
1011
989
            if (self.source.get_symlink_target(file_id) !=
1324
1302
                    changed_file_ids.add(result[0])
1325
1303
                    yield result
1326
1304
 
 
1305
    @needs_read_lock
 
1306
    def file_content_matches(self, source_file_id, target_file_id,
 
1307
            source_path=None, target_path=None, source_stat=None, target_stat=None):
 
1308
        """Check if two files are the same in the source and target trees.
 
1309
 
 
1310
        This only checks that the contents of the files are the same,
 
1311
        it does not touch anything else.
 
1312
 
 
1313
        :param source_file_id: File id of the file in the source tree
 
1314
        :param target_file_id: File id of the file in the target tree
 
1315
        :param source_path: Path of the file in the source tree
 
1316
        :param target_path: Path of the file in the target tree
 
1317
        :param source_stat: Optional stat value of the file in the source tree
 
1318
        :param target_stat: Optional stat value of the file in the target tree
 
1319
        :return: Boolean indicating whether the files have the same contents
 
1320
        """
 
1321
        source_verifier_kind, source_verifier_data = self.source.get_file_verifier(
 
1322
            source_file_id, source_path, source_stat)
 
1323
        target_verifier_kind, target_verifier_data = self.target.get_file_verifier(
 
1324
            target_file_id, target_path, target_stat)
 
1325
        if source_verifier_kind == target_verifier_kind:
 
1326
            return (source_verifier_data == target_verifier_data)
 
1327
        # Fall back to SHA1 for now
 
1328
        if source_verifier_kind != "SHA1":
 
1329
            source_sha1 = self.source.get_file_sha1(source_file_id,
 
1330
                    source_path, source_stat)
 
1331
        else:
 
1332
            source_sha1 = source_verifier_data
 
1333
        if target_verifier_kind != "SHA1":
 
1334
            target_sha1 = self.target.get_file_sha1(target_file_id,
 
1335
                    target_path, target_stat)
 
1336
        else:
 
1337
            target_sha1 = target_verifier_data
 
1338
        return (source_sha1 == target_sha1)
1327
1339
 
1328
1340
InterTree.register_optimiser(InterTree)
1329
1341