~bzr-pqm/bzr/bzr.dev

4763.2.4 by John Arbash Meinel
merge bzr.2.1 in preparation for NEWS entry.
1
# Copyright (C) 2006-2010 Canonical Ltd
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
2
#
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
7
#
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
# GNU General Public License for more details.
12
#
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
4183.7.1 by Sabin Iacob
update FSF mailing address
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
16
17
"""RevisionTree - a Tree implementation backed by repository data for a revision."""
18
19
from cStringIO import StringIO
20
2249.5.13 by John Arbash Meinel
Finish auditing Repository, and fix generate_ids to always generate utf8 ids.
21
from bzrlib import (
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
22
    errors,
2255.2.83 by John Arbash Meinel
[merge] bzr.dev 2294
23
    revision,
4241.6.7 by Vincent Ladeuil
Add InterCHKRevisionTree
24
    tree,
2249.5.13 by John Arbash Meinel
Finish auditing Repository, and fix generate_ids to always generate utf8 ids.
25
    )
4241.6.7 by Vincent Ladeuil
Add InterCHKRevisionTree
26
27
5793.2.2 by Jelmer Vernooij
Split inventory-specific code out of RevisionTree into InventoryRevisionTree.
28
class RevisionTree(tree.Tree):
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
29
    """Tree viewing a previous revision.
30
31
    File text can be retrieved from the text store.
32
    """
3008.1.13 by Michael Hudson
merge bzr.dev
33
5793.2.2 by Jelmer Vernooij
Split inventory-specific code out of RevisionTree into InventoryRevisionTree.
34
    def __init__(self, repository, revision_id):
35
        self._repository = repository
2858.2.1 by Martin Pool
Remove most calls to safe_file_id and safe_revision_id.
36
        self._revision_id = revision_id
3398.1.24 by Ian Clatworthy
make iter_search_rules a tree method
37
        self._rules_searcher = None
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
38
2100.3.20 by Aaron Bentley
Implement tree comparison for tree references
39
    def supports_tree_reference(self):
4370.3.2 by Ian Clatworthy
apply jam's review feedback
40
        return getattr(self._repository._format, "supports_tree_reference",
41
            False)
2100.3.20 by Aaron Bentley
Implement tree comparison for tree references
42
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
43
    def get_parent_ids(self):
44
        """See Tree.get_parent_ids.
45
46
        A RevisionTree's parents match the revision graph.
47
        """
1908.11.3 by Robert Collins
Merge bzr.dev
48
        if self._revision_id in (None, revision.NULL_REVISION):
49
            parent_ids = []
1908.11.2 by Robert Collins
Implement WorkingTree interface conformance tests for
50
        else:
1986.1.2 by Robert Collins
Various changes to allow non-workingtree specific tests to run entirely
51
            parent_ids = self._repository.get_revision(
52
                self._revision_id).parent_ids
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
53
        return parent_ids
3943.8.1 by Marius Kruger
remove all trailing whitespace from bzr source
54
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
55
    def get_revision_id(self):
56
        """Return the revision id associated with this tree."""
57
        return self._revision_id
58
5793.2.3 by Jelmer Vernooij
Add a RevisionTree.get_file_revision() method.
59
    def get_file_revision(self, file_id, path=None):
60
        """Return the revision id in which a file was last changed."""
61
        raise NotImplementedError(self.get_file_revision)
62
3774.1.1 by Aaron Bentley
Test Tree.get_file_text() and supply default implementation.
63
    def get_file_text(self, file_id, path=None):
4202.1.1 by John Arbash Meinel
Update Repository.iter_files_bytes() to return an iterable of bytestrings.
64
        _, content = list(self.iter_files_bytes([(file_id, None)]))[0]
65
        return ''.join(content)
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
66
2743.3.5 by Ian Clatworthy
Incorporate feedback from abentley
67
    def get_file(self, file_id, path=None):
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
68
        return StringIO(self.get_file_text(file_id))
69
5793.2.2 by Jelmer Vernooij
Split inventory-specific code out of RevisionTree into InventoryRevisionTree.
70
    def is_locked(self):
71
        return self._repository.is_locked()
72
73
    def lock_read(self):
74
        self._repository.lock_read()
75
        return self
76
77
    def __repr__(self):
78
        return '<%s instance at %x, rev_id=%r>' % (
79
            self.__class__.__name__, id(self), self._revision_id)
80
81
    def unlock(self):
82
        self._repository.unlock()
83
84
    def _get_rules_searcher(self, default_searcher):
85
        """See Tree._get_rules_searcher."""
86
        if self._rules_searcher is None:
87
            self._rules_searcher = super(RevisionTree,
88
                self)._get_rules_searcher(default_searcher)
89
        return self._rules_searcher
90
91
92
class InventoryRevisionTree(RevisionTree,tree.InventoryTree):
93
94
    def __init__(self, repository, inv, revision_id):
95
        RevisionTree.__init__(self, repository, revision_id)
96
        self._inventory = inv
97
98
    def get_file_mtime(self, file_id, path=None):
99
        ie = self._inventory[file_id]
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
100
        try:
5793.2.2 by Jelmer Vernooij
Split inventory-specific code out of RevisionTree into InventoryRevisionTree.
101
            revision = self._repository.get_revision(ie.revision)
102
        except errors.NoSuchRevision:
103
            raise errors.FileTimestampUnavailable(self.id2path(file_id))
104
        return revision.timestamp
1551.9.16 by Aaron Bentley
Implement Tree.annotate_iter for RevisionTree and WorkingTree
105
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
106
    def get_file_size(self, file_id):
107
        return self._inventory[file_id].text_size
108
2012.1.7 by Aaron Bentley
Get tree._iter_changed down to ~ 1 stat per file
109
    def get_file_sha1(self, file_id, path=None, stat_value=None):
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
110
        ie = self._inventory[file_id]
111
        if ie.kind == "file":
112
            return ie.text_sha1
113
        return None
114
5793.2.3 by Jelmer Vernooij
Add a RevisionTree.get_file_revision() method.
115
    def get_file_revision(self, file_id, path=None):
116
        ie = self._inventory[file_id]
117
        return ie.revision
118
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
119
    def is_executable(self, file_id, path=None):
120
        ie = self._inventory[file_id]
121
        if ie.kind != "file":
5050.57.1 by Aaron Bentley
Make is_executable treat symlinks and directories the same across tree types.
122
            return False
2294.1.10 by John Arbash Meinel
Switch all apis over to utf8 file ids. All tests pass
123
        return ie.executable
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
124
125
    def has_filename(self, filename):
126
        return bool(self.inventory.path2id(filename))
127
4370.5.2 by Ian Clatworthy
extend list_files() with from_dir and recursive parameters
128
    def list_files(self, include_root=False, from_dir=None, recursive=True):
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
129
        # The only files returned by this are those from the version
4370.5.2 by Ian Clatworthy
extend list_files() with from_dir and recursive parameters
130
        inv = self.inventory
131
        if from_dir is None:
132
            from_dir_id = None
133
        else:
134
            from_dir_id = inv.path2id(from_dir)
4370.5.3 by Ian Clatworthy
handle unversioned directories
135
            if from_dir_id is None:
136
                # Directory not versioned
137
                return
4370.5.2 by Ian Clatworthy
extend list_files() with from_dir and recursive parameters
138
        entries = inv.iter_entries(from_dir=from_dir_id, recursive=recursive)
139
        if inv.root is not None and not include_root and from_dir is None:
1910.2.56 by Aaron Bentley
More work on bundles
140
            # skip the root for compatability with the current apis.
1731.1.33 by Aaron Bentley
Revert no-special-root changes
141
            entries.next()
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
142
        for path, entry in entries:
143
            yield path, 'V', entry.kind, entry.file_id, entry
144
5858.1.1 by Jelmer Vernooij
Support optional path argument to Tree.get_symlink_target.
145
    def get_symlink_target(self, file_id, path=None):
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
146
        ie = self._inventory[file_id]
4241.14.12 by Vincent Ladeuil
Far too many modifications for a single commit, need to restart.
147
        # Inventories store symlink targets in unicode
148
        return ie.symlink_target
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
149
2255.2.226 by Robert Collins
Get merge_nested finally working: change nested tree iterators to take file_ids, and ensure the right branch is connected to in the merge logic. May not be suitable for shared repositories yet.
150
    def get_reference_revision(self, file_id, path=None):
151
        return self.inventory[file_id].reference_revision
2100.3.20 by Aaron Bentley
Implement tree comparison for tree references
152
2255.2.166 by Martin Pool
(broken) Add Tree.get_root_id() & test
153
    def get_root_id(self):
154
        if self.inventory.root:
155
            return self.inventory.root.file_id
156
1852.7.1 by Robert Collins
Move RevisionTree out of tree.py.
157
    def kind(self, file_id):
158
        return self._inventory[file_id].kind
159
2776.1.7 by Robert Collins
* New method on ``bzrlib.tree.Tree`` ``path_content_summary`` provides a
160
    def path_content_summary(self, path):
161
        """See Tree.path_content_summary."""
162
        id = self.inventory.path2id(path)
163
        if id is None:
164
            return ('missing', None, None, None)
165
        entry = self._inventory[id]
166
        kind = entry.kind
167
        if kind == 'file':
168
            return (kind, entry.text_size, entry.executable, entry.text_sha1)
169
        elif kind == 'symlink':
170
            return (kind, None, None, entry.symlink_target)
171
        else:
172
            return (kind, None, None, None)
173
2012.1.7 by Aaron Bentley
Get tree._iter_changed down to ~ 1 stat per file
174
    def _comparison_data(self, entry, path):
175
        if entry is None:
2012.1.15 by Aaron Bentley
Minor tweaks
176
            return None, False, None
2012.1.7 by Aaron Bentley
Get tree._iter_changed down to ~ 1 stat per file
177
        return entry.kind, entry.executable, None
178
179
    def _file_size(self, entry, stat_value):
180
        return entry.text_size
181
1852.15.3 by Robert Collins
Add a first-cut Tree.walkdirs method.
182
    def walkdirs(self, prefix=""):
183
        _directory = 'directory'
184
        inv = self.inventory
1852.15.10 by Robert Collins
Tweak the Tree.walkdirs interface more to be more useful.
185
        top_id = inv.path2id(prefix)
186
        if top_id is None:
187
            pending = []
188
        else:
189
            pending = [(prefix, '', _directory, None, top_id, None)]
1852.15.3 by Robert Collins
Add a first-cut Tree.walkdirs method.
190
        while pending:
191
            dirblock = []
192
            currentdir = pending.pop()
1852.15.10 by Robert Collins
Tweak the Tree.walkdirs interface more to be more useful.
193
            # 0 - relpath, 1- basename, 2- kind, 3- stat, id, v-kind
1852.15.3 by Robert Collins
Add a first-cut Tree.walkdirs method.
194
            if currentdir[0]:
195
                relroot = currentdir[0] + '/'
196
            else:
197
                relroot = ""
198
            # FIXME: stash the node in pending
1852.15.10 by Robert Collins
Tweak the Tree.walkdirs interface more to be more useful.
199
            entry = inv[currentdir[4]]
1852.15.3 by Robert Collins
Add a first-cut Tree.walkdirs method.
200
            for name, child in entry.sorted_children():
201
                toppath = relroot + name
1852.15.10 by Robert Collins
Tweak the Tree.walkdirs interface more to be more useful.
202
                dirblock.append((toppath, name, child.kind, None,
1852.15.3 by Robert Collins
Add a first-cut Tree.walkdirs method.
203
                    child.file_id, child.kind
204
                    ))
1852.15.10 by Robert Collins
Tweak the Tree.walkdirs interface more to be more useful.
205
            yield (currentdir[0], entry.file_id), dirblock
1852.15.3 by Robert Collins
Add a first-cut Tree.walkdirs method.
206
            # push the user specified dirs from dirblock
207
            for dir in reversed(dirblock):
208
                if dir[2] == _directory:
209
                    pending.append(dir)
3398.1.24 by Ian Clatworthy
make iter_search_rules a tree method
210
5793.2.2 by Jelmer Vernooij
Split inventory-specific code out of RevisionTree into InventoryRevisionTree.
211
    def iter_files_bytes(self, desired_files):
212
        """See Tree.iter_files_bytes.
213
214
        This version is implemented on top of Repository.extract_files_bytes"""
5793.2.3 by Jelmer Vernooij
Add a RevisionTree.get_file_revision() method.
215
        repo_desired_files = [(f, self.get_file_revision(f), i)
5793.2.2 by Jelmer Vernooij
Split inventory-specific code out of RevisionTree into InventoryRevisionTree.
216
                              for f, i in desired_files]
217
        try:
218
            for result in self._repository.iter_files_bytes(repo_desired_files):
219
                yield result
220
        except errors.RevisionNotPresent, e:
221
            raise errors.NoSuchFile(e.revision_id)
222
223
    def annotate_iter(self, file_id,
224
                      default_revision=revision.CURRENT_REVISION):
225
        """See Tree.annotate_iter"""
5793.2.3 by Jelmer Vernooij
Add a RevisionTree.get_file_revision() method.
226
        text_key = (file_id, self.get_file_revision(file_id))
5793.2.2 by Jelmer Vernooij
Split inventory-specific code out of RevisionTree into InventoryRevisionTree.
227
        annotator = self._repository.texts.get_annotator()
228
        annotations = annotator.annotate_flat(text_key)
229
        return [(key[-1], line) for key, line in annotations]
4241.6.7 by Vincent Ladeuil
Add InterCHKRevisionTree
230
231
232
class InterCHKRevisionTree(tree.InterTree):
233
    """Fast path optimiser for RevisionTrees with CHK inventories."""
234
235
    @staticmethod
236
    def is_compatible(source, target):
237
        if (isinstance(source, RevisionTree)
238
            and isinstance(target, RevisionTree)):
239
            try:
240
                # Only CHK inventories have id_to_entry attribute
241
                source.inventory.id_to_entry
242
                target.inventory.id_to_entry
243
                return True
244
            except AttributeError:
245
                pass
246
        return False
247
248
    def iter_changes(self, include_unchanged=False,
249
                     specific_files=None, pb=None, extra_trees=[],
250
                     require_versioned=True, want_unversioned=False):
251
        lookup_trees = [self.source]
252
        if extra_trees:
253
             lookup_trees.extend(extra_trees)
4570.2.3 by Robert Collins
Change the way iter_changes treats specific files to prevent InconsistentDeltas.
254
        # The ids of items we need to examine to insure delta consistency.
255
        precise_file_ids = set()
256
        discarded_changes = {}
4241.6.7 by Vincent Ladeuil
Add InterCHKRevisionTree
257
        if specific_files == []:
258
            specific_file_ids = []
259
        else:
260
            specific_file_ids = self.target.paths2ids(specific_files,
261
                lookup_trees, require_versioned=require_versioned)
262
        # FIXME: It should be possible to delegate include_unchanged handling
263
        # to CHKInventory.iter_changes and do a better job there -- vila
264
        # 20090304
4570.2.3 by Robert Collins
Change the way iter_changes treats specific files to prevent InconsistentDeltas.
265
        changed_file_ids = set()
4241.6.7 by Vincent Ladeuil
Add InterCHKRevisionTree
266
        for result in self.target.inventory.iter_changes(self.source.inventory):
4570.2.3 by Robert Collins
Change the way iter_changes treats specific files to prevent InconsistentDeltas.
267
            if specific_file_ids is not None:
268
                file_id = result[0]
269
                if file_id not in specific_file_ids:
270
                    # A change from the whole tree that we don't want to show yet.
271
                    # We may find that we need to show it for delta consistency, so
272
                    # stash it.
273
                    discarded_changes[result[0]] = result
274
                    continue
275
                new_parent_id = result[4][1]
276
                precise_file_ids.add(new_parent_id)
4241.6.7 by Vincent Ladeuil
Add InterCHKRevisionTree
277
            yield result
4570.2.3 by Robert Collins
Change the way iter_changes treats specific files to prevent InconsistentDeltas.
278
            changed_file_ids.add(result[0])
279
        if specific_file_ids is not None:
280
            for result in self._handle_precise_ids(precise_file_ids,
281
                changed_file_ids, discarded_changes=discarded_changes):
282
                yield result
4241.6.7 by Vincent Ladeuil
Add InterCHKRevisionTree
283
        if include_unchanged:
284
            # CHKMap avoid being O(tree), so we go to O(tree) only if
285
            # required to.
286
            # Now walk the whole inventory, excluding the already yielded
287
            # file ids
288
            changed_file_ids = set(changed_file_ids)
289
            for relpath, entry in self.target.inventory.iter_entries():
290
                if (specific_file_ids is not None
291
                    and not entry.file_id in specific_file_ids):
292
                    continue
293
                if not entry.file_id in changed_file_ids:
294
                    yield (entry.file_id,
295
                           (relpath, relpath), # Not renamed
296
                           False, # Not modified
297
                           (True, True), # Still  versioned
298
                           (entry.parent_id, entry.parent_id),
299
                           (entry.name, entry.name),
300
                           (entry.kind, entry.kind),
301
                           (entry.executable, entry.executable))
302
303
304
tree.InterTree.register_optimiser(InterCHKRevisionTree)