← 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: 2013-05-23 10:35:23 UTC
  • mfrom: (6574.1.1 integration)
  • Revision ID: pqm@pqm.ubuntu.com-20130523103523-2wt6jmauja1n1vdt
(jameinel) Merge bzr/2.5 into trunk. (John A Meinel)

Show diffs side-by-side

added added

removed removed

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