~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/__init__.py

  • Committer: Daniel Watkins
  • Date: 2007-08-02 18:04:35 UTC
  • mto: This revision was merged to the branch mainline in revision 2705.
  • Revision ID: d.m.watkins@warwick.ac.uk-20070802180435-cs6xalg5tkze209b
tests.blackbox.test_aliases now uses internals where appropriate.

Show diffs side-by-side

added added

removed removed

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