~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/test_log.py

  • Committer: Martin Pool
  • Date: 2005-05-03 08:00:27 UTC
  • Revision ID: mbp@sourcefrog.net-20050503080027-908edb5b39982198
doc

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005 by Canonical Ltd
2
 
 
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.
7
 
 
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.
12
 
 
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
16
 
 
17
 
import os
18
 
from cStringIO import StringIO
19
 
 
20
 
from bzrlib.tests import BzrTestBase, TestCaseWithTransport
21
 
from bzrlib.log import (LogFormatter, show_log, LongLogFormatter,
22
 
                        ShortLogFormatter, LineLogFormatter)
23
 
from bzrlib.branch import Branch
24
 
from bzrlib.errors import InvalidRevisionNumber
25
 
 
26
 
class _LogEntry(object):
27
 
    # should probably move into bzrlib.log?
28
 
    pass
29
 
 
30
 
 
31
 
class LogCatcher(LogFormatter):
32
 
    """Pull log messages into list rather than displaying them.
33
 
 
34
 
    For ease of testing we save log messages here rather than actually
35
 
    formatting them, so that we can precisely check the result without
36
 
    being too dependent on the exact formatting.
37
 
 
38
 
    We should also test the LogFormatter.
39
 
    """
40
 
    def __init__(self):
41
 
        super(LogCatcher, self).__init__(to_file=None)
42
 
        self.logs = []
43
 
 
44
 
    def show(self, revno, rev, delta):
45
 
        le = _LogEntry()
46
 
        le.revno = revno
47
 
        le.rev = rev
48
 
        le.delta = delta
49
 
        self.logs.append(le)
50
 
 
51
 
 
52
 
class SimpleLogTest(TestCaseWithTransport):
53
 
 
54
 
    def checkDelta(self, delta, **kw):
55
 
        """Check the filenames touched by a delta are as expected."""
56
 
        for n in 'added', 'removed', 'renamed', 'modified', 'unchanged':
57
 
            expected = kw.get(n, [])
58
 
 
59
 
            # tests are written with unix paths; fix them up for windows
60
 
            #if os.sep != '/':
61
 
            #    expected = [x.replace('/', os.sep) for x in expected]
62
 
 
63
 
            # strip out only the path components
64
 
            got = [x[0] for x in getattr(delta, n)]
65
 
            self.assertEquals(expected, got)
66
 
 
67
 
    def test_cur_revno(self):
68
 
        wt = self.make_branch_and_tree('.')
69
 
        b = wt.branch
70
 
 
71
 
        lf = LogCatcher()
72
 
        wt.commit('empty commit')
73
 
        show_log(b, lf, verbose=True, start_revision=1, end_revision=1)
74
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
75
 
                          start_revision=2, end_revision=1) 
76
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
77
 
                          start_revision=1, end_revision=2) 
78
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
79
 
                          start_revision=0, end_revision=2) 
80
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
81
 
                          start_revision=1, end_revision=0) 
82
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
83
 
                          start_revision=-1, end_revision=1) 
84
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
85
 
                          start_revision=1, end_revision=-1) 
86
 
 
87
 
    def test_cur_revno(self):
88
 
        wt = self.make_branch_and_tree('.')
89
 
        b = wt.branch
90
 
 
91
 
        lf = LogCatcher()
92
 
        wt.commit('empty commit')
93
 
        show_log(b, lf, verbose=True, start_revision=1, end_revision=1)
94
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
95
 
                          start_revision=2, end_revision=1) 
96
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
97
 
                          start_revision=1, end_revision=2) 
98
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
99
 
                          start_revision=0, end_revision=2) 
100
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
101
 
                          start_revision=1, end_revision=0) 
102
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
103
 
                          start_revision=-1, end_revision=1) 
104
 
        self.assertRaises(InvalidRevisionNumber, show_log, b, lf,
105
 
                          start_revision=1, end_revision=-1) 
106
 
 
107
 
    def test_simple_log(self):
108
 
        eq = self.assertEquals
109
 
        
110
 
        wt = self.make_branch_and_tree('.')
111
 
        b = wt.branch
112
 
 
113
 
        lf = LogCatcher()
114
 
        show_log(b, lf)
115
 
        # no entries yet
116
 
        eq(lf.logs, [])
117
 
 
118
 
        wt.commit('empty commit')
119
 
        lf = LogCatcher()
120
 
        show_log(b, lf, verbose=True)
121
 
        eq(len(lf.logs), 1)
122
 
        eq(lf.logs[0].revno, 1)
123
 
        eq(lf.logs[0].rev.message, 'empty commit')
124
 
        d = lf.logs[0].delta
125
 
        self.log('log delta: %r' % d)
126
 
        self.checkDelta(d)
127
 
 
128
 
        self.build_tree(['hello'])
129
 
        wt.add('hello')
130
 
        wt.commit('add one file')
131
 
 
132
 
        lf = StringIO()
133
 
        # log using regular thing
134
 
        show_log(b, LongLogFormatter(lf))
135
 
        lf.seek(0)
136
 
        for l in lf.readlines():
137
 
            self.log(l)
138
 
 
139
 
        # get log as data structure
140
 
        lf = LogCatcher()
141
 
        show_log(b, lf, verbose=True)
142
 
        eq(len(lf.logs), 2)
143
 
        self.log('log entries:')
144
 
        for logentry in lf.logs:
145
 
            self.log('%4d %s' % (logentry.revno, logentry.rev.message))
146
 
        
147
 
        # first one is most recent
148
 
        logentry = lf.logs[0]
149
 
        eq(logentry.revno, 2)
150
 
        eq(logentry.rev.message, 'add one file')
151
 
        d = logentry.delta
152
 
        self.log('log 2 delta: %r' % d)
153
 
        # self.checkDelta(d, added=['hello'])
154
 
        
155
 
        # commit a log message with control characters
156
 
        msg = "All 8-bit chars: " +  ''.join([unichr(x) for x in range(256)])
157
 
        self.log("original commit message: %r", msg)
158
 
        wt.commit(msg)
159
 
        lf = LogCatcher()
160
 
        show_log(b, lf, verbose=True)
161
 
        committed_msg = lf.logs[0].rev.message
162
 
        self.log("escaped commit message: %r", committed_msg)
163
 
        self.assert_(msg != committed_msg)
164
 
        self.assert_(len(committed_msg) > len(msg))
165
 
 
166
 
        # Check that log message with only XML-valid characters isn't
167
 
        # escaped.  As ElementTree apparently does some kind of
168
 
        # newline conversion, neither LF (\x0A) nor CR (\x0D) are
169
 
        # included in the test commit message, even though they are
170
 
        # valid XML 1.0 characters.
171
 
        msg = "\x09" + ''.join([unichr(x) for x in range(0x20, 256)])
172
 
        self.log("original commit message: %r", msg)
173
 
        wt.commit(msg)
174
 
        lf = LogCatcher()
175
 
        show_log(b, lf, verbose=True)
176
 
        committed_msg = lf.logs[0].rev.message
177
 
        self.log("escaped commit message: %r", committed_msg)
178
 
        self.assert_(msg == committed_msg)
179
 
 
180
 
    def test_trailing_newlines(self):
181
 
        wt = self.make_branch_and_tree('.')
182
 
        b = wt.branch
183
 
        b.nick='test'
184
 
        open('a', 'wb').write('hello moto\n')
185
 
        wt.add('a')
186
 
        wt.commit('simple log message', rev_id='a1'
187
 
                , timestamp=1132586655.459960938, timezone=-6*3600
188
 
                , committer='Joe Foo <joe@foo.com>')
189
 
        open('b', 'wb').write('goodbye\n')
190
 
        wt.add('b')
191
 
        wt.commit('multiline\nlog\nmessage\n', rev_id='a2'
192
 
                , timestamp=1132586842.411175966, timezone=-6*3600
193
 
                , committer='Joe Foo <joe@foo.com>')
194
 
 
195
 
        open('c', 'wb').write('just another manic monday\n')
196
 
        wt.add('c')
197
 
        wt.commit('single line with trailing newline\n', rev_id='a3'
198
 
                , timestamp=1132587176.835228920, timezone=-6*3600
199
 
                , committer = 'Joe Foo <joe@foo.com>')
200
 
 
201
 
        sio = StringIO()
202
 
        lf = ShortLogFormatter(to_file=sio)
203
 
        show_log(b, lf)
204
 
        self.assertEquals(sio.getvalue(), """\
205
 
    3 Joe Foo\t2005-11-21
206
 
      single line with trailing newline
207
 
 
208
 
    2 Joe Foo\t2005-11-21
209
 
      multiline
210
 
      log
211
 
      message
212
 
 
213
 
    1 Joe Foo\t2005-11-21
214
 
      simple log message
215
 
 
216
 
""")
217
 
 
218
 
        sio = StringIO()
219
 
        lf = LongLogFormatter(to_file=sio)
220
 
        show_log(b, lf)
221
 
        self.assertEquals(sio.getvalue(), """\
222
 
------------------------------------------------------------
223
 
revno: 3
224
 
committer: Joe Foo <joe@foo.com>
225
 
branch nick: test
226
 
timestamp: Mon 2005-11-21 09:32:56 -0600
227
 
message:
228
 
  single line with trailing newline
229
 
------------------------------------------------------------
230
 
revno: 2
231
 
committer: Joe Foo <joe@foo.com>
232
 
branch nick: test
233
 
timestamp: Mon 2005-11-21 09:27:22 -0600
234
 
message:
235
 
  multiline
236
 
  log
237
 
  message
238
 
------------------------------------------------------------
239
 
revno: 1
240
 
committer: Joe Foo <joe@foo.com>
241
 
branch nick: test
242
 
timestamp: Mon 2005-11-21 09:24:15 -0600
243
 
message:
244
 
  simple log message
245
 
""")
246
 
        
247
 
    def test_verbose_log(self):
248
 
        """Verbose log includes changed files
249
 
        
250
 
        bug #4676
251
 
        """
252
 
        wt = self.make_branch_and_tree('.')
253
 
        b = wt.branch
254
 
        self.build_tree(['a'])
255
 
        wt.add('a')
256
 
        # XXX: why does a longer nick show up?
257
 
        b.nick = 'test_verbose_log'
258
 
        wt.commit(message='add a', 
259
 
                  timestamp=1132711707, 
260
 
                  timezone=36000,
261
 
                  committer='Lorem Ipsum <test@example.com>')
262
 
        logfile = file('out.tmp', 'w+')
263
 
        formatter = LongLogFormatter(to_file=logfile)
264
 
        show_log(b, formatter, verbose=True)
265
 
        logfile.flush()
266
 
        logfile.seek(0)
267
 
        log_contents = logfile.read()
268
 
        self.assertEqualDiff(log_contents, '''\
269
 
------------------------------------------------------------
270
 
revno: 1
271
 
committer: Lorem Ipsum <test@example.com>
272
 
branch nick: test_verbose_log
273
 
timestamp: Wed 2005-11-23 12:08:27 +1000
274
 
message:
275
 
  add a
276
 
added:
277
 
  a
278
 
''')
279
 
 
280
 
    def test_line_log(self):
281
 
        """Line log should show revno
282
 
        
283
 
        bug #5162
284
 
        """
285
 
        wt = self.make_branch_and_tree('.')
286
 
        b = wt.branch
287
 
        self.build_tree(['a'])
288
 
        wt.add('a')
289
 
        b.nick = 'test-line-log'
290
 
        wt.commit(message='add a', 
291
 
                  timestamp=1132711707, 
292
 
                  timezone=36000,
293
 
                  committer='Line-Log-Formatter Tester <test@line.log>')
294
 
        logfile = file('out.tmp', 'w+')
295
 
        formatter = LineLogFormatter(to_file=logfile)
296
 
        show_log(b, formatter)
297
 
        logfile.flush()
298
 
        logfile.seek(0)
299
 
        log_contents = logfile.read()
300
 
        self.assertEqualDiff(log_contents, '1: Line-Log-Formatte... 2005-11-23 add a\n')