15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18
from cStringIO import StringIO
25
from testsweet import run_suite
32
26
import bzrlib.commands
33
from bzrlib.errors import BzrError
34
import bzrlib.inventory
35
import bzrlib.iterablefile
38
import bzrlib.osutils as osutils
41
28
import bzrlib.trace
42
from bzrlib.trace import mutter
43
from bzrlib.tests.TestUtil import TestLoader, TestSuite
44
from bzrlib.tests.treeshape import build_tree_contents
46
32
MODULES_TO_TEST = []
47
MODULES_TO_DOCTEST = [
57
def packages_to_test():
58
import bzrlib.tests.blackbox
64
class EarlyStoppingTestResultAdapter(object):
65
"""An adapter for TestResult to stop at the first first failure or error"""
67
def __init__(self, result):
70
def addError(self, test, err):
71
self._result.addError(test, err)
74
def addFailure(self, test, err):
75
self._result.addFailure(test, err)
78
def __getattr__(self, name):
79
return getattr(self._result, name)
81
def __setattr__(self, name, value):
83
object.__setattr__(self, name, value)
84
return setattr(self._result, name, value)
87
class _MyResult(unittest._TextTestResult):
90
Shows output in a different format, including displaying runtime for tests.
93
def _elapsedTime(self):
94
return "%5dms" % (1000 * (time.time() - self._start_time))
96
def startTest(self, test):
97
unittest.TestResult.startTest(self, test)
98
# In a short description, the important words are in
99
# the beginning, but in an id, the important words are
101
SHOW_DESCRIPTIONS = False
103
width = osutils.terminal_width()
104
name_width = width - 15
106
if SHOW_DESCRIPTIONS:
107
what = test.shortDescription()
109
if len(what) > name_width:
110
what = what[:name_width-3] + '...'
113
if what.startswith('bzrlib.tests.'):
115
if len(what) > name_width:
116
what = '...' + what[3-name_width:]
117
what = what.ljust(name_width)
118
self.stream.write(what)
120
self._start_time = time.time()
122
def addError(self, test, err):
123
if isinstance(err[1], TestSkipped):
124
return self.addSkipped(test, err)
125
unittest.TestResult.addError(self, test, err)
127
self.stream.writeln("ERROR %s" % self._elapsedTime())
129
self.stream.write('E')
132
def addFailure(self, test, err):
133
unittest.TestResult.addFailure(self, test, err)
135
self.stream.writeln(" FAIL %s" % self._elapsedTime())
137
self.stream.write('F')
140
def addSuccess(self, test):
142
self.stream.writeln(' OK %s' % self._elapsedTime())
144
self.stream.write('~')
146
unittest.TestResult.addSuccess(self, test)
148
def addSkipped(self, test, skip_excinfo):
150
print >>self.stream, ' SKIP %s' % self._elapsedTime()
151
print >>self.stream, ' %s' % skip_excinfo[1]
153
self.stream.write('S')
155
# seems best to treat this as success from point-of-view of unittest
156
# -- it actually does nothing so it barely matters :)
157
unittest.TestResult.addSuccess(self, test)
159
def printErrorList(self, flavour, errors):
160
for test, err in errors:
161
self.stream.writeln(self.separator1)
162
self.stream.writeln("%s: %s" % (flavour,self.getDescription(test)))
163
if hasattr(test, '_get_log'):
165
print >>self.stream, \
166
('vvvv[log from %s]' % test).ljust(78,'-')
167
print >>self.stream, test._get_log()
168
print >>self.stream, \
169
('^^^^[log from %s]' % test).ljust(78,'-')
170
self.stream.writeln(self.separator2)
171
self.stream.writeln("%s" % err)
174
class TextTestRunner(unittest.TextTestRunner):
175
stop_on_failure = False
177
def _makeResult(self):
178
result = _MyResult(self.stream, self.descriptions, self.verbosity)
179
if self.stop_on_failure:
180
result = EarlyStoppingTestResultAdapter(result)
184
def iter_suite_tests(suite):
185
"""Return all tests in a suite, recursing through nested suites"""
186
for item in suite._tests:
187
if isinstance(item, unittest.TestCase):
189
elif isinstance(item, unittest.TestSuite):
190
for r in iter_suite_tests(item):
193
raise Exception('unknown object %r inside test suite %r'
197
class TestSkipped(Exception):
198
"""Indicates that a test was intentionally skipped, rather than failing."""
33
MODULES_TO_DOCTEST = []
35
from logging import debug, warning, error
202
37
class CommandFailed(Exception):
211
46
Error and debug log messages are redirected from their usual
212
47
location into a temporary file, the contents of which can be
213
retrieved by _get_log(). We use a real OS file, not an in-memory object,
214
so that it can also capture file IO. When the test completes this file
215
is read into memory and removed from disk.
48
retrieved by _get_log().
217
50
There are also convenience functions to invoke bzr's command-line
218
routine, and to build and check bzr trees.
220
In addition to the usual method of overriding tearDown(), this class also
221
allows subclasses to register functions into the _cleanups list, which is
222
run in order as the object is torn down. It's less likely this will be
223
accidentally overlooked.
51
routine, and to build and check bzr trees."""
227
_log_file_name = None
56
# this replaces the default testsweet.TestCase; we don't want logging changed
231
57
unittest.TestCase.setUp(self)
233
self._cleanEnvironment()
234
58
bzrlib.trace.disable_default_logging()
237
def _ndiff_strings(self, a, b):
238
"""Return ndiff between two strings containing lines.
240
A trailing newline is added if missing to make the strings
242
if b and b[-1] != '\n':
244
if a and a[-1] != '\n':
246
difflines = difflib.ndiff(a.splitlines(True),
248
linejunk=lambda x: False,
249
charjunk=lambda x: False)
250
return ''.join(difflines)
252
def assertEqualDiff(self, a, b):
253
"""Assert two texts are equal, if not raise an exception.
255
This is intended for use with multi-line strings where it can
256
be hard to find the differences by eye.
258
# TODO: perhaps override assertEquals to call this for strings?
261
raise AssertionError("texts not equal:\n" +
262
self._ndiff_strings(a, b))
264
def assertStartsWith(self, s, prefix):
265
if not s.startswith(prefix):
266
raise AssertionError('string %r does not start with %r' % (s, prefix))
268
def assertEndsWith(self, s, suffix):
269
if not s.endswith(prefix):
270
raise AssertionError('string %r does not end with %r' % (s, suffix))
272
def assertContainsRe(self, haystack, needle_re):
273
"""Assert that a contains something matching a regular expression."""
274
if not re.search(needle_re, haystack):
275
raise AssertionError('pattern "%s" not found in "%s"'
276
% (needle_re, haystack))
278
def AssertSubset(self, sublist, superlist):
279
"""Assert that every entry in sublist is present in superlist."""
281
for entry in sublist:
282
if entry not in superlist:
283
missing.append(entry)
285
raise AssertionError("value(s) %r not present in container %r" %
286
(missing, superlist))
288
def assertIs(self, left, right):
289
if not (left is right):
290
raise AssertionError("%r is not %r." % (left, right))
292
def _startLogFile(self):
293
"""Send bzr and test log messages to a temporary file.
295
The file is removed as the test is torn down.
59
self._enable_file_logging()
62
def _enable_file_logging(self):
297
63
fileno, name = tempfile.mkstemp(suffix='.log', prefix='testbzr')
298
encoder, decoder, stream_reader, stream_writer = codecs.lookup('UTF-8')
299
self._log_file = stream_writer(os.fdopen(fileno, 'w+'))
300
bzrlib.trace.enable_test_log(self._log_file)
65
self._log_file = os.fdopen(fileno, 'w+')
67
hdlr = logging.StreamHandler(self._log_file)
68
hdlr.setLevel(logging.DEBUG)
69
hdlr.setFormatter(logging.Formatter('%(levelname)4.4s %(message)s'))
70
logging.getLogger('').addHandler(hdlr)
71
logging.getLogger('').setLevel(logging.DEBUG)
73
debug('opened log file %s', name)
301
75
self._log_file_name = name
302
self.addCleanup(self._finishLogFile)
304
def _finishLogFile(self):
305
"""Finished with the log file.
307
Read contents into memory, close, and delete.
309
bzrlib.trace.disable_test_log()
310
self._log_file.seek(0)
311
self._log_contents = self._log_file.read()
77
def run(self, result):
78
self.apply_redirected(None, None, None,
79
unittest.TestCase.run, self, result)
82
logging.getLogger('').removeHandler(self._log_hdlr)
83
bzrlib.trace.enable_default_logging()
84
logging.debug('%s teardown', self.id())
312
85
self._log_file.close()
313
os.remove(self._log_file_name)
314
self._log_file = self._log_file_name = None
316
def addCleanup(self, callable):
317
"""Arrange to run a callable when this case is torn down.
319
Callables are run in the reverse of the order they are registered,
320
ie last-in first-out.
322
if callable in self._cleanups:
323
raise ValueError("cleanup function %r already registered on %s"
325
self._cleanups.append(callable)
327
def _cleanEnvironment(self):
330
'APPDATA': os.getcwd(),
335
self.addCleanup(self._restoreEnvironment)
336
for name, value in new_env.iteritems():
337
self._captureVar(name, value)
340
def _captureVar(self, name, newvalue):
341
"""Set an environment variable, preparing it to be reset when finished."""
342
self.__old_env[name] = os.environ.get(name, None)
344
if name in os.environ:
347
os.environ[name] = newvalue
350
def _restoreVar(name, value):
352
if name in os.environ:
355
os.environ[name] = value
357
def _restoreEnvironment(self):
358
for name, value in self.__old_env.iteritems():
359
self._restoreVar(name, value)
363
86
unittest.TestCase.tearDown(self)
365
def _runCleanups(self):
366
"""Run registered cleanup functions.
368
This should only be called from TestCase.tearDown.
370
for cleanup_fn in reversed(self._cleanups):
373
89
def log(self, *args):
376
92
def _get_log(self):
377
93
"""Return as a string the log for this test"""
378
if self._log_file_name:
379
return open(self._log_file_name).read()
381
return self._log_contents
382
# TODO: Delete the log after it's been read in
384
def capture(self, cmd, retcode=0):
385
"""Shortcut that splits cmd into words, runs, and returns stdout"""
386
return self.run_bzr_captured(cmd.split(), retcode=retcode)[0]
388
def run_bzr_captured(self, argv, retcode=0):
389
"""Invoke bzr and return (stdout, stderr).
391
Useful for code that wants to check the contents of the
392
output, the way error messages are presented, etc.
94
return open(self._log_file_name).read()
96
def run_bzr(self, *args, **kwargs):
97
"""Invoke bzr, as if it were run from the command line.
394
99
This should be the main method for tests that want to exercise the
395
100
overall behavior of the bzr application (rather than a unit test
522
190
if contents != expect:
523
191
self.log("expected: %r" % expect)
524
192
self.log("actually: %r" % contents)
525
self.fail("contents of %s not as expected" % filename)
193
self.fail("contents of %s not as expected")
527
195
def _make_test_root(self):
528
200
if TestCaseInTempDir.TEST_ROOT is not None:
532
root = u'test%04d.tmp' % i
536
if e.errno == errno.EEXIST:
541
# successfully created
542
TestCaseInTempDir.TEST_ROOT = osutils.abspath(root)
202
TestCaseInTempDir.TEST_ROOT = os.path.abspath(
203
tempfile.mkdtemp(suffix='.tmp',
204
prefix=self._TEST_NAME + '-',
544
207
# make a fake bzr directory there to prevent any tests propagating
545
208
# up onto the source directory's real branch
546
os.mkdir(osutils.pathjoin(TestCaseInTempDir.TEST_ROOT, '.bzr'))
209
os.mkdir(os.path.join(TestCaseInTempDir.TEST_ROOT, '.bzr'))
549
212
super(TestCaseInTempDir, self).setUp()
550
214
self._make_test_root()
551
_currentdir = os.getcwdu()
552
short_id = self.id().replace('bzrlib.tests.', '') \
553
.replace('__main__.', '')
554
self.test_dir = osutils.pathjoin(self.TEST_ROOT, short_id)
215
self._currentdir = os.getcwdu()
216
self.test_dir = os.path.join(self.TEST_ROOT, self.id())
555
217
os.mkdir(self.test_dir)
556
218
os.chdir(self.test_dir)
557
os.environ['HOME'] = self.test_dir
558
os.environ['APPDATA'] = self.test_dir
559
def _leaveDirectory():
560
os.chdir(_currentdir)
561
self.addCleanup(_leaveDirectory)
563
def build_tree(self, shape, line_endings='native'):
222
os.chdir(self._currentdir)
223
super(TestCaseInTempDir, self).tearDown()
225
def _formcmd(self, cmd):
226
if isinstance(cmd, basestring):
229
cmd[0] = self.BZRPATH
230
if self.OVERRIDE_PYTHON:
231
cmd.insert(0, self.OVERRIDE_PYTHON)
232
self.log('$ %r' % cmd)
235
def runcmd(self, cmd, retcode=0):
236
"""Run one command and check the return code.
238
Returns a tuple of (stdout,stderr) strings.
240
If a single string is based, it is split into words.
241
For commands that are not simple space-separated words, please
242
pass a list instead."""
243
cmd = self._formcmd(cmd)
244
self.log('$ ' + ' '.join(cmd))
245
actual_retcode = subprocess.call(cmd, stdout=self._log_file,
246
stderr=self._log_file)
247
if retcode != actual_retcode:
248
raise CommandFailed("test failed: %r returned %d, expected %d"
249
% (cmd, actual_retcode, retcode))
251
def backtick(self, cmd, retcode=0):
252
"""Run a command and return its output"""
253
cmd = self._formcmd(cmd)
254
child = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=self._log_file)
255
outd, errd = child.communicate()
257
actual_retcode = child.wait()
259
outd = outd.replace('\r', '')
261
if retcode != actual_retcode:
262
raise CommandFailed("test failed: %r returned %d, expected %d"
263
% (cmd, actual_retcode, retcode))
269
def build_tree(self, shape):
564
270
"""Build a test tree according to a pattern.
566
272
shape is a sequence of file specifications. If the final
567
273
character is '/', a directory is created.
569
275
This doesn't add anything to a branch.
570
:param line_endings: Either 'binary' or 'native'
571
in binary mode, exact contents are written
572
in native mode, the line endings match the
573
default platform endings.
575
277
# XXX: It's OK to just create them using forward slashes on windows?
576
279
for name in shape:
577
self.assert_(isinstance(name, basestring))
280
assert isinstance(name, basestring)
578
281
if name[-1] == '/':
579
282
os.mkdir(name[:-1])
581
if line_endings == 'binary':
583
elif line_endings == 'native':
586
raise BzrError('Invalid line ending request %r' % (line_endings,))
587
285
print >>f, "contents of", name
590
def build_tree_contents(self, shape):
591
build_tree_contents(shape)
593
def failUnlessExists(self, path):
594
"""Fail unless path, which may be abs or relative, exists."""
595
self.failUnless(osutils.lexists(path))
597
def failIfExists(self, path):
598
"""Fail if path, which may be abs or relative, exists."""
599
self.failIf(osutils.lexists(path))
601
def assertFileEqual(self, content, path):
602
"""Fail if path does not contain 'content'."""
603
self.failUnless(osutils.lexists(path))
604
self.assertEqualDiff(content, open(path, 'r').read())
607
def filter_suite_by_re(suite, pattern):
609
filter_re = re.compile(pattern)
610
for test in iter_suite_tests(suite):
611
if filter_re.search(test.id()):
616
def run_suite(suite, name='test', verbose=False, pattern=".*",
617
stop_on_failure=False, keep_output=False):
618
TestCaseInTempDir._TEST_NAME = name
623
runner = TextTestRunner(stream=sys.stdout,
626
runner.stop_on_failure=stop_on_failure
628
suite = filter_suite_by_re(suite, pattern)
629
result = runner.run(suite)
630
# This is still a little bogus,
631
# but only a little. Folk not using our testrunner will
632
# have to delete their temp directories themselves.
633
if result.wasSuccessful() or not keep_output:
634
if TestCaseInTempDir.TEST_ROOT is not None:
635
shutil.rmtree(TestCaseInTempDir.TEST_ROOT)
637
print "Failed tests working directories are in '%s'\n" % TestCaseInTempDir.TEST_ROOT
638
return result.wasSuccessful()
641
def selftest(verbose=False, pattern=".*", stop_on_failure=True,
643
"""Run the whole test suite under the enhanced runner"""
644
return run_suite(test_suite(), 'testbzr', verbose=verbose, pattern=pattern,
645
stop_on_failure=stop_on_failure, keep_output=keep_output)
290
class MetaTestLog(TestCase):
291
def test_logging(self):
292
"""Test logs are captured when a test fails."""
293
logging.info('an info message')
294
warning('something looks dodgy...')
295
logging.debug('hello, test is running')
299
def selftest(verbose=False, pattern=".*"):
300
return run_suite(test_suite(), 'testbzr', verbose=verbose, pattern=pattern)
648
303
def test_suite():
649
"""Build and return TestSuite for the whole program."""
304
from bzrlib.selftest.TestUtil import TestLoader, TestSuite
305
import bzrlib, bzrlib.store, bzrlib.inventory, bzrlib.branch
306
import bzrlib.osutils, bzrlib.commands, bzrlib.merge3, bzrlib.plugin
650
307
from doctest import DocTestSuite
652
global MODULES_TO_DOCTEST
655
'bzrlib.tests.test_ancestry',
656
'bzrlib.tests.test_annotate',
657
'bzrlib.tests.test_api',
658
'bzrlib.tests.test_bad_files',
659
'bzrlib.tests.test_basis_inventory',
660
'bzrlib.tests.test_branch',
661
'bzrlib.tests.test_command',
662
'bzrlib.tests.test_commit',
663
'bzrlib.tests.test_commit_merge',
664
'bzrlib.tests.test_config',
665
'bzrlib.tests.test_conflicts',
666
'bzrlib.tests.test_diff',
667
'bzrlib.tests.test_fetch',
668
'bzrlib.tests.test_gpg',
669
'bzrlib.tests.test_graph',
670
'bzrlib.tests.test_hashcache',
671
'bzrlib.tests.test_http',
672
'bzrlib.tests.test_identitymap',
673
'bzrlib.tests.test_inv',
674
'bzrlib.tests.test_lockable_files',
675
'bzrlib.tests.test_log',
676
'bzrlib.tests.test_merge',
677
'bzrlib.tests.test_merge3',
678
'bzrlib.tests.test_merge_core',
679
'bzrlib.tests.test_missing',
680
'bzrlib.tests.test_msgeditor',
681
'bzrlib.tests.test_nonascii',
682
'bzrlib.tests.test_options',
683
'bzrlib.tests.test_osutils',
684
'bzrlib.tests.test_parent',
685
'bzrlib.tests.test_permissions',
686
'bzrlib.tests.test_plugins',
687
'bzrlib.tests.test_remove',
688
'bzrlib.tests.test_revision',
689
'bzrlib.tests.test_revisionnamespaces',
690
'bzrlib.tests.test_revprops',
691
'bzrlib.tests.test_reweave',
692
'bzrlib.tests.test_rio',
693
'bzrlib.tests.test_sampler',
694
'bzrlib.tests.test_selftest',
695
'bzrlib.tests.test_setup',
696
'bzrlib.tests.test_sftp_transport',
697
'bzrlib.tests.test_smart_add',
698
'bzrlib.tests.test_source',
699
'bzrlib.tests.test_status',
700
'bzrlib.tests.test_store',
701
'bzrlib.tests.test_testament',
702
'bzrlib.tests.test_trace',
703
'bzrlib.tests.test_transactions',
704
'bzrlib.tests.test_transport',
705
'bzrlib.tests.test_tsort',
706
'bzrlib.tests.test_ui',
707
'bzrlib.tests.test_uncommit',
708
'bzrlib.tests.test_upgrade',
709
'bzrlib.tests.test_weave',
710
'bzrlib.tests.test_whitebox',
711
'bzrlib.tests.test_workingtree',
712
'bzrlib.tests.test_xml',
313
global MODULES_TO_TEST, MODULES_TO_DOCTEST
316
['bzrlib.selftest.MetaTestLog',
317
'bzrlib.selftest.test_parent',
318
'bzrlib.selftest.testinv',
319
'bzrlib.selftest.testfetch',
320
'bzrlib.selftest.versioning',
321
'bzrlib.selftest.whitebox',
322
'bzrlib.selftest.testmerge3',
323
'bzrlib.selftest.testhashcache',
324
'bzrlib.selftest.teststatus',
325
'bzrlib.selftest.testlog',
326
'bzrlib.selftest.blackbox',
327
'bzrlib.selftest.testrevisionnamespaces',
328
'bzrlib.selftest.testbranch',
329
'bzrlib.selftest.testrevision',
330
'bzrlib.selftest.test_merge_core',
331
'bzrlib.selftest.test_smart_add',
332
'bzrlib.selftest.testdiff',
333
'bzrlib.selftest.test_xml',
335
'bzrlib.selftest.teststore',
336
'bzrlib.selftest.testgraph',
715
TestCase.BZRPATH = osutils.pathjoin(
716
osutils.realpath(osutils.dirname(bzrlib.__path__[0])), 'bzr')
717
print '%10s: %s' % ('bzr', osutils.realpath(sys.argv[0]))
718
print '%10s: %s' % ('bzrlib', bzrlib.__path__[0])
339
for m in (bzrlib.store, bzrlib.inventory, bzrlib.branch,
340
bzrlib.osutils, bzrlib.commands, bzrlib.merge3):
341
if m not in MODULES_TO_DOCTEST:
342
MODULES_TO_DOCTEST.append(m)
344
TestCase.BZRPATH = os.path.join(os.path.realpath(os.path.dirname(bzrlib.__path__[0])), 'bzr')
345
print '%-30s %s' % ('bzr binary', TestCase.BZRPATH)
720
347
suite = TestSuite()
721
# python2.4's TestLoader.loadTestsFromNames gives very poor
722
# errors if it fails to load a named module - no indication of what's
723
# actually wrong, just "no such module". We should probably override that
724
# class, but for the moment just load them ourselves. (mbp 20051202)
725
loader = TestLoader()
726
for mod_name in testmod_names:
727
mod = _load_module_by_name(mod_name)
728
suite.addTest(loader.loadTestsFromModule(mod))
729
for package in packages_to_test():
730
suite.addTest(package.test_suite())
348
suite.addTest(TestLoader().loadTestsFromNames(testmod_names))
731
349
for m in MODULES_TO_TEST:
732
suite.addTest(loader.loadTestsFromModule(m))
350
suite.addTest(TestLoader().loadTestsFromModule(m))
733
351
for m in (MODULES_TO_DOCTEST):
734
352
suite.addTest(DocTestSuite(m))
735
for name, plugin in bzrlib.plugin.all_plugins().items():
736
if hasattr(plugin, 'test_suite'):
737
suite.addTest(plugin.test_suite())
353
for p in bzrlib.plugin.all_plugins:
354
if hasattr(p, 'test_suite'):
355
suite.addTest(p.test_suite())
741
def _load_module_by_name(mod_name):
742
parts = mod_name.split('.')
743
module = __import__(mod_name)
745
# for historical reasons python returns the top-level module even though
746
# it loads the submodule; we need to walk down to get the one we want.
748
module = getattr(module, parts.pop(0))
added
removed
bzrlib/selftest/__init__.py
