196
203
# list indexes are 0-based; revisions are 1-based
197
204
cut_revs = which_revs[(start_revision-1):(end_revision)]
201
# convert the revision history to a dictionary:
202
rev_nos = dict((k, v) for v, k in cut_revs)
204
# override the mainline to look like the revision history.
205
mainline_revs = [revision_id for index, revision_id in cut_revs]
206
if cut_revs[0][0] == 1:
207
mainline_revs.insert(0, None)
209
mainline_revs.insert(0, which_revs[start_revision-2][1])
210
# how should we show merged revisions ?
211
# old api: show_merge. New api: show_merge_revno
212
show_merge_revno = getattr(lf, 'show_merge_revno', None)
213
show_merge = getattr(lf, 'show_merge', None)
214
if show_merge is None and show_merge_revno is None:
215
# no merged-revno support
216
include_merges = False
218
include_merges = True
219
if show_merge is not None and show_merge_revno is None:
220
# tell developers to update their code
221
symbol_versioning.warn('LogFormatters should provide show_merge_revno '
222
'instead of show_merge since bzr 0.11.',
223
DeprecationWarning, stacklevel=3)
224
view_revisions = list(get_view_revisions(mainline_revs, rev_nos, branch,
225
direction, include_merges=include_merges))
227
def iter_revisions():
228
# r = revision, n = revno, d = merge depth
229
revision_ids = [r for r, n, d in view_revisions]
230
zeros = set(r for r, n, d in view_revisions if d == 0)
232
repository = branch.repository
235
revisions = repository.get_revisions(revision_ids[:num])
236
if verbose or specific_fileid:
237
delta_revisions = [r for r in revisions if
238
r.revision_id in zeros]
239
deltas = repository.get_deltas_for_revisions(delta_revisions)
240
cur_deltas = dict(izip((r.revision_id for r in
241
delta_revisions), deltas))
242
for revision in revisions:
243
# The delta value will be None unless
244
# 1. verbose or specific_fileid is specified, and
245
# 2. the revision is a mainline revision
246
yield revision, cur_deltas.get(revision.revision_id)
247
revision_ids = revision_ids[num:]
206
if direction == 'reverse':
208
elif direction == 'forward':
211
raise ValueError('invalid direction %r' % direction)
213
revision_history = branch.revision_history()
214
for revno, rev_id in cut_revs:
215
if verbose or specific_fileid:
216
delta = _get_revision_delta(branch, revno)
250
# now we just print all the revisions
251
for ((rev_id, revno, merge_depth), (rev, delta)) in \
252
izip(view_revisions, iter_revisions()):
219
if not delta.touches_file_id(specific_fileid):
223
# although we calculated it, throw it away without display
226
rev = branch.repository.get_revision(rev_id)
255
229
if not searchRE.search(rev.message):
259
# a mainline revision.
262
if not delta.touches_file_id(specific_fileid):
232
lf.show(revno, rev, delta)
233
if hasattr(lf, 'show_merge'):
237
# revno is 1 based, so -2 to get back 1 less.
238
repository = branch.repository
239
excludes = repository.get_ancestry(revision_history[revno - 2])
240
excludes = set(excludes)
241
pending = list(rev.parent_ids)
243
rev_id = pending.pop()
244
if rev_id in excludes:
246
# prevent showing merged revs twice if they multi-path.
249
rev = branch.repository.get_revision(rev_id)
250
except errors.NoSuchRevision:
252
pending.extend(rev.parent_ids)
256
def deltas_for_log_dummy(branch, which_revs):
257
"""Return all the revisions without intermediate deltas.
259
Useful for log commands that won't need the delta information.
266
# although we calculated it, throw it away without display
269
lf.show(revno, rev, delta)
262
for revno, revision_id in which_revs:
263
yield revno, branch.get_revision(revision_id), None
266
def deltas_for_log_reverse(branch, which_revs):
267
"""Compute deltas for display in latest-to-earliest order.
273
Sequence of (revno, revision_id) for the subset of history to examine
276
Sequence of (revno, rev, delta)
278
The delta is from the given revision to the next one in the
279
sequence, which makes sense if the log is being displayed from
282
last_revno = last_revision_id = last_tree = None
283
for revno, revision_id in which_revs:
284
this_tree = branch.revision_tree(revision_id)
285
this_revision = branch.get_revision(revision_id)
288
yield last_revno, last_revision, compare_trees(this_tree, last_tree, False)
290
this_tree = EmptyTree(branch.get_root_id())
293
last_revision = this_revision
294
last_tree = this_tree
298
this_tree = EmptyTree(branch.get_root_id())
271
if show_merge_revno is None:
272
lf.show_merge(rev, merge_depth)
300
this_revno = last_revno - 1
301
this_revision_id = branch.revision_history()[this_revno]
302
this_tree = branch.revision_tree(this_revision_id)
303
yield last_revno, last_revision, compare_trees(this_tree, last_tree, False)
306
def deltas_for_log_forward(branch, which_revs):
307
"""Compute deltas for display in forward log.
309
Given a sequence of (revno, revision_id) pairs, return
312
The delta is from the given revision to the next one in the
313
sequence, which makes sense if the log is being displayed from
316
last_revno = last_revision_id = last_tree = None
317
prev_tree = EmptyTree(branch.get_root_id())
319
for revno, revision_id in which_revs:
320
this_tree = branch.revision_tree(revision_id)
321
this_revision = branch.get_revision(revision_id)
325
last_tree = EmptyTree(branch.get_root_id())
274
lf.show_merge_revno(rev, merge_depth, revno)
277
def get_view_revisions(mainline_revs, rev_nos, branch, direction,
278
include_merges=True):
279
"""Produce an iterator of revisions to show
280
:return: an iterator of (revision_id, revno, merge_depth)
281
(if there is no revno for a revision, None is supplied)
283
if include_merges is False:
284
revision_ids = mainline_revs[1:]
285
if direction == 'reverse':
286
revision_ids.reverse()
287
for revision_id in revision_ids:
288
yield revision_id, str(rev_nos[revision_id]), 0
290
merge_sorted_revisions = merge_sort(
291
branch.repository.get_revision_graph(mainline_revs[-1]),
296
if direction == 'forward':
297
# forward means oldest first.
298
merge_sorted_revisions = reverse_by_depth(merge_sorted_revisions)
299
elif direction != 'reverse':
300
raise ValueError('invalid direction %r' % direction)
302
for sequence, rev_id, merge_depth, revno, end_of_merge in merge_sorted_revisions:
303
yield rev_id, '.'.join(map(str, revno)), merge_depth
306
def reverse_by_depth(merge_sorted_revisions, _depth=0):
307
"""Reverse revisions by depth.
309
Revisions with a different depth are sorted as a group with the previous
310
revision of that depth. There may be no topological justification for this,
311
but it looks much nicer.
314
for val in merge_sorted_revisions:
316
zd_revisions.append([val])
318
assert val[2] > _depth
319
zd_revisions[-1].append(val)
320
for revisions in zd_revisions:
321
if len(revisions) > 1:
322
revisions[1:] = reverse_by_depth(revisions[1:], _depth + 1)
323
zd_revisions.reverse()
325
for chunk in zd_revisions:
327
last_revno = revno - 1
328
last_revision_id = branch.revision_history()[last_revno]
329
last_tree = branch.revision_tree(last_revision_id)
331
yield revno, this_revision, compare_trees(last_tree, this_tree, False)
334
last_revision = this_revision
335
last_tree = this_tree
330
338
class LogFormatter(object):
331
339
"""Abstract class to display log messages."""
333
340
def __init__(self, to_file, show_ids=False, show_timezone='original'):
334
341
self.to_file = to_file
335
342
self.show_ids = show_ids
336
343
self.show_timezone = show_timezone
338
346
def show(self, revno, rev, delta):
339
347
raise NotImplementedError('not implemented in abstract base')
346
354
def show(self, revno, rev, delta):
347
355
return self._show_helper(revno=revno, rev=rev, delta=delta)
349
@deprecated_method(zero_eleven)
350
def show_merge(self, rev, merge_depth):
351
return self._show_helper(rev=rev, indent=' '*merge_depth, merged=True, delta=None)
353
def show_merge_revno(self, rev, merge_depth, revno):
354
"""Show a merged revision rev, with merge_depth and a revno."""
355
return self._show_helper(rev=rev, revno=revno,
356
indent=' '*merge_depth, merged=True, delta=None)
357
def show_merge(self, rev):
358
return self._show_helper(rev=rev, indent=' ', merged=True, delta=None)
358
360
def _show_helper(self, rev=None, revno=None, indent='', merged=False, delta=None):
359
"""Show a revision, either merged or not."""
361
"""Show a revision, either merged or not."""
360
362
from bzrlib.osutils import format_date
361
363
to_file = self.to_file
362
364
print >>to_file, indent+'-' * 60
363
365
if revno is not None:
364
print >>to_file, indent+'revno:', revno
366
print >>to_file, 'revno:', revno
366
368
print >>to_file, indent+'merged:', rev.revision_id
367
369
elif self.show_ids:
437
438
return rev.message
439
440
def show(self, revno, rev, delta):
440
from bzrlib.osutils import terminal_width
441
print >> self.to_file, self.log_string(revno, rev, terminal_width()-1)
441
print >> self.to_file, self.log_string(rev, 79)
443
def log_string(self, revno, rev, max_chars):
444
"""Format log info into one string. Truncate tail of string
445
:param revno: revision number (int) or None.
446
Revision numbers counts from 1.
447
:param rev: revision info object
448
:param max_chars: maximum length of resulting string
449
:return: formatted truncated string
453
# show revno only when is not None
454
out.append("%s:" % revno)
455
out.append(self.truncate(self.short_committer(rev), 20))
443
def log_string(self, rev, max_chars):
444
out = [self.truncate(self.short_committer(rev), 20)]
456
445
out.append(self.date_string(rev))
457
out.append(rev.get_summary())
446
out.append(self.message(rev).replace('\n', ' '))
458
447
return self.truncate(" ".join(out).rstrip('\n'), max_chars)
461
449
def line_log(rev, max_chars):
462
450
lf = LineLogFormatter(None)
463
return lf.log_string(None, rev, max_chars)
466
class LogFormatterRegistry(registry.Registry):
467
"""Registry for log formatters"""
469
def make_formatter(self, name, *args, **kwargs):
470
"""Construct a formatter from arguments.
472
:param name: Name of the formatter to construct. 'short', 'long' and
475
return self.get(name)(*args, **kwargs)
477
def get_default(self, branch):
478
return self.get(branch.get_config().log_format())
481
log_formatter_registry = LogFormatterRegistry()
484
log_formatter_registry.register('short', ShortLogFormatter,
485
'Moderately short log format')
486
log_formatter_registry.register('long', LongLogFormatter,
487
'Detailed log format')
488
log_formatter_registry.register('line', LineLogFormatter,
489
'Log format with one line per revision')
451
return lf.log_string(rev, max_chars)
454
'long': LongLogFormatter,
455
'short': ShortLogFormatter,
456
'line': LineLogFormatter,
492
459
def register_formatter(name, formatter):
493
log_formatter_registry.register(name, formatter)
460
FORMATTERS[name] = formatter
496
462
def log_formatter(name, *args, **kwargs):
497
463
"""Construct a formatter from arguments.