/brz/remove-bazaar

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

« back to all changes in this revision

Viewing changes to bzrlib/knit.py

  • Committer: Jelmer Vernooij
  • Date: 2009-02-25 02:05:35 UTC
  • mto: This revision was merged to the branch mainline in revision 4053.
  • Revision ID: jelmer@samba.org-20090225020535-qw7udfz9ploqzosn
Add tests for InterBranch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 2005, 2006, 2007, 2008 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
"""Knit versionedfile implementation.
18
18
 
53
53
 
54
54
 
55
55
from cStringIO import StringIO
56
 
from itertools import izip
 
56
from itertools import izip, chain
57
57
import operator
58
58
import os
59
59
import sys
69
69
    lru_cache,
70
70
    pack,
71
71
    progress,
72
 
    static_tuple,
73
72
    trace,
74
73
    tsort,
75
74
    tuned_gzip,
76
 
    ui,
77
75
    )
78
76
""")
79
77
from bzrlib import (
105
103
    ConstantMapper,
106
104
    ContentFactory,
107
105
    ChunkedContentFactory,
108
 
    sort_groupcompress,
109
106
    VersionedFile,
110
107
    VersionedFiles,
111
108
    )
126
123
 
127
124
DATA_SUFFIX = '.knit'
128
125
INDEX_SUFFIX = '.kndx'
129
 
_STREAM_MIN_BUFFER_SIZE = 5*1024*1024
130
126
 
131
127
 
132
128
class KnitAdapter(object):
301
297
            if self._network_bytes is None:
302
298
                self._create_network_bytes()
303
299
            return self._network_bytes
304
 
        if ('-ft-' in self.storage_kind and
305
 
            storage_kind in ('chunked', 'fulltext')):
306
 
            adapter_key = (self.storage_kind, 'fulltext')
307
 
            adapter_factory = adapter_registry.get(adapter_key)
308
 
            adapter = adapter_factory(None)
309
 
            bytes = adapter.get_bytes(self)
310
 
            if storage_kind == 'chunked':
311
 
                return [bytes]
312
 
            else:
313
 
                return bytes
314
300
        if self._knit is not None:
315
 
            # Not redundant with direct conversion above - that only handles
316
 
            # fulltext cases.
317
301
            if storage_kind == 'chunked':
318
302
                return self._knit.get_lines(self.key[0])
319
303
            elif storage_kind == 'fulltext':
666
650
 
667
651
        see parse_fulltext which this inverts.
668
652
        """
 
653
        # TODO: jam 20070209 We only do the caching thing to make sure that
 
654
        #       the origin is a valid utf-8 line, eventually we could remove it
669
655
        return ['%s %s' % (o, t) for o, t in content._lines]
670
656
 
671
657
    def lower_line_delta(self, delta):
686
672
        content = knit._get_content(key)
687
673
        # adjust for the fact that serialised annotations are only key suffixes
688
674
        # for this factory.
689
 
        if type(key) is tuple:
 
675
        if type(key) == tuple:
690
676
            prefix = key[:-1]
691
677
            origins = content.annotate()
692
678
            result = []
758
744
 
759
745
    def annotate(self, knit, key):
760
746
        annotator = _KnitAnnotator(knit)
761
 
        return annotator.annotate_flat(key)
 
747
        return annotator.annotate(key)
762
748
 
763
749
 
764
750
 
820
806
    versioned_files.writer.end()
821
807
 
822
808
 
823
 
def _get_total_build_size(self, keys, positions):
824
 
    """Determine the total bytes to build these keys.
825
 
 
826
 
    (helper function because _KnitGraphIndex and _KndxIndex work the same, but
827
 
    don't inherit from a common base.)
828
 
 
829
 
    :param keys: Keys that we want to build
830
 
    :param positions: dict of {key, (info, index_memo, comp_parent)} (such
831
 
        as returned by _get_components_positions)
832
 
    :return: Number of bytes to build those keys
833
 
    """
834
 
    all_build_index_memos = {}
835
 
    build_keys = keys
836
 
    while build_keys:
837
 
        next_keys = set()
838
 
        for key in build_keys:
839
 
            # This is mostly for the 'stacked' case
840
 
            # Where we will be getting the data from a fallback
841
 
            if key not in positions:
842
 
                continue
843
 
            _, index_memo, compression_parent = positions[key]
844
 
            all_build_index_memos[key] = index_memo
845
 
            if compression_parent not in all_build_index_memos:
846
 
                next_keys.add(compression_parent)
847
 
        build_keys = next_keys
848
 
    return sum([index_memo[2] for index_memo
849
 
                in all_build_index_memos.itervalues()])
850
 
 
851
 
 
852
809
class KnitVersionedFiles(VersionedFiles):
853
810
    """Storage for many versioned files using knit compression.
854
811
 
909
866
            # indexes can't directly store that, so we give them
910
867
            # an empty tuple instead.
911
868
            parents = ()
912
 
        line_bytes = ''.join(lines)
913
869
        return self._add(key, lines, parents,
914
 
            parent_texts, left_matching_blocks, nostore_sha, random_id,
915
 
            line_bytes=line_bytes)
916
 
 
917
 
    def _add_text(self, key, parents, text, nostore_sha=None, random_id=False):
918
 
        """See VersionedFiles._add_text()."""
919
 
        self._index._check_write_ok()
920
 
        self._check_add(key, None, random_id, check_content=False)
921
 
        if text.__class__ is not str:
922
 
            raise errors.BzrBadParameterUnicode("text")
923
 
        if parents is None:
924
 
            # The caller might pass None if there is no graph data, but kndx
925
 
            # indexes can't directly store that, so we give them
926
 
            # an empty tuple instead.
927
 
            parents = ()
928
 
        return self._add(key, None, parents,
929
 
            None, None, nostore_sha, random_id,
930
 
            line_bytes=text)
 
870
            parent_texts, left_matching_blocks, nostore_sha, random_id)
931
871
 
932
872
    def _add(self, key, lines, parents, parent_texts,
933
 
        left_matching_blocks, nostore_sha, random_id,
934
 
        line_bytes):
 
873
        left_matching_blocks, nostore_sha, random_id):
935
874
        """Add a set of lines on top of version specified by parents.
936
875
 
937
876
        Any versions not present will be converted into ghosts.
938
 
 
939
 
        :param lines: A list of strings where each one is a single line (has a
940
 
            single newline at the end of the string) This is now optional
941
 
            (callers can pass None). It is left in its location for backwards
942
 
            compatibility. It should ''.join(lines) must == line_bytes
943
 
        :param line_bytes: A single string containing the content
944
 
 
945
 
        We pass both lines and line_bytes because different routes bring the
946
 
        values to this function. And for memory efficiency, we don't want to
947
 
        have to split/join on-demand.
948
877
        """
949
878
        # first thing, if the content is something we don't need to store, find
950
879
        # that out.
 
880
        line_bytes = ''.join(lines)
951
881
        digest = sha_string(line_bytes)
952
882
        if nostore_sha == digest:
953
883
            raise errors.ExistingContent
974
904
 
975
905
        text_length = len(line_bytes)
976
906
        options = []
977
 
        no_eol = False
978
 
        # Note: line_bytes is not modified to add a newline, that is tracked
979
 
        #       via the no_eol flag. 'lines' *is* modified, because that is the
980
 
        #       general values needed by the Content code.
981
 
        if line_bytes and line_bytes[-1] != '\n':
982
 
            options.append('no-eol')
983
 
            no_eol = True
984
 
            # Copy the existing list, or create a new one
985
 
            if lines is None:
986
 
                lines = osutils.split_lines(line_bytes)
987
 
            else:
 
907
        if lines:
 
908
            if lines[-1][-1] != '\n':
 
909
                # copy the contents of lines.
988
910
                lines = lines[:]
989
 
            # Replace the last line with one that ends in a final newline
990
 
            lines[-1] = lines[-1] + '\n'
991
 
        if lines is None:
992
 
            lines = osutils.split_lines(line_bytes)
 
911
                options.append('no-eol')
 
912
                lines[-1] = lines[-1] + '\n'
 
913
                line_bytes += '\n'
993
914
 
994
 
        for element in key[:-1]:
995
 
            if type(element) is not str:
996
 
                raise TypeError("key contains non-strings: %r" % (key,))
997
 
        if key[-1] is None:
998
 
            key = key[:-1] + ('sha1:' + digest,)
999
 
        elif type(key[-1]) is not str:
 
915
        for element in key:
 
916
            if type(element) != str:
1000
917
                raise TypeError("key contains non-strings: %r" % (key,))
1001
918
        # Knit hunks are still last-element only
1002
919
        version_id = key[-1]
1003
920
        content = self._factory.make(lines, version_id)
1004
 
        if no_eol:
 
921
        if 'no-eol' in options:
1005
922
            # Hint to the content object that its text() call should strip the
1006
923
            # EOL.
1007
924
            content._should_strip_eol = True
1019
936
        else:
1020
937
            options.append('fulltext')
1021
938
            # isinstance is slower and we have no hierarchy.
1022
 
            if self._factory.__class__ is KnitPlainFactory:
 
939
            if self._factory.__class__ == KnitPlainFactory:
1023
940
                # Use the already joined bytes saving iteration time in
1024
941
                # _record_to_data.
1025
 
                dense_lines = [line_bytes]
1026
 
                if no_eol:
1027
 
                    dense_lines.append('\n')
1028
942
                size, bytes = self._record_to_data(key, digest,
1029
 
                    lines, dense_lines)
 
943
                    lines, [line_bytes])
1030
944
            else:
1031
945
                # get mixed annotation + content and feed it into the
1032
946
                # serialiser.
1044
958
        """See VersionedFiles.annotate."""
1045
959
        return self._factory.annotate(self, key)
1046
960
 
1047
 
    def get_annotator(self):
1048
 
        return _KnitAnnotator(self)
1049
 
 
1050
 
    def check(self, progress_bar=None, keys=None):
 
961
    def check(self, progress_bar=None):
1051
962
        """See VersionedFiles.check()."""
1052
 
        if keys is None:
1053
 
            return self._logical_check()
1054
 
        else:
1055
 
            # At the moment, check does not extra work over get_record_stream
1056
 
            return self.get_record_stream(keys, 'unordered', True)
1057
 
 
1058
 
    def _logical_check(self):
1059
963
        # This doesn't actually test extraction of everything, but that will
1060
964
        # impact 'bzr check' substantially, and needs to be integrated with
1061
965
        # care. However, it does check for the obvious problem of a delta with
1075
979
    def _check_add(self, key, lines, random_id, check_content):
1076
980
        """check that version_id and lines are safe to add."""
1077
981
        version_id = key[-1]
1078
 
        if version_id is not None:
1079
 
            if contains_whitespace(version_id):
1080
 
                raise InvalidRevisionId(version_id, self)
1081
 
            self.check_not_reserved_id(version_id)
 
982
        if contains_whitespace(version_id):
 
983
            raise InvalidRevisionId(version_id, self)
 
984
        self.check_not_reserved_id(version_id)
1082
985
        # TODO: If random_id==False and the key is already present, we should
1083
986
        # probably check that the existing content is identical to what is
1084
987
        # being inserted, and otherwise raise an exception.  This would make
1192
1095
        generator = _VFContentMapGenerator(self, [key])
1193
1096
        return generator._get_content(key)
1194
1097
 
1195
 
    def get_known_graph_ancestry(self, keys):
1196
 
        """Get a KnownGraph instance with the ancestry of keys."""
1197
 
        parent_map, missing_keys = self._index.find_ancestry(keys)
1198
 
        for fallback in self._fallback_vfs:
1199
 
            if not missing_keys:
1200
 
                break
1201
 
            (f_parent_map, f_missing_keys) = fallback._index.find_ancestry(
1202
 
                                                missing_keys)
1203
 
            parent_map.update(f_parent_map)
1204
 
            missing_keys = f_missing_keys
1205
 
        kg = _mod_graph.KnownGraph(parent_map)
1206
 
        return kg
1207
 
 
1208
1098
    def get_parent_map(self, keys):
1209
1099
        """Get a map of the graph parents of keys.
1210
1100
 
1291
1181
                # n = next
1292
1182
                records = [(key, i_m) for key, (r, i_m, n)
1293
1183
                                       in position_map.iteritems()]
1294
 
                # Sort by the index memo, so that we request records from the
1295
 
                # same pack file together, and in forward-sorted order
1296
 
                records.sort(key=operator.itemgetter(1))
1297
1184
                raw_record_map = {}
1298
1185
                for key, data in self._read_records_iter_unchecked(records):
1299
1186
                    (record_details, index_memo, next) = position_map[key]
1302
1189
            except errors.RetryWithNewPacks, e:
1303
1190
                self._access.reload_or_raise(e)
1304
1191
 
1305
 
    @classmethod
1306
 
    def _split_by_prefix(cls, keys):
 
1192
    def _split_by_prefix(self, keys):
1307
1193
        """For the given keys, split them up based on their prefix.
1308
1194
 
1309
1195
        To keep memory pressure somewhat under control, split the
1312
1198
        This should be revisited if _get_content_maps() can ever cross
1313
1199
        file-id boundaries.
1314
1200
 
1315
 
        The keys for a given file_id are kept in the same relative order.
1316
 
        Ordering between file_ids is not, though prefix_order will return the
1317
 
        order that the key was first seen.
1318
 
 
1319
1201
        :param keys: An iterable of key tuples
1320
 
        :return: (split_map, prefix_order)
1321
 
            split_map       A dictionary mapping prefix => keys
1322
 
            prefix_order    The order that we saw the various prefixes
 
1202
        :return: A dict of {prefix: [key_list]}
1323
1203
        """
1324
1204
        split_by_prefix = {}
1325
 
        prefix_order = []
1326
1205
        for key in keys:
1327
1206
            if len(key) == 1:
1328
 
                prefix = ''
1329
 
            else:
1330
 
                prefix = key[0]
1331
 
 
1332
 
            if prefix in split_by_prefix:
1333
 
                split_by_prefix[prefix].append(key)
1334
 
            else:
1335
 
                split_by_prefix[prefix] = [key]
1336
 
                prefix_order.append(prefix)
1337
 
        return split_by_prefix, prefix_order
1338
 
 
1339
 
    def _group_keys_for_io(self, keys, non_local_keys, positions,
1340
 
                           _min_buffer_size=_STREAM_MIN_BUFFER_SIZE):
1341
 
        """For the given keys, group them into 'best-sized' requests.
1342
 
 
1343
 
        The idea is to avoid making 1 request per file, but to never try to
1344
 
        unpack an entire 1.5GB source tree in a single pass. Also when
1345
 
        possible, we should try to group requests to the same pack file
1346
 
        together.
1347
 
 
1348
 
        :return: list of (keys, non_local) tuples that indicate what keys
1349
 
            should be fetched next.
1350
 
        """
1351
 
        # TODO: Ideally we would group on 2 factors. We want to extract texts
1352
 
        #       from the same pack file together, and we want to extract all
1353
 
        #       the texts for a given build-chain together. Ultimately it
1354
 
        #       probably needs a better global view.
1355
 
        total_keys = len(keys)
1356
 
        prefix_split_keys, prefix_order = self._split_by_prefix(keys)
1357
 
        prefix_split_non_local_keys, _ = self._split_by_prefix(non_local_keys)
1358
 
        cur_keys = []
1359
 
        cur_non_local = set()
1360
 
        cur_size = 0
1361
 
        result = []
1362
 
        sizes = []
1363
 
        for prefix in prefix_order:
1364
 
            keys = prefix_split_keys[prefix]
1365
 
            non_local = prefix_split_non_local_keys.get(prefix, [])
1366
 
 
1367
 
            this_size = self._index._get_total_build_size(keys, positions)
1368
 
            cur_size += this_size
1369
 
            cur_keys.extend(keys)
1370
 
            cur_non_local.update(non_local)
1371
 
            if cur_size > _min_buffer_size:
1372
 
                result.append((cur_keys, cur_non_local))
1373
 
                sizes.append(cur_size)
1374
 
                cur_keys = []
1375
 
                cur_non_local = set()
1376
 
                cur_size = 0
1377
 
        if cur_keys:
1378
 
            result.append((cur_keys, cur_non_local))
1379
 
            sizes.append(cur_size)
1380
 
        return result
 
1207
                split_by_prefix.setdefault('', []).append(key)
 
1208
            else:
 
1209
                split_by_prefix.setdefault(key[0], []).append(key)
 
1210
        return split_by_prefix
1381
1211
 
1382
1212
    def get_record_stream(self, keys, ordering, include_delta_closure):
1383
1213
        """Get a stream of records for keys.
1396
1226
        if not keys:
1397
1227
            return
1398
1228
        if not self._index.has_graph:
1399
 
            # Cannot sort when no graph has been stored.
 
1229
            # Cannot topological order when no graph has been stored.
1400
1230
            ordering = 'unordered'
1401
1231
 
1402
1232
        remaining_keys = keys
1458
1288
                    needed_from_fallback.add(key)
1459
1289
        # Double index lookups here : need a unified api ?
1460
1290
        global_map, parent_maps = self._get_parent_map_with_sources(keys)
1461
 
        if ordering in ('topological', 'groupcompress'):
1462
 
            if ordering == 'topological':
1463
 
                # Global topological sort
1464
 
                present_keys = tsort.topo_sort(global_map)
1465
 
            else:
1466
 
                present_keys = sort_groupcompress(global_map)
 
1291
        if ordering == 'topological':
 
1292
            # Global topological sort
 
1293
            present_keys = tsort.topo_sort(global_map)
1467
1294
            # Now group by source:
1468
1295
            source_keys = []
1469
1296
            current_source = None
1479
1306
        else:
1480
1307
            if ordering != 'unordered':
1481
1308
                raise AssertionError('valid values for ordering are:'
1482
 
                    ' "unordered", "groupcompress" or "topological" not: %r'
 
1309
                    ' "unordered" or "topological" not: %r'
1483
1310
                    % (ordering,))
1484
1311
            # Just group by source; remote sources first.
1485
1312
            present_keys = []
1507
1334
            # XXX: get_content_maps performs its own index queries; allow state
1508
1335
            # to be passed in.
1509
1336
            non_local_keys = needed_from_fallback - absent_keys
1510
 
            for keys, non_local_keys in self._group_keys_for_io(present_keys,
1511
 
                                                                non_local_keys,
1512
 
                                                                positions):
1513
 
                generator = _VFContentMapGenerator(self, keys, non_local_keys,
1514
 
                                                   global_map,
1515
 
                                                   ordering=ordering)
 
1337
            prefix_split_keys = self._split_by_prefix(present_keys)
 
1338
            prefix_split_non_local_keys = self._split_by_prefix(non_local_keys)
 
1339
            for prefix, keys in prefix_split_keys.iteritems():
 
1340
                non_local = prefix_split_non_local_keys.get(prefix, [])
 
1341
                non_local = set(non_local)
 
1342
                generator = _VFContentMapGenerator(self, keys, non_local,
 
1343
                    global_map)
1516
1344
                for record in generator.get_record_stream():
1517
1345
                    yield record
1518
1346
        else:
1520
1348
                if source is parent_maps[0]:
1521
1349
                    # this KnitVersionedFiles
1522
1350
                    records = [(key, positions[key][1]) for key in keys]
1523
 
                    for key, raw_data in self._read_records_iter_unchecked(records):
 
1351
                    for key, raw_data, sha1 in self._read_records_iter_raw(records):
1524
1352
                        (record_details, index_memo, _) = positions[key]
1525
1353
                        yield KnitContentFactory(key, global_map[key],
1526
 
                            record_details, None, raw_data, self._factory.annotated, None)
 
1354
                            record_details, sha1, raw_data, self._factory.annotated, None)
1527
1355
                else:
1528
1356
                    vf = self._fallback_vfs[parent_maps.index(source) - 1]
1529
1357
                    for record in vf.get_record_stream(keys, ordering,
1598
1426
        # key = basis_parent, value = index entry to add
1599
1427
        buffered_index_entries = {}
1600
1428
        for record in stream:
1601
 
            kind = record.storage_kind
1602
 
            if kind.startswith('knit-') and kind.endswith('-gz'):
1603
 
                # Check that the ID in the header of the raw knit bytes matches
1604
 
                # the record metadata.
1605
 
                raw_data = record._raw_record
1606
 
                df, rec = self._parse_record_header(record.key, raw_data)
1607
 
                df.close()
1608
 
            buffered = False
1609
1429
            parents = record.parents
1610
1430
            if record.storage_kind in delta_types:
1611
1431
                # TODO: eventually the record itself should track
1657
1477
                access_memo = self._access.add_raw_records(
1658
1478
                    [(record.key, len(bytes))], bytes)[0]
1659
1479
                index_entry = (record.key, options, access_memo, parents)
 
1480
                buffered = False
1660
1481
                if 'fulltext' not in options:
1661
1482
                    # Not a fulltext, so we need to make sure the compression
1662
1483
                    # parent will also be present.
1684
1505
                # KnitVersionedFiles doesn't permit deltas (_max_delta_chain ==
1685
1506
                # 0) or because it depends on a base only present in the
1686
1507
                # fallback kvfs.
1687
 
                self._access.flush()
1688
1508
                try:
1689
1509
                    # Try getting a fulltext directly from the record.
1690
1510
                    bytes = record.get_bytes_as('fulltext')
1698
1518
                except errors.RevisionAlreadyPresent:
1699
1519
                    pass
1700
1520
            # Add any records whose basis parent is now available.
1701
 
            if not buffered:
1702
 
                added_keys = [record.key]
1703
 
                while added_keys:
1704
 
                    key = added_keys.pop(0)
1705
 
                    if key in buffered_index_entries:
1706
 
                        index_entries = buffered_index_entries[key]
1707
 
                        self._index.add_records(index_entries)
1708
 
                        added_keys.extend(
1709
 
                            [index_entry[0] for index_entry in index_entries])
1710
 
                        del buffered_index_entries[key]
 
1521
            added_keys = [record.key]
 
1522
            while added_keys:
 
1523
                key = added_keys.pop(0)
 
1524
                if key in buffered_index_entries:
 
1525
                    index_entries = buffered_index_entries[key]
 
1526
                    self._index.add_records(index_entries)
 
1527
                    added_keys.extend(
 
1528
                        [index_entry[0] for index_entry in index_entries])
 
1529
                    del buffered_index_entries[key]
1711
1530
        if buffered_index_entries:
1712
1531
            # There were index entries buffered at the end of the stream,
1713
1532
            # So these need to be added (if the index supports holding such
1714
1533
            # entries for later insertion)
1715
 
            all_entries = []
1716
1534
            for key in buffered_index_entries:
1717
1535
                index_entries = buffered_index_entries[key]
1718
 
                all_entries.extend(index_entries)
1719
 
            self._index.add_records(
1720
 
                all_entries, missing_compression_parents=True)
 
1536
                self._index.add_records(index_entries,
 
1537
                    missing_compression_parents=True)
1721
1538
 
1722
1539
    def get_missing_compression_parent_keys(self):
1723
1540
        """Return an iterable of keys of missing compression parents.
1752
1569
         * If a requested key did not change any lines (or didn't have any
1753
1570
           lines), it may not be mentioned at all in the result.
1754
1571
 
1755
 
        :param pb: Progress bar supplied by caller.
1756
1572
        :return: An iterator over (line, key).
1757
1573
        """
1758
1574
        if pb is None:
1759
 
            pb = ui.ui_factory.nested_progress_bar()
 
1575
            pb = progress.DummyProgress()
1760
1576
        keys = set(keys)
1761
1577
        total = len(keys)
1762
1578
        done = False
1772
1588
                        key_records.append((key, details[0]))
1773
1589
                records_iter = enumerate(self._read_records_iter(key_records))
1774
1590
                for (key_idx, (key, data, sha_value)) in records_iter:
1775
 
                    pb.update('Walking content', key_idx, total)
 
1591
                    pb.update('Walking content.', key_idx, total)
1776
1592
                    compression_parent = build_details[key][1]
1777
1593
                    if compression_parent is None:
1778
1594
                        # fulltext
1808
1624
                source_keys.add(key)
1809
1625
                yield line, key
1810
1626
            keys.difference_update(source_keys)
1811
 
        pb.update('Walking content', total, total)
 
1627
        pb.update('Walking content.', total, total)
1812
1628
 
1813
1629
    def _make_line_delta(self, delta_seq, new_content):
1814
1630
        """Generate a line delta from delta_seq and new_content."""
1992
1808
            function spends less time resizing the final string.
1993
1809
        :return: (len, a StringIO instance with the raw data ready to read.)
1994
1810
        """
1995
 
        chunks = ["version %s %d %s\n" % (key[-1], len(lines), digest)]
1996
 
        chunks.extend(dense_lines or lines)
1997
 
        chunks.append("end %s\n" % key[-1])
1998
 
        for chunk in chunks:
1999
 
            if type(chunk) is not str:
2000
 
                raise AssertionError(
2001
 
                    'data must be plain bytes was %s' % type(chunk))
 
1811
        # Note: using a string copy here increases memory pressure with e.g.
 
1812
        # ISO's, but it is about 3 seconds faster on a 1.2Ghz intel machine
 
1813
        # when doing the initial commit of a mozilla tree. RBC 20070921
 
1814
        bytes = ''.join(chain(
 
1815
            ["version %s %d %s\n" % (key[-1],
 
1816
                                     len(lines),
 
1817
                                     digest)],
 
1818
            dense_lines or lines,
 
1819
            ["end %s\n" % key[-1]]))
 
1820
        if type(bytes) != str:
 
1821
            raise AssertionError(
 
1822
                'data must be plain bytes was %s' % type(bytes))
2002
1823
        if lines and lines[-1][-1] != '\n':
2003
1824
            raise ValueError('corrupt lines value %r' % lines)
2004
 
        compressed_bytes = tuned_gzip.chunks_to_gzip(chunks)
 
1825
        compressed_bytes = tuned_gzip.bytes_to_gzip(bytes)
2005
1826
        return len(compressed_bytes), compressed_bytes
2006
1827
 
2007
1828
    def _split_header(self, line):
2025
1846
class _ContentMapGenerator(object):
2026
1847
    """Generate texts or expose raw deltas for a set of texts."""
2027
1848
 
2028
 
    def __init__(self, ordering='unordered'):
2029
 
        self._ordering = ordering
2030
 
 
2031
1849
    def _get_content(self, key):
2032
1850
        """Get the content object for key."""
2033
1851
        # Note that _get_content is only called when the _ContentMapGenerator
2067
1885
            # Loop over fallback repositories asking them for texts - ignore
2068
1886
            # any missing from a particular fallback.
2069
1887
            for record in source.get_record_stream(missing_keys,
2070
 
                self._ordering, True):
 
1888
                'unordered', True):
2071
1889
                if record.storage_kind == 'absent':
2072
1890
                    # Not in thie particular stream, may be in one of the
2073
1891
                    # other fallback vfs objects.
2075
1893
                missing_keys.remove(record.key)
2076
1894
                yield record
2077
1895
 
2078
 
        if self._raw_record_map is None:
2079
 
            raise AssertionError('_raw_record_map should have been filled')
 
1896
        self._raw_record_map = self.vf._get_record_map_unparsed(self.keys,
 
1897
            allow_missing=True)
2080
1898
        first = True
2081
1899
        for key in self.keys:
2082
1900
            if key in self.nonlocal_keys:
2205
2023
    """Content map generator reading from a VersionedFiles object."""
2206
2024
 
2207
2025
    def __init__(self, versioned_files, keys, nonlocal_keys=None,
2208
 
        global_map=None, raw_record_map=None, ordering='unordered'):
 
2026
        global_map=None, raw_record_map=None):
2209
2027
        """Create a _ContentMapGenerator.
2210
2028
 
2211
2029
        :param versioned_files: The versioned files that the texts are being
2219
2037
        :param raw_record_map: A unparsed raw record map to use for answering
2220
2038
            contents.
2221
2039
        """
2222
 
        _ContentMapGenerator.__init__(self, ordering=ordering)
2223
2040
        # The vf to source data from
2224
2041
        self.vf = versioned_files
2225
2042
        # The keys desired
2369
2186
    FLAGS is a comma separated list of flags about the record. Values include
2370
2187
        no-eol, line-delta, fulltext.
2371
2188
    BYTE_OFFSET is the ascii representation of the byte offset in the data file
2372
 
        that the compressed data starts at.
 
2189
        that the the compressed data starts at.
2373
2190
    LENGTH is the ascii representation of the length of the data file.
2374
2191
    PARENT_ID a utf-8 revision id prefixed by a '.' that is a parent of
2375
2192
        REVISION_ID.
2446
2263
                    line = "\n%s %s %s %s %s :" % (
2447
2264
                        key[-1], ','.join(options), pos, size,
2448
2265
                        self._dictionary_compress(parents))
2449
 
                    if type(line) is not str:
 
2266
                    if type(line) != str:
2450
2267
                        raise AssertionError(
2451
2268
                            'data must be utf8 was %s' % type(line))
2452
2269
                    lines.append(line)
2584
2401
        except KeyError:
2585
2402
            raise RevisionNotPresent(key, self)
2586
2403
 
2587
 
    def find_ancestry(self, keys):
2588
 
        """See CombinedGraphIndex.find_ancestry()"""
2589
 
        prefixes = set(key[:-1] for key in keys)
2590
 
        self._load_prefixes(prefixes)
2591
 
        result = {}
2592
 
        parent_map = {}
2593
 
        missing_keys = set()
2594
 
        pending_keys = list(keys)
2595
 
        # This assumes that keys will not reference parents in a different
2596
 
        # prefix, which is accurate so far.
2597
 
        while pending_keys:
2598
 
            key = pending_keys.pop()
2599
 
            if key in parent_map:
2600
 
                continue
2601
 
            prefix = key[:-1]
2602
 
            try:
2603
 
                suffix_parents = self._kndx_cache[prefix][0][key[-1]][4]
2604
 
            except KeyError:
2605
 
                missing_keys.add(key)
2606
 
            else:
2607
 
                parent_keys = tuple([prefix + (suffix,)
2608
 
                                     for suffix in suffix_parents])
2609
 
                parent_map[key] = parent_keys
2610
 
                pending_keys.extend([p for p in parent_keys
2611
 
                                        if p not in parent_map])
2612
 
        return parent_map, missing_keys
2613
 
 
2614
2404
    def get_parent_map(self, keys):
2615
2405
        """Get a map of the parents of keys.
2616
2406
 
2668
2458
        result = set()
2669
2459
        # Identify all key prefixes.
2670
2460
        # XXX: A bit hacky, needs polish.
2671
 
        if type(self._mapper) is ConstantMapper:
 
2461
        if type(self._mapper) == ConstantMapper:
2672
2462
            prefixes = [()]
2673
2463
        else:
2674
2464
            relpaths = set()
2706
2496
                    del self._history
2707
2497
                except NoSuchFile:
2708
2498
                    self._kndx_cache[prefix] = ({}, [])
2709
 
                    if type(self._mapper) is ConstantMapper:
 
2499
                    if type(self._mapper) == ConstantMapper:
2710
2500
                        # preserve behaviour for revisions.kndx etc.
2711
2501
                        self._init_index(path)
2712
2502
                    del self._cache
2779
2569
            return index_memo[0][:-1], index_memo[1]
2780
2570
        return keys.sort(key=get_sort_key)
2781
2571
 
2782
 
    _get_total_build_size = _get_total_build_size
2783
 
 
2784
2572
    def _split_key(self, key):
2785
2573
        """Split key into a prefix and suffix."""
2786
2574
        return key[:-1], key[-1]
2787
2575
 
2788
2576
 
2789
 
class _KeyRefs(object):
2790
 
 
2791
 
    def __init__(self, track_new_keys=False):
2792
 
        # dict mapping 'key' to 'set of keys referring to that key'
2793
 
        self.refs = {}
2794
 
        if track_new_keys:
2795
 
            # set remembering all new keys
2796
 
            self.new_keys = set()
2797
 
        else:
2798
 
            self.new_keys = None
2799
 
 
2800
 
    def clear(self):
2801
 
        if self.refs:
2802
 
            self.refs.clear()
2803
 
        if self.new_keys:
2804
 
            self.new_keys.clear()
2805
 
 
2806
 
    def add_references(self, key, refs):
2807
 
        # Record the new references
2808
 
        for referenced in refs:
2809
 
            try:
2810
 
                needed_by = self.refs[referenced]
2811
 
            except KeyError:
2812
 
                needed_by = self.refs[referenced] = set()
2813
 
            needed_by.add(key)
2814
 
        # Discard references satisfied by the new key
2815
 
        self.add_key(key)
2816
 
 
2817
 
    def get_new_keys(self):
2818
 
        return self.new_keys
2819
 
    
2820
 
    def get_unsatisfied_refs(self):
2821
 
        return self.refs.iterkeys()
2822
 
 
2823
 
    def _satisfy_refs_for_key(self, key):
2824
 
        try:
2825
 
            del self.refs[key]
2826
 
        except KeyError:
2827
 
            # No keys depended on this key.  That's ok.
2828
 
            pass
2829
 
 
2830
 
    def add_key(self, key):
2831
 
        # satisfy refs for key, and remember that we've seen this key.
2832
 
        self._satisfy_refs_for_key(key)
2833
 
        if self.new_keys is not None:
2834
 
            self.new_keys.add(key)
2835
 
 
2836
 
    def satisfy_refs_for_keys(self, keys):
2837
 
        for key in keys:
2838
 
            self._satisfy_refs_for_key(key)
2839
 
 
2840
 
    def get_referrers(self):
2841
 
        result = set()
2842
 
        for referrers in self.refs.itervalues():
2843
 
            result.update(referrers)
2844
 
        return result
2845
 
 
2846
 
 
2847
2577
class _KnitGraphIndex(object):
2848
2578
    """A KnitVersionedFiles index layered on GraphIndex."""
2849
2579
 
2850
2580
    def __init__(self, graph_index, is_locked, deltas=False, parents=True,
2851
 
        add_callback=None, track_external_parent_refs=False):
 
2581
        add_callback=None):
2852
2582
        """Construct a KnitGraphIndex on a graph_index.
2853
2583
 
2854
2584
        :param graph_index: An implementation of bzrlib.index.GraphIndex.
2862
2592
            [(node, value, node_refs), ...]
2863
2593
        :param is_locked: A callback, returns True if the index is locked and
2864
2594
            thus usable.
2865
 
        :param track_external_parent_refs: If True, record all external parent
2866
 
            references parents from added records.  These can be retrieved
2867
 
            later by calling get_missing_parents().
2868
2595
        """
2869
2596
        self._add_callback = add_callback
2870
2597
        self._graph_index = graph_index
2878
2605
        self.has_graph = parents
2879
2606
        self._is_locked = is_locked
2880
2607
        self._missing_compression_parents = set()
2881
 
        if track_external_parent_refs:
2882
 
            self._key_dependencies = _KeyRefs()
2883
 
        else:
2884
 
            self._key_dependencies = None
2885
2608
 
2886
2609
    def __repr__(self):
2887
2610
        return "%s(%r)" % (self.__class__.__name__, self._graph_index)
2911
2634
 
2912
2635
        keys = {}
2913
2636
        compression_parents = set()
2914
 
        key_dependencies = self._key_dependencies
2915
2637
        for (key, options, access_memo, parents) in records:
2916
2638
            if self._parents:
2917
2639
                parents = tuple(parents)
2918
 
                if key_dependencies is not None:
2919
 
                    key_dependencies.add_references(key, parents)
2920
2640
            index, pos, size = access_memo
2921
2641
            if 'no-eol' in options:
2922
2642
                value = 'N'
2946
2666
        if not random_id:
2947
2667
            present_nodes = self._get_entries(keys)
2948
2668
            for (index, key, value, node_refs) in present_nodes:
2949
 
                parents = node_refs[:1]
2950
 
                # Sometimes these are passed as a list rather than a tuple
2951
 
                passed = static_tuple.as_tuples(keys[key])
2952
 
                passed_parents = passed[1][:1]
2953
2669
                if (value[0] != keys[key][0][0] or
2954
 
                    parents != passed_parents):
2955
 
                    node_refs = static_tuple.as_tuples(node_refs)
 
2670
                    node_refs[:1] != keys[key][1][:1]):
2956
2671
                    raise KnitCorrupt(self, "inconsistent details in add_records"
2957
 
                        ": %s %s" % ((value, node_refs), passed))
 
2672
                        ": %s %s" % ((value, node_refs), keys[key]))
2958
2673
                del keys[key]
2959
2674
        result = []
2960
2675
        if self._parents:
2989
2704
            new_missing = graph_index.external_references(ref_list_num=1)
2990
2705
            new_missing.difference_update(self.get_parent_map(new_missing))
2991
2706
            self._missing_compression_parents.update(new_missing)
2992
 
        if self._key_dependencies is not None:
2993
 
            # Add parent refs from graph_index (and discard parent refs that
2994
 
            # the graph_index has).
2995
 
            for node in graph_index.iter_all_entries():
2996
 
                self._key_dependencies.add_references(node[1], node[3][0])
2997
2707
 
2998
2708
    def get_missing_compression_parents(self):
2999
2709
        """Return the keys of missing compression parents.
3003
2713
        """
3004
2714
        return frozenset(self._missing_compression_parents)
3005
2715
 
3006
 
    def get_missing_parents(self):
3007
 
        """Return the keys of missing parents."""
3008
 
        # If updating this, you should also update
3009
 
        # groupcompress._GCGraphIndex.get_missing_parents
3010
 
        # We may have false positives, so filter those out.
3011
 
        self._key_dependencies.satisfy_refs_for_keys(
3012
 
            self.get_parent_map(self._key_dependencies.get_unsatisfied_refs()))
3013
 
        return frozenset(self._key_dependencies.get_unsatisfied_refs())
3014
 
 
3015
2716
    def _check_read(self):
3016
2717
        """raise if reads are not permitted."""
3017
2718
        if not self._is_locked():
3125
2826
            options.append('no-eol')
3126
2827
        return options
3127
2828
 
3128
 
    def find_ancestry(self, keys):
3129
 
        """See CombinedGraphIndex.find_ancestry()"""
3130
 
        return self._graph_index.find_ancestry(keys, 0)
3131
 
 
3132
2829
    def get_parent_map(self, keys):
3133
2830
        """Get a map of the parents of keys.
3134
2831
 
3193
2890
            return positions[key][1]
3194
2891
        return keys.sort(key=get_index_memo)
3195
2892
 
3196
 
    _get_total_build_size = _get_total_build_size
3197
 
 
3198
2893
 
3199
2894
class _KnitKeyAccess(object):
3200
2895
    """Access to records in .knit files."""
3221
2916
            opaque index memo. For _KnitKeyAccess the memo is (key, pos,
3222
2917
            length), where the key is the record key.
3223
2918
        """
3224
 
        if type(raw_data) is not str:
 
2919
        if type(raw_data) != str:
3225
2920
            raise AssertionError(
3226
2921
                'data must be plain bytes was %s' % type(raw_data))
3227
2922
        result = []
3244
2939
            result.append((key, base, size))
3245
2940
        return result
3246
2941
 
3247
 
    def flush(self):
3248
 
        """Flush pending writes on this access object.
3249
 
        
3250
 
        For .knit files this is a no-op.
3251
 
        """
3252
 
        pass
3253
 
 
3254
2942
    def get_raw_records(self, memos_for_retrieval):
3255
2943
        """Get the raw bytes for a records.
3256
2944
 
3281
2969
class _DirectPackAccess(object):
3282
2970
    """Access to data in one or more packs with less translation."""
3283
2971
 
3284
 
    def __init__(self, index_to_packs, reload_func=None, flush_func=None):
 
2972
    def __init__(self, index_to_packs, reload_func=None):
3285
2973
        """Create a _DirectPackAccess object.
3286
2974
 
3287
2975
        :param index_to_packs: A dict mapping index objects to the transport
3294
2982
        self._write_index = None
3295
2983
        self._indices = index_to_packs
3296
2984
        self._reload_func = reload_func
3297
 
        self._flush_func = flush_func
3298
2985
 
3299
2986
    def add_raw_records(self, key_sizes, raw_data):
3300
2987
        """Add raw knit bytes to a storage area.
3310
2997
            length), where the index field is the write_index object supplied
3311
2998
            to the PackAccess object.
3312
2999
        """
3313
 
        if type(raw_data) is not str:
 
3000
        if type(raw_data) != str:
3314
3001
            raise AssertionError(
3315
3002
                'data must be plain bytes was %s' % type(raw_data))
3316
3003
        result = []
3322
3009
            result.append((self._write_index, p_offset, p_length))
3323
3010
        return result
3324
3011
 
3325
 
    def flush(self):
3326
 
        """Flush pending writes on this access object.
3327
 
 
3328
 
        This will flush any buffered writes to a NewPack.
3329
 
        """
3330
 
        if self._flush_func is not None:
3331
 
            self._flush_func()
3332
 
            
3333
3012
    def get_raw_records(self, memos_for_retrieval):
3334
3013
        """Get the raw bytes for a records.
3335
3014
 
3429
3108
    recommended.
3430
3109
    """
3431
3110
    annotator = _KnitAnnotator(knit)
3432
 
    return iter(annotator.annotate_flat(revision_id))
3433
 
 
3434
 
 
3435
 
class _KnitAnnotator(annotate.Annotator):
 
3111
    return iter(annotator.annotate(revision_id))
 
3112
 
 
3113
 
 
3114
class _KnitAnnotator(object):
3436
3115
    """Build up the annotations for a text."""
3437
3116
 
3438
 
    def __init__(self, vf):
3439
 
        annotate.Annotator.__init__(self, vf)
3440
 
 
3441
 
        # TODO: handle Nodes which cannot be extracted
3442
 
        # self._ghosts = set()
3443
 
 
3444
 
        # Map from (key, parent_key) => matching_blocks, should be 'use once'
3445
 
        self._matching_blocks = {}
3446
 
 
3447
 
        # KnitContent objects
3448
 
        self._content_objects = {}
3449
 
        # The number of children that depend on this fulltext content object
3450
 
        self._num_compression_children = {}
3451
 
        # Delta records that need their compression parent before they can be
3452
 
        # expanded
3453
 
        self._pending_deltas = {}
3454
 
        # Fulltext records that are waiting for their parents fulltexts before
3455
 
        # they can be yielded for annotation
3456
 
        self._pending_annotation = {}
 
3117
    def __init__(self, knit):
 
3118
        self._knit = knit
 
3119
 
 
3120
        # Content objects, differs from fulltexts because of how final newlines
 
3121
        # are treated by knits. the content objects here will always have a
 
3122
        # final newline
 
3123
        self._fulltext_contents = {}
 
3124
 
 
3125
        # Annotated lines of specific revisions
 
3126
        self._annotated_lines = {}
 
3127
 
 
3128
        # Track the raw data for nodes that we could not process yet.
 
3129
        # This maps the revision_id of the base to a list of children that will
 
3130
        # annotated from it.
 
3131
        self._pending_children = {}
 
3132
 
 
3133
        # Nodes which cannot be extracted
 
3134
        self._ghosts = set()
 
3135
 
 
3136
        # Track how many children this node has, so we know if we need to keep
 
3137
        # it
 
3138
        self._annotate_children = {}
 
3139
        self._compression_children = {}
3457
3140
 
3458
3141
        self._all_build_details = {}
 
3142
        # The children => parent revision_id graph
 
3143
        self._revision_id_graph = {}
 
3144
 
 
3145
        self._heads_provider = None
 
3146
 
 
3147
        self._nodes_to_keep_annotations = set()
 
3148
        self._generations_until_keep = 100
 
3149
 
 
3150
    def set_generations_until_keep(self, value):
 
3151
        """Set the number of generations before caching a node.
 
3152
 
 
3153
        Setting this to -1 will cache every merge node, setting this higher
 
3154
        will cache fewer nodes.
 
3155
        """
 
3156
        self._generations_until_keep = value
 
3157
 
 
3158
    def _add_fulltext_content(self, revision_id, content_obj):
 
3159
        self._fulltext_contents[revision_id] = content_obj
 
3160
        # TODO: jam 20080305 It might be good to check the sha1digest here
 
3161
        return content_obj.text()
 
3162
 
 
3163
    def _check_parents(self, child, nodes_to_annotate):
 
3164
        """Check if all parents have been processed.
 
3165
 
 
3166
        :param child: A tuple of (rev_id, parents, raw_content)
 
3167
        :param nodes_to_annotate: If child is ready, add it to
 
3168
            nodes_to_annotate, otherwise put it back in self._pending_children
 
3169
        """
 
3170
        for parent_id in child[1]:
 
3171
            if (parent_id not in self._annotated_lines):
 
3172
                # This parent is present, but another parent is missing
 
3173
                self._pending_children.setdefault(parent_id,
 
3174
                                                  []).append(child)
 
3175
                break
 
3176
        else:
 
3177
            # This one is ready to be processed
 
3178
            nodes_to_annotate.append(child)
 
3179
 
 
3180
    def _add_annotation(self, revision_id, fulltext, parent_ids,
 
3181
                        left_matching_blocks=None):
 
3182
        """Add an annotation entry.
 
3183
 
 
3184
        All parents should already have been annotated.
 
3185
        :return: A list of children that now have their parents satisfied.
 
3186
        """
 
3187
        a = self._annotated_lines
 
3188
        annotated_parent_lines = [a[p] for p in parent_ids]
 
3189
        annotated_lines = list(annotate.reannotate(annotated_parent_lines,
 
3190
            fulltext, revision_id, left_matching_blocks,
 
3191
            heads_provider=self._get_heads_provider()))
 
3192
        self._annotated_lines[revision_id] = annotated_lines
 
3193
        for p in parent_ids:
 
3194
            ann_children = self._annotate_children[p]
 
3195
            ann_children.remove(revision_id)
 
3196
            if (not ann_children
 
3197
                and p not in self._nodes_to_keep_annotations):
 
3198
                del self._annotated_lines[p]
 
3199
                del self._all_build_details[p]
 
3200
                if p in self._fulltext_contents:
 
3201
                    del self._fulltext_contents[p]
 
3202
        # Now that we've added this one, see if there are any pending
 
3203
        # deltas to be done, certainly this parent is finished
 
3204
        nodes_to_annotate = []
 
3205
        for child in self._pending_children.pop(revision_id, []):
 
3206
            self._check_parents(child, nodes_to_annotate)
 
3207
        return nodes_to_annotate
3459
3208
 
3460
3209
    def _get_build_graph(self, key):
3461
3210
        """Get the graphs for building texts and annotations.
3466
3215
        fulltext.)
3467
3216
 
3468
3217
        :return: A list of (key, index_memo) records, suitable for
3469
 
            passing to read_records_iter to start reading in the raw data from
 
3218
            passing to read_records_iter to start reading in the raw data fro/
3470
3219
            the pack file.
3471
3220
        """
 
3221
        if key in self._annotated_lines:
 
3222
            # Nothing to do
 
3223
            return []
3472
3224
        pending = set([key])
3473
3225
        records = []
3474
 
        ann_keys = set()
3475
 
        self._num_needed_children[key] = 1
 
3226
        generation = 0
 
3227
        kept_generation = 0
3476
3228
        while pending:
3477
3229
            # get all pending nodes
 
3230
            generation += 1
3478
3231
            this_iteration = pending
3479
 
            build_details = self._vf._index.get_build_details(this_iteration)
 
3232
            build_details = self._knit._index.get_build_details(this_iteration)
3480
3233
            self._all_build_details.update(build_details)
3481
 
            # new_nodes = self._vf._index._get_entries(this_iteration)
 
3234
            # new_nodes = self._knit._index._get_entries(this_iteration)
3482
3235
            pending = set()
3483
3236
            for key, details in build_details.iteritems():
3484
 
                (index_memo, compression_parent, parent_keys,
 
3237
                (index_memo, compression_parent, parents,
3485
3238
                 record_details) = details
3486
 
                self._parent_map[key] = parent_keys
3487
 
                self._heads_provider = None
 
3239
                self._revision_id_graph[key] = parents
3488
3240
                records.append((key, index_memo))
3489
3241
                # Do we actually need to check _annotated_lines?
3490
 
                pending.update([p for p in parent_keys
3491
 
                                   if p not in self._all_build_details])
3492
 
                if parent_keys:
3493
 
                    for parent_key in parent_keys:
3494
 
                        if parent_key in self._num_needed_children:
3495
 
                            self._num_needed_children[parent_key] += 1
3496
 
                        else:
3497
 
                            self._num_needed_children[parent_key] = 1
 
3242
                pending.update(p for p in parents
 
3243
                                 if p not in self._all_build_details)
3498
3244
                if compression_parent:
3499
 
                    if compression_parent in self._num_compression_children:
3500
 
                        self._num_compression_children[compression_parent] += 1
3501
 
                    else:
3502
 
                        self._num_compression_children[compression_parent] = 1
 
3245
                    self._compression_children.setdefault(compression_parent,
 
3246
                        []).append(key)
 
3247
                if parents:
 
3248
                    for parent in parents:
 
3249
                        self._annotate_children.setdefault(parent,
 
3250
                            []).append(key)
 
3251
                    num_gens = generation - kept_generation
 
3252
                    if ((num_gens >= self._generations_until_keep)
 
3253
                        and len(parents) > 1):
 
3254
                        kept_generation = generation
 
3255
                        self._nodes_to_keep_annotations.add(key)
3503
3256
 
3504
3257
            missing_versions = this_iteration.difference(build_details.keys())
3505
 
            if missing_versions:
3506
 
                for key in missing_versions:
3507
 
                    if key in self._parent_map and key in self._text_cache:
3508
 
                        # We already have this text ready, we just need to
3509
 
                        # yield it later so we get it annotated
3510
 
                        ann_keys.add(key)
3511
 
                        parent_keys = self._parent_map[key]
3512
 
                        for parent_key in parent_keys:
3513
 
                            if parent_key in self._num_needed_children:
3514
 
                                self._num_needed_children[parent_key] += 1
3515
 
                            else:
3516
 
                                self._num_needed_children[parent_key] = 1
3517
 
                        pending.update([p for p in parent_keys
3518
 
                                           if p not in self._all_build_details])
3519
 
                    else:
3520
 
                        raise errors.RevisionNotPresent(key, self._vf)
 
3258
            self._ghosts.update(missing_versions)
 
3259
            for missing_version in missing_versions:
 
3260
                # add a key, no parents
 
3261
                self._revision_id_graph[missing_version] = ()
 
3262
                pending.discard(missing_version) # don't look for it
 
3263
        if self._ghosts.intersection(self._compression_children):
 
3264
            raise KnitCorrupt(
 
3265
                "We cannot have nodes which have a ghost compression parent:\n"
 
3266
                "ghosts: %r\n"
 
3267
                "compression children: %r"
 
3268
                % (self._ghosts, self._compression_children))
 
3269
        # Cleanout anything that depends on a ghost so that we don't wait for
 
3270
        # the ghost to show up
 
3271
        for node in self._ghosts:
 
3272
            if node in self._annotate_children:
 
3273
                # We won't be building this node
 
3274
                del self._annotate_children[node]
3521
3275
        # Generally we will want to read the records in reverse order, because
3522
3276
        # we find the parent nodes after the children
3523
3277
        records.reverse()
3524
 
        return records, ann_keys
3525
 
 
3526
 
    def _get_needed_texts(self, key, pb=None):
3527
 
        # if True or len(self._vf._fallback_vfs) > 0:
3528
 
        if len(self._vf._fallback_vfs) > 0:
3529
 
            # If we have fallbacks, go to the generic path
3530
 
            for v in annotate.Annotator._get_needed_texts(self, key, pb=pb):
3531
 
                yield v
3532
 
            return
3533
 
        while True:
3534
 
            try:
3535
 
                records, ann_keys = self._get_build_graph(key)
3536
 
                for idx, (sub_key, text, num_lines) in enumerate(
3537
 
                                                self._extract_texts(records)):
3538
 
                    if pb is not None:
3539
 
                        pb.update('annotating', idx, len(records))
3540
 
                    yield sub_key, text, num_lines
3541
 
                for sub_key in ann_keys:
3542
 
                    text = self._text_cache[sub_key]
3543
 
                    num_lines = len(text) # bad assumption
3544
 
                    yield sub_key, text, num_lines
3545
 
                return
3546
 
            except errors.RetryWithNewPacks, e:
3547
 
                self._vf._access.reload_or_raise(e)
3548
 
                # The cached build_details are no longer valid
3549
 
                self._all_build_details.clear()
3550
 
 
3551
 
    def _cache_delta_blocks(self, key, compression_parent, delta, lines):
3552
 
        parent_lines = self._text_cache[compression_parent]
3553
 
        blocks = list(KnitContent.get_line_delta_blocks(delta, parent_lines, lines))
3554
 
        self._matching_blocks[(key, compression_parent)] = blocks
3555
 
 
3556
 
    def _expand_record(self, key, parent_keys, compression_parent, record,
3557
 
                       record_details):
3558
 
        delta = None
3559
 
        if compression_parent:
3560
 
            if compression_parent not in self._content_objects:
3561
 
                # Waiting for the parent
3562
 
                self._pending_deltas.setdefault(compression_parent, []).append(
3563
 
                    (key, parent_keys, record, record_details))
3564
 
                return None
3565
 
            # We have the basis parent, so expand the delta
3566
 
            num = self._num_compression_children[compression_parent]
3567
 
            num -= 1
3568
 
            if num == 0:
3569
 
                base_content = self._content_objects.pop(compression_parent)
3570
 
                self._num_compression_children.pop(compression_parent)
3571
 
            else:
3572
 
                self._num_compression_children[compression_parent] = num
3573
 
                base_content = self._content_objects[compression_parent]
3574
 
            # It is tempting to want to copy_base_content=False for the last
3575
 
            # child object. However, whenever noeol=False,
3576
 
            # self._text_cache[parent_key] is content._lines. So mutating it
3577
 
            # gives very bad results.
3578
 
            # The alternative is to copy the lines into text cache, but then we
3579
 
            # are copying anyway, so just do it here.
3580
 
            content, delta = self._vf._factory.parse_record(
3581
 
                key, record, record_details, base_content,
3582
 
                copy_base_content=True)
3583
 
        else:
3584
 
            # Fulltext record
3585
 
            content, _ = self._vf._factory.parse_record(
3586
 
                key, record, record_details, None)
3587
 
        if self._num_compression_children.get(key, 0) > 0:
3588
 
            self._content_objects[key] = content
3589
 
        lines = content.text()
3590
 
        self._text_cache[key] = lines
3591
 
        if delta is not None:
3592
 
            self._cache_delta_blocks(key, compression_parent, delta, lines)
3593
 
        return lines
3594
 
 
3595
 
    def _get_parent_annotations_and_matches(self, key, text, parent_key):
3596
 
        """Get the list of annotations for the parent, and the matching lines.
3597
 
 
3598
 
        :param text: The opaque value given by _get_needed_texts
3599
 
        :param parent_key: The key for the parent text
3600
 
        :return: (parent_annotations, matching_blocks)
3601
 
            parent_annotations is a list as long as the number of lines in
3602
 
                parent
3603
 
            matching_blocks is a list of (parent_idx, text_idx, len) tuples
3604
 
                indicating which lines match between the two texts
3605
 
        """
3606
 
        block_key = (key, parent_key)
3607
 
        if block_key in self._matching_blocks:
3608
 
            blocks = self._matching_blocks.pop(block_key)
3609
 
            parent_annotations = self._annotations_cache[parent_key]
3610
 
            return parent_annotations, blocks
3611
 
        return annotate.Annotator._get_parent_annotations_and_matches(self,
3612
 
            key, text, parent_key)
3613
 
 
3614
 
    def _process_pending(self, key):
3615
 
        """The content for 'key' was just processed.
3616
 
 
3617
 
        Determine if there is any more pending work to be processed.
3618
 
        """
3619
 
        to_return = []
3620
 
        if key in self._pending_deltas:
3621
 
            compression_parent = key
3622
 
            children = self._pending_deltas.pop(key)
3623
 
            for child_key, parent_keys, record, record_details in children:
3624
 
                lines = self._expand_record(child_key, parent_keys,
3625
 
                                            compression_parent,
3626
 
                                            record, record_details)
3627
 
                if self._check_ready_for_annotations(child_key, parent_keys):
3628
 
                    to_return.append(child_key)
3629
 
        # Also check any children that are waiting for this parent to be
3630
 
        # annotation ready
3631
 
        if key in self._pending_annotation:
3632
 
            children = self._pending_annotation.pop(key)
3633
 
            to_return.extend([c for c, p_keys in children
3634
 
                              if self._check_ready_for_annotations(c, p_keys)])
3635
 
        return to_return
3636
 
 
3637
 
    def _check_ready_for_annotations(self, key, parent_keys):
3638
 
        """return true if this text is ready to be yielded.
3639
 
 
3640
 
        Otherwise, this will return False, and queue the text into
3641
 
        self._pending_annotation
3642
 
        """
3643
 
        for parent_key in parent_keys:
3644
 
            if parent_key not in self._annotations_cache:
3645
 
                # still waiting on at least one parent text, so queue it up
3646
 
                # Note that if there are multiple parents, we need to wait
3647
 
                # for all of them.
3648
 
                self._pending_annotation.setdefault(parent_key,
3649
 
                    []).append((key, parent_keys))
3650
 
                return False
3651
 
        return True
3652
 
 
3653
 
    def _extract_texts(self, records):
3654
 
        """Extract the various texts needed based on records"""
 
3278
        return records
 
3279
 
 
3280
    def _annotate_records(self, records):
 
3281
        """Build the annotations for the listed records."""
3655
3282
        # We iterate in the order read, rather than a strict order requested
3656
3283
        # However, process what we can, and put off to the side things that
3657
3284
        # still need parents, cleaning them up when those parents are
3658
3285
        # processed.
3659
 
        # Basic data flow:
3660
 
        #   1) As 'records' are read, see if we can expand these records into
3661
 
        #      Content objects (and thus lines)
3662
 
        #   2) If a given line-delta is waiting on its compression parent, it
3663
 
        #      gets queued up into self._pending_deltas, otherwise we expand
3664
 
        #      it, and put it into self._text_cache and self._content_objects
3665
 
        #   3) If we expanded the text, we will then check to see if all
3666
 
        #      parents have also been processed. If so, this text gets yielded,
3667
 
        #      else this record gets set aside into pending_annotation
3668
 
        #   4) Further, if we expanded the text in (2), we will then check to
3669
 
        #      see if there are any children in self._pending_deltas waiting to
3670
 
        #      also be processed. If so, we go back to (2) for those
3671
 
        #   5) Further again, if we yielded the text, we can then check if that
3672
 
        #      'unlocks' any of the texts in pending_annotations, which should
3673
 
        #      then get yielded as well
3674
 
        # Note that both steps 4 and 5 are 'recursive' in that unlocking one
3675
 
        # compression child could unlock yet another, and yielding a fulltext
3676
 
        # will also 'unlock' the children that are waiting on that annotation.
3677
 
        # (Though also, unlocking 1 parent's fulltext, does not unlock a child
3678
 
        # if other parents are also waiting.)
3679
 
        # We want to yield content before expanding child content objects, so
3680
 
        # that we know when we can re-use the content lines, and the annotation
3681
 
        # code can know when it can stop caching fulltexts, as well.
3682
 
 
3683
 
        # Children that are missing their compression parent
3684
 
        pending_deltas = {}
3685
 
        for (key, record, digest) in self._vf._read_records_iter(records):
3686
 
            # ghosts?
3687
 
            details = self._all_build_details[key]
3688
 
            (_, compression_parent, parent_keys, record_details) = details
3689
 
            lines = self._expand_record(key, parent_keys, compression_parent,
3690
 
                                        record, record_details)
3691
 
            if lines is None:
3692
 
                # Pending delta should be queued up
 
3286
        for (rev_id, record,
 
3287
             digest) in self._knit._read_records_iter(records):
 
3288
            if rev_id in self._annotated_lines:
3693
3289
                continue
3694
 
            # At this point, we may be able to yield this content, if all
3695
 
            # parents are also finished
3696
 
            yield_this_text = self._check_ready_for_annotations(key,
3697
 
                                                                parent_keys)
3698
 
            if yield_this_text:
3699
 
                # All parents present
3700
 
                yield key, lines, len(lines)
3701
 
            to_process = self._process_pending(key)
3702
 
            while to_process:
3703
 
                this_process = to_process
3704
 
                to_process = []
3705
 
                for key in this_process:
3706
 
                    lines = self._text_cache[key]
3707
 
                    yield key, lines, len(lines)
3708
 
                    to_process.extend(self._process_pending(key))
 
3290
            parent_ids = self._revision_id_graph[rev_id]
 
3291
            parent_ids = [p for p in parent_ids if p not in self._ghosts]
 
3292
            details = self._all_build_details[rev_id]
 
3293
            (index_memo, compression_parent, parents,
 
3294
             record_details) = details
 
3295
            nodes_to_annotate = []
 
3296
            # TODO: Remove the punning between compression parents, and
 
3297
            #       parent_ids, we should be able to do this without assuming
 
3298
            #       the build order
 
3299
            if len(parent_ids) == 0:
 
3300
                # There are no parents for this node, so just add it
 
3301
                # TODO: This probably needs to be decoupled
 
3302
                fulltext_content, delta = self._knit._factory.parse_record(
 
3303
                    rev_id, record, record_details, None)
 
3304
                fulltext = self._add_fulltext_content(rev_id, fulltext_content)
 
3305
                nodes_to_annotate.extend(self._add_annotation(rev_id, fulltext,
 
3306
                    parent_ids, left_matching_blocks=None))
 
3307
            else:
 
3308
                child = (rev_id, parent_ids, record)
 
3309
                # Check if all the parents are present
 
3310
                self._check_parents(child, nodes_to_annotate)
 
3311
            while nodes_to_annotate:
 
3312
                # Should we use a queue here instead of a stack?
 
3313
                (rev_id, parent_ids, record) = nodes_to_annotate.pop()
 
3314
                (index_memo, compression_parent, parents,
 
3315
                 record_details) = self._all_build_details[rev_id]
 
3316
                blocks = None
 
3317
                if compression_parent is not None:
 
3318
                    comp_children = self._compression_children[compression_parent]
 
3319
                    if rev_id not in comp_children:
 
3320
                        raise AssertionError("%r not in compression children %r"
 
3321
                            % (rev_id, comp_children))
 
3322
                    # If there is only 1 child, it is safe to reuse this
 
3323
                    # content
 
3324
                    reuse_content = (len(comp_children) == 1
 
3325
                        and compression_parent not in
 
3326
                            self._nodes_to_keep_annotations)
 
3327
                    if reuse_content:
 
3328
                        # Remove it from the cache since it will be changing
 
3329
                        parent_fulltext_content = self._fulltext_contents.pop(compression_parent)
 
3330
                        # Make sure to copy the fulltext since it might be
 
3331
                        # modified
 
3332
                        parent_fulltext = list(parent_fulltext_content.text())
 
3333
                    else:
 
3334
                        parent_fulltext_content = self._fulltext_contents[compression_parent]
 
3335
                        parent_fulltext = parent_fulltext_content.text()
 
3336
                    comp_children.remove(rev_id)
 
3337
                    fulltext_content, delta = self._knit._factory.parse_record(
 
3338
                        rev_id, record, record_details,
 
3339
                        parent_fulltext_content,
 
3340
                        copy_base_content=(not reuse_content))
 
3341
                    fulltext = self._add_fulltext_content(rev_id,
 
3342
                                                          fulltext_content)
 
3343
                    if compression_parent == parent_ids[0]:
 
3344
                        # the compression_parent is the left parent, so we can
 
3345
                        # re-use the delta
 
3346
                        blocks = KnitContent.get_line_delta_blocks(delta,
 
3347
                                parent_fulltext, fulltext)
 
3348
                else:
 
3349
                    fulltext_content = self._knit._factory.parse_fulltext(
 
3350
                        record, rev_id)
 
3351
                    fulltext = self._add_fulltext_content(rev_id,
 
3352
                        fulltext_content)
 
3353
                nodes_to_annotate.extend(
 
3354
                    self._add_annotation(rev_id, fulltext, parent_ids,
 
3355
                                     left_matching_blocks=blocks))
 
3356
 
 
3357
    def _get_heads_provider(self):
 
3358
        """Create a heads provider for resolving ancestry issues."""
 
3359
        if self._heads_provider is not None:
 
3360
            return self._heads_provider
 
3361
        parent_provider = _mod_graph.DictParentsProvider(
 
3362
            self._revision_id_graph)
 
3363
        graph_obj = _mod_graph.Graph(parent_provider)
 
3364
        head_cache = _mod_graph.FrozenHeadsCache(graph_obj)
 
3365
        self._heads_provider = head_cache
 
3366
        return head_cache
 
3367
 
 
3368
    def annotate(self, key):
 
3369
        """Return the annotated fulltext at the given key.
 
3370
 
 
3371
        :param key: The key to annotate.
 
3372
        """
 
3373
        if len(self._knit._fallback_vfs) > 0:
 
3374
            # stacked knits can't use the fast path at present.
 
3375
            return self._simple_annotate(key)
 
3376
        while True:
 
3377
            try:
 
3378
                records = self._get_build_graph(key)
 
3379
                if key in self._ghosts:
 
3380
                    raise errors.RevisionNotPresent(key, self._knit)
 
3381
                self._annotate_records(records)
 
3382
                return self._annotated_lines[key]
 
3383
            except errors.RetryWithNewPacks, e:
 
3384
                self._knit._access.reload_or_raise(e)
 
3385
                # The cached build_details are no longer valid
 
3386
                self._all_build_details.clear()
 
3387
 
 
3388
    def _simple_annotate(self, key):
 
3389
        """Return annotated fulltext, rediffing from the full texts.
 
3390
 
 
3391
        This is slow but makes no assumptions about the repository
 
3392
        being able to produce line deltas.
 
3393
        """
 
3394
        # TODO: this code generates a parent maps of present ancestors; it
 
3395
        # could be split out into a separate method, and probably should use
 
3396
        # iter_ancestry instead. -- mbp and robertc 20080704
 
3397
        graph = _mod_graph.Graph(self._knit)
 
3398
        head_cache = _mod_graph.FrozenHeadsCache(graph)
 
3399
        search = graph._make_breadth_first_searcher([key])
 
3400
        keys = set()
 
3401
        while True:
 
3402
            try:
 
3403
                present, ghosts = search.next_with_ghosts()
 
3404
            except StopIteration:
 
3405
                break
 
3406
            keys.update(present)
 
3407
        parent_map = self._knit.get_parent_map(keys)
 
3408
        parent_cache = {}
 
3409
        reannotate = annotate.reannotate
 
3410
        for record in self._knit.get_record_stream(keys, 'topological', True):
 
3411
            key = record.key
 
3412
            fulltext = osutils.chunks_to_lines(record.get_bytes_as('chunked'))
 
3413
            parents = parent_map[key]
 
3414
            if parents is not None:
 
3415
                parent_lines = [parent_cache[parent] for parent in parent_map[key]]
 
3416
            else:
 
3417
                parent_lines = []
 
3418
            parent_cache[key] = list(
 
3419
                reannotate(parent_lines, fulltext, key, None, head_cache))
 
3420
        try:
 
3421
            return parent_cache[key]
 
3422
        except KeyError, e:
 
3423
            raise errors.RevisionNotPresent(key, self._knit)
 
3424
 
3709
3425
 
3710
3426
try:
3711
 
    from bzrlib._knit_load_data_pyx import _load_data_c as _load_data
3712
 
except ImportError, e:
3713
 
    osutils.failed_to_load_extension(e)
 
3427
    from bzrlib._knit_load_data_c import _load_data_c as _load_data
 
3428
except ImportError:
3714
3429
    from bzrlib._knit_load_data_py import _load_data_py as _load_data