/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/info.py

  • Committer: Martin Pool
  • Date: 2009-12-08 09:17:34 UTC
  • mto: This revision was merged to the branch mainline in revision 4880.
  • Revision ID: mbp@sourcefrog.net-20091208091734-1ktawydv0whimork
TextUIOutputStream must have an .encoding

Show diffs side-by-side

added added

removed removed

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