← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/info.py

  • Committer: Patch Queue Manager
  • Date: 2011-09-22 14:12:18 UTC
  • mfrom: (6155.3.1 jam)
  • Revision ID: pqm@pqm.ubuntu.com-20110922141218-86s4uu6nqvourw4f
(jameinel) Cleanup comments bzrlib/smart/__init__.py (John A Meinel)

Show diffs side-by-side

added added

removed removed

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