1
# Copyright (C) 2005-2010 Canonical Ltd
1
# Copyright (C) 2004, 2005 by Martin Pool
2
# Copyright (C) 2005 by Canonical Ltd
3
5
# This program is free software; you can redistribute it and/or modify
4
6
# it under the terms of the GNU General Public License as published by
5
7
# the Free Software Foundation; either version 2 of the License, or
6
8
# (at your option) any later version.
8
10
# This program is distributed in the hope that it will be useful,
9
11
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
12
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
13
# GNU General Public License for more details.
13
15
# You should have received a copy of the GNU General Public License
14
16
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17
19
__all__ = ['show_bzrdir_info']
19
from cStringIO import StringIO
24
import bzrlib.diff as diff
30
25
from bzrlib.errors import (NoWorkingTree, NotBranchError,
31
26
NoRepositoryPresent, NotLocalUrl)
32
27
from bzrlib.missing import find_unmerged
28
import bzrlib.osutils as osutils
29
from bzrlib.symbol_versioning import *
35
32
def plural(n, base='', pl=None):
44
class LocationList(object):
46
def __init__(self, base_path):
48
self.base_path = base_path
50
def add_url(self, label, url):
51
"""Add a URL to the list, converting it to a path if possible"""
55
path = urlutils.local_path_from_url(url)
56
except errors.InvalidURL:
57
self.locs.append((label, url))
59
self.add_path(label, path)
61
def add_path(self, label, path):
62
"""Add a path, converting it to a relative path if possible"""
64
path = osutils.relpath(self.base_path, path)
65
except errors.PathNotChild:
71
path = path.rstrip('/')
72
self.locs.append((label, path))
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 ]
79
def gather_location_info(repository, branch=None, working=None):
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
91
working_path = working.user_url
41
def _repo_relpath(repo_path, path):
42
"""Return path with common prefix of repository path removed.
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
48
path = osutils.normalizepath(path)
49
repo_path = osutils.normalizepath(repo_path)
52
if osutils.is_inside(repo_path, path):
53
return osutils.relpath(repo_path, path)
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
61
if working and branch:
62
working_path = working.bzrdir.root_transport.base
63
branch_path = branch.bzrdir.root_transport.base
92
64
if working_path != branch_path:
93
locs['light checkout root'] = working_path
94
if master_path != branch_path:
65
# lightweight checkout
66
print ' light checkout root: %s' % working_path
95
67
if repository.is_shared():
96
locs['repository checkout root'] = branch_path
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))
98
locs['checkout root'] = branch_path
99
if working_path != master_path:
100
locs['checkout of branch'] = master_path
73
# lightweight checkout of standalone branch
74
print ' checkout of branch: %s' % branch_path
101
75
elif repository.is_shared():
102
locs['repository branch'] = branch_path
103
elif branch_path is not None:
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():
82
print ' checkout root: %s' % working_path
83
print ' checkout of branch: %s' % branch.get_bound_location()
105
locs['branch root'] = branch_path
86
print ' branch root: %s' % working_path
88
# branch is part of shared repository
89
assert repository.is_shared()
90
branch_path = branch.bzrdir.root_transport.base
91
print ' shared repository: %s' % repository_path
92
print ' repository branch: %s' % (
93
_repo_relpath(repository_path, branch_path))
108
if repository.is_shared():
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:
114
locs['branch root'] = branch_path
115
if master_path != branch_path:
116
locs['bound to branch'] = master_path
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',
126
return [(n, locs[n]) for n in order if n in locs]
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())
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())
145
locs.add_url('stacked on', branch.get_stacked_on_url())
146
except (errors.UnstackableBranchFormat, errors.UnstackableRepositoryFormat,
152
def _show_related_info(branch, outfile):
96
assert repository.is_shared()
97
print ' shared repository: %s' % repository_path
100
def _show_related_info(branch):
153
101
"""Show parent and push location of branch."""
154
locs = _gather_related_branches(branch)
155
if len(locs.locs) > 0:
157
outfile.write('Related branches:\n')
158
outfile.writelines(locs.get_lines())
161
def _show_format_info(control=None, repository=None, branch=None,
162
working=None, outfile=None):
102
if branch.get_parent() or branch.get_push_location():
104
print 'Related branches:'
105
if branch.get_parent():
106
if branch.get_push_location():
107
print ' parent branch: %s' % branch.get_parent()
109
print ' parent branch: %s' % branch.get_parent()
110
if branch.get_push_location():
111
print ' publish to branch: %s' % branch.get_push_location()
114
def _show_format_info(control=None, repository=None, branch=None, working=None):
163
115
"""Show known formats for control, working, branch and repository."""
165
outfile.write('Format:\n')
167
outfile.write(' control: %s\n' %
168
control._format.get_format_description())
119
print ' control: %s' % control._format.get_format_description()
170
outfile.write(' working tree: %s\n' %
171
working._format.get_format_description())
121
print ' working tree: %s' % working._format.get_format_description()
173
outfile.write(' branch: %s\n' %
174
branch._format.get_format_description())
123
print ' branch: %s' % branch._format.get_format_description()
176
outfile.write(' repository: %s\n' %
177
repository._format.get_format_description())
180
def _show_locking_info(repository, branch=None, working=None, outfile=None):
125
print ' repository: %s' % repository._format.get_format_description()
128
def _show_locking_info(repository, branch=None, working=None):
181
129
"""Show locking status of working, branch and repository."""
182
130
if (repository.get_physical_lock_status() or
183
131
(branch and branch.get_physical_lock_status()) or
184
132
(working and working.get_physical_lock_status())):
186
outfile.write('Lock status:\n')
188
136
if working.get_physical_lock_status():
189
137
status = 'locked'
191
139
status = 'unlocked'
192
outfile.write(' working tree: %s\n' % status)
140
print ' working tree: %s' % status
194
142
if branch.get_physical_lock_status():
195
143
status = 'locked'
197
145
status = 'unlocked'
198
outfile.write(' branch: %s\n' % status)
146
print ' branch: %s' % status
200
148
if repository.get_physical_lock_status():
201
149
status = 'locked'
203
151
status = 'unlocked'
204
outfile.write(' repository: %s\n' % status)
207
def _show_missing_revisions_branch(branch, outfile):
152
print ' repository: %s' % status
155
def _show_missing_revisions_branch(branch):
208
156
"""Show missing master revisions in branch."""
209
157
# Try with inaccessible branch ?
210
158
master = branch.get_master_branch()
212
160
local_extra, remote_extra = find_unmerged(branch, master)
215
outfile.write(('Branch is out of date: missing %d '
216
'revision%s.\n') % (len(remote_extra),
217
plural(len(remote_extra))))
220
def _show_missing_revisions_working(working, outfile):
163
print 'Branch is out of date: missing %d revision%s.' % (
164
len(remote_extra), plural(len(remote_extra)))
167
def _show_missing_revisions_working(working):
221
168
"""Show missing revisions in working tree."""
222
169
branch = working.branch
223
170
basis = working.basis_tree()
224
171
work_inv = working.inventory
225
branch_revno, branch_last_revision = branch.last_revision_info()
227
tree_last_id = working.get_parent_ids()[0]
172
delta = diff.compare_trees(basis, working, want_unchanged=True)
173
history = branch.revision_history()
174
tree_last_id = working.last_revision()
231
if branch_revno and tree_last_id != branch_last_revision:
176
if len(history) and tree_last_id != history[-1]:
232
177
tree_last_revno = branch.revision_id_to_revno(tree_last_id)
233
missing_count = branch_revno - tree_last_revno
235
outfile.write(('Working tree is out of date: missing %d '
236
'revision%s.\n') % (missing_count, plural(missing_count)))
239
def _show_working_stats(working, outfile):
178
missing_count = len(history) - tree_last_revno
180
print 'Working tree is out of date: missing %d revision%s.' % (
181
missing_count, plural(missing_count))
184
def _show_working_stats(working):
240
185
"""Show statistics about a working tree."""
241
186
basis = working.basis_tree()
242
187
work_inv = working.inventory
243
delta = working.changes_from(basis, want_unchanged=True)
188
delta = diff.compare_trees(basis, working, want_unchanged=True)
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))
191
print 'In the working tree:'
192
print ' %8s unchanged' % len(delta.unchanged)
193
print ' %8d modified' % len(delta.modified)
194
print ' %8d added' % len(delta.added)
195
print ' %8d removed' % len(delta.removed)
196
print ' %8d renamed' % len(delta.renamed)
253
198
ignore_cnt = unknown_cnt = 0
254
199
for path in working.extras():
259
outfile.write(' %8d unknown\n' % unknown_cnt)
260
outfile.write(' %8d ignored\n' % ignore_cnt)
204
print ' %8d unknown' % unknown_cnt
205
print ' %8d ignored' % ignore_cnt
263
208
for file_id in work_inv:
264
if (work_inv.get_file_kind(file_id) == 'directory' and
265
not work_inv.is_root(file_id)):
209
if work_inv.get_file_kind(file_id) == 'directory':
267
outfile.write(' %8d versioned %s\n' % (dir_cnt,
268
plural(dir_cnt, 'subdirectory', 'subdirectories')))
271
def _show_branch_stats(branch, verbose, outfile):
211
print ' %8d versioned %s' \
213
plural(dir_cnt, 'subdirectory', 'subdirectories'))
216
def _show_branch_stats(branch, verbose):
272
217
"""Show statistics about a branch."""
273
revno, head = branch.last_revision_info()
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)
218
repository = branch.repository
219
history = branch.revision_history()
222
print 'Branch history:'
224
print ' %8d revision%s' % (revno, plural(revno))
279
committers = stats['committers']
280
outfile.write(' %8d committer%s\n' % (committers,
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))
294
def _show_repository_info(repository, outfile):
228
committers[repository.get_revision(rev).committer] = True
229
print ' %8d committer%s' % (len(committers), plural(len(committers)))
231
firstrev = repository.get_revision(history[0])
232
age = int((time.time() - firstrev.timestamp) / 3600 / 24)
233
print ' %8d day%s old' % (age, plural(age))
234
print ' first revision: %s' % osutils.format_date(firstrev.timestamp,
237
lastrev = repository.get_revision(history[-1])
238
print ' latest revision: %s' % osutils.format_date(lastrev.timestamp,
242
# print 'Text store:'
243
# c, t = branch.text_store.total_size()
244
# print ' %8d file texts' % c
245
# print ' %8d KiB' % (t/1024)
248
# print 'Inventory store:'
249
# c, t = branch.inventory_store.total_size()
250
# print ' %8d inventories' % c
251
# print ' %8d KiB' % (t/1024)
254
def _show_repository_info(repository):
295
255
"""Show settings of a repository."""
296
256
if repository.make_working_trees():
298
outfile.write('Create working tree for new branches inside '
302
def _show_repository_stats(repository, stats, outfile):
258
print 'Create working tree for new branches inside the repository.'
261
def _show_repository_stats(repository):
303
262
"""Show statistics about a repository."""
305
if 'revisions' in stats:
306
revisions = stats['revisions']
307
f.write(' %8d revision%s\n' % (revisions, plural(revisions)))
309
f.write(' %8d KiB\n' % (stats['size']/1024))
310
for hook in hooks['repository']:
311
hook(repository, stats, f)
312
if f.getvalue() != "":
314
outfile.write('Repository:\n')
315
outfile.write(f.getvalue())
318
def show_bzrdir_info(a_bzrdir, verbose=False, outfile=None):
263
if repository.bzrdir.root_transport.listable():
265
print 'Revision store:'
266
c, t = repository._revision_store.total_size(repository.get_transaction())
267
print ' %8d revision%s' % (c, plural(c))
268
print ' %8d KiB' % (t/1024)
271
@deprecated_function(zero_eight)
273
"""Please see show_bzrdir_info."""
274
return show_bzrdir_info(b.bzrdir)
277
def show_bzrdir_info(a_bzrdir, verbose=False):
319
278
"""Output to stdout the 'info' for a_bzrdir."""
323
tree = a_bzrdir.open_workingtree(
324
recommend_upgrade=False)
280
working = a_bzrdir.open_workingtree()
283
show_tree_info(working, verbose)
325
287
except (NoWorkingTree, NotLocalUrl):
328
branch = a_bzrdir.open_branch()
329
except NotBranchError:
332
repository = a_bzrdir.open_repository()
333
except NoRepositoryPresent:
334
# Return silently; cmd_info already returned NotBranchError
335
# if no bzrdir could be opened.
338
lockable = repository
340
repository = branch.repository
344
repository = branch.repository
349
show_component_info(a_bzrdir, repository, branch, tree, verbose,
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"""
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),
369
if branch is not None:
370
_show_related_info(branch, outfile)
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)
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)
392
def describe_layout(repository=None, branch=None, tree=None):
393
"""Convert a control directory layout into a user-understandable term
395
Common outputs include "Standalone tree", "Repository branch" and
396
"Checkout". Uncommon outputs include "Unshared repository with trees"
397
and "Empty control directory"
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'
405
phrase = 'Unshared repository'
406
if repository.make_working_trees():
407
phrase += ' with trees'
410
if repository.is_shared():
411
independence = "Repository "
413
independence = "Standalone "
418
if branch is None and tree is not None:
419
phrase = "branchless tree"
421
if (tree is not None and tree.user_url !=
424
phrase = "Lightweight checkout"
425
elif branch.get_bound_location() is not None:
426
if independence == 'Standalone ':
429
phrase = "Bound branch"
432
if independence != "":
433
phrase = phrase.lower()
434
return "%s%s" % (independence, phrase)
437
def describe_format(control, repository, branch, tree):
438
"""Determine the format of an existing control directory
440
Several candidates may be found. If so, the names are returned as a
441
single string, separated by ' or '.
443
If no matching candidate is found, "unnamed" is returned.
446
if (branch is not None and tree is not None and
447
branch.user_url != tree.user_url):
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 !=
458
if (branch and format.get_branch_format() !=
461
if (repository and format.repository_format !=
464
if format.__class__ is not control._format.__class__:
466
candidates.append(key)
467
if len(candidates) == 0:
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
476
candidates = new_candidates
477
return ' or '.join(candidates)
480
class InfoHooks(_mod_hooks.Hooks):
481
"""Hooks for the info command."""
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),
291
branch = a_bzrdir.open_branch()
294
show_branch_info(branch, verbose)
298
except NotBranchError:
302
repository = a_bzrdir.open_repository()
303
repository.lock_read()
305
show_repository_info(repository, verbose)
309
except NoRepositoryPresent:
312
# Return silently, cmd_info already returned NotBranchError if no bzrdir
316
def show_tree_info(working, verbose):
317
"""Output to stdout the 'info' for working."""
318
branch = working.branch
319
repository = branch.repository
320
control = working.bzrdir
322
_show_location_info(repository, branch, working)
323
_show_related_info(branch)
324
_show_format_info(control, repository, branch, working)
325
_show_locking_info(repository, branch, working)
326
_show_missing_revisions_branch(branch)
327
_show_missing_revisions_working(working)
328
_show_working_stats(working)
329
_show_branch_stats(branch, verbose)
330
_show_repository_stats(repository)
333
def show_branch_info(branch, verbose):
334
"""Output to stdout the 'info' for branch."""
335
repository = branch.repository
336
control = branch.bzrdir
338
_show_location_info(repository, branch)
339
_show_related_info(branch)
340
_show_format_info(control, repository, branch)
341
_show_locking_info(repository, branch)
342
_show_missing_revisions_branch(branch)
343
_show_branch_stats(branch, verbose)
344
_show_repository_stats(repository)
347
def show_repository_info(repository, verbose):
348
"""Output to stdout the 'info' for repository."""
349
control = repository.bzrdir
351
_show_location_info(repository)
352
_show_format_info(control, repository)
353
_show_locking_info(repository)
354
_show_repository_info(repository)
355
_show_repository_stats(repository)