← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/annotate.py

  • Committer: Jelmer Vernooij
  • Date: 2012-01-24 13:14:06 UTC
  • mto: (6445.4.5 nested-trees-spec)
  • mto: This revision was merged to the branch mainline in revision 6518.
  • Revision ID: jelmer@samba.org-20120124131406-wedftkorbpv37bm0
Import nested tree doc from devnotes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/annotate.py
16
16
 
17
17
"""File annotate based on weave storage"""
18
18
 
 
19
from __future__ import absolute_import
 
20
 
19
21
# TODO: Choice of more or less verbose formats:
20
22
#
21
23
# interposed: show more details between blocks of modified lines
41
43
    )
42
44
from bzrlib.config import extract_email_address
43
45
from bzrlib.repository import _strip_NULL_ghosts
44
 
from bzrlib.revision import CURRENT_REVISION, Revision
45
 
 
46
 
 
 
46
from bzrlib.revision import (
 
47
    CURRENT_REVISION,
 
48
    Revision,
 
49
    )
 
50
from bzrlib.symbol_versioning import (
 
51
    deprecated_function,
 
52
    deprecated_in,
 
53
    )
 
54
 
 
55
 
 
56
@deprecated_function(deprecated_in((2, 4, 0)))
47
57
def annotate_file(branch, rev_id, file_id, verbose=False, full=False,
48
58
                  to_file=None, show_ids=False):
49
59
    """Annotate file_id at revision rev_id in branch.
60
70
        used.
61
71
    :param show_ids: Show revision ids in the annotation output.
62
72
    """
63
 
    if to_file is None:
64
 
        to_file = sys.stdout
65
 
 
66
 
    # Handle the show_ids case
67
 
    annotations = _annotations(branch.repository, file_id, rev_id)
68
 
    if show_ids:
69
 
        return _show_id_annotations(annotations, to_file, full)
70
 
 
71
 
    # Calculate the lengths of the various columns
72
 
    annotation = list(_expand_annotations(annotations, branch))
73
 
    _print_annotations(annotation, verbose, to_file, full)
 
73
    tree = branch.repository.revision_tree(rev_id)
 
74
    annotate_file_tree(tree, file_id, to_file, verbose=verbose,
 
75
        full=full, show_ids=show_ids, branch=branch)
74
76
 
75
77
 
76
78
def annotate_file_tree(tree, file_id, to_file, verbose=False, full=False,
77
 
    show_ids=False):
 
79
    show_ids=False, branch=None):
78
80
    """Annotate file_id in a tree.
79
81
 
80
82
    The tree should already be read_locked() when annotate_file_tree is called.
86
88
        reasonable text width.
87
89
    :param full: XXXX Not sure what this does.
88
90
    :param show_ids: Show revision ids in the annotation output.
 
91
    :param branch: Branch to use for revision revno lookups
89
92
    """
90
 
    rev_id = tree.last_revision()
91
 
    branch = tree.branch
 
93
    if branch is None:
 
94
        branch = tree.branch
 
95
    if to_file is None:
 
96
        to_file = sys.stdout
92
97
 
93
98
    # Handle the show_ids case
94
99
    annotations = list(tree.annotate_iter(file_id))
95
100
    if show_ids:
96
101
        return _show_id_annotations(annotations, to_file, full)
97
102
 
98
 
    # Create a virtual revision to represent the current tree state.
99
 
    # Should get some more pending commit attributes, like pending tags,
100
 
    # bugfixes etc.
101
 
    current_rev = Revision(CURRENT_REVISION)
102
 
    current_rev.parent_ids = tree.get_parent_ids()
103
 
    current_rev.committer = tree.branch.get_config().username()
104
 
    current_rev.message = "?"
105
 
    current_rev.timestamp = round(time.time(), 3)
106
 
    current_rev.timezone = osutils.local_time_offset()
107
 
    annotation = list(_expand_annotations(annotations, tree.branch,
 
103
    if not getattr(tree, "get_revision_id", False):
 
104
        # Create a virtual revision to represent the current tree state.
 
105
        # Should get some more pending commit attributes, like pending tags,
 
106
        # bugfixes etc.
 
107
        current_rev = Revision(CURRENT_REVISION)
 
108
        current_rev.parent_ids = tree.get_parent_ids()
 
109
        try:
 
110
            current_rev.committer = branch.get_config_stack().get('email')
 
111
        except errors.NoWhoami:
 
112
            current_rev.committer = 'local user'
 
113
        current_rev.message = "?"
 
114
        current_rev.timestamp = round(time.time(), 3)
 
115
        current_rev.timezone = osutils.local_time_offset()
 
116
    else:
 
117
        current_rev = None
 
118
    annotation = list(_expand_annotations(annotations, branch,
108
119
        current_rev))
109
120
    _print_annotations(annotation, verbose, to_file, full)
110
121
 
170
181
    return
171
182
 
172
183
 
173
 
def _annotations(repo, file_id, rev_id):
174
 
    """Return the list of (origin_revision_id, line_text) for a revision of a file in a repository."""
175
 
    annotations = repo.texts.annotate((file_id, rev_id))
176
 
    #
177
 
    return [(key[-1], line) for (key, line) in annotations]
178
 
 
179
 
 
180
184
def _expand_annotations(annotations, branch, current_rev=None):
181
185
    """Expand a file's annotations into command line UI ready tuples.
182
186
 
189
193
    """
190
194
    repository = branch.repository
191
195
    if current_rev is not None:
192
 
        # This can probably become a function on MutableTree, get_revno_map there,
193
 
        # or something.
 
196
        # This can probably become a function on MutableTree, get_revno_map
 
197
        # there, or something.
194
198
        last_revision = current_rev.revision_id
195
199
        # XXX: Partially Cloned from branch, uses the old_get_graph, eep.
196
200
        # XXX: The main difficulty is that we need to inject a single new node