1
# Copyright (C) 2005, 2006 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
# TODO: Perhaps have a way to record errors other than by raising exceptions;
18
# would perhaps be enough to accumulate exception objects in a list without
19
# raising them. If there's more than one exception it'd be good to see them
22
"""Checking of bzr objects.
24
check_refs is a concept used for optimising check. Objects that depend on other
25
objects (e.g. tree on repository) can list the objects they would be requesting
26
so that when the dependent object is checked, matches can be pulled out and
27
evaluated in-line rather than re-reading the same data many times.
28
check_refs are tuples (kind, value). Currently defined kinds are:
30
* 'trees', where value is a revid and the looked up objects are revision trees.
31
* 'lefthand-distance', where value is a revid and the looked up objects are the
32
distance along the lefthand path to NULL for that revid.
33
* 'revision-existence', where value is a revid, and the result is True or False
34
indicating that the revision was found/not found.
37
from __future__ import absolute_import
43
from .branch import Branch
44
from .controldir import ControlDir
45
from .revision import NULL_REVISION
49
from .trace import note
50
from .workingtree import WorkingTree
51
from .i18n import gettext
54
"""Check a repository"""
56
def __init__(self, repository, check_repo=True):
57
self.repository = repository
59
def report_results(self, verbose):
60
raise NotImplementedError(self.report_results)
63
def scan_branch(branch, needed_refs, to_unlock):
64
"""Scan a branch for refs.
66
:param branch: The branch to schedule for checking.
67
:param needed_refs: Refs we are accumulating.
68
:param to_unlock: The unlock list accumulating.
70
note(gettext("Checking branch at '%s'.") % (branch.base,))
72
to_unlock.append(branch)
73
branch_refs = branch._get_check_refs()
74
for ref in branch_refs:
75
reflist = needed_refs.setdefault(ref, [])
76
reflist.append(branch)
79
def scan_tree(base_tree, tree, needed_refs, to_unlock):
80
"""Scan a tree for refs.
82
:param base_tree: The original tree check opened, used to detect duplicate
84
:param tree: The tree to schedule for checking.
85
:param needed_refs: Refs we are accumulating.
86
:param to_unlock: The unlock list accumulating.
88
if base_tree is not None and tree.basedir == base_tree.basedir:
90
note(gettext("Checking working tree at '%s'.") % (tree.basedir,))
92
to_unlock.append(tree)
93
tree_refs = tree._get_check_refs()
95
reflist = needed_refs.setdefault(ref, [])
99
def check_dwim(path, verbose, do_branch=False, do_repo=False, do_tree=False):
100
"""Check multiple objects.
102
If errors occur they are accumulated and reported as far as possible, and
103
an exception raised at the end of the process.
106
base_tree, branch, repo, relpath = \
107
ControlDir.open_containing_tree_branch_or_repository(path)
108
except errors.NotBranchError:
109
base_tree = branch = repo = None
114
if base_tree is not None:
115
# If the tree is a lightweight checkout we won't see it in
116
# repo.find_branches - add now.
118
scan_tree(None, base_tree, needed_refs, to_unlock)
119
branch = base_tree.branch
120
if branch is not None:
123
# The branch is in a shared repository
124
repo = branch.repository
127
to_unlock.append(repo)
128
branches = repo.find_branches(using=True)
130
if do_branch or do_tree:
131
for branch in branches:
134
tree = branch.controldir.open_workingtree()
136
except (errors.NotLocalUrl, errors.NoWorkingTree):
139
scan_tree(base_tree, tree, needed_refs, to_unlock)
141
scan_branch(branch, needed_refs, to_unlock)
142
if do_branch and not branches:
143
note(gettext("No branch found at specified location."))
144
if do_tree and base_tree is None and not saw_tree:
145
note(gettext("No working tree found at specified location."))
146
if do_repo or do_branch or do_tree:
148
note(gettext("Checking repository at '%s'.")
150
result = repo.check(None, callback_refs=needed_refs,
152
result.report_results(verbose)
155
note(gettext("No working tree found at specified location."))
157
note(gettext("No branch found at specified location."))
159
note(gettext("No repository found at specified location."))
161
for thing in to_unlock: