147
150
start_revision=None,
148
151
end_revision=None,
151
155
"""Write out human-readable log of commits to this branch.
154
LogFormatter object to show the output.
157
If true, list only the commits affecting the specified
158
file, rather than all commits.
161
If true show added/changed/deleted/renamed files.
164
'reverse' (default) is latest to earliest;
165
'forward' is earliest to latest.
168
If not None, only show revisions >= start_revision
171
If not None, only show revisions <= end_revision
174
If not None, only show revisions with matching commit messages
177
If not None or 0, only show limit revisions
181
if getattr(lf, 'begin_log', None):
184
_show_log(branch, lf, specific_fileid, verbose, direction,
185
start_revision, end_revision, search, limit)
187
if getattr(lf, 'end_log', None):
193
def _show_log(branch,
195
specific_fileid=None,
202
"""Worker function for show_log - see show_log."""
203
if not isinstance(lf, LogFormatter):
204
warn("not a LogFormatter instance: %r" % lf)
207
mutter('get log for file_id %r', specific_fileid)
208
generate_merge_revisions = getattr(lf, 'supports_merge_revisions', False)
209
allow_single_merge_revision = getattr(lf,
210
'supports_single_merge_revision', False)
211
view_revisions = calculate_view_revisions(branch, start_revision,
212
end_revision, direction,
214
generate_merge_revisions,
215
allow_single_merge_revision)
216
if search is not None:
217
searchRE = re.compile(search, re.IGNORECASE)
222
generate_tags = getattr(lf, 'supports_tags', False)
224
if branch.supports_tags():
225
rev_tag_dict = branch.tags.get_reverse_tag_dict()
227
generate_delta = verbose and getattr(lf, 'supports_delta', False)
229
# now we just print all the revisions
231
for (rev_id, revno, merge_depth), rev, delta in _iter_revisions(
232
branch.repository, view_revisions, generate_delta):
234
if not searchRE.search(rev.message):
237
lr = LogRevision(rev, revno, merge_depth, delta,
238
rev_tag_dict.get(rev_id))
242
if log_count >= limit:
246
def calculate_view_revisions(branch, start_revision, end_revision, direction,
247
specific_fileid, generate_merge_revisions,
248
allow_single_merge_revision):
249
if (not generate_merge_revisions and start_revision is end_revision is
250
None and direction == 'reverse' and specific_fileid is None):
251
return _linear_view_revisions(branch)
253
mainline_revs, rev_nos, start_rev_id, end_rev_id = \
254
_get_mainline_revs(branch, start_revision, end_revision)
255
if not mainline_revs:
157
This function is being retained for backwards compatibility but
158
should not be extended with new parameters. Use the new Logger class
159
instead, eg. Logger(branch, rqst).show(lf), adding parameters to the
160
make_log_request_dict function.
162
:param lf: The LogFormatter object showing the output.
164
:param specific_fileid: If not None, list only the commits affecting the
165
specified file, rather than all commits.
167
:param verbose: If True show added/changed/deleted/renamed files.
169
:param direction: 'reverse' (default) is latest to earliest; 'forward' is
172
:param start_revision: If not None, only show revisions >= start_revision
174
:param end_revision: If not None, only show revisions <= end_revision
176
:param search: If not None, only show revisions with matching commit
179
:param limit: If set, shows only 'limit' revisions, all revisions are shown
182
:param show_diff: If True, output a diff after each revision.
184
# Convert old-style parameters to new-style parameters
185
if specific_fileid is not None:
186
file_ids = [specific_fileid]
191
delta_type = 'partial'
198
diff_type = 'partial'
204
# Build the request and execute it
205
rqst = make_log_request_dict(direction=direction, specific_fileids=file_ids,
206
start_revision=start_revision, end_revision=end_revision,
207
limit=limit, message_search=search,
208
delta_type=delta_type, diff_type=diff_type)
209
Logger(branch, rqst).show(lf)
212
# Note: This needs to be kept this in sync with the defaults in
213
# make_log_request_dict() below
214
_DEFAULT_REQUEST_PARAMS = {
215
'direction': 'reverse',
217
'generate_tags': True,
218
'_match_using_deltas': True,
222
def make_log_request_dict(direction='reverse', specific_fileids=None,
223
start_revision=None, end_revision=None, limit=None,
224
message_search=None, levels=1, generate_tags=True, delta_type=None,
225
diff_type=None, _match_using_deltas=True):
226
"""Convenience function for making a logging request dictionary.
228
Using this function may make code slightly safer by ensuring
229
parameters have the correct names. It also provides a reference
230
point for documenting the supported parameters.
232
:param direction: 'reverse' (default) is latest to earliest;
233
'forward' is earliest to latest.
235
:param specific_fileids: If not None, only include revisions
236
affecting the specified files, rather than all revisions.
238
:param start_revision: If not None, only generate
239
revisions >= start_revision
241
:param end_revision: If not None, only generate
242
revisions <= end_revision
244
:param limit: If set, generate only 'limit' revisions, all revisions
245
are shown if None or 0.
247
:param message_search: If not None, only include revisions with
248
matching commit messages
250
:param levels: the number of levels of revisions to
251
generate; 1 for just the mainline; 0 for all levels.
253
:param generate_tags: If True, include tags for matched revisions.
255
:param delta_type: Either 'full', 'partial' or None.
256
'full' means generate the complete delta - adds/deletes/modifies/etc;
257
'partial' means filter the delta using specific_fileids;
258
None means do not generate any delta.
260
:param diff_type: Either 'full', 'partial' or None.
261
'full' means generate the complete diff - adds/deletes/modifies/etc;
262
'partial' means filter the diff using specific_fileids;
263
None means do not generate any diff.
265
:param _match_using_deltas: a private parameter controlling the
266
algorithm used for matching specific_fileids. This parameter
267
may be removed in the future so bzrlib client code should NOT
271
'direction': direction,
272
'specific_fileids': specific_fileids,
273
'start_revision': start_revision,
274
'end_revision': end_revision,
276
'message_search': message_search,
278
'generate_tags': generate_tags,
279
'delta_type': delta_type,
280
'diff_type': diff_type,
281
# Add 'private' attributes for features that may be deprecated
282
'_match_using_deltas': _match_using_deltas,
286
def _apply_log_request_defaults(rqst):
287
"""Apply default values to a request dictionary."""
288
result = _DEFAULT_REQUEST_PARAMS
294
class LogGenerator(object):
295
"""A generator of log revisions."""
297
def iter_log_revisions(self):
298
"""Iterate over LogRevision objects.
300
:return: An iterator yielding LogRevision objects.
302
raise NotImplementedError(self.iter_log_revisions)
305
class Logger(object):
306
"""An object the generates, formats and displays a log."""
308
def __init__(self, branch, rqst):
311
:param branch: the branch to log
312
:param rqst: A dictionary specifying the query parameters.
313
See make_log_request_dict() for supported values.
316
self.rqst = _apply_log_request_defaults(rqst)
321
:param lf: The LogFormatter object to send the output to.
323
if not isinstance(lf, LogFormatter):
324
warn("not a LogFormatter instance: %r" % lf)
326
self.branch.lock_read()
328
if getattr(lf, 'begin_log', None):
331
if getattr(lf, 'end_log', None):
336
def _show_body(self, lf):
337
"""Show the main log output.
339
Subclasses may wish to override this.
341
# Tweak the LogRequest based on what the LogFormatter can handle.
342
# (There's no point generating stuff if the formatter can't display it.)
344
rqst['levels'] = lf.get_levels()
345
if not getattr(lf, 'supports_tags', False):
346
rqst['generate_tags'] = False
347
if not getattr(lf, 'supports_delta', False):
348
rqst['delta_type'] = None
349
if not getattr(lf, 'supports_diff', False):
350
rqst['diff_type'] = None
352
# Find and print the interesting revisions
353
generator = self._generator_factory(self.branch, rqst)
354
for lr in generator.iter_log_revisions():
358
def _generator_factory(self, branch, rqst):
359
"""Make the LogGenerator object to use.
361
Subclasses may wish to override this.
363
return _DefaultLogGenerator(branch, rqst)
366
class _StartNotLinearAncestor(Exception):
367
"""Raised when a start revision is not found walking left-hand history."""
370
class _DefaultLogGenerator(LogGenerator):
371
"""The default generator of log revisions."""
373
def __init__(self, branch, rqst):
376
if rqst.get('generate_tags') and branch.supports_tags():
377
self.rev_tag_dict = branch.tags.get_reverse_tag_dict()
379
self.rev_tag_dict = {}
381
def iter_log_revisions(self):
382
"""Iterate over LogRevision objects.
384
:return: An iterator yielding LogRevision objects.
388
revision_iterator = self._create_log_revision_iterator()
389
for revs in revision_iterator:
390
for (rev_id, revno, merge_depth), rev, delta in revs:
391
# 0 levels means show everything; merge_depth counts from 0
392
levels = rqst.get('levels')
393
if levels != 0 and merge_depth >= levels:
395
diff = self._format_diff(rev, rev_id)
396
yield LogRevision(rev, revno, merge_depth, delta,
397
self.rev_tag_dict.get(rev_id), diff)
398
limit = rqst.get('limit')
401
if log_count >= limit:
404
def _format_diff(self, rev, rev_id):
405
diff_type = self.rqst.get('diff_type')
406
if diff_type is None:
408
repo = self.branch.repository
409
if len(rev.parent_ids) == 0:
410
ancestor_id = _mod_revision.NULL_REVISION
412
ancestor_id = rev.parent_ids[0]
413
tree_1 = repo.revision_tree(ancestor_id)
414
tree_2 = repo.revision_tree(rev_id)
415
file_ids = self.rqst.get('specific_fileids')
416
if diff_type == 'partial' and file_ids is not None:
417
specific_files = [tree_2.id2path(id) for id in file_ids]
419
specific_files = None
421
diff.show_diff_trees(tree_1, tree_2, s, specific_files, old_label='',
425
def _create_log_revision_iterator(self):
426
"""Create a revision iterator for log.
428
:return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
431
self.start_rev_id, self.end_rev_id = _get_revision_limits(
432
self.branch, self.rqst.get('start_revision'),
433
self.rqst.get('end_revision'))
434
if self.rqst.get('_match_using_deltas'):
435
return self._log_revision_iterator_using_delta_matching()
437
# We're using the per-file-graph algorithm. This scales really
438
# well but only makes sense if there is a single file and it's
440
file_count = len(self.rqst.get('specific_fileids'))
442
raise BzrError("illegal LogRequest: must match-using-deltas "
443
"when logging %d files" % file_count)
444
return self._log_revision_iterator_using_per_file_graph()
446
def _log_revision_iterator_using_delta_matching(self):
447
# Get the base revisions, filtering by the revision range
449
generate_merge_revisions = rqst.get('levels') != 1
450
delayed_graph_generation = not rqst.get('specific_fileids') and (
451
rqst.get('limit') or self.start_rev_id or self.end_rev_id)
452
view_revisions = _calc_view_revisions(self.branch, self.start_rev_id,
453
self.end_rev_id, rqst.get('direction'), generate_merge_revisions,
454
delayed_graph_generation=delayed_graph_generation)
456
# Apply the other filters
457
return make_log_rev_iterator(self.branch, view_revisions,
458
rqst.get('delta_type'), rqst.get('message_search'),
459
file_ids=rqst.get('specific_fileids'),
460
direction=rqst.get('direction'))
462
def _log_revision_iterator_using_per_file_graph(self):
463
# Get the base revisions, filtering by the revision range.
464
# Note that we always generate the merge revisions because
465
# filter_revisions_touching_file_id() requires them ...
467
view_revisions = _calc_view_revisions(self.branch, self.start_rev_id,
468
self.end_rev_id, rqst.get('direction'), True)
469
if not isinstance(view_revisions, list):
470
view_revisions = list(view_revisions)
471
view_revisions = _filter_revisions_touching_file_id(self.branch,
472
rqst.get('specific_fileids')[0], view_revisions,
473
include_merges=rqst.get('levels') != 1)
474
return make_log_rev_iterator(self.branch, view_revisions,
475
rqst.get('delta_type'), rqst.get('message_search'))
478
def _calc_view_revisions(branch, start_rev_id, end_rev_id, direction,
479
generate_merge_revisions, delayed_graph_generation=False):
480
"""Calculate the revisions to view.
482
:return: An iterator of (revision_id, dotted_revno, merge_depth) tuples OR
483
a list of the same tuples.
485
br_revno, br_rev_id = branch.last_revision_info()
489
# If a single revision is requested, check we can handle it
490
generate_single_revision = (end_rev_id and start_rev_id == end_rev_id and
491
(not generate_merge_revisions or not _has_merges(branch, end_rev_id)))
492
if generate_single_revision:
493
return _generate_one_revision(branch, end_rev_id, br_rev_id, br_revno)
495
# If we only want to see linear revisions, we can iterate ...
496
if not generate_merge_revisions:
497
return _generate_flat_revisions(branch, start_rev_id, end_rev_id,
500
return _generate_all_revisions(branch, start_rev_id, end_rev_id,
501
direction, delayed_graph_generation)
504
def _generate_one_revision(branch, rev_id, br_rev_id, br_revno):
505
if rev_id == br_rev_id:
507
return [(br_rev_id, br_revno, 0)]
509
revno = branch.revision_id_to_dotted_revno(rev_id)
510
revno_str = '.'.join(str(n) for n in revno)
511
return [(rev_id, revno_str, 0)]
514
def _generate_flat_revisions(branch, start_rev_id, end_rev_id, direction):
515
result = _linear_view_revisions(branch, start_rev_id, end_rev_id)
516
# If a start limit was given and it's not obviously an
517
# ancestor of the end limit, check it before outputting anything
518
if direction == 'forward' or (start_rev_id
519
and not _is_obvious_ancestor(branch, start_rev_id, end_rev_id)):
521
result = list(result)
522
except _StartNotLinearAncestor:
523
raise errors.BzrCommandError('Start revision not found in'
524
' left-hand history of end revision.')
525
if direction == 'forward':
526
result = reversed(result)
530
def _generate_all_revisions(branch, start_rev_id, end_rev_id, direction,
531
delayed_graph_generation):
532
# On large trees, generating the merge graph can take 30-60 seconds
533
# so we delay doing it until a merge is detected, incrementally
534
# returning initial (non-merge) revisions while we can.
535
initial_revisions = []
536
if delayed_graph_generation:
538
for rev_id, revno, depth in \
539
_linear_view_revisions(branch, start_rev_id, end_rev_id):
540
if _has_merges(branch, rev_id):
544
initial_revisions.append((rev_id, revno, depth))
546
# No merged revisions found
547
if direction == 'reverse':
548
return initial_revisions
549
elif direction == 'forward':
550
return reversed(initial_revisions)
552
raise ValueError('invalid direction %r' % direction)
553
except _StartNotLinearAncestor:
554
# A merge was never detected so the lower revision limit can't
555
# be nested down somewhere
556
raise errors.BzrCommandError('Start revision not found in'
557
' history of end revision.')
559
# A log including nested merges is required. If the direction is reverse,
560
# we rebase the initial merge depths so that the development line is
561
# shown naturally, i.e. just like it is for linear logging. We can easily
562
# make forward the exact opposite display, but showing the merge revisions
563
# indented at the end seems slightly nicer in that case.
564
view_revisions = chain(iter(initial_revisions),
565
_graph_view_revisions(branch, start_rev_id, end_rev_id,
566
rebase_initial_depths=direction == 'reverse'))
258
567
if direction == 'reverse':
259
start_rev_id, end_rev_id = end_rev_id, start_rev_id
261
generate_single_revision = False
262
if ((not generate_merge_revisions)
263
and ((start_rev_id and (start_rev_id not in rev_nos))
264
or (end_rev_id and (end_rev_id not in rev_nos)))):
265
generate_single_revision = ((start_rev_id == end_rev_id)
266
and allow_single_merge_revision)
267
if not generate_single_revision:
268
raise BzrCommandError('Selected log formatter only supports '
269
'mainline revisions.')
270
generate_merge_revisions = generate_single_revision
271
view_revs_iter = get_view_revisions(mainline_revs, rev_nos, branch,
272
direction, include_merges=generate_merge_revisions)
273
view_revisions = _filter_revision_range(list(view_revs_iter),
276
if view_revisions and generate_single_revision:
277
view_revisions = view_revisions[0:1]
568
return view_revisions
569
elif direction == 'forward':
570
# Forward means oldest first, adjusting for depth.
571
view_revisions = reverse_by_depth(list(view_revisions))
572
return _rebase_merge_depth(view_revisions)
574
raise ValueError('invalid direction %r' % direction)
577
def _has_merges(branch, rev_id):
578
"""Does a revision have multiple parents or not?"""
579
parents = branch.repository.get_parent_map([rev_id]).get(rev_id, [])
580
return len(parents) > 1
583
def _is_obvious_ancestor(branch, start_rev_id, end_rev_id):
584
"""Is start_rev_id an obvious ancestor of end_rev_id?"""
585
if start_rev_id and end_rev_id:
586
start_dotted = branch.revision_id_to_dotted_revno(start_rev_id)
587
end_dotted = branch.revision_id_to_dotted_revno(end_rev_id)
588
if len(start_dotted) == 1 and len(end_dotted) == 1:
590
return start_dotted[0] <= end_dotted[0]
591
elif (len(start_dotted) == 3 and len(end_dotted) == 3 and
592
start_dotted[0:1] == end_dotted[0:1]):
593
# both on same development line
594
return start_dotted[2] <= end_dotted[2]
601
def _linear_view_revisions(branch, start_rev_id, end_rev_id):
602
"""Calculate a sequence of revisions to view, newest to oldest.
604
:param start_rev_id: the lower revision-id
605
:param end_rev_id: the upper revision-id
606
:return: An iterator of (revision_id, dotted_revno, merge_depth) tuples.
607
:raises _StartNotLinearAncestor: if a start_rev_id is specified but
608
is not found walking the left-hand history
610
br_revno, br_rev_id = branch.last_revision_info()
611
repo = branch.repository
612
if start_rev_id is None and end_rev_id is None:
614
for revision_id in repo.iter_reverse_revision_history(br_rev_id):
615
yield revision_id, str(cur_revno), 0
618
if end_rev_id is None:
619
end_rev_id = br_rev_id
620
found_start = start_rev_id is None
621
for revision_id in repo.iter_reverse_revision_history(end_rev_id):
622
revno = branch.revision_id_to_dotted_revno(revision_id)
623
revno_str = '.'.join(str(n) for n in revno)
624
if not found_start and revision_id == start_rev_id:
625
yield revision_id, revno_str, 0
629
yield revision_id, revno_str, 0
632
raise _StartNotLinearAncestor()
635
def _graph_view_revisions(branch, start_rev_id, end_rev_id,
636
rebase_initial_depths=True):
637
"""Calculate revisions to view including merges, newest to oldest.
639
:param branch: the branch
640
:param start_rev_id: the lower revision-id
641
:param end_rev_id: the upper revision-id
642
:param rebase_initial_depth: should depths be rebased until a mainline
644
:return: An iterator of (revision_id, dotted_revno, merge_depth) tuples.
646
view_revisions = branch.iter_merge_sorted_revisions(
647
start_revision_id=end_rev_id, stop_revision_id=start_rev_id,
648
stop_rule="with-merges")
649
if not rebase_initial_depths:
650
for (rev_id, merge_depth, revno, end_of_merge
652
yield rev_id, '.'.join(map(str, revno)), merge_depth
654
# We're following a development line starting at a merged revision.
655
# We need to adjust depths down by the initial depth until we find
656
# a depth less than it. Then we use that depth as the adjustment.
657
# If and when we reach the mainline, depth adjustment ends.
658
depth_adjustment = None
659
for (rev_id, merge_depth, revno, end_of_merge
661
if depth_adjustment is None:
662
depth_adjustment = merge_depth
664
if merge_depth < depth_adjustment:
665
depth_adjustment = merge_depth
666
merge_depth -= depth_adjustment
667
yield rev_id, '.'.join(map(str, revno)), merge_depth
670
def calculate_view_revisions(branch, start_revision, end_revision, direction,
671
specific_fileid, generate_merge_revisions):
672
"""Calculate the revisions to view.
674
:return: An iterator of (revision_id, dotted_revno, merge_depth) tuples OR
675
a list of the same tuples.
677
# This method is no longer called by the main code path.
678
# It is retained for API compatibility and may be deprecated
680
start_rev_id, end_rev_id = _get_revision_limits(branch, start_revision,
682
view_revisions = list(_calc_view_revisions(branch, start_rev_id, end_rev_id,
683
direction, generate_merge_revisions or specific_fileid))
278
684
if specific_fileid:
279
685
view_revisions = _filter_revisions_touching_file_id(branch,
284
# rebase merge_depth - unless there are no revisions or
285
# either the first or last revision have merge_depth = 0.
686
specific_fileid, view_revisions,
687
include_merges=generate_merge_revisions)
688
return _rebase_merge_depth(view_revisions)
691
def _rebase_merge_depth(view_revisions):
692
"""Adjust depths upwards so the top level is 0."""
693
# If either the first or last revision have a merge_depth of 0, we're done
286
694
if view_revisions and view_revisions[0][2] and view_revisions[-1][2]:
287
695
min_depth = min([d for r,n,d in view_revisions])
288
696
if min_depth != 0:
290
698
return view_revisions
293
def _linear_view_revisions(branch):
294
start_revno, start_revision_id = branch.last_revision_info()
295
repo = branch.repository
296
revision_ids = repo.iter_reverse_revision_history(start_revision_id)
297
for num, revision_id in enumerate(revision_ids):
298
yield revision_id, str(start_revno - num), 0
301
def _iter_revisions(repository, view_revisions, generate_delta):
701
def make_log_rev_iterator(branch, view_revisions, generate_delta, search,
702
file_ids=None, direction='reverse'):
703
"""Create a revision iterator for log.
705
:param branch: The branch being logged.
706
:param view_revisions: The revisions being viewed.
707
:param generate_delta: Whether to generate a delta for each revision.
708
Permitted values are None, 'full' and 'partial'.
709
:param search: A user text search string.
710
:param file_ids: If non empty, only revisions matching one or more of
711
the file-ids are to be kept.
712
:param direction: the direction in which view_revisions is sorted
713
:return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
716
# Convert view_revisions into (view, None, None) groups to fit with
717
# the standard interface here.
718
if type(view_revisions) == list:
719
# A single batch conversion is faster than many incremental ones.
720
# As we have all the data, do a batch conversion.
721
nones = [None] * len(view_revisions)
722
log_rev_iterator = iter([zip(view_revisions, nones, nones)])
725
for view in view_revisions:
726
yield (view, None, None)
727
log_rev_iterator = iter([_convert()])
728
for adapter in log_adapters:
729
# It would be nicer if log adapters were first class objects
730
# with custom parameters. This will do for now. IGC 20090127
731
if adapter == _make_delta_filter:
732
log_rev_iterator = adapter(branch, generate_delta,
733
search, log_rev_iterator, file_ids, direction)
735
log_rev_iterator = adapter(branch, generate_delta,
736
search, log_rev_iterator)
737
return log_rev_iterator
740
def _make_search_filter(branch, generate_delta, search, log_rev_iterator):
741
"""Create a filtered iterator of log_rev_iterator matching on a regex.
743
:param branch: The branch being logged.
744
:param generate_delta: Whether to generate a delta for each revision.
745
:param search: A user text search string.
746
:param log_rev_iterator: An input iterator containing all revisions that
747
could be displayed, in lists.
748
:return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
752
return log_rev_iterator
753
searchRE = re_compile_checked(search, re.IGNORECASE,
754
'log message filter')
755
return _filter_message_re(searchRE, log_rev_iterator)
758
def _filter_message_re(searchRE, log_rev_iterator):
759
for revs in log_rev_iterator:
761
for (rev_id, revno, merge_depth), rev, delta in revs:
762
if searchRE.search(rev.message):
763
new_revs.append(((rev_id, revno, merge_depth), rev, delta))
767
def _make_delta_filter(branch, generate_delta, search, log_rev_iterator,
768
fileids=None, direction='reverse'):
769
"""Add revision deltas to a log iterator if needed.
771
:param branch: The branch being logged.
772
:param generate_delta: Whether to generate a delta for each revision.
773
Permitted values are None, 'full' and 'partial'.
774
:param search: A user text search string.
775
:param log_rev_iterator: An input iterator containing all revisions that
776
could be displayed, in lists.
777
:param fileids: If non empty, only revisions matching one or more of
778
the file-ids are to be kept.
779
:param direction: the direction in which view_revisions is sorted
780
:return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
783
if not generate_delta and not fileids:
784
return log_rev_iterator
785
return _generate_deltas(branch.repository, log_rev_iterator,
786
generate_delta, fileids, direction)
789
def _generate_deltas(repository, log_rev_iterator, delta_type, fileids,
791
"""Create deltas for each batch of revisions in log_rev_iterator.
793
If we're only generating deltas for the sake of filtering against
794
file-ids, we stop generating deltas once all file-ids reach the
795
appropriate life-cycle point. If we're receiving data newest to
796
oldest, then that life-cycle point is 'add', otherwise it's 'remove'.
798
check_fileids = fileids is not None and len(fileids) > 0
800
fileid_set = set(fileids)
801
if direction == 'reverse':
807
for revs in log_rev_iterator:
808
# If we were matching against fileids and we've run out,
809
# there's nothing left to do
810
if check_fileids and not fileid_set:
812
revisions = [rev[1] for rev in revs]
814
if delta_type == 'full' and not check_fileids:
815
deltas = repository.get_deltas_for_revisions(revisions)
816
for rev, delta in izip(revs, deltas):
817
new_revs.append((rev[0], rev[1], delta))
819
deltas = repository.get_deltas_for_revisions(revisions, fileid_set)
820
for rev, delta in izip(revs, deltas):
822
if delta is None or not delta.has_changed():
825
_update_fileids(delta, fileid_set, stop_on)
826
if delta_type is None:
828
elif delta_type == 'full':
829
# If the file matches all the time, rebuilding
830
# a full delta like this in addition to a partial
831
# one could be slow. However, it's likely that
832
# most revisions won't get this far, making it
833
# faster to filter on the partial deltas and
834
# build the occasional full delta than always
835
# building full deltas and filtering those.
837
delta = repository.get_revision_delta(rev_id)
838
new_revs.append((rev[0], rev[1], delta))
842
def _update_fileids(delta, fileids, stop_on):
843
"""Update the set of file-ids to search based on file lifecycle events.
845
:param fileids: a set of fileids to update
846
:param stop_on: either 'add' or 'remove' - take file-ids out of the
847
fileids set once their add or remove entry is detected respectively
850
for item in delta.added:
851
if item[1] in fileids:
852
fileids.remove(item[1])
853
elif stop_on == 'delete':
854
for item in delta.removed:
855
if item[1] in fileids:
856
fileids.remove(item[1])
859
def _make_revision_objects(branch, generate_delta, search, log_rev_iterator):
860
"""Extract revision objects from the repository
862
:param branch: The branch being logged.
863
:param generate_delta: Whether to generate a delta for each revision.
864
:param search: A user text search string.
865
:param log_rev_iterator: An input iterator containing all revisions that
866
could be displayed, in lists.
867
:return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
870
repository = branch.repository
871
for revs in log_rev_iterator:
872
# r = revision_id, n = revno, d = merge depth
873
revision_ids = [view[0] for view, _, _ in revs]
874
revisions = repository.get_revisions(revision_ids)
875
revs = [(rev[0], revision, rev[2]) for rev, revision in
876
izip(revs, revisions)]
880
def _make_batch_filter(branch, generate_delta, search, log_rev_iterator):
881
"""Group up a single large batch into smaller ones.
883
:param branch: The branch being logged.
884
:param generate_delta: Whether to generate a delta for each revision.
885
:param search: A user text search string.
886
:param log_rev_iterator: An input iterator containing all revisions that
887
could be displayed, in lists.
888
:return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
891
repository = branch.repository
303
view_revisions = iter(view_revisions)
305
cur_view_revisions = [d for x, d in zip(range(num), view_revisions)]
306
if len(cur_view_revisions) == 0:
309
# r = revision, n = revno, d = merge depth
310
revision_ids = [r for (r, n, d) in cur_view_revisions]
311
revisions = repository.get_revisions(revision_ids)
313
deltas = repository.get_deltas_for_revisions(revisions)
314
cur_deltas = dict(izip((r.revision_id for r in revisions),
316
for view_data, revision in izip(cur_view_revisions, revisions):
317
yield view_data, revision, cur_deltas.get(revision.revision_id)
318
num = min(int(num * 1.5), 200)
893
for batch in log_rev_iterator:
896
step = [detail for _, detail in zip(range(num), batch)]
900
num = min(int(num * 1.5), 200)
903
def _get_revision_limits(branch, start_revision, end_revision):
904
"""Get and check revision limits.
906
:param branch: The branch containing the revisions.
908
:param start_revision: The first revision to be logged.
909
For backwards compatibility this may be a mainline integer revno,
910
but for merge revision support a RevisionInfo is expected.
912
:param end_revision: The last revision to be logged.
913
For backwards compatibility this may be a mainline integer revno,
914
but for merge revision support a RevisionInfo is expected.
916
:return: (start_rev_id, end_rev_id) tuple.
918
branch_revno, branch_rev_id = branch.last_revision_info()
920
if start_revision is None:
923
if isinstance(start_revision, revisionspec.RevisionInfo):
924
start_rev_id = start_revision.rev_id
925
start_revno = start_revision.revno or 1
927
branch.check_real_revno(start_revision)
928
start_revno = start_revision
929
start_rev_id = branch.get_rev_id(start_revno)
932
if end_revision is None:
933
end_revno = branch_revno
935
if isinstance(end_revision, revisionspec.RevisionInfo):
936
end_rev_id = end_revision.rev_id
937
end_revno = end_revision.revno or branch_revno
939
branch.check_real_revno(end_revision)
940
end_revno = end_revision
941
end_rev_id = branch.get_rev_id(end_revno)
943
if branch_revno != 0:
944
if (start_rev_id == _mod_revision.NULL_REVISION
945
or end_rev_id == _mod_revision.NULL_REVISION):
946
raise errors.BzrCommandError('Logging revision 0 is invalid.')
947
if start_revno > end_revno:
948
raise errors.BzrCommandError("Start revision must be older than "
950
return (start_rev_id, end_rev_id)
321
953
def _get_mainline_revs(branch, start_revision, end_revision):
322
954
"""Get the mainline revisions from the branch.
324
956
Generates the list of mainline revisions for the branch.
326
:param branch: The branch containing the revisions.
958
:param branch: The branch containing the revisions.
328
960
:param start_revision: The first revision to be logged.
329
961
For backwards compatibility this may be a mainline integer revno,
443
1077
return view_revisions
446
def _filter_revisions_touching_file_id(branch, file_id, mainline_revisions,
448
"""Return the list of revision ids which touch a given file id.
1080
def _filter_revisions_touching_file_id(branch, file_id, view_revisions,
1081
include_merges=True):
1082
r"""Return the list of revision ids which touch a given file id.
450
1084
The function filters view_revisions and returns a subset.
451
1085
This includes the revisions which directly change the file id,
452
1086
and the revisions which merge these changes. So if the
453
1087
revision graph is::
460
And 'C' changes a file, then both C and D will be returned.
462
This will also can be restricted based on a subset of the mainline.
1098
And 'C' changes a file, then both C and D will be returned. F will not be
1099
returned even though it brings the changes to C into the branch starting
1100
with E. (Note that if we were using F as the tip instead of G, then we
1103
This will also be restricted based on a subset of the mainline.
1105
:param branch: The branch where we can get text revision information.
1107
:param file_id: Filter out revisions that do not touch file_id.
1109
:param view_revisions: A list of (revision_id, dotted_revno, merge_depth)
1110
tuples. This is the list of revisions which will be filtered. It is
1111
assumed that view_revisions is in merge_sort order (i.e. newest
1114
:param include_merges: include merge revisions in the result or not
464
1116
:return: A list of (revision_id, dotted_revno, merge_depth) tuples.
466
# find all the revisions that change the specific file
467
# build the ancestry of each revision in the graph
468
# - only listing the ancestors that change the specific file.
469
graph = branch.repository.get_graph()
470
# This asks for all mainline revisions, which means we only have to spider
471
# sideways, rather than depth history. That said, its still size-of-history
472
# and should be addressed.
473
# mainline_revisions always includes an extra revision at the beginning, so
475
parent_map = dict(((key, value) for key, value in
476
graph.iter_ancestry(mainline_revisions[1:]) if value is not None))
477
sorted_rev_list = topo_sort(parent_map.items())
478
text_keys = [(file_id, rev_id) for rev_id in sorted_rev_list]
479
modified_text_versions = branch.repository.texts.get_parent_map(text_keys)
481
for rev in sorted_rev_list:
482
text_key = (file_id, rev)
483
parents = parent_map[rev]
484
if text_key not in modified_text_versions and len(parents) == 1:
485
# We will not be adding anything new, so just use a reference to
486
# the parent ancestry.
487
rev_ancestry = ancestry[parents[0]]
1118
# Lookup all possible text keys to determine which ones actually modified
1120
text_keys = [(file_id, rev_id) for rev_id, revno, depth in view_revisions]
1122
# Looking up keys in batches of 1000 can cut the time in half, as well as
1123
# memory consumption. GraphIndex *does* like to look for a few keys in
1124
# parallel, it just doesn't like looking for *lots* of keys in parallel.
1125
# TODO: This code needs to be re-evaluated periodically as we tune the
1126
# indexing layer. We might consider passing in hints as to the known
1127
# access pattern (sparse/clustered, high success rate/low success
1128
# rate). This particular access is clustered with a low success rate.
1129
get_parent_map = branch.repository.texts.get_parent_map
1130
modified_text_revisions = set()
1132
for start in xrange(0, len(text_keys), chunk_size):
1133
next_keys = text_keys[start:start + chunk_size]
1134
# Only keep the revision_id portion of the key
1135
modified_text_revisions.update(
1136
[k[1] for k in get_parent_map(next_keys)])
1137
del text_keys, next_keys
1140
# Track what revisions will merge the current revision, replace entries
1141
# with 'None' when they have been added to result
1142
current_merge_stack = [None]
1143
for info in view_revisions:
1144
rev_id, revno, depth = info
1145
if depth == len(current_merge_stack):
1146
current_merge_stack.append(info)
490
if text_key in modified_text_versions:
491
rev_ancestry.add(rev)
492
for parent in parents:
493
if parent not in ancestry:
494
# parent is a Ghost, which won't be present in
495
# sorted_rev_list, but we may access it later, so create an
497
ancestry[parent] = set()
498
rev_ancestry = rev_ancestry.union(ancestry[parent])
499
ancestry[rev] = rev_ancestry
501
def is_merging_rev(r):
502
parents = parent_map[r]
504
leftparent = parents[0]
505
for rightparent in parents[1:]:
506
if not ancestry[leftparent].issuperset(
507
ancestry[rightparent]):
511
# filter from the view the revisions that did not change or merge
513
return [(r, n, d) for r, n, d in view_revs_iter
514
if (file_id, r) in modified_text_versions or is_merging_rev(r)]
1148
del current_merge_stack[depth + 1:]
1149
current_merge_stack[-1] = info
1151
if rev_id in modified_text_revisions:
1152
# This needs to be logged, along with the extra revisions
1153
for idx in xrange(len(current_merge_stack)):
1154
node = current_merge_stack[idx]
1155
if node is not None:
1156
if include_merges or node[2] == 0:
1158
current_merge_stack[idx] = None
517
1162
def get_view_revisions(mainline_revs, rev_nos, branch, direction,
878
1737
end_revision=len(new_rh),
1741
def get_history_change(old_revision_id, new_revision_id, repository):
1742
"""Calculate the uncommon lefthand history between two revisions.
1744
:param old_revision_id: The original revision id.
1745
:param new_revision_id: The new revision id.
1746
:param repository: The repository to use for the calculation.
1748
return old_history, new_history
1751
old_revisions = set()
1753
new_revisions = set()
1754
new_iter = repository.iter_reverse_revision_history(new_revision_id)
1755
old_iter = repository.iter_reverse_revision_history(old_revision_id)
1756
stop_revision = None
1759
while do_new or do_old:
1762
new_revision = new_iter.next()
1763
except StopIteration:
1766
new_history.append(new_revision)
1767
new_revisions.add(new_revision)
1768
if new_revision in old_revisions:
1769
stop_revision = new_revision
1773
old_revision = old_iter.next()
1774
except StopIteration:
1777
old_history.append(old_revision)
1778
old_revisions.add(old_revision)
1779
if old_revision in new_revisions:
1780
stop_revision = old_revision
1782
new_history.reverse()
1783
old_history.reverse()
1784
if stop_revision is not None:
1785
new_history = new_history[new_history.index(stop_revision) + 1:]
1786
old_history = old_history[old_history.index(stop_revision) + 1:]
1787
return old_history, new_history
1790
def show_branch_change(branch, output, old_revno, old_revision_id):
1791
"""Show the changes made to a branch.
1793
:param branch: The branch to show changes about.
1794
:param output: A file-like object to write changes to.
1795
:param old_revno: The revno of the old tip.
1796
:param old_revision_id: The revision_id of the old tip.
1798
new_revno, new_revision_id = branch.last_revision_info()
1799
old_history, new_history = get_history_change(old_revision_id,
1802
if old_history == [] and new_history == []:
1803
output.write('Nothing seems to have changed\n')
1806
log_format = log_formatter_registry.get_default(branch)
1807
lf = log_format(show_ids=False, to_file=output, show_timezone='original')
1808
if old_history != []:
1809
output.write('*'*60)
1810
output.write('\nRemoved Revisions:\n')
1811
show_flat_log(branch.repository, old_history, old_revno, lf)
1812
output.write('*'*60)
1813
output.write('\n\n')
1814
if new_history != []:
1815
output.write('Added Revisions:\n')
1816
start_revno = new_revno - len(new_history) + 1
1817
show_log(branch, lf, None, verbose=False, direction='forward',
1818
start_revision=start_revno,)
1821
def show_flat_log(repository, history, last_revno, lf):
1822
"""Show a simple log of the specified history.
1824
:param repository: The repository to retrieve revisions from.
1825
:param history: A list of revision_ids indicating the lefthand history.
1826
:param last_revno: The revno of the last revision_id in the history.
1827
:param lf: The log formatter to use.
1829
start_revno = last_revno - len(history) + 1
1830
revisions = repository.get_revisions(history)
1831
for i, rev in enumerate(revisions):
1832
lr = LogRevision(rev, i + last_revno, 0, None)
1836
def _get_info_for_log_files(revisionspec_list, file_list):
1837
"""Find file-ids and kinds given a list of files and a revision range.
1839
We search for files at the end of the range. If not found there,
1840
we try the start of the range.
1842
:param revisionspec_list: revision range as parsed on the command line
1843
:param file_list: the list of paths given on the command line;
1844
the first of these can be a branch location or a file path,
1845
the remainder must be file paths
1846
:return: (branch, info_list, start_rev_info, end_rev_info) where
1847
info_list is a list of (relative_path, file_id, kind) tuples where
1848
kind is one of values 'directory', 'file', 'symlink', 'tree-reference'.
1849
branch will be read-locked.
1851
from builtins import _get_revision_range, safe_relpath_files
1852
tree, b, path = bzrdir.BzrDir.open_containing_tree_or_branch(file_list[0])
1854
# XXX: It's damn messy converting a list of paths to relative paths when
1855
# those paths might be deleted ones, they might be on a case-insensitive
1856
# filesystem and/or they might be in silly locations (like another branch).
1857
# For example, what should "log bzr://branch/dir/file1 file2" do? (Is
1858
# file2 implicitly in the same dir as file1 or should its directory be
1859
# taken from the current tree somehow?) For now, this solves the common
1860
# case of running log in a nested directory, assuming paths beyond the
1861
# first one haven't been deleted ...
1863
relpaths = [path] + safe_relpath_files(tree, file_list[1:])
1865
relpaths = [path] + file_list[1:]
1867
start_rev_info, end_rev_info = _get_revision_range(revisionspec_list, b,
1869
if relpaths in ([], [u'']):
1870
return b, [], start_rev_info, end_rev_info
1871
if start_rev_info is None and end_rev_info is None:
1873
tree = b.basis_tree()
1876
file_id = tree.path2id(fp)
1877
kind = _get_kind_for_file_id(tree, file_id)
1879
# go back to when time began
1882
rev1 = b.get_rev_id(1)
1883
except errors.NoSuchRevision:
1888
tree1 = b.repository.revision_tree(rev1)
1890
file_id = tree1.path2id(fp)
1891
kind = _get_kind_for_file_id(tree1, file_id)
1892
info_list.append((fp, file_id, kind))
1894
elif start_rev_info == end_rev_info:
1895
# One revision given - file must exist in it
1896
tree = b.repository.revision_tree(end_rev_info.rev_id)
1898
file_id = tree.path2id(fp)
1899
kind = _get_kind_for_file_id(tree, file_id)
1900
info_list.append((fp, file_id, kind))
1903
# Revision range given. Get the file-id from the end tree.
1904
# If that fails, try the start tree.
1905
rev_id = end_rev_info.rev_id
1907
tree = b.basis_tree()
1909
tree = b.repository.revision_tree(rev_id)
1912
file_id = tree.path2id(fp)
1913
kind = _get_kind_for_file_id(tree, file_id)
1916
rev_id = start_rev_info.rev_id
1918
rev1 = b.get_rev_id(1)
1919
tree1 = b.repository.revision_tree(rev1)
1921
tree1 = b.repository.revision_tree(rev_id)
1922
file_id = tree1.path2id(fp)
1923
kind = _get_kind_for_file_id(tree1, file_id)
1924
info_list.append((fp, file_id, kind))
1925
return b, info_list, start_rev_info, end_rev_info
1928
def _get_kind_for_file_id(tree, file_id):
1929
"""Return the kind of a file-id or None if it doesn't exist."""
1930
if file_id is not None:
1931
return tree.kind(file_id)
1936
properties_handler_registry = registry.Registry()
1939
# adapters which revision ids to log are filtered. When log is called, the
1940
# log_rev_iterator is adapted through each of these factory methods.
1941
# Plugins are welcome to mutate this list in any way they like - as long
1942
# as the overall behaviour is preserved. At this point there is no extensible
1943
# mechanism for getting parameters to each factory method, and until there is
1944
# this won't be considered a stable api.
1948
# read revision objects
1949
_make_revision_objects,
1950
# filter on log messages
1951
_make_search_filter,
1952
# generate deltas for things we will show
added
removed
bzrlib/log.py
