~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/check.py

  • Committer: Martin Pool
  • Date: 2005-07-04 08:06:51 UTC
  • Revision ID: mbp@sourcefrog.net-20050704080651-6ecec49164359e48
- track pending-merges

- unit tests for this

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006 Canonical Ltd
2
 
#
 
1
# Copyright (C) 2004, 2005 by Martin Pool
 
2
# Copyright (C) 2005 by Canonical Ltd
 
3
 
3
4
# This program is free software; you can redistribute it and/or modify
4
5
# it under the terms of the GNU General Public License as published by
5
6
# the Free Software Foundation; either version 2 of the License, or
6
7
# (at your option) any later version.
7
 
#
 
8
 
8
9
# This program is distributed in the hope that it will be useful,
9
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
12
# GNU General Public License for more details.
12
 
#
 
13
 
13
14
# You should have received a copy of the GNU General Public License
14
15
# along with this program; if not, write to the Free Software
15
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
17
 
17
 
# TODO: Check ancestries are correct for every revision: includes
18
 
# every committed so far, and in a reasonable order.
19
 
 
20
 
# TODO: Also check non-mainline revisions mentioned as parents.
21
 
 
22
 
# TODO: Check for extra files in the control directory.
23
 
 
24
 
# TODO: Check revision, inventory and entry objects have all 
25
 
# required fields.
26
 
 
27
 
# TODO: Get every revision in the revision-store even if they're not
28
 
# referenced by history and make sure they're all valid.
29
 
 
30
 
# TODO: Perhaps have a way to record errors other than by raising exceptions;
31
 
# would perhaps be enough to accumulate exception objects in a list without
32
 
# raising them.  If there's more than one exception it'd be good to see them
33
 
# all.
34
 
 
35
 
from bzrlib.errors import BzrCheckError
36
 
import bzrlib.ui
37
 
from bzrlib.trace import note
38
 
 
39
 
class Check(object):
40
 
    """Check a repository"""
41
 
 
42
 
    # The Check object interacts with InventoryEntry.check, etc.
43
 
 
44
 
    def __init__(self, repository):
45
 
        self.repository = repository
46
 
        self.checked_text_cnt = 0
47
 
        self.checked_rev_cnt = 0
48
 
        self.ghosts = []
49
 
        self.repeated_text_cnt = 0
50
 
        self.missing_parent_links = {}
51
 
        self.missing_inventory_sha_cnt = 0
52
 
        self.missing_revision_cnt = 0
53
 
        # maps (file-id, version) -> sha1; used by InventoryFile._check
54
 
        self.checked_texts = {}
55
 
        self.checked_weaves = {}
56
 
 
57
 
    def check(self):
58
 
        self.repository.lock_read()
59
 
        self.progress = bzrlib.ui.ui_factory.nested_progress_bar()
60
 
        try:
61
 
            self.progress.update('retrieving inventory', 0, 0)
62
 
            # do not put in init, as it should be done with progess,
63
 
            # and inside the lock.
64
 
            self.inventory_weave = self.repository.get_inventory_weave()
65
 
            self.plan_revisions()
66
 
            revno = 0
67
 
            self.check_weaves()
68
 
            while revno < len(self.planned_revisions):
69
 
                rev_id = self.planned_revisions[revno]
70
 
                self.progress.update('checking revision', revno,
71
 
                                     len(self.planned_revisions))
72
 
                revno += 1
73
 
                self.check_one_rev(rev_id)
74
 
        finally:
75
 
            self.progress.finished()
76
 
            self.repository.unlock()
77
 
 
78
 
    def plan_revisions(self):
79
 
        repository = self.repository
80
 
        self.planned_revisions = set(repository.all_revision_ids())
81
 
        self.progress.clear()
82
 
        inventoried = set(self.inventory_weave.versions())
83
 
        awol = self.planned_revisions - inventoried
84
 
        if len(awol) > 0:
85
 
            raise BzrCheckError('Stored revisions missing from inventory'
86
 
                '{%s}' % ','.join([f for f in awol]))
87
 
        self.planned_revisions = list(self.planned_revisions)
88
 
 
89
 
    def report_results(self, verbose):
90
 
        note('checked repository %s format %s',
91
 
             self.repository.bzrdir.root_transport,
92
 
             self.repository._format)
93
 
        note('%6d revisions', self.checked_rev_cnt)
94
 
        note('%6d unique file texts', self.checked_text_cnt)
95
 
        note('%6d repeated file texts', self.repeated_text_cnt)
96
 
        note('%6d weaves', len(self.checked_weaves))
97
 
        if self.missing_inventory_sha_cnt:
98
 
            note('%6d revisions are missing inventory_sha1',
99
 
                 self.missing_inventory_sha_cnt)
100
 
        if self.missing_revision_cnt:
101
 
            note('%6d revisions are mentioned but not present',
102
 
                 self.missing_revision_cnt)
103
 
        if len(self.ghosts):
104
 
            note('%6d ghost revisions', len(self.ghosts))
105
 
            if verbose:
106
 
                for ghost in self.ghosts:
107
 
                    note('      %s', ghost)
108
 
        if len(self.missing_parent_links):
109
 
            note('%6d revisions missing parents in ancestry',
110
 
                 len(self.missing_parent_links))
111
 
            if verbose:
112
 
                for link, linkers in self.missing_parent_links.items():
113
 
                    note('      %s should be in the ancestry for:', link)
114
 
                    for linker in linkers:
115
 
                        note('       * %s', linker)
116
 
 
117
 
    def check_one_rev(self, rev_id):
118
 
        """Check one revision.
119
 
 
120
 
        rev_id - the one to check
121
 
        """
122
 
        rev = self.repository.get_revision(rev_id)
123
 
                
124
 
        if rev.revision_id != rev_id:
125
 
            raise BzrCheckError('wrong internal revision id in revision {%s}'
126
 
                                % rev_id)
127
 
 
128
 
        for parent in rev.parent_ids:
129
 
            if not parent in self.planned_revisions:
130
 
                missing_links = self.missing_parent_links.get(parent, [])
131
 
                missing_links.append(rev_id)
132
 
                self.missing_parent_links[parent] = missing_links
133
 
                # list based so somewhat slow,
134
 
                # TODO have a planned_revisions list and set.
135
 
                if self.repository.has_revision(parent):
136
 
                    missing_ancestry = self.repository.get_ancestry(parent)
137
 
                    for missing in missing_ancestry:
138
 
                        if (missing is not None 
139
 
                            and missing not in self.planned_revisions):
140
 
                            self.planned_revisions.append(missing)
141
 
                else:
142
 
                    self.ghosts.append(rev_id)
143
 
 
144
 
        if rev.inventory_sha1:
145
 
            inv_sha1 = self.repository.get_inventory_sha1(rev_id)
146
 
            if inv_sha1 != rev.inventory_sha1:
147
 
                raise BzrCheckError('Inventory sha1 hash doesn\'t match'
148
 
                    ' value in revision {%s}' % rev_id)
149
 
        self._check_revision_tree(rev_id)
150
 
        self.checked_rev_cnt += 1
151
 
 
152
 
    def check_weaves(self):
153
 
        """Check all the weaves we can get our hands on.
154
 
        """
155
 
        n_weaves = 1
156
 
        weave_ids = []
157
 
        if self.repository.weave_store.listable():
158
 
            weave_ids = list(self.repository.weave_store)
159
 
            n_weaves = len(weave_ids)
160
 
        self.progress.update('checking weave', 0, n_weaves)
161
 
        self.inventory_weave.check(progress_bar=self.progress)
162
 
        for i, weave_id in enumerate(weave_ids):
163
 
            self.progress.update('checking weave', i, n_weaves)
164
 
            w = self.repository.weave_store.get_weave(weave_id,
165
 
                    self.repository.get_transaction())
166
 
            # No progress here, because it looks ugly.
167
 
            w.check()
168
 
            self.checked_weaves[weave_id] = True
169
 
 
170
 
    def _check_revision_tree(self, rev_id):
171
 
        tree = self.repository.revision_tree(rev_id)
172
 
        inv = tree.inventory
173
 
        seen_ids = {}
174
 
        for file_id in inv:
175
 
            if file_id in seen_ids:
176
 
                raise BzrCheckError('duplicated file_id {%s} '
177
 
                                    'in inventory for revision {%s}'
178
 
                                    % (file_id, rev_id))
179
 
            seen_ids[file_id] = True
180
 
        for file_id in inv:
181
 
            ie = inv[file_id]
182
 
            ie.check(self, rev_id, inv, tree)
183
 
        seen_names = {}
184
 
        for path, ie in inv.iter_entries():
185
 
            if path in seen_names:
186
 
                raise BzrCheckError('duplicated path %s '
187
 
                                    'in inventory for revision {%s}'
188
 
                                    % (path, rev_id))
189
 
            seen_names[path] = True
190
 
 
191
 
 
192
 
def check(branch, verbose):
 
18
 
 
19
 
 
20
 
 
21
def check(branch):
193
22
    """Run consistency checks on a branch.
194
 
    
195
 
    Results are reported through logging.
196
 
    
197
 
    :raise BzrCheckError: if there's a consistency error.
 
23
 
 
24
    TODO: Also check non-mainline revisions mentioned as parents.
 
25
 
 
26
    TODO: Check for extra files in the control directory.
198
27
    """
 
28
    from bzrlib.trace import mutter
 
29
    from bzrlib.errors import BzrCheckError
 
30
    from bzrlib.osutils import fingerprint_file
 
31
    from bzrlib.progress import ProgressBar
 
32
 
199
33
    branch.lock_read()
 
34
 
200
35
    try:
201
 
        branch_result = branch.check()
202
 
        repo_result = branch.repository.check([branch.last_revision()])
 
36
        pb = ProgressBar(show_spinner=True)
 
37
        last_rev_id = None
 
38
 
 
39
        missing_inventory_sha_cnt = 0
 
40
        missing_revision_sha_cnt = 0
 
41
 
 
42
        history = branch.revision_history()
 
43
        revno = 0
 
44
        revcount = len(history)
 
45
 
 
46
        # for all texts checked, text_id -> sha1
 
47
        checked_texts = {}
 
48
 
 
49
        for rev_id in history:
 
50
            revno += 1
 
51
            pb.update('checking revision', revno, revcount)
 
52
            mutter('    revision {%s}' % rev_id)
 
53
            rev = branch.get_revision(rev_id)
 
54
            if rev.revision_id != rev_id:
 
55
                raise BzrCheckError('wrong internal revision id in revision {%s}'
 
56
                                    % rev_id)
 
57
 
 
58
            # check the previous history entry is a parent of this entry
 
59
            if rev.parents:
 
60
                if last_rev_id is None:
 
61
                    raise BzrCheckError("revision {%s} has %d parents, but is the "
 
62
                                        "start of the branch"
 
63
                                        % (rev_id, len(rev.parents)))
 
64
                for prr in rev.parents:
 
65
                    if prr.revision_id == last_rev_id:
 
66
                        break
 
67
                else:
 
68
                    raise BzrCheckError("previous revision {%s} not listed among "
 
69
                                        "parents of {%s}"
 
70
                                        % (last_rev_id, rev_id))
 
71
 
 
72
                for prr in rev.parents:
 
73
                    if prr.revision_sha1 is None:
 
74
                        missing_revision_sha_cnt += 1
 
75
                        continue
 
76
                    prid = prr.revision_id
 
77
                    actual_sha = branch.get_revision_sha1(prid)
 
78
                    if prr.revision_sha1 != actual_sha:
 
79
                        raise BzrCheckError("mismatched revision sha1 for "
 
80
                                            "parent {%s} of {%s}: %s vs %s"
 
81
                                            % (prid, rev_id,
 
82
                                               prr.revision_sha1, actual_sha))
 
83
            elif last_rev_id:
 
84
                raise BzrCheckError("revision {%s} has no parents listed but preceded "
 
85
                                    "by {%s}"
 
86
                                    % (rev_id, last_rev_id))
 
87
 
 
88
            ## TODO: Check all the required fields are present on the revision.
 
89
 
 
90
            if rev.inventory_sha1:
 
91
                inv_sha1 = branch.get_inventory_sha1(rev.inventory_id)
 
92
                if inv_sha1 != rev.inventory_sha1:
 
93
                    raise BzrCheckError('Inventory sha1 hash doesn\'t match'
 
94
                        ' value in revision {%s}' % rev_id)
 
95
            else:
 
96
                missing_inventory_sha_cnt += 1
 
97
                mutter("no inventory_sha1 on revision {%s}" % rev_id)
 
98
 
 
99
            inv = branch.get_inventory(rev.inventory_id)
 
100
            seen_ids = {}
 
101
            seen_names = {}
 
102
 
 
103
            ## p('revision %d/%d file ids' % (revno, revcount))
 
104
            for file_id in inv:
 
105
                if file_id in seen_ids:
 
106
                    raise BzrCheckError('duplicated file_id {%s} '
 
107
                                        'in inventory for revision {%s}'
 
108
                                        % (file_id, rev_id))
 
109
                seen_ids[file_id] = True
 
110
 
 
111
            i = 0
 
112
            for file_id in inv:
 
113
                i += 1
 
114
                if i & 31 == 0:
 
115
                    pb.tick()
 
116
 
 
117
                ie = inv[file_id]
 
118
 
 
119
                if ie.parent_id != None:
 
120
                    if ie.parent_id not in seen_ids:
 
121
                        raise BzrCheckError('missing parent {%s} in inventory for revision {%s}'
 
122
                                % (ie.parent_id, rev_id))
 
123
 
 
124
                if ie.kind == 'file':
 
125
                    if ie.text_id in checked_texts:
 
126
                        fp = checked_texts[ie.text_id]
 
127
                    else:
 
128
                        if not ie.text_id in branch.text_store:
 
129
                            raise BzrCheckError('text {%s} not in text_store' % ie.text_id)
 
130
 
 
131
                        tf = branch.text_store[ie.text_id]
 
132
                        fp = fingerprint_file(tf)
 
133
                        checked_texts[ie.text_id] = fp
 
134
 
 
135
                    if ie.text_size != fp['size']:
 
136
                        raise BzrCheckError('text {%s} wrong size' % ie.text_id)
 
137
                    if ie.text_sha1 != fp['sha1']:
 
138
                        raise BzrCheckError('text {%s} wrong sha1' % ie.text_id)
 
139
                elif ie.kind == 'directory':
 
140
                    if ie.text_sha1 != None or ie.text_size != None or ie.text_id != None:
 
141
                        raise BzrCheckError('directory {%s} has text in revision {%s}'
 
142
                                % (file_id, rev_id))
 
143
 
 
144
            pb.tick()
 
145
            for path, ie in inv.iter_entries():
 
146
                if path in seen_names:
 
147
                    raise BzrCheckError('duplicated path %s '
 
148
                                        'in inventory for revision {%s}'
 
149
                                        % (path, rev_id))
 
150
            seen_names[path] = True
 
151
            last_rev_id = rev_id
 
152
 
203
153
    finally:
204
154
        branch.unlock()
205
 
    branch_result.report_results(verbose)
206
 
    repo_result.report_results(verbose)
 
155
 
 
156
    pb.clear()
 
157
 
 
158
    print 'checked %d revisions, %d file texts' % (revcount, len(checked_texts))
 
159
    
 
160
    if missing_inventory_sha_cnt:
 
161
        print '%d revisions are missing inventory_sha1' % missing_inventory_sha_cnt
 
162
 
 
163
    if missing_revision_sha_cnt:
 
164
        print '%d parent links are missing revision_sha1' % missing_revision_sha_cnt
 
165
 
 
166
    if (missing_inventory_sha_cnt
 
167
        or missing_revision_sha_cnt):
 
168
        print '  (use "bzr upgrade" to fix them)'