1
# Copyright (C) 2005, 2006, 2007 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
17
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17
__all__ = ['show_bzrdir_info']
30
from bzrlib.errors import (NoWorkingTree, NotBranchError,
31
NoRepositoryPresent, NotLocalUrl)
32
from bzrlib.missing import find_unmerged
33
from bzrlib.symbol_versioning import (deprecated_function,
37
def plural(n, base='', pl=None):
46
class LocationList(object):
48
def __init__(self, base_path):
50
self.base_path = base_path
52
def add_url(self, label, url):
53
"""Add a URL to the list, converting it to a path if possible"""
57
path = urlutils.local_path_from_url(url)
58
except errors.InvalidURL:
59
self.locs.append((label, url))
61
self.add_path(label, path)
63
def add_path(self, label, path):
64
"""Add a path, converting it to a relative path if possible"""
66
path = osutils.relpath(self.base_path, path)
67
except errors.PathNotChild:
73
path = path.rstrip('/')
74
self.locs.append((label, path))
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 ]
81
def gather_location_info(repository, branch=None, working=None):
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
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
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:
107
locs['branch root'] = branch_path
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:
116
locs['branch root'] = branch_path
117
if master_path != branch_path:
118
locs['bound to branch'] = master_path
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',
128
return [(n, locs[n]) for n in order if n in locs]
131
def _show_location_info(locs, outfile):
132
"""Show known locations for working, branch and repository."""
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())
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())
149
def _show_related_info(branch, outfile):
150
"""Show parent and push location of branch."""
151
locs = _gather_related_branches(branch)
152
if len(locs.locs) > 0:
154
outfile.write('Related branches:\n')
155
outfile.writelines(locs.get_lines())
158
def _show_format_info(control=None, repository=None, branch=None,
159
working=None, outfile=None):
160
"""Show known formats for control, working, branch and repository."""
162
outfile.write('Format:\n')
164
outfile.write(' control: %s\n' %
165
control._format.get_format_description())
167
outfile.write(' working tree: %s\n' %
168
working._format.get_format_description())
170
outfile.write(' branch: %s\n' %
171
branch._format.get_format_description())
173
outfile.write(' repository: %s\n' %
174
repository._format.get_format_description())
177
def _show_locking_info(repository, branch=None, working=None, outfile=None):
178
"""Show locking status of working, branch and repository."""
179
if (repository.get_physical_lock_status() or
180
(branch and branch.get_physical_lock_status()) or
181
(working and working.get_physical_lock_status())):
183
outfile.write('Lock status:\n')
185
if working.get_physical_lock_status():
189
outfile.write(' working tree: %s\n' % status)
191
if branch.get_physical_lock_status():
195
outfile.write(' branch: %s\n' % status)
197
if repository.get_physical_lock_status():
201
outfile.write(' repository: %s\n' % status)
204
def _show_missing_revisions_branch(branch, outfile):
205
"""Show missing master revisions in branch."""
206
# Try with inaccessible branch ?
207
master = branch.get_master_branch()
209
local_extra, remote_extra = find_unmerged(branch, master)
212
outfile.write(('Branch is out of date: missing %d '
213
'revision%s.\n') % (len(remote_extra),
214
plural(len(remote_extra))))
217
def _show_missing_revisions_working(working, outfile):
218
"""Show missing revisions in working tree."""
219
branch = working.branch
220
basis = working.basis_tree()
221
work_inv = working.inventory
222
branch_revno, branch_last_revision = branch.last_revision_info()
224
tree_last_id = working.get_parent_ids()[0]
228
if branch_revno and tree_last_id != branch_last_revision:
229
tree_last_revno = branch.revision_id_to_revno(tree_last_id)
230
missing_count = branch_revno - tree_last_revno
232
outfile.write(('Working tree is out of date: missing %d '
233
'revision%s.\n') % (missing_count, plural(missing_count)))
236
def _show_working_stats(working, outfile):
237
"""Show statistics about a working tree."""
238
basis = working.basis_tree()
239
work_inv = working.inventory
240
delta = working.changes_from(basis, want_unchanged=True)
243
outfile.write('In the working tree:\n')
244
outfile.write(' %8s unchanged\n' % len(delta.unchanged))
245
outfile.write(' %8d modified\n' % len(delta.modified))
246
outfile.write(' %8d added\n' % len(delta.added))
247
outfile.write(' %8d removed\n' % len(delta.removed))
248
outfile.write(' %8d renamed\n' % len(delta.renamed))
21
from bzrlib.osutils import format_date
25
# surely there's a builtin for this?
36
print 'branch format:', b.controlfile('branch-format', 'r').readline().rstrip('\n')
38
def plural(n, base='', pl=None):
46
count_version_dirs = 0
48
basis = b.basis_tree()
49
working = b.working_tree()
50
work_inv = working.inventory
51
delta = diff.compare_trees(basis, working, want_unchanged=True)
54
print 'in the working tree:'
55
print ' %8s unchanged' % len(delta.unchanged)
56
print ' %8d modified' % len(delta.modified)
57
print ' %8d added' % len(delta.added)
58
print ' %8d removed' % len(delta.removed)
59
print ' %8d renamed' % len(delta.renamed)
250
61
ignore_cnt = unknown_cnt = 0
251
62
for path in working.extras():
256
outfile.write(' %8d unknown\n' % unknown_cnt)
257
outfile.write(' %8d ignored\n' % ignore_cnt)
68
print ' %8d unknown' % unknown_cnt
69
print ' %8d ignored' % ignore_cnt
260
72
for file_id in work_inv:
261
if (work_inv.get_file_kind(file_id) == 'directory' and
262
not work_inv.is_root(file_id)):
73
if work_inv.get_file_kind(file_id) == 'directory':
264
outfile.write(' %8d versioned %s\n' % (dir_cnt,
265
plural(dir_cnt, 'subdirectory', 'subdirectories')))
268
def _show_branch_stats(branch, verbose, outfile):
269
"""Show statistics about a branch."""
270
revno, head = branch.last_revision_info()
272
outfile.write('Branch history:\n')
273
outfile.write(' %8d revision%s\n' % (revno, plural(revno)))
274
stats = branch.repository.gather_stats(head, committers=verbose)
276
committers = stats['committers']
277
outfile.write(' %8d committer%s\n' % (committers,
280
timestamp, timezone = stats['firstrev']
281
age = int((time.time() - timestamp) / 3600 / 24)
282
outfile.write(' %8d day%s old\n' % (age, plural(age)))
283
outfile.write(' first revision: %s\n' %
284
osutils.format_date(timestamp, timezone))
285
timestamp, timezone = stats['latestrev']
286
outfile.write(' latest revision: %s\n' %
287
osutils.format_date(timestamp, timezone))
291
def _show_repository_info(repository, outfile):
292
"""Show settings of a repository."""
293
if repository.make_working_trees():
295
outfile.write('Create working tree for new branches inside '
299
def _show_repository_stats(stats, outfile):
300
"""Show statistics about a repository."""
301
if 'revisions' in stats or 'size' in stats:
303
outfile.write('Repository:\n')
304
if 'revisions' in stats:
305
revisions = stats['revisions']
306
outfile.write(' %8d revision%s\n' % (revisions, plural(revisions)))
308
outfile.write(' %8d KiB\n' % (stats['size']/1024))
311
def show_bzrdir_info(a_bzrdir, verbose=False, outfile=None):
312
"""Output to stdout the 'info' for a_bzrdir."""
316
tree = a_bzrdir.open_workingtree(
317
recommend_upgrade=False)
318
except (NoWorkingTree, NotLocalUrl):
321
branch = a_bzrdir.open_branch()
322
except NotBranchError:
325
repository = a_bzrdir.open_repository()
326
except NoRepositoryPresent:
327
# Return silently; cmd_info already returned NotBranchError
328
# if no bzrdir could be opened.
331
lockable = repository
333
repository = branch.repository
337
repository = branch.repository
342
show_component_info(a_bzrdir, repository, branch, tree, verbose,
348
def show_component_info(control, repository, branch=None, working=None,
349
verbose=1, outfile=None):
350
"""Write info about all bzrdir components to stdout"""
357
layout = describe_layout(repository, branch, working)
358
format = describe_format(control, repository, branch, working)
359
outfile.write("%s (format: %s)\n" % (layout, format))
360
_show_location_info(gather_location_info(repository, branch, working),
362
if branch is not None:
363
_show_related_info(branch, outfile)
366
_show_format_info(control, repository, branch, working, outfile)
367
_show_locking_info(repository, branch, working, outfile)
368
if branch is not None:
369
_show_missing_revisions_branch(branch, outfile)
370
if working is not None:
371
_show_missing_revisions_working(working, outfile)
372
_show_working_stats(working, outfile)
373
elif branch is not None:
374
_show_missing_revisions_branch(branch, outfile)
375
if branch is not None:
376
stats = _show_branch_stats(branch, verbose==2, outfile)
378
stats = repository.gather_stats()
379
if branch is None and working is None:
380
_show_repository_info(repository, outfile)
381
_show_repository_stats(stats, outfile)
384
def describe_layout(repository=None, branch=None, tree=None):
385
"""Convert a control directory layout into a user-understandable term
387
Common outputs include "Standalone tree", "Repository branch" and
388
"Checkout". Uncommon outputs include "Unshared repository with trees"
389
and "Empty control directory"
391
if repository is None:
392
return 'Empty control directory'
393
if branch is None and tree is None:
394
if repository.is_shared():
395
phrase = 'Shared repository'
397
phrase = 'Unshared repository'
398
if repository.make_working_trees():
399
phrase += ' with trees'
402
if repository.is_shared():
403
independence = "Repository "
405
independence = "Standalone "
410
if branch is None and tree is not None:
411
phrase = "branchless tree"
413
if (tree is not None and tree.bzrdir.root_transport.base !=
414
branch.bzrdir.root_transport.base):
416
phrase = "Lightweight checkout"
417
elif branch.get_bound_location() is not None:
418
if independence == 'Standalone ':
421
phrase = "Bound branch"
424
if independence != "":
425
phrase = phrase.lower()
426
return "%s%s" % (independence, phrase)
429
def describe_format(control, repository, branch, tree):
430
"""Determine the format of an existing control directory
432
Several candidates may be found. If so, the names are returned as a
433
single string, separated by ' or '.
435
If no matching candidate is found, "unnamed" is returned.
438
if (branch is not None and tree is not None and
439
branch.bzrdir.root_transport.base !=
440
tree.bzrdir.root_transport.base):
443
non_aliases = set(bzrdir.format_registry.keys())
444
non_aliases.difference_update(bzrdir.format_registry.aliases())
445
for key in non_aliases:
446
format = bzrdir.format_registry.make_bzrdir(key)
447
if isinstance(format, bzrdir.BzrDirMetaFormat1):
448
if (tree and format.workingtree_format !=
451
if (branch and format.get_branch_format() !=
454
if (repository and format.repository_format !=
457
if format.__class__ is not control._format.__class__:
459
candidates.append(key)
460
if len(candidates) == 0:
463
new_candidates = [c for c in candidates if not
464
bzrdir.format_registry.get_info(c).hidden]
465
if len(new_candidates) > 0:
466
# If there are any non-hidden formats that match, only return those to
467
# avoid listing hidden formats except when only a hidden format will
469
candidates = new_candidates
470
return ' or '.join(candidates)
75
print ' %8d versioned %s' \
77
plural(dir_cnt, 'subdirectory', 'subdirectories'))
80
print 'branch history:'
81
history = b.revision_history()
83
print ' %8d revision%s' % (revno, plural(revno))
86
committers[b.get_revision(rev).committer] = True
87
print ' %8d committer%s' % (len(committers), plural(len(committers)))
89
firstrev = b.get_revision(history[0])
90
age = int((time.time() - firstrev.timestamp) / 3600 / 24)
91
print ' %8d day%s old' % (age, plural(age))
92
print ' first revision: %s' % format_date(firstrev.timestamp,
95
lastrev = b.get_revision(history[-1])
96
print ' latest revision: %s' % format_date(lastrev.timestamp,
100
# print 'text store:'
101
# c, t = b.text_store.total_size()
102
# print ' %8d file texts' % c
103
# print ' %8d kB' % (t/1024)
106
print 'revision store:'
107
c, t = b.revision_store.total_size()
108
print ' %8d revisions' % c
109
print ' %8d kB' % (t/1024)
113
# print 'inventory store:'
114
# c, t = b.inventory_store.total_size()
115
# print ' %8d inventories' % c
116
# print ' %8d kB' % (t/1024)
added
removed
bzrlib/info.py
