← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/log.py

  • Committer: Martin Pool
  • Date: 2005-05-25 03:27:02 UTC
  • Revision ID: mbp@sourcefrog.net-20050525032702-395f038adb33c235
- clean up statcache code
- stat files in order by inum
- report on added/deleted files

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/log.py
16
16
 
17
17
 
18
18
 
 
19
"""Code to show logs of changes.
 
20
 
 
21
Various flavors of log can be produced:
 
22
 
 
23
* for one file, or the whole tree, and (not done yet) for
 
24
  files in a given directory
 
25
 
 
26
* in "verbose" mode with a description of what changed from one
 
27
  version to the next
 
28
 
 
29
* with file-ids and revision-ids shown
 
30
 
 
31
* from last to first or (not anymore) from first to last;
 
32
  the default is "reversed" because it shows the likely most
 
33
  relevant and interesting information first
 
34
 
 
35
* (not yet) in XML format
 
36
"""
 
37
 
 
38
 
 
39
from trace import mutter
19
40
 
20
41
def find_touching_revisions(branch, file_id):
21
42
    """Yield a description of revisions which affect the file_id.
25
46
    This is the list of revisions where the file is either added,
26
47
    modified, renamed or deleted.
27
48
 
28
 
    Revisions are returned in chronological order.
29
 
 
30
49
    TODO: Perhaps some way to limit this to only particular revisions,
31
 
    or to traverse a non-branch set of revisions?
32
 
 
33
 
    TODO: If a directory is given, then by default look for all
34
 
    changes under that directory.
 
50
    or to traverse a non-mainline set of revisions?
35
51
    """
36
52
    last_ie = None
37
53
    last_path = None
66
82
        revno += 1
67
83
 
68
84
 
 
85
 
69
86
def show_log(branch,
70
 
             filename=None,
 
87
             specific_fileid=None,
71
88
             show_timezone='original',
72
89
             verbose=False,
73
90
             show_ids=False,
74
 
             to_file=None):
 
91
             to_file=None,
 
92
             direction='reverse'):
75
93
    """Write out human-readable log of commits to this branch.
76
94
 
77
 
    filename
 
95
    specific_fileid
78
96
        If true, list only the commits affecting the specified
79
97
        file, rather than all commits.
80
98
 
91
109
 
92
110
    to_file
93
111
        File to send log to; by default stdout.
 
112
 
 
113
    direction
 
114
        'reverse' (default) is latest to earliest;
 
115
        'forward' is earliest to latest.
94
116
    """
95
117
    from osutils import format_date
96
118
    from errors import BzrCheckError
97
 
    from diff import compare_trees
98
119
    from textui import show_status
99
120
 
 
121
 
 
122
    if specific_fileid:
 
123
        mutter('get log for file_id %r' % specific_fileid)
 
124
 
100
125
    if to_file == None:
101
126
        import sys
102
127
        to_file = sys.stdout
103
128
 
104
 
    if filename:
105
 
        file_id = branch.read_working_inventory().path2id(filename)
106
 
        def which_revs():
107
 
            for revno, revid, why in find_touching_revisions(branch, file_id):
108
 
                yield revno, revid
109
 
    else:
110
 
        def which_revs():
111
 
            for i, revid in enumerate(branch.revision_history()):
112
 
                yield i+1, revid
113
 
        
114
 
    branch._need_readlock()
 
129
    which_revs = branch.enum_history(direction)
 
130
 
 
131
    if not (verbose or specific_fileid):
 
132
        # no need to know what changed between revisions
 
133
        with_deltas = deltas_for_log_dummy(branch, which_revs)
 
134
    elif direction == 'reverse':
 
135
        with_deltas = deltas_for_log_reverse(branch, which_revs)
 
136
    else:        
 
137
        raise NotImplementedError("sorry, verbose forward logs not done yet")
 
138
 
 
139
    for revno, rev, delta in with_deltas:
 
140
        if specific_fileid:
 
141
            if not delta.touches_file_id(specific_fileid):
 
142
                continue
 
143
        
 
144
        if not verbose:
 
145
            # although we calculated it, throw it away without display
 
146
            delta = None
 
147
            
 
148
        show_one_log(revno, rev, delta, show_ids, to_file, show_timezone)
 
149
 
 
150
 
 
151
 
 
152
def deltas_for_log_dummy(branch, which_revs):
 
153
    for revno, revision_id in which_revs:
 
154
        yield revno, branch.get_revision(revision_id), None
 
155
 
 
156
 
 
157
def deltas_for_log_reverse(branch, which_revs):
 
158
    """Compute deltas for display in reverse log.
 
159
 
 
160
    Given a sequence of (revno, revision_id) pairs, return
 
161
    (revno, rev, delta).
 
162
 
 
163
    The delta is from the given revision to the next one in the
 
164
    sequence, which makes sense if the log is being displayed from
 
165
    newest to oldest.
 
166
    """
 
167
    from tree import EmptyTree
 
168
    from diff import compare_trees
 
169
    
 
170
    last_revno = last_revision_id = last_tree = None
 
171
    for revno, revision_id in which_revs:
 
172
        this_tree = branch.revision_tree(revision_id)
 
173
        this_revision = branch.get_revision(revision_id)
 
174
        
 
175
        if last_revno:
 
176
            yield last_revno, last_revision, compare_trees(this_tree, last_tree, False)
 
177
 
 
178
        last_revno = revno
 
179
        last_revision = this_revision
 
180
        last_tree = this_tree
 
181
 
 
182
    if last_revno:
 
183
        this_tree = EmptyTree()
 
184
        yield last_revno, last_revision, compare_trees(this_tree, last_tree, False)
 
185
 
 
186
 
 
187
 
 
188
def junk():
115
189
    precursor = None
116
190
    if verbose:
117
191
        from tree import EmptyTree
118
192
        prev_tree = EmptyTree()
119
 
    for revno, revision_id in which_revs():
120
 
        print >>to_file,  '-' * 60
121
 
        print >>to_file,  'revno:', revno
122
 
        rev = branch.get_revision(revision_id)
123
 
        if show_ids:
124
 
            print >>to_file,  'revision-id:', revision_id
125
 
        print >>to_file,  'committer:', rev.committer
126
 
        print >>to_file,  'timestamp: %s' % (format_date(rev.timestamp, rev.timezone or 0,
127
 
                                             show_timezone))
128
 
 
129
 
        if revision_id != rev.revision_id:
130
 
            raise BzrCheckError("retrieved wrong revision: %r"
131
 
                                % (revision_id, rev.revision_id))
132
 
 
133
 
        print >>to_file,  'message:'
134
 
        if not rev.message:
135
 
            print >>to_file,  '  (no message)'
136
 
        else:
137
 
            for l in rev.message.split('\n'):
138
 
                print >>to_file,  '  ' + l
139
 
 
140
 
        # Don't show a list of changed files if we were asked about
141
 
        # one specific file.
142
 
 
143
 
        if verbose:
144
 
            this_tree = branch.revision_tree(revision_id)
145
 
            delta = compare_trees(prev_tree, this_tree, want_unchanged=False)
146
 
            delta.show(to_file, show_ids)
147
 
            prev_tree = this_tree
148
 
 
 
193
    for revno, revision_id in which_revs:
149
194
        precursor = revision_id
150
195
 
 
196
    if revision_id != rev.revision_id:
 
197
        raise BzrCheckError("retrieved wrong revision: %r"
 
198
                            % (revision_id, rev.revision_id))
 
199
 
 
200
    if verbose:
 
201
        this_tree = branch.revision_tree(revision_id)
 
202
        delta = compare_trees(prev_tree, this_tree, want_unchanged=False)
 
203
        prev_tree = this_tree
 
204
    else:
 
205
        delta = None    
 
206
 
 
207
 
 
208
 
 
209
def show_one_log(revno, rev, delta, show_ids, to_file, show_timezone):
 
210
    from osutils import format_date
 
211
    
 
212
    print >>to_file,  '-' * 60
 
213
    print >>to_file,  'revno:', revno
 
214
    if show_ids:
 
215
        print >>to_file,  'revision-id:', rev.revision_id
 
216
    print >>to_file,  'committer:', rev.committer
 
217
    print >>to_file,  'timestamp: %s' % (format_date(rev.timestamp, rev.timezone or 0,
 
218
                                         show_timezone))
 
219
 
 
220
    print >>to_file,  'message:'
 
221
    if not rev.message:
 
222
        print >>to_file,  '  (no message)'
 
223
    else:
 
224
        for l in rev.message.split('\n'):
 
225
            print >>to_file,  '  ' + l
 
226
 
 
227
    if delta != None:
 
228
        delta.show(to_file, show_ids)