207
mainline_revs, rev_nos, start_rev_id, end_rev_id = \
208
_get_mainline_revs(branch, start_revision, end_revision)
209
if not mainline_revs:
187
which_revs = _enumerate_history(branch)
189
if start_revision is None:
192
branch.check_real_revno(start_revision)
194
if end_revision is None:
195
end_revision = len(which_revs)
197
branch.check_real_revno(end_revision)
199
# list indexes are 0-based; revisions are 1-based
200
cut_revs = which_revs[(start_revision-1):(end_revision)]
212
if direction == 'reverse':
213
start_rev_id, end_rev_id = end_rev_id, start_rev_id
215
legacy_lf = getattr(lf, 'log_revision', None) is None
217
# pre-0.17 formatters use show for mainline revisions.
218
# how should we show merged revisions ?
219
# pre-0.11 api: show_merge
220
# 0.11-0.16 api: show_merge_revno
221
show_merge_revno = getattr(lf, 'show_merge_revno', None)
222
show_merge = getattr(lf, 'show_merge', None)
223
if show_merge is None and show_merge_revno is None:
224
# no merged-revno support
225
generate_merge_revisions = False
227
generate_merge_revisions = True
204
# convert the revision history to a dictionary:
205
rev_nos = dict((k, v) for v, k in cut_revs)
207
# override the mainline to look like the revision history.
208
mainline_revs = [revision_id for index, revision_id in cut_revs]
209
if cut_revs[0][0] == 1:
210
mainline_revs.insert(0, None)
212
mainline_revs.insert(0, which_revs[start_revision-2][1])
213
# how should we show merged revisions ?
214
# old api: show_merge. New api: show_merge_revno
215
show_merge_revno = getattr(lf, 'show_merge_revno', None)
216
show_merge = getattr(lf, 'show_merge', None)
217
if show_merge is None and show_merge_revno is None:
218
# no merged-revno support
219
include_merges = False
221
include_merges = True
222
if show_merge is not None and show_merge_revno is None:
228
223
# tell developers to update their code
229
symbol_versioning.warn('LogFormatters should provide log_revision '
230
'instead of show and show_merge_revno since bzr 0.17.',
224
symbol_versioning.warn('LogFormatters should provide show_merge_revno '
225
'instead of show_merge since bzr 0.11.',
231
226
DeprecationWarning, stacklevel=3)
233
generate_merge_revisions = getattr(lf, 'supports_merge_revisions',
235
227
view_revs_iter = get_view_revisions(mainline_revs, rev_nos, branch,
236
direction, include_merges=generate_merge_revisions)
237
view_revisions = _filter_revision_range(list(view_revs_iter),
228
direction, include_merges=include_merges)
240
229
if specific_fileid:
241
view_revisions = _filter_revisions_touching_file_id(branch,
230
view_revisions = _get_revisions_touching_file_id(branch,
235
view_revisions = list(view_revs_iter)
246
# rebase merge_depth - unless there are no revisions or
247
# either the first or last revision have merge_depth = 0.
248
if view_revisions and view_revisions[0][2] and view_revisions[-1][2]:
249
min_depth = min([d for r,n,d in view_revisions])
251
view_revisions = [(r,n,d-min_depth) for r,n,d in view_revisions]
254
generate_tags = getattr(lf, 'supports_tags', False)
237
use_tags = getattr(lf, 'supports_tags', False)
256
240
if branch.supports_tags():
257
241
rev_tag_dict = branch.tags.get_reverse_tag_dict()
259
generate_delta = verbose and getattr(lf, 'supports_delta', False)
261
243
def iter_revisions():
262
244
# r = revision, n = revno, d = merge depth
263
245
revision_ids = [r for r, n, d in view_revisions]
246
zeros = set(r for r, n, d in view_revisions if d == 0)
265
248
repository = branch.repository
266
249
while revision_ids:
268
251
revisions = repository.get_revisions(revision_ids[:num])
270
deltas = repository.get_deltas_for_revisions(revisions)
271
cur_deltas = dict(izip((r.revision_id for r in revisions),
253
delta_revisions = [r for r in revisions if
254
r.revision_id in zeros]
255
deltas = repository.get_deltas_for_revisions(delta_revisions)
256
cur_deltas = dict(izip((r.revision_id for r in
257
delta_revisions), deltas))
273
258
for revision in revisions:
259
# The delta value will be None unless
260
# 1. verbose is specified, and
261
# 2. the revision is a mainline revision
274
262
yield revision, cur_deltas.get(revision.revision_id)
275
263
revision_ids = revision_ids[num:]
276
264
num = min(int(num * 1.5), 200)
278
266
# now we just print all the revisions
280
267
for ((rev_id, revno, merge_depth), (rev, delta)) in \
281
268
izip(view_revisions, iter_revisions()):
284
271
if not searchRE.search(rev.message):
288
lr = LogRevision(rev, revno, merge_depth, delta,
289
rev_tag_dict.get(rev_id))
292
# support for legacy (pre-0.17) LogFormatters
295
lf.show(revno, rev, delta, rev_tag_dict.get(rev_id))
297
lf.show(revno, rev, delta)
299
if show_merge_revno is None:
300
lf.show_merge(rev, merge_depth)
303
lf.show_merge_revno(rev, merge_depth, revno,
304
rev_tag_dict.get(rev_id))
306
lf.show_merge_revno(rev, merge_depth, revno)
309
if log_count >= limit:
313
def _get_mainline_revs(branch, start_revision, end_revision):
314
"""Get the mainline revisions from the branch.
316
Generates the list of mainline revisions for the branch.
318
:param branch: The branch containing the revisions.
320
:param start_revision: The first revision to be logged.
321
For backwards compatibility this may be a mainline integer revno,
322
but for merge revision support a RevisionInfo is expected.
324
:param end_revision: The last revision to be logged.
325
For backwards compatibility this may be a mainline integer revno,
326
but for merge revision support a RevisionInfo is expected.
328
:return: A (mainline_revs, rev_nos, start_rev_id, end_rev_id) tuple.
330
which_revs = _enumerate_history(branch)
332
return None, None, None, None
334
# For mainline generation, map start_revision and end_revision to
335
# mainline revnos. If the revision is not on the mainline choose the
336
# appropriate extreme of the mainline instead - the extra will be
338
# Also map the revisions to rev_ids, to be used in the later filtering
341
if start_revision is None:
344
if isinstance(start_revision,RevisionInfo):
345
start_rev_id = start_revision.rev_id
346
start_revno = start_revision.revno or 1
348
branch.check_real_revno(start_revision)
349
start_revno = start_revision
352
if end_revision is None:
353
end_revno = len(which_revs)
355
if isinstance(end_revision,RevisionInfo):
356
end_rev_id = end_revision.rev_id
357
end_revno = end_revision.revno or len(which_revs)
359
branch.check_real_revno(end_revision)
360
end_revno = end_revision
362
if start_revno > end_revno:
363
from bzrlib.errors import BzrCommandError
364
raise BzrCommandError("Start revision must be older than "
367
# list indexes are 0-based; revisions are 1-based
368
cut_revs = which_revs[(start_revno-1):(end_revno)]
370
return None, None, None, None
372
# convert the revision history to a dictionary:
373
rev_nos = dict((k, v) for v, k in cut_revs)
375
# override the mainline to look like the revision history.
376
mainline_revs = [revision_id for index, revision_id in cut_revs]
377
if cut_revs[0][0] == 1:
378
mainline_revs.insert(0, None)
380
mainline_revs.insert(0, which_revs[start_revno-2][1])
381
return mainline_revs, rev_nos, start_rev_id, end_rev_id
384
def _filter_revision_range(view_revisions, start_rev_id, end_rev_id):
385
"""Filter view_revisions based on revision ranges.
387
:param view_revisions: A list of (revision_id, dotted_revno, merge_depth)
388
tuples to be filtered.
390
:param start_rev_id: If not NONE specifies the first revision to be logged.
391
If NONE then all revisions up to the end_rev_id are logged.
393
:param end_rev_id: If not NONE specifies the last revision to be logged.
394
If NONE then all revisions up to the end of the log are logged.
396
:return: The filtered view_revisions.
398
if start_rev_id or end_rev_id:
399
revision_ids = [r for r, n, d in view_revisions]
401
start_index = revision_ids.index(start_rev_id)
404
if start_rev_id == end_rev_id:
405
end_index = start_index
408
end_index = revision_ids.index(end_rev_id)
410
end_index = len(view_revisions) - 1
411
# To include the revisions merged into the last revision,
412
# extend end_rev_id down to, but not including, the next rev
413
# with the same or lesser merge_depth
414
end_merge_depth = view_revisions[end_index][2]
416
for index in xrange(end_index+1, len(view_revisions)+1):
417
if view_revisions[index][2] <= end_merge_depth:
418
end_index = index - 1
421
# if the search falls off the end then log to the end as well
422
end_index = len(view_revisions) - 1
423
view_revisions = view_revisions[start_index:end_index+1]
424
return view_revisions
427
def _filter_revisions_touching_file_id(branch, file_id, mainline_revisions,
276
lf.show(revno, rev, delta, rev_tag_dict.get(rev_id))
278
lf.show(revno, rev, delta)
280
if show_merge_revno is None:
281
lf.show_merge(rev, merge_depth)
284
lf.show_merge_revno(rev, merge_depth, revno,
285
rev_tag_dict.get(rev_id))
287
lf.show_merge_revno(rev, merge_depth, revno)
290
def _get_revisions_touching_file_id(branch, file_id, mainline_revisions,
429
292
"""Return the list of revision ids which touch a given file id.
431
The function filters view_revisions and returns a subset.
432
294
This includes the revisions which directly change the file id,
433
295
and the revisions which merge these changes. So if the
434
296
revision graph is::
539
class LogRevision(object):
540
"""A revision to be logged (by LogFormatter.log_revision).
542
A simple wrapper for the attributes of a revision to be logged.
543
The attributes may or may not be populated, as determined by the
544
logging options and the log formatter capabilities.
547
def __init__(self, rev=None, revno=None, merge_depth=0, delta=None,
551
self.merge_depth = merge_depth
556
401
class LogFormatter(object):
557
"""Abstract class to display log messages.
559
At a minimum, a derived class must implement the log_revision method.
561
If the LogFormatter needs to be informed of the beginning or end of
562
a log it should implement the begin_log and/or end_log hook methods.
564
A LogFormatter should define the following supports_XXX flags
565
to indicate which LogRevision attributes it supports:
567
- supports_delta must be True if this log formatter supports delta.
568
Otherwise the delta attribute may not be populated.
569
- supports_merge_revisions must be True if this log formatter supports
570
merge revisions. If not, only mainline revisions (those
571
with merge_depth == 0) will be passed to the formatter.
572
- supports_tags must be True if this log formatter supports tags.
573
Otherwise the tags attribute may not be populated.
402
"""Abstract class to display log messages."""
576
404
def __init__(self, to_file, show_ids=False, show_timezone='original'):
577
405
self.to_file = to_file
578
406
self.show_ids = show_ids
579
407
self.show_timezone = show_timezone
581
# TODO: uncomment this block after show() has been removed.
582
# Until then defining log_revision would prevent _show_log calling show()
583
# in legacy formatters.
584
# def log_revision(self, revision):
587
# :param revision: The LogRevision to be logged.
589
# raise NotImplementedError('not implemented in abstract base')
591
@deprecated_method(zero_seventeen)
592
409
def show(self, revno, rev, delta):
593
410
raise NotImplementedError('not implemented in abstract base')
599
416
class LongLogFormatter(LogFormatter):
601
supports_merge_revisions = True
602
supports_delta = True
418
supports_tags = True # must exist and be True
419
# if this log formatter support tags.
420
# .show() and .show_merge_revno() must then accept
421
# the 'tags'-argument with list of tags
605
@deprecated_method(zero_seventeen)
606
423
def show(self, revno, rev, delta, tags=None):
607
lr = LogRevision(rev, revno, 0, delta, tags)
608
return self.log_revision(lr)
424
return self._show_helper(revno=revno, rev=rev, delta=delta, tags=tags)
610
426
@deprecated_method(zero_eleven)
611
427
def show_merge(self, rev, merge_depth):
612
lr = LogRevision(rev, merge_depth=merge_depth)
613
return self.log_revision(lr)
428
return self._show_helper(rev=rev, indent=' '*merge_depth,
429
merged=True, delta=None)
615
@deprecated_method(zero_seventeen)
616
431
def show_merge_revno(self, rev, merge_depth, revno, tags=None):
617
432
"""Show a merged revision rev, with merge_depth and a revno."""
618
lr = LogRevision(rev, revno, merge_depth, tags=tags)
619
return self.log_revision(lr)
433
return self._show_helper(rev=rev, revno=revno,
434
indent=' '*merge_depth, merged=True, delta=None, tags=tags)
621
def log_revision(self, revision):
622
"""Log a revision, either merged or not."""
436
def _show_helper(self, rev=None, revno=None, indent='', merged=False,
437
delta=None, tags=None):
438
"""Show a revision, either merged or not."""
623
439
from bzrlib.osutils import format_date
624
indent = ' '*revision.merge_depth
625
440
to_file = self.to_file
626
441
print >>to_file, indent+'-' * 60
627
if revision.revno is not None:
628
print >>to_file, indent+'revno:', revision.revno
630
print >>to_file, indent+'tags: %s' % (', '.join(revision.tags))
442
if revno is not None:
443
print >>to_file, indent+'revno:', revno
445
print >>to_file, indent+'tags: %s' % (', '.join(tags))
447
print >>to_file, indent+'merged:', rev.revision_id
449
print >>to_file, indent+'revision-id:', rev.revision_id
631
450
if self.show_ids:
632
print >>to_file, indent+'revision-id:', revision.rev.revision_id
633
for parent_id in revision.rev.parent_ids:
451
for parent_id in rev.parent_ids:
634
452
print >>to_file, indent+'parent:', parent_id
635
print >>to_file, indent+'committer:', revision.rev.committer
453
print >>to_file, indent+'committer:', rev.committer
638
456
print >>to_file, indent+'branch nick: %s' % \
639
revision.rev.properties['branch-nick']
457
rev.properties['branch-nick']
642
date_str = format_date(revision.rev.timestamp,
643
revision.rev.timezone or 0,
460
date_str = format_date(rev.timestamp,
644
462
self.show_timezone)
645
463
print >>to_file, indent+'timestamp: %s' % date_str
647
465
print >>to_file, indent+'message:'
648
if not revision.rev.message:
649
467
print >>to_file, indent+' (no message)'
651
message = revision.rev.message.rstrip('\r\n')
469
message = rev.message.rstrip('\r\n')
652
470
for l in message.split('\n'):
653
471
print >>to_file, indent+' ' + l
654
if revision.delta is not None:
655
revision.delta.show(to_file, self.show_ids, indent=indent)
472
if delta is not None:
473
delta.show(to_file, self.show_ids)
658
476
class ShortLogFormatter(LogFormatter):
660
supports_delta = True
662
@deprecated_method(zero_seventeen)
663
477
def show(self, revno, rev, delta):
664
lr = LogRevision(rev, revno, 0, delta)
665
return self.log_revision(lr)
667
def log_revision(self, revision):
668
478
from bzrlib.osutils import format_date
670
480
to_file = self.to_file
671
date_str = format_date(revision.rev.timestamp,
672
revision.rev.timezone or 0,
675
if len(revision.rev.parent_ids) > 1:
676
is_merge = ' [merge]'
677
print >>to_file, "%5s %s\t%s%s" % (revision.revno,
678
self.short_committer(revision.rev),
679
format_date(revision.rev.timestamp,
680
revision.rev.timezone or 0,
481
date_str = format_date(rev.timestamp, rev.timezone or 0,
483
print >>to_file, "%5s %s\t%s" % (revno, self.short_committer(rev),
484
format_date(rev.timestamp, rev.timezone or 0,
681
485
self.show_timezone, date_fmt="%Y-%m-%d",
684
487
if self.show_ids:
685
print >>to_file, ' revision-id:', revision.rev.revision_id
686
if not revision.rev.message:
488
print >>to_file, ' revision-id:', rev.revision_id
687
490
print >>to_file, ' (no message)'
689
message = revision.rev.message.rstrip('\r\n')
492
message = rev.message.rstrip('\r\n')
690
493
for l in message.split('\n'):
691
494
print >>to_file, ' ' + l
693
496
# TODO: Why not show the modified files in a shorter form as
694
497
# well? rewrap them single lines of appropriate length
695
if revision.delta is not None:
696
revision.delta.show(to_file, self.show_ids)
498
if delta is not None:
499
delta.show(to_file, self.show_ids)
697
500
print >>to_file, ''
700
503
class LineLogFormatter(LogFormatter):
702
def __init__(self, *args, **kwargs):
703
from bzrlib.osutils import terminal_width
704
super(LineLogFormatter, self).__init__(*args, **kwargs)
705
self._max_chars = terminal_width() - 1
707
504
def truncate(self, str, max_len):
708
505
if len(str) <= max_len:
added
removed
bzrlib/log.py
