/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/chk_map.py

  • Committer: Jonathan Lange
  • Date: 2009-12-09 09:20:42 UTC
  • mfrom: (4881 +trunk)
  • mto: This revision was merged to the branch mainline in revision 4907.
  • Revision ID: jml@canonical.com-20091209092042-s2zgqcf8f39yzxpj
Merge trunk.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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. 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.
 
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.
32
32
 
33
33
TODO:
34
34
-----
41
41
 
42
42
from bzrlib import lazy_import
43
43
lazy_import.lazy_import(globals(), """
44
 
from bzrlib import versionedfile
 
44
from bzrlib import (
 
45
    errors,
 
46
    versionedfile,
 
47
    )
45
48
""")
46
49
from bzrlib import (
47
50
    lru_cache,
48
51
    osutils,
49
52
    registry,
 
53
    static_tuple,
50
54
    trace,
51
55
    )
 
56
from bzrlib.static_tuple import StaticTuple
52
57
 
53
58
# approx 4MB
54
59
# If each line is 50 bytes, and you have 255 internal pages, with 255-way fan
57
62
# We are caching bytes so len(value) is perfectly accurate
58
63
_page_cache = lru_cache.LRUSizeCache(_PAGE_CACHE_SIZE)
59
64
 
 
65
def clear_cache():
 
66
    _page_cache.clear()
 
67
 
60
68
# If a ChildNode falls below this many bytes, we check for a remap
61
69
_INTERESTING_NEW_SIZE = 50
62
70
# If a ChildNode shrinks by more than this amount, we check for a remap
77
85
class CHKMap(object):
78
86
    """A persistent map from string to string backed by a CHK store."""
79
87
 
 
88
    __slots__ = ('_store', '_root_node', '_search_key_func')
 
89
 
80
90
    def __init__(self, store, root_key, search_key_func=None):
81
91
        """Create a CHKMap object.
82
92
 
105
115
            of old_key is removed.
106
116
        """
107
117
        delete_count = 0
 
118
        # Check preconditions first.
 
119
        as_st = StaticTuple.from_sequence
 
120
        new_items = set([as_st(key) for (old, key, value) in delta
 
121
                         if key is not None and old is None])
 
122
        existing_new = list(self.iteritems(key_filter=new_items))
 
123
        if existing_new:
 
124
            raise errors.InconsistentDeltaDelta(delta,
 
125
                "New items are already in the map %r." % existing_new)
 
126
        # Now apply changes.
108
127
        for old, new, value in delta:
109
128
            if old is not None and old != new:
110
129
                self.unmap(old, check_remap=False)
119
138
 
120
139
    def _ensure_root(self):
121
140
        """Ensure that the root node is an object not a key."""
122
 
        if type(self._root_node) is tuple:
 
141
        if type(self._root_node) is StaticTuple:
123
142
            # Demand-load the root
124
143
            self._root_node = self._get_node(self._root_node)
125
144
 
133
152
        :param node: A tuple key or node object.
134
153
        :return: A node object.
135
154
        """
136
 
        if type(node) is tuple:
 
155
        if type(node) is StaticTuple:
137
156
            bytes = self._read_bytes(node)
138
157
            return _deserialise(bytes, node,
139
158
                search_key_func=self._search_key_func)
180
199
            for key, value in sorted(node._items.iteritems()):
181
200
                # Don't use prefix nor indent here to line up when used in
182
201
                # tests in conjunction with assertEqualDiff
183
 
                result.append('      %r %r' % (key, value))
 
202
                result.append('      %r %r' % (tuple(key), value))
184
203
        return result
185
204
 
186
205
    @classmethod
204
223
        root_key = klass._create_directly(store, initial_value,
205
224
            maximum_size=maximum_size, key_width=key_width,
206
225
            search_key_func=search_key_func)
 
226
        if type(root_key) is not StaticTuple:
 
227
            raise AssertionError('we got a %s instead of a StaticTuple'
 
228
                                 % (type(root_key),))
207
229
        return root_key
208
230
 
209
231
    @classmethod
224
246
        node = LeafNode(search_key_func=search_key_func)
225
247
        node.set_maximum_size(maximum_size)
226
248
        node._key_width = key_width
227
 
        node._items = dict(initial_value)
 
249
        as_st = StaticTuple.from_sequence
 
250
        node._items = dict([(as_st(key), val) for key, val
 
251
                                               in initial_value.iteritems()])
228
252
        node._raw_size = sum([node._key_value_len(key, value)
229
 
                              for key,value in initial_value.iteritems()])
 
253
                              for key,value in node._items.iteritems()])
230
254
        node._len = len(node._items)
231
255
        node._compute_search_prefix()
232
256
        node._compute_serialised_prefix()
468
492
    def iteritems(self, key_filter=None):
469
493
        """Iterate over the entire CHKMap's contents."""
470
494
        self._ensure_root()
 
495
        if key_filter is not None:
 
496
            as_st = StaticTuple.from_sequence
 
497
            key_filter = [as_st(key) for key in key_filter]
471
498
        return self._root_node.iteritems(self._store, key_filter=key_filter)
472
499
 
473
500
    def key(self):
474
501
        """Return the key for this map."""
475
 
        if type(self._root_node) is tuple:
 
502
        if type(self._root_node) is StaticTuple:
476
503
            return self._root_node
477
504
        else:
478
505
            return self._root_node._key
482
509
        return len(self._root_node)
483
510
 
484
511
    def map(self, key, value):
485
 
        """Map a key tuple to value."""
 
512
        """Map a key tuple to value.
 
513
        
 
514
        :param key: A key to map.
 
515
        :param value: The value to assign to key.
 
516
        """
 
517
        key = StaticTuple.from_sequence(key)
486
518
        # Need a root object.
487
519
        self._ensure_root()
488
520
        prefix, node_details = self._root_node.map(self._store, key, value)
499
531
    def _node_key(self, node):
500
532
        """Get the key for a node whether it's a tuple or node."""
501
533
        if type(node) is tuple:
 
534
            node = StaticTuple.from_sequence(node)
 
535
        if type(node) is StaticTuple:
502
536
            return node
503
537
        else:
504
538
            return node._key
505
539
 
506
540
    def unmap(self, key, check_remap=True):
507
541
        """remove key from the map."""
 
542
        key = StaticTuple.from_sequence(key)
508
543
        self._ensure_root()
509
544
        if type(self._root_node) is InternalNode:
510
545
            unmapped = self._root_node.unmap(self._store, key,
524
559
 
525
560
        :return: The key of the root node.
526
561
        """
527
 
        if type(self._root_node) is tuple:
 
562
        if type(self._root_node) is StaticTuple:
528
563
            # Already saved.
529
564
            return self._root_node
530
565
        keys = list(self._root_node.serialise(self._store))
538
573
        adding the header bytes, and without prefix compression.
539
574
    """
540
575
 
 
576
    __slots__ = ('_key', '_len', '_maximum_size', '_key_width',
 
577
                 '_raw_size', '_items', '_search_prefix', '_search_key_func'
 
578
                )
 
579
 
541
580
    def __init__(self, key_width=1):
542
581
        """Create a node.
543
582
 
632
671
        the key/value pairs.
633
672
    """
634
673
 
 
674
    __slots__ = ('_common_serialised_prefix', '_serialise_key')
 
675
 
635
676
    def __init__(self, search_key_func=None):
636
677
        Node.__init__(self)
637
678
        # All of the keys in this leaf node share this common prefix
680
721
        :param bytes: The bytes of the node.
681
722
        :param key: The key that the serialised node has.
682
723
        """
 
724
        key = static_tuple.expect_static_tuple(key)
683
725
        return _deserialise_leaf_node(bytes, key,
684
726
                                      search_key_func=search_key_func)
685
727
 
855
897
            lines.append(serialized[prefix_len:])
856
898
            lines.extend(value_lines)
857
899
        sha1, _, _ = store.add_lines((None,), (), lines)
858
 
        self._key = ("sha1:" + sha1,)
 
900
        self._key = StaticTuple("sha1:" + sha1,).intern()
859
901
        bytes = ''.join(lines)
860
902
        if len(bytes) != self._current_size():
861
903
            raise AssertionError('Invalid _current_size')
929
971
        LeafNode or InternalNode.
930
972
    """
931
973
 
 
974
    __slots__ = ('_node_width',)
 
975
 
932
976
    def __init__(self, prefix='', search_key_func=None):
933
977
        Node.__init__(self)
934
978
        # The size of an internalnode with default values and no children.
976
1020
        :param key: The key that the serialised node has.
977
1021
        :return: An InternalNode instance.
978
1022
        """
 
1023
        key = static_tuple.expect_static_tuple(key)
979
1024
        return _deserialise_internal_node(bytes, key,
980
1025
                                          search_key_func=search_key_func)
981
1026
 
1006
1051
            # for whatever we are missing
1007
1052
            shortcut = True
1008
1053
            for prefix, node in self._items.iteritems():
1009
 
                if node.__class__ is tuple:
 
1054
                if node.__class__ is StaticTuple:
1010
1055
                    keys[node] = (prefix, None)
1011
1056
                else:
1012
1057
                    yield node, None
1041
1086
                    # A given key can only match 1 child node, if it isn't
1042
1087
                    # there, then we can just return nothing
1043
1088
                    return
1044
 
                if node.__class__ is tuple:
 
1089
                if node.__class__ is StaticTuple:
1045
1090
                    keys[node] = (search_prefix, [key])
1046
1091
                else:
1047
1092
                    # This is loaded, and the only thing that can match,
1074
1119
                        # We can ignore this one
1075
1120
                        continue
1076
1121
                    node_key_filter = prefix_to_keys[search_prefix]
1077
 
                    if node.__class__ is tuple:
 
1122
                    if node.__class__ is StaticTuple:
1078
1123
                        keys[node] = (search_prefix, node_key_filter)
1079
1124
                    else:
1080
1125
                        yield node, node_key_filter
1089
1134
                        if sub_prefix in length_filter:
1090
1135
                            node_key_filter.extend(prefix_to_keys[sub_prefix])
1091
1136
                    if node_key_filter: # this key matched something, yield it
1092
 
                        if node.__class__ is tuple:
 
1137
                        if node.__class__ is StaticTuple:
1093
1138
                            keys[node] = (prefix, node_key_filter)
1094
1139
                        else:
1095
1140
                            yield node, node_key_filter
1227
1272
        :return: An iterable of the keys inserted by this operation.
1228
1273
        """
1229
1274
        for node in self._items.itervalues():
1230
 
            if type(node) is tuple:
 
1275
            if type(node) is StaticTuple:
1231
1276
                # Never deserialised.
1232
1277
                continue
1233
1278
            if node._key is not None:
1244
1289
        lines.append('%s\n' % (self._search_prefix,))
1245
1290
        prefix_len = len(self._search_prefix)
1246
1291
        for prefix, node in sorted(self._items.items()):
1247
 
            if type(node) is tuple:
 
1292
            if type(node) is StaticTuple:
1248
1293
                key = node[0]
1249
1294
            else:
1250
1295
                key = node._key[0]
1254
1299
                    % (serialised, self._search_prefix))
1255
1300
            lines.append(serialised[prefix_len:])
1256
1301
        sha1, _, _ = store.add_lines((None,), (), lines)
1257
 
        self._key = ("sha1:" + sha1,)
 
1302
        self._key = StaticTuple("sha1:" + sha1,).intern()
1258
1303
        _page_cache.add(self._key, ''.join(lines))
1259
1304
        yield self._key
1260
1305
 
1289
1334
            raise AssertionError("unserialised nodes have no refs.")
1290
1335
        refs = []
1291
1336
        for value in self._items.itervalues():
1292
 
            if type(value) is tuple:
 
1337
            if type(value) is StaticTuple:
1293
1338
                refs.append(value)
1294
1339
            else:
1295
1340
                refs.append(value.key())
1396
1441
    return node
1397
1442
 
1398
1443
 
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()
 
1444
class CHKMapDifference(object):
 
1445
    """Iterate the stored pages and key,value pairs for (new - old).
 
1446
 
 
1447
    This class provides a generator over the stored CHK pages and the
 
1448
    (key, value) pairs that are in any of the new maps and not in any of the
 
1449
    old maps.
 
1450
 
 
1451
    Note that it may yield chk pages that are common (especially root nodes),
 
1452
    but it won't yield (key,value) pairs that are common.
 
1453
    """
 
1454
 
 
1455
    def __init__(self, store, new_root_keys, old_root_keys,
 
1456
                 search_key_func, pb=None):
 
1457
        # TODO: Should we add a StaticTuple barrier here? It would be nice to
 
1458
        #       force callers to use StaticTuple, because there will often be
 
1459
        #       lots of keys passed in here. And even if we cast it locally,
 
1460
        #       that just meanst that we will have *both* a StaticTuple and a
 
1461
        #       tuple() in memory, referring to the same object. (so a net
 
1462
        #       increase in memory, not a decrease.)
 
1463
        self._store = store
 
1464
        self._new_root_keys = new_root_keys
 
1465
        self._old_root_keys = old_root_keys
 
1466
        self._pb = pb
 
1467
        # All uninteresting chks that we have seen. By the time they are added
 
1468
        # here, they should be either fully ignored, or queued up for
 
1469
        # processing
 
1470
        # TODO: This might grow to a large size if there are lots of merge
 
1471
        #       parents, etc. However, it probably doesn't scale to O(history)
 
1472
        #       like _processed_new_refs does.
 
1473
        self._all_old_chks = set(self._old_root_keys)
 
1474
        # All items that we have seen from the old_root_keys
 
1475
        self._all_old_items = set()
 
1476
        # These are interesting items which were either read, or already in the
 
1477
        # interesting queue (so we don't need to walk them again)
 
1478
        # TODO: processed_new_refs becomes O(all_chks), consider switching to
 
1479
        #       SimpleSet here.
 
1480
        self._processed_new_refs = set()
 
1481
        self._search_key_func = search_key_func
 
1482
 
 
1483
        # The uninteresting and interesting nodes to be searched
 
1484
        self._old_queue = []
 
1485
        self._new_queue = []
 
1486
        # Holds the (key, value) items found when processing the root nodes,
 
1487
        # waiting for the uninteresting nodes to be walked
 
1488
        self._new_item_queue = []
 
1489
        self._state = None
 
1490
 
 
1491
    def _read_nodes_from_store(self, keys):
 
1492
        # We chose not to use _page_cache, because we think in terms of records
 
1493
        # to be yielded. Also, we expect to touch each page only 1 time during
 
1494
        # this code. (We may want to evaluate saving the raw bytes into the
 
1495
        # page cache, which would allow a working tree update after the fetch
 
1496
        # to not have to read the bytes again.)
 
1497
        as_st = StaticTuple.from_sequence
 
1498
        stream = self._store.get_record_stream(keys, 'unordered', True)
 
1499
        for record in stream:
 
1500
            if self._pb is not None:
 
1501
                self._pb.tick()
 
1502
            if record.storage_kind == 'absent':
 
1503
                raise errors.NoSuchRevision(self._store, record.key)
1483
1504
            bytes = record.get_bytes_as('fulltext')
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)
 
1505
            node = _deserialise(bytes, record.key,
 
1506
                                search_key_func=self._search_key_func)
1487
1507
            if type(node) is InternalNode:
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)
 
1508
                # Note we don't have to do node.refs() because we know that
 
1509
                # there are no children that have been pushed into this node
 
1510
                # Note: Using as_st() here seemed to save 1.2MB, which would
 
1511
                #       indicate that we keep 100k prefix_refs around while
 
1512
                #       processing. They *should* be shorter lived than that...
 
1513
                #       It does cost us ~10s of processing time
 
1514
                #prefix_refs = [as_st(item) for item in node._items.iteritems()]
 
1515
                prefix_refs = node._items.items()
 
1516
                items = []
1494
1517
            else:
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)
 
1518
                prefix_refs = []
 
1519
                # Note: We don't use a StaticTuple here. Profiling showed a
 
1520
                #       minor memory improvement (0.8MB out of 335MB peak 0.2%)
 
1521
                #       But a significant slowdown (15s / 145s, or 10%)
 
1522
                items = node._items.items()
 
1523
            yield record, node, prefix_refs, items
 
1524
 
 
1525
    def _read_old_roots(self):
 
1526
        old_chks_to_enqueue = []
 
1527
        all_old_chks = self._all_old_chks
 
1528
        for record, node, prefix_refs, items in \
 
1529
                self._read_nodes_from_store(self._old_root_keys):
 
1530
            # Uninteresting node
 
1531
            prefix_refs = [p_r for p_r in prefix_refs
 
1532
                                if p_r[1] not in all_old_chks]
 
1533
            new_refs = [p_r[1] for p_r in prefix_refs]
 
1534
            all_old_chks.update(new_refs)
 
1535
            # TODO: This might be a good time to turn items into StaticTuple
 
1536
            #       instances and possibly intern them. However, this does not
 
1537
            #       impact 'initial branch' performance, so I'm not worrying
 
1538
            #       about this yet
 
1539
            self._all_old_items.update(items)
 
1540
            # Queue up the uninteresting references
 
1541
            # Don't actually put them in the 'to-read' queue until we have
 
1542
            # finished checking the interesting references
 
1543
            old_chks_to_enqueue.extend(prefix_refs)
 
1544
        return old_chks_to_enqueue
 
1545
 
 
1546
    def _enqueue_old(self, new_prefixes, old_chks_to_enqueue):
 
1547
        # At this point, we have read all the uninteresting and interesting
 
1548
        # items, so we can queue up the uninteresting stuff, knowing that we've
 
1549
        # handled the interesting ones
 
1550
        for prefix, ref in old_chks_to_enqueue:
 
1551
            not_interesting = True
 
1552
            for i in xrange(len(prefix), 0, -1):
 
1553
                if prefix[:i] in new_prefixes:
 
1554
                    not_interesting = False
 
1555
                    break
 
1556
            if not_interesting:
 
1557
                # This prefix is not part of the remaining 'interesting set'
 
1558
                continue
 
1559
            self._old_queue.append(ref)
 
1560
 
 
1561
    def _read_all_roots(self):
 
1562
        """Read the root pages.
 
1563
 
 
1564
        This is structured as a generator, so that the root records can be
 
1565
        yielded up to whoever needs them without any buffering.
 
1566
        """
 
1567
        # This is the bootstrap phase
 
1568
        if not self._old_root_keys:
 
1569
            # With no old_root_keys we can just shortcut and be ready
 
1570
            # for _flush_new_queue
 
1571
            self._new_queue = list(self._new_root_keys)
 
1572
            return
 
1573
        old_chks_to_enqueue = self._read_old_roots()
 
1574
        # filter out any root keys that are already known to be uninteresting
 
1575
        new_keys = set(self._new_root_keys).difference(self._all_old_chks)
 
1576
        # These are prefixes that are present in new_keys that we are
 
1577
        # thinking to yield
 
1578
        new_prefixes = set()
 
1579
        # We are about to yield all of these, so we don't want them getting
 
1580
        # added a second time
 
1581
        processed_new_refs = self._processed_new_refs
 
1582
        processed_new_refs.update(new_keys)
 
1583
        for record, node, prefix_refs, items in \
 
1584
                self._read_nodes_from_store(new_keys):
 
1585
            # At this level, we now know all the uninteresting references
 
1586
            # So we filter and queue up whatever is remaining
 
1587
            prefix_refs = [p_r for p_r in prefix_refs
 
1588
                           if p_r[1] not in self._all_old_chks
 
1589
                              and p_r[1] not in processed_new_refs]
 
1590
            refs = [p_r[1] for p_r in prefix_refs]
 
1591
            new_prefixes.update([p_r[0] for p_r in prefix_refs])
 
1592
            self._new_queue.extend(refs)
 
1593
            # TODO: We can potentially get multiple items here, however the
 
1594
            #       current design allows for this, as callers will do the work
 
1595
            #       to make the results unique. We might profile whether we
 
1596
            #       gain anything by ensuring unique return values for items
 
1597
            # TODO: This might be a good time to cast to StaticTuple, as
 
1598
            #       self._new_item_queue will hold the contents of multiple
 
1599
            #       records for an extended lifetime
 
1600
            new_items = [item for item in items
 
1601
                               if item not in self._all_old_items]
 
1602
            self._new_item_queue.extend(new_items)
 
1603
            new_prefixes.update([self._search_key_func(item[0])
 
1604
                                 for item in new_items])
 
1605
            processed_new_refs.update(refs)
 
1606
            yield record
 
1607
        # For new_prefixes we have the full length prefixes queued up.
 
1608
        # However, we also need possible prefixes. (If we have a known ref to
 
1609
        # 'ab', then we also need to include 'a'.) So expand the
 
1610
        # new_prefixes to include all shorter prefixes
 
1611
        for prefix in list(new_prefixes):
 
1612
            new_prefixes.update([prefix[:i] for i in xrange(1, len(prefix))])
 
1613
        self._enqueue_old(new_prefixes, old_chks_to_enqueue)
 
1614
 
 
1615
    def _flush_new_queue(self):
 
1616
        # No need to maintain the heap invariant anymore, just pull things out
 
1617
        # and process them
 
1618
        refs = set(self._new_queue)
 
1619
        self._new_queue = []
 
1620
        # First pass, flush all interesting items and convert to using direct refs
 
1621
        all_old_chks = self._all_old_chks
 
1622
        processed_new_refs = self._processed_new_refs
 
1623
        all_old_items = self._all_old_items
 
1624
        new_items = [item for item in self._new_item_queue
 
1625
                           if item not in all_old_items]
 
1626
        self._new_item_queue = []
 
1627
        if new_items:
 
1628
            yield None, new_items
 
1629
        refs = refs.difference(all_old_chks)
 
1630
        processed_new_refs.update(refs)
 
1631
        while refs:
 
1632
            # TODO: Using a SimpleSet for self._processed_new_refs and
 
1633
            #       saved as much as 10MB of peak memory. However, it requires
 
1634
            #       implementing a non-pyrex version.
 
1635
            next_refs = set()
 
1636
            next_refs_update = next_refs.update
 
1637
            # Inlining _read_nodes_from_store improves 'bzr branch bzr.dev'
 
1638
            # from 1m54s to 1m51s. Consider it.
 
1639
            for record, _, p_refs, items in self._read_nodes_from_store(refs):
 
1640
                if all_old_items:
 
1641
                    # using the 'if' check saves about 145s => 141s, when
 
1642
                    # streaming initial branch of Launchpad data.
 
1643
                    items = [item for item in items
 
1644
                             if item not in all_old_items]
 
1645
                yield record, items
 
1646
                next_refs_update([p_r[1] for p_r in p_refs])
 
1647
                del p_refs
 
1648
            # set1.difference(set/dict) walks all of set1, and checks if it
 
1649
            # exists in 'other'.
 
1650
            # set1.difference(iterable) walks all of iterable, and does a
 
1651
            # 'difference_update' on a clone of set1. Pick wisely based on the
 
1652
            # expected sizes of objects.
 
1653
            # in our case it is expected that 'new_refs' will always be quite
 
1654
            # small.
 
1655
            next_refs = next_refs.difference(all_old_chks)
 
1656
            next_refs = next_refs.difference(processed_new_refs)
 
1657
            processed_new_refs.update(next_refs)
 
1658
            refs = next_refs
 
1659
 
 
1660
    def _process_next_old(self):
 
1661
        # Since we don't filter uninteresting any further than during
 
1662
        # _read_all_roots, process the whole queue in a single pass.
 
1663
        refs = self._old_queue
 
1664
        self._old_queue = []
 
1665
        all_old_chks = self._all_old_chks
 
1666
        for record, _, prefix_refs, items in self._read_nodes_from_store(refs):
 
1667
            # TODO: Use StaticTuple here?
 
1668
            self._all_old_items.update(items)
 
1669
            refs = [r for _,r in prefix_refs if r not in all_old_chks]
 
1670
            self._old_queue.extend(refs)
 
1671
            all_old_chks.update(refs)
 
1672
 
 
1673
    def _process_queues(self):
 
1674
        while self._old_queue:
 
1675
            self._process_next_old()
 
1676
        return self._flush_new_queue()
 
1677
 
 
1678
    def process(self):
 
1679
        for record in self._read_all_roots():
 
1680
            yield record, []
 
1681
        for record, items in self._process_queues():
 
1682
            yield record, items
1499
1683
 
1500
1684
 
1501
1685
def iter_interesting_nodes(store, interesting_root_keys,
1512
1696
    :return: Yield
1513
1697
        (interesting record, {interesting key:values})
1514
1698
    """
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
 
1699
    iterator = CHKMapDifference(store, interesting_root_keys,
 
1700
                                uninteresting_root_keys,
 
1701
                                search_key_func=store._search_key_func,
 
1702
                                pb=pb)
 
1703
    return iterator.process()
1581
1704
 
1582
1705
 
1583
1706
try:
1587
1710
        _deserialise_leaf_node,
1588
1711
        _deserialise_internal_node,
1589
1712
        )
1590
 
except ImportError:
 
1713
except ImportError, e:
 
1714
    osutils.failed_to_load_extension(e)
1591
1715
    from bzrlib._chk_map_py import (
1592
1716
        _search_key_16,
1593
1717
        _search_key_255,
1596
1720
        )
1597
1721
search_key_registry.register('hash-16-way', _search_key_16)
1598
1722
search_key_registry.register('hash-255-way', _search_key_255)
 
1723
 
 
1724
 
 
1725
def _check_key(key):
 
1726
    """Helper function to assert that a key is properly formatted.
 
1727
 
 
1728
    This generally shouldn't be used in production code, but it can be helpful
 
1729
    to debug problems.
 
1730
    """
 
1731
    if type(key) is not StaticTuple:
 
1732
        raise TypeError('key %r is not StaticTuple but %s' % (key, type(key)))
 
1733
    if len(key) != 1:
 
1734
        raise ValueError('key %r should have length 1, not %d' % (key, len(key),))
 
1735
    if type(key[0]) is not str:
 
1736
        raise TypeError('key %r should hold a str, not %r'
 
1737
                        % (key, type(key[0])))
 
1738
    if not key[0].startswith('sha1:'):
 
1739
        raise ValueError('key %r should point to a sha1:' % (key,))
 
1740
 
 
1741