~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/chk_map.py

  • Committer: Samuel Bronson
  • Date: 2009-07-14 02:15:03 UTC
  • mto: (4547.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 4548.
  • Revision ID: naesten@gmail.com-20090714021503-t8g55xpm2tp53fhs
Clarify comment about bzrlib.foreign.VcsMapping's variable revid_prefix.

Remove the oxymoron "native foreign revisions".

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2008, 2009, 2010 Canonical Ltd
 
1
# Copyright (C) 2008, 2009 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
26
26
 
27
27
Updates to a CHKMap are done preferentially via the apply_delta method, to
28
28
allow optimisation of the update operation; but individual map/unmap calls are
29
 
possible and supported. Individual changes via map/unmap are buffered in memory
30
 
until the _save method is called to force serialisation of the tree.
31
 
apply_delta records its changes immediately by performing an implicit _save.
 
29
possible and supported. All changes via map/unmap are buffered in memory until
 
30
the _save method is called to force serialisation of the tree. apply_delta
 
31
performs a _save implicitly.
32
32
 
33
33
TODO:
34
34
-----
38
38
"""
39
39
 
40
40
import heapq
41
 
import threading
42
41
 
43
42
from bzrlib import lazy_import
44
43
lazy_import.lazy_import(globals(), """
45
 
from bzrlib import (
46
 
    errors,
47
 
    versionedfile,
48
 
    )
 
44
from bzrlib import versionedfile
49
45
""")
50
46
from bzrlib import (
51
47
    lru_cache,
52
48
    osutils,
53
49
    registry,
54
 
    static_tuple,
55
50
    trace,
56
51
    )
57
 
from bzrlib.static_tuple import StaticTuple
58
52
 
59
53
# approx 4MB
60
54
# If each line is 50 bytes, and you have 255 internal pages, with 255-way fan
61
55
# out, it takes 3.1MB to cache the layer.
62
56
_PAGE_CACHE_SIZE = 4*1024*1024
63
 
# Per thread caches for 2 reasons:
64
 
# - in the server we may be serving very different content, so we get less
65
 
#   cache thrashing.
66
 
# - we avoid locking on every cache lookup.
67
 
_thread_caches = threading.local()
68
 
# The page cache.
69
 
_thread_caches.page_cache = None
70
 
 
71
 
def _get_cache():
72
 
    """Get the per-thread page cache.
73
 
 
74
 
    We need a function to do this because in a new thread the _thread_caches
75
 
    threading.local object does not have the cache initialized yet.
76
 
    """
77
 
    page_cache = getattr(_thread_caches, 'page_cache', None)
78
 
    if page_cache is None:
79
 
        # We are caching bytes so len(value) is perfectly accurate
80
 
        page_cache = lru_cache.LRUSizeCache(_PAGE_CACHE_SIZE)
81
 
        _thread_caches.page_cache = page_cache
82
 
    return page_cache
83
 
 
84
 
 
85
 
def clear_cache():
86
 
    _get_cache().clear()
87
 
 
 
57
# We are caching bytes so len(value) is perfectly accurate
 
58
_page_cache = lru_cache.LRUSizeCache(_PAGE_CACHE_SIZE)
88
59
 
89
60
# If a ChildNode falls below this many bytes, we check for a remap
90
61
_INTERESTING_NEW_SIZE = 50
106
77
class CHKMap(object):
107
78
    """A persistent map from string to string backed by a CHK store."""
108
79
 
109
 
    __slots__ = ('_store', '_root_node', '_search_key_func')
110
 
 
111
80
    def __init__(self, store, root_key, search_key_func=None):
112
81
        """Create a CHKMap object.
113
82
 
136
105
            of old_key is removed.
137
106
        """
138
107
        delete_count = 0
139
 
        # Check preconditions first.
140
 
        as_st = StaticTuple.from_sequence
141
 
        new_items = set([as_st(key) for (old, key, value) in delta
142
 
                         if key is not None and old is None])
143
 
        existing_new = list(self.iteritems(key_filter=new_items))
144
 
        if existing_new:
145
 
            raise errors.InconsistentDeltaDelta(delta,
146
 
                "New items are already in the map %r." % existing_new)
147
 
        # Now apply changes.
148
108
        for old, new, value in delta:
149
109
            if old is not None and old != new:
150
110
                self.unmap(old, check_remap=False)
159
119
 
160
120
    def _ensure_root(self):
161
121
        """Ensure that the root node is an object not a key."""
162
 
        if type(self._root_node) is StaticTuple:
 
122
        if type(self._root_node) is tuple:
163
123
            # Demand-load the root
164
124
            self._root_node = self._get_node(self._root_node)
165
125
 
173
133
        :param node: A tuple key or node object.
174
134
        :return: A node object.
175
135
        """
176
 
        if type(node) is StaticTuple:
 
136
        if type(node) is tuple:
177
137
            bytes = self._read_bytes(node)
178
138
            return _deserialise(bytes, node,
179
139
                search_key_func=self._search_key_func)
182
142
 
183
143
    def _read_bytes(self, key):
184
144
        try:
185
 
            return _get_cache()[key]
 
145
            return _page_cache[key]
186
146
        except KeyError:
187
147
            stream = self._store.get_record_stream([key], 'unordered', True)
188
148
            bytes = stream.next().get_bytes_as('fulltext')
189
 
            _get_cache()[key] = bytes
 
149
            _page_cache[key] = bytes
190
150
            return bytes
191
151
 
192
152
    def _dump_tree(self, include_keys=False):
220
180
            for key, value in sorted(node._items.iteritems()):
221
181
                # Don't use prefix nor indent here to line up when used in
222
182
                # tests in conjunction with assertEqualDiff
223
 
                result.append('      %r %r' % (tuple(key), value))
 
183
                result.append('      %r %r' % (key, value))
224
184
        return result
225
185
 
226
186
    @classmethod
244
204
        root_key = klass._create_directly(store, initial_value,
245
205
            maximum_size=maximum_size, key_width=key_width,
246
206
            search_key_func=search_key_func)
247
 
        if type(root_key) is not StaticTuple:
248
 
            raise AssertionError('we got a %s instead of a StaticTuple'
249
 
                                 % (type(root_key),))
250
207
        return root_key
251
208
 
252
209
    @classmethod
267
224
        node = LeafNode(search_key_func=search_key_func)
268
225
        node.set_maximum_size(maximum_size)
269
226
        node._key_width = key_width
270
 
        as_st = StaticTuple.from_sequence
271
 
        node._items = dict([(as_st(key), val) for key, val
272
 
                                               in initial_value.iteritems()])
 
227
        node._items = dict(initial_value)
273
228
        node._raw_size = sum([node._key_value_len(key, value)
274
 
                              for key,value in node._items.iteritems()])
 
229
                              for key,value in initial_value.iteritems()])
275
230
        node._len = len(node._items)
276
231
        node._compute_search_prefix()
277
232
        node._compute_serialised_prefix()
513
468
    def iteritems(self, key_filter=None):
514
469
        """Iterate over the entire CHKMap's contents."""
515
470
        self._ensure_root()
516
 
        if key_filter is not None:
517
 
            as_st = StaticTuple.from_sequence
518
 
            key_filter = [as_st(key) for key in key_filter]
519
471
        return self._root_node.iteritems(self._store, key_filter=key_filter)
520
472
 
521
473
    def key(self):
522
474
        """Return the key for this map."""
523
 
        if type(self._root_node) is StaticTuple:
 
475
        if type(self._root_node) is tuple:
524
476
            return self._root_node
525
477
        else:
526
478
            return self._root_node._key
530
482
        return len(self._root_node)
531
483
 
532
484
    def map(self, key, value):
533
 
        """Map a key tuple to value.
534
 
        
535
 
        :param key: A key to map.
536
 
        :param value: The value to assign to key.
537
 
        """
538
 
        key = StaticTuple.from_sequence(key)
 
485
        """Map a key tuple to value."""
539
486
        # Need a root object.
540
487
        self._ensure_root()
541
488
        prefix, node_details = self._root_node.map(self._store, key, value)
552
499
    def _node_key(self, node):
553
500
        """Get the key for a node whether it's a tuple or node."""
554
501
        if type(node) is tuple:
555
 
            node = StaticTuple.from_sequence(node)
556
 
        if type(node) is StaticTuple:
557
502
            return node
558
503
        else:
559
504
            return node._key
560
505
 
561
506
    def unmap(self, key, check_remap=True):
562
507
        """remove key from the map."""
563
 
        key = StaticTuple.from_sequence(key)
564
508
        self._ensure_root()
565
509
        if type(self._root_node) is InternalNode:
566
510
            unmapped = self._root_node.unmap(self._store, key,
580
524
 
581
525
        :return: The key of the root node.
582
526
        """
583
 
        if type(self._root_node) is StaticTuple:
 
527
        if type(self._root_node) is tuple:
584
528
            # Already saved.
585
529
            return self._root_node
586
530
        keys = list(self._root_node.serialise(self._store))
594
538
        adding the header bytes, and without prefix compression.
595
539
    """
596
540
 
597
 
    __slots__ = ('_key', '_len', '_maximum_size', '_key_width',
598
 
                 '_raw_size', '_items', '_search_prefix', '_search_key_func'
599
 
                )
600
 
 
601
541
    def __init__(self, key_width=1):
602
542
        """Create a node.
603
543
 
692
632
        the key/value pairs.
693
633
    """
694
634
 
695
 
    __slots__ = ('_common_serialised_prefix',)
696
 
 
697
635
    def __init__(self, search_key_func=None):
698
636
        Node.__init__(self)
699
637
        # All of the keys in this leaf node share this common prefix
700
638
        self._common_serialised_prefix = None
 
639
        self._serialise_key = '\x00'.join
701
640
        if search_key_func is None:
702
641
            self._search_key_func = _search_key_plain
703
642
        else:
741
680
        :param bytes: The bytes of the node.
742
681
        :param key: The key that the serialised node has.
743
682
        """
744
 
        key = static_tuple.expect_static_tuple(key)
745
683
        return _deserialise_leaf_node(bytes, key,
746
684
                                      search_key_func=search_key_func)
747
685
 
887
825
                raise AssertionError('%r must be known' % self._search_prefix)
888
826
            return self._search_prefix, [("", self)]
889
827
 
890
 
    _serialise_key = '\x00'.join
891
 
 
892
828
    def serialise(self, store):
893
829
        """Serialise the LeafNode to store.
894
830
 
919
855
            lines.append(serialized[prefix_len:])
920
856
            lines.extend(value_lines)
921
857
        sha1, _, _ = store.add_lines((None,), (), lines)
922
 
        self._key = StaticTuple("sha1:" + sha1,).intern()
 
858
        self._key = ("sha1:" + sha1,)
923
859
        bytes = ''.join(lines)
924
860
        if len(bytes) != self._current_size():
925
861
            raise AssertionError('Invalid _current_size')
926
 
        _get_cache().add(self._key, bytes)
 
862
        _page_cache.add(self._key, bytes)
927
863
        return [self._key]
928
864
 
929
865
    def refs(self):
993
929
        LeafNode or InternalNode.
994
930
    """
995
931
 
996
 
    __slots__ = ('_node_width',)
997
 
 
998
932
    def __init__(self, prefix='', search_key_func=None):
999
933
        Node.__init__(self)
1000
934
        # The size of an internalnode with default values and no children.
1042
976
        :param key: The key that the serialised node has.
1043
977
        :return: An InternalNode instance.
1044
978
        """
1045
 
        key = static_tuple.expect_static_tuple(key)
1046
979
        return _deserialise_internal_node(bytes, key,
1047
980
                                          search_key_func=search_key_func)
1048
981
 
1073
1006
            # for whatever we are missing
1074
1007
            shortcut = True
1075
1008
            for prefix, node in self._items.iteritems():
1076
 
                if node.__class__ is StaticTuple:
 
1009
                if node.__class__ is tuple:
1077
1010
                    keys[node] = (prefix, None)
1078
1011
                else:
1079
1012
                    yield node, None
1108
1041
                    # A given key can only match 1 child node, if it isn't
1109
1042
                    # there, then we can just return nothing
1110
1043
                    return
1111
 
                if node.__class__ is StaticTuple:
 
1044
                if node.__class__ is tuple:
1112
1045
                    keys[node] = (search_prefix, [key])
1113
1046
                else:
1114
1047
                    # This is loaded, and the only thing that can match,
1141
1074
                        # We can ignore this one
1142
1075
                        continue
1143
1076
                    node_key_filter = prefix_to_keys[search_prefix]
1144
 
                    if node.__class__ is StaticTuple:
 
1077
                    if node.__class__ is tuple:
1145
1078
                        keys[node] = (search_prefix, node_key_filter)
1146
1079
                    else:
1147
1080
                        yield node, node_key_filter
1156
1089
                        if sub_prefix in length_filter:
1157
1090
                            node_key_filter.extend(prefix_to_keys[sub_prefix])
1158
1091
                    if node_key_filter: # this key matched something, yield it
1159
 
                        if node.__class__ is StaticTuple:
 
1092
                        if node.__class__ is tuple:
1160
1093
                            keys[node] = (prefix, node_key_filter)
1161
1094
                        else:
1162
1095
                            yield node, node_key_filter
1165
1098
            found_keys = set()
1166
1099
            for key in keys:
1167
1100
                try:
1168
 
                    bytes = _get_cache()[key]
 
1101
                    bytes = _page_cache[key]
1169
1102
                except KeyError:
1170
1103
                    continue
1171
1104
                else:
1196
1129
                    prefix, node_key_filter = keys[record.key]
1197
1130
                    node_and_filters.append((node, node_key_filter))
1198
1131
                    self._items[prefix] = node
1199
 
                    _get_cache().add(record.key, bytes)
 
1132
                    _page_cache.add(record.key, bytes)
1200
1133
                for info in node_and_filters:
1201
1134
                    yield info
1202
1135
 
1294
1227
        :return: An iterable of the keys inserted by this operation.
1295
1228
        """
1296
1229
        for node in self._items.itervalues():
1297
 
            if type(node) is StaticTuple:
 
1230
            if type(node) is tuple:
1298
1231
                # Never deserialised.
1299
1232
                continue
1300
1233
            if node._key is not None:
1311
1244
        lines.append('%s\n' % (self._search_prefix,))
1312
1245
        prefix_len = len(self._search_prefix)
1313
1246
        for prefix, node in sorted(self._items.items()):
1314
 
            if type(node) is StaticTuple:
 
1247
            if type(node) is tuple:
1315
1248
                key = node[0]
1316
1249
            else:
1317
1250
                key = node._key[0]
1321
1254
                    % (serialised, self._search_prefix))
1322
1255
            lines.append(serialised[prefix_len:])
1323
1256
        sha1, _, _ = store.add_lines((None,), (), lines)
1324
 
        self._key = StaticTuple("sha1:" + sha1,).intern()
1325
 
        _get_cache().add(self._key, ''.join(lines))
 
1257
        self._key = ("sha1:" + sha1,)
 
1258
        _page_cache.add(self._key, ''.join(lines))
1326
1259
        yield self._key
1327
1260
 
1328
1261
    def _search_key(self, key):
1356
1289
            raise AssertionError("unserialised nodes have no refs.")
1357
1290
        refs = []
1358
1291
        for value in self._items.itervalues():
1359
 
            if type(value) is StaticTuple:
 
1292
            if type(value) is tuple:
1360
1293
                refs.append(value)
1361
1294
            else:
1362
1295
                refs.append(value.key())
1463
1396
    return node
1464
1397
 
1465
1398
 
1466
 
class CHKMapDifference(object):
1467
 
    """Iterate the stored pages and key,value pairs for (new - old).
1468
 
 
1469
 
    This class provides a generator over the stored CHK pages and the
1470
 
    (key, value) pairs that are in any of the new maps and not in any of the
1471
 
    old maps.
1472
 
 
1473
 
    Note that it may yield chk pages that are common (especially root nodes),
1474
 
    but it won't yield (key,value) pairs that are common.
1475
 
    """
1476
 
 
1477
 
    def __init__(self, store, new_root_keys, old_root_keys,
1478
 
                 search_key_func, pb=None):
1479
 
        # TODO: Should we add a StaticTuple barrier here? It would be nice to
1480
 
        #       force callers to use StaticTuple, because there will often be
1481
 
        #       lots of keys passed in here. And even if we cast it locally,
1482
 
        #       that just meanst that we will have *both* a StaticTuple and a
1483
 
        #       tuple() in memory, referring to the same object. (so a net
1484
 
        #       increase in memory, not a decrease.)
1485
 
        self._store = store
1486
 
        self._new_root_keys = new_root_keys
1487
 
        self._old_root_keys = old_root_keys
1488
 
        self._pb = pb
1489
 
        # All uninteresting chks that we have seen. By the time they are added
1490
 
        # here, they should be either fully ignored, or queued up for
1491
 
        # processing
1492
 
        # TODO: This might grow to a large size if there are lots of merge
1493
 
        #       parents, etc. However, it probably doesn't scale to O(history)
1494
 
        #       like _processed_new_refs does.
1495
 
        self._all_old_chks = set(self._old_root_keys)
1496
 
        # All items that we have seen from the old_root_keys
1497
 
        self._all_old_items = set()
1498
 
        # These are interesting items which were either read, or already in the
1499
 
        # interesting queue (so we don't need to walk them again)
1500
 
        # TODO: processed_new_refs becomes O(all_chks), consider switching to
1501
 
        #       SimpleSet here.
1502
 
        self._processed_new_refs = set()
1503
 
        self._search_key_func = search_key_func
1504
 
 
1505
 
        # The uninteresting and interesting nodes to be searched
1506
 
        self._old_queue = []
1507
 
        self._new_queue = []
1508
 
        # Holds the (key, value) items found when processing the root nodes,
1509
 
        # waiting for the uninteresting nodes to be walked
1510
 
        self._new_item_queue = []
1511
 
        self._state = None
1512
 
 
1513
 
    def _read_nodes_from_store(self, keys):
1514
 
        # We chose not to use _get_cache(), because we think in
1515
 
        # terms of records to be yielded. Also, we expect to touch each page
1516
 
        # only 1 time during this code. (We may want to evaluate saving the
1517
 
        # raw bytes into the page cache, which would allow a working tree
1518
 
        # update after the fetch to not have to read the bytes again.)
1519
 
        as_st = StaticTuple.from_sequence
1520
 
        stream = self._store.get_record_stream(keys, 'unordered', True)
1521
 
        for record in stream:
1522
 
            if self._pb is not None:
1523
 
                self._pb.tick()
1524
 
            if record.storage_kind == 'absent':
1525
 
                raise errors.NoSuchRevision(self._store, record.key)
 
1399
def _find_children_info(store, interesting_keys, uninteresting_keys, pb):
 
1400
    """Read the associated records, and determine what is interesting."""
 
1401
    uninteresting_keys = set(uninteresting_keys)
 
1402
    chks_to_read = uninteresting_keys.union(interesting_keys)
 
1403
    next_uninteresting = set()
 
1404
    next_interesting = set()
 
1405
    next_interesting_intersection = None
 
1406
    uninteresting_items = set()
 
1407
    interesting_items = set()
 
1408
    interesting_to_yield = []
 
1409
    for record in store.get_record_stream(chks_to_read, 'unordered', True):
 
1410
        # records_read.add(record.key())
 
1411
        if pb is not None:
 
1412
            pb.tick()
 
1413
        bytes = record.get_bytes_as('fulltext')
 
1414
        # We don't care about search_key_func for this code, because we only
 
1415
        # care about external references.
 
1416
        node = _deserialise(bytes, record.key, search_key_func=None)
 
1417
        if record.key in uninteresting_keys:
 
1418
            if type(node) is InternalNode:
 
1419
                next_uninteresting.update(node.refs())
 
1420
            else:
 
1421
                # We know we are at a LeafNode, so we can pass None for the
 
1422
                # store
 
1423
                uninteresting_items.update(node.iteritems(None))
 
1424
        else:
 
1425
            interesting_to_yield.append(record.key)
 
1426
            if type(node) is InternalNode:
 
1427
                if next_interesting_intersection is None:
 
1428
                    next_interesting_intersection = set(node.refs())
 
1429
                else:
 
1430
                    next_interesting_intersection = \
 
1431
                        next_interesting_intersection.intersection(node.refs())
 
1432
                next_interesting.update(node.refs())
 
1433
            else:
 
1434
                interesting_items.update(node.iteritems(None))
 
1435
    return (next_uninteresting, uninteresting_items,
 
1436
            next_interesting, interesting_to_yield, interesting_items,
 
1437
            next_interesting_intersection)
 
1438
 
 
1439
 
 
1440
def _find_all_uninteresting(store, interesting_root_keys,
 
1441
                            uninteresting_root_keys, pb):
 
1442
    """Determine the full set of uninteresting keys."""
 
1443
    # What about duplicates between interesting_root_keys and
 
1444
    # uninteresting_root_keys?
 
1445
    if not uninteresting_root_keys:
 
1446
        # Shortcut case. We know there is nothing uninteresting to filter out
 
1447
        # So we just let the rest of the algorithm do the work
 
1448
        # We know there is nothing uninteresting, and we didn't have to read
 
1449
        # any interesting records yet.
 
1450
        return (set(), set(), set(interesting_root_keys), [], set())
 
1451
    all_uninteresting_chks = set(uninteresting_root_keys)
 
1452
    all_uninteresting_items = set()
 
1453
 
 
1454
    # First step, find the direct children of both the interesting and
 
1455
    # uninteresting set
 
1456
    (uninteresting_keys, uninteresting_items,
 
1457
     interesting_keys, interesting_to_yield,
 
1458
     interesting_items, interesting_intersection,
 
1459
     ) = _find_children_info(store, interesting_root_keys,
 
1460
                                              uninteresting_root_keys,
 
1461
                                              pb=pb)
 
1462
    all_uninteresting_chks.update(uninteresting_keys)
 
1463
    all_uninteresting_items.update(uninteresting_items)
 
1464
    del uninteresting_items
 
1465
    # Do not examine in detail pages common to all interesting trees.
 
1466
    # Pages that are common to all interesting trees will have their
 
1467
    # older versions found via the uninteresting tree traversal. Some pages
 
1468
    # found via the interesting trees traversal will be uninteresting for
 
1469
    # other of the interesting trees, which is why we require the pages to be
 
1470
    # common for us to trim them.
 
1471
    if interesting_intersection is not None:
 
1472
        uninteresting_keys.difference_update(interesting_intersection)
 
1473
 
 
1474
    # Second, find the full set of uninteresting bits reachable by the
 
1475
    # uninteresting roots
 
1476
    chks_to_read = uninteresting_keys
 
1477
    while chks_to_read:
 
1478
        next_chks = set()
 
1479
        for record in store.get_record_stream(chks_to_read, 'unordered', False):
 
1480
            # TODO: Handle 'absent'
 
1481
            if pb is not None:
 
1482
                pb.tick()
1526
1483
            bytes = record.get_bytes_as('fulltext')
1527
 
            node = _deserialise(bytes, record.key,
1528
 
                                search_key_func=self._search_key_func)
 
1484
            # We don't care about search_key_func for this code, because we
 
1485
            # only care about external references.
 
1486
            node = _deserialise(bytes, record.key, search_key_func=None)
1529
1487
            if type(node) is InternalNode:
1530
 
                # Note we don't have to do node.refs() because we know that
1531
 
                # there are no children that have been pushed into this node
1532
 
                # Note: Using as_st() here seemed to save 1.2MB, which would
1533
 
                #       indicate that we keep 100k prefix_refs around while
1534
 
                #       processing. They *should* be shorter lived than that...
1535
 
                #       It does cost us ~10s of processing time
1536
 
                #prefix_refs = [as_st(item) for item in node._items.iteritems()]
1537
 
                prefix_refs = node._items.items()
1538
 
                items = []
 
1488
                # uninteresting_prefix_chks.update(node._items.iteritems())
 
1489
                chks = node._items.values()
 
1490
                # TODO: We remove the entries that are already in
 
1491
                #       uninteresting_chks ?
 
1492
                next_chks.update(chks)
 
1493
                all_uninteresting_chks.update(chks)
1539
1494
            else:
1540
 
                prefix_refs = []
1541
 
                # Note: We don't use a StaticTuple here. Profiling showed a
1542
 
                #       minor memory improvement (0.8MB out of 335MB peak 0.2%)
1543
 
                #       But a significant slowdown (15s / 145s, or 10%)
1544
 
                items = node._items.items()
1545
 
            yield record, node, prefix_refs, items
1546
 
 
1547
 
    def _read_old_roots(self):
1548
 
        old_chks_to_enqueue = []
1549
 
        all_old_chks = self._all_old_chks
1550
 
        for record, node, prefix_refs, items in \
1551
 
                self._read_nodes_from_store(self._old_root_keys):
1552
 
            # Uninteresting node
1553
 
            prefix_refs = [p_r for p_r in prefix_refs
1554
 
                                if p_r[1] not in all_old_chks]
1555
 
            new_refs = [p_r[1] for p_r in prefix_refs]
1556
 
            all_old_chks.update(new_refs)
1557
 
            # TODO: This might be a good time to turn items into StaticTuple
1558
 
            #       instances and possibly intern them. However, this does not
1559
 
            #       impact 'initial branch' performance, so I'm not worrying
1560
 
            #       about this yet
1561
 
            self._all_old_items.update(items)
1562
 
            # Queue up the uninteresting references
1563
 
            # Don't actually put them in the 'to-read' queue until we have
1564
 
            # finished checking the interesting references
1565
 
            old_chks_to_enqueue.extend(prefix_refs)
1566
 
        return old_chks_to_enqueue
1567
 
 
1568
 
    def _enqueue_old(self, new_prefixes, old_chks_to_enqueue):
1569
 
        # At this point, we have read all the uninteresting and interesting
1570
 
        # items, so we can queue up the uninteresting stuff, knowing that we've
1571
 
        # handled the interesting ones
1572
 
        for prefix, ref in old_chks_to_enqueue:
1573
 
            not_interesting = True
1574
 
            for i in xrange(len(prefix), 0, -1):
1575
 
                if prefix[:i] in new_prefixes:
1576
 
                    not_interesting = False
1577
 
                    break
1578
 
            if not_interesting:
1579
 
                # This prefix is not part of the remaining 'interesting set'
1580
 
                continue
1581
 
            self._old_queue.append(ref)
1582
 
 
1583
 
    def _read_all_roots(self):
1584
 
        """Read the root pages.
1585
 
 
1586
 
        This is structured as a generator, so that the root records can be
1587
 
        yielded up to whoever needs them without any buffering.
1588
 
        """
1589
 
        # This is the bootstrap phase
1590
 
        if not self._old_root_keys:
1591
 
            # With no old_root_keys we can just shortcut and be ready
1592
 
            # for _flush_new_queue
1593
 
            self._new_queue = list(self._new_root_keys)
1594
 
            return
1595
 
        old_chks_to_enqueue = self._read_old_roots()
1596
 
        # filter out any root keys that are already known to be uninteresting
1597
 
        new_keys = set(self._new_root_keys).difference(self._all_old_chks)
1598
 
        # These are prefixes that are present in new_keys that we are
1599
 
        # thinking to yield
1600
 
        new_prefixes = set()
1601
 
        # We are about to yield all of these, so we don't want them getting
1602
 
        # added a second time
1603
 
        processed_new_refs = self._processed_new_refs
1604
 
        processed_new_refs.update(new_keys)
1605
 
        for record, node, prefix_refs, items in \
1606
 
                self._read_nodes_from_store(new_keys):
1607
 
            # At this level, we now know all the uninteresting references
1608
 
            # So we filter and queue up whatever is remaining
1609
 
            prefix_refs = [p_r for p_r in prefix_refs
1610
 
                           if p_r[1] not in self._all_old_chks
1611
 
                              and p_r[1] not in processed_new_refs]
1612
 
            refs = [p_r[1] for p_r in prefix_refs]
1613
 
            new_prefixes.update([p_r[0] for p_r in prefix_refs])
1614
 
            self._new_queue.extend(refs)
1615
 
            # TODO: We can potentially get multiple items here, however the
1616
 
            #       current design allows for this, as callers will do the work
1617
 
            #       to make the results unique. We might profile whether we
1618
 
            #       gain anything by ensuring unique return values for items
1619
 
            # TODO: This might be a good time to cast to StaticTuple, as
1620
 
            #       self._new_item_queue will hold the contents of multiple
1621
 
            #       records for an extended lifetime
1622
 
            new_items = [item for item in items
1623
 
                               if item not in self._all_old_items]
1624
 
            self._new_item_queue.extend(new_items)
1625
 
            new_prefixes.update([self._search_key_func(item[0])
1626
 
                                 for item in new_items])
1627
 
            processed_new_refs.update(refs)
1628
 
            yield record
1629
 
        # For new_prefixes we have the full length prefixes queued up.
1630
 
        # However, we also need possible prefixes. (If we have a known ref to
1631
 
        # 'ab', then we also need to include 'a'.) So expand the
1632
 
        # new_prefixes to include all shorter prefixes
1633
 
        for prefix in list(new_prefixes):
1634
 
            new_prefixes.update([prefix[:i] for i in xrange(1, len(prefix))])
1635
 
        self._enqueue_old(new_prefixes, old_chks_to_enqueue)
1636
 
 
1637
 
    def _flush_new_queue(self):
1638
 
        # No need to maintain the heap invariant anymore, just pull things out
1639
 
        # and process them
1640
 
        refs = set(self._new_queue)
1641
 
        self._new_queue = []
1642
 
        # First pass, flush all interesting items and convert to using direct refs
1643
 
        all_old_chks = self._all_old_chks
1644
 
        processed_new_refs = self._processed_new_refs
1645
 
        all_old_items = self._all_old_items
1646
 
        new_items = [item for item in self._new_item_queue
1647
 
                           if item not in all_old_items]
1648
 
        self._new_item_queue = []
1649
 
        if new_items:
1650
 
            yield None, new_items
1651
 
        refs = refs.difference(all_old_chks)
1652
 
        processed_new_refs.update(refs)
1653
 
        while refs:
1654
 
            # TODO: Using a SimpleSet for self._processed_new_refs and
1655
 
            #       saved as much as 10MB of peak memory. However, it requires
1656
 
            #       implementing a non-pyrex version.
1657
 
            next_refs = set()
1658
 
            next_refs_update = next_refs.update
1659
 
            # Inlining _read_nodes_from_store improves 'bzr branch bzr.dev'
1660
 
            # from 1m54s to 1m51s. Consider it.
1661
 
            for record, _, p_refs, items in self._read_nodes_from_store(refs):
1662
 
                if all_old_items:
1663
 
                    # using the 'if' check saves about 145s => 141s, when
1664
 
                    # streaming initial branch of Launchpad data.
1665
 
                    items = [item for item in items
1666
 
                             if item not in all_old_items]
1667
 
                yield record, items
1668
 
                next_refs_update([p_r[1] for p_r in p_refs])
1669
 
                del p_refs
1670
 
            # set1.difference(set/dict) walks all of set1, and checks if it
1671
 
            # exists in 'other'.
1672
 
            # set1.difference(iterable) walks all of iterable, and does a
1673
 
            # 'difference_update' on a clone of set1. Pick wisely based on the
1674
 
            # expected sizes of objects.
1675
 
            # in our case it is expected that 'new_refs' will always be quite
1676
 
            # small.
1677
 
            next_refs = next_refs.difference(all_old_chks)
1678
 
            next_refs = next_refs.difference(processed_new_refs)
1679
 
            processed_new_refs.update(next_refs)
1680
 
            refs = next_refs
1681
 
 
1682
 
    def _process_next_old(self):
1683
 
        # Since we don't filter uninteresting any further than during
1684
 
        # _read_all_roots, process the whole queue in a single pass.
1685
 
        refs = self._old_queue
1686
 
        self._old_queue = []
1687
 
        all_old_chks = self._all_old_chks
1688
 
        for record, _, prefix_refs, items in self._read_nodes_from_store(refs):
1689
 
            # TODO: Use StaticTuple here?
1690
 
            self._all_old_items.update(items)
1691
 
            refs = [r for _,r in prefix_refs if r not in all_old_chks]
1692
 
            self._old_queue.extend(refs)
1693
 
            all_old_chks.update(refs)
1694
 
 
1695
 
    def _process_queues(self):
1696
 
        while self._old_queue:
1697
 
            self._process_next_old()
1698
 
        return self._flush_new_queue()
1699
 
 
1700
 
    def process(self):
1701
 
        for record in self._read_all_roots():
1702
 
            yield record, []
1703
 
        for record, items in self._process_queues():
1704
 
            yield record, items
 
1495
                all_uninteresting_items.update(node._items.iteritems())
 
1496
        chks_to_read = next_chks
 
1497
    return (all_uninteresting_chks, all_uninteresting_items,
 
1498
            interesting_keys, interesting_to_yield, interesting_items)
1705
1499
 
1706
1500
 
1707
1501
def iter_interesting_nodes(store, interesting_root_keys,
1718
1512
    :return: Yield
1719
1513
        (interesting record, {interesting key:values})
1720
1514
    """
1721
 
    iterator = CHKMapDifference(store, interesting_root_keys,
1722
 
                                uninteresting_root_keys,
1723
 
                                search_key_func=store._search_key_func,
1724
 
                                pb=pb)
1725
 
    return iterator.process()
 
1515
    # TODO: consider that it may be more memory efficient to use the 20-byte
 
1516
    #       sha1 string, rather than tuples of hexidecimal sha1 strings.
 
1517
    # TODO: Try to factor out a lot of the get_record_stream() calls into a
 
1518
    #       helper function similar to _read_bytes. This function should be
 
1519
    #       able to use nodes from the _page_cache as well as actually
 
1520
    #       requesting bytes from the store.
 
1521
 
 
1522
    (all_uninteresting_chks, all_uninteresting_items, interesting_keys,
 
1523
     interesting_to_yield, interesting_items) = _find_all_uninteresting(store,
 
1524
        interesting_root_keys, uninteresting_root_keys, pb)
 
1525
 
 
1526
    # Now that we know everything uninteresting, we can yield information from
 
1527
    # our first request
 
1528
    interesting_items.difference_update(all_uninteresting_items)
 
1529
    interesting_to_yield = set(interesting_to_yield) - all_uninteresting_chks
 
1530
    if interesting_items:
 
1531
        yield None, interesting_items
 
1532
    if interesting_to_yield:
 
1533
        # We request these records again, rather than buffering the root
 
1534
        # records, most likely they are still in the _group_cache anyway.
 
1535
        for record in store.get_record_stream(interesting_to_yield,
 
1536
                                              'unordered', False):
 
1537
            yield record, []
 
1538
    all_uninteresting_chks.update(interesting_to_yield)
 
1539
    interesting_keys.difference_update(all_uninteresting_chks)
 
1540
 
 
1541
    chks_to_read = interesting_keys
 
1542
    counter = 0
 
1543
    while chks_to_read:
 
1544
        next_chks = set()
 
1545
        for record in store.get_record_stream(chks_to_read, 'unordered', False):
 
1546
            counter += 1
 
1547
            if pb is not None:
 
1548
                pb.update('find chk pages', counter)
 
1549
            # TODO: Handle 'absent'?
 
1550
            bytes = record.get_bytes_as('fulltext')
 
1551
            # We don't care about search_key_func for this code, because we
 
1552
            # only care about external references.
 
1553
            node = _deserialise(bytes, record.key, search_key_func=None)
 
1554
            if type(node) is InternalNode:
 
1555
                # all_uninteresting_chks grows large, as it lists all nodes we
 
1556
                # don't want to process (including already seen interesting
 
1557
                # nodes).
 
1558
                # small.difference_update(large) scales O(large), but
 
1559
                # small.difference(large) scales O(small).
 
1560
                # Also, we know we just _deserialised this node, so we can
 
1561
                # access the dict directly.
 
1562
                chks = set(node._items.itervalues()).difference(
 
1563
                            all_uninteresting_chks)
 
1564
                # Is set() and .difference_update better than:
 
1565
                # chks = [chk for chk in node.refs()
 
1566
                #              if chk not in all_uninteresting_chks]
 
1567
                next_chks.update(chks)
 
1568
                # These are now uninteresting everywhere else
 
1569
                all_uninteresting_chks.update(chks)
 
1570
                interesting_items = []
 
1571
            else:
 
1572
                interesting_items = [item for item in node._items.iteritems()
 
1573
                                     if item not in all_uninteresting_items]
 
1574
                # TODO: Do we need to filter out items that we have already
 
1575
                #       seen on other pages? We don't really want to buffer the
 
1576
                #       whole thing, but it does mean that callers need to
 
1577
                #       understand they may get duplicate values.
 
1578
                # all_uninteresting_items.update(interesting_items)
 
1579
            yield record, interesting_items
 
1580
        chks_to_read = next_chks
1726
1581
 
1727
1582
 
1728
1583
try:
1732
1587
        _deserialise_leaf_node,
1733
1588
        _deserialise_internal_node,
1734
1589
        )
1735
 
except ImportError, e:
1736
 
    osutils.failed_to_load_extension(e)
 
1590
except ImportError:
1737
1591
    from bzrlib._chk_map_py import (
1738
1592
        _search_key_16,
1739
1593
        _search_key_255,
1742
1596
        )
1743
1597
search_key_registry.register('hash-16-way', _search_key_16)
1744
1598
search_key_registry.register('hash-255-way', _search_key_255)
1745
 
 
1746
 
 
1747
 
def _check_key(key):
1748
 
    """Helper function to assert that a key is properly formatted.
1749
 
 
1750
 
    This generally shouldn't be used in production code, but it can be helpful
1751
 
    to debug problems.
1752
 
    """
1753
 
    if type(key) is not StaticTuple:
1754
 
        raise TypeError('key %r is not StaticTuple but %s' % (key, type(key)))
1755
 
    if len(key) != 1:
1756
 
        raise ValueError('key %r should have length 1, not %d' % (key, len(key),))
1757
 
    if type(key[0]) is not str:
1758
 
        raise TypeError('key %r should hold a str, not %r'
1759
 
                        % (key, type(key[0])))
1760
 
    if not key[0].startswith('sha1:'):
1761
 
        raise ValueError('key %r should point to a sha1:' % (key,))
1762
 
 
1763