~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/log.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-10-16 21:31:35 UTC
  • mfrom: (3363.19.4 fix-iter-changes)
  • Revision ID: pqm@pqm.ubuntu.com-20081016213135-0115pw9c95l2dyxq
PreviewTree.iter_changes accepts all standard parameters (abentley)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005 Canonical Ltd
2
 
 
 
1
# Copyright (C) 2005, 2006, 2007 Canonical Ltd
 
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
5
5
# the Free Software Foundation; either version 2 of the License, or
6
6
# (at your option) any later version.
7
 
 
 
7
#
8
8
# This program is distributed in the hope that it will be useful,
9
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
11
# GNU General Public License for more details.
12
 
 
 
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
42
42
 
43
43
In verbose mode we show a summary of what changed in each particular
44
44
revision.  Note that this is the delta for changes in that revision
45
 
relative to its mainline parent, not the delta relative to the last
 
45
relative to its left-most parent, not the delta relative to the last
46
46
logged revision.  So for example if you ask for a verbose log of
47
47
changes touching hello.c you will get a list of those revisions also
48
48
listing other things that were changed in the same revision, but not
49
49
all the changes since the previous revision that touched hello.c.
50
50
"""
51
51
 
52
 
 
53
 
# TODO: option to show delta summaries for merged-in revisions
 
52
import codecs
 
53
from itertools import (
 
54
    izip,
 
55
    )
54
56
import re
55
 
 
56
 
from bzrlib.delta import compare_trees
57
 
import bzrlib.errors as errors
58
 
from bzrlib.trace import mutter
59
 
from bzrlib.tree import EmptyTree
60
 
from bzrlib.tsort import merge_sort
 
57
import sys
 
58
from warnings import (
 
59
    warn,
 
60
    )
 
61
 
 
62
from bzrlib.lazy_import import lazy_import
 
63
lazy_import(globals(), """
 
64
 
 
65
from bzrlib import (
 
66
    config,
 
67
    errors,
 
68
    repository as _mod_repository,
 
69
    revision as _mod_revision,
 
70
    revisionspec,
 
71
    trace,
 
72
    tsort,
 
73
    )
 
74
""")
 
75
 
 
76
from bzrlib import (
 
77
    registry,
 
78
    )
 
79
from bzrlib.osutils import (
 
80
    format_date,
 
81
    get_terminal_encoding,
 
82
    terminal_width,
 
83
    )
61
84
 
62
85
 
63
86
def find_touching_revisions(branch, file_id):
104
127
        revno += 1
105
128
 
106
129
 
107
 
 
108
130
def _enumerate_history(branch):
109
131
    rh = []
110
132
    revno = 1
114
136
    return rh
115
137
 
116
138
 
117
 
def _get_revision_delta(branch, revno):
118
 
    """Return the delta for a mainline revision.
119
 
    
120
 
    This is used to show summaries in verbose logs, and also for finding 
121
 
    revisions which touch a given file."""
122
 
    # XXX: What are we supposed to do when showing a summary for something 
123
 
    # other than a mainline revision.  The delta to it's first parent, or
124
 
    # (more useful) the delta to a nominated other revision.
125
 
    return branch.get_revision_delta(revno)
126
 
 
127
 
 
128
139
def show_log(branch,
129
140
             lf,
130
141
             specific_fileid=None,
132
143
             direction='reverse',
133
144
             start_revision=None,
134
145
             end_revision=None,
135
 
             search=None):
 
146
             search=None,
 
147
             limit=None):
136
148
    """Write out human-readable log of commits to this branch.
137
149
 
138
150
    lf
154
166
 
155
167
    end_revision
156
168
        If not None, only show revisions <= end_revision
 
169
 
 
170
    search
 
171
        If not None, only show revisions with matching commit messages
 
172
 
 
173
    limit
 
174
        If not None or 0, only show limit revisions
157
175
    """
158
176
    branch.lock_read()
159
177
    try:
 
178
        if getattr(lf, 'begin_log', None):
 
179
            lf.begin_log()
 
180
 
160
181
        _show_log(branch, lf, specific_fileid, verbose, direction,
161
 
                  start_revision, end_revision, search)
 
182
                  start_revision, end_revision, search, limit)
 
183
 
 
184
        if getattr(lf, 'end_log', None):
 
185
            lf.end_log()
162
186
    finally:
163
187
        branch.unlock()
164
 
    
 
188
 
 
189
 
165
190
def _show_log(branch,
166
191
             lf,
167
192
             specific_fileid=None,
169
194
             direction='reverse',
170
195
             start_revision=None,
171
196
             end_revision=None,
172
 
             search=None):
 
197
             search=None,
 
198
             limit=None):
173
199
    """Worker function for show_log - see show_log."""
174
 
    from bzrlib.osutils import format_date
175
 
    from bzrlib.errors import BzrCheckError
176
 
    from bzrlib.textui import show_status
177
 
    
178
 
    from warnings import warn
179
 
 
180
200
    if not isinstance(lf, LogFormatter):
181
201
        warn("not a LogFormatter instance: %r" % lf)
182
202
 
183
203
    if specific_fileid:
184
 
        mutter('get log for file_id %r', specific_fileid)
185
 
 
186
 
    if search is not None:
187
 
        import re
188
 
        searchRE = re.compile(search, re.IGNORECASE)
 
204
        trace.mutter('get log for file_id %r', specific_fileid)
 
205
    generate_merge_revisions = getattr(lf, 'supports_merge_revisions', False)
 
206
    allow_single_merge_revision = getattr(lf,
 
207
        'supports_single_merge_revision', False)
 
208
    view_revisions = calculate_view_revisions(branch, start_revision,
 
209
                                              end_revision, direction,
 
210
                                              specific_fileid,
 
211
                                              generate_merge_revisions,
 
212
                                              allow_single_merge_revision)
 
213
    rev_tag_dict = {}
 
214
    generate_tags = getattr(lf, 'supports_tags', False)
 
215
    if generate_tags:
 
216
        if branch.supports_tags():
 
217
            rev_tag_dict = branch.tags.get_reverse_tag_dict()
 
218
 
 
219
    generate_delta = verbose and getattr(lf, 'supports_delta', False)
 
220
 
 
221
    # now we just print all the revisions
 
222
    log_count = 0
 
223
    revision_iterator = make_log_rev_iterator(branch, view_revisions,
 
224
        generate_delta, search)
 
225
    for revs in revision_iterator:
 
226
        for (rev_id, revno, merge_depth), rev, delta in revs:
 
227
            lr = LogRevision(rev, revno, merge_depth, delta,
 
228
                             rev_tag_dict.get(rev_id))
 
229
            lf.log_revision(lr)
 
230
            if limit:
 
231
                log_count += 1
 
232
                if log_count >= limit:
 
233
                    return
 
234
 
 
235
 
 
236
def calculate_view_revisions(branch, start_revision, end_revision, direction,
 
237
                             specific_fileid, generate_merge_revisions,
 
238
                             allow_single_merge_revision):
 
239
    if (not generate_merge_revisions and start_revision is end_revision is
 
240
        None and direction == 'reverse' and specific_fileid is None):
 
241
        return _linear_view_revisions(branch)
 
242
 
 
243
    mainline_revs, rev_nos, start_rev_id, end_rev_id = \
 
244
        _get_mainline_revs(branch, start_revision, end_revision)
 
245
    if not mainline_revs:
 
246
        return []
 
247
 
 
248
    if direction == 'reverse':
 
249
        start_rev_id, end_rev_id = end_rev_id, start_rev_id
 
250
 
 
251
    generate_single_revision = False
 
252
    if ((not generate_merge_revisions)
 
253
        and ((start_rev_id and (start_rev_id not in rev_nos))
 
254
            or (end_rev_id and (end_rev_id not in rev_nos)))):
 
255
        generate_single_revision = ((start_rev_id == end_rev_id)
 
256
            and allow_single_merge_revision)
 
257
        if not generate_single_revision:
 
258
            raise errors.BzrCommandError('Selected log formatter only supports'
 
259
                ' mainline revisions.')
 
260
        generate_merge_revisions = generate_single_revision
 
261
    view_revs_iter = get_view_revisions(mainline_revs, rev_nos, branch,
 
262
                          direction, include_merges=generate_merge_revisions)
 
263
    view_revisions = _filter_revision_range(list(view_revs_iter),
 
264
                                            start_rev_id,
 
265
                                            end_rev_id)
 
266
    if view_revisions and generate_single_revision:
 
267
        view_revisions = view_revisions[0:1]
 
268
    if specific_fileid:
 
269
        view_revisions = _filter_revisions_touching_file_id(branch,
 
270
                                                         specific_fileid,
 
271
                                                         view_revisions,
 
272
                                                         direction)
 
273
 
 
274
    # rebase merge_depth - unless there are no revisions or 
 
275
    # either the first or last revision have merge_depth = 0.
 
276
    if view_revisions and view_revisions[0][2] and view_revisions[-1][2]:
 
277
        min_depth = min([d for r,n,d in view_revisions])
 
278
        if min_depth != 0:
 
279
            view_revisions = [(r,n,d-min_depth) for r,n,d in view_revisions]
 
280
    return view_revisions
 
281
 
 
282
 
 
283
def _linear_view_revisions(branch):
 
284
    start_revno, start_revision_id = branch.last_revision_info()
 
285
    repo = branch.repository
 
286
    revision_ids = repo.iter_reverse_revision_history(start_revision_id)
 
287
    for num, revision_id in enumerate(revision_ids):
 
288
        yield revision_id, str(start_revno - num), 0
 
289
 
 
290
 
 
291
def make_log_rev_iterator(branch, view_revisions, generate_delta, search):
 
292
    """Create a revision iterator for log.
 
293
 
 
294
    :param branch: The branch being logged.
 
295
    :param view_revisions: The revisions being viewed.
 
296
    :param generate_delta: Whether to generate a delta for each revision.
 
297
    :param search: A user text search string.
 
298
    :return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
 
299
        delta).
 
300
    """
 
301
    # Convert view_revisions into (view, None, None) groups to fit with
 
302
    # the standard interface here.
 
303
    if type(view_revisions) == list:
 
304
        # A single batch conversion is faster than many incremental ones.
 
305
        # As we have all the data, do a batch conversion.
 
306
        nones = [None] * len(view_revisions)
 
307
        log_rev_iterator = iter([zip(view_revisions, nones, nones)])
189
308
    else:
190
 
        searchRE = None
191
 
 
192
 
    which_revs = _enumerate_history(branch)
193
 
    
 
309
        def _convert():
 
310
            for view in view_revisions:
 
311
                yield (view, None, None)
 
312
        log_rev_iterator = iter([_convert()])
 
313
    for adapter in log_adapters:
 
314
        log_rev_iterator = adapter(branch, generate_delta, search,
 
315
            log_rev_iterator)
 
316
    return log_rev_iterator
 
317
 
 
318
 
 
319
def _make_search_filter(branch, generate_delta, search, log_rev_iterator):
 
320
    """Create a filtered iterator of log_rev_iterator matching on a regex.
 
321
 
 
322
    :param branch: The branch being logged.
 
323
    :param generate_delta: Whether to generate a delta for each revision.
 
324
    :param search: A user text search string.
 
325
    :param log_rev_iterator: An input iterator containing all revisions that
 
326
        could be displayed, in lists.
 
327
    :return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
 
328
        delta).
 
329
    """
 
330
    if search is None:
 
331
        return log_rev_iterator
 
332
    # Compile the search now to get early errors.
 
333
    searchRE = re.compile(search, re.IGNORECASE)
 
334
    return _filter_message_re(searchRE, log_rev_iterator)
 
335
 
 
336
 
 
337
def _filter_message_re(searchRE, log_rev_iterator):
 
338
    for revs in log_rev_iterator:
 
339
        new_revs = []
 
340
        for (rev_id, revno, merge_depth), rev, delta in revs:
 
341
            if searchRE.search(rev.message):
 
342
                new_revs.append(((rev_id, revno, merge_depth), rev, delta))
 
343
        yield new_revs
 
344
 
 
345
 
 
346
def _make_delta_filter(branch, generate_delta, search, log_rev_iterator):
 
347
    """Add revision deltas to a log iterator if needed.
 
348
 
 
349
    :param branch: The branch being logged.
 
350
    :param generate_delta: Whether to generate a delta for each revision.
 
351
    :param search: A user text search string.
 
352
    :param log_rev_iterator: An input iterator containing all revisions that
 
353
        could be displayed, in lists.
 
354
    :return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
 
355
        delta).
 
356
    """
 
357
    if not generate_delta:
 
358
        return log_rev_iterator
 
359
    return _generate_deltas(branch.repository, log_rev_iterator)
 
360
 
 
361
 
 
362
def _generate_deltas(repository, log_rev_iterator):
 
363
    """Create deltas for each batch of revisions in log_rev_iterator."""
 
364
    for revs in log_rev_iterator:
 
365
        revisions = [rev[1] for rev in revs]
 
366
        deltas = repository.get_deltas_for_revisions(revisions)
 
367
        revs = [(rev[0], rev[1], delta) for rev, delta in izip(revs, deltas)]
 
368
        yield revs
 
369
 
 
370
 
 
371
def _make_revision_objects(branch, generate_delta, search, log_rev_iterator):
 
372
    """Extract revision objects from the repository
 
373
 
 
374
    :param branch: The branch being logged.
 
375
    :param generate_delta: Whether to generate a delta for each revision.
 
376
    :param search: A user text search string.
 
377
    :param log_rev_iterator: An input iterator containing all revisions that
 
378
        could be displayed, in lists.
 
379
    :return: An iterator over lists of ((rev_id, revno, merge_depth), rev,
 
380
        delta).
 
381
    """
 
382
    repository = branch.repository
 
383
    for revs in log_rev_iterator:
 
384
        # r = revision_id, n = revno, d = merge depth
 
385
        revision_ids = [view[0] for view, _, _ in revs]
 
386
        revisions = repository.get_revisions(revision_ids)
 
387
        revs = [(rev[0], revision, rev[2]) for rev, revision in
 
388
            izip(revs, revisions)]
 
389
        yield revs
 
390
 
 
391
 
 
392
def _make_batch_filter(branch, generate_delta, search, log_rev_iterator):
 
393
    """Group up a single large batch into smaller ones.
 
394
 
 
395
    :param branch: The branch being logged.
 
396
    :param generate_delta: Whether to generate a delta for each revision.
 
397
    :param search: A user text search string.
 
398
    :param log_rev_iterator: An input iterator containing all revisions that
 
399
        could be displayed, in lists.
 
400
    :return: An iterator over lists of ((rev_id, revno, merge_depth), rev, delta).
 
401
    """
 
402
    repository = branch.repository
 
403
    num = 9
 
404
    for batch in log_rev_iterator:
 
405
        batch = iter(batch)
 
406
        while True:
 
407
            step = [detail for _, detail in zip(range(num), batch)]
 
408
            if len(step) == 0:
 
409
                break
 
410
            yield step
 
411
            num = min(int(num * 1.5), 200)
 
412
 
 
413
 
 
414
def _get_mainline_revs(branch, start_revision, end_revision):
 
415
    """Get the mainline revisions from the branch.
 
416
    
 
417
    Generates the list of mainline revisions for the branch.
 
418
    
 
419
    :param  branch: The branch containing the revisions. 
 
420
 
 
421
    :param  start_revision: The first revision to be logged.
 
422
            For backwards compatibility this may be a mainline integer revno,
 
423
            but for merge revision support a RevisionInfo is expected.
 
424
 
 
425
    :param  end_revision: The last revision to be logged.
 
426
            For backwards compatibility this may be a mainline integer revno,
 
427
            but for merge revision support a RevisionInfo is expected.
 
428
 
 
429
    :return: A (mainline_revs, rev_nos, start_rev_id, end_rev_id) tuple.
 
430
    """
 
431
    branch_revno, branch_last_revision = branch.last_revision_info()
 
432
    if branch_revno == 0:
 
433
        return None, None, None, None
 
434
 
 
435
    # For mainline generation, map start_revision and end_revision to 
 
436
    # mainline revnos. If the revision is not on the mainline choose the 
 
437
    # appropriate extreme of the mainline instead - the extra will be 
 
438
    # filtered later.
 
439
    # Also map the revisions to rev_ids, to be used in the later filtering
 
440
    # stage.
 
441
    start_rev_id = None 
194
442
    if start_revision is None:
195
 
        start_revision = 1
 
443
        start_revno = 1
196
444
    else:
197
 
        branch.check_real_revno(start_revision)
 
445
        if isinstance(start_revision, revisionspec.RevisionInfo):
 
446
            start_rev_id = start_revision.rev_id
 
447
            start_revno = start_revision.revno or 1
 
448
        else:
 
449
            branch.check_real_revno(start_revision)
 
450
            start_revno = start_revision
198
451
    
 
452
    end_rev_id = None
199
453
    if end_revision is None:
200
 
        end_revision = len(which_revs)
201
 
    else:
202
 
        branch.check_real_revno(end_revision)
203
 
 
204
 
    # list indexes are 0-based; revisions are 1-based
205
 
    cut_revs = which_revs[(start_revision-1):(end_revision)]
206
 
    if not cut_revs:
207
 
        return
 
454
        end_revno = branch_revno
 
455
    else:
 
456
        if isinstance(end_revision, revisionspec.RevisionInfo):
 
457
            end_rev_id = end_revision.rev_id
 
458
            end_revno = end_revision.revno or branch_revno
 
459
        else:
 
460
            branch.check_real_revno(end_revision)
 
461
            end_revno = end_revision
 
462
 
 
463
    if ((start_rev_id == _mod_revision.NULL_REVISION)
 
464
        or (end_rev_id == _mod_revision.NULL_REVISION)):
 
465
        raise errors.BzrCommandError('Logging revision 0 is invalid.')
 
466
    if start_revno > end_revno:
 
467
        raise errors.BzrCommandError("Start revision must be older than "
 
468
                                     "the end revision.")
 
469
 
 
470
    if end_revno < start_revno:
 
471
        return None, None, None, None
 
472
    cur_revno = branch_revno
 
473
    rev_nos = {}
 
474
    mainline_revs = []
 
475
    for revision_id in branch.repository.iter_reverse_revision_history(
 
476
                        branch_last_revision):
 
477
        if cur_revno < start_revno:
 
478
            # We have gone far enough, but we always add 1 more revision
 
479
            rev_nos[revision_id] = cur_revno
 
480
            mainline_revs.append(revision_id)
 
481
            break
 
482
        if cur_revno <= end_revno:
 
483
            rev_nos[revision_id] = cur_revno
 
484
            mainline_revs.append(revision_id)
 
485
        cur_revno -= 1
 
486
    else:
 
487
        # We walked off the edge of all revisions, so we add a 'None' marker
 
488
        mainline_revs.append(None)
 
489
 
 
490
    mainline_revs.reverse()
 
491
 
208
492
    # override the mainline to look like the revision history.
209
 
    mainline_revs = [revision_id for index, revision_id in cut_revs]
210
 
    if cut_revs[0][0] == 1:
211
 
        mainline_revs.insert(0, None)
212
 
    else:
213
 
        mainline_revs.insert(0, which_revs[start_revision-2][1])
214
 
 
215
 
    merge_sorted_revisions = merge_sort(
216
 
        branch.repository.get_revision_graph(mainline_revs[-1]),
 
493
    return mainline_revs, rev_nos, start_rev_id, end_rev_id
 
494
 
 
495
 
 
496
def _filter_revision_range(view_revisions, start_rev_id, end_rev_id):
 
497
    """Filter view_revisions based on revision ranges.
 
498
 
 
499
    :param view_revisions: A list of (revision_id, dotted_revno, merge_depth) 
 
500
            tuples to be filtered.
 
501
 
 
502
    :param start_rev_id: If not NONE specifies the first revision to be logged.
 
503
            If NONE then all revisions up to the end_rev_id are logged.
 
504
 
 
505
    :param end_rev_id: If not NONE specifies the last revision to be logged.
 
506
            If NONE then all revisions up to the end of the log are logged.
 
507
 
 
508
    :return: The filtered view_revisions.
 
509
    """
 
510
    if start_rev_id or end_rev_id: 
 
511
        revision_ids = [r for r, n, d in view_revisions]
 
512
        if start_rev_id:
 
513
            start_index = revision_ids.index(start_rev_id)
 
514
        else:
 
515
            start_index = 0
 
516
        if start_rev_id == end_rev_id:
 
517
            end_index = start_index
 
518
        else:
 
519
            if end_rev_id:
 
520
                end_index = revision_ids.index(end_rev_id)
 
521
            else:
 
522
                end_index = len(view_revisions) - 1
 
523
        # To include the revisions merged into the last revision, 
 
524
        # extend end_rev_id down to, but not including, the next rev
 
525
        # with the same or lesser merge_depth
 
526
        end_merge_depth = view_revisions[end_index][2]
 
527
        try:
 
528
            for index in xrange(end_index+1, len(view_revisions)+1):
 
529
                if view_revisions[index][2] <= end_merge_depth:
 
530
                    end_index = index - 1
 
531
                    break
 
532
        except IndexError:
 
533
            # if the search falls off the end then log to the end as well
 
534
            end_index = len(view_revisions) - 1
 
535
        view_revisions = view_revisions[start_index:end_index+1]
 
536
    return view_revisions
 
537
 
 
538
 
 
539
def _filter_revisions_touching_file_id(branch, file_id, view_revisions,
 
540
                                       direction):
 
541
    r"""Return the list of revision ids which touch a given file id.
 
542
 
 
543
    The function filters view_revisions and returns a subset.
 
544
    This includes the revisions which directly change the file id,
 
545
    and the revisions which merge these changes. So if the
 
546
    revision graph is::
 
547
        A-.
 
548
        |\ \
 
549
        B C E
 
550
        |/ /
 
551
        D |
 
552
        |\|
 
553
        | F
 
554
        |/
 
555
        G
 
556
 
 
557
    And 'C' changes a file, then both C and D will be returned. F will not be
 
558
    returned even though it brings the changes to C into the branch starting
 
559
    with E. (Note that if we were using F as the tip instead of G, then we
 
560
    would see C, D, F.)
 
561
 
 
562
    This will also be restricted based on a subset of the mainline.
 
563
 
 
564
    :param branch: The branch where we can get text revision information.
 
565
    :param file_id: Filter out revisions that do not touch file_id.
 
566
    :param view_revisions: A list of (revision_id, dotted_revno, merge_depth)
 
567
        tuples. This is the list of revisions which will be filtered. It is
 
568
        assumed that view_revisions is in merge_sort order (either forward or
 
569
        reverse).
 
570
    :param direction: The direction of view_revisions.  See also
 
571
        reverse_by_depth, and get_view_revisions
 
572
    :return: A list of (revision_id, dotted_revno, merge_depth) tuples.
 
573
    """
 
574
    # Lookup all possible text keys to determine which ones actually modified
 
575
    # the file.
 
576
    text_keys = [(file_id, rev_id) for rev_id, revno, depth in view_revisions]
 
577
    # Looking up keys in batches of 1000 can cut the time in half, as well as
 
578
    # memory consumption. GraphIndex *does* like to look for a few keys in
 
579
    # parallel, it just doesn't like looking for *lots* of keys in parallel.
 
580
    # TODO: This code needs to be re-evaluated periodically as we tune the
 
581
    #       indexing layer. We might consider passing in hints as to the known
 
582
    #       access pattern (sparse/clustered, high success rate/low success
 
583
    #       rate). This particular access is clustered with a low success rate.
 
584
    get_parent_map = branch.repository.texts.get_parent_map
 
585
    modified_text_revisions = set()
 
586
    chunk_size = 1000
 
587
    for start in xrange(0, len(text_keys), chunk_size):
 
588
        next_keys = text_keys[start:start + chunk_size]
 
589
        # Only keep the revision_id portion of the key
 
590
        modified_text_revisions.update(
 
591
            [k[1] for k in get_parent_map(next_keys)])
 
592
    del text_keys, next_keys
 
593
 
 
594
    result = []
 
595
    if direction == 'forward':
 
596
        # TODO: The algorithm for finding 'merges' of file changes expects
 
597
        #       'reverse' order (the default from 'merge_sort()'). Instead of
 
598
        #       forcing this, we could just use the reverse_by_depth order.
 
599
        view_revisions = reverse_by_depth(view_revisions)
 
600
    # Track what revisions will merge the current revision, replace entries
 
601
    # with 'None' when they have been added to result
 
602
    current_merge_stack = [None]
 
603
    for info in view_revisions:
 
604
        rev_id, revno, depth = info
 
605
        if depth == len(current_merge_stack):
 
606
            current_merge_stack.append(info)
 
607
        else:
 
608
            del current_merge_stack[depth + 1:]
 
609
            current_merge_stack[-1] = info
 
610
 
 
611
        if rev_id in modified_text_revisions:
 
612
            # This needs to be logged, along with the extra revisions
 
613
            for idx in xrange(len(current_merge_stack)):
 
614
                node = current_merge_stack[idx]
 
615
                if node is not None:
 
616
                    result.append(node)
 
617
                    current_merge_stack[idx] = None
 
618
    if direction == 'forward':
 
619
        result = reverse_by_depth(result)
 
620
    return result
 
621
 
 
622
 
 
623
def get_view_revisions(mainline_revs, rev_nos, branch, direction,
 
624
                       include_merges=True):
 
625
    """Produce an iterator of revisions to show
 
626
    :return: an iterator of (revision_id, revno, merge_depth)
 
627
    (if there is no revno for a revision, None is supplied)
 
628
    """
 
629
    if include_merges is False:
 
630
        revision_ids = mainline_revs[1:]
 
631
        if direction == 'reverse':
 
632
            revision_ids.reverse()
 
633
        for revision_id in revision_ids:
 
634
            yield revision_id, str(rev_nos[revision_id]), 0
 
635
        return
 
636
    graph = branch.repository.get_graph()
 
637
    # This asks for all mainline revisions, which means we only have to spider
 
638
    # sideways, rather than depth history. That said, its still size-of-history
 
639
    # and should be addressed.
 
640
    # mainline_revisions always includes an extra revision at the beginning, so
 
641
    # don't request it.
 
642
    parent_map = dict(((key, value) for key, value in
 
643
        graph.iter_ancestry(mainline_revs[1:]) if value is not None))
 
644
    # filter out ghosts; merge_sort errors on ghosts.
 
645
    rev_graph = _mod_repository._strip_NULL_ghosts(parent_map)
 
646
    merge_sorted_revisions = tsort.merge_sort(
 
647
        rev_graph,
217
648
        mainline_revs[-1],
218
 
        mainline_revs)
 
649
        mainline_revs,
 
650
        generate_revno=True)
219
651
 
220
 
    if direction == 'reverse':
221
 
        cut_revs.reverse()
222
 
    elif direction == 'forward':
 
652
    if direction == 'forward':
223
653
        # forward means oldest first.
224
 
        merge_sorted_revisions.reverse()
225
 
    else:
 
654
        merge_sorted_revisions = reverse_by_depth(merge_sorted_revisions)
 
655
    elif direction != 'reverse':
226
656
        raise ValueError('invalid direction %r' % direction)
227
657
 
228
 
    revision_history = branch.revision_history()
229
 
 
230
 
    # convert the revision history to a dictionary:
231
 
    rev_nos = {}
232
 
    for index, rev_id in cut_revs:
233
 
        rev_nos[rev_id] = index
234
 
 
235
 
    # now we just print all the revisions
236
 
    for sequence, rev_id, merge_depth, end_of_merge in merge_sorted_revisions:
237
 
        rev = branch.repository.get_revision(rev_id)
238
 
 
239
 
        if searchRE:
240
 
            if not searchRE.search(rev.message):
241
 
                continue
242
 
 
243
 
        if merge_depth == 0:
244
 
            # a mainline revision.
245
 
            if verbose or specific_fileid:
246
 
                delta = _get_revision_delta(branch, rev_nos[rev_id])
247
 
                
248
 
            if specific_fileid:
249
 
                if not delta.touches_file_id(specific_fileid):
250
 
                    continue
251
 
    
252
 
            if not verbose:
253
 
                # although we calculated it, throw it away without display
254
 
                delta = None
255
 
 
256
 
            lf.show(rev_nos[rev_id], rev, delta)
257
 
        elif hasattr(lf, 'show_merge'):
258
 
            lf.show_merge(rev, merge_depth)
259
 
 
260
 
 
261
 
def deltas_for_log_dummy(branch, which_revs):
262
 
    """Return all the revisions without intermediate deltas.
263
 
 
264
 
    Useful for log commands that won't need the delta information.
265
 
    """
266
 
    
267
 
    for revno, revision_id in which_revs:
268
 
        yield revno, branch.get_revision(revision_id), None
269
 
 
270
 
 
271
 
def deltas_for_log_reverse(branch, which_revs):
272
 
    """Compute deltas for display in latest-to-earliest order.
273
 
 
274
 
    branch
275
 
        Branch to traverse
276
 
 
277
 
    which_revs
278
 
        Sequence of (revno, revision_id) for the subset of history to examine
279
 
 
280
 
    returns 
281
 
        Sequence of (revno, rev, delta)
282
 
 
283
 
    The delta is from the given revision to the next one in the
284
 
    sequence, which makes sense if the log is being displayed from
285
 
    newest to oldest.
286
 
    """
287
 
    last_revno = last_revision_id = last_tree = None
288
 
    for revno, revision_id in which_revs:
289
 
        this_tree = branch.revision_tree(revision_id)
290
 
        this_revision = branch.get_revision(revision_id)
291
 
        
292
 
        if last_revno:
293
 
            yield last_revno, last_revision, compare_trees(this_tree, last_tree, False)
294
 
 
295
 
        this_tree = EmptyTree(branch.get_root_id())
296
 
 
297
 
        last_revno = revno
298
 
        last_revision = this_revision
299
 
        last_tree = this_tree
300
 
 
301
 
    if last_revno:
302
 
        if last_revno == 1:
303
 
            this_tree = EmptyTree(branch.get_root_id())
 
658
    for sequence, rev_id, merge_depth, revno, end_of_merge in merge_sorted_revisions:
 
659
        yield rev_id, '.'.join(map(str, revno)), merge_depth
 
660
 
 
661
 
 
662
def reverse_by_depth(merge_sorted_revisions, _depth=0):
 
663
    """Reverse revisions by depth.
 
664
 
 
665
    Revisions with a different depth are sorted as a group with the previous
 
666
    revision of that depth.  There may be no topological justification for this,
 
667
    but it looks much nicer.
 
668
    """
 
669
    zd_revisions = []
 
670
    for val in merge_sorted_revisions:
 
671
        if val[2] == _depth:
 
672
            zd_revisions.append([val])
304
673
        else:
305
 
            this_revno = last_revno - 1
306
 
            this_revision_id = branch.revision_history()[this_revno]
307
 
            this_tree = branch.revision_tree(this_revision_id)
308
 
        yield last_revno, last_revision, compare_trees(this_tree, last_tree, False)
309
 
 
310
 
 
311
 
def deltas_for_log_forward(branch, which_revs):
312
 
    """Compute deltas for display in forward log.
313
 
 
314
 
    Given a sequence of (revno, revision_id) pairs, return
315
 
    (revno, rev, delta).
316
 
 
317
 
    The delta is from the given revision to the next one in the
318
 
    sequence, which makes sense if the log is being displayed from
319
 
    newest to oldest.
 
674
            zd_revisions[-1].append(val)
 
675
    for revisions in zd_revisions:
 
676
        if len(revisions) > 1:
 
677
            revisions[1:] = reverse_by_depth(revisions[1:], _depth + 1)
 
678
    zd_revisions.reverse()
 
679
    result = []
 
680
    for chunk in zd_revisions:
 
681
        result.extend(chunk)
 
682
    return result
 
683
 
 
684
 
 
685
class LogRevision(object):
 
686
    """A revision to be logged (by LogFormatter.log_revision).
 
687
 
 
688
    A simple wrapper for the attributes of a revision to be logged.
 
689
    The attributes may or may not be populated, as determined by the 
 
690
    logging options and the log formatter capabilities.
320
691
    """
321
 
    last_revno = last_revision_id = last_tree = None
322
 
    prev_tree = EmptyTree(branch.get_root_id())
323
 
 
324
 
    for revno, revision_id in which_revs:
325
 
        this_tree = branch.revision_tree(revision_id)
326
 
        this_revision = branch.get_revision(revision_id)
327
 
 
328
 
        if not last_revno:
329
 
            if revno == 1:
330
 
                last_tree = EmptyTree(branch.get_root_id())
331
 
            else:
332
 
                last_revno = revno - 1
333
 
                last_revision_id = branch.revision_history()[last_revno]
334
 
                last_tree = branch.revision_tree(last_revision_id)
335
 
 
336
 
        yield revno, this_revision, compare_trees(last_tree, this_tree, False)
337
 
 
338
 
        last_revno = revno
339
 
        last_revision = this_revision
340
 
        last_tree = this_tree
 
692
 
 
693
    def __init__(self, rev=None, revno=None, merge_depth=0, delta=None,
 
694
                 tags=None):
 
695
        self.rev = rev
 
696
        self.revno = revno
 
697
        self.merge_depth = merge_depth
 
698
        self.delta = delta
 
699
        self.tags = tags
341
700
 
342
701
 
343
702
class LogFormatter(object):
344
 
    """Abstract class to display log messages."""
 
703
    """Abstract class to display log messages.
 
704
 
 
705
    At a minimum, a derived class must implement the log_revision method.
 
706
 
 
707
    If the LogFormatter needs to be informed of the beginning or end of
 
708
    a log it should implement the begin_log and/or end_log hook methods.
 
709
 
 
710
    A LogFormatter should define the following supports_XXX flags 
 
711
    to indicate which LogRevision attributes it supports:
 
712
 
 
713
    - supports_delta must be True if this log formatter supports delta.
 
714
        Otherwise the delta attribute may not be populated.
 
715
    - supports_merge_revisions must be True if this log formatter supports 
 
716
        merge revisions.  If not, and if supports_single_merge_revisions is
 
717
        also not True, then only mainline revisions will be passed to the 
 
718
        formatter.
 
719
    - supports_single_merge_revision must be True if this log formatter
 
720
        supports logging only a single merge revision.  This flag is
 
721
        only relevant if supports_merge_revisions is not True.
 
722
    - supports_tags must be True if this log formatter supports tags.
 
723
        Otherwise the tags attribute may not be populated.
 
724
 
 
725
    Plugins can register functions to show custom revision properties using
 
726
    the properties_handler_registry. The registered function
 
727
    must respect the following interface description:
 
728
        def my_show_properties(properties_dict):
 
729
            # code that returns a dict {'name':'value'} of the properties 
 
730
            # to be shown
 
731
    """
345
732
 
346
733
    def __init__(self, to_file, show_ids=False, show_timezone='original'):
347
734
        self.to_file = to_file
348
735
        self.show_ids = show_ids
349
736
        self.show_timezone = show_timezone
350
737
 
351
 
    def show(self, revno, rev, delta):
352
 
        raise NotImplementedError('not implemented in abstract base')
 
738
# TODO: uncomment this block after show() has been removed.
 
739
# Until then defining log_revision would prevent _show_log calling show() 
 
740
# in legacy formatters.
 
741
#    def log_revision(self, revision):
 
742
#        """Log a revision.
 
743
#
 
744
#        :param  revision:   The LogRevision to be logged.
 
745
#        """
 
746
#        raise NotImplementedError('not implemented in abstract base')
353
747
 
354
748
    def short_committer(self, rev):
355
 
        return re.sub('<.*@.*>', '', rev.committer).strip(' ')
356
 
    
357
 
    
 
749
        name, address = config.parse_username(rev.committer)
 
750
        if name:
 
751
            return name
 
752
        return address
 
753
 
 
754
    def short_author(self, rev):
 
755
        name, address = config.parse_username(rev.get_apparent_author())
 
756
        if name:
 
757
            return name
 
758
        return address
 
759
 
 
760
    def show_properties(self, revision, indent):
 
761
        """Displays the custom properties returned by each registered handler.
 
762
        
 
763
        If a registered handler raises an error it is propagated.
 
764
        """
 
765
        for key, handler in properties_handler_registry.iteritems():
 
766
            for key, value in handler(revision).items():
 
767
                self.to_file.write(indent + key + ': ' + value + '\n')
 
768
 
 
769
 
358
770
class LongLogFormatter(LogFormatter):
359
 
    def show(self, revno, rev, delta):
360
 
        return self._show_helper(revno=revno, rev=rev, delta=delta)
361
 
 
362
 
    def show_merge(self, rev, merge_depth):
363
 
        return self._show_helper(rev=rev, indent='    '*merge_depth, merged=True, delta=None)
364
 
 
365
 
    def _show_helper(self, rev=None, revno=None, indent='', merged=False, delta=None):
366
 
        """Show a revision, either merged or not."""
367
 
        from bzrlib.osutils import format_date
 
771
 
 
772
    supports_merge_revisions = True
 
773
    supports_delta = True
 
774
    supports_tags = True
 
775
 
 
776
    def log_revision(self, revision):
 
777
        """Log a revision, either merged or not."""
 
778
        indent = '    ' * revision.merge_depth
368
779
        to_file = self.to_file
369
 
        print >>to_file,  indent+'-' * 60
370
 
        if revno is not None:
371
 
            print >>to_file,  'revno:', revno
372
 
        if merged:
373
 
            print >>to_file,  indent+'merged:', rev.revision_id
374
 
        elif self.show_ids:
375
 
            print >>to_file,  indent+'revision-id:', rev.revision_id
 
780
        to_file.write(indent + '-' * 60 + '\n')
 
781
        if revision.revno is not None:
 
782
            to_file.write(indent + 'revno: %s\n' % (revision.revno,))
 
783
        if revision.tags:
 
784
            to_file.write(indent + 'tags: %s\n' % (', '.join(revision.tags)))
376
785
        if self.show_ids:
377
 
            for parent_id in rev.parent_ids:
378
 
                print >>to_file, indent+'parent:', parent_id
379
 
        print >>to_file,  indent+'committer:', rev.committer
380
 
        try:
381
 
            print >>to_file, indent+'branch nick: %s' % \
382
 
                rev.properties['branch-nick']
383
 
        except KeyError:
384
 
            pass
385
 
        date_str = format_date(rev.timestamp,
386
 
                               rev.timezone or 0,
 
786
            to_file.write(indent + 'revision-id: ' + revision.rev.revision_id)
 
787
            to_file.write('\n')
 
788
            for parent_id in revision.rev.parent_ids:
 
789
                to_file.write(indent + 'parent: %s\n' % (parent_id,))
 
790
        self.show_properties(revision.rev, indent)
 
791
 
 
792
        author = revision.rev.properties.get('author', None)
 
793
        if author is not None:
 
794
            to_file.write(indent + 'author: %s\n' % (author,))
 
795
        to_file.write(indent + 'committer: %s\n' % (revision.rev.committer,))
 
796
 
 
797
        branch_nick = revision.rev.properties.get('branch-nick', None)
 
798
        if branch_nick is not None:
 
799
            to_file.write(indent + 'branch nick: %s\n' % (branch_nick,))
 
800
 
 
801
        date_str = format_date(revision.rev.timestamp,
 
802
                               revision.rev.timezone or 0,
387
803
                               self.show_timezone)
388
 
        print >>to_file,  indent+'timestamp: %s' % date_str
 
804
        to_file.write(indent + 'timestamp: %s\n' % (date_str,))
389
805
 
390
 
        print >>to_file,  indent+'message:'
391
 
        if not rev.message:
392
 
            print >>to_file,  indent+'  (no message)'
 
806
        to_file.write(indent + 'message:\n')
 
807
        if not revision.rev.message:
 
808
            to_file.write(indent + '  (no message)\n')
393
809
        else:
394
 
            message = rev.message.rstrip('\r\n')
 
810
            message = revision.rev.message.rstrip('\r\n')
395
811
            for l in message.split('\n'):
396
 
                print >>to_file,  indent+'  ' + l
397
 
        if delta != None:
398
 
            delta.show(to_file, self.show_ids)
 
812
                to_file.write(indent + '  %s\n' % (l,))
 
813
        if revision.delta is not None:
 
814
            revision.delta.show(to_file, self.show_ids, indent=indent)
399
815
 
400
816
 
401
817
class ShortLogFormatter(LogFormatter):
402
 
    def show(self, revno, rev, delta):
403
 
        from bzrlib.osutils import format_date
404
 
 
 
818
 
 
819
    supports_delta = True
 
820
    supports_single_merge_revision = True
 
821
 
 
822
    def log_revision(self, revision):
405
823
        to_file = self.to_file
406
 
        date_str = format_date(rev.timestamp, rev.timezone or 0,
407
 
                            self.show_timezone)
408
 
        print >>to_file, "%5d %s\t%s" % (revno, self.short_committer(rev),
409
 
                format_date(rev.timestamp, rev.timezone or 0,
 
824
        is_merge = ''
 
825
        if len(revision.rev.parent_ids) > 1:
 
826
            is_merge = ' [merge]'
 
827
        to_file.write("%5s %s\t%s%s\n" % (revision.revno,
 
828
                self.short_author(revision.rev),
 
829
                format_date(revision.rev.timestamp,
 
830
                            revision.rev.timezone or 0,
410
831
                            self.show_timezone, date_fmt="%Y-%m-%d",
411
 
                           show_offset=False))
 
832
                            show_offset=False),
 
833
                is_merge))
412
834
        if self.show_ids:
413
 
            print >>to_file,  '      revision-id:', rev.revision_id
414
 
        if not rev.message:
415
 
            print >>to_file,  '      (no message)'
 
835
            to_file.write('      revision-id:%s\n' % (revision.rev.revision_id,))
 
836
        if not revision.rev.message:
 
837
            to_file.write('      (no message)\n')
416
838
        else:
417
 
            message = rev.message.rstrip('\r\n')
 
839
            message = revision.rev.message.rstrip('\r\n')
418
840
            for l in message.split('\n'):
419
 
                print >>to_file,  '      ' + l
 
841
                to_file.write('      %s\n' % (l,))
420
842
 
421
843
        # TODO: Why not show the modified files in a shorter form as
422
844
        # well? rewrap them single lines of appropriate length
423
 
        if delta != None:
424
 
            delta.show(to_file, self.show_ids)
425
 
        print >>to_file, ''
 
845
        if revision.delta is not None:
 
846
            revision.delta.show(to_file, self.show_ids)
 
847
        to_file.write('\n')
426
848
 
427
849
 
428
850
class LineLogFormatter(LogFormatter):
 
851
 
 
852
    supports_single_merge_revision = True
 
853
 
 
854
    def __init__(self, *args, **kwargs):
 
855
        super(LineLogFormatter, self).__init__(*args, **kwargs)
 
856
        self._max_chars = terminal_width() - 1
 
857
 
429
858
    def truncate(self, str, max_len):
430
859
        if len(str) <= max_len:
431
860
            return str
432
861
        return str[:max_len-3]+'...'
433
862
 
434
863
    def date_string(self, rev):
435
 
        from bzrlib.osutils import format_date
436
864
        return format_date(rev.timestamp, rev.timezone or 0, 
437
865
                           self.show_timezone, date_fmt="%Y-%m-%d",
438
866
                           show_offset=False)
443
871
        else:
444
872
            return rev.message
445
873
 
446
 
    def show(self, revno, rev, delta):
447
 
        from bzrlib.osutils import terminal_width
448
 
        print >> self.to_file, self.log_string(revno, rev, terminal_width()-1)
 
874
    def log_revision(self, revision):
 
875
        self.to_file.write(self.log_string(revision.revno, revision.rev,
 
876
                                              self._max_chars))
 
877
        self.to_file.write('\n')
449
878
 
450
879
    def log_string(self, revno, rev, max_chars):
451
880
        """Format log info into one string. Truncate tail of string
452
 
        :param  revno:      revision number (int) or None.
 
881
        :param  revno:      revision number or None.
453
882
                            Revision numbers counts from 1.
454
883
        :param  rev:        revision info object
455
884
        :param  max_chars:  maximum length of resulting string
458
887
        out = []
459
888
        if revno:
460
889
            # show revno only when is not None
461
 
            out.append("%d:" % revno)
462
 
        out.append(self.truncate(self.short_committer(rev), 20))
 
890
            out.append("%s:" % revno)
 
891
        out.append(self.truncate(self.short_author(rev), 20))
463
892
        out.append(self.date_string(rev))
464
 
        out.append(self.message(rev).replace('\n', ' '))
 
893
        out.append(rev.get_summary())
465
894
        return self.truncate(" ".join(out).rstrip('\n'), max_chars)
466
895
 
467
896
 
469
898
    lf = LineLogFormatter(None)
470
899
    return lf.log_string(None, rev, max_chars)
471
900
 
472
 
FORMATTERS = {
473
 
              'long': LongLogFormatter,
474
 
              'short': ShortLogFormatter,
475
 
              'line': LineLogFormatter,
476
 
              }
 
901
 
 
902
class LogFormatterRegistry(registry.Registry):
 
903
    """Registry for log formatters"""
 
904
 
 
905
    def make_formatter(self, name, *args, **kwargs):
 
906
        """Construct a formatter from arguments.
 
907
 
 
908
        :param name: Name of the formatter to construct.  'short', 'long' and
 
909
            'line' are built-in.
 
910
        """
 
911
        return self.get(name)(*args, **kwargs)
 
912
 
 
913
    def get_default(self, branch):
 
914
        return self.get(branch.get_config().log_format())
 
915
 
 
916
 
 
917
log_formatter_registry = LogFormatterRegistry()
 
918
 
 
919
 
 
920
log_formatter_registry.register('short', ShortLogFormatter,
 
921
                                'Moderately short log format')
 
922
log_formatter_registry.register('long', LongLogFormatter,
 
923
                                'Detailed log format')
 
924
log_formatter_registry.register('line', LineLogFormatter,
 
925
                                'Log format with one line per revision')
 
926
 
477
927
 
478
928
def register_formatter(name, formatter):
479
 
    FORMATTERS[name] = formatter
 
929
    log_formatter_registry.register(name, formatter)
 
930
 
480
931
 
481
932
def log_formatter(name, *args, **kwargs):
482
933
    """Construct a formatter from arguments.
484
935
    name -- Name of the formatter to construct; currently 'long', 'short' and
485
936
        'line' are supported.
486
937
    """
487
 
    from bzrlib.errors import BzrCommandError
488
938
    try:
489
 
        return FORMATTERS[name](*args, **kwargs)
 
939
        return log_formatter_registry.make_formatter(name, *args, **kwargs)
490
940
    except KeyError:
491
 
        raise BzrCommandError("unknown log formatter: %r" % name)
 
941
        raise errors.BzrCommandError("unknown log formatter: %r" % name)
 
942
 
492
943
 
493
944
def show_one_log(revno, rev, delta, verbose, to_file, show_timezone):
494
 
    # deprecated; for compatability
 
945
    # deprecated; for compatibility
495
946
    lf = LongLogFormatter(to_file=to_file, show_timezone=show_timezone)
496
947
    lf.show(revno, rev, delta)
497
948
 
498
 
def show_changed_revisions(branch, old_rh, new_rh, to_file=None, log_format='long'):
 
949
 
 
950
def show_changed_revisions(branch, old_rh, new_rh, to_file=None,
 
951
                           log_format='long'):
499
952
    """Show the change in revision history comparing the old revision history to the new one.
500
953
 
501
954
    :param branch: The branch where the revisions exist
504
957
    :param to_file: A file to write the results to. If None, stdout will be used
505
958
    """
506
959
    if to_file is None:
507
 
        import sys
508
 
        import codecs
509
 
        import bzrlib
510
 
        to_file = codecs.getwriter(bzrlib.user_encoding)(sys.stdout, errors='replace')
 
960
        to_file = codecs.getwriter(get_terminal_encoding())(sys.stdout,
 
961
            errors='replace')
511
962
    lf = log_formatter(log_format,
512
963
                       show_ids=False,
513
964
                       to_file=to_file,
535
986
        to_file.write('\nRemoved Revisions:\n')
536
987
        for i in range(base_idx, len(old_rh)):
537
988
            rev = branch.repository.get_revision(old_rh[i])
538
 
            lf.show(i+1, rev, None)
 
989
            lr = LogRevision(rev, i+1, 0, None)
 
990
            lf.log_revision(lr)
539
991
        to_file.write('*'*60)
540
992
        to_file.write('\n\n')
541
993
    if base_idx < len(new_rh):
543
995
        show_log(branch,
544
996
                 lf,
545
997
                 None,
546
 
                 verbose=True,
 
998
                 verbose=False,
547
999
                 direction='forward',
548
1000
                 start_revision=base_idx+1,
549
1001
                 end_revision=len(new_rh),
550
1002
                 search=None)
551
1003
 
 
1004
 
 
1005
properties_handler_registry = registry.Registry()
 
1006
 
 
1007
# adapters which revision ids to log are filtered. When log is called, the
 
1008
# log_rev_iterator is adapted through each of these factory methods.
 
1009
# Plugins are welcome to mutate this list in any way they like - as long
 
1010
# as the overall behaviour is preserved. At this point there is no extensible
 
1011
# mechanism for getting parameters to each factory method, and until there is
 
1012
# this won't be considered a stable api.
 
1013
log_adapters = [
 
1014
    # core log logic
 
1015
    _make_batch_filter,
 
1016
    # read revision objects
 
1017
    _make_revision_objects,
 
1018
    # filter on log messages
 
1019
    _make_search_filter,
 
1020
    # generate deltas for things we will show
 
1021
    _make_delta_filter
 
1022
    ]