~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/repofmt/pack_repo.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-02-17 13:49:11 UTC
  • mfrom: (4988.11.1 imports)
  • Revision ID: pqm@pqm.ubuntu.com-20100217134911-s77se00ni7xc1hz8
(Jelmer) Remove some unused imports.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2007-2011 Canonical Ltd
 
1
# Copyright (C) 2007-2010 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
30
30
    osutils,
31
31
    pack,
32
32
    transactions,
33
 
    tsort,
34
33
    ui,
 
34
    xml5,
 
35
    xml6,
 
36
    xml7,
35
37
    )
36
38
from bzrlib.index import (
37
39
    CombinedGraphIndex,
38
40
    GraphIndexPrefixAdapter,
39
41
    )
 
42
from bzrlib.knit import (
 
43
    KnitPlainFactory,
 
44
    KnitVersionedFiles,
 
45
    _KnitGraphIndex,
 
46
    _DirectPackAccess,
 
47
    )
 
48
from bzrlib import tsort
40
49
""")
41
50
from bzrlib import (
42
 
    btree_index,
 
51
    bzrdir,
43
52
    errors,
44
53
    lockable_files,
45
54
    lockdir,
 
55
    revision as _mod_revision,
46
56
    )
47
57
 
48
 
from bzrlib.decorators import (
49
 
    needs_read_lock,
50
 
    needs_write_lock,
51
 
    only_raises,
52
 
    )
53
 
from bzrlib.lock import LogicalLockResult
 
58
from bzrlib.decorators import needs_write_lock, only_raises
 
59
from bzrlib.btree_index import (
 
60
    BTreeGraphIndex,
 
61
    BTreeBuilder,
 
62
    )
 
63
from bzrlib.index import (
 
64
    GraphIndex,
 
65
    InMemoryGraphIndex,
 
66
    )
 
67
from bzrlib.repofmt.knitrepo import KnitRepository
54
68
from bzrlib.repository import (
55
 
    _LazyListJoin,
56
 
    MetaDirRepository,
 
69
    CommitBuilder,
 
70
    MetaDirRepositoryFormat,
57
71
    RepositoryFormat,
58
 
    RepositoryWriteLockResult,
59
 
    )
60
 
from bzrlib.vf_repository import (
61
 
    MetaDirVersionedFileRepository,
62
 
    MetaDirVersionedFileRepositoryFormat,
63
 
    VersionedFileCommitBuilder,
64
 
    VersionedFileRootCommitBuilder,
 
72
    RootCommitBuilder,
 
73
    StreamSource,
65
74
    )
66
75
from bzrlib.trace import (
67
76
    mutter,
70
79
    )
71
80
 
72
81
 
73
 
class PackCommitBuilder(VersionedFileCommitBuilder):
74
 
    """Subclass of VersionedFileCommitBuilder to add texts with pack semantics.
 
82
class PackCommitBuilder(CommitBuilder):
 
83
    """A subclass of CommitBuilder to add texts with pack semantics.
75
84
 
76
85
    Specifically this uses one knit object rather than one knit object per
77
86
    added text, reducing memory and object pressure.
79
88
 
80
89
    def __init__(self, repository, parents, config, timestamp=None,
81
90
                 timezone=None, committer=None, revprops=None,
82
 
                 revision_id=None, lossy=False):
83
 
        VersionedFileCommitBuilder.__init__(self, repository, parents, config,
 
91
                 revision_id=None):
 
92
        CommitBuilder.__init__(self, repository, parents, config,
84
93
            timestamp=timestamp, timezone=timezone, committer=committer,
85
 
            revprops=revprops, revision_id=revision_id, lossy=lossy)
 
94
            revprops=revprops, revision_id=revision_id)
86
95
        self._file_graph = graph.Graph(
87
96
            repository._pack_collection.text_index.combined_index)
88
97
 
91
100
        return set([key[1] for key in self._file_graph.heads(keys)])
92
101
 
93
102
 
94
 
class PackRootCommitBuilder(VersionedFileRootCommitBuilder):
 
103
class PackRootCommitBuilder(RootCommitBuilder):
95
104
    """A subclass of RootCommitBuilder to add texts with pack semantics.
96
105
 
97
106
    Specifically this uses one knit object rather than one knit object per
100
109
 
101
110
    def __init__(self, repository, parents, config, timestamp=None,
102
111
                 timezone=None, committer=None, revprops=None,
103
 
                 revision_id=None, lossy=False):
104
 
        super(PackRootCommitBuilder, self).__init__(repository, parents,
105
 
            config, timestamp=timestamp, timezone=timezone,
106
 
            committer=committer, revprops=revprops, revision_id=revision_id,
107
 
            lossy=lossy)
 
112
                 revision_id=None):
 
113
        CommitBuilder.__init__(self, repository, parents, config,
 
114
            timestamp=timestamp, timezone=timezone, committer=committer,
 
115
            revprops=revprops, revision_id=revision_id)
108
116
        self._file_graph = graph.Graph(
109
117
            repository._pack_collection.text_index.combined_index)
110
118
 
221
229
        unlimited_cache = False
222
230
        if index_type == 'chk':
223
231
            unlimited_cache = True
224
 
        index = self.index_class(self.index_transport,
225
 
                    self.index_name(index_type, self.name),
226
 
                    self.index_sizes[self.index_offset(index_type)],
227
 
                    unlimited_cache=unlimited_cache)
228
 
        if index_type == 'chk':
229
 
            index._leaf_factory = btree_index._gcchk_factory
230
 
        setattr(self, index_type + '_index', index)
 
232
        setattr(self, index_type + '_index',
 
233
            self.index_class(self.index_transport,
 
234
                self.index_name(index_type, self.name),
 
235
                self.index_sizes[self.index_offset(index_type)],
 
236
                unlimited_cache=unlimited_cache))
231
237
 
232
238
 
233
239
class ExistingPack(Pack):
314
320
        for index_type in index_types:
315
321
            old_name = self.index_name(index_type, self.name)
316
322
            new_name = '../indices/' + old_name
317
 
            self.upload_transport.move(old_name, new_name)
 
323
            self.upload_transport.rename(old_name, new_name)
318
324
            self._replace_index_with_readonly(index_type)
319
325
        new_name = '../packs/' + self.file_name()
320
 
        self.upload_transport.move(self.file_name(), new_name)
 
326
        self.upload_transport.rename(self.file_name(), new_name)
321
327
        self._state = 'finished'
322
328
 
323
329
    def _get_external_refs(self, index):
503
509
        new_name = self.name + '.pack'
504
510
        if not suspend:
505
511
            new_name = '../packs/' + new_name
506
 
        self.upload_transport.move(self.random_name, new_name)
 
512
        self.upload_transport.rename(self.random_name, new_name)
507
513
        self._state = 'finished'
508
514
        if 'pack' in debug.debug_flags:
509
515
            # XXX: size might be interesting?
581
587
                                             flush_func=flush_func)
582
588
        self.add_callback = None
583
589
 
 
590
    def replace_indices(self, index_to_pack, indices):
 
591
        """Replace the current mappings with fresh ones.
 
592
 
 
593
        This should probably not be used eventually, rather incremental add and
 
594
        removal of indices. It has been added during refactoring of existing
 
595
        code.
 
596
 
 
597
        :param index_to_pack: A mapping from index objects to
 
598
            (transport, name) tuples for the pack file data.
 
599
        :param indices: A list of indices.
 
600
        """
 
601
        # refresh the revision pack map dict without replacing the instance.
 
602
        self.index_to_pack.clear()
 
603
        self.index_to_pack.update(index_to_pack)
 
604
        # XXX: API break - clearly a 'replace' method would be good?
 
605
        self.combined_index._indices[:] = indices
 
606
        # the current add nodes callback for the current writable index if
 
607
        # there is one.
 
608
        self.add_callback = None
 
609
 
584
610
    def add_index(self, index, pack):
585
611
        """Add index to the aggregate, which is an index for Pack pack.
586
612
 
593
619
        # expose it to the index map
594
620
        self.index_to_pack[index] = pack.access_tuple()
595
621
        # put it at the front of the linear index list
596
 
        self.combined_index.insert_index(0, index, pack.name)
 
622
        self.combined_index.insert_index(0, index)
597
623
 
598
624
    def add_writable_index(self, index, pack):
599
625
        """Add an index which is able to have data added to it.
619
645
        self.data_access.set_writer(None, None, (None, None))
620
646
        self.index_to_pack.clear()
621
647
        del self.combined_index._indices[:]
622
 
        del self.combined_index._index_names[:]
623
648
        self.add_callback = None
624
649
 
625
650
    def remove_index(self, index):
628
653
        :param index: An index from the pack parameter.
629
654
        """
630
655
        del self.index_to_pack[index]
631
 
        pos = self.combined_index._indices.index(index)
632
 
        del self.combined_index._indices[pos]
633
 
        del self.combined_index._index_names[pos]
 
656
        self.combined_index._indices.remove(index)
634
657
        if (self.add_callback is not None and
635
658
            getattr(index, 'add_nodes', None) == self.add_callback):
636
659
            self.add_callback = None
666
689
        # What text keys to copy. None for 'all texts'. This is set by
667
690
        # _copy_inventory_texts
668
691
        self._text_filter = None
 
692
        self._extra_init()
 
693
 
 
694
    def _extra_init(self):
 
695
        """A template hook to allow extending the constructor trivially."""
 
696
 
 
697
    def _pack_map_and_index_list(self, index_attribute):
 
698
        """Convert a list of packs to an index pack map and index list.
 
699
 
 
700
        :param index_attribute: The attribute that the desired index is found
 
701
            on.
 
702
        :return: A tuple (map, list) where map contains the dict from
 
703
            index:pack_tuple, and list contains the indices in the preferred
 
704
            access order.
 
705
        """
 
706
        indices = []
 
707
        pack_map = {}
 
708
        for pack_obj in self.packs:
 
709
            index = getattr(pack_obj, index_attribute)
 
710
            indices.append(index)
 
711
            pack_map[index] = pack_obj
 
712
        return pack_map, indices
 
713
 
 
714
    def _index_contents(self, indices, key_filter=None):
 
715
        """Get an iterable of the index contents from a pack_map.
 
716
 
 
717
        :param indices: The list of indices to query
 
718
        :param key_filter: An optional filter to limit the keys returned.
 
719
        """
 
720
        all_index = CombinedGraphIndex(indices)
 
721
        if key_filter is None:
 
722
            return all_index.iter_all_entries()
 
723
        else:
 
724
            return all_index.iter_entries(key_filter)
669
725
 
670
726
    def pack(self, pb=None):
671
727
        """Create a new pack by reading data from other packs.
682
738
        :return: A Pack object, or None if nothing was copied.
683
739
        """
684
740
        # open a pack - using the same name as the last temporary file
685
 
        # - which has already been flushed, so it's safe.
 
741
        # - which has already been flushed, so its safe.
686
742
        # XXX: - duplicate code warning with start_write_group; fix before
687
743
        #      considering 'done'.
688
744
        if self._pack_collection._new_pack is not None:
720
776
        new_pack.signature_index.set_optimize(combine_backing_indices=False)
721
777
        return new_pack
722
778
 
 
779
    def _update_pack_order(self, entries, index_to_pack_map):
 
780
        """Determine how we want our packs to be ordered.
 
781
 
 
782
        This changes the sort order of the self.packs list so that packs unused
 
783
        by 'entries' will be at the end of the list, so that future requests
 
784
        can avoid probing them.  Used packs will be at the front of the
 
785
        self.packs list, in the order of their first use in 'entries'.
 
786
 
 
787
        :param entries: A list of (index, ...) tuples
 
788
        :param index_to_pack_map: A mapping from index objects to pack objects.
 
789
        """
 
790
        packs = []
 
791
        seen_indexes = set()
 
792
        for entry in entries:
 
793
            index = entry[0]
 
794
            if index not in seen_indexes:
 
795
                packs.append(index_to_pack_map[index])
 
796
                seen_indexes.add(index)
 
797
        if len(packs) == len(self.packs):
 
798
            if 'pack' in debug.debug_flags:
 
799
                mutter('Not changing pack list, all packs used.')
 
800
            return
 
801
        seen_packs = set(packs)
 
802
        for pack in self.packs:
 
803
            if pack not in seen_packs:
 
804
                packs.append(pack)
 
805
                seen_packs.add(pack)
 
806
        if 'pack' in debug.debug_flags:
 
807
            old_names = [p.access_tuple()[1] for p in self.packs]
 
808
            new_names = [p.access_tuple()[1] for p in packs]
 
809
            mutter('Reordering packs\nfrom: %s\n  to: %s',
 
810
                   old_names, new_names)
 
811
        self.packs = packs
 
812
 
723
813
    def _copy_revision_texts(self):
724
814
        """Copy revision data to the new pack."""
725
 
        raise NotImplementedError(self._copy_revision_texts)
 
815
        # select revisions
 
816
        if self.revision_ids:
 
817
            revision_keys = [(revision_id,) for revision_id in self.revision_ids]
 
818
        else:
 
819
            revision_keys = None
 
820
        # select revision keys
 
821
        revision_index_map, revision_indices = self._pack_map_and_index_list(
 
822
            'revision_index')
 
823
        revision_nodes = self._index_contents(revision_indices, revision_keys)
 
824
        revision_nodes = list(revision_nodes)
 
825
        self._update_pack_order(revision_nodes, revision_index_map)
 
826
        # copy revision keys and adjust values
 
827
        self.pb.update("Copying revision texts", 1)
 
828
        total_items, readv_group_iter = self._revision_node_readv(revision_nodes)
 
829
        list(self._copy_nodes_graph(revision_index_map, self.new_pack._writer,
 
830
            self.new_pack.revision_index, readv_group_iter, total_items))
 
831
        if 'pack' in debug.debug_flags:
 
832
            mutter('%s: create_pack: revisions copied: %s%s %d items t+%6.3fs',
 
833
                time.ctime(), self._pack_collection._upload_transport.base,
 
834
                self.new_pack.random_name,
 
835
                self.new_pack.revision_index.key_count(),
 
836
                time.time() - self.new_pack.start_time)
 
837
        self._revision_keys = revision_keys
726
838
 
727
839
    def _copy_inventory_texts(self):
728
840
        """Copy the inventory texts to the new pack.
731
843
 
732
844
        Sets self._text_filter appropriately.
733
845
        """
734
 
        raise NotImplementedError(self._copy_inventory_texts)
 
846
        # select inventory keys
 
847
        inv_keys = self._revision_keys # currently the same keyspace, and note that
 
848
        # querying for keys here could introduce a bug where an inventory item
 
849
        # is missed, so do not change it to query separately without cross
 
850
        # checking like the text key check below.
 
851
        inventory_index_map, inventory_indices = self._pack_map_and_index_list(
 
852
            'inventory_index')
 
853
        inv_nodes = self._index_contents(inventory_indices, inv_keys)
 
854
        # copy inventory keys and adjust values
 
855
        # XXX: Should be a helper function to allow different inv representation
 
856
        # at this point.
 
857
        self.pb.update("Copying inventory texts", 2)
 
858
        total_items, readv_group_iter = self._least_readv_node_readv(inv_nodes)
 
859
        # Only grab the output lines if we will be processing them
 
860
        output_lines = bool(self.revision_ids)
 
861
        inv_lines = self._copy_nodes_graph(inventory_index_map,
 
862
            self.new_pack._writer, self.new_pack.inventory_index,
 
863
            readv_group_iter, total_items, output_lines=output_lines)
 
864
        if self.revision_ids:
 
865
            self._process_inventory_lines(inv_lines)
 
866
        else:
 
867
            # eat the iterator to cause it to execute.
 
868
            list(inv_lines)
 
869
            self._text_filter = None
 
870
        if 'pack' in debug.debug_flags:
 
871
            mutter('%s: create_pack: inventories copied: %s%s %d items t+%6.3fs',
 
872
                time.ctime(), self._pack_collection._upload_transport.base,
 
873
                self.new_pack.random_name,
 
874
                self.new_pack.inventory_index.key_count(),
 
875
                time.time() - self.new_pack.start_time)
735
876
 
736
877
    def _copy_text_texts(self):
737
 
        raise NotImplementedError(self._copy_text_texts)
 
878
        # select text keys
 
879
        text_index_map, text_nodes = self._get_text_nodes()
 
880
        if self._text_filter is not None:
 
881
            # We could return the keys copied as part of the return value from
 
882
            # _copy_nodes_graph but this doesn't work all that well with the
 
883
            # need to get line output too, so we check separately, and as we're
 
884
            # going to buffer everything anyway, we check beforehand, which
 
885
            # saves reading knit data over the wire when we know there are
 
886
            # mising records.
 
887
            text_nodes = set(text_nodes)
 
888
            present_text_keys = set(_node[1] for _node in text_nodes)
 
889
            missing_text_keys = set(self._text_filter) - present_text_keys
 
890
            if missing_text_keys:
 
891
                # TODO: raise a specific error that can handle many missing
 
892
                # keys.
 
893
                mutter("missing keys during fetch: %r", missing_text_keys)
 
894
                a_missing_key = missing_text_keys.pop()
 
895
                raise errors.RevisionNotPresent(a_missing_key[1],
 
896
                    a_missing_key[0])
 
897
        # copy text keys and adjust values
 
898
        self.pb.update("Copying content texts", 3)
 
899
        total_items, readv_group_iter = self._least_readv_node_readv(text_nodes)
 
900
        list(self._copy_nodes_graph(text_index_map, self.new_pack._writer,
 
901
            self.new_pack.text_index, readv_group_iter, total_items))
 
902
        self._log_copied_texts()
738
903
 
739
904
    def _create_pack_from_packs(self):
740
 
        raise NotImplementedError(self._create_pack_from_packs)
 
905
        self.pb.update("Opening pack", 0, 5)
 
906
        self.new_pack = self.open_pack()
 
907
        new_pack = self.new_pack
 
908
        # buffer data - we won't be reading-back during the pack creation and
 
909
        # this makes a significant difference on sftp pushes.
 
910
        new_pack.set_write_cache_size(1024*1024)
 
911
        if 'pack' in debug.debug_flags:
 
912
            plain_pack_list = ['%s%s' % (a_pack.pack_transport.base, a_pack.name)
 
913
                for a_pack in self.packs]
 
914
            if self.revision_ids is not None:
 
915
                rev_count = len(self.revision_ids)
 
916
            else:
 
917
                rev_count = 'all'
 
918
            mutter('%s: create_pack: creating pack from source packs: '
 
919
                '%s%s %s revisions wanted %s t=0',
 
920
                time.ctime(), self._pack_collection._upload_transport.base, new_pack.random_name,
 
921
                plain_pack_list, rev_count)
 
922
        self._copy_revision_texts()
 
923
        self._copy_inventory_texts()
 
924
        self._copy_text_texts()
 
925
        # select signature keys
 
926
        signature_filter = self._revision_keys # same keyspace
 
927
        signature_index_map, signature_indices = self._pack_map_and_index_list(
 
928
            'signature_index')
 
929
        signature_nodes = self._index_contents(signature_indices,
 
930
            signature_filter)
 
931
        # copy signature keys and adjust values
 
932
        self.pb.update("Copying signature texts", 4)
 
933
        self._copy_nodes(signature_nodes, signature_index_map, new_pack._writer,
 
934
            new_pack.signature_index)
 
935
        if 'pack' in debug.debug_flags:
 
936
            mutter('%s: create_pack: revision signatures copied: %s%s %d items t+%6.3fs',
 
937
                time.ctime(), self._pack_collection._upload_transport.base, new_pack.random_name,
 
938
                new_pack.signature_index.key_count(),
 
939
                time.time() - new_pack.start_time)
 
940
        # copy chk contents
 
941
        # NB XXX: how to check CHK references are present? perhaps by yielding
 
942
        # the items? How should that interact with stacked repos?
 
943
        if new_pack.chk_index is not None:
 
944
            self._copy_chks()
 
945
            if 'pack' in debug.debug_flags:
 
946
                mutter('%s: create_pack: chk content copied: %s%s %d items t+%6.3fs',
 
947
                    time.ctime(), self._pack_collection._upload_transport.base,
 
948
                    new_pack.random_name,
 
949
                    new_pack.chk_index.key_count(),
 
950
                    time.time() - new_pack.start_time)
 
951
        new_pack._check_references()
 
952
        if not self._use_pack(new_pack):
 
953
            new_pack.abort()
 
954
            return None
 
955
        self.pb.update("Finishing pack", 5)
 
956
        new_pack.finish()
 
957
        self._pack_collection.allocate(new_pack)
 
958
        return new_pack
 
959
 
 
960
    def _copy_chks(self, refs=None):
 
961
        # XXX: Todo, recursive follow-pointers facility when fetching some
 
962
        # revisions only.
 
963
        chk_index_map, chk_indices = self._pack_map_and_index_list(
 
964
            'chk_index')
 
965
        chk_nodes = self._index_contents(chk_indices, refs)
 
966
        new_refs = set()
 
967
        # TODO: This isn't strictly tasteful as we are accessing some private
 
968
        #       variables (_serializer). Perhaps a better way would be to have
 
969
        #       Repository._deserialise_chk_node()
 
970
        search_key_func = chk_map.search_key_registry.get(
 
971
            self._pack_collection.repo._serializer.search_key_name)
 
972
        def accumlate_refs(lines):
 
973
            # XXX: move to a generic location
 
974
            # Yay mismatch:
 
975
            bytes = ''.join(lines)
 
976
            node = chk_map._deserialise(bytes, ("unknown",), search_key_func)
 
977
            new_refs.update(node.refs())
 
978
        self._copy_nodes(chk_nodes, chk_index_map, self.new_pack._writer,
 
979
            self.new_pack.chk_index, output_lines=accumlate_refs)
 
980
        return new_refs
 
981
 
 
982
    def _copy_nodes(self, nodes, index_map, writer, write_index,
 
983
        output_lines=None):
 
984
        """Copy knit nodes between packs with no graph references.
 
985
 
 
986
        :param output_lines: Output full texts of copied items.
 
987
        """
 
988
        pb = ui.ui_factory.nested_progress_bar()
 
989
        try:
 
990
            return self._do_copy_nodes(nodes, index_map, writer,
 
991
                write_index, pb, output_lines=output_lines)
 
992
        finally:
 
993
            pb.finished()
 
994
 
 
995
    def _do_copy_nodes(self, nodes, index_map, writer, write_index, pb,
 
996
        output_lines=None):
 
997
        # for record verification
 
998
        knit = KnitVersionedFiles(None, None)
 
999
        # plan a readv on each source pack:
 
1000
        # group by pack
 
1001
        nodes = sorted(nodes)
 
1002
        # how to map this into knit.py - or knit.py into this?
 
1003
        # we don't want the typical knit logic, we want grouping by pack
 
1004
        # at this point - perhaps a helper library for the following code
 
1005
        # duplication points?
 
1006
        request_groups = {}
 
1007
        for index, key, value in nodes:
 
1008
            if index not in request_groups:
 
1009
                request_groups[index] = []
 
1010
            request_groups[index].append((key, value))
 
1011
        record_index = 0
 
1012
        pb.update("Copied record", record_index, len(nodes))
 
1013
        for index, items in request_groups.iteritems():
 
1014
            pack_readv_requests = []
 
1015
            for key, value in items:
 
1016
                # ---- KnitGraphIndex.get_position
 
1017
                bits = value[1:].split(' ')
 
1018
                offset, length = int(bits[0]), int(bits[1])
 
1019
                pack_readv_requests.append((offset, length, (key, value[0])))
 
1020
            # linear scan up the pack
 
1021
            pack_readv_requests.sort()
 
1022
            # copy the data
 
1023
            pack_obj = index_map[index]
 
1024
            transport, path = pack_obj.access_tuple()
 
1025
            try:
 
1026
                reader = pack.make_readv_reader(transport, path,
 
1027
                    [offset[0:2] for offset in pack_readv_requests])
 
1028
            except errors.NoSuchFile:
 
1029
                if self._reload_func is not None:
 
1030
                    self._reload_func()
 
1031
                raise
 
1032
            for (names, read_func), (_1, _2, (key, eol_flag)) in \
 
1033
                izip(reader.iter_records(), pack_readv_requests):
 
1034
                raw_data = read_func(None)
 
1035
                # check the header only
 
1036
                if output_lines is not None:
 
1037
                    output_lines(knit._parse_record(key[-1], raw_data)[0])
 
1038
                else:
 
1039
                    df, _ = knit._parse_record_header(key, raw_data)
 
1040
                    df.close()
 
1041
                pos, size = writer.add_bytes_record(raw_data, names)
 
1042
                write_index.add_node(key, eol_flag + "%d %d" % (pos, size))
 
1043
                pb.update("Copied record", record_index)
 
1044
                record_index += 1
 
1045
 
 
1046
    def _copy_nodes_graph(self, index_map, writer, write_index,
 
1047
        readv_group_iter, total_items, output_lines=False):
 
1048
        """Copy knit nodes between packs.
 
1049
 
 
1050
        :param output_lines: Return lines present in the copied data as
 
1051
            an iterator of line,version_id.
 
1052
        """
 
1053
        pb = ui.ui_factory.nested_progress_bar()
 
1054
        try:
 
1055
            for result in self._do_copy_nodes_graph(index_map, writer,
 
1056
                write_index, output_lines, pb, readv_group_iter, total_items):
 
1057
                yield result
 
1058
        except Exception:
 
1059
            # Python 2.4 does not permit try:finally: in a generator.
 
1060
            pb.finished()
 
1061
            raise
 
1062
        else:
 
1063
            pb.finished()
 
1064
 
 
1065
    def _do_copy_nodes_graph(self, index_map, writer, write_index,
 
1066
        output_lines, pb, readv_group_iter, total_items):
 
1067
        # for record verification
 
1068
        knit = KnitVersionedFiles(None, None)
 
1069
        # for line extraction when requested (inventories only)
 
1070
        if output_lines:
 
1071
            factory = KnitPlainFactory()
 
1072
        record_index = 0
 
1073
        pb.update("Copied record", record_index, total_items)
 
1074
        for index, readv_vector, node_vector in readv_group_iter:
 
1075
            # copy the data
 
1076
            pack_obj = index_map[index]
 
1077
            transport, path = pack_obj.access_tuple()
 
1078
            try:
 
1079
                reader = pack.make_readv_reader(transport, path, readv_vector)
 
1080
            except errors.NoSuchFile:
 
1081
                if self._reload_func is not None:
 
1082
                    self._reload_func()
 
1083
                raise
 
1084
            for (names, read_func), (key, eol_flag, references) in \
 
1085
                izip(reader.iter_records(), node_vector):
 
1086
                raw_data = read_func(None)
 
1087
                if output_lines:
 
1088
                    # read the entire thing
 
1089
                    content, _ = knit._parse_record(key[-1], raw_data)
 
1090
                    if len(references[-1]) == 0:
 
1091
                        line_iterator = factory.get_fulltext_content(content)
 
1092
                    else:
 
1093
                        line_iterator = factory.get_linedelta_content(content)
 
1094
                    for line in line_iterator:
 
1095
                        yield line, key
 
1096
                else:
 
1097
                    # check the header only
 
1098
                    df, _ = knit._parse_record_header(key, raw_data)
 
1099
                    df.close()
 
1100
                pos, size = writer.add_bytes_record(raw_data, names)
 
1101
                write_index.add_node(key, eol_flag + "%d %d" % (pos, size), references)
 
1102
                pb.update("Copied record", record_index)
 
1103
                record_index += 1
 
1104
 
 
1105
    def _get_text_nodes(self):
 
1106
        text_index_map, text_indices = self._pack_map_and_index_list(
 
1107
            'text_index')
 
1108
        return text_index_map, self._index_contents(text_indices,
 
1109
            self._text_filter)
 
1110
 
 
1111
    def _least_readv_node_readv(self, nodes):
 
1112
        """Generate request groups for nodes using the least readv's.
 
1113
 
 
1114
        :param nodes: An iterable of graph index nodes.
 
1115
        :return: Total node count and an iterator of the data needed to perform
 
1116
            readvs to obtain the data for nodes. Each item yielded by the
 
1117
            iterator is a tuple with:
 
1118
            index, readv_vector, node_vector. readv_vector is a list ready to
 
1119
            hand to the transport readv method, and node_vector is a list of
 
1120
            (key, eol_flag, references) for the node retrieved by the
 
1121
            matching readv_vector.
 
1122
        """
 
1123
        # group by pack so we do one readv per pack
 
1124
        nodes = sorted(nodes)
 
1125
        total = len(nodes)
 
1126
        request_groups = {}
 
1127
        for index, key, value, references in nodes:
 
1128
            if index not in request_groups:
 
1129
                request_groups[index] = []
 
1130
            request_groups[index].append((key, value, references))
 
1131
        result = []
 
1132
        for index, items in request_groups.iteritems():
 
1133
            pack_readv_requests = []
 
1134
            for key, value, references in items:
 
1135
                # ---- KnitGraphIndex.get_position
 
1136
                bits = value[1:].split(' ')
 
1137
                offset, length = int(bits[0]), int(bits[1])
 
1138
                pack_readv_requests.append(
 
1139
                    ((offset, length), (key, value[0], references)))
 
1140
            # linear scan up the pack to maximum range combining.
 
1141
            pack_readv_requests.sort()
 
1142
            # split out the readv and the node data.
 
1143
            pack_readv = [readv for readv, node in pack_readv_requests]
 
1144
            node_vector = [node for readv, node in pack_readv_requests]
 
1145
            result.append((index, pack_readv, node_vector))
 
1146
        return total, result
741
1147
 
742
1148
    def _log_copied_texts(self):
743
1149
        if 'pack' in debug.debug_flags:
747
1153
                self.new_pack.text_index.key_count(),
748
1154
                time.time() - self.new_pack.start_time)
749
1155
 
 
1156
    def _process_inventory_lines(self, inv_lines):
 
1157
        """Use up the inv_lines generator and setup a text key filter."""
 
1158
        repo = self._pack_collection.repo
 
1159
        fileid_revisions = repo._find_file_ids_from_xml_inventory_lines(
 
1160
            inv_lines, self.revision_keys)
 
1161
        text_filter = []
 
1162
        for fileid, file_revids in fileid_revisions.iteritems():
 
1163
            text_filter.extend([(fileid, file_revid) for file_revid in file_revids])
 
1164
        self._text_filter = text_filter
 
1165
 
 
1166
    def _revision_node_readv(self, revision_nodes):
 
1167
        """Return the total revisions and the readv's to issue.
 
1168
 
 
1169
        :param revision_nodes: The revision index contents for the packs being
 
1170
            incorporated into the new pack.
 
1171
        :return: As per _least_readv_node_readv.
 
1172
        """
 
1173
        return self._least_readv_node_readv(revision_nodes)
 
1174
 
750
1175
    def _use_pack(self, new_pack):
751
1176
        """Return True if new_pack should be used.
752
1177
 
756
1181
        return new_pack.data_inserted()
757
1182
 
758
1183
 
 
1184
class OptimisingPacker(Packer):
 
1185
    """A packer which spends more time to create better disk layouts."""
 
1186
 
 
1187
    def _revision_node_readv(self, revision_nodes):
 
1188
        """Return the total revisions and the readv's to issue.
 
1189
 
 
1190
        This sort places revisions in topological order with the ancestors
 
1191
        after the children.
 
1192
 
 
1193
        :param revision_nodes: The revision index contents for the packs being
 
1194
            incorporated into the new pack.
 
1195
        :return: As per _least_readv_node_readv.
 
1196
        """
 
1197
        # build an ancestors dict
 
1198
        ancestors = {}
 
1199
        by_key = {}
 
1200
        for index, key, value, references in revision_nodes:
 
1201
            ancestors[key] = references[0]
 
1202
            by_key[key] = (index, value, references)
 
1203
        order = tsort.topo_sort(ancestors)
 
1204
        total = len(order)
 
1205
        # Single IO is pathological, but it will work as a starting point.
 
1206
        requests = []
 
1207
        for key in reversed(order):
 
1208
            index, value, references = by_key[key]
 
1209
            # ---- KnitGraphIndex.get_position
 
1210
            bits = value[1:].split(' ')
 
1211
            offset, length = int(bits[0]), int(bits[1])
 
1212
            requests.append(
 
1213
                (index, [(offset, length)], [(key, value[0], references)]))
 
1214
        # TODO: combine requests in the same index that are in ascending order.
 
1215
        return total, requests
 
1216
 
 
1217
    def open_pack(self):
 
1218
        """Open a pack for the pack we are creating."""
 
1219
        new_pack = super(OptimisingPacker, self).open_pack()
 
1220
        # Turn on the optimization flags for all the index builders.
 
1221
        new_pack.revision_index.set_optimize(for_size=True)
 
1222
        new_pack.inventory_index.set_optimize(for_size=True)
 
1223
        new_pack.text_index.set_optimize(for_size=True)
 
1224
        new_pack.signature_index.set_optimize(for_size=True)
 
1225
        return new_pack
 
1226
 
 
1227
 
 
1228
class ReconcilePacker(Packer):
 
1229
    """A packer which regenerates indices etc as it copies.
 
1230
 
 
1231
    This is used by ``bzr reconcile`` to cause parent text pointers to be
 
1232
    regenerated.
 
1233
    """
 
1234
 
 
1235
    def _extra_init(self):
 
1236
        self._data_changed = False
 
1237
 
 
1238
    def _process_inventory_lines(self, inv_lines):
 
1239
        """Generate a text key reference map rather for reconciling with."""
 
1240
        repo = self._pack_collection.repo
 
1241
        refs = repo._find_text_key_references_from_xml_inventory_lines(
 
1242
            inv_lines)
 
1243
        self._text_refs = refs
 
1244
        # during reconcile we:
 
1245
        #  - convert unreferenced texts to full texts
 
1246
        #  - correct texts which reference a text not copied to be full texts
 
1247
        #  - copy all others as-is but with corrected parents.
 
1248
        #  - so at this point we don't know enough to decide what becomes a full
 
1249
        #    text.
 
1250
        self._text_filter = None
 
1251
 
 
1252
    def _copy_text_texts(self):
 
1253
        """generate what texts we should have and then copy."""
 
1254
        self.pb.update("Copying content texts", 3)
 
1255
        # we have three major tasks here:
 
1256
        # 1) generate the ideal index
 
1257
        repo = self._pack_collection.repo
 
1258
        ancestors = dict([(key[0], tuple(ref[0] for ref in refs[0])) for
 
1259
            _1, key, _2, refs in
 
1260
            self.new_pack.revision_index.iter_all_entries()])
 
1261
        ideal_index = repo._generate_text_key_index(self._text_refs, ancestors)
 
1262
        # 2) generate a text_nodes list that contains all the deltas that can
 
1263
        #    be used as-is, with corrected parents.
 
1264
        ok_nodes = []
 
1265
        bad_texts = []
 
1266
        discarded_nodes = []
 
1267
        NULL_REVISION = _mod_revision.NULL_REVISION
 
1268
        text_index_map, text_nodes = self._get_text_nodes()
 
1269
        for node in text_nodes:
 
1270
            # 0 - index
 
1271
            # 1 - key
 
1272
            # 2 - value
 
1273
            # 3 - refs
 
1274
            try:
 
1275
                ideal_parents = tuple(ideal_index[node[1]])
 
1276
            except KeyError:
 
1277
                discarded_nodes.append(node)
 
1278
                self._data_changed = True
 
1279
            else:
 
1280
                if ideal_parents == (NULL_REVISION,):
 
1281
                    ideal_parents = ()
 
1282
                if ideal_parents == node[3][0]:
 
1283
                    # no change needed.
 
1284
                    ok_nodes.append(node)
 
1285
                elif ideal_parents[0:1] == node[3][0][0:1]:
 
1286
                    # the left most parent is the same, or there are no parents
 
1287
                    # today. Either way, we can preserve the representation as
 
1288
                    # long as we change the refs to be inserted.
 
1289
                    self._data_changed = True
 
1290
                    ok_nodes.append((node[0], node[1], node[2],
 
1291
                        (ideal_parents, node[3][1])))
 
1292
                    self._data_changed = True
 
1293
                else:
 
1294
                    # Reinsert this text completely
 
1295
                    bad_texts.append((node[1], ideal_parents))
 
1296
                    self._data_changed = True
 
1297
        # we're finished with some data.
 
1298
        del ideal_index
 
1299
        del text_nodes
 
1300
        # 3) bulk copy the ok data
 
1301
        total_items, readv_group_iter = self._least_readv_node_readv(ok_nodes)
 
1302
        list(self._copy_nodes_graph(text_index_map, self.new_pack._writer,
 
1303
            self.new_pack.text_index, readv_group_iter, total_items))
 
1304
        # 4) adhoc copy all the other texts.
 
1305
        # We have to topologically insert all texts otherwise we can fail to
 
1306
        # reconcile when parts of a single delta chain are preserved intact,
 
1307
        # and other parts are not. E.g. Discarded->d1->d2->d3. d1 will be
 
1308
        # reinserted, and if d3 has incorrect parents it will also be
 
1309
        # reinserted. If we insert d3 first, d2 is present (as it was bulk
 
1310
        # copied), so we will try to delta, but d2 is not currently able to be
 
1311
        # extracted because it's basis d1 is not present. Topologically sorting
 
1312
        # addresses this. The following generates a sort for all the texts that
 
1313
        # are being inserted without having to reference the entire text key
 
1314
        # space (we only topo sort the revisions, which is smaller).
 
1315
        topo_order = tsort.topo_sort(ancestors)
 
1316
        rev_order = dict(zip(topo_order, range(len(topo_order))))
 
1317
        bad_texts.sort(key=lambda key:rev_order.get(key[0][1], 0))
 
1318
        transaction = repo.get_transaction()
 
1319
        file_id_index = GraphIndexPrefixAdapter(
 
1320
            self.new_pack.text_index,
 
1321
            ('blank', ), 1,
 
1322
            add_nodes_callback=self.new_pack.text_index.add_nodes)
 
1323
        data_access = _DirectPackAccess(
 
1324
                {self.new_pack.text_index:self.new_pack.access_tuple()})
 
1325
        data_access.set_writer(self.new_pack._writer, self.new_pack.text_index,
 
1326
            self.new_pack.access_tuple())
 
1327
        output_texts = KnitVersionedFiles(
 
1328
            _KnitGraphIndex(self.new_pack.text_index,
 
1329
                add_callback=self.new_pack.text_index.add_nodes,
 
1330
                deltas=True, parents=True, is_locked=repo.is_locked),
 
1331
            data_access=data_access, max_delta_chain=200)
 
1332
        for key, parent_keys in bad_texts:
 
1333
            # We refer to the new pack to delta data being output.
 
1334
            # A possible improvement would be to catch errors on short reads
 
1335
            # and only flush then.
 
1336
            self.new_pack.flush()
 
1337
            parents = []
 
1338
            for parent_key in parent_keys:
 
1339
                if parent_key[0] != key[0]:
 
1340
                    # Graph parents must match the fileid
 
1341
                    raise errors.BzrError('Mismatched key parent %r:%r' %
 
1342
                        (key, parent_keys))
 
1343
                parents.append(parent_key[1])
 
1344
            text_lines = osutils.split_lines(repo.texts.get_record_stream(
 
1345
                [key], 'unordered', True).next().get_bytes_as('fulltext'))
 
1346
            output_texts.add_lines(key, parent_keys, text_lines,
 
1347
                random_id=True, check_content=False)
 
1348
        # 5) check that nothing inserted has a reference outside the keyspace.
 
1349
        missing_text_keys = self.new_pack.text_index._external_references()
 
1350
        if missing_text_keys:
 
1351
            raise errors.BzrCheckError('Reference to missing compression parents %r'
 
1352
                % (missing_text_keys,))
 
1353
        self._log_copied_texts()
 
1354
 
 
1355
    def _use_pack(self, new_pack):
 
1356
        """Override _use_pack to check for reconcile having changed content."""
 
1357
        # XXX: we might be better checking this at the copy time.
 
1358
        original_inventory_keys = set()
 
1359
        inv_index = self._pack_collection.inventory_index.combined_index
 
1360
        for entry in inv_index.iter_all_entries():
 
1361
            original_inventory_keys.add(entry[1])
 
1362
        new_inventory_keys = set()
 
1363
        for entry in new_pack.inventory_index.iter_all_entries():
 
1364
            new_inventory_keys.add(entry[1])
 
1365
        if new_inventory_keys != original_inventory_keys:
 
1366
            self._data_changed = True
 
1367
        return new_pack.data_inserted() and self._data_changed
 
1368
 
 
1369
 
759
1370
class RepositoryPackCollection(object):
760
1371
    """Management of packs within a repository.
761
1372
 
762
1373
    :ivar _names: map of {pack_name: (index_size,)}
763
1374
    """
764
1375
 
765
 
    pack_factory = None
766
 
    resumed_pack_factory = None
767
 
    normal_packer_class = None
768
 
    optimising_packer_class = None
 
1376
    pack_factory = NewPack
 
1377
    resumed_pack_factory = ResumedPack
769
1378
 
770
1379
    def __init__(self, repo, transport, index_transport, upload_transport,
771
1380
                 pack_transport, index_builder_class, index_class,
806
1415
        self.inventory_index = AggregateIndex(self.reload_pack_names, flush)
807
1416
        self.text_index = AggregateIndex(self.reload_pack_names, flush)
808
1417
        self.signature_index = AggregateIndex(self.reload_pack_names, flush)
809
 
        all_indices = [self.revision_index, self.inventory_index,
810
 
                self.text_index, self.signature_index]
811
1418
        if use_chk_index:
812
1419
            self.chk_index = AggregateIndex(self.reload_pack_names, flush)
813
 
            all_indices.append(self.chk_index)
814
1420
        else:
815
1421
            # used to determine if we're using a chk_index elsewhere.
816
1422
            self.chk_index = None
817
 
        # Tell all the CombinedGraphIndex objects about each other, so they can
818
 
        # share hints about which pack names to search first.
819
 
        all_combined = [agg_idx.combined_index for agg_idx in all_indices]
820
 
        for combined_idx in all_combined:
821
 
            combined_idx.set_sibling_indices(
822
 
                set(all_combined).difference([combined_idx]))
823
1423
        # resumed packs
824
1424
        self._resumed_packs = []
825
1425
 
912
1512
            'containing %d revisions. Packing %d files into %d affecting %d'
913
1513
            ' revisions', self, total_packs, total_revisions, num_old_packs,
914
1514
            num_new_packs, num_revs_affected)
915
 
        result = self._execute_pack_operations(pack_operations, packer_class=self.normal_packer_class,
 
1515
        result = self._execute_pack_operations(pack_operations,
916
1516
                                      reload_func=self._restart_autopack)
917
1517
        mutter('Auto-packing repository %s completed', self)
918
1518
        return result
919
1519
 
920
 
    def _execute_pack_operations(self, pack_operations, packer_class,
921
 
            reload_func=None):
 
1520
    def _execute_pack_operations(self, pack_operations, _packer_class=Packer,
 
1521
                                 reload_func=None):
922
1522
        """Execute a series of pack operations.
923
1523
 
924
1524
        :param pack_operations: A list of [revision_count, packs_to_combine].
925
 
        :param packer_class: The class of packer to use
 
1525
        :param _packer_class: The class of packer to use (default: Packer).
926
1526
        :return: The new pack names.
927
1527
        """
928
1528
        for revision_count, packs in pack_operations:
929
1529
            # we may have no-ops from the setup logic
930
1530
            if len(packs) == 0:
931
1531
                continue
932
 
            packer = packer_class(self, packs, '.autopack',
 
1532
            packer = _packer_class(self, packs, '.autopack',
933
1533
                                   reload_func=reload_func)
934
1534
            try:
935
 
                result = packer.pack()
 
1535
                packer.pack()
936
1536
            except errors.RetryWithNewPacks:
937
1537
                # An exception is propagating out of this context, make sure
938
1538
                # this packer has cleaned up. Packer() doesn't set its new_pack
941
1541
                if packer.new_pack is not None:
942
1542
                    packer.new_pack.abort()
943
1543
                raise
944
 
            if result is None:
945
 
                return
946
1544
            for pack in packs:
947
1545
                self._remove_pack_from_memory(pack)
948
1546
        # record the newly available packs and stop advertising the old
970
1568
        """Is the collection already packed?"""
971
1569
        return not (self.repo._format.pack_compresses or (len(self._names) > 1))
972
1570
 
973
 
    def pack(self, hint=None, clean_obsolete_packs=False):
 
1571
    def pack(self, hint=None):
974
1572
        """Pack the pack collection totally."""
975
1573
        self.ensure_loaded()
976
1574
        total_packs = len(self._names)
982
1580
        mutter('Packing repository %s, which has %d pack files, '
983
1581
            'containing %d revisions with hint %r.', self, total_packs,
984
1582
            total_revisions, hint)
985
 
        while True:
986
 
            try:
987
 
                self._try_pack_operations(hint)
988
 
            except RetryPackOperations:
989
 
                continue
990
 
            break
991
 
 
992
 
        if clean_obsolete_packs:
993
 
            self._clear_obsolete_packs()
994
 
 
995
 
    def _try_pack_operations(self, hint):
996
 
        """Calculate the pack operations based on the hint (if any), and
997
 
        execute them.
998
 
        """
999
1583
        # determine which packs need changing
1000
1584
        pack_operations = [[0, []]]
1001
1585
        for pack in self.all_packs():
1004
1588
                # or this pack was included in the hint.
1005
1589
                pack_operations[-1][0] += pack.get_revision_count()
1006
1590
                pack_operations[-1][1].append(pack)
1007
 
        self._execute_pack_operations(pack_operations,
1008
 
            packer_class=self.optimising_packer_class,
1009
 
            reload_func=self._restart_pack_operations)
 
1591
        self._execute_pack_operations(pack_operations, OptimisingPacker)
1010
1592
 
1011
1593
    def plan_autopack_combinations(self, existing_packs, pack_distribution):
1012
1594
        """Plan a pack operation.
1022
1604
        pack_operations = [[0, []]]
1023
1605
        # plan out what packs to keep, and what to reorganise
1024
1606
        while len(existing_packs):
1025
 
            # take the largest pack, and if it's less than the head of the
 
1607
            # take the largest pack, and if its less than the head of the
1026
1608
            # distribution chart we will include its contents in the new pack
1027
 
            # for that position. If it's larger, we remove its size from the
 
1609
            # for that position. If its larger, we remove its size from the
1028
1610
            # distribution chart
1029
1611
            next_pack_rev_count, next_pack = existing_packs.pop(0)
1030
1612
            if next_pack_rev_count >= pack_distribution[0]:
1065
1647
 
1066
1648
        :return: True if the disk names had not been previously read.
1067
1649
        """
1068
 
        # NB: if you see an assertion error here, it's probably access against
 
1650
        # NB: if you see an assertion error here, its probably access against
1069
1651
        # an unlocked repo. Naughty.
1070
1652
        if not self.repo.is_locked():
1071
1653
            raise errors.ObjectNotLocked(self.repo)
1101
1683
            txt_index = self._make_index(name, '.tix')
1102
1684
            sig_index = self._make_index(name, '.six')
1103
1685
            if self.chk_index is not None:
1104
 
                chk_index = self._make_index(name, '.cix', is_chk=True)
 
1686
                chk_index = self._make_index(name, '.cix', unlimited_cache=True)
1105
1687
            else:
1106
1688
                chk_index = None
1107
1689
            result = ExistingPack(self._pack_transport, name, rev_index,
1127
1709
            sig_index = self._make_index(name, '.six', resume=True)
1128
1710
            if self.chk_index is not None:
1129
1711
                chk_index = self._make_index(name, '.cix', resume=True,
1130
 
                                             is_chk=True)
 
1712
                                             unlimited_cache=True)
1131
1713
            else:
1132
1714
                chk_index = None
1133
1715
            result = self.resumed_pack_factory(name, rev_index, inv_index,
1163
1745
        return self._index_class(self.transport, 'pack-names', None
1164
1746
                ).iter_all_entries()
1165
1747
 
1166
 
    def _make_index(self, name, suffix, resume=False, is_chk=False):
 
1748
    def _make_index(self, name, suffix, resume=False, unlimited_cache=False):
1167
1749
        size_offset = self._suffix_offsets[suffix]
1168
1750
        index_name = name + suffix
1169
1751
        if resume:
1172
1754
        else:
1173
1755
            transport = self._index_transport
1174
1756
            index_size = self._names[name][size_offset]
1175
 
        index = self._index_class(transport, index_name, index_size,
1176
 
                                  unlimited_cache=is_chk)
1177
 
        if is_chk and self._index_class is btree_index.BTreeGraphIndex: 
1178
 
            index._leaf_factory = btree_index._gcchk_factory
1179
 
        return index
 
1757
        return self._index_class(transport, index_name, index_size,
 
1758
                                 unlimited_cache=unlimited_cache)
1180
1759
 
1181
1760
    def _max_pack_count(self, total_revisions):
1182
1761
        """Return the maximum number of packs to use for total revisions.
1211
1790
        """
1212
1791
        for pack in packs:
1213
1792
            try:
1214
 
                pack.pack_transport.move(pack.file_name(),
 
1793
                pack.pack_transport.rename(pack.file_name(),
1215
1794
                    '../obsolete_packs/' + pack.file_name())
1216
1795
            except (errors.PathError, errors.TransportError), e:
1217
1796
                # TODO: Should these be warnings or mutters?
1225
1804
                suffixes.append('.cix')
1226
1805
            for suffix in suffixes:
1227
1806
                try:
1228
 
                    self._index_transport.move(pack.name + suffix,
 
1807
                    self._index_transport.rename(pack.name + suffix,
1229
1808
                        '../obsolete_packs/' + pack.name + suffix)
1230
1809
                except (errors.PathError, errors.TransportError), e:
1231
1810
                    mutter("couldn't rename obsolete index, skipping it:\n%s"
1368
1947
                    # disk index because the set values are the same, unless
1369
1948
                    # the only index shows up as deleted by the set difference
1370
1949
                    # - which it may. Until there is a specific test for this,
1371
 
                    # assume it's broken. RBC 20071017.
 
1950
                    # assume its broken. RBC 20071017.
1372
1951
                    self._remove_pack_from_memory(self.get_pack_by_name(name))
1373
1952
                    self._names[name] = sizes
1374
1953
                    self.get_pack_by_name(name)
1439
2018
        """
1440
2019
        # The ensure_loaded call is to handle the case where the first call
1441
2020
        # made involving the collection was to reload_pack_names, where we 
1442
 
        # don't have a view of disk contents. It's a bit of a bandaid, and
1443
 
        # causes two reads of pack-names, but it's a rare corner case not
1444
 
        # struck with regular push/pull etc.
 
2021
        # don't have a view of disk contents. Its a bit of a bandaid, and
 
2022
        # causes two reads of pack-names, but its a rare corner case not struck
 
2023
        # with regular push/pull etc.
1445
2024
        first_read = self.ensure_loaded()
1446
2025
        if first_read:
1447
2026
            return True
1466
2045
            raise
1467
2046
        raise errors.RetryAutopack(self.repo, False, sys.exc_info())
1468
2047
 
1469
 
    def _restart_pack_operations(self):
1470
 
        """Reload the pack names list, and restart the autopack code."""
1471
 
        if not self.reload_pack_names():
1472
 
            # Re-raise the original exception, because something went missing
1473
 
            # and a restart didn't find it
1474
 
            raise
1475
 
        raise RetryPackOperations(self.repo, False, sys.exc_info())
1476
 
 
1477
2048
    def _clear_obsolete_packs(self, preserve=None):
1478
2049
        """Delete everything from the obsolete-packs directory.
1479
2050
 
1627
2198
            self._resume_pack(token)
1628
2199
 
1629
2200
 
1630
 
class PackRepository(MetaDirVersionedFileRepository):
 
2201
class KnitPackRepository(KnitRepository):
1631
2202
    """Repository with knit objects stored inside pack containers.
1632
2203
 
1633
2204
    The layering for a KnitPackRepository is:
1636
2207
    ===================================================
1637
2208
    Tuple based apis below, string based, and key based apis above
1638
2209
    ---------------------------------------------------
1639
 
    VersionedFiles
 
2210
    KnitVersionedFiles
1640
2211
      Provides .texts, .revisions etc
1641
2212
      This adapts the N-tuple keys to physical knit records which only have a
1642
2213
      single string identifier (for historical reasons), which in older formats
1652
2223
 
1653
2224
    """
1654
2225
 
1655
 
    # These attributes are inherited from the Repository base class. Setting
1656
 
    # them to None ensures that if the constructor is changed to not initialize
1657
 
    # them, or a subclass fails to call the constructor, that an error will
1658
 
    # occur rather than the system working but generating incorrect data.
1659
 
    _commit_builder_class = None
1660
 
    _serializer = None
1661
 
 
1662
2226
    def __init__(self, _format, a_bzrdir, control_files, _commit_builder_class,
1663
2227
        _serializer):
1664
 
        MetaDirRepository.__init__(self, _format, a_bzrdir, control_files)
1665
 
        self._commit_builder_class = _commit_builder_class
1666
 
        self._serializer = _serializer
 
2228
        KnitRepository.__init__(self, _format, a_bzrdir, control_files,
 
2229
            _commit_builder_class, _serializer)
 
2230
        index_transport = self._transport.clone('indices')
 
2231
        self._pack_collection = RepositoryPackCollection(self, self._transport,
 
2232
            index_transport,
 
2233
            self._transport.clone('upload'),
 
2234
            self._transport.clone('packs'),
 
2235
            _format.index_builder_class,
 
2236
            _format.index_class,
 
2237
            use_chk_index=self._format.supports_chks,
 
2238
            )
 
2239
        self.inventories = KnitVersionedFiles(
 
2240
            _KnitGraphIndex(self._pack_collection.inventory_index.combined_index,
 
2241
                add_callback=self._pack_collection.inventory_index.add_callback,
 
2242
                deltas=True, parents=True, is_locked=self.is_locked),
 
2243
            data_access=self._pack_collection.inventory_index.data_access,
 
2244
            max_delta_chain=200)
 
2245
        self.revisions = KnitVersionedFiles(
 
2246
            _KnitGraphIndex(self._pack_collection.revision_index.combined_index,
 
2247
                add_callback=self._pack_collection.revision_index.add_callback,
 
2248
                deltas=False, parents=True, is_locked=self.is_locked,
 
2249
                track_external_parent_refs=True),
 
2250
            data_access=self._pack_collection.revision_index.data_access,
 
2251
            max_delta_chain=0)
 
2252
        self.signatures = KnitVersionedFiles(
 
2253
            _KnitGraphIndex(self._pack_collection.signature_index.combined_index,
 
2254
                add_callback=self._pack_collection.signature_index.add_callback,
 
2255
                deltas=False, parents=False, is_locked=self.is_locked),
 
2256
            data_access=self._pack_collection.signature_index.data_access,
 
2257
            max_delta_chain=0)
 
2258
        self.texts = KnitVersionedFiles(
 
2259
            _KnitGraphIndex(self._pack_collection.text_index.combined_index,
 
2260
                add_callback=self._pack_collection.text_index.add_callback,
 
2261
                deltas=True, parents=True, is_locked=self.is_locked),
 
2262
            data_access=self._pack_collection.text_index.data_access,
 
2263
            max_delta_chain=200)
 
2264
        if _format.supports_chks:
 
2265
            # No graph, no compression:- references from chks are between
 
2266
            # different objects not temporal versions of the same; and without
 
2267
            # some sort of temporal structure knit compression will just fail.
 
2268
            self.chk_bytes = KnitVersionedFiles(
 
2269
                _KnitGraphIndex(self._pack_collection.chk_index.combined_index,
 
2270
                    add_callback=self._pack_collection.chk_index.add_callback,
 
2271
                    deltas=False, parents=False, is_locked=self.is_locked),
 
2272
                data_access=self._pack_collection.chk_index.data_access,
 
2273
                max_delta_chain=0)
 
2274
        else:
 
2275
            self.chk_bytes = None
 
2276
        # True when the repository object is 'write locked' (as opposed to the
 
2277
        # physical lock only taken out around changes to the pack-names list.)
 
2278
        # Another way to represent this would be a decorator around the control
 
2279
        # files object that presents logical locks as physical ones - if this
 
2280
        # gets ugly consider that alternative design. RBC 20071011
 
2281
        self._write_lock_count = 0
 
2282
        self._transaction = None
 
2283
        # for tests
 
2284
        self._reconcile_does_inventory_gc = True
1667
2285
        self._reconcile_fixes_text_parents = True
1668
 
        if self._format.supports_external_lookups:
1669
 
            self._unstacked_provider = graph.CachingParentsProvider(
1670
 
                self._make_parents_provider_unstacked())
1671
 
        else:
1672
 
            self._unstacked_provider = graph.CachingParentsProvider(self)
1673
 
        self._unstacked_provider.disable_cache()
 
2286
        self._reconcile_backsup_inventory = False
1674
2287
 
1675
 
    @needs_read_lock
1676
 
    def _all_revision_ids(self):
1677
 
        """See Repository.all_revision_ids()."""
1678
 
        return [key[0] for key in self.revisions.keys()]
 
2288
    def _warn_if_deprecated(self, branch=None):
 
2289
        # This class isn't deprecated, but one sub-format is
 
2290
        if isinstance(self._format, RepositoryFormatKnitPack5RichRootBroken):
 
2291
            super(KnitPackRepository, self)._warn_if_deprecated(branch)
1679
2292
 
1680
2293
    def _abort_write_group(self):
1681
2294
        self.revisions._index._key_dependencies.clear()
1682
2295
        self._pack_collection._abort_write_group()
1683
2296
 
 
2297
    def _get_source(self, to_format):
 
2298
        if to_format.network_name() == self._format.network_name():
 
2299
            return KnitPackStreamSource(self, to_format)
 
2300
        return super(KnitPackRepository, self)._get_source(to_format)
 
2301
 
1684
2302
    def _make_parents_provider(self):
1685
 
        if not self._format.supports_external_lookups:
1686
 
            return self._unstacked_provider
1687
 
        return graph.StackedParentsProvider(_LazyListJoin(
1688
 
            [self._unstacked_provider], self._fallback_repositories))
 
2303
        return graph.CachingParentsProvider(self)
1689
2304
 
1690
2305
    def _refresh_data(self):
1691
2306
        if not self.is_locked():
1692
2307
            return
1693
2308
        self._pack_collection.reload_pack_names()
1694
 
        self._unstacked_provider.disable_cache()
1695
 
        self._unstacked_provider.enable_cache()
1696
2309
 
1697
2310
    def _start_write_group(self):
1698
2311
        self._pack_collection._start_write_group()
1700
2313
    def _commit_write_group(self):
1701
2314
        hint = self._pack_collection._commit_write_group()
1702
2315
        self.revisions._index._key_dependencies.clear()
1703
 
        # The commit may have added keys that were previously cached as
1704
 
        # missing, so reset the cache.
1705
 
        self._unstacked_provider.disable_cache()
1706
 
        self._unstacked_provider.enable_cache()
1707
2316
        return hint
1708
2317
 
1709
2318
    def suspend_write_group(self):
1736
2345
        return self._write_lock_count
1737
2346
 
1738
2347
    def lock_write(self, token=None):
1739
 
        """Lock the repository for writes.
1740
 
 
1741
 
        :return: A bzrlib.repository.RepositoryWriteLockResult.
1742
 
        """
1743
2348
        locked = self.is_locked()
1744
2349
        if not self._write_lock_count and locked:
1745
2350
            raise errors.ReadOnlyError(self)
1750
2355
            if 'relock' in debug.debug_flags and self._prev_lock == 'w':
1751
2356
                note('%r was write locked again', self)
1752
2357
            self._prev_lock = 'w'
1753
 
            self._unstacked_provider.enable_cache()
1754
2358
            for repo in self._fallback_repositories:
1755
2359
                # Writes don't affect fallback repos
1756
2360
                repo.lock_read()
1757
2361
            self._refresh_data()
1758
 
        return RepositoryWriteLockResult(self.unlock, None)
1759
2362
 
1760
2363
    def lock_read(self):
1761
 
        """Lock the repository for reads.
1762
 
 
1763
 
        :return: A bzrlib.lock.LogicalLockResult.
1764
 
        """
1765
2364
        locked = self.is_locked()
1766
2365
        if self._write_lock_count:
1767
2366
            self._write_lock_count += 1
1771
2370
            if 'relock' in debug.debug_flags and self._prev_lock == 'r':
1772
2371
                note('%r was read locked again', self)
1773
2372
            self._prev_lock = 'r'
1774
 
            self._unstacked_provider.enable_cache()
1775
2373
            for repo in self._fallback_repositories:
1776
2374
                repo.lock_read()
1777
2375
            self._refresh_data()
1778
 
        return LogicalLockResult(self.unlock)
1779
2376
 
1780
2377
    def leave_lock_in_place(self):
1781
2378
        # not supported - raise an error
1786
2383
        raise NotImplementedError(self.dont_leave_lock_in_place)
1787
2384
 
1788
2385
    @needs_write_lock
1789
 
    def pack(self, hint=None, clean_obsolete_packs=False):
 
2386
    def pack(self, hint=None):
1790
2387
        """Compress the data within the repository.
1791
2388
 
1792
2389
        This will pack all the data to a single pack. In future it may
1793
2390
        recompress deltas or do other such expensive operations.
1794
2391
        """
1795
 
        self._pack_collection.pack(hint=hint, clean_obsolete_packs=clean_obsolete_packs)
 
2392
        self._pack_collection.pack(hint=hint)
1796
2393
 
1797
2394
    @needs_write_lock
1798
2395
    def reconcile(self, other=None, thorough=False):
1803
2400
        return reconciler
1804
2401
 
1805
2402
    def _reconcile_pack(self, collection, packs, extension, revs, pb):
1806
 
        raise NotImplementedError(self._reconcile_pack)
 
2403
        packer = ReconcilePacker(collection, packs, extension, revs)
 
2404
        return packer.pack(pb)
1807
2405
 
1808
2406
    @only_raises(errors.LockNotHeld, errors.LockBroken)
1809
2407
    def unlock(self):
1810
2408
        if self._write_lock_count == 1 and self._write_group is not None:
1811
2409
            self.abort_write_group()
1812
 
            self._unstacked_provider.disable_cache()
1813
2410
            self._transaction = None
1814
2411
            self._write_lock_count = 0
1815
2412
            raise errors.BzrError(
1825
2422
            self.control_files.unlock()
1826
2423
 
1827
2424
        if not self.is_locked():
1828
 
            self._unstacked_provider.disable_cache()
1829
2425
            for repo in self._fallback_repositories:
1830
2426
                repo.unlock()
1831
2427
 
1832
2428
 
1833
 
class RepositoryFormatPack(MetaDirVersionedFileRepositoryFormat):
 
2429
class KnitPackStreamSource(StreamSource):
 
2430
    """A StreamSource used to transfer data between same-format KnitPack repos.
 
2431
 
 
2432
    This source assumes:
 
2433
        1) Same serialization format for all objects
 
2434
        2) Same root information
 
2435
        3) XML format inventories
 
2436
        4) Atomic inserts (so we can stream inventory texts before text
 
2437
           content)
 
2438
        5) No chk_bytes
 
2439
    """
 
2440
 
 
2441
    def __init__(self, from_repository, to_format):
 
2442
        super(KnitPackStreamSource, self).__init__(from_repository, to_format)
 
2443
        self._text_keys = None
 
2444
        self._text_fetch_order = 'unordered'
 
2445
 
 
2446
    def _get_filtered_inv_stream(self, revision_ids):
 
2447
        from_repo = self.from_repository
 
2448
        parent_ids = from_repo._find_parent_ids_of_revisions(revision_ids)
 
2449
        parent_keys = [(p,) for p in parent_ids]
 
2450
        find_text_keys = from_repo._find_text_key_references_from_xml_inventory_lines
 
2451
        parent_text_keys = set(find_text_keys(
 
2452
            from_repo._inventory_xml_lines_for_keys(parent_keys)))
 
2453
        content_text_keys = set()
 
2454
        knit = KnitVersionedFiles(None, None)
 
2455
        factory = KnitPlainFactory()
 
2456
        def find_text_keys_from_content(record):
 
2457
            if record.storage_kind not in ('knit-delta-gz', 'knit-ft-gz'):
 
2458
                raise ValueError("Unknown content storage kind for"
 
2459
                    " inventory text: %s" % (record.storage_kind,))
 
2460
            # It's a knit record, it has a _raw_record field (even if it was
 
2461
            # reconstituted from a network stream).
 
2462
            raw_data = record._raw_record
 
2463
            # read the entire thing
 
2464
            revision_id = record.key[-1]
 
2465
            content, _ = knit._parse_record(revision_id, raw_data)
 
2466
            if record.storage_kind == 'knit-delta-gz':
 
2467
                line_iterator = factory.get_linedelta_content(content)
 
2468
            elif record.storage_kind == 'knit-ft-gz':
 
2469
                line_iterator = factory.get_fulltext_content(content)
 
2470
            content_text_keys.update(find_text_keys(
 
2471
                [(line, revision_id) for line in line_iterator]))
 
2472
        revision_keys = [(r,) for r in revision_ids]
 
2473
        def _filtered_inv_stream():
 
2474
            source_vf = from_repo.inventories
 
2475
            stream = source_vf.get_record_stream(revision_keys,
 
2476
                                                 'unordered', False)
 
2477
            for record in stream:
 
2478
                if record.storage_kind == 'absent':
 
2479
                    raise errors.NoSuchRevision(from_repo, record.key)
 
2480
                find_text_keys_from_content(record)
 
2481
                yield record
 
2482
            self._text_keys = content_text_keys - parent_text_keys
 
2483
        return ('inventories', _filtered_inv_stream())
 
2484
 
 
2485
    def _get_text_stream(self):
 
2486
        # Note: We know we don't have to handle adding root keys, because both
 
2487
        # the source and target are the identical network name.
 
2488
        text_stream = self.from_repository.texts.get_record_stream(
 
2489
                        self._text_keys, self._text_fetch_order, False)
 
2490
        return ('texts', text_stream)
 
2491
 
 
2492
    def get_stream(self, search):
 
2493
        revision_ids = search.get_keys()
 
2494
        for stream_info in self._fetch_revision_texts(revision_ids):
 
2495
            yield stream_info
 
2496
        self._revision_keys = [(rev_id,) for rev_id in revision_ids]
 
2497
        yield self._get_filtered_inv_stream(revision_ids)
 
2498
        yield self._get_text_stream()
 
2499
 
 
2500
 
 
2501
 
 
2502
class RepositoryFormatPack(MetaDirRepositoryFormat):
1834
2503
    """Format logic for pack structured repositories.
1835
2504
 
1836
2505
    This repository format has:
1866
2535
    index_class = None
1867
2536
    _fetch_uses_deltas = True
1868
2537
    fast_deltas = False
1869
 
    supports_funky_characters = True
1870
 
    revision_graph_can_have_wrong_parents = True
1871
2538
 
1872
2539
    def initialize(self, a_bzrdir, shared=False):
1873
2540
        """Create a pack based repository.
1884
2551
        utf8_files = [('format', self.get_format_string())]
1885
2552
 
1886
2553
        self._upload_blank_content(a_bzrdir, dirs, files, utf8_files, shared)
1887
 
        repository = self.open(a_bzrdir=a_bzrdir, _found=True)
1888
 
        self._run_post_repo_init_hooks(repository, a_bzrdir, shared)
1889
 
        return repository
 
2554
        return self.open(a_bzrdir=a_bzrdir, _found=True)
1890
2555
 
1891
2556
    def open(self, a_bzrdir, _found=False, _override_transport=None):
1892
2557
        """See RepositoryFormat.open().
1910
2575
                              _serializer=self._serializer)
1911
2576
 
1912
2577
 
1913
 
class RetryPackOperations(errors.RetryWithNewPacks):
1914
 
    """Raised when we are packing and we find a missing file.
1915
 
 
1916
 
    Meant as a signaling exception, to tell the RepositoryPackCollection.pack
1917
 
    code it should try again.
1918
 
    """
1919
 
 
1920
 
    internal_error = True
1921
 
 
1922
 
    _fmt = ("Pack files have changed, reload and try pack again."
1923
 
            " context: %(context)s %(orig_error)s")
1924
 
 
1925
 
 
1926
 
class _DirectPackAccess(object):
1927
 
    """Access to data in one or more packs with less translation."""
1928
 
 
1929
 
    def __init__(self, index_to_packs, reload_func=None, flush_func=None):
1930
 
        """Create a _DirectPackAccess object.
1931
 
 
1932
 
        :param index_to_packs: A dict mapping index objects to the transport
1933
 
            and file names for obtaining data.
1934
 
        :param reload_func: A function to call if we determine that the pack
1935
 
            files have moved and we need to reload our caches. See
1936
 
            bzrlib.repo_fmt.pack_repo.AggregateIndex for more details.
1937
 
        """
1938
 
        self._container_writer = None
1939
 
        self._write_index = None
1940
 
        self._indices = index_to_packs
1941
 
        self._reload_func = reload_func
1942
 
        self._flush_func = flush_func
1943
 
 
1944
 
    def add_raw_records(self, key_sizes, raw_data):
1945
 
        """Add raw knit bytes to a storage area.
1946
 
 
1947
 
        The data is spooled to the container writer in one bytes-record per
1948
 
        raw data item.
1949
 
 
1950
 
        :param sizes: An iterable of tuples containing the key and size of each
1951
 
            raw data segment.
1952
 
        :param raw_data: A bytestring containing the data.
1953
 
        :return: A list of memos to retrieve the record later. Each memo is an
1954
 
            opaque index memo. For _DirectPackAccess the memo is (index, pos,
1955
 
            length), where the index field is the write_index object supplied
1956
 
            to the PackAccess object.
1957
 
        """
1958
 
        if type(raw_data) is not str:
1959
 
            raise AssertionError(
1960
 
                'data must be plain bytes was %s' % type(raw_data))
1961
 
        result = []
1962
 
        offset = 0
1963
 
        for key, size in key_sizes:
1964
 
            p_offset, p_length = self._container_writer.add_bytes_record(
1965
 
                raw_data[offset:offset+size], [])
1966
 
            offset += size
1967
 
            result.append((self._write_index, p_offset, p_length))
1968
 
        return result
1969
 
 
1970
 
    def flush(self):
1971
 
        """Flush pending writes on this access object.
1972
 
 
1973
 
        This will flush any buffered writes to a NewPack.
1974
 
        """
1975
 
        if self._flush_func is not None:
1976
 
            self._flush_func()
1977
 
 
1978
 
    def get_raw_records(self, memos_for_retrieval):
1979
 
        """Get the raw bytes for a records.
1980
 
 
1981
 
        :param memos_for_retrieval: An iterable containing the (index, pos,
1982
 
            length) memo for retrieving the bytes. The Pack access method
1983
 
            looks up the pack to use for a given record in its index_to_pack
1984
 
            map.
1985
 
        :return: An iterator over the bytes of the records.
1986
 
        """
1987
 
        # first pass, group into same-index requests
1988
 
        request_lists = []
1989
 
        current_index = None
1990
 
        for (index, offset, length) in memos_for_retrieval:
1991
 
            if current_index == index:
1992
 
                current_list.append((offset, length))
1993
 
            else:
1994
 
                if current_index is not None:
1995
 
                    request_lists.append((current_index, current_list))
1996
 
                current_index = index
1997
 
                current_list = [(offset, length)]
1998
 
        # handle the last entry
1999
 
        if current_index is not None:
2000
 
            request_lists.append((current_index, current_list))
2001
 
        for index, offsets in request_lists:
2002
 
            try:
2003
 
                transport, path = self._indices[index]
2004
 
            except KeyError:
2005
 
                # A KeyError here indicates that someone has triggered an index
2006
 
                # reload, and this index has gone missing, we need to start
2007
 
                # over.
2008
 
                if self._reload_func is None:
2009
 
                    # If we don't have a _reload_func there is nothing that can
2010
 
                    # be done
2011
 
                    raise
2012
 
                raise errors.RetryWithNewPacks(index,
2013
 
                                               reload_occurred=True,
2014
 
                                               exc_info=sys.exc_info())
2015
 
            try:
2016
 
                reader = pack.make_readv_reader(transport, path, offsets)
2017
 
                for names, read_func in reader.iter_records():
2018
 
                    yield read_func(None)
2019
 
            except errors.NoSuchFile:
2020
 
                # A NoSuchFile error indicates that a pack file has gone
2021
 
                # missing on disk, we need to trigger a reload, and start over.
2022
 
                if self._reload_func is None:
2023
 
                    raise
2024
 
                raise errors.RetryWithNewPacks(transport.abspath(path),
2025
 
                                               reload_occurred=False,
2026
 
                                               exc_info=sys.exc_info())
2027
 
 
2028
 
    def set_writer(self, writer, index, transport_packname):
2029
 
        """Set a writer to use for adding data."""
2030
 
        if index is not None:
2031
 
            self._indices[index] = transport_packname
2032
 
        self._container_writer = writer
2033
 
        self._write_index = index
2034
 
 
2035
 
    def reload_or_raise(self, retry_exc):
2036
 
        """Try calling the reload function, or re-raise the original exception.
2037
 
 
2038
 
        This should be called after _DirectPackAccess raises a
2039
 
        RetryWithNewPacks exception. This function will handle the common logic
2040
 
        of determining when the error is fatal versus being temporary.
2041
 
        It will also make sure that the original exception is raised, rather
2042
 
        than the RetryWithNewPacks exception.
2043
 
 
2044
 
        If this function returns, then the calling function should retry
2045
 
        whatever operation was being performed. Otherwise an exception will
2046
 
        be raised.
2047
 
 
2048
 
        :param retry_exc: A RetryWithNewPacks exception.
2049
 
        """
2050
 
        is_error = False
2051
 
        if self._reload_func is None:
2052
 
            is_error = True
2053
 
        elif not self._reload_func():
2054
 
            # The reload claimed that nothing changed
2055
 
            if not retry_exc.reload_occurred:
2056
 
                # If there wasn't an earlier reload, then we really were
2057
 
                # expecting to find changes. We didn't find them, so this is a
2058
 
                # hard error
2059
 
                is_error = True
2060
 
        if is_error:
2061
 
            exc_class, exc_value, exc_traceback = retry_exc.exc_info
2062
 
            raise exc_class, exc_value, exc_traceback
2063
 
 
2064
 
 
 
2578
class RepositoryFormatKnitPack1(RepositoryFormatPack):
 
2579
    """A no-subtrees parameterized Pack repository.
 
2580
 
 
2581
    This format was introduced in 0.92.
 
2582
    """
 
2583
 
 
2584
    repository_class = KnitPackRepository
 
2585
    _commit_builder_class = PackCommitBuilder
 
2586
    @property
 
2587
    def _serializer(self):
 
2588
        return xml5.serializer_v5
 
2589
    # What index classes to use
 
2590
    index_builder_class = InMemoryGraphIndex
 
2591
    index_class = GraphIndex
 
2592
 
 
2593
    def _get_matching_bzrdir(self):
 
2594
        return bzrdir.format_registry.make_bzrdir('pack-0.92')
 
2595
 
 
2596
    def _ignore_setting_bzrdir(self, format):
 
2597
        pass
 
2598
 
 
2599
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2600
 
 
2601
    def get_format_string(self):
 
2602
        """See RepositoryFormat.get_format_string()."""
 
2603
        return "Bazaar pack repository format 1 (needs bzr 0.92)\n"
 
2604
 
 
2605
    def get_format_description(self):
 
2606
        """See RepositoryFormat.get_format_description()."""
 
2607
        return "Packs containing knits without subtree support"
 
2608
 
 
2609
 
 
2610
class RepositoryFormatKnitPack3(RepositoryFormatPack):
 
2611
    """A subtrees parameterized Pack repository.
 
2612
 
 
2613
    This repository format uses the xml7 serializer to get:
 
2614
     - support for recording full info about the tree root
 
2615
     - support for recording tree-references
 
2616
 
 
2617
    This format was introduced in 0.92.
 
2618
    """
 
2619
 
 
2620
    repository_class = KnitPackRepository
 
2621
    _commit_builder_class = PackRootCommitBuilder
 
2622
    rich_root_data = True
 
2623
    experimental = True
 
2624
    supports_tree_reference = True
 
2625
    @property
 
2626
    def _serializer(self):
 
2627
        return xml7.serializer_v7
 
2628
    # What index classes to use
 
2629
    index_builder_class = InMemoryGraphIndex
 
2630
    index_class = GraphIndex
 
2631
 
 
2632
    def _get_matching_bzrdir(self):
 
2633
        return bzrdir.format_registry.make_bzrdir(
 
2634
            'pack-0.92-subtree')
 
2635
 
 
2636
    def _ignore_setting_bzrdir(self, format):
 
2637
        pass
 
2638
 
 
2639
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2640
 
 
2641
    def get_format_string(self):
 
2642
        """See RepositoryFormat.get_format_string()."""
 
2643
        return "Bazaar pack repository format 1 with subtree support (needs bzr 0.92)\n"
 
2644
 
 
2645
    def get_format_description(self):
 
2646
        """See RepositoryFormat.get_format_description()."""
 
2647
        return "Packs containing knits with subtree support\n"
 
2648
 
 
2649
 
 
2650
class RepositoryFormatKnitPack4(RepositoryFormatPack):
 
2651
    """A rich-root, no subtrees parameterized Pack repository.
 
2652
 
 
2653
    This repository format uses the xml6 serializer to get:
 
2654
     - support for recording full info about the tree root
 
2655
 
 
2656
    This format was introduced in 1.0.
 
2657
    """
 
2658
 
 
2659
    repository_class = KnitPackRepository
 
2660
    _commit_builder_class = PackRootCommitBuilder
 
2661
    rich_root_data = True
 
2662
    supports_tree_reference = False
 
2663
    @property
 
2664
    def _serializer(self):
 
2665
        return xml6.serializer_v6
 
2666
    # What index classes to use
 
2667
    index_builder_class = InMemoryGraphIndex
 
2668
    index_class = GraphIndex
 
2669
 
 
2670
    def _get_matching_bzrdir(self):
 
2671
        return bzrdir.format_registry.make_bzrdir(
 
2672
            'rich-root-pack')
 
2673
 
 
2674
    def _ignore_setting_bzrdir(self, format):
 
2675
        pass
 
2676
 
 
2677
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2678
 
 
2679
    def get_format_string(self):
 
2680
        """See RepositoryFormat.get_format_string()."""
 
2681
        return ("Bazaar pack repository format 1 with rich root"
 
2682
                " (needs bzr 1.0)\n")
 
2683
 
 
2684
    def get_format_description(self):
 
2685
        """See RepositoryFormat.get_format_description()."""
 
2686
        return "Packs containing knits with rich root support\n"
 
2687
 
 
2688
 
 
2689
class RepositoryFormatKnitPack5(RepositoryFormatPack):
 
2690
    """Repository that supports external references to allow stacking.
 
2691
 
 
2692
    New in release 1.6.
 
2693
 
 
2694
    Supports external lookups, which results in non-truncated ghosts after
 
2695
    reconcile compared to pack-0.92 formats.
 
2696
    """
 
2697
 
 
2698
    repository_class = KnitPackRepository
 
2699
    _commit_builder_class = PackCommitBuilder
 
2700
    supports_external_lookups = True
 
2701
    # What index classes to use
 
2702
    index_builder_class = InMemoryGraphIndex
 
2703
    index_class = GraphIndex
 
2704
 
 
2705
    @property
 
2706
    def _serializer(self):
 
2707
        return xml5.serializer_v5
 
2708
 
 
2709
    def _get_matching_bzrdir(self):
 
2710
        return bzrdir.format_registry.make_bzrdir('1.6')
 
2711
 
 
2712
    def _ignore_setting_bzrdir(self, format):
 
2713
        pass
 
2714
 
 
2715
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2716
 
 
2717
    def get_format_string(self):
 
2718
        """See RepositoryFormat.get_format_string()."""
 
2719
        return "Bazaar RepositoryFormatKnitPack5 (bzr 1.6)\n"
 
2720
 
 
2721
    def get_format_description(self):
 
2722
        """See RepositoryFormat.get_format_description()."""
 
2723
        return "Packs 5 (adds stacking support, requires bzr 1.6)"
 
2724
 
 
2725
 
 
2726
class RepositoryFormatKnitPack5RichRoot(RepositoryFormatPack):
 
2727
    """A repository with rich roots and stacking.
 
2728
 
 
2729
    New in release 1.6.1.
 
2730
 
 
2731
    Supports stacking on other repositories, allowing data to be accessed
 
2732
    without being stored locally.
 
2733
    """
 
2734
 
 
2735
    repository_class = KnitPackRepository
 
2736
    _commit_builder_class = PackRootCommitBuilder
 
2737
    rich_root_data = True
 
2738
    supports_tree_reference = False # no subtrees
 
2739
    supports_external_lookups = True
 
2740
    # What index classes to use
 
2741
    index_builder_class = InMemoryGraphIndex
 
2742
    index_class = GraphIndex
 
2743
 
 
2744
    @property
 
2745
    def _serializer(self):
 
2746
        return xml6.serializer_v6
 
2747
 
 
2748
    def _get_matching_bzrdir(self):
 
2749
        return bzrdir.format_registry.make_bzrdir(
 
2750
            '1.6.1-rich-root')
 
2751
 
 
2752
    def _ignore_setting_bzrdir(self, format):
 
2753
        pass
 
2754
 
 
2755
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2756
 
 
2757
    def get_format_string(self):
 
2758
        """See RepositoryFormat.get_format_string()."""
 
2759
        return "Bazaar RepositoryFormatKnitPack5RichRoot (bzr 1.6.1)\n"
 
2760
 
 
2761
    def get_format_description(self):
 
2762
        return "Packs 5 rich-root (adds stacking support, requires bzr 1.6.1)"
 
2763
 
 
2764
 
 
2765
class RepositoryFormatKnitPack5RichRootBroken(RepositoryFormatPack):
 
2766
    """A repository with rich roots and external references.
 
2767
 
 
2768
    New in release 1.6.
 
2769
 
 
2770
    Supports external lookups, which results in non-truncated ghosts after
 
2771
    reconcile compared to pack-0.92 formats.
 
2772
 
 
2773
    This format was deprecated because the serializer it uses accidentally
 
2774
    supported subtrees, when the format was not intended to. This meant that
 
2775
    someone could accidentally fetch from an incorrect repository.
 
2776
    """
 
2777
 
 
2778
    repository_class = KnitPackRepository
 
2779
    _commit_builder_class = PackRootCommitBuilder
 
2780
    rich_root_data = True
 
2781
    supports_tree_reference = False # no subtrees
 
2782
 
 
2783
    supports_external_lookups = True
 
2784
    # What index classes to use
 
2785
    index_builder_class = InMemoryGraphIndex
 
2786
    index_class = GraphIndex
 
2787
 
 
2788
    @property
 
2789
    def _serializer(self):
 
2790
        return xml7.serializer_v7
 
2791
 
 
2792
    def _get_matching_bzrdir(self):
 
2793
        matching = bzrdir.format_registry.make_bzrdir(
 
2794
            '1.6.1-rich-root')
 
2795
        matching.repository_format = self
 
2796
        return matching
 
2797
 
 
2798
    def _ignore_setting_bzrdir(self, format):
 
2799
        pass
 
2800
 
 
2801
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2802
 
 
2803
    def get_format_string(self):
 
2804
        """See RepositoryFormat.get_format_string()."""
 
2805
        return "Bazaar RepositoryFormatKnitPack5RichRoot (bzr 1.6)\n"
 
2806
 
 
2807
    def get_format_description(self):
 
2808
        return ("Packs 5 rich-root (adds stacking support, requires bzr 1.6)"
 
2809
                " (deprecated)")
 
2810
 
 
2811
 
 
2812
class RepositoryFormatKnitPack6(RepositoryFormatPack):
 
2813
    """A repository with stacking and btree indexes,
 
2814
    without rich roots or subtrees.
 
2815
 
 
2816
    This is equivalent to pack-1.6 with B+Tree indices.
 
2817
    """
 
2818
 
 
2819
    repository_class = KnitPackRepository
 
2820
    _commit_builder_class = PackCommitBuilder
 
2821
    supports_external_lookups = True
 
2822
    # What index classes to use
 
2823
    index_builder_class = BTreeBuilder
 
2824
    index_class = BTreeGraphIndex
 
2825
 
 
2826
    @property
 
2827
    def _serializer(self):
 
2828
        return xml5.serializer_v5
 
2829
 
 
2830
    def _get_matching_bzrdir(self):
 
2831
        return bzrdir.format_registry.make_bzrdir('1.9')
 
2832
 
 
2833
    def _ignore_setting_bzrdir(self, format):
 
2834
        pass
 
2835
 
 
2836
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2837
 
 
2838
    def get_format_string(self):
 
2839
        """See RepositoryFormat.get_format_string()."""
 
2840
        return "Bazaar RepositoryFormatKnitPack6 (bzr 1.9)\n"
 
2841
 
 
2842
    def get_format_description(self):
 
2843
        """See RepositoryFormat.get_format_description()."""
 
2844
        return "Packs 6 (uses btree indexes, requires bzr 1.9)"
 
2845
 
 
2846
 
 
2847
class RepositoryFormatKnitPack6RichRoot(RepositoryFormatPack):
 
2848
    """A repository with rich roots, no subtrees, stacking and btree indexes.
 
2849
 
 
2850
    1.6-rich-root with B+Tree indices.
 
2851
    """
 
2852
 
 
2853
    repository_class = KnitPackRepository
 
2854
    _commit_builder_class = PackRootCommitBuilder
 
2855
    rich_root_data = True
 
2856
    supports_tree_reference = False # no subtrees
 
2857
    supports_external_lookups = True
 
2858
    # What index classes to use
 
2859
    index_builder_class = BTreeBuilder
 
2860
    index_class = BTreeGraphIndex
 
2861
 
 
2862
    @property
 
2863
    def _serializer(self):
 
2864
        return xml6.serializer_v6
 
2865
 
 
2866
    def _get_matching_bzrdir(self):
 
2867
        return bzrdir.format_registry.make_bzrdir(
 
2868
            '1.9-rich-root')
 
2869
 
 
2870
    def _ignore_setting_bzrdir(self, format):
 
2871
        pass
 
2872
 
 
2873
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2874
 
 
2875
    def get_format_string(self):
 
2876
        """See RepositoryFormat.get_format_string()."""
 
2877
        return "Bazaar RepositoryFormatKnitPack6RichRoot (bzr 1.9)\n"
 
2878
 
 
2879
    def get_format_description(self):
 
2880
        return "Packs 6 rich-root (uses btree indexes, requires bzr 1.9)"
 
2881
 
 
2882
 
 
2883
class RepositoryFormatPackDevelopment2Subtree(RepositoryFormatPack):
 
2884
    """A subtrees development repository.
 
2885
 
 
2886
    This format should be retained until the second release after bzr 1.7.
 
2887
 
 
2888
    1.6.1-subtree[as it might have been] with B+Tree indices.
 
2889
 
 
2890
    This is [now] retained until we have a CHK based subtree format in
 
2891
    development.
 
2892
    """
 
2893
 
 
2894
    repository_class = KnitPackRepository
 
2895
    _commit_builder_class = PackRootCommitBuilder
 
2896
    rich_root_data = True
 
2897
    experimental = True
 
2898
    supports_tree_reference = True
 
2899
    supports_external_lookups = True
 
2900
    # What index classes to use
 
2901
    index_builder_class = BTreeBuilder
 
2902
    index_class = BTreeGraphIndex
 
2903
 
 
2904
    @property
 
2905
    def _serializer(self):
 
2906
        return xml7.serializer_v7
 
2907
 
 
2908
    def _get_matching_bzrdir(self):
 
2909
        return bzrdir.format_registry.make_bzrdir(
 
2910
            'development-subtree')
 
2911
 
 
2912
    def _ignore_setting_bzrdir(self, format):
 
2913
        pass
 
2914
 
 
2915
    _matchingbzrdir = property(_get_matching_bzrdir, _ignore_setting_bzrdir)
 
2916
 
 
2917
    def get_format_string(self):
 
2918
        """See RepositoryFormat.get_format_string()."""
 
2919
        return ("Bazaar development format 2 with subtree support "
 
2920
            "(needs bzr.dev from before 1.8)\n")
 
2921
 
 
2922
    def get_format_description(self):
 
2923
        """See RepositoryFormat.get_format_description()."""
 
2924
        return ("Development repository format, currently the same as "
 
2925
            "1.6.1-subtree with B+Tree indices.\n")
2065
2926