~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/test_trace.py

  • Committer: Andrew Bennetts
  • Date: 2008-02-07 07:05:13 UTC
  • mto: This revision was merged to the branch mainline in revision 3398.
  • Revision ID: andrew.bennetts@canonical.com-20080207070513-u7tvul100g1yn6n7
Add a comment to the new CSS.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2005, 2006, 2007 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
# "weren't nothing promised to you.  do i look like i got a promise face?"
 
18
 
 
19
"""Tests for trace library"""
 
20
 
 
21
from cStringIO import StringIO
 
22
import errno
 
23
import os
 
24
import re
 
25
import sys
 
26
 
 
27
from bzrlib import (
 
28
    errors,
 
29
    )
 
30
from bzrlib.tests import TestCaseInTempDir, TestCase
 
31
from bzrlib.trace import (
 
32
    mutter, mutter_callsite, report_exception,
 
33
    set_verbosity_level, get_verbosity_level, is_quiet, is_verbose, be_quiet,
 
34
    _rollover_trace_maybe,
 
35
    )
 
36
 
 
37
 
 
38
def _format_exception():
 
39
    """Format an exception as it would normally be displayed to the user"""
 
40
    buf = StringIO()
 
41
    report_exception(sys.exc_info(), buf)
 
42
    return buf.getvalue()
 
43
 
 
44
 
 
45
class TestTrace(TestCase):
 
46
 
 
47
    def test_format_sys_exception(self):
 
48
        try:
 
49
            raise NotImplementedError, "time travel"
 
50
        except NotImplementedError:
 
51
            pass
 
52
        err = _format_exception()
 
53
        self.assertEqualDiff(err.splitlines()[0],
 
54
                'bzr: ERROR: exceptions.NotImplementedError: time travel')
 
55
        self.assertContainsRe(err,
 
56
                r'File.*test_trace.py')
 
57
 
 
58
    def test_format_interrupt_exception(self):
 
59
        try:
 
60
            raise KeyboardInterrupt()
 
61
        except KeyboardInterrupt:
 
62
            # XXX: Some risk that a *real* keyboard interrupt won't be seen
 
63
            pass
 
64
        msg = _format_exception()
 
65
        self.assertTrue(len(msg) > 0)
 
66
        self.assertEqualDiff(msg, 'bzr: interrupted\n')
 
67
 
 
68
    def test_format_os_error(self):
 
69
        try:
 
70
            file('nosuchfile22222')
 
71
        except (OSError, IOError):
 
72
            pass
 
73
        msg = _format_exception()
 
74
        self.assertContainsRe(msg, r'^bzr: ERROR: \[Errno .*\] No such file.*nosuchfile')
 
75
 
 
76
    def test_format_unicode_error(self):
 
77
        try:
 
78
            raise errors.BzrCommandError(u'argument foo\xb5 does not exist')
 
79
        except errors.BzrCommandError:
 
80
            pass
 
81
        msg = _format_exception()
 
82
 
 
83
    def test_format_exception(self):
 
84
        """Short formatting of bzr exceptions"""
 
85
        try:
 
86
            raise errors.NotBranchError('wibble')
 
87
        except errors.NotBranchError:
 
88
            pass
 
89
        msg = _format_exception()
 
90
        self.assertTrue(len(msg) > 0)
 
91
        self.assertEqualDiff(msg, 'bzr: ERROR: Not a branch: \"wibble\".\n')
 
92
 
 
93
    def test_trace_unicode(self):
 
94
        """Write Unicode to trace log"""
 
95
        self.log(u'the unicode character for benzene is \N{BENZENE RING}')
 
96
        self.assertContainsRe(self._get_log(keep_log_file=True),
 
97
                              "the unicode character for benzene is")
 
98
    
 
99
    def test_trace_argument_unicode(self):
 
100
        """Write a Unicode argument to the trace log"""
 
101
        mutter(u'the unicode character for benzene is %s', u'\N{BENZENE RING}')
 
102
        self.assertContainsRe(self._get_log(keep_log_file=True),
 
103
                              'the unicode character')
 
104
 
 
105
    def test_trace_argument_utf8(self):
 
106
        """Write a Unicode argument to the trace log"""
 
107
        mutter(u'the unicode character for benzene is %s',
 
108
               u'\N{BENZENE RING}'.encode('utf-8'))
 
109
        self.assertContainsRe(self._get_log(keep_log_file=True),
 
110
                              'the unicode character')
 
111
 
 
112
    def test_report_broken_pipe(self):
 
113
        try:
 
114
            raise IOError(errno.EPIPE, 'broken pipe foofofo')
 
115
        except IOError, e:
 
116
            msg = _format_exception()
 
117
            self.assertEquals(msg, "bzr: broken pipe\n")
 
118
        else:
 
119
            self.fail("expected error not raised")
 
120
 
 
121
    def assertLogStartsWith(self, log, string):
 
122
        """Like assertStartsWith, but skips the log timestamp."""
 
123
        self.assertContainsRe(log,
 
124
            '^\\d+\\.\\d+  ' + re.escape(string))
 
125
 
 
126
    def test_mutter_callsite_1(self):
 
127
        """mutter_callsite can capture 1 level of stack frame."""
 
128
        mutter_callsite(1, "foo %s", "a string")
 
129
        log = self._get_log(keep_log_file=True)
 
130
        # begin with the message
 
131
        self.assertLogStartsWith(log, 'foo a string\nCalled from:\n')
 
132
        # should show two frame: this frame and the one above
 
133
        self.assertContainsRe(log,
 
134
            'test_trace\\.py", line \\d+, in test_mutter_callsite_1\n')
 
135
        # this frame should be the final one
 
136
        self.assertEndsWith(log, ' "a string")\n')
 
137
 
 
138
    def test_mutter_callsite_2(self):
 
139
        """mutter_callsite can capture 2 levels of stack frame."""
 
140
        mutter_callsite(2, "foo %s", "a string")
 
141
        log = self._get_log(keep_log_file=True)
 
142
        # begin with the message
 
143
        self.assertLogStartsWith(log, 'foo a string\nCalled from:\n')
 
144
        # should show two frame: this frame and the one above
 
145
        self.assertContainsRe(log,
 
146
            'test_trace.py", line \d+, in test_mutter_callsite_2\n')
 
147
        # this frame should be the final one
 
148
        self.assertEndsWith(log, ' "a string")\n')
 
149
 
 
150
    def test_mutter_never_fails(self):
 
151
        # Even if the decode/encode stage fails, mutter should not
 
152
        # raise an exception
 
153
        mutter(u'Writing a greek mu (\xb5) works in a unicode string')
 
154
        mutter('But fails in an ascii string \xb5')
 
155
        mutter('and in an ascii argument: %s', '\xb5')
 
156
        log = self._get_log(keep_log_file=True)
 
157
        self.assertContainsRe(log, 'Writing a greek mu')
 
158
        self.assertContainsRe(log, "But fails in an ascii string")
 
159
        self.assertContainsRe(log, u"ascii argument: \xb5")
 
160
 
 
161
 
 
162
class TestVerbosityLevel(TestCase):
 
163
 
 
164
    def test_verbosity_level(self):
 
165
        set_verbosity_level(1)
 
166
        self.assertEqual(1, get_verbosity_level())
 
167
        self.assertTrue(is_verbose())
 
168
        self.assertFalse(is_quiet())
 
169
        set_verbosity_level(-1)
 
170
        self.assertEqual(-1, get_verbosity_level())
 
171
        self.assertFalse(is_verbose())
 
172
        self.assertTrue(is_quiet())
 
173
        set_verbosity_level(0)
 
174
        self.assertEqual(0, get_verbosity_level())
 
175
        self.assertFalse(is_verbose())
 
176
        self.assertFalse(is_quiet())
 
177
 
 
178
    def test_be_quiet(self):
 
179
        # Confirm the old API still works
 
180
        be_quiet(True)
 
181
        self.assertEqual(-1, get_verbosity_level())
 
182
        be_quiet(False)
 
183
        self.assertEqual(0, get_verbosity_level())
 
184
 
 
185
 
 
186
class TestBzrLog(TestCaseInTempDir):
 
187
 
 
188
    def test_log_rollover(self):
 
189
        temp_log_name = 'test-log'
 
190
        trace_file = open(temp_log_name, 'at')
 
191
        trace_file.write('test_log_rollover padding\n' * 1000000)
 
192
        trace_file.close()
 
193
        _rollover_trace_maybe(temp_log_name)
 
194
        # should have been rolled over
 
195
        self.assertFalse(os.access(temp_log_name, os.R_OK))