← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/log.py

  • Committer: Andrew Bennetts
  • Date: 2011-05-16 10:08:01 UTC
  • mto: This revision was merged to the branch mainline in revision 5865.
  • Revision ID: andrew.bennetts@canonical.com-20110516100801-81ookklkd9be2e3a
Move duplicate definitions of {Knit,GroupCompress}VersionedFiles.get_known_graph_ancestry into VersionedFilesWithFallbacks.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/log.py
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2005-2011 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
73
73
    repository as _mod_repository,
74
74
    revision as _mod_revision,
75
75
    revisionspec,
76
 
    trace,
77
76
    tsort,
78
77
    )
79
78
""")
84
83
from bzrlib.osutils import (
85
84
    format_date,
86
85
    format_date_with_offset_in_original_timezone,
 
86
    get_diff_header_encoding,
87
87
    get_terminal_encoding,
88
 
    re_compile_checked,
89
88
    terminal_width,
90
89
    )
91
90
from bzrlib.symbol_versioning import (
298
297
 
299
298
def _apply_log_request_defaults(rqst):
300
299
    """Apply default values to a request dictionary."""
301
 
    result = _DEFAULT_REQUEST_PARAMS
 
300
    result = _DEFAULT_REQUEST_PARAMS.copy()
302
301
    if rqst:
303
302
        result.update(rqst)
304
303
    return result
432
431
        else:
433
432
            specific_files = None
434
433
        s = StringIO()
 
434
        path_encoding = get_diff_header_encoding()
435
435
        diff.show_diff_trees(tree_1, tree_2, s, specific_files, old_label='',
436
 
            new_label='')
 
436
            new_label='', path_encoding=path_encoding)
437
437
        return s.getvalue()
438
438
 
439
439
    def _create_log_revision_iterator(self):
522
522
    elif not generate_merge_revisions:
523
523
        # If we only want to see linear revisions, we can iterate ...
524
524
        iter_revs = _generate_flat_revisions(branch, start_rev_id, end_rev_id,
525
 
                                             direction)
 
525
                                             direction, exclude_common_ancestry)
526
526
        if direction == 'forward':
527
527
            iter_revs = reversed(iter_revs)
528
528
    else:
539
539
        # It's the tip
540
540
        return [(br_rev_id, br_revno, 0)]
541
541
    else:
542
 
        revno = branch.revision_id_to_dotted_revno(rev_id)
543
 
        revno_str = '.'.join(str(n) for n in revno)
 
542
        revno_str = _compute_revno_str(branch, rev_id)
544
543
        return [(rev_id, revno_str, 0)]
545
544
 
546
545
 
547
 
def _generate_flat_revisions(branch, start_rev_id, end_rev_id, direction):
548
 
    result = _linear_view_revisions(branch, start_rev_id, end_rev_id)
 
546
def _generate_flat_revisions(branch, start_rev_id, end_rev_id, direction,
 
547
                             exclude_common_ancestry=False):
 
548
    result = _linear_view_revisions(
 
549
        branch, start_rev_id, end_rev_id,
 
550
        exclude_common_ancestry=exclude_common_ancestry)
549
551
    # If a start limit was given and it's not obviously an
550
552
    # ancestor of the end limit, check it before outputting anything
551
553
    if direction == 'forward' or (start_rev_id
572
574
    if delayed_graph_generation:
573
575
        try:
574
576
            for rev_id, revno, depth in  _linear_view_revisions(
575
 
                branch, start_rev_id, end_rev_id):
 
577
                branch, start_rev_id, end_rev_id, exclude_common_ancestry):
576
578
                if _has_merges(branch, rev_id):
577
579
                    # The end_rev_id can be nested down somewhere. We need an
578
580
                    # explicit ancestry check. There is an ambiguity here as we
623
625
    return len(parents) > 1
624
626
 
625
627
 
 
628
def _compute_revno_str(branch, rev_id):
 
629
    """Compute the revno string from a rev_id.
 
630
 
 
631
    :return: The revno string, or None if the revision is not in the supplied
 
632
        branch.
 
633
    """
 
634
    try:
 
635
        revno = branch.revision_id_to_dotted_revno(rev_id)
 
636
    except errors.NoSuchRevision:
 
637
        # The revision must be outside of this branch
 
638
        return None
 
639
    else:
 
640
        return '.'.join(str(n) for n in revno)
 
641
 
 
642
 
626
643
def _is_obvious_ancestor(branch, start_rev_id, end_rev_id):
627
644
    """Is start_rev_id an obvious ancestor of end_rev_id?"""
628
645
    if start_rev_id and end_rev_id:
629
 
        start_dotted = branch.revision_id_to_dotted_revno(start_rev_id)
630
 
        end_dotted = branch.revision_id_to_dotted_revno(end_rev_id)
 
646
        try:
 
647
            start_dotted = branch.revision_id_to_dotted_revno(start_rev_id)
 
648
            end_dotted = branch.revision_id_to_dotted_revno(end_rev_id)
 
649
        except errors.NoSuchRevision:
 
650
            # one or both is not in the branch; not obvious
 
651
            return False
631
652
        if len(start_dotted) == 1 and len(end_dotted) == 1:
632
653
            # both on mainline
633
654
            return start_dotted[0] <= end_dotted[0]
643
664
    return True
644
665
 
645
666
 
646
 
def _linear_view_revisions(branch, start_rev_id, end_rev_id):
 
667
def _linear_view_revisions(branch, start_rev_id, end_rev_id,
 
668
                           exclude_common_ancestry=False):
647
669
    """Calculate a sequence of revisions to view, newest to oldest.
648
670
 
649
671
    :param start_rev_id: the lower revision-id
650
672
    :param end_rev_id: the upper revision-id
 
673
    :param exclude_common_ancestry: Whether the start_rev_id should be part of
 
674
        the iterated revisions.
651
675
    :return: An iterator of (revision_id, dotted_revno, merge_depth) tuples.
652
676
    :raises _StartNotLinearAncestor: if a start_rev_id is specified but
653
 
      is not found walking the left-hand history
 
677
        is not found walking the left-hand history
654
678
    """
655
679
    br_revno, br_rev_id = branch.last_revision_info()
656
680
    repo = branch.repository
664
688
            end_rev_id = br_rev_id
665
689
        found_start = start_rev_id is None
666
690
        for revision_id in repo.iter_reverse_revision_history(end_rev_id):
667
 
            revno = branch.revision_id_to_dotted_revno(revision_id)
668
 
            revno_str = '.'.join(str(n) for n in revno)
 
691
            revno_str = _compute_revno_str(branch, revision_id)
669
692
            if not found_start and revision_id == start_rev_id:
670
 
                yield revision_id, revno_str, 0
 
693
                if not exclude_common_ancestry:
 
694
                    yield revision_id, revno_str, 0
671
695
                found_start = True
672
696
                break
673
697
            else:
802
826
    """
803
827
    if search is None:
804
828
        return log_rev_iterator
805
 
    searchRE = re_compile_checked(search, re.IGNORECASE,
806
 
            'log message filter')
 
829
    searchRE = re.compile(search, re.IGNORECASE)
807
830
    return _filter_message_re(searchRE, log_rev_iterator)
808
831
 
809
832
 
1168
1191
    """
1169
1192
    # Lookup all possible text keys to determine which ones actually modified
1170
1193
    # the file.
 
1194
    graph = branch.repository.get_file_graph()
 
1195
    get_parent_map = graph.get_parent_map
1171
1196
    text_keys = [(file_id, rev_id) for rev_id, revno, depth in view_revisions]
1172
1197
    next_keys = None
1173
1198
    # Looking up keys in batches of 1000 can cut the time in half, as well as
1177
1202
    #       indexing layer. We might consider passing in hints as to the known
1178
1203
    #       access pattern (sparse/clustered, high success rate/low success
1179
1204
    #       rate). This particular access is clustered with a low success rate.
1180
 
    get_parent_map = branch.repository.texts.get_parent_map
1181
1205
    modified_text_revisions = set()
1182
1206
    chunk_size = 1000
1183
1207
    for start in xrange(0, len(text_keys), chunk_size):
1293
1317
    def __init__(self, rev=None, revno=None, merge_depth=0, delta=None,
1294
1318
                 tags=None, diff=None):
1295
1319
        self.rev = rev
1296
 
        self.revno = str(revno)
 
1320
        if revno is None:
 
1321
            self.revno = None
 
1322
        else:
 
1323
            self.revno = str(revno)
1297
1324
        self.merge_depth = merge_depth
1298
1325
        self.delta = delta
1299
1326
        self.tags = tags
1341
1368
 
1342
1369
    def __init__(self, to_file, show_ids=False, show_timezone='original',
1343
1370
                 delta_format=None, levels=None, show_advice=False,
1344
 
                 to_exact_file=None):
 
1371
                 to_exact_file=None, author_list_handler=None):
1345
1372
        """Create a LogFormatter.
1346
1373
 
1347
1374
        :param to_file: the file to output to
1355
1382
          let the log formatter decide.
1356
1383
        :param show_advice: whether to show advice at the end of the
1357
1384
          log or not
 
1385
        :param author_list_handler: callable generating a list of
 
1386
          authors to display for a given revision
1358
1387
        """
1359
1388
        self.to_file = to_file
1360
1389
        # 'exact' stream used to show diff, it should print content 'as is'
1375
1404
        self.levels = levels
1376
1405
        self._show_advice = show_advice
1377
1406
        self._merge_count = 0
 
1407
        self._author_list_handler = author_list_handler
1378
1408
 
1379
1409
    def get_levels(self):
1380
1410
        """Get the number of levels to display or 0 for all."""
1412
1442
        return address
1413
1443
 
1414
1444
    def short_author(self, rev):
1415
 
        name, address = config.parse_username(rev.get_apparent_authors()[0])
1416
 
        if name:
1417
 
            return name
1418
 
        return address
 
1445
        return self.authors(rev, 'first', short=True, sep=', ')
 
1446
 
 
1447
    def authors(self, rev, who, short=False, sep=None):
 
1448
        """Generate list of authors, taking --authors option into account.
 
1449
 
 
1450
        The caller has to specify the name of a author list handler,
 
1451
        as provided by the author list registry, using the ``who``
 
1452
        argument.  That name only sets a default, though: when the
 
1453
        user selected a different author list generation using the
 
1454
        ``--authors`` command line switch, as represented by the
 
1455
        ``author_list_handler`` constructor argument, that value takes
 
1456
        precedence.
 
1457
 
 
1458
        :param rev: The revision for which to generate the list of authors.
 
1459
        :param who: Name of the default handler.
 
1460
        :param short: Whether to shorten names to either name or address.
 
1461
        :param sep: What separator to use for automatic concatenation.
 
1462
        """
 
1463
        if self._author_list_handler is not None:
 
1464
            # The user did specify --authors, which overrides the default
 
1465
            author_list_handler = self._author_list_handler
 
1466
        else:
 
1467
            # The user didn't specify --authors, so we use the caller's default
 
1468
            author_list_handler = author_list_registry.get(who)
 
1469
        names = author_list_handler(rev)
 
1470
        if short:
 
1471
            for i in range(len(names)):
 
1472
                name, address = config.parse_username(names[i])
 
1473
                if name:
 
1474
                    names[i] = name
 
1475
                else:
 
1476
                    names[i] = address
 
1477
        if sep is not None:
 
1478
            names = sep.join(names)
 
1479
        return names
1419
1480
 
1420
1481
    def merge_marker(self, revision):
1421
1482
        """Get the merge marker to include in the output or '' if none."""
1516
1577
                self.merge_marker(revision)))
1517
1578
        if revision.tags:
1518
1579
            lines.append('tags: %s' % (', '.join(revision.tags)))
1519
 
        if self.show_ids:
 
1580
        if self.show_ids or revision.revno is None:
1520
1581
            lines.append('revision-id: %s' % (revision.rev.revision_id,))
 
1582
        if self.show_ids:
1521
1583
            for parent_id in revision.rev.parent_ids:
1522
1584
                lines.append('parent: %s' % (parent_id,))
1523
1585
        lines.extend(self.custom_properties(revision.rev))
1524
1586
 
1525
1587
        committer = revision.rev.committer
1526
 
        authors = revision.rev.get_apparent_authors()
 
1588
        authors = self.authors(revision.rev, 'all')
1527
1589
        if authors != [committer]:
1528
1590
            lines.append('author: %s' % (", ".join(authors),))
1529
1591
        lines.append('committer: %s' % (committer,))
1586
1648
        indent = '    ' * depth
1587
1649
        revno_width = self.revno_width_by_depth.get(depth)
1588
1650
        if revno_width is None:
1589
 
            if revision.revno.find('.') == -1:
 
1651
            if revision.revno is None or revision.revno.find('.') == -1:
1590
1652
                # mainline revno, e.g. 12345
1591
1653
                revno_width = 5
1592
1654
            else:
1600
1662
        if revision.tags:
1601
1663
            tags = ' {%s}' % (', '.join(revision.tags))
1602
1664
        to_file.write(indent + "%*s %s\t%s%s%s\n" % (revno_width,
1603
 
                revision.revno, self.short_author(revision.rev),
 
1665
                revision.revno or "", self.short_author(revision.rev),
1604
1666
                format_date(revision.rev.timestamp,
1605
1667
                            revision.rev.timezone or 0,
1606
1668
                            self.show_timezone, date_fmt="%Y-%m-%d",
1607
1669
                            show_offset=False),
1608
1670
                tags, self.merge_marker(revision)))
1609
1671
        self.show_properties(revision.rev, indent+offset)
1610
 
        if self.show_ids:
 
1672
        if self.show_ids or revision.revno is None:
1611
1673
            to_file.write(indent + offset + 'revision-id:%s\n'
1612
1674
                          % (revision.rev.revision_id,))
1613
1675
        if not revision.rev.message:
1703
1765
                               self.show_timezone,
1704
1766
                               date_fmt='%Y-%m-%d',
1705
1767
                               show_offset=False)
1706
 
        committer_str = revision.rev.get_apparent_authors()[0].replace (' <', '  <')
 
1768
        committer_str = self.authors(revision.rev, 'first', sep=', ')
 
1769
        committer_str = committer_str.replace(' <', '  <')
1707
1770
        to_file.write('%s  %s\n\n' % (date_str,committer_str))
1708
1771
 
1709
1772
        if revision.delta is not None and revision.delta.has_changed():
1774
1837
        raise errors.BzrCommandError("unknown log formatter: %r" % name)
1775
1838
 
1776
1839
 
 
1840
def author_list_all(rev):
 
1841
    return rev.get_apparent_authors()[:]
 
1842
 
 
1843
 
 
1844
def author_list_first(rev):
 
1845
    lst = rev.get_apparent_authors()
 
1846
    try:
 
1847
        return [lst[0]]
 
1848
    except IndexError:
 
1849
        return []
 
1850
 
 
1851
 
 
1852
def author_list_committer(rev):
 
1853
    return [rev.committer]
 
1854
 
 
1855
 
 
1856
author_list_registry = registry.Registry()
 
1857
 
 
1858
author_list_registry.register('all', author_list_all,
 
1859
                              'All authors')
 
1860
 
 
1861
author_list_registry.register('first', author_list_first,
 
1862
                              'The first author')
 
1863
 
 
1864
author_list_registry.register('committer', author_list_committer,
 
1865
                              'The committer')
 
1866
 
 
1867
 
1777
1868
def show_one_log(revno, rev, delta, verbose, to_file, show_timezone):
1778
1869
    # deprecated; for compatibility
1779
1870
    lf = LongLogFormatter(to_file=to_file, show_timezone=show_timezone)
1947
2038
      kind is one of values 'directory', 'file', 'symlink', 'tree-reference'.
1948
2039
      branch will be read-locked.
1949
2040
    """
1950
 
    from builtins import _get_revision_range, safe_relpath_files
 
2041
    from builtins import _get_revision_range
1951
2042
    tree, b, path = bzrdir.BzrDir.open_containing_tree_or_branch(file_list[0])
1952
2043
    add_cleanup(b.lock_read().unlock)
1953
2044
    # XXX: It's damn messy converting a list of paths to relative paths when
1959
2050
    # case of running log in a nested directory, assuming paths beyond the
1960
2051
    # first one haven't been deleted ...
1961
2052
    if tree:
1962
 
        relpaths = [path] + safe_relpath_files(tree, file_list[1:])
 
2053
        relpaths = [path] + tree.safe_relpath_files(file_list[1:])
1963
2054
    else:
1964
2055
        relpaths = [path] + file_list[1:]
1965
2056
    info_list = []