1
# Copyright (C) 2005, 2006, 2007 Canonical Ltd
 
 
3
# This program is free software; you can redistribute it and/or modify
 
 
4
# it under the terms of the GNU General Public License as published by
 
 
5
# the Free Software Foundation; either version 2 of the License, or
 
 
6
# (at your option) any later version.
 
 
8
# This program is distributed in the hope that it will be useful,
 
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
 
11
# GNU General Public License for more details.
 
 
13
# You should have received a copy of the GNU General Public License
 
 
14
# along with this program; if not, write to the Free Software
 
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
 
19
"""Code to show logs of changes.
 
 
21
Various flavors of log can be produced:
 
 
23
* for one file, or the whole tree, and (not done yet) for
 
 
24
  files in a given directory
 
 
26
* in "verbose" mode with a description of what changed from one
 
 
29
* with file-ids and revision-ids shown
 
 
31
Logs are actually written out through an abstract LogFormatter
 
 
32
interface, which allows for different preferred formats.  Plugins can
 
 
35
Logs can be produced in either forward (oldest->newest) or reverse
 
 
36
(newest->oldest) order.
 
 
38
Logs can be filtered to show only revisions matching a particular
 
 
39
search string, or within a particular range of revisions.  The range
 
 
40
can be given as date/times, which are reduced to revisions before
 
 
43
In verbose mode we show a summary of what changed in each particular
 
 
44
revision.  Note that this is the delta for changes in that revision
 
 
45
relative to its left-most parent, not the delta relative to the last
 
 
46
logged revision.  So for example if you ask for a verbose log of
 
 
47
changes touching hello.c you will get a list of those revisions also
 
 
48
listing other things that were changed in the same revision, but not
 
 
49
all the changes since the previous revision that touched hello.c.
 
 
53
from itertools import (
 
 
58
from warnings import (
 
 
62
from bzrlib.lazy_import import lazy_import
 
 
63
lazy_import(globals(), """
 
 
78
from bzrlib.osutils import (
 
 
80
    get_terminal_encoding,
 
 
83
from bzrlib.symbol_versioning import (
 
 
87
from bzrlib.trace import mutter
 
 
90
def find_touching_revisions(branch, file_id):
 
 
91
    """Yield a description of revisions which affect the file_id.
 
 
93
    Each returned element is (revno, revision_id, description)
 
 
95
    This is the list of revisions where the file is either added,
 
 
96
    modified, renamed or deleted.
 
 
98
    TODO: Perhaps some way to limit this to only particular revisions,
 
 
99
    or to traverse a non-mainline set of revisions?
 
 
104
    for revision_id in branch.revision_history():
 
 
105
        this_inv = branch.repository.get_revision_inventory(revision_id)
 
 
106
        if file_id in this_inv:
 
 
107
            this_ie = this_inv[file_id]
 
 
108
            this_path = this_inv.id2path(file_id)
 
 
110
            this_ie = this_path = None
 
 
112
        # now we know how it was last time, and how it is in this revision.
 
 
113
        # are those two states effectively the same or not?
 
 
115
        if not this_ie and not last_ie:
 
 
116
            # not present in either
 
 
118
        elif this_ie and not last_ie:
 
 
119
            yield revno, revision_id, "added " + this_path
 
 
120
        elif not this_ie and last_ie:
 
 
122
            yield revno, revision_id, "deleted " + last_path
 
 
123
        elif this_path != last_path:
 
 
124
            yield revno, revision_id, ("renamed %s => %s" % (last_path, this_path))
 
 
125
        elif (this_ie.text_size != last_ie.text_size
 
 
126
              or this_ie.text_sha1 != last_ie.text_sha1):
 
 
127
            yield revno, revision_id, "modified " + this_path
 
 
130
        last_path = this_path
 
 
134
def _enumerate_history(branch):
 
 
137
    for rev_id in branch.revision_history():
 
 
138
        rh.append((revno, rev_id))
 
 
145
             specific_fileid=None,
 
 
152
    """Write out human-readable log of commits to this branch.
 
 
155
        LogFormatter object to show the output.
 
 
158
        If true, list only the commits affecting the specified
 
 
159
        file, rather than all commits.
 
 
162
        If true show added/changed/deleted/renamed files.
 
 
165
        'reverse' (default) is latest to earliest;
 
 
166
        'forward' is earliest to latest.
 
 
169
        If not None, only show revisions >= start_revision
 
 
172
        If not None, only show revisions <= end_revision
 
 
175
        If not None, only show revisions with matching commit messages
 
 
178
        If not None or 0, only show limit revisions
 
 
182
        if getattr(lf, 'begin_log', None):
 
 
185
        _show_log(branch, lf, specific_fileid, verbose, direction,
 
 
186
                  start_revision, end_revision, search, limit)
 
 
188
        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)
 
 
209
    if search is not None:
 
 
210
        searchRE = re.compile(search, re.IGNORECASE)
 
 
214
    mainline_revs, rev_nos, start_rev_id, end_rev_id = \
 
 
215
        _get_mainline_revs(branch, start_revision, end_revision)
 
 
216
    if not mainline_revs:
 
 
219
    if direction == 'reverse':
 
 
220
        start_rev_id, end_rev_id = end_rev_id, start_rev_id
 
 
222
    legacy_lf = getattr(lf, 'log_revision', None) is None
 
 
224
        # pre-0.17 formatters use show for mainline revisions.
 
 
225
        # how should we show merged revisions ?
 
 
226
        #   pre-0.11 api: show_merge
 
 
227
        #   0.11-0.16 api: show_merge_revno
 
 
228
        show_merge_revno = getattr(lf, 'show_merge_revno', None)
 
 
229
        show_merge = getattr(lf, 'show_merge', None)
 
 
230
        if show_merge is None and show_merge_revno is None:
 
 
231
            # no merged-revno support
 
 
232
            generate_merge_revisions = False
 
 
234
            generate_merge_revisions = True
 
 
235
        # tell developers to update their code
 
 
236
        symbol_versioning.warn('LogFormatters should provide log_revision '
 
 
237
            'instead of show and show_merge_revno since bzr 0.17.',
 
 
238
            DeprecationWarning, stacklevel=3)
 
 
240
        generate_merge_revisions = getattr(lf, 'supports_merge_revisions', 
 
 
242
    generate_single_revision = False
 
 
243
    if ((not generate_merge_revisions)
 
 
244
        and ((start_rev_id and (start_rev_id not in rev_nos))
 
 
245
            or (end_rev_id and (end_rev_id not in rev_nos)))):
 
 
246
        generate_single_revision = ((start_rev_id == end_rev_id)
 
 
247
            and getattr(lf, 'supports_single_merge_revision', False))
 
 
248
        if not generate_single_revision:
 
 
249
            raise errors.BzrCommandError('Selected log formatter only supports '
 
 
250
                'mainline revisions.')
 
 
251
        generate_merge_revisions = generate_single_revision
 
 
252
    view_revs_iter = get_view_revisions(mainline_revs, rev_nos, branch,
 
 
253
                          direction, include_merges=generate_merge_revisions)
 
 
254
    view_revisions = _filter_revision_range(list(view_revs_iter),
 
 
257
    if view_revisions and generate_single_revision:
 
 
258
        view_revisions = view_revisions[0:1]
 
 
260
        view_revisions = _filter_revisions_touching_file_id(branch,
 
 
265
    # rebase merge_depth - unless there are no revisions or 
 
 
266
    # either the first or last revision have merge_depth = 0.
 
 
267
    if view_revisions and view_revisions[0][2] and view_revisions[-1][2]:
 
 
268
        min_depth = min([d for r,n,d in view_revisions])
 
 
270
            view_revisions = [(r,n,d-min_depth) for r,n,d in view_revisions]
 
 
273
    generate_tags = getattr(lf, 'supports_tags', False)
 
 
275
        if branch.supports_tags():
 
 
276
            rev_tag_dict = branch.tags.get_reverse_tag_dict()
 
 
278
    generate_delta = verbose and getattr(lf, 'supports_delta', False)
 
 
280
    def iter_revisions():
 
 
281
        # r = revision, n = revno, d = merge depth
 
 
282
        revision_ids = [r for r, n, d in view_revisions]
 
 
284
        repository = branch.repository
 
 
287
            revisions = repository.get_revisions(revision_ids[:num])
 
 
289
                deltas = repository.get_deltas_for_revisions(revisions)
 
 
290
                cur_deltas = dict(izip((r.revision_id for r in revisions),
 
 
292
            for revision in revisions:
 
 
293
                yield revision, cur_deltas.get(revision.revision_id)
 
 
294
            revision_ids  = revision_ids[num:]
 
 
295
            num = min(int(num * 1.5), 200)
 
 
297
    # now we just print all the revisions
 
 
299
    for ((rev_id, revno, merge_depth), (rev, delta)) in \
 
 
300
         izip(view_revisions, iter_revisions()):
 
 
303
            if not searchRE.search(rev.message):
 
 
307
            lr = LogRevision(rev, revno, merge_depth, delta,
 
 
308
                             rev_tag_dict.get(rev_id))
 
 
311
            # support for legacy (pre-0.17) LogFormatters
 
 
314
                    lf.show(revno, rev, delta, rev_tag_dict.get(rev_id))
 
 
316
                    lf.show(revno, rev, delta)
 
 
318
                if show_merge_revno is None:
 
 
319
                    lf.show_merge(rev, merge_depth)
 
 
322
                        lf.show_merge_revno(rev, merge_depth, revno,
 
 
323
                                            rev_tag_dict.get(rev_id))
 
 
325
                        lf.show_merge_revno(rev, merge_depth, revno)
 
 
328
            if log_count >= limit:
 
 
332
def _get_mainline_revs(branch, start_revision, end_revision):
 
 
333
    """Get the mainline revisions from the branch.
 
 
335
    Generates the list of mainline revisions for the branch.
 
 
337
    :param  branch: The branch containing the revisions. 
 
 
339
    :param  start_revision: The first revision to be logged.
 
 
340
            For backwards compatibility this may be a mainline integer revno,
 
 
341
            but for merge revision support a RevisionInfo is expected.
 
 
343
    :param  end_revision: The last revision to be logged.
 
 
344
            For backwards compatibility this may be a mainline integer revno,
 
 
345
            but for merge revision support a RevisionInfo is expected.
 
 
347
    :return: A (mainline_revs, rev_nos, start_rev_id, end_rev_id) tuple.
 
 
349
    which_revs = _enumerate_history(branch)
 
 
351
        return None, None, None, None
 
 
353
    # For mainline generation, map start_revision and end_revision to 
 
 
354
    # mainline revnos. If the revision is not on the mainline choose the 
 
 
355
    # appropriate extreme of the mainline instead - the extra will be 
 
 
357
    # Also map the revisions to rev_ids, to be used in the later filtering
 
 
360
    if start_revision is None:
 
 
363
        if isinstance(start_revision, revisionspec.RevisionInfo):
 
 
364
            start_rev_id = start_revision.rev_id
 
 
365
            start_revno = start_revision.revno or 1
 
 
367
            branch.check_real_revno(start_revision)
 
 
368
            start_revno = start_revision
 
 
371
    if end_revision is None:
 
 
372
        end_revno = len(which_revs)
 
 
374
        if isinstance(end_revision, revisionspec.RevisionInfo):
 
 
375
            end_rev_id = end_revision.rev_id
 
 
376
            end_revno = end_revision.revno or len(which_revs)
 
 
378
            branch.check_real_revno(end_revision)
 
 
379
            end_revno = end_revision
 
 
381
    if ((start_rev_id == revision.NULL_REVISION)
 
 
382
        or (end_rev_id == revision.NULL_REVISION)):
 
 
383
        raise errors.BzrCommandError('Logging revision 0 is invalid.')
 
 
384
    if start_revno > end_revno:
 
 
385
        raise errors.BzrCommandError("Start revision must be older than "
 
 
388
    # list indexes are 0-based; revisions are 1-based
 
 
389
    cut_revs = which_revs[(start_revno-1):(end_revno)]
 
 
391
        return None, None, None, None
 
 
393
    # convert the revision history to a dictionary:
 
 
394
    rev_nos = dict((k, v) for v, k in cut_revs)
 
 
396
    # override the mainline to look like the revision history.
 
 
397
    mainline_revs = [revision_id for index, revision_id in cut_revs]
 
 
398
    if cut_revs[0][0] == 1:
 
 
399
        mainline_revs.insert(0, None)
 
 
401
        mainline_revs.insert(0, which_revs[start_revno-2][1])
 
 
402
    return mainline_revs, rev_nos, start_rev_id, end_rev_id
 
 
405
def _filter_revision_range(view_revisions, start_rev_id, end_rev_id):
 
 
406
    """Filter view_revisions based on revision ranges.
 
 
408
    :param view_revisions: A list of (revision_id, dotted_revno, merge_depth) 
 
 
409
            tuples to be filtered.
 
 
411
    :param start_rev_id: If not NONE specifies the first revision to be logged.
 
 
412
            If NONE then all revisions up to the end_rev_id are logged.
 
 
414
    :param end_rev_id: If not NONE specifies the last revision to be logged.
 
 
415
            If NONE then all revisions up to the end of the log are logged.
 
 
417
    :return: The filtered view_revisions.
 
 
419
    if start_rev_id or end_rev_id: 
 
 
420
        revision_ids = [r for r, n, d in view_revisions]
 
 
422
            start_index = revision_ids.index(start_rev_id)
 
 
425
        if start_rev_id == end_rev_id:
 
 
426
            end_index = start_index
 
 
429
                end_index = revision_ids.index(end_rev_id)
 
 
431
                end_index = len(view_revisions) - 1
 
 
432
        # To include the revisions merged into the last revision, 
 
 
433
        # extend end_rev_id down to, but not including, the next rev
 
 
434
        # with the same or lesser merge_depth
 
 
435
        end_merge_depth = view_revisions[end_index][2]
 
 
437
            for index in xrange(end_index+1, len(view_revisions)+1):
 
 
438
                if view_revisions[index][2] <= end_merge_depth:
 
 
439
                    end_index = index - 1
 
 
442
            # if the search falls off the end then log to the end as well
 
 
443
            end_index = len(view_revisions) - 1
 
 
444
        view_revisions = view_revisions[start_index:end_index+1]
 
 
445
    return view_revisions
 
 
448
def _filter_revisions_touching_file_id(branch, file_id, mainline_revisions,
 
 
450
    """Return the list of revision ids which touch a given file id.
 
 
452
    The function filters view_revisions and returns a subset.
 
 
453
    This includes the revisions which directly change the file id,
 
 
454
    and the revisions which merge these changes. So if the
 
 
462
    And 'C' changes a file, then both C and D will be returned.
 
 
464
    This will also can be restricted based on a subset of the mainline.
 
 
466
    :return: A list of (revision_id, dotted_revno, merge_depth) tuples.
 
 
468
    # find all the revisions that change the specific file
 
 
469
    file_weave = branch.repository.weave_store.get_weave(file_id,
 
 
470
                branch.repository.get_transaction())
 
 
471
    weave_modifed_revisions = set(file_weave.versions())
 
 
472
    # build the ancestry of each revision in the graph
 
 
473
    # - only listing the ancestors that change the specific file.
 
 
474
    rev_graph = branch.repository.get_revision_graph(mainline_revisions[-1])
 
 
475
    sorted_rev_list = tsort.topo_sort(rev_graph)
 
 
477
    for rev in sorted_rev_list:
 
 
478
        parents = rev_graph[rev]
 
 
479
        if rev not in weave_modifed_revisions and len(parents) == 1:
 
 
480
            # We will not be adding anything new, so just use a reference to
 
 
481
            # the parent ancestry.
 
 
482
            rev_ancestry = ancestry[parents[0]]
 
 
485
            if rev in weave_modifed_revisions:
 
 
486
                rev_ancestry.add(rev)
 
 
487
            for parent in parents:
 
 
488
                rev_ancestry = rev_ancestry.union(ancestry[parent])
 
 
489
        ancestry[rev] = rev_ancestry
 
 
491
    def is_merging_rev(r):
 
 
492
        parents = rev_graph[r]
 
 
494
            leftparent = parents[0]
 
 
495
            for rightparent in parents[1:]:
 
 
496
                if not ancestry[leftparent].issuperset(
 
 
497
                        ancestry[rightparent]):
 
 
501
    # filter from the view the revisions that did not change or merge 
 
 
503
    return [(r, n, d) for r, n, d in view_revs_iter
 
 
504
            if r in weave_modifed_revisions or is_merging_rev(r)]
 
 
507
def get_view_revisions(mainline_revs, rev_nos, branch, direction,
 
 
508
                       include_merges=True):
 
 
509
    """Produce an iterator of revisions to show
 
 
510
    :return: an iterator of (revision_id, revno, merge_depth)
 
 
511
    (if there is no revno for a revision, None is supplied)
 
 
513
    if include_merges is False:
 
 
514
        revision_ids = mainline_revs[1:]
 
 
515
        if direction == 'reverse':
 
 
516
            revision_ids.reverse()
 
 
517
        for revision_id in revision_ids:
 
 
518
            yield revision_id, str(rev_nos[revision_id]), 0
 
 
520
    merge_sorted_revisions = tsort.merge_sort(
 
 
521
        branch.repository.get_revision_graph(mainline_revs[-1]),
 
 
526
    if direction == 'forward':
 
 
527
        # forward means oldest first.
 
 
528
        merge_sorted_revisions = reverse_by_depth(merge_sorted_revisions)
 
 
529
    elif direction != 'reverse':
 
 
530
        raise ValueError('invalid direction %r' % direction)
 
 
532
    for sequence, rev_id, merge_depth, revno, end_of_merge in merge_sorted_revisions:
 
 
533
        yield rev_id, '.'.join(map(str, revno)), merge_depth
 
 
536
def reverse_by_depth(merge_sorted_revisions, _depth=0):
 
 
537
    """Reverse revisions by depth.
 
 
539
    Revisions with a different depth are sorted as a group with the previous
 
 
540
    revision of that depth.  There may be no topological justification for this,
 
 
541
    but it looks much nicer.
 
 
544
    for val in merge_sorted_revisions:
 
 
546
            zd_revisions.append([val])
 
 
548
            assert val[2] > _depth
 
 
549
            zd_revisions[-1].append(val)
 
 
550
    for revisions in zd_revisions:
 
 
551
        if len(revisions) > 1:
 
 
552
            revisions[1:] = reverse_by_depth(revisions[1:], _depth + 1)
 
 
553
    zd_revisions.reverse()
 
 
555
    for chunk in zd_revisions:
 
 
560
class LogRevision(object):
 
 
561
    """A revision to be logged (by LogFormatter.log_revision).
 
 
563
    A simple wrapper for the attributes of a revision to be logged.
 
 
564
    The attributes may or may not be populated, as determined by the 
 
 
565
    logging options and the log formatter capabilities.
 
 
568
    def __init__(self, rev=None, revno=None, merge_depth=0, delta=None,
 
 
572
        self.merge_depth = merge_depth
 
 
577
class LogFormatter(object):
 
 
578
    """Abstract class to display log messages.
 
 
580
    At a minimum, a derived class must implement the log_revision method.
 
 
582
    If the LogFormatter needs to be informed of the beginning or end of
 
 
583
    a log it should implement the begin_log and/or end_log hook methods.
 
 
585
    A LogFormatter should define the following supports_XXX flags 
 
 
586
    to indicate which LogRevision attributes it supports:
 
 
588
    - supports_delta must be True if this log formatter supports delta.
 
 
589
        Otherwise the delta attribute may not be populated.
 
 
590
    - supports_merge_revisions must be True if this log formatter supports 
 
 
591
        merge revisions.  If not, and if supports_single_merge_revisions is
 
 
592
        also not True, then only mainline revisions will be passed to the 
 
 
594
    - supports_single_merge_revision must be True if this log formatter
 
 
595
        supports logging only a single merge revision.  This flag is
 
 
596
        only relevant if supports_merge_revisions is not True.
 
 
597
    - supports_tags must be True if this log formatter supports tags.
 
 
598
        Otherwise the tags attribute may not be populated.
 
 
601
    def __init__(self, to_file, show_ids=False, show_timezone='original'):
 
 
602
        self.to_file = to_file
 
 
603
        self.show_ids = show_ids
 
 
604
        self.show_timezone = show_timezone
 
 
606
# TODO: uncomment this block after show() has been removed.
 
 
607
# Until then defining log_revision would prevent _show_log calling show() 
 
 
608
# in legacy formatters.
 
 
609
#    def log_revision(self, revision):
 
 
612
#        :param  revision:   The LogRevision to be logged.
 
 
614
#        raise NotImplementedError('not implemented in abstract base')
 
 
616
    @deprecated_method(zero_seventeen)
 
 
617
    def show(self, revno, rev, delta):
 
 
618
        raise NotImplementedError('not implemented in abstract base')
 
 
620
    def short_committer(self, rev):
 
 
621
        name, address = config.parse_username(rev.committer)
 
 
626
    def short_author(self, rev):
 
 
627
        name, address = config.parse_username(rev.get_apparent_author())
 
 
633
class LongLogFormatter(LogFormatter):
 
 
635
    supports_merge_revisions = True
 
 
636
    supports_delta = True
 
 
639
    @deprecated_method(zero_seventeen)
 
 
640
    def show(self, revno, rev, delta, tags=None):
 
 
641
        lr = LogRevision(rev, revno, 0, delta, tags)
 
 
642
        return self.log_revision(lr)
 
 
644
    @deprecated_method(zero_seventeen)
 
 
645
    def show_merge_revno(self, rev, merge_depth, revno, tags=None):
 
 
646
        """Show a merged revision rev, with merge_depth and a revno."""
 
 
647
        lr = LogRevision(rev, revno, merge_depth, tags=tags)
 
 
648
        return self.log_revision(lr)
 
 
650
    def log_revision(self, revision):
 
 
651
        """Log a revision, either merged or not."""
 
 
652
        indent = '    ' * revision.merge_depth
 
 
653
        to_file = self.to_file
 
 
654
        to_file.write(indent + '-' * 60 + '\n')
 
 
655
        if revision.revno is not None:
 
 
656
            to_file.write(indent + 'revno: %s\n' % (revision.revno,))
 
 
658
            to_file.write(indent + 'tags: %s\n' % (', '.join(revision.tags)))
 
 
660
            to_file.write(indent + 'revision-id:' + revision.rev.revision_id)
 
 
662
            for parent_id in revision.rev.parent_ids:
 
 
663
                to_file.write(indent + 'parent: %s\n' % (parent_id,))
 
 
665
        author = revision.rev.properties.get('author', None)
 
 
666
        if author is not None:
 
 
667
            to_file.write(indent + 'author: %s\n' % (author,))
 
 
668
        to_file.write(indent + 'committer: %s\n' % (revision.rev.committer,))
 
 
670
        branch_nick = revision.rev.properties.get('branch-nick', None)
 
 
671
        if branch_nick is not None:
 
 
672
            to_file.write(indent + 'branch nick: %s\n' % (branch_nick,))
 
 
674
        date_str = format_date(revision.rev.timestamp,
 
 
675
                               revision.rev.timezone or 0,
 
 
677
        to_file.write(indent + 'timestamp: %s\n' % (date_str,))
 
 
679
        to_file.write(indent + 'message:\n')
 
 
680
        if not revision.rev.message:
 
 
681
            to_file.write(indent + '  (no message)\n')
 
 
683
            message = revision.rev.message.rstrip('\r\n')
 
 
684
            for l in message.split('\n'):
 
 
685
                to_file.write(indent + '  %s\n' % (l,))
 
 
686
        if revision.delta is not None:
 
 
687
            revision.delta.show(to_file, self.show_ids, indent=indent)
 
 
690
class ShortLogFormatter(LogFormatter):
 
 
692
    supports_delta = True
 
 
693
    supports_single_merge_revision = True
 
 
695
    @deprecated_method(zero_seventeen)
 
 
696
    def show(self, revno, rev, delta):
 
 
697
        lr = LogRevision(rev, revno, 0, delta)
 
 
698
        return self.log_revision(lr)
 
 
700
    def log_revision(self, revision):
 
 
701
        to_file = self.to_file
 
 
702
        date_str = format_date(revision.rev.timestamp,
 
 
703
                               revision.rev.timezone or 0,
 
 
706
        if len(revision.rev.parent_ids) > 1:
 
 
707
            is_merge = ' [merge]'
 
 
708
        to_file.write("%5s %s\t%s%s\n" % (revision.revno,
 
 
709
                self.short_author(revision.rev),
 
 
710
                format_date(revision.rev.timestamp,
 
 
711
                            revision.rev.timezone or 0,
 
 
712
                            self.show_timezone, date_fmt="%Y-%m-%d",
 
 
716
            to_file.write('      revision-id:%s\n' % (revision.rev.revision_id,))
 
 
717
        if not revision.rev.message:
 
 
718
            to_file.write('      (no message)\n')
 
 
720
            message = revision.rev.message.rstrip('\r\n')
 
 
721
            for l in message.split('\n'):
 
 
722
                to_file.write('      %s\n' % (l,))
 
 
724
        # TODO: Why not show the modified files in a shorter form as
 
 
725
        # well? rewrap them single lines of appropriate length
 
 
726
        if revision.delta is not None:
 
 
727
            revision.delta.show(to_file, self.show_ids)
 
 
731
class LineLogFormatter(LogFormatter):
 
 
733
    supports_single_merge_revision = True
 
 
735
    def __init__(self, *args, **kwargs):
 
 
736
        super(LineLogFormatter, self).__init__(*args, **kwargs)
 
 
737
        self._max_chars = terminal_width() - 1
 
 
739
    def truncate(self, str, max_len):
 
 
740
        if len(str) <= max_len:
 
 
742
        return str[:max_len-3]+'...'
 
 
744
    def date_string(self, rev):
 
 
745
        return format_date(rev.timestamp, rev.timezone or 0, 
 
 
746
                           self.show_timezone, date_fmt="%Y-%m-%d",
 
 
749
    def message(self, rev):
 
 
751
            return '(no message)'
 
 
755
    @deprecated_method(zero_seventeen)
 
 
756
    def show(self, revno, rev, delta):
 
 
757
        self.to_file.write(self.log_string(revno, rev, terminal_width()-1))
 
 
758
        self.to_file.write('\n')
 
 
760
    def log_revision(self, revision):
 
 
761
        self.to_file.write(self.log_string(revision.revno, revision.rev,
 
 
763
        self.to_file.write('\n')
 
 
765
    def log_string(self, revno, rev, max_chars):
 
 
766
        """Format log info into one string. Truncate tail of string
 
 
767
        :param  revno:      revision number (int) or None.
 
 
768
                            Revision numbers counts from 1.
 
 
769
        :param  rev:        revision info object
 
 
770
        :param  max_chars:  maximum length of resulting string
 
 
771
        :return:            formatted truncated string
 
 
775
            # show revno only when is not None
 
 
776
            out.append("%s:" % revno)
 
 
777
        out.append(self.truncate(self.short_author(rev), 20))
 
 
778
        out.append(self.date_string(rev))
 
 
779
        out.append(rev.get_summary())
 
 
780
        return self.truncate(" ".join(out).rstrip('\n'), max_chars)
 
 
783
def line_log(rev, max_chars):
 
 
784
    lf = LineLogFormatter(None)
 
 
785
    return lf.log_string(None, rev, max_chars)
 
 
788
class LogFormatterRegistry(registry.Registry):
 
 
789
    """Registry for log formatters"""
 
 
791
    def make_formatter(self, name, *args, **kwargs):
 
 
792
        """Construct a formatter from arguments.
 
 
794
        :param name: Name of the formatter to construct.  'short', 'long' and
 
 
797
        return self.get(name)(*args, **kwargs)
 
 
799
    def get_default(self, branch):
 
 
800
        return self.get(branch.get_config().log_format())
 
 
803
log_formatter_registry = LogFormatterRegistry()
 
 
806
log_formatter_registry.register('short', ShortLogFormatter,
 
 
807
                                'Moderately short log format')
 
 
808
log_formatter_registry.register('long', LongLogFormatter,
 
 
809
                                'Detailed log format')
 
 
810
log_formatter_registry.register('line', LineLogFormatter,
 
 
811
                                'Log format with one line per revision')
 
 
814
def register_formatter(name, formatter):
 
 
815
    log_formatter_registry.register(name, formatter)
 
 
818
def log_formatter(name, *args, **kwargs):
 
 
819
    """Construct a formatter from arguments.
 
 
821
    name -- Name of the formatter to construct; currently 'long', 'short' and
 
 
822
        'line' are supported.
 
 
825
        return log_formatter_registry.make_formatter(name, *args, **kwargs)
 
 
827
        raise errors.BzrCommandError("unknown log formatter: %r" % name)
 
 
830
def show_one_log(revno, rev, delta, verbose, to_file, show_timezone):
 
 
831
    # deprecated; for compatibility
 
 
832
    lf = LongLogFormatter(to_file=to_file, show_timezone=show_timezone)
 
 
833
    lf.show(revno, rev, delta)
 
 
836
def show_changed_revisions(branch, old_rh, new_rh, to_file=None,
 
 
838
    """Show the change in revision history comparing the old revision history to the new one.
 
 
840
    :param branch: The branch where the revisions exist
 
 
841
    :param old_rh: The old revision history
 
 
842
    :param new_rh: The new revision history
 
 
843
    :param to_file: A file to write the results to. If None, stdout will be used
 
 
846
        to_file = codecs.getwriter(get_terminal_encoding())(sys.stdout,
 
 
848
    lf = log_formatter(log_format,
 
 
851
                       show_timezone='original')
 
 
853
    # This is the first index which is different between
 
 
856
    for i in xrange(max(len(new_rh),
 
 
860
            or new_rh[i] != old_rh[i]):
 
 
865
        to_file.write('Nothing seems to have changed\n')
 
 
867
    ## TODO: It might be nice to do something like show_log
 
 
868
    ##       and show the merged entries. But since this is the
 
 
869
    ##       removed revisions, it shouldn't be as important
 
 
870
    if base_idx < len(old_rh):
 
 
871
        to_file.write('*'*60)
 
 
872
        to_file.write('\nRemoved Revisions:\n')
 
 
873
        for i in range(base_idx, len(old_rh)):
 
 
874
            rev = branch.repository.get_revision(old_rh[i])
 
 
875
            lr = LogRevision(rev, i+1, 0, None)
 
 
877
        to_file.write('*'*60)
 
 
878
        to_file.write('\n\n')
 
 
879
    if base_idx < len(new_rh):
 
 
880
        to_file.write('Added Revisions:\n')
 
 
886
                 start_revision=base_idx+1,
 
 
887
                 end_revision=len(new_rh),