1
# Copyright (C) 2005-2011 Canonical Ltd
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.
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.
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
# "weren't nothing promised to you. do i look like i got a promise face?"
19
"""Tests for trace library"""
21
from cStringIO import StringIO
33
from bzrlib.tests import features, TestCaseInTempDir, TestCase
34
from bzrlib.trace import (
35
mutter, mutter_callsite, report_exception,
36
set_verbosity_level, get_verbosity_level, is_quiet, is_verbose, be_quiet,
39
_rollover_trace_maybe,
44
def _format_exception():
45
"""Format an exception as it would normally be displayed to the user"""
47
report_exception(sys.exc_info(), buf)
51
class TestTrace(TestCase):
53
def test_format_sys_exception(self):
54
# Test handling of an internal/unexpected error that probably
55
# indicates a bug in bzr. The details of the message may vary
56
# depending on whether apport is available or not. See test_crash for
59
raise NotImplementedError, "time travel"
60
except NotImplementedError:
62
err = _format_exception()
63
self.assertEqualDiff(err.splitlines()[0],
64
'bzr: ERROR: exceptions.NotImplementedError: time travel')
65
self.assertContainsRe(err,
66
'Bazaar has encountered an internal error.')
68
def test_format_interrupt_exception(self):
70
raise KeyboardInterrupt()
71
except KeyboardInterrupt:
72
# XXX: Some risk that a *real* keyboard interrupt won't be seen
74
msg = _format_exception()
75
self.assertTrue(len(msg) > 0)
76
self.assertEqualDiff(msg, 'bzr: interrupted\n')
78
def test_format_memory_error(self):
83
msg = _format_exception()
84
self.assertEquals(msg,
85
"bzr: out of memory\nUse -Dmem_dump to dump memory to a file.\n")
87
def test_format_mem_dump(self):
88
self.requireFeature(features.meliae)
89
debug.debug_flags.add('mem_dump')
94
msg = _format_exception()
95
self.assertStartsWith(msg,
96
"bzr: out of memory\nMemory dumped to ")
98
def test_format_os_error(self):
100
os.rmdir('nosuchfile22222')
103
msg = _format_exception()
104
# Linux seems to give "No such file" but Windows gives "The system
105
# cannot find the file specified".
106
self.assertEqual('bzr: ERROR: %s\n' % (e_str,), msg)
108
def test_format_io_error(self):
110
file('nosuchfile22222')
113
msg = _format_exception()
114
# Even though Windows and Linux differ for 'os.rmdir', they both give
115
# 'No such file' for open()
116
self.assertContainsRe(msg,
117
r'^bzr: ERROR: \[Errno .*\] No such file.*nosuchfile')
119
def test_format_pywintypes_error(self):
120
self.requireFeature(features.pywintypes)
121
import pywintypes, win32file
123
win32file.RemoveDirectory('nosuchfile22222')
124
except pywintypes.error:
126
msg = _format_exception()
127
# GZ 2010-05-03: Formatting for pywintypes.error is basic, a 3-tuple
128
# with errno, function name, and locale error message
129
self.assertContainsRe(msg,
130
r"^bzr: ERROR: \(2, 'RemoveDirectory[AW]?', .*\)")
132
def test_format_unicode_error(self):
134
raise errors.BzrCommandError(u'argument foo\xb5 does not exist')
135
except errors.BzrCommandError:
137
msg = _format_exception()
139
def test_format_exception(self):
140
"""Short formatting of bzr exceptions"""
142
raise errors.NotBranchError('wibble')
143
except errors.NotBranchError:
145
msg = _format_exception()
146
self.assertTrue(len(msg) > 0)
147
self.assertEqualDiff(msg, 'bzr: ERROR: Not a branch: \"wibble\".\n')
149
def test_report_external_import_error(self):
150
"""Short friendly message for missing system modules."""
152
import ImaginaryModule
153
except ImportError, e:
156
self.fail("somehow succeeded in importing %r" % ImaginaryModule)
157
msg = _format_exception()
158
self.assertEqual(msg,
159
'bzr: ERROR: No module named ImaginaryModule\n'
160
'You may need to install this Python library separately.\n')
162
def test_report_import_syntax_error(self):
164
raise ImportError("syntax error")
165
except ImportError, e:
167
msg = _format_exception()
168
self.assertContainsRe(msg,
169
r'Bazaar has encountered an internal error')
171
def test_trace_unicode(self):
172
"""Write Unicode to trace log"""
173
self.log(u'the unicode character for benzene is \N{BENZENE RING}')
175
self.assertContainsRe(log, "the unicode character for benzene is")
177
def test_trace_argument_unicode(self):
178
"""Write a Unicode argument to the trace log"""
179
mutter(u'the unicode character for benzene is %s', u'\N{BENZENE RING}')
181
self.assertContainsRe(log, 'the unicode character')
183
def test_trace_argument_utf8(self):
184
"""Write a Unicode argument to the trace log"""
185
mutter(u'the unicode character for benzene is %s',
186
u'\N{BENZENE RING}'.encode('utf-8'))
188
self.assertContainsRe(log, 'the unicode character')
190
def test_report_broken_pipe(self):
192
raise IOError(errno.EPIPE, 'broken pipe foofofo')
194
msg = _format_exception()
195
self.assertEquals(msg, "bzr: broken pipe\n")
197
self.fail("expected error not raised")
199
def assertLogStartsWith(self, log, string):
200
"""Like assertStartsWith, but skips the log timestamp."""
201
self.assertContainsRe(log,
202
'^\\d+\\.\\d+ ' + re.escape(string))
204
def test_mutter_callsite_1(self):
205
"""mutter_callsite can capture 1 level of stack frame."""
206
mutter_callsite(1, "foo %s", "a string")
208
# begin with the message
209
self.assertLogStartsWith(log, 'foo a string\nCalled from:\n')
210
# should show two frame: this frame and the one above
211
self.assertContainsRe(log,
212
'test_trace\\.py", line \\d+, in test_mutter_callsite_1\n')
213
# this frame should be the final one
214
self.assertEndsWith(log, ' "a string")\n')
216
def test_mutter_callsite_2(self):
217
"""mutter_callsite can capture 2 levels of stack frame."""
218
mutter_callsite(2, "foo %s", "a string")
220
# begin with the message
221
self.assertLogStartsWith(log, 'foo a string\nCalled from:\n')
222
# should show two frame: this frame and the one above
223
self.assertContainsRe(log,
224
'test_trace.py", line \d+, in test_mutter_callsite_2\n')
225
# this frame should be the final one
226
self.assertEndsWith(log, ' "a string")\n')
228
def test_mutter_never_fails(self):
229
# Even if the decode/encode stage fails, mutter should not
231
# This test checks that mutter doesn't fail; the current behaviour
232
# is that it doesn't fail *and writes non-utf8*.
233
mutter(u'Writing a greek mu (\xb5) works in a unicode string')
234
mutter('But fails in an ascii string \xb5')
235
mutter('and in an ascii argument: %s', '\xb5')
237
self.assertContainsRe(log, 'Writing a greek mu')
238
self.assertContainsRe(log, "But fails in an ascii string")
239
# However, the log content object does unicode replacement on reading
240
# to let it get unicode back where good data has been written. So we
241
# have to do a replaceent here as well.
242
self.assertContainsRe(log, "ascii argument: \xb5".decode('utf8',
245
def test_show_error(self):
247
show_error(u'error2 \xb5 blah')
248
show_error('arg: %s', 'blah')
249
show_error('arg2: %(key)s', {'key':'stuff'})
251
raise Exception("oops")
253
show_error('kwarg', exc_info=True)
255
self.assertContainsRe(log, 'error1')
256
self.assertContainsRe(log, u'error2 \xb5 blah')
257
self.assertContainsRe(log, 'arg: blah')
258
self.assertContainsRe(log, 'arg2: stuff')
259
self.assertContainsRe(log, 'kwarg')
260
self.assertContainsRe(log, 'Traceback \\(most recent call last\\):')
261
self.assertContainsRe(log, 'File ".*test_trace.py", line .*, in test_show_error')
262
self.assertContainsRe(log, 'raise Exception\\("oops"\\)')
263
self.assertContainsRe(log, 'Exception: oops')
265
def test_push_log_file(self):
266
"""Can push and pop log file, and this catches mutter messages.
268
This is primarily for use in the test framework.
270
tmp1 = tempfile.NamedTemporaryFile()
271
tmp2 = tempfile.NamedTemporaryFile()
273
memento1 = push_log_file(tmp1)
274
mutter("comment to file1")
276
memento2 = push_log_file(tmp2)
278
mutter("comment to file2")
280
pop_log_file(memento2)
281
mutter("again to file1")
283
pop_log_file(memento1)
284
# the files were opened in binary mode, so should have exactly
285
# these bytes. and removing the file as the log target should
286
# have caused them to be flushed out. need to match using regexps
287
# as there's a timestamp at the front.
289
self.assertContainsRe(tmp1.read(),
290
r"\d+\.\d+ comment to file1\n\d+\.\d+ again to file1\n")
292
self.assertContainsRe(tmp2.read(),
293
r"\d+\.\d+ comment to file2\n")
298
def test__open_bzr_log_uses_stderr_for_failures(self):
299
# If _open_bzr_log cannot open the file, then we should write the
300
# warning to stderr. Since this is normally happening before logging is
302
self.overrideAttr(sys, 'stderr', StringIO())
303
# Set the log file to something that cannot exist
304
self.overrideEnv('BZR_LOG', os.getcwd() + '/no-dir/bzr.log')
305
self.overrideAttr(trace, '_bzr_log_filename')
306
logf = trace._open_bzr_log()
307
self.assertIs(None, logf)
308
self.assertContainsRe(sys.stderr.getvalue(),
309
'failed to open trace file: .*/no-dir/bzr.log')
312
class TestVerbosityLevel(TestCase):
314
def test_verbosity_level(self):
315
set_verbosity_level(1)
316
self.assertEqual(1, get_verbosity_level())
317
self.assertTrue(is_verbose())
318
self.assertFalse(is_quiet())
319
set_verbosity_level(-1)
320
self.assertEqual(-1, get_verbosity_level())
321
self.assertFalse(is_verbose())
322
self.assertTrue(is_quiet())
323
set_verbosity_level(0)
324
self.assertEqual(0, get_verbosity_level())
325
self.assertFalse(is_verbose())
326
self.assertFalse(is_quiet())
328
def test_be_quiet(self):
329
# Confirm the old API still works
331
self.assertEqual(-1, get_verbosity_level())
333
self.assertEqual(0, get_verbosity_level())
336
class TestBzrLog(TestCaseInTempDir):
338
def test_log_rollover(self):
339
temp_log_name = 'test-log'
340
trace_file = open(temp_log_name, 'at')
341
trace_file.writelines(['test_log_rollover padding\n'] * 200000)
343
_rollover_trace_maybe(temp_log_name)
344
# should have been rolled over
345
self.assertFalse(os.access(temp_log_name, os.R_OK))
348
class TestTraceConfiguration(TestCaseInTempDir):
350
def test_default_config(self):
351
config = trace.DefaultConfig()
352
self.overrideAttr(trace, "_bzr_log_filename", None)
353
trace._bzr_log_filename = None
354
expected_filename = trace._get_bzr_log_filename()
355
self.assertEqual(None, trace._bzr_log_filename)
358
# Should have entered and setup a default filename.
359
self.assertEqual(expected_filename, trace._bzr_log_filename)
361
config.__exit__(None, None, None)
362
# Should have exited and cleaned up.
363
self.assertEqual(None, trace._bzr_log_filename)
added
removed
bzrlib/tests/test_trace.py
