/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: Robert Collins
  • Date: 2010-05-05 00:05:29 UTC
  • mto: This revision was merged to the branch mainline in revision 5206.
  • Revision ID: robertc@robertcollins.net-20100505000529-ltmllyms5watqj5u
Make 'pydoc bzrlib.tests.build_tree_shape' useful.

Show diffs side-by-side

added added

removed removed

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