~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/check.py

[merge] fix \t in commit messages

Show diffs side-by-side

added added

removed removed

Lines of Context:
15
15
# along with this program; if not, write to the Free Software
16
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17
17
 
 
18
# TODO: Check ancestries are correct for every revision: includes
 
19
# every committed so far, and in a reasonable order.
 
20
 
 
21
# TODO: Also check non-mainline revisions mentioned as parents.
 
22
 
 
23
# TODO: Check for extra files in the control directory.
 
24
 
 
25
# TODO: Check revision, inventory and entry objects have all 
 
26
# required fields.
 
27
 
 
28
# TODO: Get every revision in the revision-store even if they're not
 
29
# referenced by history and make sure they're all valid.
 
30
 
18
31
import bzrlib.ui
19
32
from bzrlib.trace import note, warning
20
 
 
21
 
def _update_store_entry(obj, obj_id, branch, store_name, store):
22
 
    """This is just a meta-function, which handles both revision entries
23
 
    and inventory entries.
24
 
    """
25
 
    from bzrlib.trace import mutter
26
 
    import tempfile, os, errno
27
 
    from osutils import rename
28
 
    obj_tmp = tempfile.TemporaryFile()
29
 
    obj.write_xml(obj_tmp)
30
 
    obj_tmp.seek(0)
31
 
 
32
 
    tmpfd, tmp_path = tempfile.mkstemp(prefix=obj_id, suffix='.gz',
33
 
        dir=branch.controlfilename(store_name))
34
 
    os.close(tmpfd)
35
 
    try:
36
 
        orig_obj_path = branch.controlfilename([store_name, obj_id+'.gz'])
37
 
        # Remove the old entry out of the way
38
 
        rename(orig_obj_path, tmp_path)
39
 
        try:
40
 
            # TODO: We may need to handle the case where the old
41
 
            # entry was not compressed (and thus did not end with .gz)
42
 
 
43
 
            store.add(obj_tmp, obj_id) # Add the new one
44
 
            os.remove(tmp_path) # Remove the old name
45
 
            mutter('    Updated %s entry {%s}' % (store_name, obj_id))
46
 
        except:
47
 
            # On any exception, restore the old entry
48
 
            rename(tmp_path, orig_obj_path)
49
 
            raise
50
 
    finally:
51
 
        if os.path.exists(tmp_path):
52
 
            # Unfortunately, the next command might throw
53
 
            # an exception, which will mask a previous exception.
54
 
            os.remove(tmp_path)
55
 
        obj_tmp.close()
56
 
 
57
 
def _update_revision_entry(rev, branch):
58
 
    """After updating the values in a revision, make sure to
59
 
    write out the data, but try to do it in an atomic manner.
60
 
 
61
 
    :param rev:    The Revision object to store
62
 
    :param branch: The Branch object where this Revision is to be stored.
63
 
    """
64
 
    _update_store_entry(rev, rev.revision_id, branch,
65
 
            'revision-store', branch.revision_store)
66
 
 
67
 
def _update_inventory_entry(inv, inv_id, branch):
68
 
    """When an inventory has been modified (such as by adding a unique tree root)
69
 
    this atomically re-generates the file.
70
 
 
71
 
    :param inv:     The Inventory
72
 
    :param inv_id:  The inventory id for this inventory
73
 
    :param branch:  The Branch where this entry will be stored.
74
 
    """
75
 
    raise NotImplementedError("can't update existing inventory entry")
76
 
 
77
 
 
78
 
def check(branch):
79
 
    """Run consistency checks on a branch.
80
 
 
81
 
    TODO: Also check non-mainline revisions mentioned as parents.
82
 
 
83
 
    TODO: Check for extra files in the control directory.
84
 
    """
85
 
    from bzrlib.trace import mutter
86
 
    from bzrlib.errors import BzrCheckError, NoSuchRevision
87
 
    from bzrlib.osutils import fingerprint_file
88
 
    from bzrlib.inventory import ROOT_ID
89
 
    from bzrlib.branch import gen_root_id
90
 
 
91
 
    branch.lock_read()
92
 
 
93
 
    try:
 
33
from bzrlib.osutils import rename, sha_string, fingerprint_file
 
34
from bzrlib.trace import mutter
 
35
from bzrlib.errors import BzrCheckError, NoSuchRevision
 
36
from bzrlib.inventory import ROOT_ID
 
37
from bzrlib.branch import gen_root_id
 
38
 
 
39
 
 
40
class Check(object):
 
41
    """Check a branch"""
 
42
 
 
43
    def __init__(self, branch):
 
44
        self.branch = branch
 
45
        self.checked_text_cnt = 0
 
46
        self.checked_rev_cnt = 0
 
47
        self.ghosts = []
 
48
        self.repeated_text_cnt = 0
 
49
        self.missing_parent_links = {}
 
50
        self.missing_inventory_sha_cnt = 0
 
51
        self.missing_revision_cnt = 0
 
52
        # maps (file-id, version) -> sha1
 
53
        self.checked_texts = {}
 
54
 
 
55
    def check(self):
 
56
        self.branch.lock_read()
 
57
        try:
 
58
            self.history = self.branch.revision_history()
 
59
            if not len(self.history):
 
60
                # nothing to see here
 
61
                return
 
62
            self.planned_revisions = self.branch.get_ancestry(self.history[-1])
 
63
            self.planned_revisions.remove(None)
 
64
            revno = 0
 
65
    
 
66
            self.progress = bzrlib.ui.ui_factory.progress_bar()
 
67
            while revno < len(self.planned_revisions):
 
68
                rev_id = self.planned_revisions[revno]
 
69
                self.progress.update('checking revision', revno,
 
70
                                     len(self.planned_revisions))
 
71
                revno += 1
 
72
                self.check_one_rev(rev_id)
 
73
            self.progress.clear()
 
74
        finally:
 
75
            self.branch.unlock()
 
76
 
 
77
    def report_results(self, verbose):
 
78
        note('checked branch %s format %d',
 
79
             self.branch.base, 
 
80
             self.branch._branch_format)
 
81
 
 
82
        note('%6d revisions', self.checked_rev_cnt)
 
83
        note('%6d unique file texts', self.checked_text_cnt)
 
84
        note('%6d repeated file texts', self.repeated_text_cnt)
 
85
        if self.missing_inventory_sha_cnt:
 
86
            note('%6d revisions are missing inventory_sha1',
 
87
                 self.missing_inventory_sha_cnt)
 
88
        if self.missing_revision_cnt:
 
89
            note('%6d revisions are mentioned but not present',
 
90
                 self.missing_revision_cnt)
 
91
        if len(self.ghosts):
 
92
            note('%6d ghost revisions', len(self.ghosts))
 
93
            if verbose:
 
94
                for ghost in self.ghosts:
 
95
                    note('      %s', ghost)
 
96
        if len(self.missing_parent_links):
 
97
            note('%6d revisions missing parents in ancestry', 
 
98
                 len(self.missing_parent_links))
 
99
            if verbose:
 
100
                for link, linkers in self.missing_parent_links.items():
 
101
                    note('      %s should be in the ancestry for:', link)
 
102
                    for linker in linkers:
 
103
                        note('       * %s', linker)
 
104
 
 
105
    def check_one_rev(self, rev_id):
 
106
        """Check one revision.
 
107
 
 
108
        rev_id - the one to check
 
109
 
 
110
        last_rev_id - the previous one on the mainline, if any.
 
111
        """
 
112
 
 
113
        # mutter('    revision {%s}', rev_id)
 
114
        branch = self.branch
 
115
        try:
 
116
            rev_history_position = self.history.index(rev_id)
 
117
        except ValueError:
 
118
            rev_history_position = None
94
119
        last_rev_id = None
95
 
 
96
 
        missing_inventory_sha_cnt = 0
97
 
        missing_revision_sha_cnt = 0
98
 
        missing_revision_cnt = 0
99
 
 
100
 
        history = branch.revision_history()
101
 
        revno = 0
102
 
        revcount = len(history)
103
 
        mismatch_inv_id = []
104
 
 
105
 
        # for all texts checked, text_id -> sha1
106
 
        checked_texts = {}
107
 
 
108
 
        progress = bzrlib.ui.ui_factory.progress_bar()
109
 
 
110
 
        for rev_id in history:
111
 
            revno += 1
112
 
            progress.update('checking revision', revno, revcount)
113
 
            # mutter('    revision {%s}' % rev_id)
114
 
            rev = branch.get_revision(rev_id)
115
 
            if rev.revision_id != rev_id:
116
 
                raise BzrCheckError('wrong internal revision id in revision {%s}'
117
 
                                    % rev_id)
118
 
 
119
 
            # check the previous history entry is a parent of this entry
120
 
            if rev.parents:
121
 
                if last_rev_id is None:
122
 
                    raise BzrCheckError("revision {%s} has %d parents, but is the "
123
 
                                        "start of the branch"
124
 
                                        % (rev_id, len(rev.parents)))
125
 
                for prr in rev.parents:
126
 
                    if prr.revision_id == last_rev_id:
 
120
        if rev_history_position:
 
121
            rev = branch.get_revision(rev_id)
 
122
            if rev_history_position > 0:
 
123
                last_rev_id = self.history[rev_history_position - 1]
 
124
        else:
 
125
            rev = branch.get_revision(rev_id)
 
126
                
 
127
        if rev.revision_id != rev_id:
 
128
            raise BzrCheckError('wrong internal revision id in revision {%s}'
 
129
                                % rev_id)
 
130
 
 
131
        # check the previous history entry is a parent of this entry
 
132
        if rev.parent_ids:
 
133
            if last_rev_id is not None:
 
134
                for parent_id in rev.parent_ids:
 
135
                    if parent_id == last_rev_id:
127
136
                        break
128
137
                else:
129
138
                    raise BzrCheckError("previous revision {%s} not listed among "
130
139
                                        "parents of {%s}"
131
140
                                        % (last_rev_id, rev_id))
132
 
 
133
 
                for prr in rev.parents:
134
 
                    if prr.revision_sha1 is None:
135
 
                        missing_revision_sha_cnt += 1
136
 
                        continue
137
 
                    prid = prr.revision_id
138
 
                    
139
 
                    try:
140
 
                        actual_sha = branch.get_revision_sha1(prid)
141
 
                    except NoSuchRevision:
142
 
                        missing_revision_cnt += 1
143
 
                        mutter("parent {%s} of {%s} not present in store",
144
 
                               prid, rev_id)
145
 
                        continue
146
 
                        
147
 
                    if prr.revision_sha1 != actual_sha:
148
 
                        raise BzrCheckError("mismatched revision sha1 for "
149
 
                                            "parent {%s} of {%s}: %s vs %s"
150
 
                                            % (prid, rev_id,
151
 
                                               prr.revision_sha1, actual_sha))
152
 
            elif last_rev_id:
153
 
                raise BzrCheckError("revision {%s} has no parents listed but preceded "
154
 
                                    "by {%s}"
155
 
                                    % (rev_id, last_rev_id))
156
 
 
157
 
            if hasattr(rev, 'inventory_id') and rev.inventory_id != rev_id:
158
 
                mismatch_inv_id.append(rev_id)
159
 
 
160
 
            ## TODO: Check all the required fields are present on the revision.
161
 
 
162
 
            if rev.inventory_sha1:
163
 
                inv_sha1 = branch.get_inventory_sha1(rev_id)
164
 
                if inv_sha1 != rev.inventory_sha1:
165
 
                    raise BzrCheckError('Inventory sha1 hash doesn\'t match'
166
 
                        ' value in revision {%s}' % rev_id)
167
 
            else:
168
 
                missing_inventory_sha_cnt += 1
169
 
                mutter("no inventory_sha1 on revision {%s}" % rev_id)
170
 
 
171
 
            inv = branch.get_inventory(rev_id)
172
 
            seen_ids = {}
173
 
            seen_names = {}
174
 
 
175
 
            ## p('revision %d/%d file ids' % (revno, revcount))
176
 
            for file_id in inv:
177
 
                if file_id in seen_ids:
178
 
                    raise BzrCheckError('duplicated file_id {%s} '
179
 
                                        'in inventory for revision {%s}'
180
 
                                        % (file_id, rev_id))
181
 
                seen_ids[file_id] = True
182
 
 
183
 
            i = 0
184
 
            for file_id in inv:
185
 
                i += 1
186
 
                if i & 31 == 0:
187
 
                    progress.tick()
188
 
 
189
 
                ie = inv[file_id]
190
 
 
191
 
                if ie.parent_id != None:
192
 
                    if ie.parent_id not in seen_ids:
193
 
                        raise BzrCheckError('missing parent {%s} in inventory for revision {%s}'
194
 
                                % (ie.parent_id, rev_id))
195
 
 
196
 
                if ie.kind == 'file':
197
 
                    if ie.text_id in checked_texts:
198
 
                        fp = checked_texts[ie.text_id]
 
141
            for parent in rev.parent_ids:
 
142
                if not parent in self.planned_revisions:
 
143
                    missing_links = self.missing_parent_links.get(parent, [])
 
144
                    missing_links.append(rev_id)
 
145
                    self.missing_parent_links[parent] = missing_links
 
146
                    # list based so slow, TODO have a planned_revisions list and set.
 
147
                    if self.branch.has_revision(parent):
 
148
                        missing_ancestry = self.branch.get_ancestry(parent)
 
149
                        for missing in missing_ancestry:
 
150
                            if (missing is not None 
 
151
                                and missing not in self.planned_revisions):
 
152
                                self.planned_revisions.append(missing)
199
153
                    else:
200
 
                        if not ie.text_id in branch.text_store:
201
 
                            raise BzrCheckError('text {%s} not in text_store' % ie.text_id)
202
 
 
203
 
                        tf = branch.text_store[ie.text_id]
204
 
                        fp = fingerprint_file(tf)
205
 
                        checked_texts[ie.text_id] = fp
206
 
 
207
 
                    if ie.text_size != fp['size']:
208
 
                        raise BzrCheckError('text {%s} wrong size' % ie.text_id)
209
 
                    if ie.text_sha1 != fp['sha1']:
210
 
                        raise BzrCheckError('text {%s} wrong sha1' % ie.text_id)
211
 
                elif ie.kind == 'directory':
212
 
                    if ie.text_sha1 != None or ie.text_size != None or ie.text_id != None:
213
 
                        raise BzrCheckError('directory {%s} has text in revision {%s}'
214
 
                                % (file_id, rev_id))
215
 
 
216
 
            progress.tick()
217
 
            for path, ie in inv.iter_entries():
218
 
                if path in seen_names:
219
 
                    raise BzrCheckError('duplicated path %s '
220
 
                                        'in inventory for revision {%s}'
221
 
                                        % (path, rev_id))
 
154
                        self.ghosts.append(rev_id)
 
155
        elif last_rev_id:
 
156
            raise BzrCheckError("revision {%s} has no parents listed "
 
157
                                "but preceded by {%s}"
 
158
                                % (rev_id, last_rev_id))
 
159
 
 
160
        if rev.inventory_sha1:
 
161
            inv_sha1 = branch.get_inventory_sha1(rev_id)
 
162
            if inv_sha1 != rev.inventory_sha1:
 
163
                raise BzrCheckError('Inventory sha1 hash doesn\'t match'
 
164
                    ' value in revision {%s}' % rev_id)
 
165
        else:
 
166
            missing_inventory_sha_cnt += 1
 
167
            mutter("no inventory_sha1 on revision {%s}", rev_id)
 
168
        self._check_revision_tree(rev_id)
 
169
        self.checked_rev_cnt += 1
 
170
 
 
171
    def _check_revision_tree(self, rev_id):
 
172
        tree = self.branch.revision_tree(rev_id)
 
173
        inv = tree.inventory
 
174
        seen_ids = {}
 
175
        for file_id in inv:
 
176
            if file_id in seen_ids:
 
177
                raise BzrCheckError('duplicated file_id {%s} '
 
178
                                    'in inventory for revision {%s}'
 
179
                                    % (file_id, rev_id))
 
180
            seen_ids[file_id] = True
 
181
        for file_id in inv:
 
182
            ie = inv[file_id]
 
183
            ie.check(self, rev_id, inv, tree)
 
184
        seen_names = {}
 
185
        for path, ie in inv.iter_entries():
 
186
            if path in seen_names:
 
187
                raise BzrCheckError('duplicated path %s '
 
188
                                    'in inventory for revision {%s}'
 
189
                                    % (path, rev_id))
222
190
            seen_names[path] = True
223
 
            last_rev_id = rev_id
224
 
 
225
 
    finally:
226
 
        branch.unlock()
227
 
 
228
 
    progress.clear()
229
 
 
230
 
    note('checked %d revisions, %d file texts' % (revcount, len(checked_texts)))
231
 
    
232
 
    if missing_inventory_sha_cnt:
233
 
        note('%d revisions are missing inventory_sha1' % missing_inventory_sha_cnt)
234
 
 
235
 
    if missing_revision_sha_cnt:
236
 
        note('%d parent links are missing revision_sha1' % missing_revision_sha_cnt)
237
 
 
238
 
    if missing_revision_cnt:
239
 
        note('%d revisions are mentioned but not present' % missing_revision_cnt)
240
 
 
241
 
    if missing_revision_cnt:
242
 
        print '%d revisions are mentioned but not present' % missing_revision_cnt
243
 
 
244
 
    # stub this out for now because the main bzr branch has references
245
 
    # to revisions that aren't present in the store -- mbp 20050804
246
 
#    if (missing_inventory_sha_cnt
247
 
#        or missing_revision_sha_cnt):
248
 
#        print '  (use "bzr upgrade" to fix them)'
249
 
 
250
 
    if mismatch_inv_id:
251
 
        warning('%d revisions have mismatched inventory ids:' % len(mismatch_inv_id))
252
 
        for rev_id in mismatch_inv_id:
253
 
            warning('  %s', rev_id)
 
191
 
 
192
 
 
193
def check(branch, verbose):
 
194
    """Run consistency checks on a branch."""
 
195
    checker = Check(branch)
 
196
    checker.check()
 
197
    checker.report_results(verbose)