~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/revisiontree.py

  • Committer: Patch Queue Manager
  • Date: 2016-04-21 04:10:52 UTC
  • mfrom: (6616.1.1 fix-en-user-guide)
  • Revision ID: pqm@pqm.ubuntu.com-20160421041052-clcye7ns1qcl2n7w
(richard-wilbur) Ensure build of English use guide always uses English text
 even when user's locale specifies a different language. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2007 Canonical Ltd
 
1
# Copyright (C) 2006-2010 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
"""RevisionTree - a Tree implementation backed by repository data for a revision."""
18
18
 
 
19
from __future__ import absolute_import
 
20
 
19
21
from cStringIO import StringIO
20
22
 
21
23
from bzrlib import (
22
 
    osutils,
 
24
    errors,
23
25
    revision,
24
 
    symbol_versioning,
 
26
    tree,
25
27
    )
26
 
from bzrlib.tree import Tree
27
 
 
28
 
 
29
 
class RevisionTree(Tree):
 
28
 
 
29
 
 
30
class RevisionTree(tree.Tree):
30
31
    """Tree viewing a previous revision.
31
32
 
32
33
    File text can be retrieved from the text store.
33
34
    """
34
 
    
35
 
    def __init__(self, branch, inv, revision_id):
36
 
        # for compatability the 'branch' parameter has not been renamed to 
37
 
        # repository at this point. However, we should change RevisionTree's
38
 
        # construction to always be via Repository and not via direct 
39
 
        # construction - this will mean that we can change the constructor
40
 
        # with much less chance of breaking client code.
41
 
        self._repository = branch
42
 
        self._weave_store = branch.weave_store
43
 
        self._inventory = inv
 
35
 
 
36
    def __init__(self, repository, revision_id):
 
37
        self._repository = repository
44
38
        self._revision_id = revision_id
 
39
        self._rules_searcher = None
 
40
 
 
41
    def has_versioned_directories(self):
 
42
        """See `Tree.has_versioned_directories`."""
 
43
        return self._repository._format.supports_versioned_directories
45
44
 
46
45
    def supports_tree_reference(self):
47
 
        return True
 
46
        return getattr(self._repository._format, "supports_tree_reference",
 
47
            False)
48
48
 
49
49
    def get_parent_ids(self):
50
50
        """See Tree.get_parent_ids.
57
57
            parent_ids = self._repository.get_revision(
58
58
                self._revision_id).parent_ids
59
59
        return parent_ids
60
 
        
 
60
 
61
61
    def get_revision_id(self):
62
62
        """Return the revision id associated with this tree."""
63
63
        return self._revision_id
64
64
 
65
 
    @symbol_versioning.deprecated_method(symbol_versioning.zero_ninety)
66
 
    def get_weave(self, file_id):
67
 
        return self._get_weave(file_id)
68
 
 
69
 
    def _get_weave(self, file_id):
70
 
        return self._weave_store.get_weave(file_id,
71
 
                self._repository.get_transaction())
72
 
 
73
 
    def get_file_lines(self, file_id):
74
 
        ie = self._inventory[file_id]
75
 
        weave = self._get_weave(file_id)
76
 
        return weave.get_lines(ie.revision)
77
 
 
78
 
    def get_file_text(self, file_id):
79
 
        return ''.join(self.get_file_lines(file_id))
 
65
    def get_file_revision(self, file_id, path=None):
 
66
        """Return the revision id in which a file was last changed."""
 
67
        raise NotImplementedError(self.get_file_revision)
 
68
 
 
69
    def get_file_text(self, file_id, path=None):
 
70
        for (identifier, content) in self.iter_files_bytes([(file_id, None)]):
 
71
            ret = "".join(content)
 
72
        return ret
80
73
 
81
74
    def get_file(self, file_id, path=None):
82
75
        return StringIO(self.get_file_text(file_id))
83
76
 
84
 
    def iter_files_bytes(self, desired_files):
85
 
        """See Tree.extract_files_bytes.
86
 
 
87
 
        This version is implemented on top of Repository.extract_files_bytes"""
88
 
        repo_desired_files = [(f, self.inventory[f].revision, i)
89
 
                              for f, i in desired_files]
90
 
        return self._repository.iter_files_bytes(repo_desired_files)
91
 
 
92
 
    def annotate_iter(self, file_id,
93
 
                      default_revision=revision.CURRENT_REVISION):
94
 
        """See Tree.annotate_iter"""
95
 
        w = self._get_weave(file_id)
96
 
        return w.annotate_iter(self.inventory[file_id].revision)
 
77
    def is_locked(self):
 
78
        return self._repository.is_locked()
 
79
 
 
80
    def lock_read(self):
 
81
        self._repository.lock_read()
 
82
        return self
 
83
 
 
84
    def __repr__(self):
 
85
        return '<%s instance at %x, rev_id=%r>' % (
 
86
            self.__class__.__name__, id(self), self._revision_id)
 
87
 
 
88
    def unlock(self):
 
89
        self._repository.unlock()
 
90
 
 
91
    def _get_rules_searcher(self, default_searcher):
 
92
        """See Tree._get_rules_searcher."""
 
93
        if self._rules_searcher is None:
 
94
            self._rules_searcher = super(RevisionTree,
 
95
                self)._get_rules_searcher(default_searcher)
 
96
        return self._rules_searcher
 
97
 
 
98
 
 
99
class InventoryRevisionTree(RevisionTree,tree.InventoryTree):
 
100
 
 
101
    def __init__(self, repository, inv, revision_id):
 
102
        RevisionTree.__init__(self, repository, revision_id)
 
103
        self._inventory = inv
 
104
 
 
105
    def get_file_mtime(self, file_id, path=None):
 
106
        inv, inv_file_id = self._unpack_file_id(file_id)
 
107
        ie = inv[inv_file_id]
 
108
        try:
 
109
            revision = self._repository.get_revision(ie.revision)
 
110
        except errors.NoSuchRevision:
 
111
            raise errors.FileTimestampUnavailable(self.id2path(file_id))
 
112
        return revision.timestamp
97
113
 
98
114
    def get_file_size(self, file_id):
99
 
        return self._inventory[file_id].text_size
 
115
        inv, inv_file_id = self._unpack_file_id(file_id)
 
116
        return inv[inv_file_id].text_size
100
117
 
101
118
    def get_file_sha1(self, file_id, path=None, stat_value=None):
102
 
        ie = self._inventory[file_id]
 
119
        inv, inv_file_id = self._unpack_file_id(file_id)
 
120
        ie = inv[inv_file_id]
103
121
        if ie.kind == "file":
104
122
            return ie.text_sha1
105
123
        return None
106
124
 
107
 
    def get_file_mtime(self, file_id, path=None):
108
 
        ie = self._inventory[file_id]
109
 
        revision = self._repository.get_revision(ie.revision)
110
 
        return revision.timestamp
 
125
    def get_file_revision(self, file_id, path=None):
 
126
        inv, inv_file_id = self._unpack_file_id(file_id)
 
127
        ie = inv[inv_file_id]
 
128
        return ie.revision
111
129
 
112
130
    def is_executable(self, file_id, path=None):
113
 
        ie = self._inventory[file_id]
 
131
        inv, inv_file_id = self._unpack_file_id(file_id)
 
132
        ie = inv[inv_file_id]
114
133
        if ie.kind != "file":
115
 
            return None
 
134
            return False
116
135
        return ie.executable
117
136
 
118
137
    def has_filename(self, filename):
119
 
        return bool(self.inventory.path2id(filename))
 
138
        return bool(self.path2id(filename))
120
139
 
121
 
    def list_files(self, include_root=False):
 
140
    def list_files(self, include_root=False, from_dir=None, recursive=True):
122
141
        # The only files returned by this are those from the version
123
 
        entries = self.inventory.iter_entries()
124
 
        # skip the root for compatability with the current apis.
125
 
        if self.inventory.root is not None and not include_root:
 
142
        if from_dir is None:
 
143
            from_dir_id = None
 
144
            inv = self.root_inventory
 
145
        else:
 
146
            inv, from_dir_id = self._path2inv_file_id(from_dir)
 
147
            if from_dir_id is None:
 
148
                # Directory not versioned
 
149
                return
 
150
        entries = inv.iter_entries(from_dir=from_dir_id, recursive=recursive)
 
151
        if inv.root is not None and not include_root and from_dir is None:
126
152
            # skip the root for compatability with the current apis.
127
153
            entries.next()
128
154
        for path, entry in entries:
129
155
            yield path, 'V', entry.kind, entry.file_id, entry
130
156
 
131
 
    def get_symlink_target(self, file_id):
132
 
        ie = self._inventory[file_id]
133
 
        return ie.symlink_target;
 
157
    def get_symlink_target(self, file_id, path=None):
 
158
        inv, inv_file_id = self._unpack_file_id(file_id)
 
159
        ie = inv[inv_file_id]
 
160
        # Inventories store symlink targets in unicode
 
161
        return ie.symlink_target
134
162
 
135
163
    def get_reference_revision(self, file_id, path=None):
136
 
        return self.inventory[file_id].reference_revision
 
164
        inv, inv_file_id = self._unpack_file_id(file_id)
 
165
        return inv[inv_file_id].reference_revision
137
166
 
138
167
    def get_root_id(self):
139
 
        if self.inventory.root:
140
 
            return self.inventory.root.file_id
 
168
        if self.root_inventory.root:
 
169
            return self.root_inventory.root.file_id
141
170
 
142
171
    def kind(self, file_id):
143
 
        return self._inventory[file_id].kind
 
172
        inv, inv_file_id = self._unpack_file_id(file_id)
 
173
        return inv[inv_file_id].kind
144
174
 
145
175
    def path_content_summary(self, path):
146
176
        """See Tree.path_content_summary."""
147
 
        id = self.inventory.path2id(path)
148
 
        if id is None:
 
177
        inv, file_id = self._path2inv_file_id(path)
 
178
        if file_id is None:
149
179
            return ('missing', None, None, None)
150
 
        entry = self._inventory[id]
 
180
        entry = inv[file_id]
151
181
        kind = entry.kind
152
182
        if kind == 'file':
153
183
            return (kind, entry.text_size, entry.executable, entry.text_sha1)
162
192
        return entry.kind, entry.executable, None
163
193
 
164
194
    def _file_size(self, entry, stat_value):
165
 
        assert entry.text_size is not None
166
195
        return entry.text_size
167
196
 
168
 
    def _get_ancestors(self, default_revision):
169
 
        return set(self._repository.get_ancestry(self._revision_id,
170
 
                                                 topo_sorted=False))
171
 
 
172
 
    def lock_read(self):
173
 
        self._repository.lock_read()
174
 
 
175
 
    def __repr__(self):
176
 
        return '<%s instance at %x, rev_id=%r>' % (
177
 
            self.__class__.__name__, id(self), self._revision_id)
178
 
 
179
 
    def unlock(self):
180
 
        self._repository.unlock()
181
 
 
182
197
    def walkdirs(self, prefix=""):
183
198
        _directory = 'directory'
184
 
        inv = self.inventory
185
 
        top_id = inv.path2id(prefix)
 
199
        inv, top_id = self._path2inv_file_id(prefix)
186
200
        if top_id is None:
187
201
            pending = []
188
202
        else:
207
221
            for dir in reversed(dirblock):
208
222
                if dir[2] == _directory:
209
223
                    pending.append(dir)
 
224
 
 
225
    def iter_files_bytes(self, desired_files):
 
226
        """See Tree.iter_files_bytes.
 
227
 
 
228
        This version is implemented on top of Repository.iter_files_bytes"""
 
229
        repo_desired_files = [(f, self.get_file_revision(f), i)
 
230
                              for f, i in desired_files]
 
231
        try:
 
232
            for result in self._repository.iter_files_bytes(repo_desired_files):
 
233
                yield result
 
234
        except errors.RevisionNotPresent, e:
 
235
            raise errors.NoSuchFile(e.file_id)
 
236
 
 
237
    def annotate_iter(self, file_id,
 
238
                      default_revision=revision.CURRENT_REVISION):
 
239
        """See Tree.annotate_iter"""
 
240
        text_key = (file_id, self.get_file_revision(file_id))
 
241
        annotator = self._repository.texts.get_annotator()
 
242
        annotations = annotator.annotate_flat(text_key)
 
243
        return [(key[-1], line) for key, line in annotations]
 
244
 
 
245
    def __eq__(self, other):
 
246
        if self is other:
 
247
            return True
 
248
        if isinstance(other, InventoryRevisionTree):
 
249
            return (self.root_inventory == other.root_inventory)
 
250
        return False
 
251
 
 
252
    def __ne__(self, other):
 
253
        return not (self == other)
 
254
 
 
255
    def __hash__(self):
 
256
        raise ValueError('not hashable')
 
257
 
 
258
 
 
259
class InterCHKRevisionTree(tree.InterTree):
 
260
    """Fast path optimiser for RevisionTrees with CHK inventories."""
 
261
 
 
262
    @staticmethod
 
263
    def is_compatible(source, target):
 
264
        if (isinstance(source, RevisionTree)
 
265
            and isinstance(target, RevisionTree)):
 
266
            try:
 
267
                # Only CHK inventories have id_to_entry attribute
 
268
                source.root_inventory.id_to_entry
 
269
                target.root_inventory.id_to_entry
 
270
                return True
 
271
            except AttributeError:
 
272
                pass
 
273
        return False
 
274
 
 
275
    def iter_changes(self, include_unchanged=False,
 
276
                     specific_files=None, pb=None, extra_trees=[],
 
277
                     require_versioned=True, want_unversioned=False):
 
278
        lookup_trees = [self.source]
 
279
        if extra_trees:
 
280
             lookup_trees.extend(extra_trees)
 
281
        # The ids of items we need to examine to insure delta consistency.
 
282
        precise_file_ids = set()
 
283
        discarded_changes = {}
 
284
        if specific_files == []:
 
285
            specific_file_ids = []
 
286
        else:
 
287
            specific_file_ids = self.target.paths2ids(specific_files,
 
288
                lookup_trees, require_versioned=require_versioned)
 
289
        # FIXME: It should be possible to delegate include_unchanged handling
 
290
        # to CHKInventory.iter_changes and do a better job there -- vila
 
291
        # 20090304
 
292
        changed_file_ids = set()
 
293
        # FIXME: nested tree support
 
294
        for result in self.target.root_inventory.iter_changes(
 
295
                self.source.root_inventory):
 
296
            if specific_file_ids is not None:
 
297
                file_id = result[0]
 
298
                if file_id not in specific_file_ids:
 
299
                    # A change from the whole tree that we don't want to show yet.
 
300
                    # We may find that we need to show it for delta consistency, so
 
301
                    # stash it.
 
302
                    discarded_changes[result[0]] = result
 
303
                    continue
 
304
                new_parent_id = result[4][1]
 
305
                precise_file_ids.add(new_parent_id)
 
306
            yield result
 
307
            changed_file_ids.add(result[0])
 
308
        if specific_file_ids is not None:
 
309
            for result in self._handle_precise_ids(precise_file_ids,
 
310
                changed_file_ids, discarded_changes=discarded_changes):
 
311
                yield result
 
312
        if include_unchanged:
 
313
            # CHKMap avoid being O(tree), so we go to O(tree) only if
 
314
            # required to.
 
315
            # Now walk the whole inventory, excluding the already yielded
 
316
            # file ids
 
317
            # FIXME: Support nested trees
 
318
            changed_file_ids = set(changed_file_ids)
 
319
            for relpath, entry in self.target.root_inventory.iter_entries():
 
320
                if (specific_file_ids is not None
 
321
                    and not entry.file_id in specific_file_ids):
 
322
                    continue
 
323
                if not entry.file_id in changed_file_ids:
 
324
                    yield (entry.file_id,
 
325
                           (relpath, relpath), # Not renamed
 
326
                           False, # Not modified
 
327
                           (True, True), # Still  versioned
 
328
                           (entry.parent_id, entry.parent_id),
 
329
                           (entry.name, entry.name),
 
330
                           (entry.kind, entry.kind),
 
331
                           (entry.executable, entry.executable))
 
332
 
 
333
 
 
334
tree.InterTree.register_optimiser(InterCHKRevisionTree)