~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/__init__.py

  • Committer: John Arbash Meinel
  • Date: 2009-07-06 18:59:24 UTC
  • mto: This revision was merged to the branch mainline in revision 4522.
  • Revision ID: john@arbash-meinel.com-20090706185924-qlhn1j607117lgdj
Start implementing an Annotator.add_special_text functionality.

The Python implementation supports it. Basically, it is meant to allow things
like WT and PreviewTree to insert the 'current' content into the graph, so that
we can get local modifications into the annotations.
There is also some work here to get support for texts that are already cached
in the annotator. So that we avoid extracting them, and can shortcut the
history.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006 by Canonical Ltd
 
1
# Copyright (C) 2005, 2006, 2007, 2008, 2009 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
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
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
 
18
18
# TODO: Perhaps there should be an API to find out if bzr running under the
26
26
# general style of bzrlib.  Please continue that consistency when adding e.g.
27
27
# new assertFoo() methods.
28
28
 
 
29
import atexit
29
30
import codecs
30
31
from cStringIO import StringIO
31
32
import difflib
32
33
import doctest
33
34
import errno
34
35
import logging
 
36
import math
35
37
import os
 
38
from pprint import pformat
 
39
import random
36
40
import re
37
41
import shlex
38
42
import stat
39
 
from subprocess import Popen, PIPE
 
43
from subprocess import Popen, PIPE, STDOUT
40
44
import sys
41
45
import tempfile
 
46
import threading
 
47
import time
42
48
import unittest
43
 
import time
44
 
 
45
 
 
 
49
import warnings
 
50
 
 
51
 
 
52
from bzrlib import (
 
53
    branchbuilder,
 
54
    bzrdir,
 
55
    debug,
 
56
    errors,
 
57
    hooks,
 
58
    lock as _mod_lock,
 
59
    memorytree,
 
60
    osutils,
 
61
    progress,
 
62
    ui,
 
63
    urlutils,
 
64
    registry,
 
65
    workingtree,
 
66
    )
46
67
import bzrlib.branch
47
 
import bzrlib.bzrdir as bzrdir
48
68
import bzrlib.commands
49
 
import bzrlib.bundle.serializer
50
 
import bzrlib.errors as errors
 
69
import bzrlib.timestamp
 
70
import bzrlib.export
51
71
import bzrlib.inventory
52
72
import bzrlib.iterablefile
53
73
import bzrlib.lockdir
58
78
    pass
59
79
from bzrlib.merge import merge_inner
60
80
import bzrlib.merge3
61
 
import bzrlib.osutils
62
 
import bzrlib.osutils as osutils
63
81
import bzrlib.plugin
64
 
import bzrlib.progress as progress
65
 
from bzrlib.revision import common_ancestor
 
82
from bzrlib.smart import client, request, server
66
83
import bzrlib.store
 
84
from bzrlib import symbol_versioning
 
85
from bzrlib.symbol_versioning import (
 
86
    DEPRECATED_PARAMETER,
 
87
    deprecated_function,
 
88
    deprecated_method,
 
89
    deprecated_passed,
 
90
    )
67
91
import bzrlib.trace
68
92
from bzrlib.transport import get_transport
69
93
import bzrlib.transport
70
 
from bzrlib.transport.local import LocalRelpathServer
 
94
from bzrlib.transport.local import LocalURLServer
 
95
from bzrlib.transport.memory import MemoryServer
71
96
from bzrlib.transport.readonly import ReadonlyServer
72
 
from bzrlib.trace import mutter
 
97
from bzrlib.trace import mutter, note
73
98
from bzrlib.tests import TestUtil
 
99
from bzrlib.tests.http_server import HttpServer
74
100
from bzrlib.tests.TestUtil import (
75
101
                          TestSuite,
76
102
                          TestLoader,
77
103
                          )
78
104
from bzrlib.tests.treeshape import build_tree_contents
79
 
import bzrlib.urlutils as urlutils
 
105
import bzrlib.version_info_formats.format_custom
80
106
from bzrlib.workingtree import WorkingTree, WorkingTreeFormat2
81
107
 
82
 
default_transport = LocalRelpathServer
83
 
 
84
 
MODULES_TO_TEST = []
85
 
MODULES_TO_DOCTEST = [
86
 
                      bzrlib.branch,
87
 
                      bzrlib.bundle.serializer,
88
 
                      bzrlib.commands,
89
 
                      bzrlib.errors,
90
 
                      bzrlib.inventory,
91
 
                      bzrlib.iterablefile,
92
 
                      bzrlib.lockdir,
93
 
                      bzrlib.merge3,
94
 
                      bzrlib.option,
95
 
                      bzrlib.osutils,
96
 
                      bzrlib.store
97
 
                      ]
98
 
 
99
 
 
100
 
def packages_to_test():
101
 
    """Return a list of packages to test.
102
 
 
103
 
    The packages are not globally imported so that import failures are
104
 
    triggered when running selftest, not when importing the command.
105
 
    """
106
 
    import bzrlib.doc
107
 
    import bzrlib.tests.blackbox
108
 
    import bzrlib.tests.branch_implementations
109
 
    import bzrlib.tests.bzrdir_implementations
110
 
    import bzrlib.tests.interrepository_implementations
111
 
    import bzrlib.tests.interversionedfile_implementations
112
 
    import bzrlib.tests.intertree_implementations
113
 
    import bzrlib.tests.repository_implementations
114
 
    import bzrlib.tests.revisionstore_implementations
115
 
    import bzrlib.tests.tree_implementations
116
 
    import bzrlib.tests.workingtree_implementations
117
 
    return [
118
 
            bzrlib.doc,
119
 
            bzrlib.tests.blackbox,
120
 
            bzrlib.tests.branch_implementations,
121
 
            bzrlib.tests.bzrdir_implementations,
122
 
            bzrlib.tests.interrepository_implementations,
123
 
            bzrlib.tests.interversionedfile_implementations,
124
 
            bzrlib.tests.intertree_implementations,
125
 
            bzrlib.tests.repository_implementations,
126
 
            bzrlib.tests.revisionstore_implementations,
127
 
            bzrlib.tests.tree_implementations,
128
 
            bzrlib.tests.workingtree_implementations,
129
 
            ]
130
 
 
131
 
 
132
 
class _MyResult(unittest._TextTestResult):
133
 
    """Custom TestResult.
134
 
 
135
 
    Shows output in a different format, including displaying runtime for tests.
136
 
    """
 
108
# Mark this python module as being part of the implementation
 
109
# of unittest: this gives us better tracebacks where the last
 
110
# shown frame is the test code, not our assertXYZ.
 
111
__unittest = 1
 
112
 
 
113
default_transport = LocalURLServer
 
114
 
 
115
 
 
116
class ExtendedTestResult(unittest._TextTestResult):
 
117
    """Accepts, reports and accumulates the results of running tests.
 
118
 
 
119
    Compared to the unittest version this class adds support for
 
120
    profiling, benchmarking, stopping as soon as a test fails,  and
 
121
    skipping tests.  There are further-specialized subclasses for
 
122
    different types of display.
 
123
 
 
124
    When a test finishes, in whatever way, it calls one of the addSuccess,
 
125
    addFailure or addError classes.  These in turn may redirect to a more
 
126
    specific case for the special test results supported by our extended
 
127
    tests.
 
128
 
 
129
    Note that just one of these objects is fed the results from many tests.
 
130
    """
 
131
 
137
132
    stop_early = False
138
 
    
139
 
    def __init__(self, stream, descriptions, verbosity, pb=None):
 
133
 
 
134
    def __init__(self, stream, descriptions, verbosity,
 
135
                 bench_history=None,
 
136
                 num_tests=None,
 
137
                 strict=False,
 
138
                 ):
 
139
        """Construct new TestResult.
 
140
 
 
141
        :param bench_history: Optionally, a writable file object to accumulate
 
142
            benchmark results.
 
143
        """
140
144
        unittest._TextTestResult.__init__(self, stream, descriptions, verbosity)
141
 
        self.pb = pb
142
 
    
143
 
    def extractBenchmarkTime(self, testCase):
 
145
        if bench_history is not None:
 
146
            from bzrlib.version import _get_bzr_source_tree
 
147
            src_tree = _get_bzr_source_tree()
 
148
            if src_tree:
 
149
                try:
 
150
                    revision_id = src_tree.get_parent_ids()[0]
 
151
                except IndexError:
 
152
                    # XXX: if this is a brand new tree, do the same as if there
 
153
                    # is no branch.
 
154
                    revision_id = ''
 
155
            else:
 
156
                # XXX: If there's no branch, what should we do?
 
157
                revision_id = ''
 
158
            bench_history.write("--date %s %s\n" % (time.time(), revision_id))
 
159
        self._bench_history = bench_history
 
160
        self.ui = ui.ui_factory
 
161
        self.num_tests = num_tests
 
162
        self.error_count = 0
 
163
        self.failure_count = 0
 
164
        self.known_failure_count = 0
 
165
        self.skip_count = 0
 
166
        self.not_applicable_count = 0
 
167
        self.unsupported = {}
 
168
        self.count = 0
 
169
        self._overall_start_time = time.time()
 
170
        self._strict = strict
 
171
 
 
172
    def done(self):
 
173
        if self._strict:
 
174
            ok = self.wasStrictlySuccessful()
 
175
        else:
 
176
            ok = self.wasSuccessful()
 
177
        if ok:
 
178
            self.stream.write('tests passed\n')
 
179
        else:
 
180
            self.stream.write('tests failed\n')
 
181
        if TestCase._first_thread_leaker_id:
 
182
            self.stream.write(
 
183
                '%s is leaking threads among %d leaking tests.\n' % (
 
184
                TestCase._first_thread_leaker_id,
 
185
                TestCase._leaking_threads_tests))
 
186
 
 
187
    def _extractBenchmarkTime(self, testCase):
144
188
        """Add a benchmark time for the current test case."""
145
 
        self._benchmarkTime = getattr(testCase, "_benchtime", None)
146
 
    
 
189
        return getattr(testCase, "_benchtime", None)
 
190
 
147
191
    def _elapsedTestTimeString(self):
148
192
        """Return a time string for the overall time the current test has taken."""
149
193
        return self._formatTime(time.time() - self._start_time)
150
194
 
151
 
    def _testTimeString(self):
152
 
        if self._benchmarkTime is not None:
 
195
    def _testTimeString(self, testCase):
 
196
        benchmark_time = self._extractBenchmarkTime(testCase)
 
197
        if benchmark_time is not None:
153
198
            return "%s/%s" % (
154
 
                self._formatTime(self._benchmarkTime),
 
199
                self._formatTime(benchmark_time),
155
200
                self._elapsedTestTimeString())
156
201
        else:
157
 
            return "      %s" % self._elapsedTestTimeString()
 
202
            return "           %s" % self._elapsedTestTimeString()
158
203
 
159
204
    def _formatTime(self, seconds):
160
205
        """Format seconds as milliseconds with leading spaces."""
161
 
        return "%5dms" % (1000 * seconds)
 
206
        # some benchmarks can take thousands of seconds to run, so we need 8
 
207
        # places
 
208
        return "%8dms" % (1000 * seconds)
162
209
 
163
 
    def _ellipsise_unimportant_words(self, a_string, final_width,
164
 
                                   keep_start=False):
165
 
        """Add ellipses (sp?) for overly long strings.
166
 
        
167
 
        :param keep_start: If true preserve the start of a_string rather
168
 
                           than the end of it.
169
 
        """
170
 
        if keep_start:
171
 
            if len(a_string) > final_width:
172
 
                result = a_string[:final_width-3] + '...'
173
 
            else:
174
 
                result = a_string
175
 
        else:
176
 
            if len(a_string) > final_width:
177
 
                result = '...' + a_string[3-final_width:]
178
 
            else:
179
 
                result = a_string
180
 
        return result.ljust(final_width)
 
210
    def _shortened_test_description(self, test):
 
211
        what = test.id()
 
212
        what = re.sub(r'^bzrlib\.(tests|benchmarks)\.', '', what)
 
213
        return what
181
214
 
182
215
    def startTest(self, test):
183
216
        unittest.TestResult.startTest(self, test)
184
 
        # In a short description, the important words are in
185
 
        # the beginning, but in an id, the important words are
186
 
        # at the end
187
 
        SHOW_DESCRIPTIONS = False
188
 
 
189
 
        if not self.showAll and self.dots and self.pb is not None:
190
 
            final_width = 13
191
 
        else:
192
 
            final_width = osutils.terminal_width()
193
 
            final_width = final_width - 15 - 8
194
 
        what = None
195
 
        if SHOW_DESCRIPTIONS:
196
 
            what = test.shortDescription()
197
 
            if what:
198
 
                what = self._ellipsise_unimportant_words(what, final_width, keep_start=True)
199
 
        if what is None:
200
 
            what = test.id()
201
 
            if what.startswith('bzrlib.tests.'):
202
 
                what = what[13:]
203
 
            what = self._ellipsise_unimportant_words(what, final_width)
204
 
        if self.showAll:
205
 
            self.stream.write(what)
206
 
        elif self.dots and self.pb is not None:
207
 
            self.pb.update(what, self.testsRun - 1, None)
208
 
        self.stream.flush()
 
217
        if self.count == 0:
 
218
            self.startTests()
 
219
        self.report_test_start(test)
 
220
        test.number = self.count
209
221
        self._recordTestStartTime()
210
222
 
 
223
    def startTests(self):
 
224
        self.stream.write(
 
225
            'testing: %s\n' % (osutils.realpath(sys.argv[0]),))
 
226
        self.stream.write(
 
227
            '   %s (%s python%s)\n' % (
 
228
                    bzrlib.__path__[0],
 
229
                    bzrlib.version_string,
 
230
                    bzrlib._format_version_tuple(sys.version_info),
 
231
                    ))
 
232
        self.stream.write('\n')
 
233
 
211
234
    def _recordTestStartTime(self):
212
235
        """Record that a test has started."""
213
236
        self._start_time = time.time()
214
237
 
 
238
    def _cleanupLogFile(self, test):
 
239
        # We can only do this if we have one of our TestCases, not if
 
240
        # we have a doctest.
 
241
        setKeepLogfile = getattr(test, 'setKeepLogfile', None)
 
242
        if setKeepLogfile is not None:
 
243
            setKeepLogfile()
 
244
 
215
245
    def addError(self, test, err):
216
 
        if isinstance(err[1], TestSkipped):
217
 
            return self.addSkipped(test, err)    
218
 
        unittest.TestResult.addError(self, test, err)
219
 
        self.extractBenchmarkTime(test)
220
 
        if self.showAll:
221
 
            self.stream.writeln("ERROR %s" % self._testTimeString())
222
 
        elif self.dots and self.pb is None:
223
 
            self.stream.write('E')
224
 
        elif self.dots:
225
 
            self.pb.update(self._ellipsise_unimportant_words('ERROR', 13), self.testsRun, None)
226
 
            self.pb.note(self._ellipsise_unimportant_words(
227
 
                            test.id() + ': ERROR',
228
 
                            osutils.terminal_width()))
229
 
        self.stream.flush()
230
 
        if self.stop_early:
231
 
            self.stop()
 
246
        """Tell result that test finished with an error.
 
247
 
 
248
        Called from the TestCase run() method when the test
 
249
        fails with an unexpected error.
 
250
        """
 
251
        self._testConcluded(test)
 
252
        if isinstance(err[1], TestNotApplicable):
 
253
            return self._addNotApplicable(test, err)
 
254
        elif isinstance(err[1], UnavailableFeature):
 
255
            return self.addNotSupported(test, err[1].args[0])
 
256
        else:
 
257
            unittest.TestResult.addError(self, test, err)
 
258
            self.error_count += 1
 
259
            self.report_error(test, err)
 
260
            if self.stop_early:
 
261
                self.stop()
 
262
            self._cleanupLogFile(test)
232
263
 
233
264
    def addFailure(self, test, err):
234
 
        unittest.TestResult.addFailure(self, test, err)
235
 
        self.extractBenchmarkTime(test)
236
 
        if self.showAll:
237
 
            self.stream.writeln(" FAIL %s" % self._testTimeString())
238
 
        elif self.dots and self.pb is None:
239
 
            self.stream.write('F')
240
 
        elif self.dots:
241
 
            self.pb.update(self._ellipsise_unimportant_words('FAIL', 13), self.testsRun, None)
242
 
            self.pb.note(self._ellipsise_unimportant_words(
243
 
                            test.id() + ': FAIL',
244
 
                            osutils.terminal_width()))
245
 
        self.stream.flush()
246
 
        if self.stop_early:
247
 
            self.stop()
 
265
        """Tell result that test failed.
 
266
 
 
267
        Called from the TestCase run() method when the test
 
268
        fails because e.g. an assert() method failed.
 
269
        """
 
270
        self._testConcluded(test)
 
271
        if isinstance(err[1], KnownFailure):
 
272
            return self._addKnownFailure(test, err)
 
273
        else:
 
274
            unittest.TestResult.addFailure(self, test, err)
 
275
            self.failure_count += 1
 
276
            self.report_failure(test, err)
 
277
            if self.stop_early:
 
278
                self.stop()
 
279
            self._cleanupLogFile(test)
248
280
 
249
281
    def addSuccess(self, test):
250
 
        self.extractBenchmarkTime(test)
251
 
        if self.showAll:
252
 
            self.stream.writeln('   OK %s' % self._testTimeString())
253
 
            for bench_called, stats in getattr(test, '_benchcalls', []):
254
 
                self.stream.writeln('LSProf output for %s(%s, %s)' % bench_called)
255
 
                stats.pprint(file=self.stream)
256
 
        elif self.dots and self.pb is None:
257
 
            self.stream.write('~')
258
 
        elif self.dots:
259
 
            self.pb.update(self._ellipsise_unimportant_words('OK', 13), self.testsRun, None)
260
 
        self.stream.flush()
 
282
        """Tell result that test completed successfully.
 
283
 
 
284
        Called from the TestCase run()
 
285
        """
 
286
        self._testConcluded(test)
 
287
        if self._bench_history is not None:
 
288
            benchmark_time = self._extractBenchmarkTime(test)
 
289
            if benchmark_time is not None:
 
290
                self._bench_history.write("%s %s\n" % (
 
291
                    self._formatTime(benchmark_time),
 
292
                    test.id()))
 
293
        self.report_success(test)
 
294
        self._cleanupLogFile(test)
261
295
        unittest.TestResult.addSuccess(self, test)
262
 
 
263
 
    def addSkipped(self, test, skip_excinfo):
264
 
        self.extractBenchmarkTime(test)
265
 
        if self.showAll:
266
 
            print >>self.stream, ' SKIP %s' % self._testTimeString()
267
 
            print >>self.stream, '     %s' % skip_excinfo[1]
268
 
        elif self.dots and self.pb is None:
269
 
            self.stream.write('S')
270
 
        elif self.dots:
271
 
            self.pb.update(self._ellipsise_unimportant_words('SKIP', 13), self.testsRun, None)
272
 
        self.stream.flush()
273
 
        # seems best to treat this as success from point-of-view of unittest
274
 
        # -- it actually does nothing so it barely matters :)
 
296
        test._log_contents = ''
 
297
 
 
298
    def _testConcluded(self, test):
 
299
        """Common code when a test has finished.
 
300
 
 
301
        Called regardless of whether it succeded, failed, etc.
 
302
        """
 
303
        pass
 
304
 
 
305
    def _addKnownFailure(self, test, err):
 
306
        self.known_failure_count += 1
 
307
        self.report_known_failure(test, err)
 
308
 
 
309
    def addNotSupported(self, test, feature):
 
310
        """The test will not be run because of a missing feature.
 
311
        """
 
312
        # this can be called in two different ways: it may be that the
 
313
        # test started running, and then raised (through addError)
 
314
        # UnavailableFeature.  Alternatively this method can be called
 
315
        # while probing for features before running the tests; in that
 
316
        # case we will see startTest and stopTest, but the test will never
 
317
        # actually run.
 
318
        self.unsupported.setdefault(str(feature), 0)
 
319
        self.unsupported[str(feature)] += 1
 
320
        self.report_unsupported(test, feature)
 
321
 
 
322
    def addSkip(self, test, reason):
 
323
        """A test has not run for 'reason'."""
 
324
        self.skip_count += 1
 
325
        self.report_skip(test, reason)
 
326
 
 
327
    def _addNotApplicable(self, test, skip_excinfo):
 
328
        if isinstance(skip_excinfo[1], TestNotApplicable):
 
329
            self.not_applicable_count += 1
 
330
            self.report_not_applicable(test, skip_excinfo)
275
331
        try:
276
332
            test.tearDown()
277
333
        except KeyboardInterrupt:
278
334
            raise
279
335
        except:
280
 
            self.addError(test, test.__exc_info())
 
336
            self.addError(test, test.exc_info())
281
337
        else:
 
338
            # seems best to treat this as success from point-of-view of unittest
 
339
            # -- it actually does nothing so it barely matters :)
282
340
            unittest.TestResult.addSuccess(self, test)
 
341
            test._log_contents = ''
283
342
 
284
343
    def printErrorList(self, flavour, errors):
285
344
        for test, err in errors:
286
345
            self.stream.writeln(self.separator1)
287
 
            self.stream.writeln("%s: %s" % (flavour, self.getDescription(test)))
 
346
            self.stream.write("%s: " % flavour)
 
347
            self.stream.writeln(self.getDescription(test))
288
348
            if getattr(test, '_get_log', None) is not None:
289
 
                print >>self.stream
290
 
                print >>self.stream, \
291
 
                        ('vvvv[log from %s]' % test.id()).ljust(78,'-')
292
 
                print >>self.stream, test._get_log()
293
 
                print >>self.stream, \
294
 
                        ('^^^^[log from %s]' % test.id()).ljust(78,'-')
 
349
                self.stream.write('\n')
 
350
                self.stream.write(
 
351
                        ('vvvv[log from %s]' % test.id()).ljust(78,'-'))
 
352
                self.stream.write('\n')
 
353
                self.stream.write(test._get_log())
 
354
                self.stream.write('\n')
 
355
                self.stream.write(
 
356
                        ('^^^^[log from %s]' % test.id()).ljust(78,'-'))
 
357
                self.stream.write('\n')
295
358
            self.stream.writeln(self.separator2)
296
359
            self.stream.writeln("%s" % err)
297
360
 
 
361
    def finished(self):
 
362
        pass
 
363
 
 
364
    def report_cleaning_up(self):
 
365
        pass
 
366
 
 
367
    def report_success(self, test):
 
368
        pass
 
369
 
 
370
    def wasStrictlySuccessful(self):
 
371
        if self.unsupported or self.known_failure_count:
 
372
            return False
 
373
        return self.wasSuccessful()
 
374
 
 
375
 
 
376
class TextTestResult(ExtendedTestResult):
 
377
    """Displays progress and results of tests in text form"""
 
378
 
 
379
    def __init__(self, stream, descriptions, verbosity,
 
380
                 bench_history=None,
 
381
                 num_tests=None,
 
382
                 pb=None,
 
383
                 strict=None,
 
384
                 ):
 
385
        ExtendedTestResult.__init__(self, stream, descriptions, verbosity,
 
386
            bench_history, num_tests, strict)
 
387
        if pb is None:
 
388
            self.pb = self.ui.nested_progress_bar()
 
389
            self._supplied_pb = False
 
390
        else:
 
391
            self.pb = pb
 
392
            self._supplied_pb = True
 
393
        self.pb.show_pct = False
 
394
        self.pb.show_spinner = False
 
395
        self.pb.show_eta = False,
 
396
        self.pb.show_count = False
 
397
        self.pb.show_bar = False
 
398
 
 
399
    def report_starting(self):
 
400
        self.pb.update('[test 0/%d] Starting' % (self.num_tests))
 
401
 
 
402
    def _progress_prefix_text(self):
 
403
        # the longer this text, the less space we have to show the test
 
404
        # name...
 
405
        a = '[%d' % self.count              # total that have been run
 
406
        # tests skipped as known not to be relevant are not important enough
 
407
        # to show here
 
408
        ## if self.skip_count:
 
409
        ##     a += ', %d skip' % self.skip_count
 
410
        ## if self.known_failure_count:
 
411
        ##     a += '+%dX' % self.known_failure_count
 
412
        if self.num_tests is not None:
 
413
            a +='/%d' % self.num_tests
 
414
        a += ' in '
 
415
        runtime = time.time() - self._overall_start_time
 
416
        if runtime >= 60:
 
417
            a += '%dm%ds' % (runtime / 60, runtime % 60)
 
418
        else:
 
419
            a += '%ds' % runtime
 
420
        if self.error_count:
 
421
            a += ', %d err' % self.error_count
 
422
        if self.failure_count:
 
423
            a += ', %d fail' % self.failure_count
 
424
        if self.unsupported:
 
425
            a += ', %d missing' % len(self.unsupported)
 
426
        a += ']'
 
427
        return a
 
428
 
 
429
    def report_test_start(self, test):
 
430
        self.count += 1
 
431
        self.pb.update(
 
432
                self._progress_prefix_text()
 
433
                + ' '
 
434
                + self._shortened_test_description(test))
 
435
 
 
436
    def _test_description(self, test):
 
437
        return self._shortened_test_description(test)
 
438
 
 
439
    def report_error(self, test, err):
 
440
        self.pb.note('ERROR: %s\n    %s\n',
 
441
            self._test_description(test),
 
442
            err[1],
 
443
            )
 
444
 
 
445
    def report_failure(self, test, err):
 
446
        self.pb.note('FAIL: %s\n    %s\n',
 
447
            self._test_description(test),
 
448
            err[1],
 
449
            )
 
450
 
 
451
    def report_known_failure(self, test, err):
 
452
        self.pb.note('XFAIL: %s\n%s\n',
 
453
            self._test_description(test), err[1])
 
454
 
 
455
    def report_skip(self, test, reason):
 
456
        pass
 
457
 
 
458
    def report_not_applicable(self, test, skip_excinfo):
 
459
        pass
 
460
 
 
461
    def report_unsupported(self, test, feature):
 
462
        """test cannot be run because feature is missing."""
 
463
 
 
464
    def report_cleaning_up(self):
 
465
        self.pb.update('Cleaning up')
 
466
 
 
467
    def finished(self):
 
468
        if not self._supplied_pb:
 
469
            self.pb.finished()
 
470
 
 
471
 
 
472
class VerboseTestResult(ExtendedTestResult):
 
473
    """Produce long output, with one line per test run plus times"""
 
474
 
 
475
    def _ellipsize_to_right(self, a_string, final_width):
 
476
        """Truncate and pad a string, keeping the right hand side"""
 
477
        if len(a_string) > final_width:
 
478
            result = '...' + a_string[3-final_width:]
 
479
        else:
 
480
            result = a_string
 
481
        return result.ljust(final_width)
 
482
 
 
483
    def report_starting(self):
 
484
        self.stream.write('running %d tests...\n' % self.num_tests)
 
485
 
 
486
    def report_test_start(self, test):
 
487
        self.count += 1
 
488
        name = self._shortened_test_description(test)
 
489
        # width needs space for 6 char status, plus 1 for slash, plus 2 10-char
 
490
        # numbers, plus a trailing blank
 
491
        # when NUMBERED_DIRS: plus 5 chars on test number, plus 1 char on space
 
492
        self.stream.write(self._ellipsize_to_right(name,
 
493
                          osutils.terminal_width()-30))
 
494
        self.stream.flush()
 
495
 
 
496
    def _error_summary(self, err):
 
497
        indent = ' ' * 4
 
498
        return '%s%s' % (indent, err[1])
 
499
 
 
500
    def report_error(self, test, err):
 
501
        self.stream.writeln('ERROR %s\n%s'
 
502
                % (self._testTimeString(test),
 
503
                   self._error_summary(err)))
 
504
 
 
505
    def report_failure(self, test, err):
 
506
        self.stream.writeln(' FAIL %s\n%s'
 
507
                % (self._testTimeString(test),
 
508
                   self._error_summary(err)))
 
509
 
 
510
    def report_known_failure(self, test, err):
 
511
        self.stream.writeln('XFAIL %s\n%s'
 
512
                % (self._testTimeString(test),
 
513
                   self._error_summary(err)))
 
514
 
 
515
    def report_success(self, test):
 
516
        self.stream.writeln('   OK %s' % self._testTimeString(test))
 
517
        for bench_called, stats in getattr(test, '_benchcalls', []):
 
518
            self.stream.writeln('LSProf output for %s(%s, %s)' % bench_called)
 
519
            stats.pprint(file=self.stream)
 
520
        # flush the stream so that we get smooth output. This verbose mode is
 
521
        # used to show the output in PQM.
 
522
        self.stream.flush()
 
523
 
 
524
    def report_skip(self, test, reason):
 
525
        self.stream.writeln(' SKIP %s\n%s'
 
526
                % (self._testTimeString(test), reason))
 
527
 
 
528
    def report_not_applicable(self, test, skip_excinfo):
 
529
        self.stream.writeln('  N/A %s\n%s'
 
530
                % (self._testTimeString(test),
 
531
                   self._error_summary(skip_excinfo)))
 
532
 
 
533
    def report_unsupported(self, test, feature):
 
534
        """test cannot be run because feature is missing."""
 
535
        self.stream.writeln("NODEP %s\n    The feature '%s' is not available."
 
536
                %(self._testTimeString(test), feature))
 
537
 
298
538
 
299
539
class TextTestRunner(object):
300
540
    stop_on_failure = False
303
543
                 stream=sys.stderr,
304
544
                 descriptions=0,
305
545
                 verbosity=1,
306
 
                 keep_output=False,
307
 
                 pb=None):
 
546
                 bench_history=None,
 
547
                 list_only=False,
 
548
                 strict=False,
 
549
                 ):
308
550
        self.stream = unittest._WritelnDecorator(stream)
309
551
        self.descriptions = descriptions
310
552
        self.verbosity = verbosity
311
 
        self.keep_output = keep_output
312
 
        self.pb = pb
313
 
 
314
 
    def _makeResult(self):
315
 
        result = _MyResult(self.stream,
316
 
                           self.descriptions,
317
 
                           self.verbosity,
318
 
                           pb=self.pb)
319
 
        result.stop_early = self.stop_on_failure
320
 
        return result
 
553
        self._bench_history = bench_history
 
554
        self.list_only = list_only
 
555
        self._strict = strict
321
556
 
322
557
    def run(self, test):
323
558
        "Run the given test case or test suite."
324
 
        result = self._makeResult()
325
559
        startTime = time.time()
326
 
        if self.pb is not None:
327
 
            self.pb.update('Running tests', 0, test.countTestCases())
328
 
        test.run(result)
 
560
        if self.verbosity == 1:
 
561
            result_class = TextTestResult
 
562
        elif self.verbosity >= 2:
 
563
            result_class = VerboseTestResult
 
564
        result = result_class(self.stream,
 
565
                              self.descriptions,
 
566
                              self.verbosity,
 
567
                              bench_history=self._bench_history,
 
568
                              num_tests=test.countTestCases(),
 
569
                              strict=self._strict,
 
570
                              )
 
571
        result.stop_early = self.stop_on_failure
 
572
        result.report_starting()
 
573
        if self.list_only:
 
574
            if self.verbosity >= 2:
 
575
                self.stream.writeln("Listing tests only ...\n")
 
576
            run = 0
 
577
            for t in iter_suite_tests(test):
 
578
                self.stream.writeln("%s" % (t.id()))
 
579
                run += 1
 
580
            return None
 
581
        else:
 
582
            try:
 
583
                import testtools
 
584
            except ImportError:
 
585
                test.run(result)
 
586
            else:
 
587
                if isinstance(test, testtools.ConcurrentTestSuite):
 
588
                    # We need to catch bzr specific behaviors
 
589
                    test.run(BZRTransformingResult(result))
 
590
                else:
 
591
                    test.run(result)
 
592
            run = result.testsRun
 
593
            actionTaken = "Ran"
329
594
        stopTime = time.time()
330
595
        timeTaken = stopTime - startTime
331
596
        result.printErrors()
332
597
        self.stream.writeln(result.separator2)
333
 
        run = result.testsRun
334
 
        self.stream.writeln("Ran %d test%s in %.3fs" %
335
 
                            (run, run != 1 and "s" or "", timeTaken))
 
598
        self.stream.writeln("%s %d test%s in %.3fs" % (actionTaken,
 
599
                            run, run != 1 and "s" or "", timeTaken))
336
600
        self.stream.writeln()
337
601
        if not result.wasSuccessful():
338
602
            self.stream.write("FAILED (")
342
606
            if errored:
343
607
                if failed: self.stream.write(", ")
344
608
                self.stream.write("errors=%d" % errored)
 
609
            if result.known_failure_count:
 
610
                if failed or errored: self.stream.write(", ")
 
611
                self.stream.write("known_failure_count=%d" %
 
612
                    result.known_failure_count)
345
613
            self.stream.writeln(")")
346
614
        else:
347
 
            self.stream.writeln("OK")
348
 
        if self.pb is not None:
349
 
            self.pb.update('Cleaning up', 0, 1)
350
 
        # This is still a little bogus, 
351
 
        # but only a little. Folk not using our testrunner will
352
 
        # have to delete their temp directories themselves.
353
 
        test_root = TestCaseInTempDir.TEST_ROOT
354
 
        if result.wasSuccessful() or not self.keep_output:
355
 
            if test_root is not None:
356
 
                # If LANG=C we probably have created some bogus paths
357
 
                # which rmtree(unicode) will fail to delete
358
 
                # so make sure we are using rmtree(str) to delete everything
359
 
                # except on win32, where rmtree(str) will fail
360
 
                # since it doesn't have the property of byte-stream paths
361
 
                # (they are either ascii or mbcs)
362
 
                if sys.platform == 'win32':
363
 
                    # make sure we are using the unicode win32 api
364
 
                    test_root = unicode(test_root)
365
 
                else:
366
 
                    test_root = test_root.encode(
367
 
                        sys.getfilesystemencoding())
368
 
                osutils.rmtree(test_root)
369
 
        else:
370
 
            if self.pb is not None:
371
 
                self.pb.note("Failed tests working directories are in '%s'\n",
372
 
                             test_root)
 
615
            if result.known_failure_count:
 
616
                self.stream.writeln("OK (known_failures=%d)" %
 
617
                    result.known_failure_count)
373
618
            else:
374
 
                self.stream.writeln(
375
 
                    "Failed tests working directories are in '%s'\n" %
376
 
                    test_root)
377
 
        TestCaseInTempDir.TEST_ROOT = None
378
 
        if self.pb is not None:
379
 
            self.pb.clear()
 
619
                self.stream.writeln("OK")
 
620
        if result.skip_count > 0:
 
621
            skipped = result.skip_count
 
622
            self.stream.writeln('%d test%s skipped' %
 
623
                                (skipped, skipped != 1 and "s" or ""))
 
624
        if result.unsupported:
 
625
            for feature, count in sorted(result.unsupported.items()):
 
626
                self.stream.writeln("Missing feature '%s' skipped %d tests." %
 
627
                    (feature, count))
 
628
        result.finished()
380
629
        return result
381
630
 
382
631
 
383
632
def iter_suite_tests(suite):
384
633
    """Return all tests in a suite, recursing through nested suites"""
385
 
    for item in suite._tests:
386
 
        if isinstance(item, unittest.TestCase):
387
 
            yield item
388
 
        elif isinstance(item, unittest.TestSuite):
 
634
    if isinstance(suite, unittest.TestCase):
 
635
        yield suite
 
636
    elif isinstance(suite, unittest.TestSuite):
 
637
        for item in suite:
389
638
            for r in iter_suite_tests(item):
390
639
                yield r
391
 
        else:
392
 
            raise Exception('unknown object %r inside test suite %r'
393
 
                            % (item, suite))
 
640
    else:
 
641
        raise Exception('unknown type %r for object %r'
 
642
                        % (type(suite), suite))
394
643
 
395
644
 
396
645
class TestSkipped(Exception):
397
646
    """Indicates that a test was intentionally skipped, rather than failing."""
398
 
    # XXX: Not used yet
 
647
 
 
648
 
 
649
class TestNotApplicable(TestSkipped):
 
650
    """A test is not applicable to the situation where it was run.
 
651
 
 
652
    This is only normally raised by parameterized tests, if they find that
 
653
    the instance they're constructed upon does not support one aspect
 
654
    of its interface.
 
655
    """
 
656
 
 
657
 
 
658
class KnownFailure(AssertionError):
 
659
    """Indicates that a test failed in a precisely expected manner.
 
660
 
 
661
    Such failures dont block the whole test suite from passing because they are
 
662
    indicators of partially completed code or of future work. We have an
 
663
    explicit error for them so that we can ensure that they are always visible:
 
664
    KnownFailures are always shown in the output of bzr selftest.
 
665
    """
 
666
 
 
667
 
 
668
class UnavailableFeature(Exception):
 
669
    """A feature required for this test was not available.
 
670
 
 
671
    The feature should be used to construct the exception.
 
672
    """
399
673
 
400
674
 
401
675
class CommandFailed(Exception):
404
678
 
405
679
class StringIOWrapper(object):
406
680
    """A wrapper around cStringIO which just adds an encoding attribute.
407
 
    
 
681
 
408
682
    Internally we can check sys.stdout to see what the output encoding
409
683
    should be. However, cStringIO has no encoding attribute that we can
410
684
    set. So we wrap it instead.
428
702
            return setattr(self._cstring, name, val)
429
703
 
430
704
 
 
705
class TestUIFactory(ui.CLIUIFactory):
 
706
    """A UI Factory for testing.
 
707
 
 
708
    Hide the progress bar but emit note()s.
 
709
    Redirect stdin.
 
710
    Allows get_password to be tested without real tty attached.
 
711
    """
 
712
 
 
713
    def __init__(self, stdout=None, stderr=None, stdin=None):
 
714
        if stdin is not None:
 
715
            # We use a StringIOWrapper to be able to test various
 
716
            # encodings, but the user is still responsible to
 
717
            # encode the string and to set the encoding attribute
 
718
            # of StringIOWrapper.
 
719
            stdin = StringIOWrapper(stdin)
 
720
        super(TestUIFactory, self).__init__(stdin, stdout, stderr)
 
721
 
 
722
    def clear(self):
 
723
        """See progress.ProgressBar.clear()."""
 
724
 
 
725
    def clear_term(self):
 
726
        """See progress.ProgressBar.clear_term()."""
 
727
 
 
728
    def finished(self):
 
729
        """See progress.ProgressBar.finished()."""
 
730
 
 
731
    def note(self, fmt_string, *args):
 
732
        """See progress.ProgressBar.note()."""
 
733
        if args:
 
734
            fmt_string = fmt_string % args
 
735
        self.stdout.write(fmt_string + "\n")
 
736
 
 
737
    def progress_bar(self):
 
738
        return self
 
739
 
 
740
    def nested_progress_bar(self):
 
741
        return self
 
742
 
 
743
    def update(self, message, count=None, total=None):
 
744
        """See progress.ProgressBar.update()."""
 
745
 
 
746
    def get_non_echoed_password(self):
 
747
        """Get password from stdin without trying to handle the echo mode"""
 
748
        password = self.stdin.readline()
 
749
        if not password:
 
750
            raise EOFError
 
751
        if password[-1] == '\n':
 
752
            password = password[:-1]
 
753
        return password
 
754
 
 
755
 
431
756
class TestCase(unittest.TestCase):
432
757
    """Base class for bzr unit tests.
433
 
    
434
 
    Tests that need access to disk resources should subclass 
 
758
 
 
759
    Tests that need access to disk resources should subclass
435
760
    TestCaseInTempDir not TestCase.
436
761
 
437
762
    Error and debug log messages are redirected from their usual
439
764
    retrieved by _get_log().  We use a real OS file, not an in-memory object,
440
765
    so that it can also capture file IO.  When the test completes this file
441
766
    is read into memory and removed from disk.
442
 
       
 
767
 
443
768
    There are also convenience functions to invoke bzr's command-line
444
769
    routine, and to build and check bzr trees.
445
 
   
 
770
 
446
771
    In addition to the usual method of overriding tearDown(), this class also
447
772
    allows subclasses to register functions into the _cleanups list, which is
448
773
    run in order as the object is torn down.  It's less likely this will be
449
774
    accidentally overlooked.
450
775
    """
451
776
 
 
777
    _active_threads = None
 
778
    _leaking_threads_tests = 0
 
779
    _first_thread_leaker_id = None
452
780
    _log_file_name = None
453
781
    _log_contents = ''
 
782
    _keep_log_file = False
454
783
    # record lsprof data when performing benchmark calls.
455
784
    _gather_lsprof_in_benchmarks = False
 
785
    attrs_to_keep = ('id', '_testMethodName', '_testMethodDoc',
 
786
                     '_log_contents', '_log_file_name', '_benchtime',
 
787
                     '_TestCase__testMethodName', '_TestCase__testMethodDoc',)
456
788
 
457
789
    def __init__(self, methodName='testMethod'):
458
790
        super(TestCase, self).__init__(methodName)
459
791
        self._cleanups = []
 
792
        self._bzr_test_setUp_run = False
 
793
        self._bzr_test_tearDown_run = False
460
794
 
461
795
    def setUp(self):
462
796
        unittest.TestCase.setUp(self)
 
797
        self._bzr_test_setUp_run = True
463
798
        self._cleanEnvironment()
464
 
        bzrlib.trace.disable_default_logging()
 
799
        self._silenceUI()
465
800
        self._startLogFile()
466
801
        self._benchcalls = []
467
802
        self._benchtime = None
 
803
        self._clear_hooks()
 
804
        # Track locks - needs to be called before _clear_debug_flags.
 
805
        self._track_locks()
 
806
        self._clear_debug_flags()
 
807
        TestCase._active_threads = threading.activeCount()
 
808
        self.addCleanup(self._check_leaked_threads)
 
809
 
 
810
    def debug(self):
 
811
        # debug a frame up.
 
812
        import pdb
 
813
        pdb.Pdb().set_trace(sys._getframe().f_back)
 
814
 
 
815
    def _check_leaked_threads(self):
 
816
        active = threading.activeCount()
 
817
        leaked_threads = active - TestCase._active_threads
 
818
        TestCase._active_threads = active
 
819
        if leaked_threads:
 
820
            TestCase._leaking_threads_tests += 1
 
821
            if TestCase._first_thread_leaker_id is None:
 
822
                TestCase._first_thread_leaker_id = self.id()
 
823
 
 
824
    def _clear_debug_flags(self):
 
825
        """Prevent externally set debug flags affecting tests.
 
826
 
 
827
        Tests that want to use debug flags can just set them in the
 
828
        debug_flags set during setup/teardown.
 
829
        """
 
830
        self._preserved_debug_flags = set(debug.debug_flags)
 
831
        if 'allow_debug' not in selftest_debug_flags:
 
832
            debug.debug_flags.clear()
 
833
        self.addCleanup(self._restore_debug_flags)
 
834
 
 
835
    def _clear_hooks(self):
 
836
        # prevent hooks affecting tests
 
837
        self._preserved_hooks = {}
 
838
        for key, factory in hooks.known_hooks.items():
 
839
            parent, name = hooks.known_hooks_key_to_parent_and_attribute(key)
 
840
            current_hooks = hooks.known_hooks_key_to_object(key)
 
841
            self._preserved_hooks[parent] = (name, current_hooks)
 
842
        self.addCleanup(self._restoreHooks)
 
843
        for key, factory in hooks.known_hooks.items():
 
844
            parent, name = hooks.known_hooks_key_to_parent_and_attribute(key)
 
845
            setattr(parent, name, factory())
 
846
        # this hook should always be installed
 
847
        request._install_hook()
 
848
 
 
849
    def _silenceUI(self):
 
850
        """Turn off UI for duration of test"""
 
851
        # by default the UI is off; tests can turn it on if they want it.
 
852
        saved = ui.ui_factory
 
853
        def _restore():
 
854
            ui.ui_factory = saved
 
855
        ui.ui_factory = ui.SilentUIFactory()
 
856
        self.addCleanup(_restore)
 
857
 
 
858
    def _check_locks(self):
 
859
        """Check that all lock take/release actions have been paired."""
 
860
        # once we have fixed all the current lock problems, we can change the
 
861
        # following code to always check for mismatched locks, but only do
 
862
        # traceback showing with -Dlock (self._lock_check_thorough is True).
 
863
        # For now, because the test suite will fail, we only assert that lock
 
864
        # matching has occured with -Dlock.
 
865
        # unhook:
 
866
        acquired_locks = [lock for action, lock in self._lock_actions
 
867
                          if action == 'acquired']
 
868
        released_locks = [lock for action, lock in self._lock_actions
 
869
                          if action == 'released']
 
870
        broken_locks = [lock for action, lock in self._lock_actions
 
871
                        if action == 'broken']
 
872
        # trivially, given the tests for lock acquistion and release, if we
 
873
        # have as many in each list, it should be ok. Some lock tests also
 
874
        # break some locks on purpose and should be taken into account by
 
875
        # considering that breaking a lock is just a dirty way of releasing it.
 
876
        if len(acquired_locks) != (len(released_locks) + len(broken_locks)):
 
877
            message = ('Different number of acquired and '
 
878
                       'released or broken locks. (%s, %s + %s)' %
 
879
                       (acquired_locks, released_locks, broken_locks))
 
880
            if not self._lock_check_thorough:
 
881
                # Rather than fail, just warn
 
882
                print "Broken test %s: %s" % (self, message)
 
883
                return
 
884
            self.fail(message)
 
885
 
 
886
    def _track_locks(self):
 
887
        """Track lock activity during tests."""
 
888
        self._lock_actions = []
 
889
        self._lock_check_thorough = 'lock' not in debug.debug_flags
 
890
        self.addCleanup(self._check_locks)
 
891
        _mod_lock.Lock.hooks.install_named_hook('lock_acquired',
 
892
                                                self._lock_acquired, None)
 
893
        _mod_lock.Lock.hooks.install_named_hook('lock_released',
 
894
                                                self._lock_released, None)
 
895
        _mod_lock.Lock.hooks.install_named_hook('lock_broken',
 
896
                                                self._lock_broken, None)
 
897
 
 
898
    def _lock_acquired(self, result):
 
899
        self._lock_actions.append(('acquired', result))
 
900
 
 
901
    def _lock_released(self, result):
 
902
        self._lock_actions.append(('released', result))
 
903
 
 
904
    def _lock_broken(self, result):
 
905
        self._lock_actions.append(('broken', result))
468
906
 
469
907
    def _ndiff_strings(self, a, b):
470
908
        """Return ndiff between two strings containing lines.
471
 
        
 
909
 
472
910
        A trailing newline is added if missing to make the strings
473
911
        print properly."""
474
912
        if b and b[-1] != '\n':
481
919
                                  charjunk=lambda x: False)
482
920
        return ''.join(difflines)
483
921
 
 
922
    def assertEqual(self, a, b, message=''):
 
923
        try:
 
924
            if a == b:
 
925
                return
 
926
        except UnicodeError, e:
 
927
            # If we can't compare without getting a UnicodeError, then
 
928
            # obviously they are different
 
929
            mutter('UnicodeError: %s', e)
 
930
        if message:
 
931
            message += '\n'
 
932
        raise AssertionError("%snot equal:\na = %s\nb = %s\n"
 
933
            % (message,
 
934
               pformat(a), pformat(b)))
 
935
 
 
936
    assertEquals = assertEqual
 
937
 
484
938
    def assertEqualDiff(self, a, b, message=None):
485
939
        """Assert two texts are equal, if not raise an exception.
486
 
        
487
 
        This is intended for use with multi-line strings where it can 
 
940
 
 
941
        This is intended for use with multi-line strings where it can
488
942
        be hard to find the differences by eye.
489
943
        """
490
944
        # TODO: perhaps override assertEquals to call this for strings?
492
946
            return
493
947
        if message is None:
494
948
            message = "texts not equal:\n"
495
 
        raise AssertionError(message + 
496
 
                             self._ndiff_strings(a, b))      
497
 
        
 
949
        if a == b + '\n':
 
950
            message = 'first string is missing a final newline.\n'
 
951
        if a + '\n' == b:
 
952
            message = 'second string is missing a final newline.\n'
 
953
        raise AssertionError(message +
 
954
                             self._ndiff_strings(a, b))
 
955
 
498
956
    def assertEqualMode(self, mode, mode_test):
499
957
        self.assertEqual(mode, mode_test,
500
958
                         'mode mismatch %o != %o' % (mode, mode_test))
501
959
 
 
960
    def assertEqualStat(self, expected, actual):
 
961
        """assert that expected and actual are the same stat result.
 
962
 
 
963
        :param expected: A stat result.
 
964
        :param actual: A stat result.
 
965
        :raises AssertionError: If the expected and actual stat values differ
 
966
            other than by atime.
 
967
        """
 
968
        self.assertEqual(expected.st_size, actual.st_size)
 
969
        self.assertEqual(expected.st_mtime, actual.st_mtime)
 
970
        self.assertEqual(expected.st_ctime, actual.st_ctime)
 
971
        self.assertEqual(expected.st_dev, actual.st_dev)
 
972
        self.assertEqual(expected.st_ino, actual.st_ino)
 
973
        self.assertEqual(expected.st_mode, actual.st_mode)
 
974
 
 
975
    def assertLength(self, length, obj_with_len):
 
976
        """Assert that obj_with_len is of length length."""
 
977
        if len(obj_with_len) != length:
 
978
            self.fail("Incorrect length: wanted %d, got %d for %r" % (
 
979
                length, len(obj_with_len), obj_with_len))
 
980
 
 
981
    def assertPositive(self, val):
 
982
        """Assert that val is greater than 0."""
 
983
        self.assertTrue(val > 0, 'expected a positive value, but got %s' % val)
 
984
 
 
985
    def assertNegative(self, val):
 
986
        """Assert that val is less than 0."""
 
987
        self.assertTrue(val < 0, 'expected a negative value, but got %s' % val)
 
988
 
502
989
    def assertStartsWith(self, s, prefix):
503
990
        if not s.startswith(prefix):
504
991
            raise AssertionError('string %r does not start with %r' % (s, prefix))
508
995
        if not s.endswith(suffix):
509
996
            raise AssertionError('string %r does not end with %r' % (s, suffix))
510
997
 
511
 
    def assertContainsRe(self, haystack, needle_re):
 
998
    def assertContainsRe(self, haystack, needle_re, flags=0):
512
999
        """Assert that a contains something matching a regular expression."""
513
 
        if not re.search(needle_re, haystack):
514
 
            raise AssertionError('pattern "%s" not found in "%s"'
515
 
                    % (needle_re, haystack))
 
1000
        if not re.search(needle_re, haystack, flags):
 
1001
            if '\n' in haystack or len(haystack) > 60:
 
1002
                # a long string, format it in a more readable way
 
1003
                raise AssertionError(
 
1004
                        'pattern "%s" not found in\n"""\\\n%s"""\n'
 
1005
                        % (needle_re, haystack))
 
1006
            else:
 
1007
                raise AssertionError('pattern "%s" not found in "%s"'
 
1008
                        % (needle_re, haystack))
516
1009
 
517
 
    def assertNotContainsRe(self, haystack, needle_re):
 
1010
    def assertNotContainsRe(self, haystack, needle_re, flags=0):
518
1011
        """Assert that a does not match a regular expression"""
519
 
        if re.search(needle_re, haystack):
 
1012
        if re.search(needle_re, haystack, flags):
520
1013
            raise AssertionError('pattern "%s" found in "%s"'
521
1014
                    % (needle_re, haystack))
522
1015
 
523
1016
    def assertSubset(self, sublist, superlist):
524
1017
        """Assert that every entry in sublist is present in superlist."""
525
 
        missing = []
526
 
        for entry in sublist:
527
 
            if entry not in superlist:
528
 
                missing.append(entry)
 
1018
        missing = set(sublist) - set(superlist)
529
1019
        if len(missing) > 0:
530
 
            raise AssertionError("value(s) %r not present in container %r" % 
 
1020
            raise AssertionError("value(s) %r not present in container %r" %
531
1021
                                 (missing, superlist))
532
1022
 
533
 
    def assertIs(self, left, right):
 
1023
    def assertListRaises(self, excClass, func, *args, **kwargs):
 
1024
        """Fail unless excClass is raised when the iterator from func is used.
 
1025
 
 
1026
        Many functions can return generators this makes sure
 
1027
        to wrap them in a list() call to make sure the whole generator
 
1028
        is run, and that the proper exception is raised.
 
1029
        """
 
1030
        try:
 
1031
            list(func(*args, **kwargs))
 
1032
        except excClass, e:
 
1033
            return e
 
1034
        else:
 
1035
            if getattr(excClass,'__name__', None) is not None:
 
1036
                excName = excClass.__name__
 
1037
            else:
 
1038
                excName = str(excClass)
 
1039
            raise self.failureException, "%s not raised" % excName
 
1040
 
 
1041
    def assertRaises(self, excClass, callableObj, *args, **kwargs):
 
1042
        """Assert that a callable raises a particular exception.
 
1043
 
 
1044
        :param excClass: As for the except statement, this may be either an
 
1045
            exception class, or a tuple of classes.
 
1046
        :param callableObj: A callable, will be passed ``*args`` and
 
1047
            ``**kwargs``.
 
1048
 
 
1049
        Returns the exception so that you can examine it.
 
1050
        """
 
1051
        try:
 
1052
            callableObj(*args, **kwargs)
 
1053
        except excClass, e:
 
1054
            return e
 
1055
        else:
 
1056
            if getattr(excClass,'__name__', None) is not None:
 
1057
                excName = excClass.__name__
 
1058
            else:
 
1059
                # probably a tuple
 
1060
                excName = str(excClass)
 
1061
            raise self.failureException, "%s not raised" % excName
 
1062
 
 
1063
    def assertIs(self, left, right, message=None):
534
1064
        if not (left is right):
535
 
            raise AssertionError("%r is not %r." % (left, right))
 
1065
            if message is not None:
 
1066
                raise AssertionError(message)
 
1067
            else:
 
1068
                raise AssertionError("%r is not %r." % (left, right))
 
1069
 
 
1070
    def assertIsNot(self, left, right, message=None):
 
1071
        if (left is right):
 
1072
            if message is not None:
 
1073
                raise AssertionError(message)
 
1074
            else:
 
1075
                raise AssertionError("%r is %r." % (left, right))
536
1076
 
537
1077
    def assertTransportMode(self, transport, path, mode):
538
 
        """Fail if a path does not have mode mode.
539
 
        
 
1078
        """Fail if a path does not have mode "mode".
 
1079
 
540
1080
        If modes are not supported on this transport, the assertion is ignored.
541
1081
        """
542
1082
        if not transport._can_roundtrip_unix_modebits():
544
1084
        path_stat = transport.stat(path)
545
1085
        actual_mode = stat.S_IMODE(path_stat.st_mode)
546
1086
        self.assertEqual(mode, actual_mode,
547
 
            'mode of %r incorrect (%o != %o)' % (path, mode, actual_mode))
 
1087
                         'mode of %r incorrect (%s != %s)'
 
1088
                         % (path, oct(mode), oct(actual_mode)))
 
1089
 
 
1090
    def assertIsSameRealPath(self, path1, path2):
 
1091
        """Fail if path1 and path2 points to different files"""
 
1092
        self.assertEqual(osutils.realpath(path1),
 
1093
                         osutils.realpath(path2),
 
1094
                         "apparent paths:\na = %s\nb = %s\n," % (path1, path2))
548
1095
 
549
1096
    def assertIsInstance(self, obj, kls):
550
1097
        """Fail if obj is not an instance of kls"""
552
1099
            self.fail("%r is an instance of %s rather than %s" % (
553
1100
                obj, obj.__class__, kls))
554
1101
 
 
1102
    def expectFailure(self, reason, assertion, *args, **kwargs):
 
1103
        """Invoke a test, expecting it to fail for the given reason.
 
1104
 
 
1105
        This is for assertions that ought to succeed, but currently fail.
 
1106
        (The failure is *expected* but not *wanted*.)  Please be very precise
 
1107
        about the failure you're expecting.  If a new bug is introduced,
 
1108
        AssertionError should be raised, not KnownFailure.
 
1109
 
 
1110
        Frequently, expectFailure should be followed by an opposite assertion.
 
1111
        See example below.
 
1112
 
 
1113
        Intended to be used with a callable that raises AssertionError as the
 
1114
        'assertion' parameter.  args and kwargs are passed to the 'assertion'.
 
1115
 
 
1116
        Raises KnownFailure if the test fails.  Raises AssertionError if the
 
1117
        test succeeds.
 
1118
 
 
1119
        example usage::
 
1120
 
 
1121
          self.expectFailure('Math is broken', self.assertNotEqual, 54,
 
1122
                             dynamic_val)
 
1123
          self.assertEqual(42, dynamic_val)
 
1124
 
 
1125
          This means that a dynamic_val of 54 will cause the test to raise
 
1126
          a KnownFailure.  Once math is fixed and the expectFailure is removed,
 
1127
          only a dynamic_val of 42 will allow the test to pass.  Anything other
 
1128
          than 54 or 42 will cause an AssertionError.
 
1129
        """
 
1130
        try:
 
1131
            assertion(*args, **kwargs)
 
1132
        except AssertionError:
 
1133
            raise KnownFailure(reason)
 
1134
        else:
 
1135
            self.fail('Unexpected success.  Should have failed: %s' % reason)
 
1136
 
 
1137
    def assertFileEqual(self, content, path):
 
1138
        """Fail if path does not contain 'content'."""
 
1139
        self.failUnlessExists(path)
 
1140
        f = file(path, 'rb')
 
1141
        try:
 
1142
            s = f.read()
 
1143
        finally:
 
1144
            f.close()
 
1145
        self.assertEqualDiff(content, s)
 
1146
 
 
1147
    def failUnlessExists(self, path):
 
1148
        """Fail unless path or paths, which may be abs or relative, exist."""
 
1149
        if not isinstance(path, basestring):
 
1150
            for p in path:
 
1151
                self.failUnlessExists(p)
 
1152
        else:
 
1153
            self.failUnless(osutils.lexists(path),path+" does not exist")
 
1154
 
 
1155
    def failIfExists(self, path):
 
1156
        """Fail if path or paths, which may be abs or relative, exist."""
 
1157
        if not isinstance(path, basestring):
 
1158
            for p in path:
 
1159
                self.failIfExists(p)
 
1160
        else:
 
1161
            self.failIf(osutils.lexists(path),path+" exists")
 
1162
 
 
1163
    def _capture_deprecation_warnings(self, a_callable, *args, **kwargs):
 
1164
        """A helper for callDeprecated and applyDeprecated.
 
1165
 
 
1166
        :param a_callable: A callable to call.
 
1167
        :param args: The positional arguments for the callable
 
1168
        :param kwargs: The keyword arguments for the callable
 
1169
        :return: A tuple (warnings, result). result is the result of calling
 
1170
            a_callable(``*args``, ``**kwargs``).
 
1171
        """
 
1172
        local_warnings = []
 
1173
        def capture_warnings(msg, cls=None, stacklevel=None):
 
1174
            # we've hooked into a deprecation specific callpath,
 
1175
            # only deprecations should getting sent via it.
 
1176
            self.assertEqual(cls, DeprecationWarning)
 
1177
            local_warnings.append(msg)
 
1178
        original_warning_method = symbol_versioning.warn
 
1179
        symbol_versioning.set_warning_method(capture_warnings)
 
1180
        try:
 
1181
            result = a_callable(*args, **kwargs)
 
1182
        finally:
 
1183
            symbol_versioning.set_warning_method(original_warning_method)
 
1184
        return (local_warnings, result)
 
1185
 
 
1186
    def applyDeprecated(self, deprecation_format, a_callable, *args, **kwargs):
 
1187
        """Call a deprecated callable without warning the user.
 
1188
 
 
1189
        Note that this only captures warnings raised by symbol_versioning.warn,
 
1190
        not other callers that go direct to the warning module.
 
1191
 
 
1192
        To test that a deprecated method raises an error, do something like
 
1193
        this::
 
1194
 
 
1195
            self.assertRaises(errors.ReservedId,
 
1196
                self.applyDeprecated,
 
1197
                deprecated_in((1, 5, 0)),
 
1198
                br.append_revision,
 
1199
                'current:')
 
1200
 
 
1201
        :param deprecation_format: The deprecation format that the callable
 
1202
            should have been deprecated with. This is the same type as the
 
1203
            parameter to deprecated_method/deprecated_function. If the
 
1204
            callable is not deprecated with this format, an assertion error
 
1205
            will be raised.
 
1206
        :param a_callable: A callable to call. This may be a bound method or
 
1207
            a regular function. It will be called with ``*args`` and
 
1208
            ``**kwargs``.
 
1209
        :param args: The positional arguments for the callable
 
1210
        :param kwargs: The keyword arguments for the callable
 
1211
        :return: The result of a_callable(``*args``, ``**kwargs``)
 
1212
        """
 
1213
        call_warnings, result = self._capture_deprecation_warnings(a_callable,
 
1214
            *args, **kwargs)
 
1215
        expected_first_warning = symbol_versioning.deprecation_string(
 
1216
            a_callable, deprecation_format)
 
1217
        if len(call_warnings) == 0:
 
1218
            self.fail("No deprecation warning generated by call to %s" %
 
1219
                a_callable)
 
1220
        self.assertEqual(expected_first_warning, call_warnings[0])
 
1221
        return result
 
1222
 
 
1223
    def callCatchWarnings(self, fn, *args, **kw):
 
1224
        """Call a callable that raises python warnings.
 
1225
 
 
1226
        The caller's responsible for examining the returned warnings.
 
1227
 
 
1228
        If the callable raises an exception, the exception is not
 
1229
        caught and propagates up to the caller.  In that case, the list
 
1230
        of warnings is not available.
 
1231
 
 
1232
        :returns: ([warning_object, ...], fn_result)
 
1233
        """
 
1234
        # XXX: This is not perfect, because it completely overrides the
 
1235
        # warnings filters, and some code may depend on suppressing particular
 
1236
        # warnings.  It's the easiest way to insulate ourselves from -Werror,
 
1237
        # though.  -- Andrew, 20071062
 
1238
        wlist = []
 
1239
        def _catcher(message, category, filename, lineno, file=None, line=None):
 
1240
            # despite the name, 'message' is normally(?) a Warning subclass
 
1241
            # instance
 
1242
            wlist.append(message)
 
1243
        saved_showwarning = warnings.showwarning
 
1244
        saved_filters = warnings.filters
 
1245
        try:
 
1246
            warnings.showwarning = _catcher
 
1247
            warnings.filters = []
 
1248
            result = fn(*args, **kw)
 
1249
        finally:
 
1250
            warnings.showwarning = saved_showwarning
 
1251
            warnings.filters = saved_filters
 
1252
        return wlist, result
 
1253
 
 
1254
    def callDeprecated(self, expected, callable, *args, **kwargs):
 
1255
        """Assert that a callable is deprecated in a particular way.
 
1256
 
 
1257
        This is a very precise test for unusual requirements. The
 
1258
        applyDeprecated helper function is probably more suited for most tests
 
1259
        as it allows you to simply specify the deprecation format being used
 
1260
        and will ensure that that is issued for the function being called.
 
1261
 
 
1262
        Note that this only captures warnings raised by symbol_versioning.warn,
 
1263
        not other callers that go direct to the warning module.  To catch
 
1264
        general warnings, use callCatchWarnings.
 
1265
 
 
1266
        :param expected: a list of the deprecation warnings expected, in order
 
1267
        :param callable: The callable to call
 
1268
        :param args: The positional arguments for the callable
 
1269
        :param kwargs: The keyword arguments for the callable
 
1270
        """
 
1271
        call_warnings, result = self._capture_deprecation_warnings(callable,
 
1272
            *args, **kwargs)
 
1273
        self.assertEqual(expected, call_warnings)
 
1274
        return result
 
1275
 
555
1276
    def _startLogFile(self):
556
1277
        """Send bzr and test log messages to a temporary file.
557
1278
 
558
1279
        The file is removed as the test is torn down.
559
1280
        """
560
1281
        fileno, name = tempfile.mkstemp(suffix='.log', prefix='testbzr')
561
 
        encoder, decoder, stream_reader, stream_writer = codecs.lookup('UTF-8')
562
 
        self._log_file = stream_writer(os.fdopen(fileno, 'w+'))
563
 
        self._log_nonce = bzrlib.trace.enable_test_log(self._log_file)
 
1282
        self._log_file = os.fdopen(fileno, 'w+')
 
1283
        self._log_memento = bzrlib.trace.push_log_file(self._log_file)
564
1284
        self._log_file_name = name
565
1285
        self.addCleanup(self._finishLogFile)
566
1286
 
567
1287
    def _finishLogFile(self):
568
1288
        """Finished with the log file.
569
1289
 
570
 
        Read contents into memory, close, and delete.
 
1290
        Close the file and delete it, unless setKeepLogfile was called.
571
1291
        """
572
1292
        if self._log_file is None:
573
1293
            return
574
 
        bzrlib.trace.disable_test_log(self._log_nonce)
575
 
        self._log_file.seek(0)
576
 
        self._log_contents = self._log_file.read()
 
1294
        bzrlib.trace.pop_log_file(self._log_memento)
577
1295
        self._log_file.close()
578
 
        os.remove(self._log_file_name)
579
 
        self._log_file = self._log_file_name = None
580
 
 
581
 
    def addCleanup(self, callable):
 
1296
        self._log_file = None
 
1297
        if not self._keep_log_file:
 
1298
            os.remove(self._log_file_name)
 
1299
            self._log_file_name = None
 
1300
 
 
1301
    def setKeepLogfile(self):
 
1302
        """Make the logfile not be deleted when _finishLogFile is called."""
 
1303
        self._keep_log_file = True
 
1304
 
 
1305
    def addCleanup(self, callable, *args, **kwargs):
582
1306
        """Arrange to run a callable when this case is torn down.
583
1307
 
584
 
        Callables are run in the reverse of the order they are registered, 
 
1308
        Callables are run in the reverse of the order they are registered,
585
1309
        ie last-in first-out.
586
1310
        """
587
 
        if callable in self._cleanups:
588
 
            raise ValueError("cleanup function %r already registered on %s" 
589
 
                    % (callable, self))
590
 
        self._cleanups.append(callable)
 
1311
        self._cleanups.append((callable, args, kwargs))
591
1312
 
592
1313
    def _cleanEnvironment(self):
593
1314
        new_env = {
 
1315
            'BZR_HOME': None, # Don't inherit BZR_HOME to all the tests.
594
1316
            'HOME': os.getcwd(),
595
 
            'APPDATA': os.getcwd(),
 
1317
            # bzr now uses the Win32 API and doesn't rely on APPDATA, but the
 
1318
            # tests do check our impls match APPDATA
 
1319
            'BZR_EDITOR': None, # test_msgeditor manipulates this variable
 
1320
            'VISUAL': None,
 
1321
            'EDITOR': None,
596
1322
            'BZR_EMAIL': None,
597
1323
            'BZREMAIL': None, # may still be present in the environment
598
1324
            'EMAIL': None,
 
1325
            'BZR_PROGRESS_BAR': None,
 
1326
            'BZR_LOG': None,
 
1327
            'BZR_PLUGIN_PATH': None,
 
1328
            # SSH Agent
 
1329
            'SSH_AUTH_SOCK': None,
 
1330
            # Proxies
 
1331
            'http_proxy': None,
 
1332
            'HTTP_PROXY': None,
 
1333
            'https_proxy': None,
 
1334
            'HTTPS_PROXY': None,
 
1335
            'no_proxy': None,
 
1336
            'NO_PROXY': None,
 
1337
            'all_proxy': None,
 
1338
            'ALL_PROXY': None,
 
1339
            # Nobody cares about ftp_proxy, FTP_PROXY AFAIK. So far at
 
1340
            # least. If you do (care), please update this comment
 
1341
            # -- vila 20080401
 
1342
            'ftp_proxy': None,
 
1343
            'FTP_PROXY': None,
 
1344
            'BZR_REMOTE_PATH': None,
599
1345
        }
600
1346
        self.__old_env = {}
601
1347
        self.addCleanup(self._restoreEnvironment)
602
1348
        for name, value in new_env.iteritems():
603
1349
            self._captureVar(name, value)
604
1350
 
605
 
 
606
1351
    def _captureVar(self, name, newvalue):
607
 
        """Set an environment variable, preparing it to be reset when finished."""
608
 
        self.__old_env[name] = os.environ.get(name, None)
609
 
        if newvalue is None:
610
 
            if name in os.environ:
611
 
                del os.environ[name]
612
 
        else:
613
 
            os.environ[name] = newvalue
 
1352
        """Set an environment variable, and reset it when finished."""
 
1353
        self.__old_env[name] = osutils.set_or_unset_env(name, newvalue)
614
1354
 
615
 
    @staticmethod
616
 
    def _restoreVar(name, value):
617
 
        if value is None:
618
 
            if name in os.environ:
619
 
                del os.environ[name]
620
 
        else:
621
 
            os.environ[name] = value
 
1355
    def _restore_debug_flags(self):
 
1356
        debug.debug_flags.clear()
 
1357
        debug.debug_flags.update(self._preserved_debug_flags)
622
1358
 
623
1359
    def _restoreEnvironment(self):
624
1360
        for name, value in self.__old_env.iteritems():
625
 
            self._restoreVar(name, value)
 
1361
            osutils.set_or_unset_env(name, value)
 
1362
 
 
1363
    def _restoreHooks(self):
 
1364
        for klass, (name, hooks) in self._preserved_hooks.items():
 
1365
            setattr(klass, name, hooks)
 
1366
 
 
1367
    def knownFailure(self, reason):
 
1368
        """This test has failed for some known reason."""
 
1369
        raise KnownFailure(reason)
 
1370
 
 
1371
    def _do_skip(self, result, reason):
 
1372
        addSkip = getattr(result, 'addSkip', None)
 
1373
        if not callable(addSkip):
 
1374
            result.addError(self, sys.exc_info())
 
1375
        else:
 
1376
            addSkip(self, reason)
 
1377
 
 
1378
    def run(self, result=None):
 
1379
        if result is None: result = self.defaultTestResult()
 
1380
        for feature in getattr(self, '_test_needs_features', []):
 
1381
            if not feature.available():
 
1382
                result.startTest(self)
 
1383
                if getattr(result, 'addNotSupported', None):
 
1384
                    result.addNotSupported(self, feature)
 
1385
                else:
 
1386
                    result.addSuccess(self)
 
1387
                result.stopTest(self)
 
1388
                return result
 
1389
        try:
 
1390
            try:
 
1391
                result.startTest(self)
 
1392
                absent_attr = object()
 
1393
                # Python 2.5
 
1394
                method_name = getattr(self, '_testMethodName', absent_attr)
 
1395
                if method_name is absent_attr:
 
1396
                    # Python 2.4
 
1397
                    method_name = getattr(self, '_TestCase__testMethodName')
 
1398
                testMethod = getattr(self, method_name)
 
1399
                try:
 
1400
                    try:
 
1401
                        self.setUp()
 
1402
                        if not self._bzr_test_setUp_run:
 
1403
                            self.fail(
 
1404
                                "test setUp did not invoke "
 
1405
                                "bzrlib.tests.TestCase's setUp")
 
1406
                    except KeyboardInterrupt:
 
1407
                        self._runCleanups()
 
1408
                        raise
 
1409
                    except TestSkipped, e:
 
1410
                        self._do_skip(result, e.args[0])
 
1411
                        self.tearDown()
 
1412
                        return result
 
1413
                    except:
 
1414
                        result.addError(self, sys.exc_info())
 
1415
                        self._runCleanups()
 
1416
                        return result
 
1417
 
 
1418
                    ok = False
 
1419
                    try:
 
1420
                        testMethod()
 
1421
                        ok = True
 
1422
                    except self.failureException:
 
1423
                        result.addFailure(self, sys.exc_info())
 
1424
                    except TestSkipped, e:
 
1425
                        if not e.args:
 
1426
                            reason = "No reason given."
 
1427
                        else:
 
1428
                            reason = e.args[0]
 
1429
                        self._do_skip(result, reason)
 
1430
                    except KeyboardInterrupt:
 
1431
                        self._runCleanups()
 
1432
                        raise
 
1433
                    except:
 
1434
                        result.addError(self, sys.exc_info())
 
1435
 
 
1436
                    try:
 
1437
                        self.tearDown()
 
1438
                        if not self._bzr_test_tearDown_run:
 
1439
                            self.fail(
 
1440
                                "test tearDown did not invoke "
 
1441
                                "bzrlib.tests.TestCase's tearDown")
 
1442
                    except KeyboardInterrupt:
 
1443
                        self._runCleanups()
 
1444
                        raise
 
1445
                    except:
 
1446
                        result.addError(self, sys.exc_info())
 
1447
                        self._runCleanups()
 
1448
                        ok = False
 
1449
                    if ok: result.addSuccess(self)
 
1450
                finally:
 
1451
                    result.stopTest(self)
 
1452
                return result
 
1453
            except TestNotApplicable:
 
1454
                # Not moved from the result [yet].
 
1455
                self._runCleanups()
 
1456
                raise
 
1457
            except KeyboardInterrupt:
 
1458
                self._runCleanups()
 
1459
                raise
 
1460
        finally:
 
1461
            saved_attrs = {}
 
1462
            for attr_name in self.attrs_to_keep:
 
1463
                if attr_name in self.__dict__:
 
1464
                    saved_attrs[attr_name] = self.__dict__[attr_name]
 
1465
            self.__dict__ = saved_attrs
626
1466
 
627
1467
    def tearDown(self):
628
1468
        self._runCleanups()
 
1469
        self._log_contents = ''
 
1470
        self._bzr_test_tearDown_run = True
629
1471
        unittest.TestCase.tearDown(self)
630
1472
 
631
1473
    def time(self, callable, *args, **kwargs):
632
1474
        """Run callable and accrue the time it takes to the benchmark time.
633
 
        
 
1475
 
634
1476
        If lsprofiling is enabled (i.e. by --lsprof-time to bzr selftest) then
635
1477
        this will cause lsprofile statistics to be gathered and stored in
636
1478
        self._benchcalls.
651
1493
            self._benchtime += time.time() - start
652
1494
 
653
1495
    def _runCleanups(self):
654
 
        """Run registered cleanup functions. 
 
1496
        """Run registered cleanup functions.
655
1497
 
656
1498
        This should only be called from TestCase.tearDown.
657
1499
        """
658
 
        # TODO: Perhaps this should keep running cleanups even if 
 
1500
        # TODO: Perhaps this should keep running cleanups even if
659
1501
        # one of them fails?
660
 
        for cleanup_fn in reversed(self._cleanups):
661
 
            cleanup_fn()
 
1502
 
 
1503
        # Actually pop the cleanups from the list so tearDown running
 
1504
        # twice is safe (this happens for skipped tests).
 
1505
        while self._cleanups:
 
1506
            cleanup, args, kwargs = self._cleanups.pop()
 
1507
            cleanup(*args, **kwargs)
662
1508
 
663
1509
    def log(self, *args):
664
1510
        mutter(*args)
665
1511
 
666
 
    def _get_log(self):
667
 
        """Return as a string the log for this test"""
668
 
        if self._log_file_name:
669
 
            return open(self._log_file_name).read()
670
 
        else:
 
1512
    def _get_log(self, keep_log_file=False):
 
1513
        """Get the log from bzrlib.trace calls from this test.
 
1514
 
 
1515
        :param keep_log_file: When True, if the log is still a file on disk
 
1516
            leave it as a file on disk. When False, if the log is still a file
 
1517
            on disk, the log file is deleted and the log preserved as
 
1518
            self._log_contents.
 
1519
        :return: A string containing the log.
 
1520
        """
 
1521
        # flush the log file, to get all content
 
1522
        import bzrlib.trace
 
1523
        if bzrlib.trace._trace_file:
 
1524
            bzrlib.trace._trace_file.flush()
 
1525
        if self._log_contents:
 
1526
            # XXX: this can hardly contain the content flushed above --vila
 
1527
            # 20080128
671
1528
            return self._log_contents
672
 
        # TODO: Delete the log after it's been read in
673
 
 
674
 
    def capture(self, cmd, retcode=0):
675
 
        """Shortcut that splits cmd into words, runs, and returns stdout"""
676
 
        return self.run_bzr_captured(cmd.split(), retcode=retcode)[0]
677
 
 
678
 
    def run_bzr_captured(self, argv, retcode=0, encoding=None, stdin=None):
679
 
        """Invoke bzr and return (stdout, stderr).
680
 
 
681
 
        Useful for code that wants to check the contents of the
682
 
        output, the way error messages are presented, etc.
683
 
 
684
 
        This should be the main method for tests that want to exercise the
685
 
        overall behavior of the bzr application (rather than a unit test
686
 
        or a functional test of the library.)
687
 
 
688
 
        Much of the old code runs bzr by forking a new copy of Python, but
689
 
        that is slower, harder to debug, and generally not necessary.
690
 
 
691
 
        This runs bzr through the interface that catches and reports
692
 
        errors, and with logging set to something approximating the
693
 
        default, so that error reporting can be checked.
694
 
 
695
 
        :param argv: arguments to invoke bzr
696
 
        :param retcode: expected return code, or None for don't-care.
697
 
        :param encoding: encoding for sys.stdout and sys.stderr
698
 
        :param stdin: A string to be used as stdin for the command.
 
1529
        if self._log_file_name is not None:
 
1530
            logfile = open(self._log_file_name)
 
1531
            try:
 
1532
                log_contents = logfile.read()
 
1533
            finally:
 
1534
                logfile.close()
 
1535
            if not keep_log_file:
 
1536
                self._log_contents = log_contents
 
1537
                try:
 
1538
                    os.remove(self._log_file_name)
 
1539
                except OSError, e:
 
1540
                    if sys.platform == 'win32' and e.errno == errno.EACCES:
 
1541
                        sys.stderr.write(('Unable to delete log file '
 
1542
                                             ' %r\n' % self._log_file_name))
 
1543
                    else:
 
1544
                        raise
 
1545
            return log_contents
 
1546
        else:
 
1547
            return "DELETED log file to reduce memory footprint"
 
1548
 
 
1549
    def requireFeature(self, feature):
 
1550
        """This test requires a specific feature is available.
 
1551
 
 
1552
        :raises UnavailableFeature: When feature is not available.
699
1553
        """
 
1554
        if not feature.available():
 
1555
            raise UnavailableFeature(feature)
 
1556
 
 
1557
    def _run_bzr_autosplit(self, args, retcode, encoding, stdin,
 
1558
            working_dir):
 
1559
        """Run bazaar command line, splitting up a string command line."""
 
1560
        if isinstance(args, basestring):
 
1561
            # shlex don't understand unicode strings,
 
1562
            # so args should be plain string (bialix 20070906)
 
1563
            args = list(shlex.split(str(args)))
 
1564
        return self._run_bzr_core(args, retcode=retcode,
 
1565
                encoding=encoding, stdin=stdin, working_dir=working_dir,
 
1566
                )
 
1567
 
 
1568
    def _run_bzr_core(self, args, retcode, encoding, stdin,
 
1569
            working_dir):
700
1570
        if encoding is None:
701
 
            encoding = bzrlib.user_encoding
702
 
        if stdin is not None:
703
 
            stdin = StringIO(stdin)
 
1571
            encoding = osutils.get_user_encoding()
704
1572
        stdout = StringIOWrapper()
705
1573
        stderr = StringIOWrapper()
706
1574
        stdout.encoding = encoding
707
1575
        stderr.encoding = encoding
708
1576
 
709
 
        self.log('run bzr: %r', argv)
 
1577
        self.log('run bzr: %r', args)
710
1578
        # FIXME: don't call into logging here
711
1579
        handler = logging.StreamHandler(stderr)
712
1580
        handler.setLevel(logging.INFO)
713
1581
        logger = logging.getLogger('')
714
1582
        logger.addHandler(handler)
715
 
        old_ui_factory = bzrlib.ui.ui_factory
716
 
        bzrlib.ui.ui_factory = bzrlib.tests.blackbox.TestUIFactory(
717
 
            stdout=stdout,
718
 
            stderr=stderr)
719
 
        bzrlib.ui.ui_factory.stdin = stdin
 
1583
        old_ui_factory = ui.ui_factory
 
1584
        ui.ui_factory = TestUIFactory(stdin=stdin, stdout=stdout, stderr=stderr)
 
1585
 
 
1586
        cwd = None
 
1587
        if working_dir is not None:
 
1588
            cwd = osutils.getcwd()
 
1589
            os.chdir(working_dir)
 
1590
 
720
1591
        try:
721
 
            result = self.apply_redirected(stdin, stdout, stderr,
722
 
                                           bzrlib.commands.run_bzr_catch_errors,
723
 
                                           argv)
 
1592
            result = self.apply_redirected(ui.ui_factory.stdin,
 
1593
                stdout, stderr,
 
1594
                bzrlib.commands.run_bzr_catch_user_errors,
 
1595
                args)
724
1596
        finally:
725
1597
            logger.removeHandler(handler)
726
 
            bzrlib.ui.ui_factory = old_ui_factory
 
1598
            ui.ui_factory = old_ui_factory
 
1599
            if cwd is not None:
 
1600
                os.chdir(cwd)
727
1601
 
728
1602
        out = stdout.getvalue()
729
1603
        err = stderr.getvalue()
732
1606
        if err:
733
1607
            self.log('errors:\n%r', err)
734
1608
        if retcode is not None:
735
 
            self.assertEquals(retcode, result)
 
1609
            self.assertEquals(retcode, result,
 
1610
                              message='Unexpected return code')
736
1611
        return out, err
737
1612
 
738
 
    def run_bzr(self, *args, **kwargs):
 
1613
    def run_bzr(self, args, retcode=0, encoding=None, stdin=None,
 
1614
                working_dir=None, error_regexes=[], output_encoding=None):
739
1615
        """Invoke bzr, as if it were run from the command line.
740
1616
 
 
1617
        The argument list should not include the bzr program name - the
 
1618
        first argument is normally the bzr command.  Arguments may be
 
1619
        passed in three ways:
 
1620
 
 
1621
        1- A list of strings, eg ["commit", "a"].  This is recommended
 
1622
        when the command contains whitespace or metacharacters, or
 
1623
        is built up at run time.
 
1624
 
 
1625
        2- A single string, eg "add a".  This is the most convenient
 
1626
        for hardcoded commands.
 
1627
 
 
1628
        This runs bzr through the interface that catches and reports
 
1629
        errors, and with logging set to something approximating the
 
1630
        default, so that error reporting can be checked.
 
1631
 
741
1632
        This should be the main method for tests that want to exercise the
742
1633
        overall behavior of the bzr application (rather than a unit test
743
1634
        or a functional test of the library.)
745
1636
        This sends the stdout/stderr results into the test's log,
746
1637
        where it may be useful for debugging.  See also run_captured.
747
1638
 
748
 
        :param stdin: A string to be used as stdin for the command.
 
1639
        :keyword stdin: A string to be used as stdin for the command.
 
1640
        :keyword retcode: The status code the command should return;
 
1641
            default 0.
 
1642
        :keyword working_dir: The directory to run the command in
 
1643
        :keyword error_regexes: A list of expected error messages.  If
 
1644
            specified they must be seen in the error output of the command.
749
1645
        """
750
 
        retcode = kwargs.pop('retcode', 0)
751
 
        encoding = kwargs.pop('encoding', None)
752
 
        stdin = kwargs.pop('stdin', None)
753
 
        return self.run_bzr_captured(args, retcode=retcode, encoding=encoding, stdin=stdin)
754
 
 
755
 
    def run_bzr_decode(self, *args, **kwargs):
756
 
        if kwargs.has_key('encoding'):
757
 
            encoding = kwargs['encoding']
758
 
        else:
759
 
            encoding = bzrlib.user_encoding
760
 
        return self.run_bzr(*args, **kwargs)[0].decode(encoding)
 
1646
        out, err = self._run_bzr_autosplit(
 
1647
            args=args,
 
1648
            retcode=retcode,
 
1649
            encoding=encoding,
 
1650
            stdin=stdin,
 
1651
            working_dir=working_dir,
 
1652
            )
 
1653
        self.assertIsInstance(error_regexes, (list, tuple))
 
1654
        for regex in error_regexes:
 
1655
            self.assertContainsRe(err, regex)
 
1656
        return out, err
761
1657
 
762
1658
    def run_bzr_error(self, error_regexes, *args, **kwargs):
763
1659
        """Run bzr, and check that stderr contains the supplied regexes
764
 
        
765
 
        :param error_regexes: Sequence of regular expressions which 
 
1660
 
 
1661
        :param error_regexes: Sequence of regular expressions which
766
1662
            must each be found in the error output. The relative ordering
767
1663
            is not enforced.
768
1664
        :param args: command-line arguments for bzr
769
1665
        :param kwargs: Keyword arguments which are interpreted by run_bzr
770
1666
            This function changes the default value of retcode to be 3,
771
1667
            since in most cases this is run when you expect bzr to fail.
772
 
        :return: (out, err) The actual output of running the command (in case you
773
 
                 want to do more inspection)
774
 
 
775
 
        Examples of use:
 
1668
 
 
1669
        :return: (out, err) The actual output of running the command (in case
 
1670
            you want to do more inspection)
 
1671
 
 
1672
        Examples of use::
 
1673
 
776
1674
            # Make sure that commit is failing because there is nothing to do
777
1675
            self.run_bzr_error(['no changes to commit'],
778
 
                               'commit', '-m', 'my commit comment')
 
1676
                               ['commit', '-m', 'my commit comment'])
779
1677
            # Make sure --strict is handling an unknown file, rather than
780
1678
            # giving us the 'nothing to do' error
781
1679
            self.build_tree(['unknown'])
782
1680
            self.run_bzr_error(['Commit refused because there are unknown files'],
783
 
                               'commit', '--strict', '-m', 'my commit comment')
 
1681
                               ['commit', --strict', '-m', 'my commit comment'])
784
1682
        """
785
1683
        kwargs.setdefault('retcode', 3)
 
1684
        kwargs['error_regexes'] = error_regexes
786
1685
        out, err = self.run_bzr(*args, **kwargs)
787
 
        for regex in error_regexes:
788
 
            self.assertContainsRe(err, regex)
789
1686
        return out, err
790
1687
 
791
1688
    def run_bzr_subprocess(self, *args, **kwargs):
792
1689
        """Run bzr in a subprocess for testing.
793
1690
 
794
 
        This starts a new Python interpreter and runs bzr in there. 
795
 
        This should only be used for tests that have a justifiable need for
796
 
        this isolation: e.g. they are testing startup time, or signal
797
 
        handling, or early startup code, etc.  Subprocess code can't be 
798
 
        profiled or debugged so easily.
799
 
 
 
1691
        This starts a new Python interpreter and runs bzr in there.
 
1692
        This should only be used for tests that have a justifiable need for
 
1693
        this isolation: e.g. they are testing startup time, or signal
 
1694
        handling, or early startup code, etc.  Subprocess code can't be
 
1695
        profiled or debugged so easily.
 
1696
 
 
1697
        :keyword retcode: The status code that is expected.  Defaults to 0.  If
 
1698
            None is supplied, the status code is not checked.
 
1699
        :keyword env_changes: A dictionary which lists changes to environment
 
1700
            variables. A value of None will unset the env variable.
 
1701
            The values must be strings. The change will only occur in the
 
1702
            child, so you don't need to fix the environment after running.
 
1703
        :keyword universal_newlines: Convert CRLF => LF
 
1704
        :keyword allow_plugins: By default the subprocess is run with
 
1705
            --no-plugins to ensure test reproducibility. Also, it is possible
 
1706
            for system-wide plugins to create unexpected output on stderr,
 
1707
            which can cause unnecessary test failures.
 
1708
        """
 
1709
        env_changes = kwargs.get('env_changes', {})
 
1710
        working_dir = kwargs.get('working_dir', None)
 
1711
        allow_plugins = kwargs.get('allow_plugins', False)
 
1712
        if len(args) == 1:
 
1713
            if isinstance(args[0], list):
 
1714
                args = args[0]
 
1715
            elif isinstance(args[0], basestring):
 
1716
                args = list(shlex.split(args[0]))
 
1717
        else:
 
1718
            raise ValueError("passing varargs to run_bzr_subprocess")
 
1719
        process = self.start_bzr_subprocess(args, env_changes=env_changes,
 
1720
                                            working_dir=working_dir,
 
1721
                                            allow_plugins=allow_plugins)
 
1722
        # We distinguish between retcode=None and retcode not passed.
 
1723
        supplied_retcode = kwargs.get('retcode', 0)
 
1724
        return self.finish_bzr_subprocess(process, retcode=supplied_retcode,
 
1725
            universal_newlines=kwargs.get('universal_newlines', False),
 
1726
            process_args=args)
 
1727
 
 
1728
    def start_bzr_subprocess(self, process_args, env_changes=None,
 
1729
                             skip_if_plan_to_signal=False,
 
1730
                             working_dir=None,
 
1731
                             allow_plugins=False):
 
1732
        """Start bzr in a subprocess for testing.
 
1733
 
 
1734
        This starts a new Python interpreter and runs bzr in there.
 
1735
        This should only be used for tests that have a justifiable need for
 
1736
        this isolation: e.g. they are testing startup time, or signal
 
1737
        handling, or early startup code, etc.  Subprocess code can't be
 
1738
        profiled or debugged so easily.
 
1739
 
 
1740
        :param process_args: a list of arguments to pass to the bzr executable,
 
1741
            for example ``['--version']``.
 
1742
        :param env_changes: A dictionary which lists changes to environment
 
1743
            variables. A value of None will unset the env variable.
 
1744
            The values must be strings. The change will only occur in the
 
1745
            child, so you don't need to fix the environment after running.
 
1746
        :param skip_if_plan_to_signal: raise TestSkipped when true and os.kill
 
1747
            is not available.
 
1748
        :param allow_plugins: If False (default) pass --no-plugins to bzr.
 
1749
 
 
1750
        :returns: Popen object for the started process.
 
1751
        """
 
1752
        if skip_if_plan_to_signal:
 
1753
            if not getattr(os, 'kill', None):
 
1754
                raise TestSkipped("os.kill not available.")
 
1755
 
 
1756
        if env_changes is None:
 
1757
            env_changes = {}
 
1758
        old_env = {}
 
1759
 
 
1760
        def cleanup_environment():
 
1761
            for env_var, value in env_changes.iteritems():
 
1762
                old_env[env_var] = osutils.set_or_unset_env(env_var, value)
 
1763
 
 
1764
        def restore_environment():
 
1765
            for env_var, value in old_env.iteritems():
 
1766
                osutils.set_or_unset_env(env_var, value)
 
1767
 
 
1768
        bzr_path = self.get_bzr_path()
 
1769
 
 
1770
        cwd = None
 
1771
        if working_dir is not None:
 
1772
            cwd = osutils.getcwd()
 
1773
            os.chdir(working_dir)
 
1774
 
 
1775
        try:
 
1776
            # win32 subprocess doesn't support preexec_fn
 
1777
            # so we will avoid using it on all platforms, just to
 
1778
            # make sure the code path is used, and we don't break on win32
 
1779
            cleanup_environment()
 
1780
            command = [sys.executable]
 
1781
            # frozen executables don't need the path to bzr
 
1782
            if getattr(sys, "frozen", None) is None:
 
1783
                command.append(bzr_path)
 
1784
            if not allow_plugins:
 
1785
                command.append('--no-plugins')
 
1786
            command.extend(process_args)
 
1787
            process = self._popen(command, stdin=PIPE, stdout=PIPE, stderr=PIPE)
 
1788
        finally:
 
1789
            restore_environment()
 
1790
            if cwd is not None:
 
1791
                os.chdir(cwd)
 
1792
 
 
1793
        return process
 
1794
 
 
1795
    def _popen(self, *args, **kwargs):
 
1796
        """Place a call to Popen.
 
1797
 
 
1798
        Allows tests to override this method to intercept the calls made to
 
1799
        Popen for introspection.
 
1800
        """
 
1801
        return Popen(*args, **kwargs)
 
1802
 
 
1803
    def get_bzr_path(self):
 
1804
        """Return the path of the 'bzr' executable for this test suite."""
 
1805
        bzr_path = os.path.dirname(os.path.dirname(bzrlib.__file__))+'/bzr'
 
1806
        if not os.path.isfile(bzr_path):
 
1807
            # We are probably installed. Assume sys.argv is the right file
 
1808
            bzr_path = sys.argv[0]
 
1809
        return bzr_path
 
1810
 
 
1811
    def finish_bzr_subprocess(self, process, retcode=0, send_signal=None,
 
1812
                              universal_newlines=False, process_args=None):
 
1813
        """Finish the execution of process.
 
1814
 
 
1815
        :param process: the Popen object returned from start_bzr_subprocess.
800
1816
        :param retcode: The status code that is expected.  Defaults to 0.  If
801
 
        None is supplied, the status code is not checked.
 
1817
            None is supplied, the status code is not checked.
 
1818
        :param send_signal: an optional signal to send to the process.
 
1819
        :param universal_newlines: Convert CRLF => LF
 
1820
        :returns: (stdout, stderr)
802
1821
        """
803
 
        bzr_path = os.path.dirname(os.path.dirname(bzrlib.__file__))+'/bzr'
804
 
        args = list(args)
805
 
        process = Popen([sys.executable, bzr_path]+args, stdout=PIPE, 
806
 
                         stderr=PIPE)
807
 
        out = process.stdout.read()
808
 
        err = process.stderr.read()
809
 
        retcode = process.wait()
810
 
        supplied_retcode = kwargs.get('retcode', 0)
811
 
        if supplied_retcode is not None:
812
 
            assert supplied_retcode == retcode
 
1822
        if send_signal is not None:
 
1823
            os.kill(process.pid, send_signal)
 
1824
        out, err = process.communicate()
 
1825
 
 
1826
        if universal_newlines:
 
1827
            out = out.replace('\r\n', '\n')
 
1828
            err = err.replace('\r\n', '\n')
 
1829
 
 
1830
        if retcode is not None and retcode != process.returncode:
 
1831
            if process_args is None:
 
1832
                process_args = "(unknown args)"
 
1833
            mutter('Output of bzr %s:\n%s', process_args, out)
 
1834
            mutter('Error for bzr %s:\n%s', process_args, err)
 
1835
            self.fail('Command bzr %s failed with retcode %s != %s'
 
1836
                      % (process_args, retcode, process.returncode))
813
1837
        return [out, err]
814
1838
 
815
1839
    def check_inventory_shape(self, inv, shape):
821
1845
        shape = list(shape)             # copy
822
1846
        for path, ie in inv.entries():
823
1847
            name = path.replace('\\', '/')
824
 
            if ie.kind == 'dir':
 
1848
            if ie.kind == 'directory':
825
1849
                name = name + '/'
826
1850
            if name in shape:
827
1851
                shape.remove(name)
864
1888
            sys.stderr = real_stderr
865
1889
            sys.stdin = real_stdin
866
1890
 
867
 
    def merge(self, branch_from, wt_to):
868
 
        """A helper for tests to do a ui-less merge.
869
 
 
870
 
        This should move to the main library when someone has time to integrate
871
 
        it in.
872
 
        """
873
 
        # minimal ui-less merge.
874
 
        wt_to.branch.fetch(branch_from)
875
 
        base_rev = common_ancestor(branch_from.last_revision(),
876
 
                                   wt_to.branch.last_revision(),
877
 
                                   wt_to.branch.repository)
878
 
        merge_inner(wt_to.branch, branch_from.basis_tree(), 
879
 
                    wt_to.branch.repository.revision_tree(base_rev),
880
 
                    this_tree=wt_to)
881
 
        wt_to.add_pending_merge(branch_from.last_revision())
882
 
 
883
 
 
884
 
BzrTestBase = TestCase
885
 
 
886
 
     
887
 
class TestCaseInTempDir(TestCase):
 
1891
    def reduceLockdirTimeout(self):
 
1892
        """Reduce the default lock timeout for the duration of the test, so that
 
1893
        if LockContention occurs during a test, it does so quickly.
 
1894
 
 
1895
        Tests that expect to provoke LockContention errors should call this.
 
1896
        """
 
1897
        orig_timeout = bzrlib.lockdir._DEFAULT_TIMEOUT_SECONDS
 
1898
        def resetTimeout():
 
1899
            bzrlib.lockdir._DEFAULT_TIMEOUT_SECONDS = orig_timeout
 
1900
        self.addCleanup(resetTimeout)
 
1901
        bzrlib.lockdir._DEFAULT_TIMEOUT_SECONDS = 0
 
1902
 
 
1903
    def make_utf8_encoded_stringio(self, encoding_type=None):
 
1904
        """Return a StringIOWrapper instance, that will encode Unicode
 
1905
        input to UTF-8.
 
1906
        """
 
1907
        if encoding_type is None:
 
1908
            encoding_type = 'strict'
 
1909
        sio = StringIO()
 
1910
        output_encoding = 'utf-8'
 
1911
        sio = codecs.getwriter(output_encoding)(sio, errors=encoding_type)
 
1912
        sio.encoding = output_encoding
 
1913
        return sio
 
1914
 
 
1915
 
 
1916
class CapturedCall(object):
 
1917
    """A helper for capturing smart server calls for easy debug analysis."""
 
1918
 
 
1919
    def __init__(self, params, prefix_length):
 
1920
        """Capture the call with params and skip prefix_length stack frames."""
 
1921
        self.call = params
 
1922
        import traceback
 
1923
        # The last 5 frames are the __init__, the hook frame, and 3 smart
 
1924
        # client frames. Beyond this we could get more clever, but this is good
 
1925
        # enough for now.
 
1926
        stack = traceback.extract_stack()[prefix_length:-5]
 
1927
        self.stack = ''.join(traceback.format_list(stack))
 
1928
 
 
1929
    def __str__(self):
 
1930
        return self.call.method
 
1931
 
 
1932
    def __repr__(self):
 
1933
        return self.call.method
 
1934
 
 
1935
    def stack(self):
 
1936
        return self.stack
 
1937
 
 
1938
 
 
1939
class TestCaseWithMemoryTransport(TestCase):
 
1940
    """Common test class for tests that do not need disk resources.
 
1941
 
 
1942
    Tests that need disk resources should derive from TestCaseWithTransport.
 
1943
 
 
1944
    TestCaseWithMemoryTransport sets the TEST_ROOT variable for all bzr tests.
 
1945
 
 
1946
    For TestCaseWithMemoryTransport the test_home_dir is set to the name of
 
1947
    a directory which does not exist. This serves to help ensure test isolation
 
1948
    is preserved. test_dir is set to the TEST_ROOT, as is cwd, because they
 
1949
    must exist. However, TestCaseWithMemoryTransport does not offer local
 
1950
    file defaults for the transport in tests, nor does it obey the command line
 
1951
    override, so tests that accidentally write to the common directory should
 
1952
    be rare.
 
1953
 
 
1954
    :cvar TEST_ROOT: Directory containing all temporary directories, plus
 
1955
    a .bzr directory that stops us ascending higher into the filesystem.
 
1956
    """
 
1957
 
 
1958
    TEST_ROOT = None
 
1959
    _TEST_NAME = 'test'
 
1960
 
 
1961
    def __init__(self, methodName='runTest'):
 
1962
        # allow test parameterization after test construction and before test
 
1963
        # execution. Variables that the parameterizer sets need to be
 
1964
        # ones that are not set by setUp, or setUp will trash them.
 
1965
        super(TestCaseWithMemoryTransport, self).__init__(methodName)
 
1966
        self.vfs_transport_factory = default_transport
 
1967
        self.transport_server = None
 
1968
        self.transport_readonly_server = None
 
1969
        self.__vfs_server = None
 
1970
 
 
1971
    def get_transport(self, relpath=None):
 
1972
        """Return a writeable transport.
 
1973
 
 
1974
        This transport is for the test scratch space relative to
 
1975
        "self._test_root"
 
1976
 
 
1977
        :param relpath: a path relative to the base url.
 
1978
        """
 
1979
        t = get_transport(self.get_url(relpath))
 
1980
        self.assertFalse(t.is_readonly())
 
1981
        return t
 
1982
 
 
1983
    def get_readonly_transport(self, relpath=None):
 
1984
        """Return a readonly transport for the test scratch space
 
1985
 
 
1986
        This can be used to test that operations which should only need
 
1987
        readonly access in fact do not try to write.
 
1988
 
 
1989
        :param relpath: a path relative to the base url.
 
1990
        """
 
1991
        t = get_transport(self.get_readonly_url(relpath))
 
1992
        self.assertTrue(t.is_readonly())
 
1993
        return t
 
1994
 
 
1995
    def create_transport_readonly_server(self):
 
1996
        """Create a transport server from class defined at init.
 
1997
 
 
1998
        This is mostly a hook for daughter classes.
 
1999
        """
 
2000
        return self.transport_readonly_server()
 
2001
 
 
2002
    def get_readonly_server(self):
 
2003
        """Get the server instance for the readonly transport
 
2004
 
 
2005
        This is useful for some tests with specific servers to do diagnostics.
 
2006
        """
 
2007
        if self.__readonly_server is None:
 
2008
            if self.transport_readonly_server is None:
 
2009
                # readonly decorator requested
 
2010
                # bring up the server
 
2011
                self.__readonly_server = ReadonlyServer()
 
2012
                self.__readonly_server.setUp(self.get_vfs_only_server())
 
2013
            else:
 
2014
                self.__readonly_server = self.create_transport_readonly_server()
 
2015
                self.__readonly_server.setUp(self.get_vfs_only_server())
 
2016
            self.addCleanup(self.__readonly_server.tearDown)
 
2017
        return self.__readonly_server
 
2018
 
 
2019
    def get_readonly_url(self, relpath=None):
 
2020
        """Get a URL for the readonly transport.
 
2021
 
 
2022
        This will either be backed by '.' or a decorator to the transport
 
2023
        used by self.get_url()
 
2024
        relpath provides for clients to get a path relative to the base url.
 
2025
        These should only be downwards relative, not upwards.
 
2026
        """
 
2027
        base = self.get_readonly_server().get_url()
 
2028
        return self._adjust_url(base, relpath)
 
2029
 
 
2030
    def get_vfs_only_server(self):
 
2031
        """Get the vfs only read/write server instance.
 
2032
 
 
2033
        This is useful for some tests with specific servers that need
 
2034
        diagnostics.
 
2035
 
 
2036
        For TestCaseWithMemoryTransport this is always a MemoryServer, and there
 
2037
        is no means to override it.
 
2038
        """
 
2039
        if self.__vfs_server is None:
 
2040
            self.__vfs_server = MemoryServer()
 
2041
            self.__vfs_server.setUp()
 
2042
            self.addCleanup(self.__vfs_server.tearDown)
 
2043
        return self.__vfs_server
 
2044
 
 
2045
    def get_server(self):
 
2046
        """Get the read/write server instance.
 
2047
 
 
2048
        This is useful for some tests with specific servers that need
 
2049
        diagnostics.
 
2050
 
 
2051
        This is built from the self.transport_server factory. If that is None,
 
2052
        then the self.get_vfs_server is returned.
 
2053
        """
 
2054
        if self.__server is None:
 
2055
            if self.transport_server is None or self.transport_server is self.vfs_transport_factory:
 
2056
                return self.get_vfs_only_server()
 
2057
            else:
 
2058
                # bring up a decorated means of access to the vfs only server.
 
2059
                self.__server = self.transport_server()
 
2060
                try:
 
2061
                    self.__server.setUp(self.get_vfs_only_server())
 
2062
                except TypeError, e:
 
2063
                    # This should never happen; the try:Except here is to assist
 
2064
                    # developers having to update code rather than seeing an
 
2065
                    # uninformative TypeError.
 
2066
                    raise Exception, "Old server API in use: %s, %s" % (self.__server, e)
 
2067
            self.addCleanup(self.__server.tearDown)
 
2068
        return self.__server
 
2069
 
 
2070
    def _adjust_url(self, base, relpath):
 
2071
        """Get a URL (or maybe a path) for the readwrite transport.
 
2072
 
 
2073
        This will either be backed by '.' or to an equivalent non-file based
 
2074
        facility.
 
2075
        relpath provides for clients to get a path relative to the base url.
 
2076
        These should only be downwards relative, not upwards.
 
2077
        """
 
2078
        if relpath is not None and relpath != '.':
 
2079
            if not base.endswith('/'):
 
2080
                base = base + '/'
 
2081
            # XXX: Really base should be a url; we did after all call
 
2082
            # get_url()!  But sometimes it's just a path (from
 
2083
            # LocalAbspathServer), and it'd be wrong to append urlescaped data
 
2084
            # to a non-escaped local path.
 
2085
            if base.startswith('./') or base.startswith('/'):
 
2086
                base += relpath
 
2087
            else:
 
2088
                base += urlutils.escape(relpath)
 
2089
        return base
 
2090
 
 
2091
    def get_url(self, relpath=None):
 
2092
        """Get a URL (or maybe a path) for the readwrite transport.
 
2093
 
 
2094
        This will either be backed by '.' or to an equivalent non-file based
 
2095
        facility.
 
2096
        relpath provides for clients to get a path relative to the base url.
 
2097
        These should only be downwards relative, not upwards.
 
2098
        """
 
2099
        base = self.get_server().get_url()
 
2100
        return self._adjust_url(base, relpath)
 
2101
 
 
2102
    def get_vfs_only_url(self, relpath=None):
 
2103
        """Get a URL (or maybe a path for the plain old vfs transport.
 
2104
 
 
2105
        This will never be a smart protocol.  It always has all the
 
2106
        capabilities of the local filesystem, but it might actually be a
 
2107
        MemoryTransport or some other similar virtual filesystem.
 
2108
 
 
2109
        This is the backing transport (if any) of the server returned by
 
2110
        get_url and get_readonly_url.
 
2111
 
 
2112
        :param relpath: provides for clients to get a path relative to the base
 
2113
            url.  These should only be downwards relative, not upwards.
 
2114
        :return: A URL
 
2115
        """
 
2116
        base = self.get_vfs_only_server().get_url()
 
2117
        return self._adjust_url(base, relpath)
 
2118
 
 
2119
    def _create_safety_net(self):
 
2120
        """Make a fake bzr directory.
 
2121
 
 
2122
        This prevents any tests propagating up onto the TEST_ROOT directory's
 
2123
        real branch.
 
2124
        """
 
2125
        root = TestCaseWithMemoryTransport.TEST_ROOT
 
2126
        bzrdir.BzrDir.create_standalone_workingtree(root)
 
2127
 
 
2128
    def _check_safety_net(self):
 
2129
        """Check that the safety .bzr directory have not been touched.
 
2130
 
 
2131
        _make_test_root have created a .bzr directory to prevent tests from
 
2132
        propagating. This method ensures than a test did not leaked.
 
2133
        """
 
2134
        root = TestCaseWithMemoryTransport.TEST_ROOT
 
2135
        wt = workingtree.WorkingTree.open(root)
 
2136
        last_rev = wt.last_revision()
 
2137
        if last_rev != 'null:':
 
2138
            # The current test have modified the /bzr directory, we need to
 
2139
            # recreate a new one or all the followng tests will fail.
 
2140
            # If you need to inspect its content uncomment the following line
 
2141
            # import pdb; pdb.set_trace()
 
2142
            _rmtree_temp_dir(root + '/.bzr')
 
2143
            self._create_safety_net()
 
2144
            raise AssertionError('%s/.bzr should not be modified' % root)
 
2145
 
 
2146
    def _make_test_root(self):
 
2147
        if TestCaseWithMemoryTransport.TEST_ROOT is None:
 
2148
            root = osutils.mkdtemp(prefix='testbzr-', suffix='.tmp')
 
2149
            TestCaseWithMemoryTransport.TEST_ROOT = root
 
2150
 
 
2151
            self._create_safety_net()
 
2152
 
 
2153
            # The same directory is used by all tests, and we're not
 
2154
            # specifically told when all tests are finished.  This will do.
 
2155
            atexit.register(_rmtree_temp_dir, root)
 
2156
 
 
2157
        self.addCleanup(self._check_safety_net)
 
2158
 
 
2159
    def makeAndChdirToTestDir(self):
 
2160
        """Create a temporary directories for this one test.
 
2161
 
 
2162
        This must set self.test_home_dir and self.test_dir and chdir to
 
2163
        self.test_dir.
 
2164
 
 
2165
        For TestCaseWithMemoryTransport we chdir to the TEST_ROOT for this test.
 
2166
        """
 
2167
        os.chdir(TestCaseWithMemoryTransport.TEST_ROOT)
 
2168
        self.test_dir = TestCaseWithMemoryTransport.TEST_ROOT
 
2169
        self.test_home_dir = self.test_dir + "/MemoryTransportMissingHomeDir"
 
2170
 
 
2171
    def make_branch(self, relpath, format=None):
 
2172
        """Create a branch on the transport at relpath."""
 
2173
        repo = self.make_repository(relpath, format=format)
 
2174
        return repo.bzrdir.create_branch()
 
2175
 
 
2176
    def make_bzrdir(self, relpath, format=None):
 
2177
        try:
 
2178
            # might be a relative or absolute path
 
2179
            maybe_a_url = self.get_url(relpath)
 
2180
            segments = maybe_a_url.rsplit('/', 1)
 
2181
            t = get_transport(maybe_a_url)
 
2182
            if len(segments) > 1 and segments[-1] not in ('', '.'):
 
2183
                t.ensure_base()
 
2184
            if format is None:
 
2185
                format = 'default'
 
2186
            if isinstance(format, basestring):
 
2187
                format = bzrdir.format_registry.make_bzrdir(format)
 
2188
            return format.initialize_on_transport(t)
 
2189
        except errors.UninitializableFormat:
 
2190
            raise TestSkipped("Format %s is not initializable." % format)
 
2191
 
 
2192
    def make_repository(self, relpath, shared=False, format=None):
 
2193
        """Create a repository on our default transport at relpath.
 
2194
 
 
2195
        Note that relpath must be a relative path, not a full url.
 
2196
        """
 
2197
        # FIXME: If you create a remoterepository this returns the underlying
 
2198
        # real format, which is incorrect.  Actually we should make sure that
 
2199
        # RemoteBzrDir returns a RemoteRepository.
 
2200
        # maybe  mbp 20070410
 
2201
        made_control = self.make_bzrdir(relpath, format=format)
 
2202
        return made_control.create_repository(shared=shared)
 
2203
 
 
2204
    def make_smart_server(self, path):
 
2205
        smart_server = server.SmartTCPServer_for_testing()
 
2206
        smart_server.setUp(self.get_server())
 
2207
        remote_transport = get_transport(smart_server.get_url()).clone(path)
 
2208
        self.addCleanup(smart_server.tearDown)
 
2209
        return remote_transport
 
2210
 
 
2211
    def make_branch_and_memory_tree(self, relpath, format=None):
 
2212
        """Create a branch on the default transport and a MemoryTree for it."""
 
2213
        b = self.make_branch(relpath, format=format)
 
2214
        return memorytree.MemoryTree.create_on_branch(b)
 
2215
 
 
2216
    def make_branch_builder(self, relpath, format=None):
 
2217
        branch = self.make_branch(relpath, format=format)
 
2218
        return branchbuilder.BranchBuilder(branch=branch)
 
2219
 
 
2220
    def overrideEnvironmentForTesting(self):
 
2221
        os.environ['HOME'] = self.test_home_dir
 
2222
        os.environ['BZR_HOME'] = self.test_home_dir
 
2223
 
 
2224
    def setUp(self):
 
2225
        super(TestCaseWithMemoryTransport, self).setUp()
 
2226
        self._make_test_root()
 
2227
        _currentdir = os.getcwdu()
 
2228
        def _leaveDirectory():
 
2229
            os.chdir(_currentdir)
 
2230
        self.addCleanup(_leaveDirectory)
 
2231
        self.makeAndChdirToTestDir()
 
2232
        self.overrideEnvironmentForTesting()
 
2233
        self.__readonly_server = None
 
2234
        self.__server = None
 
2235
        self.reduceLockdirTimeout()
 
2236
 
 
2237
    def setup_smart_server_with_call_log(self):
 
2238
        """Sets up a smart server as the transport server with a call log."""
 
2239
        self.transport_server = server.SmartTCPServer_for_testing
 
2240
        self.hpss_calls = []
 
2241
        import traceback
 
2242
        # Skip the current stack down to the caller of
 
2243
        # setup_smart_server_with_call_log
 
2244
        prefix_length = len(traceback.extract_stack()) - 2
 
2245
        def capture_hpss_call(params):
 
2246
            self.hpss_calls.append(
 
2247
                CapturedCall(params, prefix_length))
 
2248
        client._SmartClient.hooks.install_named_hook(
 
2249
            'call', capture_hpss_call, None)
 
2250
 
 
2251
    def reset_smart_call_log(self):
 
2252
        self.hpss_calls = []
 
2253
 
 
2254
 
 
2255
class TestCaseInTempDir(TestCaseWithMemoryTransport):
888
2256
    """Derived class that runs a test within a temporary directory.
889
2257
 
890
2258
    This is useful for tests that need to create a branch, etc.
894
2262
    All test cases create their own directory within that.  If the
895
2263
    tests complete successfully, the directory is removed.
896
2264
 
897
 
    InTempDir is an old alias for FunctionalTestCase.
 
2265
    :ivar test_base_dir: The path of the top-level directory for this
 
2266
    test, which contains a home directory and a work directory.
 
2267
 
 
2268
    :ivar test_home_dir: An initially empty directory under test_base_dir
 
2269
    which is used as $HOME for this test.
 
2270
 
 
2271
    :ivar test_dir: A directory under test_base_dir used as the current
 
2272
    directory when the test proper is run.
898
2273
    """
899
2274
 
900
 
    TEST_ROOT = None
901
 
    _TEST_NAME = 'test'
902
2275
    OVERRIDE_PYTHON = 'python'
903
2276
 
904
2277
    def check_file_contents(self, filename, expect):
909
2282
            self.log("actually: %r" % contents)
910
2283
            self.fail("contents of %s not as expected" % filename)
911
2284
 
912
 
    def _make_test_root(self):
913
 
        if TestCaseInTempDir.TEST_ROOT is not None:
914
 
            return
915
 
        i = 0
916
 
        while True:
917
 
            root = u'test%04d.tmp' % i
918
 
            try:
919
 
                os.mkdir(root)
920
 
            except OSError, e:
921
 
                if e.errno == errno.EEXIST:
922
 
                    i += 1
923
 
                    continue
924
 
                else:
925
 
                    raise
926
 
            # successfully created
927
 
            TestCaseInTempDir.TEST_ROOT = osutils.abspath(root)
928
 
            break
929
 
        # make a fake bzr directory there to prevent any tests propagating
930
 
        # up onto the source directory's real branch
931
 
        bzrdir.BzrDir.create_standalone_workingtree(TestCaseInTempDir.TEST_ROOT)
932
 
 
933
 
    def setUp(self):
934
 
        super(TestCaseInTempDir, self).setUp()
935
 
        self._make_test_root()
936
 
        _currentdir = os.getcwdu()
937
 
        # shorten the name, to avoid test failures due to path length
938
 
        short_id = self.id().replace('bzrlib.tests.', '') \
939
 
                   .replace('__main__.', '')[-100:]
940
 
        # it's possible the same test class is run several times for
941
 
        # parameterized tests, so make sure the names don't collide.  
942
 
        i = 0
943
 
        while True:
944
 
            if i > 0:
945
 
                candidate_dir = '%s/%s.%d' % (self.TEST_ROOT, short_id, i)
946
 
            else:
947
 
                candidate_dir = '%s/%s' % (self.TEST_ROOT, short_id)
948
 
            if os.path.exists(candidate_dir):
949
 
                i = i + 1
950
 
                continue
951
 
            else:
952
 
                self.test_dir = candidate_dir
953
 
                os.mkdir(self.test_dir)
954
 
                os.chdir(self.test_dir)
 
2285
    def _getTestDirPrefix(self):
 
2286
        # create a directory within the top level test directory
 
2287
        if sys.platform == 'win32':
 
2288
            name_prefix = re.sub('[<>*=+",:;_/\\-]', '_', self.id())
 
2289
            # windows is likely to have path-length limits so use a short name
 
2290
            name_prefix = name_prefix[-30:]
 
2291
        else:
 
2292
            name_prefix = re.sub('[/]', '_', self.id())
 
2293
        return name_prefix
 
2294
 
 
2295
    def makeAndChdirToTestDir(self):
 
2296
        """See TestCaseWithMemoryTransport.makeAndChdirToTestDir().
 
2297
 
 
2298
        For TestCaseInTempDir we create a temporary directory based on the test
 
2299
        name and then create two subdirs - test and home under it.
 
2300
        """
 
2301
        name_prefix = osutils.pathjoin(TestCaseWithMemoryTransport.TEST_ROOT,
 
2302
            self._getTestDirPrefix())
 
2303
        name = name_prefix
 
2304
        for i in range(100):
 
2305
            if os.path.exists(name):
 
2306
                name = name_prefix + '_' + str(i)
 
2307
            else:
 
2308
                os.mkdir(name)
955
2309
                break
956
 
        os.environ['HOME'] = self.test_dir
957
 
        os.environ['APPDATA'] = self.test_dir
958
 
        def _leaveDirectory():
959
 
            os.chdir(_currentdir)
960
 
        self.addCleanup(_leaveDirectory)
961
 
        
962
 
    def build_tree(self, shape, line_endings='native', transport=None):
 
2310
        # now create test and home directories within this dir
 
2311
        self.test_base_dir = name
 
2312
        self.test_home_dir = self.test_base_dir + '/home'
 
2313
        os.mkdir(self.test_home_dir)
 
2314
        self.test_dir = self.test_base_dir + '/work'
 
2315
        os.mkdir(self.test_dir)
 
2316
        os.chdir(self.test_dir)
 
2317
        # put name of test inside
 
2318
        f = file(self.test_base_dir + '/name', 'w')
 
2319
        try:
 
2320
            f.write(self.id())
 
2321
        finally:
 
2322
            f.close()
 
2323
        self.addCleanup(self.deleteTestDir)
 
2324
 
 
2325
    def deleteTestDir(self):
 
2326
        os.chdir(TestCaseWithMemoryTransport.TEST_ROOT)
 
2327
        _rmtree_temp_dir(self.test_base_dir)
 
2328
 
 
2329
    def build_tree(self, shape, line_endings='binary', transport=None):
963
2330
        """Build a test tree according to a pattern.
964
2331
 
965
2332
        shape is a sequence of file specifications.  If the final
968
2335
        This assumes that all the elements in the tree being built are new.
969
2336
 
970
2337
        This doesn't add anything to a branch.
 
2338
 
 
2339
        :type shape:    list or tuple.
971
2340
        :param line_endings: Either 'binary' or 'native'
972
 
                             in binary mode, exact contents are written
973
 
                             in native mode, the line endings match the
974
 
                             default platform endings.
975
 
 
976
 
        :param transport: A transport to write to, for building trees on 
977
 
                          VFS's. If the transport is readonly or None,
978
 
                          "." is opened automatically.
 
2341
            in binary mode, exact contents are written in native mode, the
 
2342
            line endings match the default platform endings.
 
2343
        :param transport: A transport to write to, for building trees on VFS's.
 
2344
            If the transport is readonly or None, "." is opened automatically.
 
2345
        :return: None
979
2346
        """
 
2347
        if type(shape) not in (list, tuple):
 
2348
            raise AssertionError("Parameter 'shape' should be "
 
2349
                "a list or a tuple. Got %r instead" % (shape,))
980
2350
        # It's OK to just create them using forward slashes on windows.
981
2351
        if transport is None or transport.is_readonly():
982
2352
            transport = get_transport(".")
983
2353
        for name in shape:
984
 
            self.assert_(isinstance(name, basestring))
 
2354
            self.assertIsInstance(name, basestring)
985
2355
            if name[-1] == '/':
986
2356
                transport.mkdir(urlutils.escape(name[:-1]))
987
2357
            else:
990
2360
                elif line_endings == 'native':
991
2361
                    end = os.linesep
992
2362
                else:
993
 
                    raise errors.BzrError('Invalid line ending request %r' % (line_endings,))
 
2363
                    raise errors.BzrError(
 
2364
                        'Invalid line ending request %r' % line_endings)
994
2365
                content = "contents of %s%s" % (name.encode('utf-8'), end)
995
 
                # Technically 'put()' is the right command. However, put
996
 
                # uses an AtomicFile, which requires an extra rename into place
997
 
                # As long as the files didn't exist in the past, append() will
998
 
                # do the same thing as put()
999
 
                # On jam's machine, make_kernel_like_tree is:
1000
 
                #   put:    4.5-7.5s (averaging 6s)
1001
 
                #   append: 2.9-4.5s
1002
 
                transport.append(urlutils.escape(name), StringIO(content))
 
2366
                transport.put_bytes_non_atomic(urlutils.escape(name), content)
1003
2367
 
1004
2368
    def build_tree_contents(self, shape):
1005
2369
        build_tree_contents(shape)
1006
2370
 
1007
 
    def failUnlessExists(self, path):
1008
 
        """Fail unless path, which may be abs or relative, exists."""
1009
 
        self.failUnless(osutils.lexists(path))
 
2371
    def assertInWorkingTree(self, path, root_path='.', tree=None):
 
2372
        """Assert whether path or paths are in the WorkingTree"""
 
2373
        if tree is None:
 
2374
            tree = workingtree.WorkingTree.open(root_path)
 
2375
        if not isinstance(path, basestring):
 
2376
            for p in path:
 
2377
                self.assertInWorkingTree(p, tree=tree)
 
2378
        else:
 
2379
            self.assertIsNot(tree.path2id(path), None,
 
2380
                path+' not in working tree.')
1010
2381
 
1011
 
    def failIfExists(self, path):
1012
 
        """Fail if path, which may be abs or relative, exists."""
1013
 
        self.failIf(osutils.lexists(path))
1014
 
        
1015
 
    def assertFileEqual(self, content, path):
1016
 
        """Fail if path does not contain 'content'."""
1017
 
        self.failUnless(osutils.lexists(path))
1018
 
        # TODO: jam 20060427 Shouldn't this be 'rb'?
1019
 
        self.assertEqualDiff(content, open(path, 'r').read())
 
2382
    def assertNotInWorkingTree(self, path, root_path='.', tree=None):
 
2383
        """Assert whether path or paths are not in the WorkingTree"""
 
2384
        if tree is None:
 
2385
            tree = workingtree.WorkingTree.open(root_path)
 
2386
        if not isinstance(path, basestring):
 
2387
            for p in path:
 
2388
                self.assertNotInWorkingTree(p,tree=tree)
 
2389
        else:
 
2390
            self.assertIs(tree.path2id(path), None, path+' in working tree.')
1020
2391
 
1021
2392
 
1022
2393
class TestCaseWithTransport(TestCaseInTempDir):
1029
2400
    ReadonlyTransportDecorator is used instead which allows the use of non disk
1030
2401
    based read write transports.
1031
2402
 
1032
 
    If an explicit class is provided for readonly access, that server and the 
 
2403
    If an explicit class is provided for readonly access, that server and the
1033
2404
    readwrite one must both define get_url() as resolving to os.getcwd().
1034
2405
    """
1035
2406
 
1036
 
    def __init__(self, methodName='testMethod'):
1037
 
        super(TestCaseWithTransport, self).__init__(methodName)
1038
 
        self.__readonly_server = None
1039
 
        self.__server = None
1040
 
        self.transport_server = default_transport
1041
 
        self.transport_readonly_server = None
1042
 
 
1043
 
    def get_readonly_url(self, relpath=None):
1044
 
        """Get a URL for the readonly transport.
1045
 
 
1046
 
        This will either be backed by '.' or a decorator to the transport 
1047
 
        used by self.get_url()
1048
 
        relpath provides for clients to get a path relative to the base url.
1049
 
        These should only be downwards relative, not upwards.
1050
 
        """
1051
 
        base = self.get_readonly_server().get_url()
1052
 
        if relpath is not None:
1053
 
            if not base.endswith('/'):
1054
 
                base = base + '/'
1055
 
            base = base + relpath
1056
 
        return base
1057
 
 
1058
 
    def get_readonly_server(self):
1059
 
        """Get the server instance for the readonly transport
1060
 
 
1061
 
        This is useful for some tests with specific servers to do diagnostics.
1062
 
        """
1063
 
        if self.__readonly_server is None:
1064
 
            if self.transport_readonly_server is None:
1065
 
                # readonly decorator requested
1066
 
                # bring up the server
1067
 
                self.get_url()
1068
 
                self.__readonly_server = ReadonlyServer()
1069
 
                self.__readonly_server.setUp(self.__server)
1070
 
            else:
1071
 
                self.__readonly_server = self.transport_readonly_server()
1072
 
                self.__readonly_server.setUp()
1073
 
            self.addCleanup(self.__readonly_server.tearDown)
1074
 
        return self.__readonly_server
1075
 
 
1076
 
    def get_server(self):
1077
 
        """Get the read/write server instance.
 
2407
    def get_vfs_only_server(self):
 
2408
        """See TestCaseWithMemoryTransport.
1078
2409
 
1079
2410
        This is useful for some tests with specific servers that need
1080
2411
        diagnostics.
1081
2412
        """
1082
 
        if self.__server is None:
1083
 
            self.__server = self.transport_server()
1084
 
            self.__server.setUp()
1085
 
            self.addCleanup(self.__server.tearDown)
1086
 
        return self.__server
1087
 
 
1088
 
    def get_url(self, relpath=None):
1089
 
        """Get a URL for the readwrite transport.
1090
 
 
1091
 
        This will either be backed by '.' or to an equivalent non-file based
1092
 
        facility.
1093
 
        relpath provides for clients to get a path relative to the base url.
1094
 
        These should only be downwards relative, not upwards.
1095
 
        """
1096
 
        base = self.get_server().get_url()
1097
 
        if relpath is not None and relpath != '.':
1098
 
            if not base.endswith('/'):
1099
 
                base = base + '/'
1100
 
            base = base + urlutils.escape(relpath)
1101
 
        return base
1102
 
 
1103
 
    def get_transport(self):
1104
 
        """Return a writeable transport for the test scratch space"""
1105
 
        t = get_transport(self.get_url())
1106
 
        self.assertFalse(t.is_readonly())
1107
 
        return t
1108
 
 
1109
 
    def get_readonly_transport(self):
1110
 
        """Return a readonly transport for the test scratch space
1111
 
        
1112
 
        This can be used to test that operations which should only need
1113
 
        readonly access in fact do not try to write.
1114
 
        """
1115
 
        t = get_transport(self.get_readonly_url())
1116
 
        self.assertTrue(t.is_readonly())
1117
 
        return t
1118
 
 
1119
 
    def make_branch(self, relpath, format=None):
1120
 
        """Create a branch on the transport at relpath."""
1121
 
        repo = self.make_repository(relpath, format=format)
1122
 
        return repo.bzrdir.create_branch()
1123
 
 
1124
 
    def make_bzrdir(self, relpath, format=None):
1125
 
        try:
1126
 
            url = self.get_url(relpath)
1127
 
            mutter('relpath %r => url %r', relpath, url)
1128
 
            segments = url.split('/')
1129
 
            if segments and segments[-1] not in ('', '.'):
1130
 
                parent = '/'.join(segments[:-1])
1131
 
                t = get_transport(parent)
1132
 
                try:
1133
 
                    t.mkdir(segments[-1])
1134
 
                except errors.FileExists:
1135
 
                    pass
1136
 
            if format is None:
1137
 
                format=bzrlib.bzrdir.BzrDirFormat.get_default_format()
1138
 
            # FIXME: make this use a single transport someday. RBC 20060418
1139
 
            return format.initialize_on_transport(get_transport(relpath))
1140
 
        except errors.UninitializableFormat:
1141
 
            raise TestSkipped("Format %s is not initializable." % format)
1142
 
 
1143
 
    def make_repository(self, relpath, shared=False, format=None):
1144
 
        """Create a repository on our default transport at relpath."""
1145
 
        made_control = self.make_bzrdir(relpath, format=format)
1146
 
        return made_control.create_repository(shared=shared)
 
2413
        if self.__vfs_server is None:
 
2414
            self.__vfs_server = self.vfs_transport_factory()
 
2415
            self.__vfs_server.setUp()
 
2416
            self.addCleanup(self.__vfs_server.tearDown)
 
2417
        return self.__vfs_server
1147
2418
 
1148
2419
    def make_branch_and_tree(self, relpath, format=None):
1149
2420
        """Create a branch on the transport and a tree locally.
1150
2421
 
1151
 
        Returns the tree.
 
2422
        If the transport is not a LocalTransport, the Tree can't be created on
 
2423
        the transport.  In that case if the vfs_transport_factory is
 
2424
        LocalURLServer the working tree is created in the local
 
2425
        directory backing the transport, and the returned tree's branch and
 
2426
        repository will also be accessed locally. Otherwise a lightweight
 
2427
        checkout is created and returned.
 
2428
 
 
2429
        :param format: The BzrDirFormat.
 
2430
        :returns: the WorkingTree.
1152
2431
        """
1153
2432
        # TODO: always use the local disk path for the working tree,
1154
2433
        # this obviously requires a format that supports branch references
1158
2437
        try:
1159
2438
            return b.bzrdir.create_workingtree()
1160
2439
        except errors.NotLocalUrl:
1161
 
            # new formats - catch No tree error and create
1162
 
            # a branch reference and a checkout.
1163
 
            # old formats at that point - raise TestSkipped.
1164
 
            # TODO: rbc 20060208
1165
 
            return WorkingTreeFormat2().initialize(bzrdir.BzrDir.open(relpath))
 
2440
            # We can only make working trees locally at the moment.  If the
 
2441
            # transport can't support them, then we keep the non-disk-backed
 
2442
            # branch and create a local checkout.
 
2443
            if self.vfs_transport_factory is LocalURLServer:
 
2444
                # the branch is colocated on disk, we cannot create a checkout.
 
2445
                # hopefully callers will expect this.
 
2446
                local_controldir= bzrdir.BzrDir.open(self.get_vfs_only_url(relpath))
 
2447
                wt = local_controldir.create_workingtree()
 
2448
                if wt.branch._format != b._format:
 
2449
                    wt._branch = b
 
2450
                    # Make sure that assigning to wt._branch fixes wt.branch,
 
2451
                    # in case the implementation details of workingtree objects
 
2452
                    # change.
 
2453
                    self.assertIs(b, wt.branch)
 
2454
                return wt
 
2455
            else:
 
2456
                return b.create_checkout(relpath, lightweight=True)
1166
2457
 
1167
2458
    def assertIsDirectory(self, relpath, transport):
1168
2459
        """Assert that relpath within transport is a directory.
1179
2470
            self.fail("path %s is not a directory; has mode %#o"
1180
2471
                      % (relpath, mode))
1181
2472
 
 
2473
    def assertTreesEqual(self, left, right):
 
2474
        """Check that left and right have the same content and properties."""
 
2475
        # we use a tree delta to check for equality of the content, and we
 
2476
        # manually check for equality of other things such as the parents list.
 
2477
        self.assertEqual(left.get_parent_ids(), right.get_parent_ids())
 
2478
        differences = left.changes_from(right)
 
2479
        self.assertFalse(differences.has_changed(),
 
2480
            "Trees %r and %r are different: %r" % (left, right, differences))
 
2481
 
 
2482
    def setUp(self):
 
2483
        super(TestCaseWithTransport, self).setUp()
 
2484
        self.__vfs_server = None
 
2485
 
1182
2486
 
1183
2487
class ChrootedTestCase(TestCaseWithTransport):
1184
2488
    """A support class that provides readonly urls outside the local namespace.
1188
2492
    for readonly urls.
1189
2493
 
1190
2494
    TODO RBC 20060127: make this an option to TestCaseWithTransport so it can
1191
 
                       be used without needed to redo it when a different 
 
2495
                       be used without needed to redo it when a different
1192
2496
                       subclass is in use ?
1193
2497
    """
1194
2498
 
1195
2499
    def setUp(self):
1196
2500
        super(ChrootedTestCase, self).setUp()
1197
 
        if not self.transport_server == bzrlib.transport.memory.MemoryServer:
1198
 
            self.transport_readonly_server = bzrlib.transport.http.HttpServer
 
2501
        if not self.vfs_transport_factory == MemoryServer:
 
2502
            self.transport_readonly_server = HttpServer
 
2503
 
 
2504
 
 
2505
def condition_id_re(pattern):
 
2506
    """Create a condition filter which performs a re check on a test's id.
 
2507
 
 
2508
    :param pattern: A regular expression string.
 
2509
    :return: A callable that returns True if the re matches.
 
2510
    """
 
2511
    filter_re = osutils.re_compile_checked(pattern, 0,
 
2512
        'test filter')
 
2513
    def condition(test):
 
2514
        test_id = test.id()
 
2515
        return filter_re.search(test_id)
 
2516
    return condition
 
2517
 
 
2518
 
 
2519
def condition_isinstance(klass_or_klass_list):
 
2520
    """Create a condition filter which returns isinstance(param, klass).
 
2521
 
 
2522
    :return: A callable which when called with one parameter obj return the
 
2523
        result of isinstance(obj, klass_or_klass_list).
 
2524
    """
 
2525
    def condition(obj):
 
2526
        return isinstance(obj, klass_or_klass_list)
 
2527
    return condition
 
2528
 
 
2529
 
 
2530
def condition_id_in_list(id_list):
 
2531
    """Create a condition filter which verify that test's id in a list.
 
2532
 
 
2533
    :param id_list: A TestIdList object.
 
2534
    :return: A callable that returns True if the test's id appears in the list.
 
2535
    """
 
2536
    def condition(test):
 
2537
        return id_list.includes(test.id())
 
2538
    return condition
 
2539
 
 
2540
 
 
2541
def condition_id_startswith(starts):
 
2542
    """Create a condition filter verifying that test's id starts with a string.
 
2543
 
 
2544
    :param starts: A list of string.
 
2545
    :return: A callable that returns True if the test's id starts with one of
 
2546
        the given strings.
 
2547
    """
 
2548
    def condition(test):
 
2549
        for start in starts:
 
2550
            if test.id().startswith(start):
 
2551
                return True
 
2552
        return False
 
2553
    return condition
 
2554
 
 
2555
 
 
2556
def exclude_tests_by_condition(suite, condition):
 
2557
    """Create a test suite which excludes some tests from suite.
 
2558
 
 
2559
    :param suite: The suite to get tests from.
 
2560
    :param condition: A callable whose result evaluates True when called with a
 
2561
        test case which should be excluded from the result.
 
2562
    :return: A suite which contains the tests found in suite that fail
 
2563
        condition.
 
2564
    """
 
2565
    result = []
 
2566
    for test in iter_suite_tests(suite):
 
2567
        if not condition(test):
 
2568
            result.append(test)
 
2569
    return TestUtil.TestSuite(result)
 
2570
 
 
2571
 
 
2572
def filter_suite_by_condition(suite, condition):
 
2573
    """Create a test suite by filtering another one.
 
2574
 
 
2575
    :param suite: The source suite.
 
2576
    :param condition: A callable whose result evaluates True when called with a
 
2577
        test case which should be included in the result.
 
2578
    :return: A suite which contains the tests found in suite that pass
 
2579
        condition.
 
2580
    """
 
2581
    result = []
 
2582
    for test in iter_suite_tests(suite):
 
2583
        if condition(test):
 
2584
            result.append(test)
 
2585
    return TestUtil.TestSuite(result)
1199
2586
 
1200
2587
 
1201
2588
def filter_suite_by_re(suite, pattern):
1202
 
    result = TestUtil.TestSuite()
1203
 
    filter_re = re.compile(pattern)
 
2589
    """Create a test suite by filtering another one.
 
2590
 
 
2591
    :param suite:           the source suite
 
2592
    :param pattern:         pattern that names must match
 
2593
    :returns: the newly created suite
 
2594
    """
 
2595
    condition = condition_id_re(pattern)
 
2596
    result_suite = filter_suite_by_condition(suite, condition)
 
2597
    return result_suite
 
2598
 
 
2599
 
 
2600
def filter_suite_by_id_list(suite, test_id_list):
 
2601
    """Create a test suite by filtering another one.
 
2602
 
 
2603
    :param suite: The source suite.
 
2604
    :param test_id_list: A list of the test ids to keep as strings.
 
2605
    :returns: the newly created suite
 
2606
    """
 
2607
    condition = condition_id_in_list(test_id_list)
 
2608
    result_suite = filter_suite_by_condition(suite, condition)
 
2609
    return result_suite
 
2610
 
 
2611
 
 
2612
def filter_suite_by_id_startswith(suite, start):
 
2613
    """Create a test suite by filtering another one.
 
2614
 
 
2615
    :param suite: The source suite.
 
2616
    :param start: A list of string the test id must start with one of.
 
2617
    :returns: the newly created suite
 
2618
    """
 
2619
    condition = condition_id_startswith(start)
 
2620
    result_suite = filter_suite_by_condition(suite, condition)
 
2621
    return result_suite
 
2622
 
 
2623
 
 
2624
def exclude_tests_by_re(suite, pattern):
 
2625
    """Create a test suite which excludes some tests from suite.
 
2626
 
 
2627
    :param suite: The suite to get tests from.
 
2628
    :param pattern: A regular expression string. Test ids that match this
 
2629
        pattern will be excluded from the result.
 
2630
    :return: A TestSuite that contains all the tests from suite without the
 
2631
        tests that matched pattern. The order of tests is the same as it was in
 
2632
        suite.
 
2633
    """
 
2634
    return exclude_tests_by_condition(suite, condition_id_re(pattern))
 
2635
 
 
2636
 
 
2637
def preserve_input(something):
 
2638
    """A helper for performing test suite transformation chains.
 
2639
 
 
2640
    :param something: Anything you want to preserve.
 
2641
    :return: Something.
 
2642
    """
 
2643
    return something
 
2644
 
 
2645
 
 
2646
def randomize_suite(suite):
 
2647
    """Return a new TestSuite with suite's tests in random order.
 
2648
 
 
2649
    The tests in the input suite are flattened into a single suite in order to
 
2650
    accomplish this. Any nested TestSuites are removed to provide global
 
2651
    randomness.
 
2652
    """
 
2653
    tests = list(iter_suite_tests(suite))
 
2654
    random.shuffle(tests)
 
2655
    return TestUtil.TestSuite(tests)
 
2656
 
 
2657
 
 
2658
def split_suite_by_condition(suite, condition):
 
2659
    """Split a test suite into two by a condition.
 
2660
 
 
2661
    :param suite: The suite to split.
 
2662
    :param condition: The condition to match on. Tests that match this
 
2663
        condition are returned in the first test suite, ones that do not match
 
2664
        are in the second suite.
 
2665
    :return: A tuple of two test suites, where the first contains tests from
 
2666
        suite matching the condition, and the second contains the remainder
 
2667
        from suite. The order within each output suite is the same as it was in
 
2668
        suite.
 
2669
    """
 
2670
    matched = []
 
2671
    did_not_match = []
1204
2672
    for test in iter_suite_tests(suite):
1205
 
        if filter_re.search(test.id()):
1206
 
            result.addTest(test)
1207
 
    return result
 
2673
        if condition(test):
 
2674
            matched.append(test)
 
2675
        else:
 
2676
            did_not_match.append(test)
 
2677
    return TestUtil.TestSuite(matched), TestUtil.TestSuite(did_not_match)
 
2678
 
 
2679
 
 
2680
def split_suite_by_re(suite, pattern):
 
2681
    """Split a test suite into two by a regular expression.
 
2682
 
 
2683
    :param suite: The suite to split.
 
2684
    :param pattern: A regular expression string. Test ids that match this
 
2685
        pattern will be in the first test suite returned, and the others in the
 
2686
        second test suite returned.
 
2687
    :return: A tuple of two test suites, where the first contains tests from
 
2688
        suite matching pattern, and the second contains the remainder from
 
2689
        suite. The order within each output suite is the same as it was in
 
2690
        suite.
 
2691
    """
 
2692
    return split_suite_by_condition(suite, condition_id_re(pattern))
1208
2693
 
1209
2694
 
1210
2695
def run_suite(suite, name='test', verbose=False, pattern=".*",
1211
 
              stop_on_failure=False, keep_output=False,
1212
 
              transport=None, lsprof_timed=None):
1213
 
    TestCaseInTempDir._TEST_NAME = name
 
2696
              stop_on_failure=False,
 
2697
              transport=None, lsprof_timed=None, bench_history=None,
 
2698
              matching_tests_first=None,
 
2699
              list_only=False,
 
2700
              random_seed=None,
 
2701
              exclude_pattern=None,
 
2702
              strict=False,
 
2703
              runner_class=None,
 
2704
              suite_decorators=None,
 
2705
              stream=None):
 
2706
    """Run a test suite for bzr selftest.
 
2707
 
 
2708
    :param runner_class: The class of runner to use. Must support the
 
2709
        constructor arguments passed by run_suite which are more than standard
 
2710
        python uses.
 
2711
    :return: A boolean indicating success.
 
2712
    """
1214
2713
    TestCase._gather_lsprof_in_benchmarks = lsprof_timed
1215
2714
    if verbose:
1216
2715
        verbosity = 2
1217
 
        pb = None
1218
2716
    else:
1219
2717
        verbosity = 1
1220
 
        pb = progress.ProgressBar()
1221
 
    runner = TextTestRunner(stream=sys.stdout,
 
2718
    if runner_class is None:
 
2719
        runner_class = TextTestRunner
 
2720
    if stream is None:
 
2721
        stream = sys.stdout
 
2722
    runner = runner_class(stream=stream,
1222
2723
                            descriptions=0,
1223
2724
                            verbosity=verbosity,
1224
 
                            keep_output=keep_output,
1225
 
                            pb=pb)
 
2725
                            bench_history=bench_history,
 
2726
                            list_only=list_only,
 
2727
                            strict=strict,
 
2728
                            )
1226
2729
    runner.stop_on_failure=stop_on_failure
1227
 
    if pattern != '.*':
1228
 
        suite = filter_suite_by_re(suite, pattern)
 
2730
    # built in decorator factories:
 
2731
    decorators = [
 
2732
        random_order(random_seed, runner),
 
2733
        exclude_tests(exclude_pattern),
 
2734
        ]
 
2735
    if matching_tests_first:
 
2736
        decorators.append(tests_first(pattern))
 
2737
    else:
 
2738
        decorators.append(filter_tests(pattern))
 
2739
    if suite_decorators:
 
2740
        decorators.extend(suite_decorators)
 
2741
    for decorator in decorators:
 
2742
        suite = decorator(suite)
1229
2743
    result = runner.run(suite)
1230
 
    return result.wasSuccessful()
 
2744
    if list_only:
 
2745
        return True
 
2746
    result.done()
 
2747
    if strict:
 
2748
        return result.wasStrictlySuccessful()
 
2749
    else:
 
2750
        return result.wasSuccessful()
 
2751
 
 
2752
 
 
2753
# A registry where get() returns a suite decorator.
 
2754
parallel_registry = registry.Registry()
 
2755
 
 
2756
 
 
2757
def fork_decorator(suite):
 
2758
    concurrency = osutils.local_concurrency()
 
2759
    if concurrency == 1:
 
2760
        return suite
 
2761
    from testtools import ConcurrentTestSuite
 
2762
    return ConcurrentTestSuite(suite, fork_for_tests)
 
2763
parallel_registry.register('fork', fork_decorator)
 
2764
 
 
2765
 
 
2766
def subprocess_decorator(suite):
 
2767
    concurrency = osutils.local_concurrency()
 
2768
    if concurrency == 1:
 
2769
        return suite
 
2770
    from testtools import ConcurrentTestSuite
 
2771
    return ConcurrentTestSuite(suite, reinvoke_for_tests)
 
2772
parallel_registry.register('subprocess', subprocess_decorator)
 
2773
 
 
2774
 
 
2775
def exclude_tests(exclude_pattern):
 
2776
    """Return a test suite decorator that excludes tests."""
 
2777
    if exclude_pattern is None:
 
2778
        return identity_decorator
 
2779
    def decorator(suite):
 
2780
        return ExcludeDecorator(suite, exclude_pattern)
 
2781
    return decorator
 
2782
 
 
2783
 
 
2784
def filter_tests(pattern):
 
2785
    if pattern == '.*':
 
2786
        return identity_decorator
 
2787
    def decorator(suite):
 
2788
        return FilterTestsDecorator(suite, pattern)
 
2789
    return decorator
 
2790
 
 
2791
 
 
2792
def random_order(random_seed, runner):
 
2793
    """Return a test suite decorator factory for randomising tests order.
 
2794
    
 
2795
    :param random_seed: now, a string which casts to a long, or a long.
 
2796
    :param runner: A test runner with a stream attribute to report on.
 
2797
    """
 
2798
    if random_seed is None:
 
2799
        return identity_decorator
 
2800
    def decorator(suite):
 
2801
        return RandomDecorator(suite, random_seed, runner.stream)
 
2802
    return decorator
 
2803
 
 
2804
 
 
2805
def tests_first(pattern):
 
2806
    if pattern == '.*':
 
2807
        return identity_decorator
 
2808
    def decorator(suite):
 
2809
        return TestFirstDecorator(suite, pattern)
 
2810
    return decorator
 
2811
 
 
2812
 
 
2813
def identity_decorator(suite):
 
2814
    """Return suite."""
 
2815
    return suite
 
2816
 
 
2817
 
 
2818
class TestDecorator(TestSuite):
 
2819
    """A decorator for TestCase/TestSuite objects.
 
2820
    
 
2821
    Usually, subclasses should override __iter__(used when flattening test
 
2822
    suites), which we do to filter, reorder, parallelise and so on, run() and
 
2823
    debug().
 
2824
    """
 
2825
 
 
2826
    def __init__(self, suite):
 
2827
        TestSuite.__init__(self)
 
2828
        self.addTest(suite)
 
2829
 
 
2830
    def countTestCases(self):
 
2831
        cases = 0
 
2832
        for test in self:
 
2833
            cases += test.countTestCases()
 
2834
        return cases
 
2835
 
 
2836
    def debug(self):
 
2837
        for test in self:
 
2838
            test.debug()
 
2839
 
 
2840
    def run(self, result):
 
2841
        # Use iteration on self, not self._tests, to allow subclasses to hook
 
2842
        # into __iter__.
 
2843
        for test in self:
 
2844
            if result.shouldStop:
 
2845
                break
 
2846
            test.run(result)
 
2847
        return result
 
2848
 
 
2849
 
 
2850
class ExcludeDecorator(TestDecorator):
 
2851
    """A decorator which excludes test matching an exclude pattern."""
 
2852
 
 
2853
    def __init__(self, suite, exclude_pattern):
 
2854
        TestDecorator.__init__(self, suite)
 
2855
        self.exclude_pattern = exclude_pattern
 
2856
        self.excluded = False
 
2857
 
 
2858
    def __iter__(self):
 
2859
        if self.excluded:
 
2860
            return iter(self._tests)
 
2861
        self.excluded = True
 
2862
        suite = exclude_tests_by_re(self, self.exclude_pattern)
 
2863
        del self._tests[:]
 
2864
        self.addTests(suite)
 
2865
        return iter(self._tests)
 
2866
 
 
2867
 
 
2868
class FilterTestsDecorator(TestDecorator):
 
2869
    """A decorator which filters tests to those matching a pattern."""
 
2870
 
 
2871
    def __init__(self, suite, pattern):
 
2872
        TestDecorator.__init__(self, suite)
 
2873
        self.pattern = pattern
 
2874
        self.filtered = False
 
2875
 
 
2876
    def __iter__(self):
 
2877
        if self.filtered:
 
2878
            return iter(self._tests)
 
2879
        self.filtered = True
 
2880
        suite = filter_suite_by_re(self, self.pattern)
 
2881
        del self._tests[:]
 
2882
        self.addTests(suite)
 
2883
        return iter(self._tests)
 
2884
 
 
2885
 
 
2886
class RandomDecorator(TestDecorator):
 
2887
    """A decorator which randomises the order of its tests."""
 
2888
 
 
2889
    def __init__(self, suite, random_seed, stream):
 
2890
        TestDecorator.__init__(self, suite)
 
2891
        self.random_seed = random_seed
 
2892
        self.randomised = False
 
2893
        self.stream = stream
 
2894
 
 
2895
    def __iter__(self):
 
2896
        if self.randomised:
 
2897
            return iter(self._tests)
 
2898
        self.randomised = True
 
2899
        self.stream.writeln("Randomizing test order using seed %s\n" %
 
2900
            (self.actual_seed()))
 
2901
        # Initialise the random number generator.
 
2902
        random.seed(self.actual_seed())
 
2903
        suite = randomize_suite(self)
 
2904
        del self._tests[:]
 
2905
        self.addTests(suite)
 
2906
        return iter(self._tests)
 
2907
 
 
2908
    def actual_seed(self):
 
2909
        if self.random_seed == "now":
 
2910
            # We convert the seed to a long to make it reuseable across
 
2911
            # invocations (because the user can reenter it).
 
2912
            self.random_seed = long(time.time())
 
2913
        else:
 
2914
            # Convert the seed to a long if we can
 
2915
            try:
 
2916
                self.random_seed = long(self.random_seed)
 
2917
            except:
 
2918
                pass
 
2919
        return self.random_seed
 
2920
 
 
2921
 
 
2922
class TestFirstDecorator(TestDecorator):
 
2923
    """A decorator which moves named tests to the front."""
 
2924
 
 
2925
    def __init__(self, suite, pattern):
 
2926
        TestDecorator.__init__(self, suite)
 
2927
        self.pattern = pattern
 
2928
        self.filtered = False
 
2929
 
 
2930
    def __iter__(self):
 
2931
        if self.filtered:
 
2932
            return iter(self._tests)
 
2933
        self.filtered = True
 
2934
        suites = split_suite_by_re(self, self.pattern)
 
2935
        del self._tests[:]
 
2936
        self.addTests(suites)
 
2937
        return iter(self._tests)
 
2938
 
 
2939
 
 
2940
def partition_tests(suite, count):
 
2941
    """Partition suite into count lists of tests."""
 
2942
    result = []
 
2943
    tests = list(iter_suite_tests(suite))
 
2944
    tests_per_process = int(math.ceil(float(len(tests)) / count))
 
2945
    for block in range(count):
 
2946
        low_test = block * tests_per_process
 
2947
        high_test = low_test + tests_per_process
 
2948
        process_tests = tests[low_test:high_test]
 
2949
        result.append(process_tests)
 
2950
    return result
 
2951
 
 
2952
 
 
2953
def fork_for_tests(suite):
 
2954
    """Take suite and start up one runner per CPU by forking()
 
2955
 
 
2956
    :return: An iterable of TestCase-like objects which can each have
 
2957
        run(result) called on them to feed tests to result.
 
2958
    """
 
2959
    concurrency = osutils.local_concurrency()
 
2960
    result = []
 
2961
    from subunit import TestProtocolClient, ProtocolTestCase
 
2962
    class TestInOtherProcess(ProtocolTestCase):
 
2963
        # Should be in subunit, I think. RBC.
 
2964
        def __init__(self, stream, pid):
 
2965
            ProtocolTestCase.__init__(self, stream)
 
2966
            self.pid = pid
 
2967
 
 
2968
        def run(self, result):
 
2969
            try:
 
2970
                ProtocolTestCase.run(self, result)
 
2971
            finally:
 
2972
                os.waitpid(self.pid, os.WNOHANG)
 
2973
 
 
2974
    test_blocks = partition_tests(suite, concurrency)
 
2975
    for process_tests in test_blocks:
 
2976
        process_suite = TestSuite()
 
2977
        process_suite.addTests(process_tests)
 
2978
        c2pread, c2pwrite = os.pipe()
 
2979
        pid = os.fork()
 
2980
        if pid == 0:
 
2981
            try:
 
2982
                os.close(c2pread)
 
2983
                # Leave stderr and stdout open so we can see test noise
 
2984
                # Close stdin so that the child goes away if it decides to
 
2985
                # read from stdin (otherwise its a roulette to see what
 
2986
                # child actually gets keystrokes for pdb etc).
 
2987
                sys.stdin.close()
 
2988
                sys.stdin = None
 
2989
                stream = os.fdopen(c2pwrite, 'wb', 1)
 
2990
                subunit_result = TestProtocolClient(stream)
 
2991
                process_suite.run(subunit_result)
 
2992
            finally:
 
2993
                os._exit(0)
 
2994
        else:
 
2995
            os.close(c2pwrite)
 
2996
            stream = os.fdopen(c2pread, 'rb', 1)
 
2997
            test = TestInOtherProcess(stream, pid)
 
2998
            result.append(test)
 
2999
    return result
 
3000
 
 
3001
 
 
3002
def reinvoke_for_tests(suite):
 
3003
    """Take suite and start up one runner per CPU using subprocess().
 
3004
 
 
3005
    :return: An iterable of TestCase-like objects which can each have
 
3006
        run(result) called on them to feed tests to result.
 
3007
    """
 
3008
    concurrency = osutils.local_concurrency()
 
3009
    result = []
 
3010
    from subunit import ProtocolTestCase
 
3011
    class TestInSubprocess(ProtocolTestCase):
 
3012
        def __init__(self, process, name):
 
3013
            ProtocolTestCase.__init__(self, process.stdout)
 
3014
            self.process = process
 
3015
            self.process.stdin.close()
 
3016
            self.name = name
 
3017
 
 
3018
        def run(self, result):
 
3019
            try:
 
3020
                ProtocolTestCase.run(self, result)
 
3021
            finally:
 
3022
                self.process.wait()
 
3023
                os.unlink(self.name)
 
3024
            # print "pid %d finished" % finished_process
 
3025
    test_blocks = partition_tests(suite, concurrency)
 
3026
    for process_tests in test_blocks:
 
3027
        # ugly; currently reimplement rather than reuses TestCase methods.
 
3028
        bzr_path = os.path.dirname(os.path.dirname(bzrlib.__file__))+'/bzr'
 
3029
        if not os.path.isfile(bzr_path):
 
3030
            # We are probably installed. Assume sys.argv is the right file
 
3031
            bzr_path = sys.argv[0]
 
3032
        fd, test_list_file_name = tempfile.mkstemp()
 
3033
        test_list_file = os.fdopen(fd, 'wb', 1)
 
3034
        for test in process_tests:
 
3035
            test_list_file.write(test.id() + '\n')
 
3036
        test_list_file.close()
 
3037
        try:
 
3038
            argv = [bzr_path, 'selftest', '--load-list', test_list_file_name,
 
3039
                '--subunit']
 
3040
            if '--no-plugins' in sys.argv:
 
3041
                argv.append('--no-plugins')
 
3042
            # stderr=STDOUT would be ideal, but until we prevent noise on
 
3043
            # stderr it can interrupt the subunit protocol.
 
3044
            process = Popen(argv, stdin=PIPE, stdout=PIPE, stderr=PIPE,
 
3045
                bufsize=1)
 
3046
            test = TestInSubprocess(process, test_list_file_name)
 
3047
            result.append(test)
 
3048
        except:
 
3049
            os.unlink(test_list_file_name)
 
3050
            raise
 
3051
    return result
 
3052
 
 
3053
 
 
3054
class BZRTransformingResult(unittest.TestResult):
 
3055
 
 
3056
    def __init__(self, target):
 
3057
        unittest.TestResult.__init__(self)
 
3058
        self.result = target
 
3059
 
 
3060
    def startTest(self, test):
 
3061
        self.result.startTest(test)
 
3062
 
 
3063
    def stopTest(self, test):
 
3064
        self.result.stopTest(test)
 
3065
 
 
3066
    def addError(self, test, err):
 
3067
        feature = self._error_looks_like('UnavailableFeature: ', err)
 
3068
        if feature is not None:
 
3069
            self.result.addNotSupported(test, feature)
 
3070
        else:
 
3071
            self.result.addError(test, err)
 
3072
 
 
3073
    def addFailure(self, test, err):
 
3074
        known = self._error_looks_like('KnownFailure: ', err)
 
3075
        if known is not None:
 
3076
            self.result._addKnownFailure(test, [KnownFailure,
 
3077
                                                KnownFailure(known), None])
 
3078
        else:
 
3079
            self.result.addFailure(test, err)
 
3080
 
 
3081
    def addSkip(self, test, reason):
 
3082
        self.result.addSkip(test, reason)
 
3083
 
 
3084
    def addSuccess(self, test):
 
3085
        self.result.addSuccess(test)
 
3086
 
 
3087
    def _error_looks_like(self, prefix, err):
 
3088
        """Deserialize exception and returns the stringify value."""
 
3089
        import subunit
 
3090
        value = None
 
3091
        typ, exc, _ = err
 
3092
        if isinstance(exc, subunit.RemoteException):
 
3093
            # stringify the exception gives access to the remote traceback
 
3094
            # We search the last line for 'prefix'
 
3095
            lines = str(exc).split('\n')
 
3096
            while lines and not lines[-1]:
 
3097
                lines.pop(-1)
 
3098
            if lines:
 
3099
                if lines[-1].startswith(prefix):
 
3100
                    value = lines[-1][len(prefix):]
 
3101
        return value
 
3102
 
 
3103
 
 
3104
# Controlled by "bzr selftest -E=..." option
 
3105
selftest_debug_flags = set()
1231
3106
 
1232
3107
 
1233
3108
def selftest(verbose=False, pattern=".*", stop_on_failure=True,
1234
 
             keep_output=False,
1235
3109
             transport=None,
1236
3110
             test_suite_factory=None,
1237
 
             lsprof_timed=None):
 
3111
             lsprof_timed=None,
 
3112
             bench_history=None,
 
3113
             matching_tests_first=None,
 
3114
             list_only=False,
 
3115
             random_seed=None,
 
3116
             exclude_pattern=None,
 
3117
             strict=False,
 
3118
             load_list=None,
 
3119
             debug_flags=None,
 
3120
             starting_with=None,
 
3121
             runner_class=None,
 
3122
             suite_decorators=None,
 
3123
             ):
1238
3124
    """Run the whole test suite under the enhanced runner"""
1239
3125
    # XXX: Very ugly way to do this...
1240
3126
    # Disable warning about old formats because we don't want it to disturb
1247
3133
        transport = default_transport
1248
3134
    old_transport = default_transport
1249
3135
    default_transport = transport
 
3136
    global selftest_debug_flags
 
3137
    old_debug_flags = selftest_debug_flags
 
3138
    if debug_flags is not None:
 
3139
        selftest_debug_flags = set(debug_flags)
1250
3140
    try:
 
3141
        if load_list is None:
 
3142
            keep_only = None
 
3143
        else:
 
3144
            keep_only = load_test_id_list(load_list)
1251
3145
        if test_suite_factory is None:
1252
 
            suite = test_suite()
 
3146
            suite = test_suite(keep_only, starting_with)
1253
3147
        else:
1254
3148
            suite = test_suite_factory()
1255
3149
        return run_suite(suite, 'testbzr', verbose=verbose, pattern=pattern,
1256
 
                     stop_on_failure=stop_on_failure, keep_output=keep_output,
 
3150
                     stop_on_failure=stop_on_failure,
1257
3151
                     transport=transport,
1258
 
                     lsprof_timed=lsprof_timed)
 
3152
                     lsprof_timed=lsprof_timed,
 
3153
                     bench_history=bench_history,
 
3154
                     matching_tests_first=matching_tests_first,
 
3155
                     list_only=list_only,
 
3156
                     random_seed=random_seed,
 
3157
                     exclude_pattern=exclude_pattern,
 
3158
                     strict=strict,
 
3159
                     runner_class=runner_class,
 
3160
                     suite_decorators=suite_decorators,
 
3161
                     )
1259
3162
    finally:
1260
3163
        default_transport = old_transport
1261
 
 
1262
 
 
1263
 
def test_suite():
 
3164
        selftest_debug_flags = old_debug_flags
 
3165
 
 
3166
 
 
3167
def load_test_id_list(file_name):
 
3168
    """Load a test id list from a text file.
 
3169
 
 
3170
    The format is one test id by line.  No special care is taken to impose
 
3171
    strict rules, these test ids are used to filter the test suite so a test id
 
3172
    that do not match an existing test will do no harm. This allows user to add
 
3173
    comments, leave blank lines, etc.
 
3174
    """
 
3175
    test_list = []
 
3176
    try:
 
3177
        ftest = open(file_name, 'rt')
 
3178
    except IOError, e:
 
3179
        if e.errno != errno.ENOENT:
 
3180
            raise
 
3181
        else:
 
3182
            raise errors.NoSuchFile(file_name)
 
3183
 
 
3184
    for test_name in ftest.readlines():
 
3185
        test_list.append(test_name.strip())
 
3186
    ftest.close()
 
3187
    return test_list
 
3188
 
 
3189
 
 
3190
def suite_matches_id_list(test_suite, id_list):
 
3191
    """Warns about tests not appearing or appearing more than once.
 
3192
 
 
3193
    :param test_suite: A TestSuite object.
 
3194
    :param test_id_list: The list of test ids that should be found in
 
3195
         test_suite.
 
3196
 
 
3197
    :return: (absents, duplicates) absents is a list containing the test found
 
3198
        in id_list but not in test_suite, duplicates is a list containing the
 
3199
        test found multiple times in test_suite.
 
3200
 
 
3201
    When using a prefined test id list, it may occurs that some tests do not
 
3202
    exist anymore or that some tests use the same id. This function warns the
 
3203
    tester about potential problems in his workflow (test lists are volatile)
 
3204
    or in the test suite itself (using the same id for several tests does not
 
3205
    help to localize defects).
 
3206
    """
 
3207
    # Build a dict counting id occurrences
 
3208
    tests = dict()
 
3209
    for test in iter_suite_tests(test_suite):
 
3210
        id = test.id()
 
3211
        tests[id] = tests.get(id, 0) + 1
 
3212
 
 
3213
    not_found = []
 
3214
    duplicates = []
 
3215
    for id in id_list:
 
3216
        occurs = tests.get(id, 0)
 
3217
        if not occurs:
 
3218
            not_found.append(id)
 
3219
        elif occurs > 1:
 
3220
            duplicates.append(id)
 
3221
 
 
3222
    return not_found, duplicates
 
3223
 
 
3224
 
 
3225
class TestIdList(object):
 
3226
    """Test id list to filter a test suite.
 
3227
 
 
3228
    Relying on the assumption that test ids are built as:
 
3229
    <module>[.<class>.<method>][(<param>+)], <module> being in python dotted
 
3230
    notation, this class offers methods to :
 
3231
    - avoid building a test suite for modules not refered to in the test list,
 
3232
    - keep only the tests listed from the module test suite.
 
3233
    """
 
3234
 
 
3235
    def __init__(self, test_id_list):
 
3236
        # When a test suite needs to be filtered against us we compare test ids
 
3237
        # for equality, so a simple dict offers a quick and simple solution.
 
3238
        self.tests = dict().fromkeys(test_id_list, True)
 
3239
 
 
3240
        # While unittest.TestCase have ids like:
 
3241
        # <module>.<class>.<method>[(<param+)],
 
3242
        # doctest.DocTestCase can have ids like:
 
3243
        # <module>
 
3244
        # <module>.<class>
 
3245
        # <module>.<function>
 
3246
        # <module>.<class>.<method>
 
3247
 
 
3248
        # Since we can't predict a test class from its name only, we settle on
 
3249
        # a simple constraint: a test id always begins with its module name.
 
3250
 
 
3251
        modules = {}
 
3252
        for test_id in test_id_list:
 
3253
            parts = test_id.split('.')
 
3254
            mod_name = parts.pop(0)
 
3255
            modules[mod_name] = True
 
3256
            for part in parts:
 
3257
                mod_name += '.' + part
 
3258
                modules[mod_name] = True
 
3259
        self.modules = modules
 
3260
 
 
3261
    def refers_to(self, module_name):
 
3262
        """Is there tests for the module or one of its sub modules."""
 
3263
        return self.modules.has_key(module_name)
 
3264
 
 
3265
    def includes(self, test_id):
 
3266
        return self.tests.has_key(test_id)
 
3267
 
 
3268
 
 
3269
class TestPrefixAliasRegistry(registry.Registry):
 
3270
    """A registry for test prefix aliases.
 
3271
 
 
3272
    This helps implement shorcuts for the --starting-with selftest
 
3273
    option. Overriding existing prefixes is not allowed but not fatal (a
 
3274
    warning will be emitted).
 
3275
    """
 
3276
 
 
3277
    def register(self, key, obj, help=None, info=None,
 
3278
                 override_existing=False):
 
3279
        """See Registry.register.
 
3280
 
 
3281
        Trying to override an existing alias causes a warning to be emitted,
 
3282
        not a fatal execption.
 
3283
        """
 
3284
        try:
 
3285
            super(TestPrefixAliasRegistry, self).register(
 
3286
                key, obj, help=help, info=info, override_existing=False)
 
3287
        except KeyError:
 
3288
            actual = self.get(key)
 
3289
            note('Test prefix alias %s is already used for %s, ignoring %s'
 
3290
                 % (key, actual, obj))
 
3291
 
 
3292
    def resolve_alias(self, id_start):
 
3293
        """Replace the alias by the prefix in the given string.
 
3294
 
 
3295
        Using an unknown prefix is an error to help catching typos.
 
3296
        """
 
3297
        parts = id_start.split('.')
 
3298
        try:
 
3299
            parts[0] = self.get(parts[0])
 
3300
        except KeyError:
 
3301
            raise errors.BzrCommandError(
 
3302
                '%s is not a known test prefix alias' % parts[0])
 
3303
        return '.'.join(parts)
 
3304
 
 
3305
 
 
3306
test_prefix_alias_registry = TestPrefixAliasRegistry()
 
3307
"""Registry of test prefix aliases."""
 
3308
 
 
3309
 
 
3310
# This alias allows to detect typos ('bzrlin.') by making all valid test ids
 
3311
# appear prefixed ('bzrlib.' is "replaced" by 'bzrlib.').
 
3312
test_prefix_alias_registry.register('bzrlib', 'bzrlib')
 
3313
 
 
3314
# Obvious higest levels prefixes, feel free to add your own via a plugin
 
3315
test_prefix_alias_registry.register('bd', 'bzrlib.doc')
 
3316
test_prefix_alias_registry.register('bu', 'bzrlib.utils')
 
3317
test_prefix_alias_registry.register('bt', 'bzrlib.tests')
 
3318
test_prefix_alias_registry.register('bb', 'bzrlib.tests.blackbox')
 
3319
test_prefix_alias_registry.register('bp', 'bzrlib.plugins')
 
3320
 
 
3321
 
 
3322
def test_suite(keep_only=None, starting_with=None):
1264
3323
    """Build and return TestSuite for the whole of bzrlib.
1265
 
    
 
3324
 
 
3325
    :param keep_only: A list of test ids limiting the suite returned.
 
3326
 
 
3327
    :param starting_with: An id limiting the suite returned to the tests
 
3328
         starting with it.
 
3329
 
1266
3330
    This function can be replaced if you need to change the default test
1267
3331
    suite on a global basis, but it is not encouraged.
1268
3332
    """
1269
3333
    testmod_names = [
 
3334
                   'bzrlib.doc',
 
3335
                   'bzrlib.tests.blackbox',
 
3336
                   'bzrlib.tests.branch_implementations',
 
3337
                   'bzrlib.tests.bzrdir_implementations',
 
3338
                   'bzrlib.tests.commands',
 
3339
                   'bzrlib.tests.interrepository_implementations',
 
3340
                   'bzrlib.tests.intertree_implementations',
 
3341
                   'bzrlib.tests.inventory_implementations',
 
3342
                   'bzrlib.tests.per_interbranch',
 
3343
                   'bzrlib.tests.per_lock',
 
3344
                   'bzrlib.tests.per_repository',
 
3345
                   'bzrlib.tests.per_repository_chk',
 
3346
                   'bzrlib.tests.per_repository_reference',
 
3347
                   'bzrlib.tests.test__annotator',
 
3348
                   'bzrlib.tests.test__chk_map',
 
3349
                   'bzrlib.tests.test__dirstate_helpers',
 
3350
                   'bzrlib.tests.test__groupcompress',
 
3351
                   'bzrlib.tests.test__known_graph',
 
3352
                   'bzrlib.tests.test__rio',
 
3353
                   'bzrlib.tests.test__walkdirs_win32',
1270
3354
                   'bzrlib.tests.test_ancestry',
 
3355
                   'bzrlib.tests.test_annotate',
1271
3356
                   'bzrlib.tests.test_api',
1272
3357
                   'bzrlib.tests.test_atomicfile',
1273
3358
                   'bzrlib.tests.test_bad_files',
 
3359
                   'bzrlib.tests.test_bencode',
 
3360
                   'bzrlib.tests.test_bisect_multi',
1274
3361
                   'bzrlib.tests.test_branch',
 
3362
                   'bzrlib.tests.test_branchbuilder',
 
3363
                   'bzrlib.tests.test_btree_index',
 
3364
                   'bzrlib.tests.test_bugtracker',
1275
3365
                   'bzrlib.tests.test_bundle',
1276
3366
                   'bzrlib.tests.test_bzrdir',
1277
 
                   'bzrlib.tests.test_command',
 
3367
                   'bzrlib.tests.test__chunks_to_lines',
 
3368
                   'bzrlib.tests.test_cache_utf8',
 
3369
                   'bzrlib.tests.test_chk_map',
 
3370
                   'bzrlib.tests.test_chk_serializer',
 
3371
                   'bzrlib.tests.test_chunk_writer',
 
3372
                   'bzrlib.tests.test_clean_tree',
 
3373
                   'bzrlib.tests.test_commands',
1278
3374
                   'bzrlib.tests.test_commit',
1279
3375
                   'bzrlib.tests.test_commit_merge',
1280
3376
                   'bzrlib.tests.test_config',
1281
3377
                   'bzrlib.tests.test_conflicts',
 
3378
                   'bzrlib.tests.test_counted_lock',
1282
3379
                   'bzrlib.tests.test_decorators',
 
3380
                   'bzrlib.tests.test_delta',
 
3381
                   'bzrlib.tests.test_debug',
 
3382
                   'bzrlib.tests.test_deprecated_graph',
1283
3383
                   'bzrlib.tests.test_diff',
1284
 
                   'bzrlib.tests.test_doc_generate',
 
3384
                   'bzrlib.tests.test_directory_service',
 
3385
                   'bzrlib.tests.test_dirstate',
 
3386
                   'bzrlib.tests.test_email_message',
 
3387
                   'bzrlib.tests.test_eol_filters',
1285
3388
                   'bzrlib.tests.test_errors',
1286
 
                   'bzrlib.tests.test_escaped_store',
 
3389
                   'bzrlib.tests.test_export',
 
3390
                   'bzrlib.tests.test_extract',
1287
3391
                   'bzrlib.tests.test_fetch',
 
3392
                   'bzrlib.tests.test_fifo_cache',
 
3393
                   'bzrlib.tests.test_filters',
 
3394
                   'bzrlib.tests.test_ftp_transport',
 
3395
                   'bzrlib.tests.test_foreign',
 
3396
                   'bzrlib.tests.test_generate_docs',
 
3397
                   'bzrlib.tests.test_generate_ids',
 
3398
                   'bzrlib.tests.test_globbing',
1288
3399
                   'bzrlib.tests.test_gpg',
1289
3400
                   'bzrlib.tests.test_graph',
 
3401
                   'bzrlib.tests.test_groupcompress',
1290
3402
                   'bzrlib.tests.test_hashcache',
 
3403
                   'bzrlib.tests.test_help',
 
3404
                   'bzrlib.tests.test_hooks',
1291
3405
                   'bzrlib.tests.test_http',
1292
3406
                   'bzrlib.tests.test_http_response',
 
3407
                   'bzrlib.tests.test_https_ca_bundle',
1293
3408
                   'bzrlib.tests.test_identitymap',
1294
3409
                   'bzrlib.tests.test_ignores',
 
3410
                   'bzrlib.tests.test_index',
 
3411
                   'bzrlib.tests.test_info',
1295
3412
                   'bzrlib.tests.test_inv',
 
3413
                   'bzrlib.tests.test_inventory_delta',
1296
3414
                   'bzrlib.tests.test_knit',
 
3415
                   'bzrlib.tests.test_lazy_import',
 
3416
                   'bzrlib.tests.test_lazy_regex',
 
3417
                   'bzrlib.tests.test_lockable_files',
1297
3418
                   'bzrlib.tests.test_lockdir',
1298
 
                   'bzrlib.tests.test_lockable_files',
1299
3419
                   'bzrlib.tests.test_log',
 
3420
                   'bzrlib.tests.test_lru_cache',
 
3421
                   'bzrlib.tests.test_lsprof',
 
3422
                   'bzrlib.tests.test_mail_client',
 
3423
                   'bzrlib.tests.test_memorytree',
1300
3424
                   'bzrlib.tests.test_merge',
1301
3425
                   'bzrlib.tests.test_merge3',
1302
3426
                   'bzrlib.tests.test_merge_core',
 
3427
                   'bzrlib.tests.test_merge_directive',
1303
3428
                   'bzrlib.tests.test_missing',
1304
3429
                   'bzrlib.tests.test_msgeditor',
 
3430
                   'bzrlib.tests.test_multiparent',
 
3431
                   'bzrlib.tests.test_mutabletree',
1305
3432
                   'bzrlib.tests.test_nonascii',
1306
3433
                   'bzrlib.tests.test_options',
1307
3434
                   'bzrlib.tests.test_osutils',
 
3435
                   'bzrlib.tests.test_osutils_encodings',
 
3436
                   'bzrlib.tests.test_pack',
 
3437
                   'bzrlib.tests.test_pack_repository',
1308
3438
                   'bzrlib.tests.test_patch',
1309
3439
                   'bzrlib.tests.test_patches',
1310
3440
                   'bzrlib.tests.test_permissions',
1311
3441
                   'bzrlib.tests.test_plugins',
1312
3442
                   'bzrlib.tests.test_progress',
 
3443
                   'bzrlib.tests.test_read_bundle',
1313
3444
                   'bzrlib.tests.test_reconcile',
 
3445
                   'bzrlib.tests.test_reconfigure',
 
3446
                   'bzrlib.tests.test_registry',
 
3447
                   'bzrlib.tests.test_remote',
 
3448
                   'bzrlib.tests.test_rename_map',
1314
3449
                   'bzrlib.tests.test_repository',
 
3450
                   'bzrlib.tests.test_revert',
1315
3451
                   'bzrlib.tests.test_revision',
1316
 
                   'bzrlib.tests.test_revisionnamespaces',
 
3452
                   'bzrlib.tests.test_revisionspec',
1317
3453
                   'bzrlib.tests.test_revisiontree',
1318
3454
                   'bzrlib.tests.test_rio',
 
3455
                   'bzrlib.tests.test_rules',
1319
3456
                   'bzrlib.tests.test_sampler',
1320
3457
                   'bzrlib.tests.test_selftest',
 
3458
                   'bzrlib.tests.test_serializer',
1321
3459
                   'bzrlib.tests.test_setup',
1322
3460
                   'bzrlib.tests.test_sftp_transport',
 
3461
                   'bzrlib.tests.test_shelf',
 
3462
                   'bzrlib.tests.test_shelf_ui',
 
3463
                   'bzrlib.tests.test_smart',
1323
3464
                   'bzrlib.tests.test_smart_add',
 
3465
                   'bzrlib.tests.test_smart_request',
 
3466
                   'bzrlib.tests.test_smart_transport',
 
3467
                   'bzrlib.tests.test_smtp_connection',
1324
3468
                   'bzrlib.tests.test_source',
 
3469
                   'bzrlib.tests.test_ssh_transport',
1325
3470
                   'bzrlib.tests.test_status',
1326
3471
                   'bzrlib.tests.test_store',
 
3472
                   'bzrlib.tests.test_strace',
 
3473
                   'bzrlib.tests.test_subsume',
 
3474
                   'bzrlib.tests.test_switch',
1327
3475
                   'bzrlib.tests.test_symbol_versioning',
 
3476
                   'bzrlib.tests.test_tag',
1328
3477
                   'bzrlib.tests.test_testament',
1329
3478
                   'bzrlib.tests.test_textfile',
1330
3479
                   'bzrlib.tests.test_textmerge',
 
3480
                   'bzrlib.tests.test_timestamp',
1331
3481
                   'bzrlib.tests.test_trace',
1332
3482
                   'bzrlib.tests.test_transactions',
1333
3483
                   'bzrlib.tests.test_transform',
1334
3484
                   'bzrlib.tests.test_transport',
 
3485
                   'bzrlib.tests.test_transport_implementations',
 
3486
                   'bzrlib.tests.test_transport_log',
1335
3487
                   'bzrlib.tests.test_tree',
 
3488
                   'bzrlib.tests.test_treebuilder',
1336
3489
                   'bzrlib.tests.test_tsort',
1337
3490
                   'bzrlib.tests.test_tuned_gzip',
1338
3491
                   'bzrlib.tests.test_ui',
 
3492
                   'bzrlib.tests.test_uncommit',
1339
3493
                   'bzrlib.tests.test_upgrade',
 
3494
                   'bzrlib.tests.test_upgrade_stacked',
1340
3495
                   'bzrlib.tests.test_urlutils',
 
3496
                   'bzrlib.tests.test_version',
 
3497
                   'bzrlib.tests.test_version_info',
1341
3498
                   'bzrlib.tests.test_versionedfile',
1342
3499
                   'bzrlib.tests.test_weave',
1343
3500
                   'bzrlib.tests.test_whitebox',
 
3501
                   'bzrlib.tests.test_win32utils',
1344
3502
                   'bzrlib.tests.test_workingtree',
 
3503
                   'bzrlib.tests.test_workingtree_4',
 
3504
                   'bzrlib.tests.test_wsgi',
1345
3505
                   'bzrlib.tests.test_xml',
 
3506
                   'bzrlib.tests.tree_implementations',
 
3507
                   'bzrlib.tests.workingtree_implementations',
1346
3508
                   ]
1347
 
    test_transport_implementations = [
1348
 
        'bzrlib.tests.test_transport_implementations',
1349
 
        'bzrlib.tests.test_read_bundle',
1350
 
        ]
1351
 
    suite = TestUtil.TestSuite()
 
3509
 
1352
3510
    loader = TestUtil.TestLoader()
 
3511
 
 
3512
    if keep_only is not None:
 
3513
        id_filter = TestIdList(keep_only)
 
3514
    if starting_with:
 
3515
        starting_with = [test_prefix_alias_registry.resolve_alias(start)
 
3516
                         for start in starting_with]
 
3517
        # We take precedence over keep_only because *at loading time* using
 
3518
        # both options means we will load less tests for the same final result.
 
3519
        def interesting_module(name):
 
3520
            for start in starting_with:
 
3521
                if (
 
3522
                    # Either the module name starts with the specified string
 
3523
                    name.startswith(start)
 
3524
                    # or it may contain tests starting with the specified string
 
3525
                    or start.startswith(name)
 
3526
                    ):
 
3527
                    return True
 
3528
            return False
 
3529
        loader = TestUtil.FilteredByModuleTestLoader(interesting_module)
 
3530
 
 
3531
    elif keep_only is not None:
 
3532
        loader = TestUtil.FilteredByModuleTestLoader(id_filter.refers_to)
 
3533
        def interesting_module(name):
 
3534
            return id_filter.refers_to(name)
 
3535
 
 
3536
    else:
 
3537
        loader = TestUtil.TestLoader()
 
3538
        def interesting_module(name):
 
3539
            # No filtering, all modules are interesting
 
3540
            return True
 
3541
 
 
3542
    suite = loader.suiteClass()
 
3543
 
 
3544
    # modules building their suite with loadTestsFromModuleNames
1353
3545
    suite.addTest(loader.loadTestsFromModuleNames(testmod_names))
1354
 
    from bzrlib.transport import TransportTestProviderAdapter
1355
 
    adapter = TransportTestProviderAdapter()
1356
 
    adapt_modules(test_transport_implementations, adapter, loader, suite)
1357
 
    for package in packages_to_test():
1358
 
        suite.addTest(package.test_suite())
1359
 
    for m in MODULES_TO_TEST:
1360
 
        suite.addTest(loader.loadTestsFromModule(m))
1361
 
    for m in MODULES_TO_DOCTEST:
1362
 
        suite.addTest(doctest.DocTestSuite(m))
1363
 
    for name, plugin in bzrlib.plugin.all_plugins().items():
1364
 
        if getattr(plugin, 'test_suite', None) is not None:
1365
 
            suite.addTest(plugin.test_suite())
 
3546
 
 
3547
    modules_to_doctest = [
 
3548
        'bzrlib',
 
3549
        'bzrlib.branchbuilder',
 
3550
        'bzrlib.export',
 
3551
        'bzrlib.inventory',
 
3552
        'bzrlib.iterablefile',
 
3553
        'bzrlib.lockdir',
 
3554
        'bzrlib.merge3',
 
3555
        'bzrlib.option',
 
3556
        'bzrlib.symbol_versioning',
 
3557
        'bzrlib.tests',
 
3558
        'bzrlib.timestamp',
 
3559
        'bzrlib.version_info_formats.format_custom',
 
3560
        ]
 
3561
 
 
3562
    for mod in modules_to_doctest:
 
3563
        if not interesting_module(mod):
 
3564
            # No tests to keep here, move along
 
3565
            continue
 
3566
        try:
 
3567
            # note that this really does mean "report only" -- doctest
 
3568
            # still runs the rest of the examples
 
3569
            doc_suite = doctest.DocTestSuite(mod,
 
3570
                optionflags=doctest.REPORT_ONLY_FIRST_FAILURE)
 
3571
        except ValueError, e:
 
3572
            print '**failed to get doctest for: %s\n%s' % (mod, e)
 
3573
            raise
 
3574
        if len(doc_suite._tests) == 0:
 
3575
            raise errors.BzrError("no doctests found in %s" % (mod,))
 
3576
        suite.addTest(doc_suite)
 
3577
 
 
3578
    default_encoding = sys.getdefaultencoding()
 
3579
    for name, plugin in bzrlib.plugin.plugins().items():
 
3580
        if not interesting_module(plugin.module.__name__):
 
3581
            continue
 
3582
        plugin_suite = plugin.test_suite()
 
3583
        # We used to catch ImportError here and turn it into just a warning,
 
3584
        # but really if you don't have --no-plugins this should be a failure.
 
3585
        # mbp 20080213 - see http://bugs.launchpad.net/bugs/189771
 
3586
        if plugin_suite is None:
 
3587
            plugin_suite = plugin.load_plugin_tests(loader)
 
3588
        if plugin_suite is not None:
 
3589
            suite.addTest(plugin_suite)
 
3590
        if default_encoding != sys.getdefaultencoding():
 
3591
            bzrlib.trace.warning(
 
3592
                'Plugin "%s" tried to reset default encoding to: %s', name,
 
3593
                sys.getdefaultencoding())
 
3594
            reload(sys)
 
3595
            sys.setdefaultencoding(default_encoding)
 
3596
 
 
3597
    if starting_with:
 
3598
        suite = filter_suite_by_id_startswith(suite, starting_with)
 
3599
 
 
3600
    if keep_only is not None:
 
3601
        # Now that the referred modules have loaded their tests, keep only the
 
3602
        # requested ones.
 
3603
        suite = filter_suite_by_id_list(suite, id_filter)
 
3604
        # Do some sanity checks on the id_list filtering
 
3605
        not_found, duplicates = suite_matches_id_list(suite, keep_only)
 
3606
        if starting_with:
 
3607
            # The tester has used both keep_only and starting_with, so he is
 
3608
            # already aware that some tests are excluded from the list, there
 
3609
            # is no need to tell him which.
 
3610
            pass
 
3611
        else:
 
3612
            # Some tests mentioned in the list are not in the test suite. The
 
3613
            # list may be out of date, report to the tester.
 
3614
            for id in not_found:
 
3615
                bzrlib.trace.warning('"%s" not found in the test suite', id)
 
3616
        for id in duplicates:
 
3617
            bzrlib.trace.warning('"%s" is used as an id by several tests', id)
 
3618
 
1366
3619
    return suite
1367
3620
 
1368
3621
 
1369
 
def adapt_modules(mods_list, adapter, loader, suite):
1370
 
    """Adapt the modules in mods_list using adapter and add to suite."""
1371
 
    for test in iter_suite_tests(loader.loadTestsFromModuleNames(mods_list)):
1372
 
        suite.addTests(adapter.adapt(test))
 
3622
def multiply_scenarios(scenarios_left, scenarios_right):
 
3623
    """Multiply two sets of scenarios.
 
3624
 
 
3625
    :returns: the cartesian product of the two sets of scenarios, that is
 
3626
        a scenario for every possible combination of a left scenario and a
 
3627
        right scenario.
 
3628
    """
 
3629
    return [
 
3630
        ('%s,%s' % (left_name, right_name),
 
3631
         dict(left_dict.items() + right_dict.items()))
 
3632
        for left_name, left_dict in scenarios_left
 
3633
        for right_name, right_dict in scenarios_right]
 
3634
 
 
3635
 
 
3636
def multiply_tests(tests, scenarios, result):
 
3637
    """Multiply tests_list by scenarios into result.
 
3638
 
 
3639
    This is the core workhorse for test parameterisation.
 
3640
 
 
3641
    Typically the load_tests() method for a per-implementation test suite will
 
3642
    call multiply_tests and return the result.
 
3643
 
 
3644
    :param tests: The tests to parameterise.
 
3645
    :param scenarios: The scenarios to apply: pairs of (scenario_name,
 
3646
        scenario_param_dict).
 
3647
    :param result: A TestSuite to add created tests to.
 
3648
 
 
3649
    This returns the passed in result TestSuite with the cross product of all
 
3650
    the tests repeated once for each scenario.  Each test is adapted by adding
 
3651
    the scenario name at the end of its id(), and updating the test object's
 
3652
    __dict__ with the scenario_param_dict.
 
3653
 
 
3654
    >>> import bzrlib.tests.test_sampler
 
3655
    >>> r = multiply_tests(
 
3656
    ...     bzrlib.tests.test_sampler.DemoTest('test_nothing'),
 
3657
    ...     [('one', dict(param=1)),
 
3658
    ...      ('two', dict(param=2))],
 
3659
    ...     TestSuite())
 
3660
    >>> tests = list(iter_suite_tests(r))
 
3661
    >>> len(tests)
 
3662
    2
 
3663
    >>> tests[0].id()
 
3664
    'bzrlib.tests.test_sampler.DemoTest.test_nothing(one)'
 
3665
    >>> tests[0].param
 
3666
    1
 
3667
    >>> tests[1].param
 
3668
    2
 
3669
    """
 
3670
    for test in iter_suite_tests(tests):
 
3671
        apply_scenarios(test, scenarios, result)
 
3672
    return result
 
3673
 
 
3674
 
 
3675
def apply_scenarios(test, scenarios, result):
 
3676
    """Apply the scenarios in scenarios to test and add to result.
 
3677
 
 
3678
    :param test: The test to apply scenarios to.
 
3679
    :param scenarios: An iterable of scenarios to apply to test.
 
3680
    :return: result
 
3681
    :seealso: apply_scenario
 
3682
    """
 
3683
    for scenario in scenarios:
 
3684
        result.addTest(apply_scenario(test, scenario))
 
3685
    return result
 
3686
 
 
3687
 
 
3688
def apply_scenario(test, scenario):
 
3689
    """Copy test and apply scenario to it.
 
3690
 
 
3691
    :param test: A test to adapt.
 
3692
    :param scenario: A tuple describing the scenarion.
 
3693
        The first element of the tuple is the new test id.
 
3694
        The second element is a dict containing attributes to set on the
 
3695
        test.
 
3696
    :return: The adapted test.
 
3697
    """
 
3698
    new_id = "%s(%s)" % (test.id(), scenario[0])
 
3699
    new_test = clone_test(test, new_id)
 
3700
    for name, value in scenario[1].items():
 
3701
        setattr(new_test, name, value)
 
3702
    return new_test
 
3703
 
 
3704
 
 
3705
def clone_test(test, new_id):
 
3706
    """Clone a test giving it a new id.
 
3707
 
 
3708
    :param test: The test to clone.
 
3709
    :param new_id: The id to assign to it.
 
3710
    :return: The new test.
 
3711
    """
 
3712
    from copy import deepcopy
 
3713
    new_test = deepcopy(test)
 
3714
    new_test.id = lambda: new_id
 
3715
    return new_test
 
3716
 
 
3717
 
 
3718
def _rmtree_temp_dir(dirname):
 
3719
    # If LANG=C we probably have created some bogus paths
 
3720
    # which rmtree(unicode) will fail to delete
 
3721
    # so make sure we are using rmtree(str) to delete everything
 
3722
    # except on win32, where rmtree(str) will fail
 
3723
    # since it doesn't have the property of byte-stream paths
 
3724
    # (they are either ascii or mbcs)
 
3725
    if sys.platform == 'win32':
 
3726
        # make sure we are using the unicode win32 api
 
3727
        dirname = unicode(dirname)
 
3728
    else:
 
3729
        dirname = dirname.encode(sys.getfilesystemencoding())
 
3730
    try:
 
3731
        osutils.rmtree(dirname)
 
3732
    except OSError, e:
 
3733
        if sys.platform == 'win32' and e.errno == errno.EACCES:
 
3734
            sys.stderr.write('Permission denied: '
 
3735
                             'unable to remove testing dir '
 
3736
                             '%s\n%s'
 
3737
                             % (os.path.basename(dirname), e))
 
3738
        else:
 
3739
            raise
 
3740
 
 
3741
 
 
3742
class Feature(object):
 
3743
    """An operating system Feature."""
 
3744
 
 
3745
    def __init__(self):
 
3746
        self._available = None
 
3747
 
 
3748
    def available(self):
 
3749
        """Is the feature available?
 
3750
 
 
3751
        :return: True if the feature is available.
 
3752
        """
 
3753
        if self._available is None:
 
3754
            self._available = self._probe()
 
3755
        return self._available
 
3756
 
 
3757
    def _probe(self):
 
3758
        """Implement this method in concrete features.
 
3759
 
 
3760
        :return: True if the feature is available.
 
3761
        """
 
3762
        raise NotImplementedError
 
3763
 
 
3764
    def __str__(self):
 
3765
        if getattr(self, 'feature_name', None):
 
3766
            return self.feature_name()
 
3767
        return self.__class__.__name__
 
3768
 
 
3769
 
 
3770
class _SymlinkFeature(Feature):
 
3771
 
 
3772
    def _probe(self):
 
3773
        return osutils.has_symlinks()
 
3774
 
 
3775
    def feature_name(self):
 
3776
        return 'symlinks'
 
3777
 
 
3778
SymlinkFeature = _SymlinkFeature()
 
3779
 
 
3780
 
 
3781
class _HardlinkFeature(Feature):
 
3782
 
 
3783
    def _probe(self):
 
3784
        return osutils.has_hardlinks()
 
3785
 
 
3786
    def feature_name(self):
 
3787
        return 'hardlinks'
 
3788
 
 
3789
HardlinkFeature = _HardlinkFeature()
 
3790
 
 
3791
 
 
3792
class _OsFifoFeature(Feature):
 
3793
 
 
3794
    def _probe(self):
 
3795
        return getattr(os, 'mkfifo', None)
 
3796
 
 
3797
    def feature_name(self):
 
3798
        return 'filesystem fifos'
 
3799
 
 
3800
OsFifoFeature = _OsFifoFeature()
 
3801
 
 
3802
 
 
3803
class _UnicodeFilenameFeature(Feature):
 
3804
    """Does the filesystem support Unicode filenames?"""
 
3805
 
 
3806
    def _probe(self):
 
3807
        try:
 
3808
            # Check for character combinations unlikely to be covered by any
 
3809
            # single non-unicode encoding. We use the characters
 
3810
            # - greek small letter alpha (U+03B1) and
 
3811
            # - braille pattern dots-123456 (U+283F).
 
3812
            os.stat(u'\u03b1\u283f')
 
3813
        except UnicodeEncodeError:
 
3814
            return False
 
3815
        except (IOError, OSError):
 
3816
            # The filesystem allows the Unicode filename but the file doesn't
 
3817
            # exist.
 
3818
            return True
 
3819
        else:
 
3820
            # The filesystem allows the Unicode filename and the file exists,
 
3821
            # for some reason.
 
3822
            return True
 
3823
 
 
3824
UnicodeFilenameFeature = _UnicodeFilenameFeature()
 
3825
 
 
3826
 
 
3827
def probe_unicode_in_user_encoding():
 
3828
    """Try to encode several unicode strings to use in unicode-aware tests.
 
3829
    Return first successfull match.
 
3830
 
 
3831
    :return:  (unicode value, encoded plain string value) or (None, None)
 
3832
    """
 
3833
    possible_vals = [u'm\xb5', u'\xe1', u'\u0410']
 
3834
    for uni_val in possible_vals:
 
3835
        try:
 
3836
            str_val = uni_val.encode(osutils.get_user_encoding())
 
3837
        except UnicodeEncodeError:
 
3838
            # Try a different character
 
3839
            pass
 
3840
        else:
 
3841
            return uni_val, str_val
 
3842
    return None, None
 
3843
 
 
3844
 
 
3845
def probe_bad_non_ascii(encoding):
 
3846
    """Try to find [bad] character with code [128..255]
 
3847
    that cannot be decoded to unicode in some encoding.
 
3848
    Return None if all non-ascii characters is valid
 
3849
    for given encoding.
 
3850
    """
 
3851
    for i in xrange(128, 256):
 
3852
        char = chr(i)
 
3853
        try:
 
3854
            char.decode(encoding)
 
3855
        except UnicodeDecodeError:
 
3856
            return char
 
3857
    return None
 
3858
 
 
3859
 
 
3860
class _HTTPSServerFeature(Feature):
 
3861
    """Some tests want an https Server, check if one is available.
 
3862
 
 
3863
    Right now, the only way this is available is under python2.6 which provides
 
3864
    an ssl module.
 
3865
    """
 
3866
 
 
3867
    def _probe(self):
 
3868
        try:
 
3869
            import ssl
 
3870
            return True
 
3871
        except ImportError:
 
3872
            return False
 
3873
 
 
3874
    def feature_name(self):
 
3875
        return 'HTTPSServer'
 
3876
 
 
3877
 
 
3878
HTTPSServerFeature = _HTTPSServerFeature()
 
3879
 
 
3880
 
 
3881
class _UnicodeFilename(Feature):
 
3882
    """Does the filesystem support Unicode filenames?"""
 
3883
 
 
3884
    def _probe(self):
 
3885
        try:
 
3886
            os.stat(u'\u03b1')
 
3887
        except UnicodeEncodeError:
 
3888
            return False
 
3889
        except (IOError, OSError):
 
3890
            # The filesystem allows the Unicode filename but the file doesn't
 
3891
            # exist.
 
3892
            return True
 
3893
        else:
 
3894
            # The filesystem allows the Unicode filename and the file exists,
 
3895
            # for some reason.
 
3896
            return True
 
3897
 
 
3898
UnicodeFilename = _UnicodeFilename()
 
3899
 
 
3900
 
 
3901
class _UTF8Filesystem(Feature):
 
3902
    """Is the filesystem UTF-8?"""
 
3903
 
 
3904
    def _probe(self):
 
3905
        if osutils._fs_enc.upper() in ('UTF-8', 'UTF8'):
 
3906
            return True
 
3907
        return False
 
3908
 
 
3909
UTF8Filesystem = _UTF8Filesystem()
 
3910
 
 
3911
 
 
3912
class _CaseInsCasePresFilenameFeature(Feature):
 
3913
    """Is the file-system case insensitive, but case-preserving?"""
 
3914
 
 
3915
    def _probe(self):
 
3916
        fileno, name = tempfile.mkstemp(prefix='MixedCase')
 
3917
        try:
 
3918
            # first check truly case-preserving for created files, then check
 
3919
            # case insensitive when opening existing files.
 
3920
            name = osutils.normpath(name)
 
3921
            base, rel = osutils.split(name)
 
3922
            found_rel = osutils.canonical_relpath(base, name)
 
3923
            return (found_rel == rel
 
3924
                    and os.path.isfile(name.upper())
 
3925
                    and os.path.isfile(name.lower()))
 
3926
        finally:
 
3927
            os.close(fileno)
 
3928
            os.remove(name)
 
3929
 
 
3930
    def feature_name(self):
 
3931
        return "case-insensitive case-preserving filesystem"
 
3932
 
 
3933
CaseInsCasePresFilenameFeature = _CaseInsCasePresFilenameFeature()
 
3934
 
 
3935
 
 
3936
class _CaseInsensitiveFilesystemFeature(Feature):
 
3937
    """Check if underlying filesystem is case-insensitive but *not* case
 
3938
    preserving.
 
3939
    """
 
3940
    # Note that on Windows, Cygwin, MacOS etc, the file-systems are far
 
3941
    # more likely to be case preserving, so this case is rare.
 
3942
 
 
3943
    def _probe(self):
 
3944
        if CaseInsCasePresFilenameFeature.available():
 
3945
            return False
 
3946
 
 
3947
        if TestCaseWithMemoryTransport.TEST_ROOT is None:
 
3948
            root = osutils.mkdtemp(prefix='testbzr-', suffix='.tmp')
 
3949
            TestCaseWithMemoryTransport.TEST_ROOT = root
 
3950
        else:
 
3951
            root = TestCaseWithMemoryTransport.TEST_ROOT
 
3952
        tdir = osutils.mkdtemp(prefix='case-sensitive-probe-', suffix='',
 
3953
            dir=root)
 
3954
        name_a = osutils.pathjoin(tdir, 'a')
 
3955
        name_A = osutils.pathjoin(tdir, 'A')
 
3956
        os.mkdir(name_a)
 
3957
        result = osutils.isdir(name_A)
 
3958
        _rmtree_temp_dir(tdir)
 
3959
        return result
 
3960
 
 
3961
    def feature_name(self):
 
3962
        return 'case-insensitive filesystem'
 
3963
 
 
3964
CaseInsensitiveFilesystemFeature = _CaseInsensitiveFilesystemFeature()
 
3965
 
 
3966
 
 
3967
class _SubUnitFeature(Feature):
 
3968
    """Check if subunit is available."""
 
3969
 
 
3970
    def _probe(self):
 
3971
        try:
 
3972
            import subunit
 
3973
            return True
 
3974
        except ImportError:
 
3975
            return False
 
3976
 
 
3977
    def feature_name(self):
 
3978
        return 'subunit'
 
3979
 
 
3980
SubUnitFeature = _SubUnitFeature()
 
3981
# Only define SubUnitBzrRunner if subunit is available.
 
3982
try:
 
3983
    from subunit import TestProtocolClient
 
3984
    class SubUnitBzrRunner(TextTestRunner):
 
3985
        def run(self, test):
 
3986
            result = TestProtocolClient(self.stream)
 
3987
            test.run(result)
 
3988
            return result
 
3989
except ImportError:
 
3990
    pass