/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/annotate.py

  • Committer: Robert Collins
  • Date: 2010-05-06 11:08:10 UTC
  • mto: This revision was merged to the branch mainline in revision 5223.
  • Revision ID: robertc@robertcollins.net-20100506110810-h3j07fh5gmw54s25
Cleaner matcher matching revised unlocking protocol.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/annotate.py
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009 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
16
16
 
17
17
"""File annotate based on weave storage"""
18
18
 
19
 
from __future__ import absolute_import
20
 
 
21
19
# TODO: Choice of more or less verbose formats:
22
20
#
23
21
# interposed: show more details between blocks of modified lines
30
28
import sys
31
29
import time
32
30
 
33
 
from .lazy_import import lazy_import
34
 
lazy_import(globals(), """
35
 
 
36
 
import patiencediff
37
 
 
38
 
from breezy import (
 
31
from bzrlib import (
 
32
    errors,
 
33
    osutils,
 
34
    patiencediff,
39
35
    tsort,
40
36
    )
41
 
""")
42
 
from . import (
43
 
    osutils,
44
 
    )
45
 
from .config import (
46
 
    NoEmailInUsername,
47
 
    NoWhoami,
48
 
    extract_email_address,
49
 
    )
50
 
from .repository import _strip_NULL_ghosts
51
 
from .revision import (
52
 
    CURRENT_REVISION,
53
 
    Revision,
54
 
    )
55
 
 
56
 
 
57
 
def annotate_file_tree(tree, path, to_file, verbose=False, full=False,
58
 
                       show_ids=False, branch=None):
59
 
    """Annotate path in a tree.
 
37
from bzrlib.config import extract_email_address
 
38
from bzrlib.repository import _strip_NULL_ghosts
 
39
from bzrlib.revision import CURRENT_REVISION, Revision
 
40
 
 
41
 
 
42
def annotate_file(branch, rev_id, file_id, verbose=False, full=False,
 
43
                  to_file=None, show_ids=False):
 
44
    """Annotate file_id at revision rev_id in branch.
 
45
 
 
46
    The branch should already be read_locked() when annotate_file is called.
 
47
 
 
48
    :param branch: The branch to look for revision numbers and history from.
 
49
    :param rev_id: The revision id to annotate.
 
50
    :param file_id: The file_id to annotate.
 
51
    :param verbose: Show all details rather than truncating to ensure
 
52
        reasonable text width.
 
53
    :param full: XXXX Not sure what this does.
 
54
    :param to_file: The file to output the annotation to; if None stdout is
 
55
        used.
 
56
    :param show_ids: Show revision ids in the annotation output.
 
57
    """
 
58
    if to_file is None:
 
59
        to_file = sys.stdout
 
60
 
 
61
    # Handle the show_ids case
 
62
    annotations = _annotations(branch.repository, file_id, rev_id)
 
63
    if show_ids:
 
64
        return _show_id_annotations(annotations, to_file, full)
 
65
 
 
66
    # Calculate the lengths of the various columns
 
67
    annotation = list(_expand_annotations(annotations, branch))
 
68
    _print_annotations(annotation, verbose, to_file, full)
 
69
 
 
70
 
 
71
def annotate_file_tree(tree, file_id, to_file, verbose=False, full=False,
 
72
    show_ids=False):
 
73
    """Annotate file_id in a tree.
60
74
 
61
75
    The tree should already be read_locked() when annotate_file_tree is called.
62
76
 
63
77
    :param tree: The tree to look for revision numbers and history from.
64
 
    :param path: The path to annotate
 
78
    :param file_id: The file_id to annotate.
65
79
    :param to_file: The file to output the annotation to.
66
80
    :param verbose: Show all details rather than truncating to ensure
67
81
        reasonable text width.
68
82
    :param full: XXXX Not sure what this does.
69
83
    :param show_ids: Show revision ids in the annotation output.
70
 
    :param branch: Branch to use for revision revno lookups
71
84
    """
72
 
    if branch is None:
73
 
        branch = tree.branch
74
 
    if to_file is None:
75
 
        to_file = sys.stdout
 
85
    rev_id = tree.last_revision()
 
86
    branch = tree.branch
76
87
 
77
 
    encoding = osutils.get_terminal_encoding()
78
88
    # Handle the show_ids case
79
 
    annotations = list(tree.annotate_iter(path))
 
89
    annotations = list(tree.annotate_iter(file_id))
80
90
    if show_ids:
81
 
        return _show_id_annotations(annotations, to_file, full, encoding)
82
 
 
83
 
    if not getattr(tree, "get_revision_id", False):
84
 
        # Create a virtual revision to represent the current tree state.
85
 
        # Should get some more pending commit attributes, like pending tags,
86
 
        # bugfixes etc.
87
 
        current_rev = Revision(CURRENT_REVISION)
88
 
        current_rev.parent_ids = tree.get_parent_ids()
89
 
        try:
90
 
            current_rev.committer = branch.get_config_stack().get('email')
91
 
        except NoWhoami:
92
 
            current_rev.committer = 'local user'
93
 
        current_rev.message = "?"
94
 
        current_rev.timestamp = round(time.time(), 3)
95
 
        current_rev.timezone = osutils.local_time_offset()
96
 
    else:
97
 
        current_rev = None
98
 
    annotation = list(_expand_annotations(
99
 
        annotations, branch, current_rev))
100
 
    _print_annotations(annotation, verbose, to_file, full, encoding)
101
 
 
102
 
 
103
 
def _print_annotations(annotation, verbose, to_file, full, encoding):
 
91
        return _show_id_annotations(annotations, to_file, full)
 
92
 
 
93
    # Create a virtual revision to represent the current tree state.
 
94
    # Should get some more pending commit attributes, like pending tags,
 
95
    # bugfixes etc.
 
96
    current_rev = Revision(CURRENT_REVISION)
 
97
    current_rev.parent_ids = tree.get_parent_ids()
 
98
    current_rev.committer = tree.branch.get_config().username()
 
99
    current_rev.message = "?"
 
100
    current_rev.timestamp = round(time.time(), 3)
 
101
    current_rev.timezone = osutils.local_time_offset()
 
102
    annotation = list(_expand_annotations(annotations, tree.branch,
 
103
        current_rev))
 
104
    _print_annotations(annotation, verbose, to_file, full)
 
105
 
 
106
 
 
107
def _print_annotations(annotation, verbose, to_file, full):
104
108
    """Print annotations to to_file.
105
109
 
106
110
    :param to_file: The file to output the annotation to.
109
113
    :param full: XXXX Not sure what this does.
110
114
    """
111
115
    if len(annotation) == 0:
112
 
        max_origin_len = max_revno_len = 0
 
116
        max_origin_len = max_revno_len = max_revid_len = 0
113
117
    else:
114
118
        max_origin_len = max(len(x[1]) for x in annotation)
115
119
        max_revno_len = max(len(x[0]) for x in annotation)
 
120
        max_revid_len = max(len(x[3]) for x in annotation)
116
121
    if not verbose:
117
122
        max_revno_len = min(max_revno_len, 12)
118
123
    max_revno_len = max(max_revno_len, 3)
119
124
 
120
125
    # Output the annotations
121
126
    prevanno = ''
 
127
    encoding = getattr(to_file, 'encoding', None) or \
 
128
            osutils.get_terminal_encoding()
122
129
    for (revno_str, author, date_str, line_rev_id, text) in annotation:
123
130
        if verbose:
124
131
            anno = '%-*s %-*s %8s ' % (max_revno_len, revno_str,
125
132
                                       max_origin_len, author, date_str)
126
133
        else:
127
134
            if len(revno_str) > max_revno_len:
128
 
                revno_str = revno_str[:max_revno_len - 1] + '>'
 
135
                revno_str = revno_str[:max_revno_len-1] + '>'
129
136
            anno = "%-*s %-7s " % (max_revno_len, revno_str, author[:7])
130
137
        if anno.lstrip() == "" and full:
131
138
            anno = prevanno
132
 
        # GZ 2017-05-21: Writing both unicode annotation and bytes from file
133
 
        # which the given to_file must cope with.
134
 
        to_file.write(anno)
135
 
        to_file.write('| %s\n' % (text.decode(encoding),))
 
139
        try:
 
140
            to_file.write(anno)
 
141
        except UnicodeEncodeError:
 
142
            # cmd_annotate should be passing in an 'exact' object, which means
 
143
            # we have a direct handle to sys.stdout or equivalent. It may not
 
144
            # be able to handle the exact Unicode characters, but 'annotate' is
 
145
            # a user function (non-scripting), so shouldn't die because of
 
146
            # unrepresentable annotation characters. So encode using 'replace',
 
147
            # and write them again.
 
148
            to_file.write(anno.encode(encoding, 'replace'))
 
149
        to_file.write('| %s\n' % (text,))
136
150
        prevanno = anno
137
151
 
138
152
 
139
 
def _show_id_annotations(annotations, to_file, full, encoding):
 
153
def _show_id_annotations(annotations, to_file, full):
140
154
    if not annotations:
141
155
        return
142
156
    last_rev_id = None
145
159
        if full or last_rev_id != origin:
146
160
            this = origin
147
161
        else:
148
 
            this = b''
149
 
        to_file.write('%*s | %s' % (
150
 
            max_origin_len, this.decode('utf-8'), text.decode(encoding)))
 
162
            this = ''
 
163
        to_file.write('%*s | %s' % (max_origin_len, this, text))
151
164
        last_rev_id = origin
152
165
    return
153
166
 
154
167
 
 
168
def _annotations(repo, file_id, rev_id):
 
169
    """Return the list of (origin_revision_id, line_text) for a revision of a file in a repository."""
 
170
    annotations = repo.texts.annotate((file_id, rev_id))
 
171
    #
 
172
    return [(key[-1], line) for (key, line) in annotations]
 
173
 
 
174
 
155
175
def _expand_annotations(annotations, branch, current_rev=None):
156
176
    """Expand a file's annotations into command line UI ready tuples.
157
177
 
163
183
    :param branch: A locked branch to query for revision details.
164
184
    """
165
185
    repository = branch.repository
166
 
    revision_ids = set(o for o, t in annotations)
167
186
    if current_rev is not None:
168
 
        # This can probably become a function on MutableTree, get_revno_map
169
 
        # there, or something.
 
187
        # This can probably become a function on MutableTree, get_revno_map there,
 
188
        # or something.
170
189
        last_revision = current_rev.revision_id
171
190
        # XXX: Partially Cloned from branch, uses the old_get_graph, eep.
172
191
        # XXX: The main difficulty is that we need to inject a single new node
174
193
        #      Once KnownGraph gets an 'add_node()' function, we can use
175
194
        #      VF.get_known_graph_ancestry().
176
195
        graph = repository.get_graph()
177
 
        revision_graph = {
178
 
            key: value for key, value in
179
 
            graph.iter_ancestry(current_rev.parent_ids) if value is not None}
 
196
        revision_graph = dict(((key, value) for key, value in
 
197
            graph.iter_ancestry(current_rev.parent_ids) if value is not None))
180
198
        revision_graph = _strip_NULL_ghosts(revision_graph)
181
199
        revision_graph[last_revision] = current_rev.parent_ids
182
200
        merge_sorted_revisions = tsort.merge_sort(
184
202
            last_revision,
185
203
            None,
186
204
            generate_revno=True)
187
 
        revision_id_to_revno = {
188
 
            rev_id: revno
 
205
        revision_id_to_revno = dict((rev_id, revno)
189
206
            for seq_num, rev_id, depth, revno, end_of_merge in
190
 
            merge_sorted_revisions}
 
207
                merge_sorted_revisions)
191
208
    else:
192
 
        # TODO(jelmer): Only look up the revision ids that we need (i.e. those
193
 
        # in revision_ids). Possibly add a HPSS call that can look those up
194
 
        # in bulk over HPSS.
195
209
        revision_id_to_revno = branch.get_revision_id_to_revno_map()
196
210
    last_origin = None
 
211
    revision_ids = set(o for o, t in annotations)
197
212
    revisions = {}
198
213
    if CURRENT_REVISION in revision_ids:
199
214
        revision_id_to_revno[CURRENT_REVISION] = (
200
215
            "%d?" % (branch.revno() + 1),)
201
216
        revisions[CURRENT_REVISION] = current_rev
202
 
    revisions.update(
203
 
        entry for entry in
204
 
        repository.iter_revisions(revision_ids)
205
 
        if entry[1] is not None)
 
217
    revision_ids = [o for o in revision_ids if
 
218
                    repository.has_revision(o)]
 
219
    revisions.update((r.revision_id, r) for r in
 
220
                     repository.get_revisions(revision_ids))
206
221
    for origin, text in annotations:
207
 
        text = text.rstrip(b'\r\n')
 
222
        text = text.rstrip('\r\n')
208
223
        if origin == last_origin:
209
 
            (revno_str, author, date_str) = ('', '', '')
 
224
            (revno_str, author, date_str) = ('','','')
210
225
        else:
211
226
            last_origin = origin
212
227
            if origin not in revisions:
213
 
                (revno_str, author, date_str) = ('?', '?', '?')
 
228
                (revno_str, author, date_str) = ('?','?','?')
214
229
            else:
215
 
                revno_str = '.'.join(
216
 
                    str(i) for i in revision_id_to_revno[origin])
 
230
                revno_str = '.'.join(str(i) for i in
 
231
                                            revision_id_to_revno[origin])
217
232
            rev = revisions[origin]
218
233
            tz = rev.timezone or 0
219
234
            date_str = time.strftime('%Y%m%d',
223
238
            author = rev.get_apparent_authors()[0]
224
239
            try:
225
240
                author = extract_email_address(author)
226
 
            except NoEmailInUsername:
 
241
            except errors.NoEmailInUsername:
227
242
                pass        # use the whole name
228
243
        yield (revno_str, author, date_str, origin, text)
229
244
 
284
299
    new_cur = 0
285
300
    if matching_blocks is None:
286
301
        plain_parent_lines = [l for r, l in parent_lines]
287
 
        matcher = patiencediff.PatienceSequenceMatcher(
288
 
            None, plain_parent_lines, new_lines)
 
302
        matcher = patiencediff.PatienceSequenceMatcher(None,
 
303
            plain_parent_lines, new_lines)
289
304
        matching_blocks = matcher.get_matching_blocks()
290
305
    lines = []
291
306
    for i, j, n in matching_blocks:
292
307
        for line in new_lines[new_cur:j]:
293
308
            lines.append((new_revision_id, line))
294
 
        lines.extend(parent_lines[i:i + n])
 
309
        lines.extend(parent_lines[i:i+n])
295
310
        new_cur = j + n
296
311
    return lines
297
312
 
298
313
 
299
314
def _get_matching_blocks(old, new):
300
 
    matcher = patiencediff.PatienceSequenceMatcher(None, old, new)
 
315
    matcher = patiencediff.PatienceSequenceMatcher(None,
 
316
        old, new)
301
317
    return matcher.get_matching_blocks()
302
318
 
303
319
 
304
320
_break_annotation_tie = None
305
321
 
306
 
 
307
322
def _old_break_annotation_tie(annotated_lines):
308
323
    """Chose an attribution between several possible ones.
309
324
 
351
366
    output_extend = output_lines.extend
352
367
    output_append = output_lines.append
353
368
    # We need to see if any of the unannotated lines match
354
 
    plain_right_subset = [l for a, l in right_lines[start_right:end_right]]
 
369
    plain_right_subset = [l for a,l in right_lines[start_right:end_right]]
355
370
    plain_child_subset = plain_child_lines[start_child:end_child]
356
371
    match_blocks = _get_matching_blocks(plain_right_subset, plain_child_subset)
357
372
 
360
375
    for right_idx, child_idx, match_len in match_blocks:
361
376
        # All the lines that don't match are just passed along
362
377
        if child_idx > last_child_idx:
363
 
            output_extend(child_lines[start_child + last_child_idx:
364
 
                                      start_child + child_idx])
365
 
        for offset in range(match_len):
366
 
            left = child_lines[start_child + child_idx + offset]
367
 
            right = right_lines[start_right + right_idx + offset]
 
378
            output_extend(child_lines[start_child + last_child_idx
 
379
                                      :start_child + child_idx])
 
380
        for offset in xrange(match_len):
 
381
            left = child_lines[start_child+child_idx+offset]
 
382
            right = right_lines[start_right+right_idx+offset]
368
383
            if left[0] == right[0]:
369
384
                # The annotations match, just return the left one
370
385
                output_append(left)
379
394
                else:
380
395
                    heads = heads_provider.heads((left[0], right[0]))
381
396
                    if len(heads) == 1:
382
 
                        output_append((next(iter(heads)), left[1]))
 
397
                        output_append((iter(heads).next(), left[1]))
383
398
                    else:
384
399
                        # Both claim different origins, get a stable result.
385
400
                        # If the result is not stable, there is a risk a
414
429
    # be the bulk of the lines, and they will need no further processing.
415
430
    lines = []
416
431
    lines_extend = lines.extend
417
 
    # The line just after the last match from the right side
418
 
    last_right_idx = 0
 
432
    last_right_idx = 0 # The line just after the last match from the right side
419
433
    last_left_idx = 0
420
434
    matching_left_and_right = _get_matching_blocks(right_parent_lines,
421
435
                                                   annotated_lines)
443
457
 
444
458
 
445
459
try:
446
 
    from breezy._annotator_pyx import Annotator
447
 
except ImportError as e:
 
460
    from bzrlib._annotator_pyx import Annotator
 
461
except ImportError, e:
448
462
    osutils.failed_to_load_extension(e)
449
 
    from breezy._annotator_py import Annotator  # noqa: F401
 
463
    from bzrlib._annotator_py import Annotator