← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/info.py

  • Committer: John Arbash Meinel
  • Date: 2008-08-18 22:34:21 UTC
  • mto: (3606.5.6 1.6)
  • mto: This revision was merged to the branch mainline in revision 3641.
  • Revision ID: john@arbash-meinel.com-20080818223421-todjny24vj4faj4t
Add tests for the fetching behavior.

The proper parameter passed is 'unordered' add an assert for it, and
fix callers that were passing 'unsorted' instead.
Add tests that we make the right get_record_stream call based
on the value of _fetch_uses_deltas.
Fix the fetch request for signatures.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/info.py
1
 
# Copyright (C) 2005, 2006 by Canonical Ltd
 
1
# Copyright (C) 2005, 2006, 2007 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
5
5
# the Free Software Foundation; either version 2 of the License, or
6
6
# (at your option) any later version.
7
 
# 
 
7
#
8
8
# This program is distributed in the hope that it will be useful,
9
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
11
# GNU General Public License for more details.
12
 
# 
 
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
__all__ = ['show_bzrdir_info']
18
18
 
 
19
import os
19
20
import time
20
 
 
21
 
 
22
 
import bzrlib.diff as diff
 
21
import sys
 
22
 
 
23
from bzrlib import (
 
24
    bzrdir,
 
25
    diff,
 
26
    errors,
 
27
    osutils,
 
28
    urlutils,
 
29
    )
23
30
from bzrlib.errors import (NoWorkingTree, NotBranchError,
24
31
                           NoRepositoryPresent, NotLocalUrl)
25
32
from bzrlib.missing import find_unmerged
26
 
import bzrlib.osutils as osutils
27
 
from bzrlib.symbol_versioning import *
28
33
 
29
34
 
30
35
def plural(n, base='', pl=None):
31
36
    if n == 1:
32
37
        return base
33
 
    elif pl != None:
 
38
    elif pl is not None:
34
39
        return pl
35
40
    else:
36
41
        return 's'
37
42
 
38
43
 
39
 
def _repo_relpath(repo_path, path):
40
 
    """Return path with common prefix of repository path removed.
41
 
 
42
 
    If path is not part of the repository, the original path is returned.
43
 
    If path is equal to the repository, the current directory marker '.' is
44
 
    returned.
45
 
    """
46
 
    path = osutils.normalizepath(path)
47
 
    repo_path = osutils.normalizepath(repo_path)
48
 
    if path == repo_path:
49
 
        return '.'
50
 
    if osutils.is_inside(repo_path, path):
51
 
        return osutils.relpath(repo_path, path)
52
 
    return path
53
 
 
54
 
 
55
 
def _show_location_info(repository, branch=None, working=None):
56
 
    """Show known locations for working, branch and repository."""
 
44
class LocationList(object):
 
45
 
 
46
    def __init__(self, base_path):
 
47
        self.locs = []
 
48
        self.base_path = base_path
 
49
 
 
50
    def add_url(self, label, url):
 
51
        """Add a URL to the list, converting it to a path if possible"""
 
52
        if url is None:
 
53
            return
 
54
        try:
 
55
            path = urlutils.local_path_from_url(url)
 
56
        except errors.InvalidURL:
 
57
            self.locs.append((label, url))
 
58
        else:
 
59
            self.add_path(label, path)
 
60
 
 
61
    def add_path(self, label, path):
 
62
        """Add a path, converting it to a relative path if possible"""
 
63
        try:
 
64
            path = osutils.relpath(self.base_path, path)
 
65
        except errors.PathNotChild:
 
66
            pass
 
67
        else:
 
68
            if path == '':
 
69
                path = '.'
 
70
        if path != '/':
 
71
            path = path.rstrip('/')
 
72
        self.locs.append((label, path))
 
73
 
 
74
    def get_lines(self):
 
75
        max_len = max(len(l) for l, u in self.locs)
 
76
        return ["  %*s: %s\n" % (max_len, l, u) for l, u in self.locs ]
 
77
 
 
78
 
 
79
def gather_location_info(repository, branch=None, working=None):
 
80
    locs = {}
57
81
    repository_path = repository.bzrdir.root_transport.base
58
 
    print 'Location:'
59
 
    if working and branch:
 
82
    if branch is not None:
 
83
        branch_path = branch.bzrdir.root_transport.base
 
84
        master_path = branch.get_bound_location()
 
85
        if master_path is None:
 
86
            master_path = branch_path
 
87
    else:
 
88
        branch_path = None
 
89
        master_path = None
 
90
    if working:
60
91
        working_path = working.bzrdir.root_transport.base
61
 
        branch_path = branch.bzrdir.root_transport.base
62
92
        if working_path != branch_path:
63
 
            # lightweight checkout
64
 
            print '  light checkout root: %s' % working_path
 
93
            locs['light checkout root'] = working_path
 
94
        if master_path != branch_path:
65
95
            if repository.is_shared():
66
 
                # lightweight checkout of branch in shared repository
67
 
                print '    shared repository: %s' % repository_path
68
 
                print '    repository branch: %s' % (
69
 
                    _repo_relpath(repository_path, branch_path))
 
96
                locs['repository checkout root'] = branch_path
70
97
            else:
71
 
                # lightweight checkout of standalone branch
72
 
                print '   checkout of branch: %s' % branch_path
 
98
                locs['checkout root'] = branch_path
 
99
        if working_path != master_path:
 
100
            locs['checkout of branch'] = master_path
73
101
        elif repository.is_shared():
74
 
            # branch with tree inside shared repository
75
 
            print '    shared repository: %s' % repository_path
76
 
            print '  repository checkout: %s' % (
77
 
                _repo_relpath(repository_path, branch_path))
78
 
        elif branch.get_bound_location():
79
 
            # normal checkout
80
 
            print '       checkout root: %s' % working_path
81
 
            print '  checkout of branch: %s' % branch.get_bound_location()
82
 
        else:
 
102
            locs['repository branch'] = branch_path
 
103
        elif branch_path is not None:
83
104
            # standalone
84
 
            print '  branch root: %s' % working_path
85
 
    elif branch:
86
 
        branch_path = branch.bzrdir.root_transport.base
 
105
            locs['branch root'] = branch_path
 
106
    else:
 
107
        working_path = None
87
108
        if repository.is_shared():
88
 
            # branch is part of shared repository
89
 
            print '  shared repository: %s' % repository_path
90
 
            print '  repository branch: %s' % (
91
 
                _repo_relpath(repository_path, branch_path))
 
109
            # lightweight checkout of branch in shared repository
 
110
            if branch_path is not None:
 
111
                locs['repository branch'] = branch_path
 
112
        elif branch_path is not None:
 
113
            # standalone
 
114
            locs['branch root'] = branch_path
 
115
            if master_path != branch_path:
 
116
                locs['bound to branch'] = master_path
92
117
        else:
93
 
            # standalone branch
94
 
            print '  branch root: %s' % branch_path
95
 
    else:
96
 
        # shared repository
97
 
        assert repository.is_shared()
98
 
        print '  shared repository: %s' % repository_path
99
 
 
100
 
 
101
 
def _show_related_info(branch):
 
118
            locs['repository'] = repository_path
 
119
    if repository.is_shared():
 
120
        # lightweight checkout of branch in shared repository
 
121
        locs['shared repository'] = repository_path
 
122
    order = ['light checkout root', 'repository checkout root',
 
123
             'checkout root', 'checkout of branch', 'shared repository',
 
124
             'repository', 'repository branch', 'branch root',
 
125
             'bound to branch']
 
126
    return [(n, locs[n]) for n in order if n in locs]
 
127
 
 
128
 
 
129
def _show_location_info(locs, outfile):
 
130
    """Show known locations for working, branch and repository."""
 
131
    outfile.write('Location:\n')
 
132
    path_list = LocationList(osutils.getcwd())
 
133
    for name, loc in locs:
 
134
        path_list.add_url(name, loc)
 
135
    outfile.writelines(path_list.get_lines())
 
136
 
 
137
 
 
138
def _gather_related_branches(branch):
 
139
    locs = LocationList(osutils.getcwd())
 
140
    locs.add_url('public branch', branch.get_public_branch())
 
141
    locs.add_url('push branch', branch.get_push_location())
 
142
    locs.add_url('parent branch', branch.get_parent())
 
143
    locs.add_url('submit branch', branch.get_submit_branch())
 
144
    try:
 
145
        locs.add_url('stacked on', branch.get_stacked_on_url())
 
146
    except (errors.UnstackableBranchFormat, errors.UnstackableRepositoryFormat,
 
147
        errors.NotStacked):
 
148
        pass
 
149
    return locs
 
150
 
 
151
 
 
152
def _show_related_info(branch, outfile):
102
153
    """Show parent and push location of branch."""
103
 
    if branch.get_parent() or branch.get_push_location():
104
 
        print
105
 
        print 'Related branches:'
106
 
        if branch.get_parent():
107
 
            if branch.get_push_location():
108
 
                print '      parent branch: %s' % branch.get_parent()
109
 
            else:
110
 
                print '  parent branch: %s' % branch.get_parent()
111
 
        if branch.get_push_location():
112
 
            print '  publish to branch: %s' % branch.get_push_location()
113
 
 
114
 
 
115
 
def _show_format_info(control=None, repository=None, branch=None, working=None):
 
154
    locs = _gather_related_branches(branch)
 
155
    if len(locs.locs) > 0:
 
156
        outfile.write('\n')
 
157
        outfile.write('Related branches:\n')
 
158
        outfile.writelines(locs.get_lines())
 
159
 
 
160
 
 
161
def _show_format_info(control=None, repository=None, branch=None,
 
162
                      working=None, outfile=None):
116
163
    """Show known formats for control, working, branch and repository."""
117
 
    print
118
 
    print 'Format:'
 
164
    outfile.write('\n')
 
165
    outfile.write('Format:\n')
119
166
    if control:
120
 
        print '       control: %s' % control._format.get_format_description()
 
167
        outfile.write('       control: %s\n' %
 
168
            control._format.get_format_description())
121
169
    if working:
122
 
        print '  working tree: %s' % working._format.get_format_description()
 
170
        outfile.write('  working tree: %s\n' %
 
171
            working._format.get_format_description())
123
172
    if branch:
124
 
        print '        branch: %s' % branch._format.get_format_description()
 
173
        outfile.write('        branch: %s\n' %
 
174
            branch._format.get_format_description())
125
175
    if repository:
126
 
        print '    repository: %s' % repository._format.get_format_description()
127
 
 
128
 
 
129
 
def _show_locking_info(repository, branch=None, working=None):
 
176
        outfile.write('    repository: %s\n' %
 
177
            repository._format.get_format_description())
 
178
 
 
179
 
 
180
def _show_locking_info(repository, branch=None, working=None, outfile=None):
130
181
    """Show locking status of working, branch and repository."""
131
182
    if (repository.get_physical_lock_status() or
132
183
        (branch and branch.get_physical_lock_status()) or
133
184
        (working and working.get_physical_lock_status())):
134
 
        print
135
 
        print 'Lock status:'
 
185
        outfile.write('\n')
 
186
        outfile.write('Lock status:\n')
136
187
        if working:
137
188
            if working.get_physical_lock_status():
138
189
                status = 'locked'
139
190
            else:
140
191
                status = 'unlocked'
141
 
            print '  working tree: %s' % status
 
192
            outfile.write('  working tree: %s\n' % status)
142
193
        if branch:
143
194
            if branch.get_physical_lock_status():
144
195
                status = 'locked'
145
196
            else:
146
197
                status = 'unlocked'
147
 
            print '        branch: %s' % status
 
198
            outfile.write('        branch: %s\n' % status)
148
199
        if repository:
149
200
            if repository.get_physical_lock_status():
150
201
                status = 'locked'
151
202
            else:
152
203
                status = 'unlocked'
153
 
            print '    repository: %s' % status
154
 
 
155
 
 
156
 
def _show_missing_revisions_branch(branch):
 
204
            outfile.write('    repository: %s\n' % status)
 
205
 
 
206
 
 
207
def _show_missing_revisions_branch(branch, outfile):
157
208
    """Show missing master revisions in branch."""
158
209
    # Try with inaccessible branch ?
159
210
    master = branch.get_master_branch()
160
211
    if master:
161
212
        local_extra, remote_extra = find_unmerged(branch, master)
162
213
        if remote_extra:
163
 
            print
164
 
            print 'Branch is out of date: missing %d revision%s.' % (
165
 
                len(remote_extra), plural(len(remote_extra)))
166
 
 
167
 
 
168
 
def _show_missing_revisions_working(working):
 
214
            outfile.write('\n')
 
215
            outfile.write(('Branch is out of date: missing %d '
 
216
                'revision%s.\n') % (len(remote_extra),
 
217
                plural(len(remote_extra))))
 
218
 
 
219
 
 
220
def _show_missing_revisions_working(working, outfile):
169
221
    """Show missing revisions in working tree."""
170
222
    branch = working.branch
171
223
    basis = working.basis_tree()
172
224
    work_inv = working.inventory
173
 
    delta = diff.compare_trees(basis, working, want_unchanged=True)
174
 
    history = branch.revision_history()
175
 
    tree_last_id = working.last_revision()
 
225
    branch_revno, branch_last_revision = branch.last_revision_info()
 
226
    try:
 
227
        tree_last_id = working.get_parent_ids()[0]
 
228
    except IndexError:
 
229
        tree_last_id = None
176
230
 
177
 
    if len(history) and tree_last_id != history[-1]:
 
231
    if branch_revno and tree_last_id != branch_last_revision:
178
232
        tree_last_revno = branch.revision_id_to_revno(tree_last_id)
179
 
        missing_count = len(history) - tree_last_revno
180
 
        print
181
 
        print 'Working tree is out of date: missing %d revision%s.' % (
182
 
            missing_count, plural(missing_count))
183
 
 
184
 
 
185
 
def _show_working_stats(working):
 
233
        missing_count = branch_revno - tree_last_revno
 
234
        outfile.write('\n')
 
235
        outfile.write(('Working tree is out of date: missing %d '
 
236
            'revision%s.\n') % (missing_count, plural(missing_count)))
 
237
 
 
238
 
 
239
def _show_working_stats(working, outfile):
186
240
    """Show statistics about a working tree."""
187
241
    basis = working.basis_tree()
188
242
    work_inv = working.inventory
189
 
    delta = diff.compare_trees(basis, working, want_unchanged=True)
 
243
    delta = working.changes_from(basis, want_unchanged=True)
190
244
 
191
 
    print
192
 
    print 'In the working tree:'
193
 
    print '  %8s unchanged' % len(delta.unchanged)
194
 
    print '  %8d modified' % len(delta.modified)
195
 
    print '  %8d added' % len(delta.added)
196
 
    print '  %8d removed' % len(delta.removed)
197
 
    print '  %8d renamed' % len(delta.renamed)
 
245
    outfile.write('\n')
 
246
    outfile.write('In the working tree:\n')
 
247
    outfile.write('  %8s unchanged\n' % len(delta.unchanged))
 
248
    outfile.write('  %8d modified\n' % len(delta.modified))
 
249
    outfile.write('  %8d added\n' % len(delta.added))
 
250
    outfile.write('  %8d removed\n' % len(delta.removed))
 
251
    outfile.write('  %8d renamed\n' % len(delta.renamed))
198
252
 
199
253
    ignore_cnt = unknown_cnt = 0
200
254
    for path in working.extras():
202
256
            ignore_cnt += 1
203
257
        else:
204
258
            unknown_cnt += 1
205
 
    print '  %8d unknown' % unknown_cnt
206
 
    print '  %8d ignored' % ignore_cnt
 
259
    outfile.write('  %8d unknown\n' % unknown_cnt)
 
260
    outfile.write('  %8d ignored\n' % ignore_cnt)
207
261
 
208
262
    dir_cnt = 0
209
263
    for file_id in work_inv:
210
 
        if work_inv.get_file_kind(file_id) == 'directory':
 
264
        if (work_inv.get_file_kind(file_id) == 'directory' and 
 
265
            not work_inv.is_root(file_id)):
211
266
            dir_cnt += 1
212
 
    print '  %8d versioned %s' \
213
 
          % (dir_cnt,
214
 
             plural(dir_cnt, 'subdirectory', 'subdirectories'))
215
 
 
216
 
 
217
 
def _show_branch_stats(branch, verbose):
 
267
    outfile.write('  %8d versioned %s\n' % (dir_cnt,
 
268
        plural(dir_cnt, 'subdirectory', 'subdirectories')))
 
269
 
 
270
 
 
271
def _show_branch_stats(branch, verbose, outfile):
218
272
    """Show statistics about a branch."""
219
 
    repository = branch.repository
220
 
    history = branch.revision_history()
221
 
 
222
 
    print
223
 
    print 'Branch history:'
224
 
    revno = len(history)
225
 
    print '  %8d revision%s' % (revno, plural(revno))
 
273
    revno, head = branch.last_revision_info()
 
274
    outfile.write('\n')
 
275
    outfile.write('Branch history:\n')
 
276
    outfile.write('  %8d revision%s\n' % (revno, plural(revno)))
 
277
    stats = branch.repository.gather_stats(head, committers=verbose)
226
278
    if verbose:
227
 
        committers = {}
228
 
        for rev in history:
229
 
            committers[repository.get_revision(rev).committer] = True
230
 
        print '  %8d committer%s' % (len(committers), plural(len(committers)))
231
 
    if revno > 0:
232
 
        firstrev = repository.get_revision(history[0])
233
 
        age = int((time.time() - firstrev.timestamp) / 3600 / 24)
234
 
        print '  %8d day%s old' % (age, plural(age))
235
 
        print '   first revision: %s' % osutils.format_date(firstrev.timestamp,
236
 
                                                            firstrev.timezone)
237
 
 
238
 
        lastrev = repository.get_revision(history[-1])
239
 
        print '  latest revision: %s' % osutils.format_date(lastrev.timestamp,
240
 
                                                            lastrev.timezone)
241
 
 
242
 
#     print
243
 
#     print 'Text store:'
244
 
#     c, t = branch.text_store.total_size()
245
 
#     print '  %8d file texts' % c
246
 
#     print '  %8d KiB' % (t/1024)
247
 
 
248
 
#     print
249
 
#     print 'Inventory store:'
250
 
#     c, t = branch.inventory_store.total_size()
251
 
#     print '  %8d inventories' % c
252
 
#     print '  %8d KiB' % (t/1024)
253
 
 
254
 
 
255
 
def _show_repository_info(repository):
 
279
        committers = stats['committers']
 
280
        outfile.write('  %8d committer%s\n' % (committers,
 
281
            plural(committers)))
 
282
    if revno:
 
283
        timestamp, timezone = stats['firstrev']
 
284
        age = int((time.time() - timestamp) / 3600 / 24)
 
285
        outfile.write('  %8d day%s old\n' % (age, plural(age)))
 
286
        outfile.write('   first revision: %s\n' %
 
287
            osutils.format_date(timestamp, timezone))
 
288
        timestamp, timezone = stats['latestrev']
 
289
        outfile.write('  latest revision: %s\n' %
 
290
            osutils.format_date(timestamp, timezone))
 
291
    return stats
 
292
 
 
293
 
 
294
def _show_repository_info(repository, outfile):
256
295
    """Show settings of a repository."""
257
296
    if repository.make_working_trees():
258
 
        print
259
 
        print 'Create working tree for new branches inside the repository.'
260
 
 
261
 
 
262
 
def _show_repository_stats(repository):
 
297
        outfile.write('\n')
 
298
        outfile.write('Create working tree for new branches inside '
 
299
            'the repository.\n')
 
300
 
 
301
 
 
302
def _show_repository_stats(stats, outfile):
263
303
    """Show statistics about a repository."""
264
 
    if repository.bzrdir.root_transport.listable():
265
 
        print
266
 
        print 'Revision store:'
267
 
        c, t = repository._revision_store.total_size(repository.get_transaction())
268
 
        print '  %8d revision%s' % (c, plural(c))
269
 
        print '  %8d KiB' % (t/1024)
270
 
 
271
 
 
272
 
@deprecated_function(zero_eight)
273
 
def show_info(b):
274
 
    """Please see show_bzrdir_info."""
275
 
    return show_bzrdir_info(b.bzrdir)
276
 
 
277
 
 
278
 
def show_bzrdir_info(a_bzrdir, verbose=False):
 
304
    if 'revisions' in stats or 'size' in stats:
 
305
        outfile.write('\n')
 
306
        outfile.write('Repository:\n')
 
307
    if 'revisions' in stats:
 
308
        revisions = stats['revisions']
 
309
        outfile.write('  %8d revision%s\n' % (revisions, plural(revisions)))
 
310
    if 'size' in stats:
 
311
        outfile.write('  %8d KiB\n' % (stats['size']/1024))
 
312
 
 
313
 
 
314
def show_bzrdir_info(a_bzrdir, verbose=False, outfile=None):
279
315
    """Output to stdout the 'info' for a_bzrdir."""
 
316
    if outfile is None:
 
317
        outfile = sys.stdout
280
318
    try:
281
 
        working = a_bzrdir.open_workingtree()
282
 
        working.lock_read()
283
 
        try:
284
 
            show_tree_info(working, verbose)
285
 
        finally:
286
 
            working.unlock()
287
 
        return
 
319
        tree = a_bzrdir.open_workingtree(
 
320
            recommend_upgrade=False)
288
321
    except (NoWorkingTree, NotLocalUrl):
289
 
        pass
290
 
 
291
 
    try:
292
 
        branch = a_bzrdir.open_branch()
293
 
        branch.lock_read()
294
 
        try:
295
 
            show_branch_info(branch, verbose)
296
 
        finally:
297
 
            branch.unlock()
298
 
        return
299
 
    except NotBranchError:
300
 
        pass
301
 
 
302
 
    try:
303
 
        repository = a_bzrdir.open_repository()
304
 
        repository.lock_read()
305
 
        try:
306
 
            show_repository_info(repository, verbose)
307
 
        finally:
308
 
            repository.unlock()
309
 
        return
310
 
    except NoRepositoryPresent:
311
 
        pass
312
 
 
313
 
    # Return silently, cmd_info already returned NotBranchError if no bzrdir
314
 
    # could be opened.
315
 
 
316
 
 
317
 
def show_tree_info(working, verbose):
318
 
    """Output to stdout the 'info' for working."""
319
 
    branch = working.branch
320
 
    repository = branch.repository
321
 
    control = working.bzrdir
322
 
 
323
 
    _show_location_info(repository, branch, working)
324
 
    _show_related_info(branch)
325
 
    _show_format_info(control, repository, branch, working)
326
 
    _show_locking_info(repository, branch, working)
327
 
    _show_missing_revisions_branch(branch)
328
 
    _show_missing_revisions_working(working)
329
 
    _show_working_stats(working)
330
 
    _show_branch_stats(branch, verbose)
331
 
    _show_repository_stats(repository)
332
 
 
333
 
 
334
 
def show_branch_info(branch, verbose):
335
 
    """Output to stdout the 'info' for branch."""
336
 
    repository = branch.repository
337
 
    control = branch.bzrdir
338
 
 
339
 
    _show_location_info(repository, branch)
340
 
    _show_related_info(branch)
341
 
    _show_format_info(control, repository, branch)
342
 
    _show_locking_info(repository, branch)
343
 
    _show_missing_revisions_branch(branch)
344
 
    _show_branch_stats(branch, verbose)
345
 
    _show_repository_stats(repository)
346
 
 
347
 
 
348
 
def show_repository_info(repository, verbose):
349
 
    """Output to stdout the 'info' for repository."""
350
 
    control = repository.bzrdir
351
 
 
352
 
    _show_location_info(repository)
353
 
    _show_format_info(control, repository)
354
 
    _show_locking_info(repository)
355
 
    _show_repository_info(repository)
356
 
    _show_repository_stats(repository)
 
322
        tree = None
 
323
        try:
 
324
            branch = a_bzrdir.open_branch()
 
325
        except NotBranchError:
 
326
            branch = None
 
327
            try:
 
328
                repository = a_bzrdir.open_repository()
 
329
            except NoRepositoryPresent:
 
330
                # Return silently; cmd_info already returned NotBranchError
 
331
                # if no bzrdir could be opened.
 
332
                return
 
333
            else:
 
334
                lockable = repository
 
335
        else:
 
336
            repository = branch.repository
 
337
            lockable = branch
 
338
    else:
 
339
        branch = tree.branch
 
340
        repository = branch.repository
 
341
        lockable = tree
 
342
 
 
343
    lockable.lock_read()
 
344
    try:
 
345
        show_component_info(a_bzrdir, repository, branch, tree, verbose,
 
346
                            outfile)
 
347
    finally:
 
348
        lockable.unlock()
 
349
 
 
350
 
 
351
def show_component_info(control, repository, branch=None, working=None,
 
352
    verbose=1, outfile=None):
 
353
    """Write info about all bzrdir components to stdout"""
 
354
    if outfile is None:
 
355
        outfile = sys.stdout
 
356
    if verbose is False:
 
357
        verbose = 1
 
358
    if verbose is True:
 
359
        verbose = 2
 
360
    layout = describe_layout(repository, branch, working)
 
361
    format = describe_format(control, repository, branch, working)
 
362
    outfile.write("%s (format: %s)\n" % (layout, format))
 
363
    _show_location_info(gather_location_info(repository, branch, working),
 
364
                        outfile)
 
365
    if branch is not None:
 
366
        _show_related_info(branch, outfile)
 
367
    if verbose == 0:
 
368
        return
 
369
    _show_format_info(control, repository, branch, working, outfile)
 
370
    _show_locking_info(repository, branch, working, outfile)
 
371
    if branch is not None:
 
372
        _show_missing_revisions_branch(branch, outfile)
 
373
    if working is not None:
 
374
        _show_missing_revisions_working(working, outfile)
 
375
        _show_working_stats(working, outfile)
 
376
    elif branch is not None:
 
377
        _show_missing_revisions_branch(branch, outfile)
 
378
    if branch is not None:
 
379
        stats = _show_branch_stats(branch, verbose==2, outfile)
 
380
    else:
 
381
        stats = repository.gather_stats()
 
382
    if branch is None and working is None:
 
383
        _show_repository_info(repository, outfile)
 
384
    _show_repository_stats(stats, outfile)
 
385
 
 
386
 
 
387
def describe_layout(repository=None, branch=None, tree=None):
 
388
    """Convert a control directory layout into a user-understandable term
 
389
 
 
390
    Common outputs include "Standalone tree", "Repository branch" and
 
391
    "Checkout".  Uncommon outputs include "Unshared repository with trees"
 
392
    and "Empty control directory"
 
393
    """
 
394
    if repository is None:
 
395
        return 'Empty control directory'
 
396
    if branch is None and tree is None:
 
397
        if repository.is_shared():
 
398
            phrase = 'Shared repository'
 
399
        else:
 
400
            phrase = 'Unshared repository'
 
401
        if repository.make_working_trees():
 
402
            phrase += ' with trees'
 
403
        return phrase
 
404
    else:
 
405
        if repository.is_shared():
 
406
            independence = "Repository "
 
407
        else:
 
408
            independence = "Standalone "
 
409
        if tree is not None:
 
410
            phrase = "tree"
 
411
        else:
 
412
            phrase = "branch"
 
413
        if branch is None and tree is not None:
 
414
            phrase = "branchless tree"
 
415
        else:
 
416
            if (tree is not None and tree.bzrdir.root_transport.base !=
 
417
                branch.bzrdir.root_transport.base):
 
418
                independence = ''
 
419
                phrase = "Lightweight checkout"
 
420
            elif branch.get_bound_location() is not None:
 
421
                if independence == 'Standalone ':
 
422
                    independence = ''
 
423
                if tree is None:
 
424
                    phrase = "Bound branch"
 
425
                else:
 
426
                    phrase = "Checkout"
 
427
        if independence != "":
 
428
            phrase = phrase.lower()
 
429
        return "%s%s" % (independence, phrase)
 
430
 
 
431
 
 
432
def describe_format(control, repository, branch, tree):
 
433
    """Determine the format of an existing control directory
 
434
 
 
435
    Several candidates may be found.  If so, the names are returned as a
 
436
    single string, separated by ' or '.
 
437
 
 
438
    If no matching candidate is found, "unnamed" is returned.
 
439
    """
 
440
    candidates  = []
 
441
    if (branch is not None and tree is not None and
 
442
        branch.bzrdir.root_transport.base !=
 
443
        tree.bzrdir.root_transport.base):
 
444
        branch = None
 
445
        repository = None
 
446
    non_aliases = set(bzrdir.format_registry.keys())
 
447
    non_aliases.difference_update(bzrdir.format_registry.aliases())
 
448
    for key in non_aliases:
 
449
        format = bzrdir.format_registry.make_bzrdir(key)
 
450
        if isinstance(format, bzrdir.BzrDirMetaFormat1):
 
451
            if (tree and format.workingtree_format !=
 
452
                tree._format):
 
453
                continue
 
454
            if (branch and format.get_branch_format() !=
 
455
                branch._format):
 
456
                continue
 
457
            if (repository and format.repository_format !=
 
458
                repository._format):
 
459
                continue
 
460
        if format.__class__ is not control._format.__class__:
 
461
            continue
 
462
        candidates.append(key)
 
463
    if len(candidates) == 0:
 
464
        return 'unnamed'
 
465
    candidates.sort()
 
466
    new_candidates = [c for c in candidates if not
 
467
        bzrdir.format_registry.get_info(c).hidden]
 
468
    if len(new_candidates) > 0:
 
469
        # If there are any non-hidden formats that match, only return those to
 
470
        # avoid listing hidden formats except when only a hidden format will
 
471
        # do.
 
472
        candidates = new_candidates
 
473
    return ' or '.join(candidates)