~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/test_selftest.py

  • Committer: Jelmer Vernooij
  • Date: 2011-10-14 13:56:45 UTC
  • mfrom: (6215 +trunk)
  • mto: This revision was merged to the branch mainline in revision 6216.
  • Revision ID: jelmer@samba.org-20111014135645-phc3q3y21k2ks0s2
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006, 2007, 2008, 2009 Canonical Ltd
 
1
# Copyright (C) 2005-2011 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
17
17
"""Tests for the test framework."""
18
18
 
19
19
from cStringIO import StringIO
 
20
import gc
 
21
import doctest
20
22
import os
 
23
import signal
21
24
import sys
 
25
import threading
22
26
import time
23
27
import unittest
24
28
import warnings
25
29
 
 
30
from testtools import (
 
31
    ExtendedToOriginalDecorator,
 
32
    MultiTestResult,
 
33
    __version__ as testtools_version,
 
34
    )
 
35
from testtools.content import Content
 
36
from testtools.content_type import ContentType
 
37
from testtools.matchers import (
 
38
    DocTestMatches,
 
39
    Equals,
 
40
    )
 
41
import testtools.testresult.doubles
 
42
 
26
43
import bzrlib
27
44
from bzrlib import (
28
45
    branchbuilder,
29
46
    bzrdir,
30
 
    debug,
31
47
    errors,
 
48
    hooks,
32
49
    lockdir,
33
50
    memorytree,
34
51
    osutils,
35
 
    progress,
36
52
    remote,
37
53
    repository,
38
54
    symbol_versioning,
39
55
    tests,
 
56
    transport,
40
57
    workingtree,
 
58
    workingtree_3,
 
59
    workingtree_4,
41
60
    )
42
61
from bzrlib.repofmt import (
43
 
    pack_repo,
44
 
    weaverepo,
 
62
    groupcompress_repo,
45
63
    )
46
64
from bzrlib.symbol_versioning import (
47
65
    deprecated_function,
49
67
    deprecated_method,
50
68
    )
51
69
from bzrlib.tests import (
 
70
    features,
52
71
    test_lsprof,
53
 
    test_sftp_transport,
 
72
    test_server,
54
73
    TestUtil,
55
74
    )
56
 
from bzrlib.trace import note
57
 
from bzrlib.transport.memory import MemoryServer, MemoryTransport
58
 
from bzrlib.version import _get_bzr_source_tree
 
75
from bzrlib.trace import note, mutter
 
76
from bzrlib.transport import memory
59
77
 
60
78
 
61
79
def _test_ids(test_suite):
63
81
    return [t.id() for t in tests.iter_suite_tests(test_suite)]
64
82
 
65
83
 
66
 
class SelftestTests(tests.TestCase):
67
 
 
68
 
    def test_import_tests(self):
69
 
        mod = TestUtil._load_module_by_name('bzrlib.tests.test_selftest')
70
 
        self.assertEqual(mod.SelftestTests, SelftestTests)
71
 
 
72
 
    def test_import_test_failure(self):
73
 
        self.assertRaises(ImportError,
74
 
                          TestUtil._load_module_by_name,
75
 
                          'bzrlib.no-name-yet')
76
 
 
77
84
class MetaTestLog(tests.TestCase):
78
85
 
79
86
    def test_logging(self):
80
87
        """Test logs are captured when a test fails."""
81
88
        self.log('a test message')
82
 
        self._log_file.flush()
83
 
        self.assertContainsRe(self._get_log(keep_log_file=True),
84
 
                              'a test message\n')
85
 
 
86
 
 
87
 
class TestUnicodeFilename(tests.TestCase):
88
 
 
89
 
    def test_probe_passes(self):
90
 
        """UnicodeFilename._probe passes."""
91
 
        # We can't test much more than that because the behaviour depends
92
 
        # on the platform.
93
 
        tests.UnicodeFilename._probe()
 
89
        details = self.getDetails()
 
90
        log = details['log']
 
91
        self.assertThat(log.content_type, Equals(ContentType(
 
92
            "text", "plain", {"charset": "utf8"})))
 
93
        self.assertThat(u"".join(log.iter_text()), Equals(self.get_log()))
 
94
        self.assertThat(self.get_log(),
 
95
            DocTestMatches(u"...a test message\n", doctest.ELLIPSIS))
94
96
 
95
97
 
96
98
class TestTreeShape(tests.TestCaseInTempDir):
97
99
 
98
100
    def test_unicode_paths(self):
99
 
        self.requireFeature(tests.UnicodeFilename)
 
101
        self.requireFeature(features.UnicodeFilenameFeature)
100
102
 
101
103
        filename = u'hell\u00d8'
102
104
        self.build_tree_contents([(filename, 'contents of hello')])
103
 
        self.failUnlessExists(filename)
 
105
        self.assertPathExists(filename)
 
106
 
 
107
 
 
108
class TestClassesAvailable(tests.TestCase):
 
109
    """As a convenience we expose Test* classes from bzrlib.tests"""
 
110
 
 
111
    def test_test_case(self):
 
112
        from bzrlib.tests import TestCase
 
113
 
 
114
    def test_test_loader(self):
 
115
        from bzrlib.tests import TestLoader
 
116
 
 
117
    def test_test_suite(self):
 
118
        from bzrlib.tests import TestSuite
104
119
 
105
120
 
106
121
class TestTransportScenarios(tests.TestCase):
124
139
        self.assertEqual(sample_permutation,
125
140
                         get_transport_test_permutations(MockModule()))
126
141
 
127
 
    def test_scenarios_invlude_all_modules(self):
 
142
    def test_scenarios_include_all_modules(self):
128
143
        # this checks that the scenario generator returns as many permutations
129
144
        # as there are in all the registered transport modules - we assume if
130
145
        # this matches its probably doing the right thing especially in
189
204
    def test_scenarios(self):
190
205
        # check that constructor parameters are passed through to the adapted
191
206
        # test.
192
 
        from bzrlib.tests.per_bzrdir import make_scenarios
 
207
        from bzrlib.tests.per_controldir import make_scenarios
193
208
        vfs_factory = "v"
194
209
        server1 = "a"
195
210
        server2 = "b"
215
230
        from bzrlib.tests.per_repository import formats_to_scenarios
216
231
        formats = [("(c)", remote.RemoteRepositoryFormat()),
217
232
                   ("(d)", repository.format_registry.get(
218
 
                        'Bazaar pack repository format 1 (needs bzr 0.92)\n'))]
 
233
                    'Bazaar repository format 2a (needs bzr 1.16 or later)\n'))]
219
234
        no_vfs_scenarios = formats_to_scenarios(formats, "server", "readonly",
220
235
            None)
221
236
        vfs_scenarios = formats_to_scenarios(formats, "server", "readonly",
222
237
            vfs_transport_factory="vfs")
223
238
        # no_vfs generate scenarios without vfs_transport_factory
224
 
        self.assertEqual([
 
239
        expected = [
225
240
            ('RemoteRepositoryFormat(c)',
226
241
             {'bzrdir_format': remote.RemoteBzrDirFormat(),
227
242
              'repository_format': remote.RemoteRepositoryFormat(),
228
243
              'transport_readonly_server': 'readonly',
229
244
              'transport_server': 'server'}),
230
 
            ('RepositoryFormatKnitPack1(d)',
 
245
            ('RepositoryFormat2a(d)',
231
246
             {'bzrdir_format': bzrdir.BzrDirMetaFormat1(),
232
 
              'repository_format': pack_repo.RepositoryFormatKnitPack1(),
 
247
              'repository_format': groupcompress_repo.RepositoryFormat2a(),
233
248
              'transport_readonly_server': 'readonly',
234
 
              'transport_server': 'server'})],
235
 
            no_vfs_scenarios)
 
249
              'transport_server': 'server'})]
 
250
        self.assertEqual(expected, no_vfs_scenarios)
236
251
        self.assertEqual([
237
252
            ('RemoteRepositoryFormat(c)',
238
253
             {'bzrdir_format': remote.RemoteBzrDirFormat(),
240
255
              'transport_readonly_server': 'readonly',
241
256
              'transport_server': 'server',
242
257
              'vfs_transport_factory': 'vfs'}),
243
 
            ('RepositoryFormatKnitPack1(d)',
 
258
            ('RepositoryFormat2a(d)',
244
259
             {'bzrdir_format': bzrdir.BzrDirMetaFormat1(),
245
 
              'repository_format': pack_repo.RepositoryFormatKnitPack1(),
 
260
              'repository_format': groupcompress_repo.RepositoryFormat2a(),
246
261
              'transport_readonly_server': 'readonly',
247
262
              'transport_server': 'server',
248
263
              'vfs_transport_factory': 'vfs'})],
293
308
        from bzrlib.tests.per_interrepository import make_scenarios
294
309
        server1 = "a"
295
310
        server2 = "b"
296
 
        formats = [(str, "C1", "C2"), (int, "D1", "D2")]
 
311
        formats = [("C0", "C1", "C2", "C3"), ("D0", "D1", "D2", "D3")]
297
312
        scenarios = make_scenarios(server1, server2, formats)
298
313
        self.assertEqual([
299
 
            ('str,str,str',
300
 
             {'interrepo_class': str,
301
 
              'repository_format': 'C1',
 
314
            ('C0,str,str',
 
315
             {'repository_format': 'C1',
302
316
              'repository_format_to': 'C2',
303
317
              'transport_readonly_server': 'b',
304
 
              'transport_server': 'a'}),
305
 
            ('int,str,str',
306
 
             {'interrepo_class': int,
307
 
              'repository_format': 'D1',
 
318
              'transport_server': 'a',
 
319
              'extra_setup': 'C3'}),
 
320
            ('D0,str,str',
 
321
             {'repository_format': 'D1',
308
322
              'repository_format_to': 'D2',
309
323
              'transport_readonly_server': 'b',
310
 
              'transport_server': 'a'})],
 
324
              'transport_server': 'a',
 
325
              'extra_setup': 'D3'})],
311
326
            scenarios)
312
327
 
313
328
 
319
334
        from bzrlib.tests.per_workingtree import make_scenarios
320
335
        server1 = "a"
321
336
        server2 = "b"
322
 
        formats = [workingtree.WorkingTreeFormat2(),
323
 
                   workingtree.WorkingTreeFormat3(),]
 
337
        formats = [workingtree_4.WorkingTreeFormat4(),
 
338
                   workingtree_3.WorkingTreeFormat3(),]
324
339
        scenarios = make_scenarios(server1, server2, formats)
325
340
        self.assertEqual([
326
 
            ('WorkingTreeFormat2',
 
341
            ('WorkingTreeFormat4',
327
342
             {'bzrdir_format': formats[0]._matchingbzrdir,
328
343
              'transport_readonly_server': 'b',
329
344
              'transport_server': 'a',
356
371
            )
357
372
        server1 = "a"
358
373
        server2 = "b"
359
 
        formats = [workingtree.WorkingTreeFormat2(),
360
 
                   workingtree.WorkingTreeFormat3(),]
 
374
        formats = [workingtree_4.WorkingTreeFormat4(),
 
375
                   workingtree_3.WorkingTreeFormat3(),]
361
376
        scenarios = make_scenarios(server1, server2, formats)
362
377
        self.assertEqual(7, len(scenarios))
363
 
        default_wt_format = workingtree.WorkingTreeFormat4._default_format
364
 
        wt4_format = workingtree.WorkingTreeFormat4()
365
 
        wt5_format = workingtree.WorkingTreeFormat5()
 
378
        default_wt_format = workingtree.format_registry.get_default()
 
379
        wt4_format = workingtree_4.WorkingTreeFormat4()
 
380
        wt5_format = workingtree_4.WorkingTreeFormat5()
366
381
        expected_scenarios = [
367
 
            ('WorkingTreeFormat2',
 
382
            ('WorkingTreeFormat4',
368
383
             {'bzrdir_format': formats[0]._matchingbzrdir,
369
384
              'transport_readonly_server': 'b',
370
385
              'transport_server': 'a',
430
445
        # ones to add.
431
446
        from bzrlib.tests.per_tree import (
432
447
            return_parameter,
433
 
            revision_tree_from_workingtree
434
448
            )
435
449
        from bzrlib.tests.per_intertree import (
436
450
            make_scenarios,
437
451
            )
438
 
        from bzrlib.workingtree import WorkingTreeFormat2, WorkingTreeFormat3
 
452
        from bzrlib.workingtree_3 import WorkingTreeFormat3
 
453
        from bzrlib.workingtree_4 import WorkingTreeFormat4
439
454
        input_test = TestInterTreeScenarios(
440
455
            "test_scenarios")
441
456
        server1 = "a"
442
457
        server2 = "b"
443
 
        format1 = WorkingTreeFormat2()
 
458
        format1 = WorkingTreeFormat4()
444
459
        format2 = WorkingTreeFormat3()
445
460
        formats = [("1", str, format1, format2, "converter1"),
446
461
            ("2", int, format2, format1, "converter2")]
488
503
        self.assertEqualStat(real, fake)
489
504
 
490
505
    def test_assertEqualStat_notequal(self):
491
 
        self.build_tree(["foo", "bar"])
 
506
        self.build_tree(["foo", "longname"])
492
507
        self.assertRaises(AssertionError, self.assertEqualStat,
493
 
            os.lstat("foo"), os.lstat("bar"))
 
508
            os.lstat("foo"), os.lstat("longname"))
 
509
 
 
510
    def test_failUnlessExists(self):
 
511
        """Deprecated failUnlessExists and failIfExists"""
 
512
        self.applyDeprecated(
 
513
            deprecated_in((2, 4)),
 
514
            self.failUnlessExists, '.')
 
515
        self.build_tree(['foo/', 'foo/bar'])
 
516
        self.applyDeprecated(
 
517
            deprecated_in((2, 4)),
 
518
            self.failUnlessExists, 'foo/bar')
 
519
        self.applyDeprecated(
 
520
            deprecated_in((2, 4)),
 
521
            self.failIfExists, 'foo/foo')
 
522
 
 
523
    def test_assertPathExists(self):
 
524
        self.assertPathExists('.')
 
525
        self.build_tree(['foo/', 'foo/bar'])
 
526
        self.assertPathExists('foo/bar')
 
527
        self.assertPathDoesNotExist('foo/foo')
494
528
 
495
529
 
496
530
class TestTestCaseWithMemoryTransport(tests.TestCaseWithMemoryTransport):
514
548
        cwd = osutils.getcwd()
515
549
        self.assertIsSameRealPath(self.test_dir, cwd)
516
550
 
 
551
    def test_BZR_HOME_and_HOME_are_bytestrings(self):
 
552
        """The $BZR_HOME and $HOME environment variables should not be unicode.
 
553
 
 
554
        See https://bugs.launchpad.net/bzr/+bug/464174
 
555
        """
 
556
        self.assertIsInstance(os.environ['BZR_HOME'], str)
 
557
        self.assertIsInstance(os.environ['HOME'], str)
 
558
 
517
559
    def test_make_branch_and_memory_tree(self):
518
560
        """In TestCaseWithMemoryTransport we should not make the branch on disk.
519
561
 
523
565
        tree = self.make_branch_and_memory_tree('dir')
524
566
        # Guard against regression into MemoryTransport leaking
525
567
        # files to disk instead of keeping them in memory.
526
 
        self.failIf(osutils.lexists('dir'))
 
568
        self.assertFalse(osutils.lexists('dir'))
527
569
        self.assertIsInstance(tree, memorytree.MemoryTree)
528
570
 
529
571
    def test_make_branch_and_memory_tree_with_format(self):
530
572
        """make_branch_and_memory_tree should accept a format option."""
531
573
        format = bzrdir.BzrDirMetaFormat1()
532
 
        format.repository_format = weaverepo.RepositoryFormat7()
 
574
        format.repository_format = repository.format_registry.get_default()
533
575
        tree = self.make_branch_and_memory_tree('dir', format=format)
534
576
        # Guard against regression into MemoryTransport leaking
535
577
        # files to disk instead of keeping them in memory.
536
 
        self.failIf(osutils.lexists('dir'))
 
578
        self.assertFalse(osutils.lexists('dir'))
537
579
        self.assertIsInstance(tree, memorytree.MemoryTree)
538
580
        self.assertEqual(format.repository_format.__class__,
539
581
            tree.branch.repository._format.__class__)
543
585
        self.assertIsInstance(builder, branchbuilder.BranchBuilder)
544
586
        # Guard against regression into MemoryTransport leaking
545
587
        # files to disk instead of keeping them in memory.
546
 
        self.failIf(osutils.lexists('dir'))
 
588
        self.assertFalse(osutils.lexists('dir'))
547
589
 
548
590
    def test_make_branch_builder_with_format(self):
549
591
        # Use a repo layout that doesn't conform to a 'named' layout, to ensure
550
592
        # that the format objects are used.
551
593
        format = bzrdir.BzrDirMetaFormat1()
552
 
        repo_format = weaverepo.RepositoryFormat7()
 
594
        repo_format = repository.format_registry.get_default()
553
595
        format.repository_format = repo_format
554
596
        builder = self.make_branch_builder('dir', format=format)
555
597
        the_branch = builder.get_branch()
556
598
        # Guard against regression into MemoryTransport leaking
557
599
        # files to disk instead of keeping them in memory.
558
 
        self.failIf(osutils.lexists('dir'))
 
600
        self.assertFalse(osutils.lexists('dir'))
559
601
        self.assertEqual(format.repository_format.__class__,
560
602
                         the_branch.repository._format.__class__)
561
603
        self.assertEqual(repo_format.get_format_string(),
567
609
        the_branch = builder.get_branch()
568
610
        # Guard against regression into MemoryTransport leaking
569
611
        # files to disk instead of keeping them in memory.
570
 
        self.failIf(osutils.lexists('dir'))
 
612
        self.assertFalse(osutils.lexists('dir'))
571
613
        dir_format = bzrdir.format_registry.make_bzrdir('knit')
572
614
        self.assertEqual(dir_format.repository_format.__class__,
573
615
                         the_branch.repository._format.__class__)
575
617
                         self.get_transport().get_bytes(
576
618
                            'dir/.bzr/repository/format'))
577
619
 
578
 
    def test_safety_net(self):
579
 
        """No test should modify the safety .bzr directory.
580
 
 
581
 
        We just test that the _check_safety_net private method raises
582
 
        AssertionError, it's easier than building a test suite with the same
583
 
        test.
584
 
        """
585
 
        # Oops, a commit in the current directory (i.e. without local .bzr
586
 
        # directory) will crawl up the hierarchy to find a .bzr directory.
587
 
        self.run_bzr(['commit', '-mfoo', '--unchanged'])
588
 
        # But we have a safety net in place.
589
 
        self.assertRaises(AssertionError, self._check_safety_net)
590
 
 
591
620
    def test_dangling_locks_cause_failures(self):
592
621
        class TestDanglingLock(tests.TestCaseWithMemoryTransport):
593
622
            def test_function(self):
594
 
                t = self.get_transport('.')
 
623
                t = self.get_transport_from_path('.')
595
624
                l = lockdir.LockDir(t, 'lock')
596
625
                l.create()
597
626
                l.attempt_lock()
598
627
        test = TestDanglingLock('test_function')
599
628
        result = test.run()
600
 
        self.assertEqual(1, len(result.errors))
 
629
        total_failures = result.errors + result.failures
 
630
        if self._lock_check_thorough:
 
631
            self.assertEqual(1, len(total_failures))
 
632
        else:
 
633
            # When _lock_check_thorough is disabled, then we don't trigger a
 
634
            # failure
 
635
            self.assertEqual(0, len(total_failures))
601
636
 
602
637
 
603
638
class TestTestCaseWithTransport(tests.TestCaseWithTransport):
604
639
    """Tests for the convenience functions TestCaseWithTransport introduces."""
605
640
 
606
641
    def test_get_readonly_url_none(self):
607
 
        from bzrlib.transport import get_transport
608
 
        from bzrlib.transport.memory import MemoryServer
609
642
        from bzrlib.transport.readonly import ReadonlyTransportDecorator
610
 
        self.vfs_transport_factory = MemoryServer
 
643
        self.vfs_transport_factory = memory.MemoryServer
611
644
        self.transport_readonly_server = None
612
645
        # calling get_readonly_transport() constructs a decorator on the url
613
646
        # for the server
614
647
        url = self.get_readonly_url()
615
648
        url2 = self.get_readonly_url('foo/bar')
616
 
        t = get_transport(url)
617
 
        t2 = get_transport(url2)
618
 
        self.failUnless(isinstance(t, ReadonlyTransportDecorator))
619
 
        self.failUnless(isinstance(t2, ReadonlyTransportDecorator))
 
649
        t = transport.get_transport_from_url(url)
 
650
        t2 = transport.get_transport_from_url(url2)
 
651
        self.assertIsInstance(t, ReadonlyTransportDecorator)
 
652
        self.assertIsInstance(t2, ReadonlyTransportDecorator)
620
653
        self.assertEqual(t2.base[:-1], t.abspath('foo/bar'))
621
654
 
622
655
    def test_get_readonly_url_http(self):
623
656
        from bzrlib.tests.http_server import HttpServer
624
 
        from bzrlib.transport import get_transport
625
 
        from bzrlib.transport.local import LocalURLServer
626
657
        from bzrlib.transport.http import HttpTransportBase
627
 
        self.transport_server = LocalURLServer
 
658
        self.transport_server = test_server.LocalURLServer
628
659
        self.transport_readonly_server = HttpServer
629
660
        # calling get_readonly_transport() gives us a HTTP server instance.
630
661
        url = self.get_readonly_url()
631
662
        url2 = self.get_readonly_url('foo/bar')
632
663
        # the transport returned may be any HttpTransportBase subclass
633
 
        t = get_transport(url)
634
 
        t2 = get_transport(url2)
635
 
        self.failUnless(isinstance(t, HttpTransportBase))
636
 
        self.failUnless(isinstance(t2, HttpTransportBase))
 
664
        t = transport.get_transport_from_url(url)
 
665
        t2 = transport.get_transport_from_url(url2)
 
666
        self.assertIsInstance(t, HttpTransportBase)
 
667
        self.assertIsInstance(t2, HttpTransportBase)
637
668
        self.assertEqual(t2.base[:-1], t.abspath('foo/bar'))
638
669
 
639
670
    def test_is_directory(self):
647
678
    def test_make_branch_builder(self):
648
679
        builder = self.make_branch_builder('dir')
649
680
        rev_id = builder.build_commit()
650
 
        self.failUnlessExists('dir')
 
681
        self.assertPathExists('dir')
651
682
        a_dir = bzrdir.BzrDir.open('dir')
652
683
        self.assertRaises(errors.NoWorkingTree, a_dir.open_workingtree)
653
684
        a_branch = a_dir.open_branch()
661
692
 
662
693
    def setUp(self):
663
694
        super(TestTestCaseTransports, self).setUp()
664
 
        self.vfs_transport_factory = MemoryServer
 
695
        self.vfs_transport_factory = memory.MemoryServer
665
696
 
666
697
    def test_make_bzrdir_preserves_transport(self):
667
698
        t = self.get_transport()
668
699
        result_bzrdir = self.make_bzrdir('subdir')
669
700
        self.assertIsInstance(result_bzrdir.transport,
670
 
                              MemoryTransport)
 
701
                              memory.MemoryTransport)
671
702
        # should not be on disk, should only be in memory
672
 
        self.failIfExists('subdir')
 
703
        self.assertPathDoesNotExist('subdir')
673
704
 
674
705
 
675
706
class TestChrootedTest(tests.ChrootedTestCase):
676
707
 
677
708
    def test_root_is_root(self):
678
 
        from bzrlib.transport import get_transport
679
 
        t = get_transport(self.get_readonly_url())
 
709
        t = transport.get_transport_from_url(self.get_readonly_url())
680
710
        url = t.base
681
711
        self.assertEqual(url, t.clone('..').base)
682
712
 
683
713
 
684
 
class MockProgress(progress._BaseProgressBar):
685
 
    """Progress-bar standin that records calls.
686
 
 
687
 
    Useful for testing pb using code.
688
 
    """
689
 
 
690
 
    def __init__(self):
691
 
        progress._BaseProgressBar.__init__(self)
692
 
        self.calls = []
693
 
 
694
 
    def tick(self):
695
 
        self.calls.append(('tick',))
696
 
 
697
 
    def update(self, msg=None, current=None, total=None):
698
 
        self.calls.append(('update', msg, current, total))
699
 
 
700
 
    def clear(self):
701
 
        self.calls.append(('clear',))
702
 
 
703
 
    def note(self, msg, *args):
704
 
        self.calls.append(('note', msg, args))
 
714
class TestProfileResult(tests.TestCase):
 
715
 
 
716
    def test_profiles_tests(self):
 
717
        self.requireFeature(features.lsprof_feature)
 
718
        terminal = testtools.testresult.doubles.ExtendedTestResult()
 
719
        result = tests.ProfileResult(terminal)
 
720
        class Sample(tests.TestCase):
 
721
            def a(self):
 
722
                self.sample_function()
 
723
            def sample_function(self):
 
724
                pass
 
725
        test = Sample("a")
 
726
        test.run(result)
 
727
        case = terminal._events[0][1]
 
728
        self.assertLength(1, case._benchcalls)
 
729
        # We must be able to unpack it as the test reporting code wants
 
730
        (_, _, _), stats = case._benchcalls[0]
 
731
        self.assertTrue(callable(stats.pprint))
705
732
 
706
733
 
707
734
class TestTestResult(tests.TestCase):
711
738
                descriptions=0,
712
739
                verbosity=1,
713
740
                )
714
 
        test_case.run(result)
715
 
        timed_string = result._testTimeString(test_case)
 
741
        capture = testtools.testresult.doubles.ExtendedTestResult()
 
742
        test_case.run(MultiTestResult(result, capture))
 
743
        run_case = capture._events[0][1]
 
744
        timed_string = result._testTimeString(run_case)
716
745
        self.assertContainsRe(timed_string, expected_re)
717
746
 
718
747
    def test_test_reporting(self):
736
765
        self.check_timing(ShortDelayTestCase('test_short_delay'),
737
766
                          r"^ +[0-9]+ms$")
738
767
 
739
 
    def test_assigned_benchmark_file_stores_date(self):
740
 
        output = StringIO()
741
 
        result = bzrlib.tests.TextTestResult(self._log_file,
742
 
                                        descriptions=0,
743
 
                                        verbosity=1,
744
 
                                        bench_history=output
745
 
                                        )
746
 
        output_string = output.getvalue()
747
 
        # if you are wondering about the regexp please read the comment in
748
 
        # test_bench_history (bzrlib.tests.test_selftest.TestRunner)
749
 
        # XXX: what comment?  -- Andrew Bennetts
750
 
        self.assertContainsRe(output_string, "--date [0-9.]+")
751
 
 
752
 
    def test_benchhistory_records_test_times(self):
753
 
        result_stream = StringIO()
754
 
        result = bzrlib.tests.TextTestResult(
755
 
            self._log_file,
756
 
            descriptions=0,
757
 
            verbosity=1,
758
 
            bench_history=result_stream
759
 
            )
760
 
 
761
 
        # we want profile a call and check that its test duration is recorded
762
 
        # make a new test instance that when run will generate a benchmark
763
 
        example_test_case = TestTestResult("_time_hello_world_encoding")
764
 
        # execute the test, which should succeed and record times
765
 
        example_test_case.run(result)
766
 
        lines = result_stream.getvalue().splitlines()
767
 
        self.assertEqual(2, len(lines))
768
 
        self.assertContainsRe(lines[1],
769
 
            " *[0-9]+ms bzrlib.tests.test_selftest.TestTestResult"
770
 
            "._time_hello_world_encoding")
771
 
 
772
768
    def _time_hello_world_encoding(self):
773
769
        """Profile two sleep calls
774
770
 
779
775
 
780
776
    def test_lsprofiling(self):
781
777
        """Verbose test result prints lsprof statistics from test cases."""
782
 
        self.requireFeature(test_lsprof.LSProfFeature)
 
778
        self.requireFeature(features.lsprof_feature)
783
779
        result_stream = StringIO()
784
780
        result = bzrlib.tests.VerboseTestResult(
785
 
            unittest._WritelnDecorator(result_stream),
 
781
            result_stream,
786
782
            descriptions=0,
787
783
            verbosity=2,
788
784
            )
814
810
        self.assertContainsRe(output,
815
811
            r"LSProf output for <type 'unicode'>\(\('world',\), {'errors': 'replace'}\)\n")
816
812
 
 
813
    def test_uses_time_from_testtools(self):
 
814
        """Test case timings in verbose results should use testtools times"""
 
815
        import datetime
 
816
        class TimeAddedVerboseTestResult(tests.VerboseTestResult):
 
817
            def startTest(self, test):
 
818
                self.time(datetime.datetime.utcfromtimestamp(1.145))
 
819
                super(TimeAddedVerboseTestResult, self).startTest(test)
 
820
            def addSuccess(self, test):
 
821
                self.time(datetime.datetime.utcfromtimestamp(51.147))
 
822
                super(TimeAddedVerboseTestResult, self).addSuccess(test)
 
823
            def report_tests_starting(self): pass
 
824
        sio = StringIO()
 
825
        self.get_passing_test().run(TimeAddedVerboseTestResult(sio, 0, 2))
 
826
        self.assertEndsWith(sio.getvalue(), "OK    50002ms\n")
 
827
 
817
828
    def test_known_failure(self):
818
 
        """A KnownFailure being raised should trigger several result actions."""
 
829
        """Using knownFailure should trigger several result actions."""
819
830
        class InstrumentedTestResult(tests.ExtendedTestResult):
820
 
            def done(self): pass
821
 
            def startTests(self): pass
822
 
            def report_test_start(self, test): pass
823
 
            def report_known_failure(self, test, err):
824
 
                self._call = test, err
 
831
            def stopTestRun(self): pass
 
832
            def report_tests_starting(self): pass
 
833
            def report_known_failure(self, test, err=None, details=None):
 
834
                self._call = test, 'known failure'
825
835
        result = InstrumentedTestResult(None, None, None, None)
826
 
        def test_function():
827
 
            raise tests.KnownFailure('failed!')
828
 
        test = unittest.FunctionTestCase(test_function)
 
836
        class Test(tests.TestCase):
 
837
            def test_function(self):
 
838
                self.knownFailure('failed!')
 
839
        test = Test("test_function")
829
840
        test.run(result)
830
841
        # it should invoke 'report_known_failure'.
831
842
        self.assertEqual(2, len(result._call))
832
 
        self.assertEqual(test, result._call[0])
833
 
        self.assertEqual(tests.KnownFailure, result._call[1][0])
834
 
        self.assertIsInstance(result._call[1][1], tests.KnownFailure)
 
843
        self.assertEqual(test.id(), result._call[0].id())
 
844
        self.assertEqual('known failure', result._call[1])
835
845
        # we dont introspec the traceback, if the rest is ok, it would be
836
846
        # exceptional for it not to be.
837
847
        # it should update the known_failure_count on the object.
843
853
        # verbose test output formatting
844
854
        result_stream = StringIO()
845
855
        result = bzrlib.tests.VerboseTestResult(
846
 
            unittest._WritelnDecorator(result_stream),
 
856
            result_stream,
847
857
            descriptions=0,
848
858
            verbosity=2,
849
859
            )
850
 
        test = self.get_passing_test()
851
 
        result.startTest(test)
852
 
        prefix = len(result_stream.getvalue())
853
 
        # the err parameter has the shape:
854
 
        # (class, exception object, traceback)
855
 
        # KnownFailures dont get their tracebacks shown though, so we
856
 
        # can skip that.
857
 
        err = (tests.KnownFailure, tests.KnownFailure('foo'), None)
858
 
        result.report_known_failure(test, err)
859
 
        output = result_stream.getvalue()[prefix:]
860
 
        lines = output.splitlines()
861
 
        self.assertContainsRe(lines[0], r'XFAIL *\d+ms$')
862
 
        self.assertEqual(lines[1], '    foo')
863
 
        self.assertEqual(2, len(lines))
864
 
 
865
 
    def test_text_report_known_failure(self):
866
 
        # text test output formatting
867
 
        pb = MockProgress()
868
 
        result = bzrlib.tests.TextTestResult(
869
 
            StringIO(),
870
 
            descriptions=0,
871
 
            verbosity=1,
872
 
            pb=pb,
873
 
            )
874
 
        test = self.get_passing_test()
875
 
        # this seeds the state to handle reporting the test.
876
 
        result.startTest(test)
877
 
        # the err parameter has the shape:
878
 
        # (class, exception object, traceback)
879
 
        # KnownFailures dont get their tracebacks shown though, so we
880
 
        # can skip that.
881
 
        err = (tests.KnownFailure, tests.KnownFailure('foo'), None)
882
 
        result.report_known_failure(test, err)
883
 
        self.assertEqual(
884
 
            [
885
 
            ('update', '[1 in 0s] passing_test', None, None),
886
 
            ('note', 'XFAIL: %s\n%s\n', ('passing_test', err[1]))
887
 
            ],
888
 
            pb.calls)
889
 
        # known_failures should be printed in the summary, so if we run a test
890
 
        # after there are some known failures, the update prefix should match
891
 
        # this.
892
 
        result.known_failure_count = 3
893
 
        test.run(result)
894
 
        self.assertEqual(
895
 
            [
896
 
            ('update', '[2 in 0s] passing_test', None, None),
897
 
            ],
898
 
            pb.calls[2:])
 
860
        _get_test("test_xfail").run(result)
 
861
        self.assertContainsRe(result_stream.getvalue(),
 
862
            "\n\\S+\\.test_xfail\\s+XFAIL\\s+\\d+ms\n"
 
863
            "\\s*(?:Text attachment: )?reason"
 
864
            "(?:\n-+\n|: {{{)"
 
865
            "this_fails"
 
866
            "(?:\n-+\n|}}}\n)")
899
867
 
900
868
    def get_passing_test(self):
901
869
        """Return a test object that can't be run usefully."""
906
874
    def test_add_not_supported(self):
907
875
        """Test the behaviour of invoking addNotSupported."""
908
876
        class InstrumentedTestResult(tests.ExtendedTestResult):
909
 
            def done(self): pass
910
 
            def startTests(self): pass
911
 
            def report_test_start(self, test): pass
 
877
            def stopTestRun(self): pass
 
878
            def report_tests_starting(self): pass
912
879
            def report_unsupported(self, test, feature):
913
880
                self._call = test, feature
914
881
        result = InstrumentedTestResult(None, None, None, None)
915
882
        test = SampleTestCase('_test_pass')
916
 
        feature = tests.Feature()
 
883
        feature = features.Feature()
917
884
        result.startTest(test)
918
885
        result.addNotSupported(test, feature)
919
886
        # it should invoke 'report_unsupported'.
933
900
        # verbose test output formatting
934
901
        result_stream = StringIO()
935
902
        result = bzrlib.tests.VerboseTestResult(
936
 
            unittest._WritelnDecorator(result_stream),
 
903
            result_stream,
937
904
            descriptions=0,
938
905
            verbosity=2,
939
906
            )
940
907
        test = self.get_passing_test()
941
 
        feature = tests.Feature()
 
908
        feature = features.Feature()
942
909
        result.startTest(test)
943
910
        prefix = len(result_stream.getvalue())
944
911
        result.report_unsupported(test, feature)
945
912
        output = result_stream.getvalue()[prefix:]
946
913
        lines = output.splitlines()
947
 
        self.assertEqual(lines, ['NODEP        0ms',
948
 
                                 "    The feature 'Feature' is not available."])
949
 
 
950
 
    def test_text_report_unsupported(self):
951
 
        # text test output formatting
952
 
        pb = MockProgress()
953
 
        result = bzrlib.tests.TextTestResult(
954
 
            StringIO(),
955
 
            descriptions=0,
956
 
            verbosity=1,
957
 
            pb=pb,
958
 
            )
959
 
        test = self.get_passing_test()
960
 
        feature = tests.Feature()
961
 
        # this seeds the state to handle reporting the test.
962
 
        result.startTest(test)
963
 
        result.report_unsupported(test, feature)
964
 
        # no output on unsupported features
965
 
        self.assertEqual(
966
 
            [('update', '[1 in 0s] passing_test', None, None)
967
 
            ],
968
 
            pb.calls)
969
 
        # the number of missing features should be printed in the progress
970
 
        # summary, so check for that.
971
 
        result.unsupported = {'foo':0, 'bar':0}
972
 
        test.run(result)
973
 
        self.assertEqual(
974
 
            [
975
 
            ('update', '[2 in 0s, 2 missing] passing_test', None, None),
976
 
            ],
977
 
            pb.calls[1:])
 
914
        # We don't check for the final '0ms' since it may fail on slow hosts
 
915
        self.assertStartsWith(lines[0], 'NODEP')
 
916
        self.assertEqual(lines[1],
 
917
                         "    The feature 'Feature' is not available.")
978
918
 
979
919
    def test_unavailable_exception(self):
980
920
        """An UnavailableFeature being raised should invoke addNotSupported."""
981
921
        class InstrumentedTestResult(tests.ExtendedTestResult):
982
 
            def done(self): pass
983
 
            def startTests(self): pass
984
 
            def report_test_start(self, test): pass
 
922
            def stopTestRun(self): pass
 
923
            def report_tests_starting(self): pass
985
924
            def addNotSupported(self, test, feature):
986
925
                self._call = test, feature
987
926
        result = InstrumentedTestResult(None, None, None, None)
988
 
        feature = tests.Feature()
989
 
        def test_function():
990
 
            raise tests.UnavailableFeature(feature)
991
 
        test = unittest.FunctionTestCase(test_function)
 
927
        feature = features.Feature()
 
928
        class Test(tests.TestCase):
 
929
            def test_function(self):
 
930
                raise tests.UnavailableFeature(feature)
 
931
        test = Test("test_function")
992
932
        test.run(result)
993
933
        # it should invoke 'addNotSupported'.
994
934
        self.assertEqual(2, len(result._call))
995
 
        self.assertEqual(test, result._call[0])
 
935
        self.assertEqual(test.id(), result._call[0].id())
996
936
        self.assertEqual(feature, result._call[1])
997
937
        # and not count as an error
998
938
        self.assertEqual(0, result.error_count)
1009
949
    def test_strict_with_known_failure(self):
1010
950
        result = bzrlib.tests.TextTestResult(self._log_file, descriptions=0,
1011
951
                                             verbosity=1)
1012
 
        test = self.get_passing_test()
1013
 
        err = (tests.KnownFailure, tests.KnownFailure('foo'), None)
1014
 
        result._addKnownFailure(test, err)
 
952
        test = _get_test("test_xfail")
 
953
        test.run(result)
1015
954
        self.assertFalse(result.wasStrictlySuccessful())
1016
955
        self.assertEqual(None, result._extractBenchmarkTime(test))
1017
956
 
1028
967
        class InstrumentedTestResult(tests.ExtendedTestResult):
1029
968
            calls = 0
1030
969
            def startTests(self): self.calls += 1
1031
 
            def report_test_start(self, test): pass
1032
970
        result = InstrumentedTestResult(None, None, None, None)
1033
971
        def test_function():
1034
972
            pass
1036
974
        test.run(result)
1037
975
        self.assertEquals(1, result.calls)
1038
976
 
1039
 
 
1040
 
class TestUnicodeFilenameFeature(tests.TestCase):
1041
 
 
1042
 
    def test_probe_passes(self):
1043
 
        """UnicodeFilenameFeature._probe passes."""
1044
 
        # We can't test much more than that because the behaviour depends
1045
 
        # on the platform.
1046
 
        tests.UnicodeFilenameFeature._probe()
 
977
    def test_startTests_only_once(self):
 
978
        """With multiple tests startTests should still only be called once"""
 
979
        class InstrumentedTestResult(tests.ExtendedTestResult):
 
980
            calls = 0
 
981
            def startTests(self): self.calls += 1
 
982
        result = InstrumentedTestResult(None, None, None, None)
 
983
        suite = unittest.TestSuite([
 
984
            unittest.FunctionTestCase(lambda: None),
 
985
            unittest.FunctionTestCase(lambda: None)])
 
986
        suite.run(result)
 
987
        self.assertEquals(1, result.calls)
 
988
        self.assertEquals(2, result.count)
1047
989
 
1048
990
 
1049
991
class TestRunner(tests.TestCase):
1071
1013
    def test_known_failure_failed_run(self):
1072
1014
        # run a test that generates a known failure which should be printed in
1073
1015
        # the final output when real failures occur.
1074
 
        def known_failure_test():
1075
 
            raise tests.KnownFailure('failed')
 
1016
        class Test(tests.TestCase):
 
1017
            def known_failure_test(self):
 
1018
                self.expectFailure('failed', self.assertTrue, False)
1076
1019
        test = unittest.TestSuite()
1077
 
        test.addTest(unittest.FunctionTestCase(known_failure_test))
 
1020
        test.addTest(Test("known_failure_test"))
1078
1021
        def failing_test():
1079
1022
            raise AssertionError('foo')
1080
1023
        test.addTest(unittest.FunctionTestCase(failing_test))
1082
1025
        runner = tests.TextTestRunner(stream=stream)
1083
1026
        result = self.run_test_runner(runner, test)
1084
1027
        lines = stream.getvalue().splitlines()
1085
 
        self.assertEqual([
1086
 
            '',
1087
 
            '======================================================================',
1088
 
            'FAIL: unittest.FunctionTestCase (failing_test)',
1089
 
            '----------------------------------------------------------------------',
1090
 
            'Traceback (most recent call last):',
1091
 
            '    raise AssertionError(\'foo\')',
1092
 
            'AssertionError: foo',
1093
 
            '',
1094
 
            '----------------------------------------------------------------------',
1095
 
            '',
1096
 
            'FAILED (failures=1, known_failure_count=1)'],
1097
 
            lines[3:8] + lines[9:13] + lines[14:])
 
1028
        self.assertContainsRe(stream.getvalue(),
 
1029
            '(?sm)^bzr selftest.*$'
 
1030
            '.*'
 
1031
            '^======================================================================\n'
 
1032
            '^FAIL: failing_test\n'
 
1033
            '^----------------------------------------------------------------------\n'
 
1034
            'Traceback \\(most recent call last\\):\n'
 
1035
            '  .*' # File .*, line .*, in failing_test' - but maybe not from .pyc
 
1036
            '    raise AssertionError\\(\'foo\'\\)\n'
 
1037
            '.*'
 
1038
            '^----------------------------------------------------------------------\n'
 
1039
            '.*'
 
1040
            'FAILED \\(failures=1, known_failure_count=1\\)'
 
1041
            )
1098
1042
 
1099
1043
    def test_known_failure_ok_run(self):
1100
 
        # run a test that generates a known failure which should be printed in the final output.
1101
 
        def known_failure_test():
1102
 
            raise tests.KnownFailure('failed')
1103
 
        test = unittest.FunctionTestCase(known_failure_test)
 
1044
        # run a test that generates a known failure which should be printed in
 
1045
        # the final output.
 
1046
        class Test(tests.TestCase):
 
1047
            def known_failure_test(self):
 
1048
                self.knownFailure("Never works...")
 
1049
        test = Test("known_failure_test")
1104
1050
        stream = StringIO()
1105
1051
        runner = tests.TextTestRunner(stream=stream)
1106
1052
        result = self.run_test_runner(runner, test)
1111
1057
            '\n'
1112
1058
            'OK \\(known_failures=1\\)\n')
1113
1059
 
 
1060
    def test_unexpected_success_bad(self):
 
1061
        class Test(tests.TestCase):
 
1062
            def test_truth(self):
 
1063
                self.expectFailure("No absolute truth", self.assertTrue, True)
 
1064
        runner = tests.TextTestRunner(stream=StringIO())
 
1065
        result = self.run_test_runner(runner, Test("test_truth"))
 
1066
        if testtools_version[:3] <= (0, 9, 11):
 
1067
            self.assertContainsRe(runner.stream.getvalue(),
 
1068
                "=+\n"
 
1069
                "FAIL: \\S+\.test_truth\n"
 
1070
                "-+\n"
 
1071
                "(?:.*\n)*"
 
1072
                "No absolute truth\n"
 
1073
                "(?:.*\n)*"
 
1074
                "-+\n"
 
1075
                "Ran 1 test in .*\n"
 
1076
                "\n"
 
1077
                "FAILED \\(failures=1\\)\n\\Z")
 
1078
        else:
 
1079
            self.assertContainsRe(runner.stream.getvalue(),
 
1080
                "=+\n"
 
1081
                "FAIL: \\S+\.test_truth\n"
 
1082
                "-+\n"
 
1083
                "Empty attachments:\n"
 
1084
                "  log\n"
 
1085
                "\n"
 
1086
                "reason: {{{No absolute truth}}}\n"
 
1087
                "-+\n"
 
1088
                "Ran 1 test in .*\n"
 
1089
                "\n"
 
1090
                "FAILED \\(failures=1\\)\n\\Z")
 
1091
 
 
1092
    def test_result_decorator(self):
 
1093
        # decorate results
 
1094
        calls = []
 
1095
        class LoggingDecorator(ExtendedToOriginalDecorator):
 
1096
            def startTest(self, test):
 
1097
                ExtendedToOriginalDecorator.startTest(self, test)
 
1098
                calls.append('start')
 
1099
        test = unittest.FunctionTestCase(lambda:None)
 
1100
        stream = StringIO()
 
1101
        runner = tests.TextTestRunner(stream=stream,
 
1102
            result_decorators=[LoggingDecorator])
 
1103
        result = self.run_test_runner(runner, test)
 
1104
        self.assertLength(1, calls)
 
1105
 
1114
1106
    def test_skipped_test(self):
1115
1107
        # run a test that is skipped, and check the suite as a whole still
1116
1108
        # succeeds.
1169
1161
 
1170
1162
    def test_not_applicable(self):
1171
1163
        # run a test that is skipped because it's not applicable
1172
 
        def not_applicable_test():
1173
 
            raise tests.TestNotApplicable('this test never runs')
 
1164
        class Test(tests.TestCase):
 
1165
            def not_applicable_test(self):
 
1166
                raise tests.TestNotApplicable('this test never runs')
1174
1167
        out = StringIO()
1175
1168
        runner = tests.TextTestRunner(stream=out, verbosity=2)
1176
 
        test = unittest.FunctionTestCase(not_applicable_test)
 
1169
        test = Test("not_applicable_test")
1177
1170
        result = self.run_test_runner(runner, test)
1178
1171
        self._log_file.write(out.getvalue())
1179
1172
        self.assertTrue(result.wasSuccessful())
1183
1176
        self.assertContainsRe(out.getvalue(),
1184
1177
                r'(?m)^    this test never runs')
1185
1178
 
1186
 
    def test_not_applicable_demo(self):
1187
 
        # just so you can see it in the test output
1188
 
        raise tests.TestNotApplicable('this test is just a demonstation')
1189
 
 
1190
1179
    def test_unsupported_features_listed(self):
1191
1180
        """When unsupported features are encountered they are detailed."""
1192
 
        class Feature1(tests.Feature):
 
1181
        class Feature1(features.Feature):
1193
1182
            def _probe(self): return False
1194
 
        class Feature2(tests.Feature):
 
1183
        class Feature2(features.Feature):
1195
1184
            def _probe(self): return False
1196
1185
        # create sample tests
1197
1186
        test1 = SampleTestCase('_test_pass')
1212
1201
            ],
1213
1202
            lines[-3:])
1214
1203
 
1215
 
    def test_bench_history(self):
1216
 
        # tests that the running the benchmark produces a history file
1217
 
        # containing a timestamp and the revision id of the bzrlib source which
1218
 
        # was tested.
1219
 
        workingtree = _get_bzr_source_tree()
1220
 
        test = TestRunner('dummy_test')
1221
 
        output = StringIO()
1222
 
        runner = tests.TextTestRunner(stream=self._log_file,
1223
 
                                      bench_history=output)
1224
 
        result = self.run_test_runner(runner, test)
1225
 
        output_string = output.getvalue()
1226
 
        self.assertContainsRe(output_string, "--date [0-9.]+")
1227
 
        if workingtree is not None:
1228
 
            revision_id = workingtree.get_parent_ids()[0]
1229
 
            self.assertEndsWith(output_string.rstrip(), revision_id)
1230
 
 
1231
 
    def assertLogDeleted(self, test):
1232
 
        log = test._get_log()
1233
 
        self.assertEqual("DELETED log file to reduce memory footprint", log)
1234
 
        self.assertEqual('', test._log_contents)
1235
 
        self.assertIs(None, test._log_file_name)
1236
 
 
1237
 
    def test_success_log_deleted(self):
1238
 
        """Successful tests have their log deleted"""
1239
 
 
1240
 
        class LogTester(tests.TestCase):
1241
 
 
1242
 
            def test_success(self):
1243
 
                self.log('this will be removed\n')
1244
 
 
1245
 
        sio = StringIO()
1246
 
        runner = tests.TextTestRunner(stream=sio)
1247
 
        test = LogTester('test_success')
1248
 
        result = self.run_test_runner(runner, test)
1249
 
 
1250
 
        self.assertLogDeleted(test)
1251
 
 
1252
 
    def test_skipped_log_deleted(self):
1253
 
        """Skipped tests have their log deleted"""
1254
 
 
1255
 
        class LogTester(tests.TestCase):
1256
 
 
1257
 
            def test_skipped(self):
1258
 
                self.log('this will be removed\n')
1259
 
                raise tests.TestSkipped()
1260
 
 
1261
 
        sio = StringIO()
1262
 
        runner = tests.TextTestRunner(stream=sio)
1263
 
        test = LogTester('test_skipped')
1264
 
        result = self.run_test_runner(runner, test)
1265
 
 
1266
 
        self.assertLogDeleted(test)
1267
 
 
1268
 
    def test_not_aplicable_log_deleted(self):
1269
 
        """Not applicable tests have their log deleted"""
1270
 
 
1271
 
        class LogTester(tests.TestCase):
1272
 
 
1273
 
            def test_not_applicable(self):
1274
 
                self.log('this will be removed\n')
1275
 
                raise tests.TestNotApplicable()
1276
 
 
1277
 
        sio = StringIO()
1278
 
        runner = tests.TextTestRunner(stream=sio)
1279
 
        test = LogTester('test_not_applicable')
1280
 
        result = self.run_test_runner(runner, test)
1281
 
 
1282
 
        self.assertLogDeleted(test)
1283
 
 
1284
 
    def test_known_failure_log_deleted(self):
1285
 
        """Know failure tests have their log deleted"""
1286
 
 
1287
 
        class LogTester(tests.TestCase):
1288
 
 
1289
 
            def test_known_failure(self):
1290
 
                self.log('this will be removed\n')
1291
 
                raise tests.KnownFailure()
1292
 
 
1293
 
        sio = StringIO()
1294
 
        runner = tests.TextTestRunner(stream=sio)
1295
 
        test = LogTester('test_known_failure')
1296
 
        result = self.run_test_runner(runner, test)
1297
 
 
1298
 
        self.assertLogDeleted(test)
1299
 
 
1300
 
    def test_fail_log_kept(self):
1301
 
        """Failed tests have their log kept"""
1302
 
 
1303
 
        class LogTester(tests.TestCase):
1304
 
 
1305
 
            def test_fail(self):
1306
 
                self.log('this will be kept\n')
1307
 
                self.fail('this test fails')
1308
 
 
1309
 
        sio = StringIO()
1310
 
        runner = tests.TextTestRunner(stream=sio)
1311
 
        test = LogTester('test_fail')
1312
 
        result = self.run_test_runner(runner, test)
1313
 
 
1314
 
        text = sio.getvalue()
1315
 
        self.assertContainsRe(text, 'this will be kept')
1316
 
        self.assertContainsRe(text, 'this test fails')
1317
 
 
1318
 
        log = test._get_log()
1319
 
        self.assertContainsRe(log, 'this will be kept')
1320
 
        self.assertEqual(log, test._log_contents)
1321
 
 
1322
 
    def test_error_log_kept(self):
1323
 
        """Tests with errors have their log kept"""
1324
 
 
1325
 
        class LogTester(tests.TestCase):
1326
 
 
1327
 
            def test_error(self):
1328
 
                self.log('this will be kept\n')
1329
 
                raise ValueError('random exception raised')
1330
 
 
1331
 
        sio = StringIO()
1332
 
        runner = tests.TextTestRunner(stream=sio)
1333
 
        test = LogTester('test_error')
1334
 
        result = self.run_test_runner(runner, test)
1335
 
 
1336
 
        text = sio.getvalue()
1337
 
        self.assertContainsRe(text, 'this will be kept')
1338
 
        self.assertContainsRe(text, 'random exception raised')
1339
 
 
1340
 
        log = test._get_log()
1341
 
        self.assertContainsRe(log, 'this will be kept')
1342
 
        self.assertEqual(log, test._log_contents)
 
1204
    def test_verbose_test_count(self):
 
1205
        """A verbose test run reports the right test count at the start"""
 
1206
        suite = TestUtil.TestSuite([
 
1207
            unittest.FunctionTestCase(lambda:None),
 
1208
            unittest.FunctionTestCase(lambda:None)])
 
1209
        self.assertEqual(suite.countTestCases(), 2)
 
1210
        stream = StringIO()
 
1211
        runner = tests.TextTestRunner(stream=stream, verbosity=2)
 
1212
        # Need to use the CountingDecorator as that's what sets num_tests
 
1213
        result = self.run_test_runner(runner, tests.CountingDecorator(suite))
 
1214
        self.assertStartsWith(stream.getvalue(), "running 2 tests")
 
1215
 
 
1216
    def test_startTestRun(self):
 
1217
        """run should call result.startTestRun()"""
 
1218
        calls = []
 
1219
        class LoggingDecorator(ExtendedToOriginalDecorator):
 
1220
            def startTestRun(self):
 
1221
                ExtendedToOriginalDecorator.startTestRun(self)
 
1222
                calls.append('startTestRun')
 
1223
        test = unittest.FunctionTestCase(lambda:None)
 
1224
        stream = StringIO()
 
1225
        runner = tests.TextTestRunner(stream=stream,
 
1226
            result_decorators=[LoggingDecorator])
 
1227
        result = self.run_test_runner(runner, test)
 
1228
        self.assertLength(1, calls)
 
1229
 
 
1230
    def test_stopTestRun(self):
 
1231
        """run should call result.stopTestRun()"""
 
1232
        calls = []
 
1233
        class LoggingDecorator(ExtendedToOriginalDecorator):
 
1234
            def stopTestRun(self):
 
1235
                ExtendedToOriginalDecorator.stopTestRun(self)
 
1236
                calls.append('stopTestRun')
 
1237
        test = unittest.FunctionTestCase(lambda:None)
 
1238
        stream = StringIO()
 
1239
        runner = tests.TextTestRunner(stream=stream,
 
1240
            result_decorators=[LoggingDecorator])
 
1241
        result = self.run_test_runner(runner, test)
 
1242
        self.assertLength(1, calls)
 
1243
 
 
1244
    def test_unicode_test_output_on_ascii_stream(self):
 
1245
        """Showing results should always succeed even on an ascii console"""
 
1246
        class FailureWithUnicode(tests.TestCase):
 
1247
            def test_log_unicode(self):
 
1248
                self.log(u"\u2606")
 
1249
                self.fail("Now print that log!")
 
1250
        out = StringIO()
 
1251
        self.overrideAttr(osutils, "get_terminal_encoding",
 
1252
            lambda trace=False: "ascii")
 
1253
        result = self.run_test_runner(tests.TextTestRunner(stream=out),
 
1254
            FailureWithUnicode("test_log_unicode"))
 
1255
        if testtools_version[:3] > (0, 9, 11):
 
1256
            self.assertContainsRe(out.getvalue(), "log: {{{\d+\.\d+  \\\\u2606}}}")
 
1257
        else:
 
1258
            self.assertContainsRe(out.getvalue(),
 
1259
                "Text attachment: log\n"
 
1260
                "-+\n"
 
1261
                "\d+\.\d+  \\\\u2606\n"
 
1262
                "-+\n")
1343
1263
 
1344
1264
 
1345
1265
class SampleTestCase(tests.TestCase):
1350
1270
class _TestException(Exception):
1351
1271
    pass
1352
1272
 
 
1273
 
1353
1274
class TestTestCase(tests.TestCase):
1354
1275
    """Tests that test the core bzrlib TestCase."""
1355
1276
 
1404
1325
        # we could set something and run a test that will check
1405
1326
        # it gets santised, but this is probably sufficient for now:
1406
1327
        # if someone runs the test with -Dsomething it will error.
1407
 
        self.assertEqual(set(), bzrlib.debug.debug_flags)
 
1328
        flags = set()
 
1329
        if self._lock_check_thorough:
 
1330
            flags.add('strict_locks')
 
1331
        self.assertEqual(flags, bzrlib.debug.debug_flags)
1408
1332
 
1409
1333
    def change_selftest_debug_flags(self, new_flags):
1410
 
        orig_selftest_flags = tests.selftest_debug_flags
1411
 
        self.addCleanup(self._restore_selftest_debug_flags, orig_selftest_flags)
1412
 
        tests.selftest_debug_flags = set(new_flags)
1413
 
 
1414
 
    def _restore_selftest_debug_flags(self, flags):
1415
 
        tests.selftest_debug_flags = flags
 
1334
        self.overrideAttr(tests, 'selftest_debug_flags', set(new_flags))
1416
1335
 
1417
1336
    def test_allow_debug_flag(self):
1418
1337
        """The -Eallow_debug flag prevents bzrlib.debug.debug_flags from being
1425
1344
                self.flags = set(bzrlib.debug.debug_flags)
1426
1345
        test = TestThatRecordsFlags('test_foo')
1427
1346
        test.run(self.make_test_result())
1428
 
        self.assertEqual(set(['a-flag']), self.flags)
 
1347
        flags = set(['a-flag'])
 
1348
        if 'disable_lock_checks' not in tests.selftest_debug_flags:
 
1349
            flags.add('strict_locks')
 
1350
        self.assertEqual(flags, self.flags)
 
1351
 
 
1352
    def test_disable_lock_checks(self):
 
1353
        """The -Edisable_lock_checks flag disables thorough checks."""
 
1354
        class TestThatRecordsFlags(tests.TestCase):
 
1355
            def test_foo(nested_self):
 
1356
                self.flags = set(bzrlib.debug.debug_flags)
 
1357
                self.test_lock_check_thorough = nested_self._lock_check_thorough
 
1358
        self.change_selftest_debug_flags(set())
 
1359
        test = TestThatRecordsFlags('test_foo')
 
1360
        test.run(self.make_test_result())
 
1361
        # By default we do strict lock checking and thorough lock/unlock
 
1362
        # tracking.
 
1363
        self.assertTrue(self.test_lock_check_thorough)
 
1364
        self.assertEqual(set(['strict_locks']), self.flags)
 
1365
        # Now set the disable_lock_checks flag, and show that this changed.
 
1366
        self.change_selftest_debug_flags(set(['disable_lock_checks']))
 
1367
        test = TestThatRecordsFlags('test_foo')
 
1368
        test.run(self.make_test_result())
 
1369
        self.assertFalse(self.test_lock_check_thorough)
 
1370
        self.assertEqual(set(), self.flags)
 
1371
 
 
1372
    def test_this_fails_strict_lock_check(self):
 
1373
        class TestThatRecordsFlags(tests.TestCase):
 
1374
            def test_foo(nested_self):
 
1375
                self.flags1 = set(bzrlib.debug.debug_flags)
 
1376
                self.thisFailsStrictLockCheck()
 
1377
                self.flags2 = set(bzrlib.debug.debug_flags)
 
1378
        # Make sure lock checking is active
 
1379
        self.change_selftest_debug_flags(set())
 
1380
        test = TestThatRecordsFlags('test_foo')
 
1381
        test.run(self.make_test_result())
 
1382
        self.assertEqual(set(['strict_locks']), self.flags1)
 
1383
        self.assertEqual(set(), self.flags2)
1429
1384
 
1430
1385
    def test_debug_flags_restored(self):
1431
1386
        """The bzrlib debug flags should be restored to their original state
1442
1397
        self.assertEqual(set(['original-state']), bzrlib.debug.debug_flags)
1443
1398
 
1444
1399
    def make_test_result(self):
 
1400
        """Get a test result that writes to the test log file."""
1445
1401
        return tests.TextTestResult(self._log_file, descriptions=0, verbosity=1)
1446
1402
 
1447
1403
    def inner_test(self):
1455
1411
        result = self.make_test_result()
1456
1412
        self.inner_test.run(result)
1457
1413
        note("outer finish")
 
1414
        self.addCleanup(osutils.delete_any, self._log_file_name)
1458
1415
 
1459
1416
    def test_trace_nesting(self):
1460
1417
        # this tests that each test case nests its trace facility correctly.
1484
1441
        sample_test = TestTestCase("method_that_times_a_bit_twice")
1485
1442
        output_stream = StringIO()
1486
1443
        result = bzrlib.tests.VerboseTestResult(
1487
 
            unittest._WritelnDecorator(output_stream),
 
1444
            output_stream,
1488
1445
            descriptions=0,
1489
 
            verbosity=2,
1490
 
            num_tests=sample_test.countTestCases())
 
1446
            verbosity=2)
1491
1447
        sample_test.run(result)
1492
1448
        self.assertContainsRe(
1493
1449
            output_stream.getvalue(),
1498
1454
        # Note this test won't fail with hooks that the core library doesn't
1499
1455
        # use - but it trigger with a plugin that adds hooks, so its still a
1500
1456
        # useful warning in that case.
1501
 
        self.assertEqual(bzrlib.branch.BranchHooks(),
1502
 
            bzrlib.branch.Branch.hooks)
1503
 
        self.assertEqual(bzrlib.smart.server.SmartServerHooks(),
 
1457
        self.assertEqual(bzrlib.branch.BranchHooks(), bzrlib.branch.Branch.hooks)
 
1458
        self.assertEqual(
 
1459
            bzrlib.smart.server.SmartServerHooks(),
1504
1460
            bzrlib.smart.server.SmartTCPServer.hooks)
1505
 
        self.assertEqual(bzrlib.commands.CommandHooks(),
1506
 
            bzrlib.commands.Command.hooks)
 
1461
        self.assertEqual(
 
1462
            bzrlib.commands.CommandHooks(), bzrlib.commands.Command.hooks)
1507
1463
 
1508
1464
    def test__gather_lsprof_in_benchmarks(self):
1509
1465
        """When _gather_lsprof_in_benchmarks is on, accumulate profile data.
1510
1466
 
1511
1467
        Each self.time() call is individually and separately profiled.
1512
1468
        """
1513
 
        self.requireFeature(test_lsprof.LSProfFeature)
 
1469
        self.requireFeature(features.lsprof_feature)
1514
1470
        # overrides the class member with an instance member so no cleanup
1515
1471
        # needed.
1516
1472
        self._gather_lsprof_in_benchmarks = True
1521
1477
        self.assertEqual((time.sleep, (0.003,), {}), self._benchcalls[1][0])
1522
1478
        self.assertIsInstance(self._benchcalls[0][1], bzrlib.lsprof.Stats)
1523
1479
        self.assertIsInstance(self._benchcalls[1][1], bzrlib.lsprof.Stats)
 
1480
        del self._benchcalls[:]
1524
1481
 
1525
1482
    def test_knownFailure(self):
1526
1483
        """Self.knownFailure() should raise a KnownFailure exception."""
1527
1484
        self.assertRaises(tests.KnownFailure, self.knownFailure, "A Failure")
1528
1485
 
 
1486
    def test_open_bzrdir_safe_roots(self):
 
1487
        # even a memory transport should fail to open when its url isn't 
 
1488
        # permitted.
 
1489
        # Manually set one up (TestCase doesn't and shouldn't provide magic
 
1490
        # machinery)
 
1491
        transport_server = memory.MemoryServer()
 
1492
        transport_server.start_server()
 
1493
        self.addCleanup(transport_server.stop_server)
 
1494
        t = transport.get_transport_from_url(transport_server.get_url())
 
1495
        bzrdir.BzrDir.create(t.base)
 
1496
        self.assertRaises(errors.BzrError,
 
1497
            bzrdir.BzrDir.open_from_transport, t)
 
1498
        # But if we declare this as safe, we can open the bzrdir.
 
1499
        self.permit_url(t.base)
 
1500
        self._bzr_selftest_roots.append(t.base)
 
1501
        bzrdir.BzrDir.open_from_transport(t)
 
1502
 
1529
1503
    def test_requireFeature_available(self):
1530
1504
        """self.requireFeature(available) is a no-op."""
1531
 
        class Available(tests.Feature):
 
1505
        class Available(features.Feature):
1532
1506
            def _probe(self):return True
1533
1507
        feature = Available()
1534
1508
        self.requireFeature(feature)
1535
1509
 
1536
1510
    def test_requireFeature_unavailable(self):
1537
1511
        """self.requireFeature(unavailable) raises UnavailableFeature."""
1538
 
        class Unavailable(tests.Feature):
 
1512
        class Unavailable(features.Feature):
1539
1513
            def _probe(self):return False
1540
1514
        feature = Unavailable()
1541
1515
        self.assertRaises(tests.UnavailableFeature,
1575
1549
        """Test disabled tests behaviour with support aware results."""
1576
1550
        test = SampleTestCase('_test_pass')
1577
1551
        class DisabledFeature(object):
 
1552
            def __eq__(self, other):
 
1553
                return isinstance(other, DisabledFeature)
1578
1554
            def available(self):
1579
1555
                return False
1580
1556
        the_feature = DisabledFeature()
1591
1567
                self.calls.append(('addNotSupported', test, feature))
1592
1568
        result = InstrumentedTestResult()
1593
1569
        test.run(result)
 
1570
        case = result.calls[0][1]
1594
1571
        self.assertEqual([
1595
 
            ('startTest', test),
1596
 
            ('addNotSupported', test, the_feature),
1597
 
            ('stopTest', test),
 
1572
            ('startTest', case),
 
1573
            ('addNotSupported', case, the_feature),
 
1574
            ('stopTest', case),
1598
1575
            ],
1599
1576
            result.calls)
1600
1577
 
 
1578
    def test_start_server_registers_url(self):
 
1579
        transport_server = memory.MemoryServer()
 
1580
        # A little strict, but unlikely to be changed soon.
 
1581
        self.assertEqual([], self._bzr_selftest_roots)
 
1582
        self.start_server(transport_server)
 
1583
        self.assertSubset([transport_server.get_url()],
 
1584
            self._bzr_selftest_roots)
 
1585
 
1601
1586
    def test_assert_list_raises_on_generator(self):
1602
1587
        def generator_which_will_raise():
1603
1588
            # This will not raise until after the first yield
1653
1638
        self.assertRaises(AssertionError,
1654
1639
            self.assertListRaises, _TestException, success_generator)
1655
1640
 
 
1641
    def test_overrideAttr_without_value(self):
 
1642
        self.test_attr = 'original' # Define a test attribute
 
1643
        obj = self # Make 'obj' visible to the embedded test
 
1644
        class Test(tests.TestCase):
 
1645
 
 
1646
            def setUp(self):
 
1647
                tests.TestCase.setUp(self)
 
1648
                self.orig = self.overrideAttr(obj, 'test_attr')
 
1649
 
 
1650
            def test_value(self):
 
1651
                self.assertEqual('original', self.orig)
 
1652
                self.assertEqual('original', obj.test_attr)
 
1653
                obj.test_attr = 'modified'
 
1654
                self.assertEqual('modified', obj.test_attr)
 
1655
 
 
1656
        test = Test('test_value')
 
1657
        test.run(unittest.TestResult())
 
1658
        self.assertEqual('original', obj.test_attr)
 
1659
 
 
1660
    def test_overrideAttr_with_value(self):
 
1661
        self.test_attr = 'original' # Define a test attribute
 
1662
        obj = self # Make 'obj' visible to the embedded test
 
1663
        class Test(tests.TestCase):
 
1664
 
 
1665
            def setUp(self):
 
1666
                tests.TestCase.setUp(self)
 
1667
                self.orig = self.overrideAttr(obj, 'test_attr', new='modified')
 
1668
 
 
1669
            def test_value(self):
 
1670
                self.assertEqual('original', self.orig)
 
1671
                self.assertEqual('modified', obj.test_attr)
 
1672
 
 
1673
        test = Test('test_value')
 
1674
        test.run(unittest.TestResult())
 
1675
        self.assertEqual('original', obj.test_attr)
 
1676
 
 
1677
    def test_recordCalls(self):
 
1678
        from bzrlib.tests import test_selftest
 
1679
        calls = self.recordCalls(
 
1680
            test_selftest, '_add_numbers')
 
1681
        self.assertEqual(test_selftest._add_numbers(2, 10),
 
1682
            12)
 
1683
        self.assertEquals(calls, [((2, 10), {})])
 
1684
 
 
1685
 
 
1686
def _add_numbers(a, b):
 
1687
    return a + b
 
1688
 
 
1689
 
 
1690
class _MissingFeature(features.Feature):
 
1691
    def _probe(self):
 
1692
        return False
 
1693
missing_feature = _MissingFeature()
 
1694
 
 
1695
 
 
1696
def _get_test(name):
 
1697
    """Get an instance of a specific example test.
 
1698
 
 
1699
    We protect this in a function so that they don't auto-run in the test
 
1700
    suite.
 
1701
    """
 
1702
 
 
1703
    class ExampleTests(tests.TestCase):
 
1704
 
 
1705
        def test_fail(self):
 
1706
            mutter('this was a failing test')
 
1707
            self.fail('this test will fail')
 
1708
 
 
1709
        def test_error(self):
 
1710
            mutter('this test errored')
 
1711
            raise RuntimeError('gotcha')
 
1712
 
 
1713
        def test_missing_feature(self):
 
1714
            mutter('missing the feature')
 
1715
            self.requireFeature(missing_feature)
 
1716
 
 
1717
        def test_skip(self):
 
1718
            mutter('this test will be skipped')
 
1719
            raise tests.TestSkipped('reason')
 
1720
 
 
1721
        def test_success(self):
 
1722
            mutter('this test succeeds')
 
1723
 
 
1724
        def test_xfail(self):
 
1725
            mutter('test with expected failure')
 
1726
            self.knownFailure('this_fails')
 
1727
 
 
1728
        def test_unexpected_success(self):
 
1729
            mutter('test with unexpected success')
 
1730
            self.expectFailure('should_fail', lambda: None)
 
1731
 
 
1732
    return ExampleTests(name)
 
1733
 
 
1734
 
 
1735
class TestTestCaseLogDetails(tests.TestCase):
 
1736
 
 
1737
    def _run_test(self, test_name):
 
1738
        test = _get_test(test_name)
 
1739
        result = testtools.TestResult()
 
1740
        test.run(result)
 
1741
        return result
 
1742
 
 
1743
    def test_fail_has_log(self):
 
1744
        result = self._run_test('test_fail')
 
1745
        self.assertEqual(1, len(result.failures))
 
1746
        result_content = result.failures[0][1]
 
1747
        if testtools_version < (0, 9, 12):
 
1748
            self.assertContainsRe(result_content, 'Text attachment: log')
 
1749
        self.assertContainsRe(result_content, 'this was a failing test')
 
1750
 
 
1751
    def test_error_has_log(self):
 
1752
        result = self._run_test('test_error')
 
1753
        self.assertEqual(1, len(result.errors))
 
1754
        result_content = result.errors[0][1]
 
1755
        if testtools_version < (0, 9, 12):
 
1756
            self.assertContainsRe(result_content, 'Text attachment: log')
 
1757
        self.assertContainsRe(result_content, 'this test errored')
 
1758
 
 
1759
    def test_skip_has_no_log(self):
 
1760
        result = self._run_test('test_skip')
 
1761
        self.assertEqual(['reason'], result.skip_reasons.keys())
 
1762
        skips = result.skip_reasons['reason']
 
1763
        self.assertEqual(1, len(skips))
 
1764
        test = skips[0]
 
1765
        self.assertFalse('log' in test.getDetails())
 
1766
 
 
1767
    def test_missing_feature_has_no_log(self):
 
1768
        # testtools doesn't know about addNotSupported, so it just gets
 
1769
        # considered as a skip
 
1770
        result = self._run_test('test_missing_feature')
 
1771
        self.assertEqual([missing_feature], result.skip_reasons.keys())
 
1772
        skips = result.skip_reasons[missing_feature]
 
1773
        self.assertEqual(1, len(skips))
 
1774
        test = skips[0]
 
1775
        self.assertFalse('log' in test.getDetails())
 
1776
 
 
1777
    def test_xfail_has_no_log(self):
 
1778
        result = self._run_test('test_xfail')
 
1779
        self.assertEqual(1, len(result.expectedFailures))
 
1780
        result_content = result.expectedFailures[0][1]
 
1781
        self.assertNotContainsRe(result_content, 'Text attachment: log')
 
1782
        self.assertNotContainsRe(result_content, 'test with expected failure')
 
1783
 
 
1784
    def test_unexpected_success_has_log(self):
 
1785
        result = self._run_test('test_unexpected_success')
 
1786
        self.assertEqual(1, len(result.unexpectedSuccesses))
 
1787
        # Inconsistency, unexpectedSuccesses is a list of tests,
 
1788
        # expectedFailures is a list of reasons?
 
1789
        test = result.unexpectedSuccesses[0]
 
1790
        details = test.getDetails()
 
1791
        self.assertTrue('log' in details)
 
1792
 
 
1793
 
 
1794
class TestTestCloning(tests.TestCase):
 
1795
    """Tests that test cloning of TestCases (as used by multiply_tests)."""
 
1796
 
 
1797
    def test_cloned_testcase_does_not_share_details(self):
 
1798
        """A TestCase cloned with clone_test does not share mutable attributes
 
1799
        such as details or cleanups.
 
1800
        """
 
1801
        class Test(tests.TestCase):
 
1802
            def test_foo(self):
 
1803
                self.addDetail('foo', Content('text/plain', lambda: 'foo'))
 
1804
        orig_test = Test('test_foo')
 
1805
        cloned_test = tests.clone_test(orig_test, orig_test.id() + '(cloned)')
 
1806
        orig_test.run(unittest.TestResult())
 
1807
        self.assertEqual('foo', orig_test.getDetails()['foo'].iter_bytes())
 
1808
        self.assertEqual(None, cloned_test.getDetails().get('foo'))
 
1809
 
 
1810
    def test_double_apply_scenario_preserves_first_scenario(self):
 
1811
        """Applying two levels of scenarios to a test preserves the attributes
 
1812
        added by both scenarios.
 
1813
        """
 
1814
        class Test(tests.TestCase):
 
1815
            def test_foo(self):
 
1816
                pass
 
1817
        test = Test('test_foo')
 
1818
        scenarios_x = [('x=1', {'x': 1}), ('x=2', {'x': 2})]
 
1819
        scenarios_y = [('y=1', {'y': 1}), ('y=2', {'y': 2})]
 
1820
        suite = tests.multiply_tests(test, scenarios_x, unittest.TestSuite())
 
1821
        suite = tests.multiply_tests(suite, scenarios_y, unittest.TestSuite())
 
1822
        all_tests = list(tests.iter_suite_tests(suite))
 
1823
        self.assertLength(4, all_tests)
 
1824
        all_xys = sorted((t.x, t.y) for t in all_tests)
 
1825
        self.assertEqual([(1, 1), (1, 2), (2, 1), (2, 2)], all_xys)
 
1826
 
1656
1827
 
1657
1828
# NB: Don't delete this; it's not actually from 0.11!
1658
1829
@deprecated_function(deprecated_in((0, 11, 0)))
1701
1872
        self.assertEndsWith('foo', 'oo')
1702
1873
        self.assertRaises(AssertionError, self.assertEndsWith, 'o', 'oo')
1703
1874
 
 
1875
    def test_assertEqualDiff(self):
 
1876
        e = self.assertRaises(AssertionError,
 
1877
                              self.assertEqualDiff, '', '\n')
 
1878
        self.assertEquals(str(e),
 
1879
                          # Don't blink ! The '+' applies to the second string
 
1880
                          'first string is missing a final newline.\n+ \n')
 
1881
        e = self.assertRaises(AssertionError,
 
1882
                              self.assertEqualDiff, '\n', '')
 
1883
        self.assertEquals(str(e),
 
1884
                          # Don't blink ! The '-' applies to the second string
 
1885
                          'second string is missing a final newline.\n- \n')
 
1886
 
 
1887
 
 
1888
class TestDeprecations(tests.TestCase):
 
1889
 
1704
1890
    def test_applyDeprecated_not_deprecated(self):
1705
1891
        sample_object = ApplyDeprecatedHelper()
1706
1892
        # calling an undeprecated callable raises an assertion
1771
1957
    def test_make_branch_and_tree_with_format(self):
1772
1958
        # we should be able to supply a format to make_branch_and_tree
1773
1959
        self.make_branch_and_tree('a', format=bzrlib.bzrdir.BzrDirMetaFormat1())
1774
 
        self.make_branch_and_tree('b', format=bzrlib.bzrdir.BzrDirFormat6())
1775
1960
        self.assertIsInstance(bzrlib.bzrdir.BzrDir.open('a')._format,
1776
1961
                              bzrlib.bzrdir.BzrDirMetaFormat1)
1777
 
        self.assertIsInstance(bzrlib.bzrdir.BzrDir.open('b')._format,
1778
 
                              bzrlib.bzrdir.BzrDirFormat6)
1779
1962
 
1780
1963
    def test_make_branch_and_memory_tree(self):
1781
1964
        # we should be able to get a new branch and a mutable tree from
1783
1966
        tree = self.make_branch_and_memory_tree('a')
1784
1967
        self.assertIsInstance(tree, bzrlib.memorytree.MemoryTree)
1785
1968
 
1786
 
 
1787
 
class TestSFTPMakeBranchAndTree(test_sftp_transport.TestCaseWithSFTPServer):
1788
 
 
1789
 
    def test_make_tree_for_sftp_branch(self):
1790
 
        """Transports backed by local directories create local trees."""
1791
 
 
 
1969
    def test_make_tree_for_local_vfs_backed_transport(self):
 
1970
        # make_branch_and_tree has to use local branch and repositories
 
1971
        # when the vfs transport and local disk are colocated, even if
 
1972
        # a different transport is in use for url generation.
 
1973
        self.transport_server = test_server.FakeVFATServer
 
1974
        self.assertFalse(self.get_url('t1').startswith('file://'))
1792
1975
        tree = self.make_branch_and_tree('t1')
1793
1976
        base = tree.bzrdir.root_transport.base
1794
 
        self.failIf(base.startswith('sftp'),
1795
 
                'base %r is on sftp but should be local' % base)
 
1977
        self.assertStartsWith(base, 'file://')
1796
1978
        self.assertEquals(tree.bzrdir.root_transport,
1797
1979
                tree.branch.bzrdir.root_transport)
1798
1980
        self.assertEquals(tree.bzrdir.root_transport,
1799
1981
                tree.branch.repository.bzrdir.root_transport)
1800
1982
 
1801
1983
 
1802
 
class TestSelftest(tests.TestCase):
 
1984
class SelfTestHelper(object):
 
1985
 
 
1986
    def run_selftest(self, **kwargs):
 
1987
        """Run selftest returning its output."""
 
1988
        output = StringIO()
 
1989
        old_transport = bzrlib.tests.default_transport
 
1990
        old_root = tests.TestCaseWithMemoryTransport.TEST_ROOT
 
1991
        tests.TestCaseWithMemoryTransport.TEST_ROOT = None
 
1992
        try:
 
1993
            self.assertEqual(True, tests.selftest(stream=output, **kwargs))
 
1994
        finally:
 
1995
            bzrlib.tests.default_transport = old_transport
 
1996
            tests.TestCaseWithMemoryTransport.TEST_ROOT = old_root
 
1997
        output.seek(0)
 
1998
        return output
 
1999
 
 
2000
 
 
2001
class TestSelftest(tests.TestCase, SelfTestHelper):
1803
2002
    """Tests of bzrlib.tests.selftest."""
1804
2003
 
1805
2004
    def test_selftest_benchmark_parameter_invokes_test_suite__benchmark__(self):
1813
2012
            test_suite_factory=factory)
1814
2013
        self.assertEqual([True], factory_called)
1815
2014
 
1816
 
 
1817
 
class TestKnownFailure(tests.TestCase):
1818
 
 
1819
 
    def test_known_failure(self):
1820
 
        """Check that KnownFailure is defined appropriately."""
1821
 
        # a KnownFailure is an assertion error for compatability with unaware
1822
 
        # runners.
1823
 
        self.assertIsInstance(tests.KnownFailure(""), AssertionError)
1824
 
 
1825
 
    def test_expect_failure(self):
1826
 
        try:
1827
 
            self.expectFailure("Doomed to failure", self.assertTrue, False)
1828
 
        except tests.KnownFailure, e:
1829
 
            self.assertEqual('Doomed to failure', e.args[0])
1830
 
        try:
1831
 
            self.expectFailure("Doomed to failure", self.assertTrue, True)
1832
 
        except AssertionError, e:
1833
 
            self.assertEqual('Unexpected success.  Should have failed:'
1834
 
                             ' Doomed to failure', e.args[0])
 
2015
    def factory(self):
 
2016
        """A test suite factory."""
 
2017
        class Test(tests.TestCase):
 
2018
            def a(self):
 
2019
                pass
 
2020
            def b(self):
 
2021
                pass
 
2022
            def c(self):
 
2023
                pass
 
2024
        return TestUtil.TestSuite([Test("a"), Test("b"), Test("c")])
 
2025
 
 
2026
    def test_list_only(self):
 
2027
        output = self.run_selftest(test_suite_factory=self.factory,
 
2028
            list_only=True)
 
2029
        self.assertEqual(3, len(output.readlines()))
 
2030
 
 
2031
    def test_list_only_filtered(self):
 
2032
        output = self.run_selftest(test_suite_factory=self.factory,
 
2033
            list_only=True, pattern="Test.b")
 
2034
        self.assertEndsWith(output.getvalue(), "Test.b\n")
 
2035
        self.assertLength(1, output.readlines())
 
2036
 
 
2037
    def test_list_only_excludes(self):
 
2038
        output = self.run_selftest(test_suite_factory=self.factory,
 
2039
            list_only=True, exclude_pattern="Test.b")
 
2040
        self.assertNotContainsRe("Test.b", output.getvalue())
 
2041
        self.assertLength(2, output.readlines())
 
2042
 
 
2043
    def test_lsprof_tests(self):
 
2044
        self.requireFeature(features.lsprof_feature)
 
2045
        results = []
 
2046
        class Test(object):
 
2047
            def __call__(test, result):
 
2048
                test.run(result)
 
2049
            def run(test, result):
 
2050
                results.append(result)
 
2051
            def countTestCases(self):
 
2052
                return 1
 
2053
        self.run_selftest(test_suite_factory=Test, lsprof_tests=True)
 
2054
        self.assertLength(1, results)
 
2055
        self.assertIsInstance(results.pop(), ExtendedToOriginalDecorator)
 
2056
 
 
2057
    def test_random(self):
 
2058
        # test randomising by listing a number of tests.
 
2059
        output_123 = self.run_selftest(test_suite_factory=self.factory,
 
2060
            list_only=True, random_seed="123")
 
2061
        output_234 = self.run_selftest(test_suite_factory=self.factory,
 
2062
            list_only=True, random_seed="234")
 
2063
        self.assertNotEqual(output_123, output_234)
 
2064
        # "Randominzing test order..\n\n
 
2065
        self.assertLength(5, output_123.readlines())
 
2066
        self.assertLength(5, output_234.readlines())
 
2067
 
 
2068
    def test_random_reuse_is_same_order(self):
 
2069
        # test randomising by listing a number of tests.
 
2070
        expected = self.run_selftest(test_suite_factory=self.factory,
 
2071
            list_only=True, random_seed="123")
 
2072
        repeated = self.run_selftest(test_suite_factory=self.factory,
 
2073
            list_only=True, random_seed="123")
 
2074
        self.assertEqual(expected.getvalue(), repeated.getvalue())
 
2075
 
 
2076
    def test_runner_class(self):
 
2077
        self.requireFeature(features.subunit)
 
2078
        from subunit import ProtocolTestCase
 
2079
        stream = self.run_selftest(runner_class=tests.SubUnitBzrRunner,
 
2080
            test_suite_factory=self.factory)
 
2081
        test = ProtocolTestCase(stream)
 
2082
        result = unittest.TestResult()
 
2083
        test.run(result)
 
2084
        self.assertEqual(3, result.testsRun)
 
2085
 
 
2086
    def test_starting_with_single_argument(self):
 
2087
        output = self.run_selftest(test_suite_factory=self.factory,
 
2088
            starting_with=['bzrlib.tests.test_selftest.Test.a'],
 
2089
            list_only=True)
 
2090
        self.assertEqual('bzrlib.tests.test_selftest.Test.a\n',
 
2091
            output.getvalue())
 
2092
 
 
2093
    def test_starting_with_multiple_argument(self):
 
2094
        output = self.run_selftest(test_suite_factory=self.factory,
 
2095
            starting_with=['bzrlib.tests.test_selftest.Test.a',
 
2096
                'bzrlib.tests.test_selftest.Test.b'],
 
2097
            list_only=True)
 
2098
        self.assertEqual('bzrlib.tests.test_selftest.Test.a\n'
 
2099
            'bzrlib.tests.test_selftest.Test.b\n',
 
2100
            output.getvalue())
 
2101
 
 
2102
    def check_transport_set(self, transport_server):
 
2103
        captured_transport = []
 
2104
        def seen_transport(a_transport):
 
2105
            captured_transport.append(a_transport)
 
2106
        class Capture(tests.TestCase):
 
2107
            def a(self):
 
2108
                seen_transport(bzrlib.tests.default_transport)
 
2109
        def factory():
 
2110
            return TestUtil.TestSuite([Capture("a")])
 
2111
        self.run_selftest(transport=transport_server, test_suite_factory=factory)
 
2112
        self.assertEqual(transport_server, captured_transport[0])
 
2113
 
 
2114
    def test_transport_sftp(self):
 
2115
        self.requireFeature(features.paramiko)
 
2116
        from bzrlib.tests import stub_sftp
 
2117
        self.check_transport_set(stub_sftp.SFTPAbsoluteServer)
 
2118
 
 
2119
    def test_transport_memory(self):
 
2120
        self.check_transport_set(memory.MemoryServer)
 
2121
 
 
2122
 
 
2123
class TestSelftestWithIdList(tests.TestCaseInTempDir, SelfTestHelper):
 
2124
    # Does IO: reads test.list
 
2125
 
 
2126
    def test_load_list(self):
 
2127
        # Provide a list with one test - this test.
 
2128
        test_id_line = '%s\n' % self.id()
 
2129
        self.build_tree_contents([('test.list', test_id_line)])
 
2130
        # And generate a list of the tests in  the suite.
 
2131
        stream = self.run_selftest(load_list='test.list', list_only=True)
 
2132
        self.assertEqual(test_id_line, stream.getvalue())
 
2133
 
 
2134
    def test_load_unknown(self):
 
2135
        # Provide a list with one test - this test.
 
2136
        # And generate a list of the tests in  the suite.
 
2137
        err = self.assertRaises(errors.NoSuchFile, self.run_selftest,
 
2138
            load_list='missing file name', list_only=True)
 
2139
 
 
2140
 
 
2141
class TestSubunitLogDetails(tests.TestCase, SelfTestHelper):
 
2142
 
 
2143
    _test_needs_features = [features.subunit]
 
2144
 
 
2145
    def run_subunit_stream(self, test_name):
 
2146
        from subunit import ProtocolTestCase
 
2147
        def factory():
 
2148
            return TestUtil.TestSuite([_get_test(test_name)])
 
2149
        stream = self.run_selftest(runner_class=tests.SubUnitBzrRunner,
 
2150
            test_suite_factory=factory)
 
2151
        test = ProtocolTestCase(stream)
 
2152
        result = testtools.TestResult()
 
2153
        test.run(result)
 
2154
        content = stream.getvalue()
 
2155
        return content, result
 
2156
 
 
2157
    def test_fail_has_log(self):
 
2158
        content, result = self.run_subunit_stream('test_fail')
 
2159
        self.assertEqual(1, len(result.failures))
 
2160
        self.assertContainsRe(content, '(?m)^log$')
 
2161
        self.assertContainsRe(content, 'this test will fail')
 
2162
 
 
2163
    def test_error_has_log(self):
 
2164
        content, result = self.run_subunit_stream('test_error')
 
2165
        self.assertContainsRe(content, '(?m)^log$')
 
2166
        self.assertContainsRe(content, 'this test errored')
 
2167
 
 
2168
    def test_skip_has_no_log(self):
 
2169
        content, result = self.run_subunit_stream('test_skip')
 
2170
        self.assertNotContainsRe(content, '(?m)^log$')
 
2171
        self.assertNotContainsRe(content, 'this test will be skipped')
 
2172
        self.assertEqual(['reason'], result.skip_reasons.keys())
 
2173
        skips = result.skip_reasons['reason']
 
2174
        self.assertEqual(1, len(skips))
 
2175
        test = skips[0]
 
2176
        # RemotedTestCase doesn't preserve the "details"
 
2177
        ## self.assertFalse('log' in test.getDetails())
 
2178
 
 
2179
    def test_missing_feature_has_no_log(self):
 
2180
        content, result = self.run_subunit_stream('test_missing_feature')
 
2181
        self.assertNotContainsRe(content, '(?m)^log$')
 
2182
        self.assertNotContainsRe(content, 'missing the feature')
 
2183
        self.assertEqual(['_MissingFeature\n'], result.skip_reasons.keys())
 
2184
        skips = result.skip_reasons['_MissingFeature\n']
 
2185
        self.assertEqual(1, len(skips))
 
2186
        test = skips[0]
 
2187
        # RemotedTestCase doesn't preserve the "details"
 
2188
        ## self.assertFalse('log' in test.getDetails())
 
2189
 
 
2190
    def test_xfail_has_no_log(self):
 
2191
        content, result = self.run_subunit_stream('test_xfail')
 
2192
        self.assertNotContainsRe(content, '(?m)^log$')
 
2193
        self.assertNotContainsRe(content, 'test with expected failure')
 
2194
        self.assertEqual(1, len(result.expectedFailures))
 
2195
        result_content = result.expectedFailures[0][1]
 
2196
        self.assertNotContainsRe(result_content, 'Text attachment: log')
 
2197
        self.assertNotContainsRe(result_content, 'test with expected failure')
 
2198
 
 
2199
    def test_unexpected_success_has_log(self):
 
2200
        content, result = self.run_subunit_stream('test_unexpected_success')
 
2201
        self.assertContainsRe(content, '(?m)^log$')
 
2202
        self.assertContainsRe(content, 'test with unexpected success')
 
2203
        # GZ 2011-05-18: Old versions of subunit treat unexpected success as a
 
2204
        #                success, if a min version check is added remove this
 
2205
        from subunit import TestProtocolClient as _Client
 
2206
        if _Client.addUnexpectedSuccess.im_func is _Client.addSuccess.im_func:
 
2207
            self.expectFailure('subunit treats "unexpectedSuccess"'
 
2208
                               ' as a plain success',
 
2209
                self.assertEqual, 1, len(result.unexpectedSuccesses))
 
2210
        self.assertEqual(1, len(result.unexpectedSuccesses))
 
2211
        test = result.unexpectedSuccesses[0]
 
2212
        # RemotedTestCase doesn't preserve the "details"
 
2213
        ## self.assertTrue('log' in test.getDetails())
 
2214
 
 
2215
    def test_success_has_no_log(self):
 
2216
        content, result = self.run_subunit_stream('test_success')
 
2217
        self.assertEqual(1, result.testsRun)
 
2218
        self.assertNotContainsRe(content, '(?m)^log$')
 
2219
        self.assertNotContainsRe(content, 'this test succeeds')
 
2220
 
 
2221
 
 
2222
class TestRunBzr(tests.TestCase):
 
2223
 
 
2224
    out = ''
 
2225
    err = ''
 
2226
 
 
2227
    def _run_bzr_core(self, argv, retcode=0, encoding=None, stdin=None,
 
2228
                         working_dir=None):
 
2229
        """Override _run_bzr_core to test how it is invoked by run_bzr.
 
2230
 
 
2231
        Attempts to run bzr from inside this class don't actually run it.
 
2232
 
 
2233
        We test how run_bzr actually invokes bzr in another location.  Here we
 
2234
        only need to test that it passes the right parameters to run_bzr.
 
2235
        """
 
2236
        self.argv = list(argv)
 
2237
        self.retcode = retcode
 
2238
        self.encoding = encoding
 
2239
        self.stdin = stdin
 
2240
        self.working_dir = working_dir
 
2241
        return self.retcode, self.out, self.err
 
2242
 
 
2243
    def test_run_bzr_error(self):
 
2244
        self.out = "It sure does!\n"
 
2245
        out, err = self.run_bzr_error(['^$'], ['rocks'], retcode=34)
 
2246
        self.assertEqual(['rocks'], self.argv)
 
2247
        self.assertEqual(34, self.retcode)
 
2248
        self.assertEqual('It sure does!\n', out)
 
2249
        self.assertEquals(out, self.out)
 
2250
        self.assertEqual('', err)
 
2251
        self.assertEquals(err, self.err)
 
2252
 
 
2253
    def test_run_bzr_error_regexes(self):
 
2254
        self.out = ''
 
2255
        self.err = "bzr: ERROR: foobarbaz is not versioned"
 
2256
        out, err = self.run_bzr_error(
 
2257
            ["bzr: ERROR: foobarbaz is not versioned"],
 
2258
            ['file-id', 'foobarbaz'])
 
2259
 
 
2260
    def test_encoding(self):
 
2261
        """Test that run_bzr passes encoding to _run_bzr_core"""
 
2262
        self.run_bzr('foo bar')
 
2263
        self.assertEqual(None, self.encoding)
 
2264
        self.assertEqual(['foo', 'bar'], self.argv)
 
2265
 
 
2266
        self.run_bzr('foo bar', encoding='baz')
 
2267
        self.assertEqual('baz', self.encoding)
 
2268
        self.assertEqual(['foo', 'bar'], self.argv)
 
2269
 
 
2270
    def test_retcode(self):
 
2271
        """Test that run_bzr passes retcode to _run_bzr_core"""
 
2272
        # Default is retcode == 0
 
2273
        self.run_bzr('foo bar')
 
2274
        self.assertEqual(0, self.retcode)
 
2275
        self.assertEqual(['foo', 'bar'], self.argv)
 
2276
 
 
2277
        self.run_bzr('foo bar', retcode=1)
 
2278
        self.assertEqual(1, self.retcode)
 
2279
        self.assertEqual(['foo', 'bar'], self.argv)
 
2280
 
 
2281
        self.run_bzr('foo bar', retcode=None)
 
2282
        self.assertEqual(None, self.retcode)
 
2283
        self.assertEqual(['foo', 'bar'], self.argv)
 
2284
 
 
2285
        self.run_bzr(['foo', 'bar'], retcode=3)
 
2286
        self.assertEqual(3, self.retcode)
 
2287
        self.assertEqual(['foo', 'bar'], self.argv)
 
2288
 
 
2289
    def test_stdin(self):
 
2290
        # test that the stdin keyword to run_bzr is passed through to
 
2291
        # _run_bzr_core as-is. We do this by overriding
 
2292
        # _run_bzr_core in this class, and then calling run_bzr,
 
2293
        # which is a convenience function for _run_bzr_core, so
 
2294
        # should invoke it.
 
2295
        self.run_bzr('foo bar', stdin='gam')
 
2296
        self.assertEqual('gam', self.stdin)
 
2297
        self.assertEqual(['foo', 'bar'], self.argv)
 
2298
 
 
2299
        self.run_bzr('foo bar', stdin='zippy')
 
2300
        self.assertEqual('zippy', self.stdin)
 
2301
        self.assertEqual(['foo', 'bar'], self.argv)
 
2302
 
 
2303
    def test_working_dir(self):
 
2304
        """Test that run_bzr passes working_dir to _run_bzr_core"""
 
2305
        self.run_bzr('foo bar')
 
2306
        self.assertEqual(None, self.working_dir)
 
2307
        self.assertEqual(['foo', 'bar'], self.argv)
 
2308
 
 
2309
        self.run_bzr('foo bar', working_dir='baz')
 
2310
        self.assertEqual('baz', self.working_dir)
 
2311
        self.assertEqual(['foo', 'bar'], self.argv)
 
2312
 
 
2313
    def test_reject_extra_keyword_arguments(self):
 
2314
        self.assertRaises(TypeError, self.run_bzr, "foo bar",
 
2315
                          error_regex=['error message'])
 
2316
 
 
2317
 
 
2318
class TestRunBzrCaptured(tests.TestCaseWithTransport):
 
2319
    # Does IO when testing the working_dir parameter.
 
2320
 
 
2321
    def apply_redirected(self, stdin=None, stdout=None, stderr=None,
 
2322
                         a_callable=None, *args, **kwargs):
 
2323
        self.stdin = stdin
 
2324
        self.factory_stdin = getattr(bzrlib.ui.ui_factory, "stdin", None)
 
2325
        self.factory = bzrlib.ui.ui_factory
 
2326
        self.working_dir = osutils.getcwd()
 
2327
        stdout.write('foo\n')
 
2328
        stderr.write('bar\n')
 
2329
        return 0
 
2330
 
 
2331
    def test_stdin(self):
 
2332
        # test that the stdin keyword to _run_bzr_core is passed through to
 
2333
        # apply_redirected as a StringIO. We do this by overriding
 
2334
        # apply_redirected in this class, and then calling _run_bzr_core,
 
2335
        # which calls apply_redirected.
 
2336
        self.run_bzr(['foo', 'bar'], stdin='gam')
 
2337
        self.assertEqual('gam', self.stdin.read())
 
2338
        self.assertTrue(self.stdin is self.factory_stdin)
 
2339
        self.run_bzr(['foo', 'bar'], stdin='zippy')
 
2340
        self.assertEqual('zippy', self.stdin.read())
 
2341
        self.assertTrue(self.stdin is self.factory_stdin)
 
2342
 
 
2343
    def test_ui_factory(self):
 
2344
        # each invocation of self.run_bzr should get its
 
2345
        # own UI factory, which is an instance of TestUIFactory,
 
2346
        # with stdin, stdout and stderr attached to the stdin,
 
2347
        # stdout and stderr of the invoked run_bzr
 
2348
        current_factory = bzrlib.ui.ui_factory
 
2349
        self.run_bzr(['foo'])
 
2350
        self.assertFalse(current_factory is self.factory)
 
2351
        self.assertNotEqual(sys.stdout, self.factory.stdout)
 
2352
        self.assertNotEqual(sys.stderr, self.factory.stderr)
 
2353
        self.assertEqual('foo\n', self.factory.stdout.getvalue())
 
2354
        self.assertEqual('bar\n', self.factory.stderr.getvalue())
 
2355
        self.assertIsInstance(self.factory, tests.TestUIFactory)
 
2356
 
 
2357
    def test_working_dir(self):
 
2358
        self.build_tree(['one/', 'two/'])
 
2359
        cwd = osutils.getcwd()
 
2360
 
 
2361
        # Default is to work in the current directory
 
2362
        self.run_bzr(['foo', 'bar'])
 
2363
        self.assertEqual(cwd, self.working_dir)
 
2364
 
 
2365
        self.run_bzr(['foo', 'bar'], working_dir=None)
 
2366
        self.assertEqual(cwd, self.working_dir)
 
2367
 
 
2368
        # The function should be run in the alternative directory
 
2369
        # but afterwards the current working dir shouldn't be changed
 
2370
        self.run_bzr(['foo', 'bar'], working_dir='one')
 
2371
        self.assertNotEqual(cwd, self.working_dir)
 
2372
        self.assertEndsWith(self.working_dir, 'one')
 
2373
        self.assertEqual(cwd, osutils.getcwd())
 
2374
 
 
2375
        self.run_bzr(['foo', 'bar'], working_dir='two')
 
2376
        self.assertNotEqual(cwd, self.working_dir)
 
2377
        self.assertEndsWith(self.working_dir, 'two')
 
2378
        self.assertEqual(cwd, osutils.getcwd())
 
2379
 
 
2380
 
 
2381
class StubProcess(object):
 
2382
    """A stub process for testing run_bzr_subprocess."""
 
2383
    
 
2384
    def __init__(self, out="", err="", retcode=0):
 
2385
        self.out = out
 
2386
        self.err = err
 
2387
        self.returncode = retcode
 
2388
 
 
2389
    def communicate(self):
 
2390
        return self.out, self.err
 
2391
 
 
2392
 
 
2393
class TestWithFakedStartBzrSubprocess(tests.TestCaseWithTransport):
 
2394
    """Base class for tests testing how we might run bzr."""
 
2395
 
 
2396
    def setUp(self):
 
2397
        tests.TestCaseWithTransport.setUp(self)
 
2398
        self.subprocess_calls = []
 
2399
 
 
2400
    def start_bzr_subprocess(self, process_args, env_changes=None,
 
2401
                             skip_if_plan_to_signal=False,
 
2402
                             working_dir=None,
 
2403
                             allow_plugins=False):
 
2404
        """capture what run_bzr_subprocess tries to do."""
 
2405
        self.subprocess_calls.append({'process_args':process_args,
 
2406
            'env_changes':env_changes,
 
2407
            'skip_if_plan_to_signal':skip_if_plan_to_signal,
 
2408
            'working_dir':working_dir, 'allow_plugins':allow_plugins})
 
2409
        return self.next_subprocess
 
2410
 
 
2411
 
 
2412
class TestRunBzrSubprocess(TestWithFakedStartBzrSubprocess):
 
2413
 
 
2414
    def assertRunBzrSubprocess(self, expected_args, process, *args, **kwargs):
 
2415
        """Run run_bzr_subprocess with args and kwargs using a stubbed process.
 
2416
 
 
2417
        Inside TestRunBzrSubprocessCommands we use a stub start_bzr_subprocess
 
2418
        that will return static results. This assertion method populates those
 
2419
        results and also checks the arguments run_bzr_subprocess generates.
 
2420
        """
 
2421
        self.next_subprocess = process
 
2422
        try:
 
2423
            result = self.run_bzr_subprocess(*args, **kwargs)
 
2424
        except:
 
2425
            self.next_subprocess = None
 
2426
            for key, expected in expected_args.iteritems():
 
2427
                self.assertEqual(expected, self.subprocess_calls[-1][key])
 
2428
            raise
1835
2429
        else:
1836
 
            self.fail('Assertion not raised')
1837
 
 
1838
 
 
1839
 
class TestFeature(tests.TestCase):
1840
 
 
1841
 
    def test_caching(self):
1842
 
        """Feature._probe is called by the feature at most once."""
1843
 
        class InstrumentedFeature(tests.Feature):
1844
 
            def __init__(self):
1845
 
                super(InstrumentedFeature, self).__init__()
1846
 
                self.calls = []
1847
 
            def _probe(self):
1848
 
                self.calls.append('_probe')
1849
 
                return False
1850
 
        feature = InstrumentedFeature()
1851
 
        feature.available()
1852
 
        self.assertEqual(['_probe'], feature.calls)
1853
 
        feature.available()
1854
 
        self.assertEqual(['_probe'], feature.calls)
1855
 
 
1856
 
    def test_named_str(self):
1857
 
        """Feature.__str__ should thunk to feature_name()."""
1858
 
        class NamedFeature(tests.Feature):
1859
 
            def feature_name(self):
1860
 
                return 'symlinks'
1861
 
        feature = NamedFeature()
1862
 
        self.assertEqual('symlinks', str(feature))
1863
 
 
1864
 
    def test_default_str(self):
1865
 
        """Feature.__str__ should default to __class__.__name__."""
1866
 
        class NamedFeature(tests.Feature):
1867
 
            pass
1868
 
        feature = NamedFeature()
1869
 
        self.assertEqual('NamedFeature', str(feature))
1870
 
 
1871
 
 
1872
 
class TestUnavailableFeature(tests.TestCase):
1873
 
 
1874
 
    def test_access_feature(self):
1875
 
        feature = tests.Feature()
1876
 
        exception = tests.UnavailableFeature(feature)
1877
 
        self.assertIs(feature, exception.args[0])
 
2430
            self.next_subprocess = None
 
2431
            for key, expected in expected_args.iteritems():
 
2432
                self.assertEqual(expected, self.subprocess_calls[-1][key])
 
2433
            return result
 
2434
 
 
2435
    def test_run_bzr_subprocess(self):
 
2436
        """The run_bzr_helper_external command behaves nicely."""
 
2437
        self.assertRunBzrSubprocess({'process_args':['--version']},
 
2438
            StubProcess(), '--version')
 
2439
        self.assertRunBzrSubprocess({'process_args':['--version']},
 
2440
            StubProcess(), ['--version'])
 
2441
        # retcode=None disables retcode checking
 
2442
        result = self.assertRunBzrSubprocess({},
 
2443
            StubProcess(retcode=3), '--version', retcode=None)
 
2444
        result = self.assertRunBzrSubprocess({},
 
2445
            StubProcess(out="is free software"), '--version')
 
2446
        self.assertContainsRe(result[0], 'is free software')
 
2447
        # Running a subcommand that is missing errors
 
2448
        self.assertRaises(AssertionError, self.assertRunBzrSubprocess,
 
2449
            {'process_args':['--versionn']}, StubProcess(retcode=3),
 
2450
            '--versionn')
 
2451
        # Unless it is told to expect the error from the subprocess
 
2452
        result = self.assertRunBzrSubprocess({},
 
2453
            StubProcess(retcode=3), '--versionn', retcode=3)
 
2454
        # Or to ignore retcode checking
 
2455
        result = self.assertRunBzrSubprocess({},
 
2456
            StubProcess(err="unknown command", retcode=3), '--versionn',
 
2457
            retcode=None)
 
2458
        self.assertContainsRe(result[1], 'unknown command')
 
2459
 
 
2460
    def test_env_change_passes_through(self):
 
2461
        self.assertRunBzrSubprocess(
 
2462
            {'env_changes':{'new':'value', 'changed':'newvalue', 'deleted':None}},
 
2463
            StubProcess(), '',
 
2464
            env_changes={'new':'value', 'changed':'newvalue', 'deleted':None})
 
2465
 
 
2466
    def test_no_working_dir_passed_as_None(self):
 
2467
        self.assertRunBzrSubprocess({'working_dir': None}, StubProcess(), '')
 
2468
 
 
2469
    def test_no_working_dir_passed_through(self):
 
2470
        self.assertRunBzrSubprocess({'working_dir': 'dir'}, StubProcess(), '',
 
2471
            working_dir='dir')
 
2472
 
 
2473
    def test_run_bzr_subprocess_no_plugins(self):
 
2474
        self.assertRunBzrSubprocess({'allow_plugins': False},
 
2475
            StubProcess(), '')
 
2476
 
 
2477
    def test_allow_plugins(self):
 
2478
        self.assertRunBzrSubprocess({'allow_plugins': True},
 
2479
            StubProcess(), '', allow_plugins=True)
 
2480
 
 
2481
 
 
2482
class TestFinishBzrSubprocess(TestWithFakedStartBzrSubprocess):
 
2483
 
 
2484
    def test_finish_bzr_subprocess_with_error(self):
 
2485
        """finish_bzr_subprocess allows specification of the desired exit code.
 
2486
        """
 
2487
        process = StubProcess(err="unknown command", retcode=3)
 
2488
        result = self.finish_bzr_subprocess(process, retcode=3)
 
2489
        self.assertEqual('', result[0])
 
2490
        self.assertContainsRe(result[1], 'unknown command')
 
2491
 
 
2492
    def test_finish_bzr_subprocess_ignoring_retcode(self):
 
2493
        """finish_bzr_subprocess allows the exit code to be ignored."""
 
2494
        process = StubProcess(err="unknown command", retcode=3)
 
2495
        result = self.finish_bzr_subprocess(process, retcode=None)
 
2496
        self.assertEqual('', result[0])
 
2497
        self.assertContainsRe(result[1], 'unknown command')
 
2498
 
 
2499
    def test_finish_subprocess_with_unexpected_retcode(self):
 
2500
        """finish_bzr_subprocess raises self.failureException if the retcode is
 
2501
        not the expected one.
 
2502
        """
 
2503
        process = StubProcess(err="unknown command", retcode=3)
 
2504
        self.assertRaises(self.failureException, self.finish_bzr_subprocess,
 
2505
                          process)
 
2506
 
 
2507
 
 
2508
class _DontSpawnProcess(Exception):
 
2509
    """A simple exception which just allows us to skip unnecessary steps"""
 
2510
 
 
2511
 
 
2512
class TestStartBzrSubProcess(tests.TestCase):
 
2513
    """Stub test start_bzr_subprocess."""
 
2514
 
 
2515
    def _subprocess_log_cleanup(self):
 
2516
        """Inhibits the base version as we don't produce a log file."""
 
2517
 
 
2518
    def _popen(self, *args, **kwargs):
 
2519
        """Override the base version to record the command that is run.
 
2520
 
 
2521
        From there we can ensure it is correct without spawning a real process.
 
2522
        """
 
2523
        self.check_popen_state()
 
2524
        self._popen_args = args
 
2525
        self._popen_kwargs = kwargs
 
2526
        raise _DontSpawnProcess()
 
2527
 
 
2528
    def check_popen_state(self):
 
2529
        """Replace to make assertions when popen is called."""
 
2530
 
 
2531
    def test_run_bzr_subprocess_no_plugins(self):
 
2532
        self.assertRaises(_DontSpawnProcess, self.start_bzr_subprocess, [])
 
2533
        command = self._popen_args[0]
 
2534
        self.assertEqual(sys.executable, command[0])
 
2535
        self.assertEqual(self.get_bzr_path(), command[1])
 
2536
        self.assertEqual(['--no-plugins'], command[2:])
 
2537
 
 
2538
    def test_allow_plugins(self):
 
2539
        self.assertRaises(_DontSpawnProcess, self.start_bzr_subprocess, [],
 
2540
                          allow_plugins=True)
 
2541
        command = self._popen_args[0]
 
2542
        self.assertEqual([], command[2:])
 
2543
 
 
2544
    def test_set_env(self):
 
2545
        self.assertFalse('EXISTANT_ENV_VAR' in os.environ)
 
2546
        # set in the child
 
2547
        def check_environment():
 
2548
            self.assertEqual('set variable', os.environ['EXISTANT_ENV_VAR'])
 
2549
        self.check_popen_state = check_environment
 
2550
        self.assertRaises(_DontSpawnProcess, self.start_bzr_subprocess, [],
 
2551
                          env_changes={'EXISTANT_ENV_VAR':'set variable'})
 
2552
        # not set in theparent
 
2553
        self.assertFalse('EXISTANT_ENV_VAR' in os.environ)
 
2554
 
 
2555
    def test_run_bzr_subprocess_env_del(self):
 
2556
        """run_bzr_subprocess can remove environment variables too."""
 
2557
        self.assertFalse('EXISTANT_ENV_VAR' in os.environ)
 
2558
        def check_environment():
 
2559
            self.assertFalse('EXISTANT_ENV_VAR' in os.environ)
 
2560
        os.environ['EXISTANT_ENV_VAR'] = 'set variable'
 
2561
        self.check_popen_state = check_environment
 
2562
        self.assertRaises(_DontSpawnProcess, self.start_bzr_subprocess, [],
 
2563
                          env_changes={'EXISTANT_ENV_VAR':None})
 
2564
        # Still set in parent
 
2565
        self.assertEqual('set variable', os.environ['EXISTANT_ENV_VAR'])
 
2566
        del os.environ['EXISTANT_ENV_VAR']
 
2567
 
 
2568
    def test_env_del_missing(self):
 
2569
        self.assertFalse('NON_EXISTANT_ENV_VAR' in os.environ)
 
2570
        def check_environment():
 
2571
            self.assertFalse('NON_EXISTANT_ENV_VAR' in os.environ)
 
2572
        self.check_popen_state = check_environment
 
2573
        self.assertRaises(_DontSpawnProcess, self.start_bzr_subprocess, [],
 
2574
                          env_changes={'NON_EXISTANT_ENV_VAR':None})
 
2575
 
 
2576
    def test_working_dir(self):
 
2577
        """Test that we can specify the working dir for the child"""
 
2578
        orig_getcwd = osutils.getcwd
 
2579
        orig_chdir = os.chdir
 
2580
        chdirs = []
 
2581
        def chdir(path):
 
2582
            chdirs.append(path)
 
2583
        self.overrideAttr(os, 'chdir', chdir)
 
2584
        def getcwd():
 
2585
            return 'current'
 
2586
        self.overrideAttr(osutils, 'getcwd', getcwd)
 
2587
        self.assertRaises(_DontSpawnProcess, self.start_bzr_subprocess, [],
 
2588
                          working_dir='foo')
 
2589
        self.assertEqual(['foo', 'current'], chdirs)
 
2590
 
 
2591
    def test_get_bzr_path_with_cwd_bzrlib(self):
 
2592
        self.get_source_path = lambda: ""
 
2593
        self.overrideAttr(os.path, "isfile", lambda path: True)
 
2594
        self.assertEqual(self.get_bzr_path(), "bzr")
 
2595
 
 
2596
 
 
2597
class TestActuallyStartBzrSubprocess(tests.TestCaseWithTransport):
 
2598
    """Tests that really need to do things with an external bzr."""
 
2599
 
 
2600
    def test_start_and_stop_bzr_subprocess_send_signal(self):
 
2601
        """finish_bzr_subprocess raises self.failureException if the retcode is
 
2602
        not the expected one.
 
2603
        """
 
2604
        self.disable_missing_extensions_warning()
 
2605
        process = self.start_bzr_subprocess(['wait-until-signalled'],
 
2606
                                            skip_if_plan_to_signal=True)
 
2607
        self.assertEqual('running\n', process.stdout.readline())
 
2608
        result = self.finish_bzr_subprocess(process, send_signal=signal.SIGINT,
 
2609
                                            retcode=3)
 
2610
        self.assertEqual('', result[0])
 
2611
        self.assertEqual('bzr: interrupted\n', result[1])
1878
2612
 
1879
2613
 
1880
2614
class TestSelftestFiltering(tests.TestCase):
1883
2617
        tests.TestCase.setUp(self)
1884
2618
        self.suite = TestUtil.TestSuite()
1885
2619
        self.loader = TestUtil.TestLoader()
1886
 
        self.suite.addTest(self.loader.loadTestsFromModuleNames([
1887
 
            'bzrlib.tests.test_selftest']))
 
2620
        self.suite.addTest(self.loader.loadTestsFromModule(
 
2621
            sys.modules['bzrlib.tests.test_selftest']))
1888
2622
        self.all_names = _test_ids(self.suite)
1889
2623
 
1890
2624
    def test_condition_id_re(self):
2033
2767
        self.assertEqual(remaining_names, _test_ids(split_suite[1]))
2034
2768
 
2035
2769
 
2036
 
class TestCheckInventoryShape(tests.TestCaseWithTransport):
 
2770
class TestCheckTreeShape(tests.TestCaseWithTransport):
2037
2771
 
2038
 
    def test_check_inventory_shape(self):
 
2772
    def test_check_tree_shape(self):
2039
2773
        files = ['a', 'b/', 'b/c']
2040
2774
        tree = self.make_branch_and_tree('.')
2041
2775
        self.build_tree(files)
2042
2776
        tree.add(files)
2043
2777
        tree.lock_read()
2044
2778
        try:
2045
 
            self.check_inventory_shape(tree.inventory, files)
 
2779
            self.check_tree_shape(tree, files)
2046
2780
        finally:
2047
2781
            tree.unlock()
2048
2782
 
2061
2795
        # the test framework
2062
2796
        self.assertEquals('always fails', str(e))
2063
2797
        # check that there's no traceback in the test log
2064
 
        self.assertNotContainsRe(self._get_log(keep_log_file=True),
2065
 
            r'Traceback')
 
2798
        self.assertNotContainsRe(self.get_log(), r'Traceback')
2066
2799
 
2067
2800
    def test_run_bzr_user_error_caught(self):
2068
2801
        # Running bzr in blackbox mode, normal/expected/user errors should be
2069
2802
        # caught in the regular way and turned into an error message plus exit
2070
2803
        # code.
2071
 
        out, err = self.run_bzr(["log", "/nonexistantpath"], retcode=3)
 
2804
        transport_server = memory.MemoryServer()
 
2805
        transport_server.start_server()
 
2806
        self.addCleanup(transport_server.stop_server)
 
2807
        url = transport_server.get_url()
 
2808
        self.permit_url(url)
 
2809
        out, err = self.run_bzr(["log", "%s/nonexistantpath" % url], retcode=3)
2072
2810
        self.assertEqual(out, '')
2073
2811
        self.assertContainsRe(err,
2074
2812
            'bzr: ERROR: Not a branch: ".*nonexistantpath/".\n')
2200
2938
 
2201
2939
class TestTestSuite(tests.TestCase):
2202
2940
 
 
2941
    def test__test_suite_testmod_names(self):
 
2942
        # Test that a plausible list of test module names are returned
 
2943
        # by _test_suite_testmod_names.
 
2944
        test_list = tests._test_suite_testmod_names()
 
2945
        self.assertSubset([
 
2946
            'bzrlib.tests.blackbox',
 
2947
            'bzrlib.tests.per_transport',
 
2948
            'bzrlib.tests.test_selftest',
 
2949
            ],
 
2950
            test_list)
 
2951
 
 
2952
    def test__test_suite_modules_to_doctest(self):
 
2953
        # Test that a plausible list of modules to doctest is returned
 
2954
        # by _test_suite_modules_to_doctest.
 
2955
        test_list = tests._test_suite_modules_to_doctest()
 
2956
        if __doc__ is None:
 
2957
            # When docstrings are stripped, there are no modules to doctest
 
2958
            self.assertEqual([], test_list)
 
2959
            return
 
2960
        self.assertSubset([
 
2961
            'bzrlib.timestamp',
 
2962
            ],
 
2963
            test_list)
 
2964
 
2203
2965
    def test_test_suite(self):
2204
 
        # This test is slow, so we do a single test with one test in each
2205
 
        # category
2206
 
        test_list = [
 
2966
        # test_suite() loads the entire test suite to operate. To avoid this
 
2967
        # overhead, and yet still be confident that things are happening,
 
2968
        # we temporarily replace two functions used by test_suite with 
 
2969
        # test doubles that supply a few sample tests to load, and check they
 
2970
        # are loaded.
 
2971
        calls = []
 
2972
        def testmod_names():
 
2973
            calls.append("testmod_names")
 
2974
            return [
 
2975
                'bzrlib.tests.blackbox.test_branch',
 
2976
                'bzrlib.tests.per_transport',
 
2977
                'bzrlib.tests.test_selftest',
 
2978
                ]
 
2979
        self.overrideAttr(tests, '_test_suite_testmod_names', testmod_names)
 
2980
        def doctests():
 
2981
            calls.append("modules_to_doctest")
 
2982
            if __doc__ is None:
 
2983
                return []
 
2984
            return ['bzrlib.timestamp']
 
2985
        self.overrideAttr(tests, '_test_suite_modules_to_doctest', doctests)
 
2986
        expected_test_list = [
2207
2987
            # testmod_names
2208
2988
            'bzrlib.tests.blackbox.test_branch.TestBranch.test_branch',
2209
2989
            ('bzrlib.tests.per_transport.TransportTests'
2210
 
             '.test_abspath(LocalURLServer)'),
 
2990
             '.test_abspath(LocalTransport,LocalURLServer)'),
2211
2991
            'bzrlib.tests.test_selftest.TestTestSuite.test_test_suite',
2212
 
            # modules_to_doctest
2213
 
            'bzrlib.timestamp.format_highres_date',
2214
2992
            # plugins can't be tested that way since selftest may be run with
2215
2993
            # --no-plugins
2216
2994
            ]
2217
 
        suite = tests.test_suite(test_list)
2218
 
        self.assertEquals(test_list, _test_ids(suite))
 
2995
        if __doc__ is not None:
 
2996
            expected_test_list.extend([
 
2997
                # modules_to_doctest
 
2998
                'bzrlib.timestamp.format_highres_date',
 
2999
                ])
 
3000
        suite = tests.test_suite()
 
3001
        self.assertEqual(set(["testmod_names", "modules_to_doctest"]),
 
3002
            set(calls))
 
3003
        self.assertSubset(expected_test_list, _test_ids(suite))
2219
3004
 
2220
3005
    def test_test_suite_list_and_start(self):
 
3006
        # We cannot test this at the same time as the main load, because we want
 
3007
        # to know that starting_with == None works. So a second load is
 
3008
        # incurred - note that the starting_with parameter causes a partial load
 
3009
        # rather than a full load so this test should be pretty quick.
2221
3010
        test_list = ['bzrlib.tests.test_selftest.TestTestSuite.test_test_suite']
2222
3011
        suite = tests.test_suite(test_list,
2223
3012
                                 ['bzrlib.tests.test_selftest.TestTestSuite'])
2268
3057
    def test_load_tests(self):
2269
3058
        test_list = ['bzrlib.tests.test_sampler.DemoTest.test_nothing']
2270
3059
        loader = self._create_loader(test_list)
2271
 
 
2272
3060
        suite = loader.loadTestsFromModuleName('bzrlib.tests.test_sampler')
2273
3061
        self.assertEquals(test_list, _test_ids(suite))
2274
3062
 
2275
3063
    def test_exclude_tests(self):
2276
3064
        test_list = ['bogus']
2277
3065
        loader = self._create_loader(test_list)
2278
 
 
2279
3066
        suite = loader.loadTestsFromModuleName('bzrlib.tests.test_sampler')
2280
3067
        self.assertEquals([], _test_ids(suite))
2281
3068
 
2326
3113
        tpr.register('bar', 'bbb.aaa.rrr')
2327
3114
        tpr.register('bar', 'bBB.aAA.rRR')
2328
3115
        self.assertEquals('bbb.aaa.rrr', tpr.get('bar'))
2329
 
        self.assertContainsRe(self._get_log(keep_log_file=True),
2330
 
                              r'.*bar.*bbb.aaa.rrr.*bBB.aAA.rRR')
 
3116
        self.assertThat(self.get_log(),
 
3117
            DocTestMatches("...bar...bbb.aaa.rrr...BB.aAA.rRR",
 
3118
                           doctest.ELLIPSIS))
2331
3119
 
2332
3120
    def test_get_unknown_prefix(self):
2333
3121
        tpr = self._get_registry()
2353
3141
        self.assertEquals('bzrlib.plugins', tpr.resolve_alias('bp'))
2354
3142
 
2355
3143
 
 
3144
class TestThreadLeakDetection(tests.TestCase):
 
3145
    """Ensure when tests leak threads we detect and report it"""
 
3146
 
 
3147
    class LeakRecordingResult(tests.ExtendedTestResult):
 
3148
        def __init__(self):
 
3149
            tests.ExtendedTestResult.__init__(self, StringIO(), 0, 1)
 
3150
            self.leaks = []
 
3151
        def _report_thread_leak(self, test, leaks, alive):
 
3152
            self.leaks.append((test, leaks))
 
3153
 
 
3154
    def test_testcase_without_addCleanups(self):
 
3155
        """Check old TestCase instances don't break with leak detection"""
 
3156
        class Test(unittest.TestCase):
 
3157
            def runTest(self):
 
3158
                pass
 
3159
        result = self.LeakRecordingResult()
 
3160
        test = Test()
 
3161
        result.startTestRun()
 
3162
        test.run(result)
 
3163
        result.stopTestRun()
 
3164
        self.assertEqual(result._tests_leaking_threads_count, 0)
 
3165
        self.assertEqual(result.leaks, [])
 
3166
        
 
3167
    def test_thread_leak(self):
 
3168
        """Ensure a thread that outlives the running of a test is reported
 
3169
 
 
3170
        Uses a thread that blocks on an event, and is started by the inner
 
3171
        test case. As the thread outlives the inner case's run, it should be
 
3172
        detected as a leak, but the event is then set so that the thread can
 
3173
        be safely joined in cleanup so it's not leaked for real.
 
3174
        """
 
3175
        event = threading.Event()
 
3176
        thread = threading.Thread(name="Leaker", target=event.wait)
 
3177
        class Test(tests.TestCase):
 
3178
            def test_leak(self):
 
3179
                thread.start()
 
3180
        result = self.LeakRecordingResult()
 
3181
        test = Test("test_leak")
 
3182
        self.addCleanup(thread.join)
 
3183
        self.addCleanup(event.set)
 
3184
        result.startTestRun()
 
3185
        test.run(result)
 
3186
        result.stopTestRun()
 
3187
        self.assertEqual(result._tests_leaking_threads_count, 1)
 
3188
        self.assertEqual(result._first_thread_leaker_id, test.id())
 
3189
        self.assertEqual(result.leaks, [(test, set([thread]))])
 
3190
        self.assertContainsString(result.stream.getvalue(), "leaking threads")
 
3191
 
 
3192
    def test_multiple_leaks(self):
 
3193
        """Check multiple leaks are blamed on the test cases at fault
 
3194
 
 
3195
        Same concept as the previous test, but has one inner test method that
 
3196
        leaks two threads, and one that doesn't leak at all.
 
3197
        """
 
3198
        event = threading.Event()
 
3199
        thread_a = threading.Thread(name="LeakerA", target=event.wait)
 
3200
        thread_b = threading.Thread(name="LeakerB", target=event.wait)
 
3201
        thread_c = threading.Thread(name="LeakerC", target=event.wait)
 
3202
        class Test(tests.TestCase):
 
3203
            def test_first_leak(self):
 
3204
                thread_b.start()
 
3205
            def test_second_no_leak(self):
 
3206
                pass
 
3207
            def test_third_leak(self):
 
3208
                thread_c.start()
 
3209
                thread_a.start()
 
3210
        result = self.LeakRecordingResult()
 
3211
        first_test = Test("test_first_leak")
 
3212
        third_test = Test("test_third_leak")
 
3213
        self.addCleanup(thread_a.join)
 
3214
        self.addCleanup(thread_b.join)
 
3215
        self.addCleanup(thread_c.join)
 
3216
        self.addCleanup(event.set)
 
3217
        result.startTestRun()
 
3218
        unittest.TestSuite(
 
3219
            [first_test, Test("test_second_no_leak"), third_test]
 
3220
            ).run(result)
 
3221
        result.stopTestRun()
 
3222
        self.assertEqual(result._tests_leaking_threads_count, 2)
 
3223
        self.assertEqual(result._first_thread_leaker_id, first_test.id())
 
3224
        self.assertEqual(result.leaks, [
 
3225
            (first_test, set([thread_b])),
 
3226
            (third_test, set([thread_a, thread_c]))])
 
3227
        self.assertContainsString(result.stream.getvalue(), "leaking threads")
 
3228
 
 
3229
 
 
3230
class TestPostMortemDebugging(tests.TestCase):
 
3231
    """Check post mortem debugging works when tests fail or error"""
 
3232
 
 
3233
    class TracebackRecordingResult(tests.ExtendedTestResult):
 
3234
        def __init__(self):
 
3235
            tests.ExtendedTestResult.__init__(self, StringIO(), 0, 1)
 
3236
            self.postcode = None
 
3237
        def _post_mortem(self, tb=None):
 
3238
            """Record the code object at the end of the current traceback"""
 
3239
            tb = tb or sys.exc_info()[2]
 
3240
            if tb is not None:
 
3241
                next = tb.tb_next
 
3242
                while next is not None:
 
3243
                    tb = next
 
3244
                    next = next.tb_next
 
3245
                self.postcode = tb.tb_frame.f_code
 
3246
        def report_error(self, test, err):
 
3247
            pass
 
3248
        def report_failure(self, test, err):
 
3249
            pass
 
3250
 
 
3251
    def test_location_unittest_error(self):
 
3252
        """Needs right post mortem traceback with erroring unittest case"""
 
3253
        class Test(unittest.TestCase):
 
3254
            def runTest(self):
 
3255
                raise RuntimeError
 
3256
        result = self.TracebackRecordingResult()
 
3257
        Test().run(result)
 
3258
        self.assertEqual(result.postcode, Test.runTest.func_code)
 
3259
 
 
3260
    def test_location_unittest_failure(self):
 
3261
        """Needs right post mortem traceback with failing unittest case"""
 
3262
        class Test(unittest.TestCase):
 
3263
            def runTest(self):
 
3264
                raise self.failureException
 
3265
        result = self.TracebackRecordingResult()
 
3266
        Test().run(result)
 
3267
        self.assertEqual(result.postcode, Test.runTest.func_code)
 
3268
 
 
3269
    def test_location_bt_error(self):
 
3270
        """Needs right post mortem traceback with erroring bzrlib.tests case"""
 
3271
        class Test(tests.TestCase):
 
3272
            def test_error(self):
 
3273
                raise RuntimeError
 
3274
        result = self.TracebackRecordingResult()
 
3275
        Test("test_error").run(result)
 
3276
        self.assertEqual(result.postcode, Test.test_error.func_code)
 
3277
 
 
3278
    def test_location_bt_failure(self):
 
3279
        """Needs right post mortem traceback with failing bzrlib.tests case"""
 
3280
        class Test(tests.TestCase):
 
3281
            def test_failure(self):
 
3282
                raise self.failureException
 
3283
        result = self.TracebackRecordingResult()
 
3284
        Test("test_failure").run(result)
 
3285
        self.assertEqual(result.postcode, Test.test_failure.func_code)
 
3286
 
 
3287
    def test_env_var_triggers_post_mortem(self):
 
3288
        """Check pdb.post_mortem is called iff BZR_TEST_PDB is set"""
 
3289
        import pdb
 
3290
        result = tests.ExtendedTestResult(StringIO(), 0, 1)
 
3291
        post_mortem_calls = []
 
3292
        self.overrideAttr(pdb, "post_mortem", post_mortem_calls.append)
 
3293
        self.overrideEnv('BZR_TEST_PDB', None)
 
3294
        result._post_mortem(1)
 
3295
        self.overrideEnv('BZR_TEST_PDB', 'on')
 
3296
        result._post_mortem(2)
 
3297
        self.assertEqual([2], post_mortem_calls)
 
3298
 
 
3299
 
2356
3300
class TestRunSuite(tests.TestCase):
2357
3301
 
2358
3302
    def test_runner_class(self):
2368
3312
                return tests.ExtendedTestResult(self.stream, self.descriptions,
2369
3313
                                                self.verbosity)
2370
3314
        tests.run_suite(suite, runner_class=MyRunner, stream=StringIO())
2371
 
        self.assertEqual(calls, [suite])
2372
 
 
2373
 
    def test_done(self):
2374
 
        """run_suite should call result.done()"""
2375
 
        self.calls = 0
2376
 
        def one_more_call(): self.calls += 1
2377
 
        def test_function():
2378
 
            pass
2379
 
        test = unittest.FunctionTestCase(test_function)
2380
 
        class InstrumentedTestResult(tests.ExtendedTestResult):
2381
 
            def done(self): one_more_call()
2382
 
        class MyRunner(tests.TextTestRunner):
2383
 
            def run(self, test):
2384
 
                return InstrumentedTestResult(self.stream, self.descriptions,
2385
 
                                              self.verbosity)
2386
 
        tests.run_suite(test, runner_class=MyRunner, stream=StringIO())
2387
 
        self.assertEquals(1, self.calls)
 
3315
        self.assertLength(1, calls)
 
3316
 
 
3317
 
 
3318
class TestUncollectedWarnings(tests.TestCase):
 
3319
    """Check a test case still alive after being run emits a warning"""
 
3320
 
 
3321
    class Test(tests.TestCase):
 
3322
        def test_pass(self):
 
3323
            pass
 
3324
        def test_self_ref(self):
 
3325
            self.also_self = self.test_self_ref
 
3326
        def test_skip(self):
 
3327
            self.skip("Don't need")
 
3328
 
 
3329
    def _get_suite(self):
 
3330
        return TestUtil.TestSuite([
 
3331
            self.Test("test_pass"),
 
3332
            self.Test("test_self_ref"),
 
3333
            self.Test("test_skip"),
 
3334
            ])
 
3335
 
 
3336
    def _inject_stream_into_subunit(self, stream):
 
3337
        """To be overridden by subclasses that run tests out of process"""
 
3338
 
 
3339
    def _run_selftest_with_suite(self, **kwargs):
 
3340
        sio = StringIO()
 
3341
        self._inject_stream_into_subunit(sio)
 
3342
        old_flags = tests.selftest_debug_flags
 
3343
        tests.selftest_debug_flags = old_flags.union(["uncollected_cases"])
 
3344
        gc_on = gc.isenabled()
 
3345
        if gc_on:
 
3346
            gc.disable()
 
3347
        try:
 
3348
            tests.selftest(test_suite_factory=self._get_suite, stream=sio,
 
3349
                stop_on_failure=False, **kwargs)
 
3350
        finally:
 
3351
            if gc_on:
 
3352
                gc.enable()
 
3353
            tests.selftest_debug_flags = old_flags
 
3354
        output = sio.getvalue()
 
3355
        self.assertNotContainsRe(output, "Uncollected test case.*test_pass")
 
3356
        self.assertContainsRe(output, "Uncollected test case.*test_self_ref")
 
3357
        return output
 
3358
 
 
3359
    def test_testsuite(self):
 
3360
        self._run_selftest_with_suite()
 
3361
 
 
3362
    def test_pattern(self):
 
3363
        out = self._run_selftest_with_suite(pattern="test_(?:pass|self_ref)$")
 
3364
        self.assertNotContainsRe(out, "test_skip")
 
3365
 
 
3366
    def test_exclude_pattern(self):
 
3367
        out = self._run_selftest_with_suite(exclude_pattern="test_skip$")
 
3368
        self.assertNotContainsRe(out, "test_skip")
 
3369
 
 
3370
    def test_random_seed(self):
 
3371
        self._run_selftest_with_suite(random_seed="now")
 
3372
 
 
3373
    def test_matching_tests_first(self):
 
3374
        self._run_selftest_with_suite(matching_tests_first=True,
 
3375
            pattern="test_self_ref$")
 
3376
 
 
3377
    def test_starting_with_and_exclude(self):
 
3378
        out = self._run_selftest_with_suite(starting_with=["bt."],
 
3379
            exclude_pattern="test_skip$")
 
3380
        self.assertNotContainsRe(out, "test_skip")
 
3381
 
 
3382
    def test_additonal_decorator(self):
 
3383
        out = self._run_selftest_with_suite(
 
3384
            suite_decorators=[tests.TestDecorator])
 
3385
 
 
3386
 
 
3387
class TestUncollectedWarningsSubunit(TestUncollectedWarnings):
 
3388
    """Check warnings from tests staying alive are emitted with subunit"""
 
3389
 
 
3390
    _test_needs_features = [features.subunit]
 
3391
 
 
3392
    def _run_selftest_with_suite(self, **kwargs):
 
3393
        return TestUncollectedWarnings._run_selftest_with_suite(self,
 
3394
            runner_class=tests.SubUnitBzrRunner, **kwargs)
 
3395
 
 
3396
 
 
3397
class TestUncollectedWarningsForking(TestUncollectedWarnings):
 
3398
    """Check warnings from tests staying alive are emitted when forking"""
 
3399
 
 
3400
    _test_needs_features = [features.subunit]
 
3401
 
 
3402
    def _inject_stream_into_subunit(self, stream):
 
3403
        """Monkey-patch subunit so the extra output goes to stream not stdout
 
3404
 
 
3405
        Some APIs need rewriting so this kind of bogus hackery can be replaced
 
3406
        by passing the stream param from run_tests down into ProtocolTestCase.
 
3407
        """
 
3408
        from subunit import ProtocolTestCase
 
3409
        _original_init = ProtocolTestCase.__init__
 
3410
        def _init_with_passthrough(self, *args, **kwargs):
 
3411
            _original_init(self, *args, **kwargs)
 
3412
            self._passthrough = stream
 
3413
        self.overrideAttr(ProtocolTestCase, "__init__", _init_with_passthrough)
 
3414
 
 
3415
    def _run_selftest_with_suite(self, **kwargs):
 
3416
        # GZ 2011-05-26: Add a PosixSystem feature so this check can go away
 
3417
        if getattr(os, "fork", None) is None:
 
3418
            raise tests.TestNotApplicable("Platform doesn't support forking")
 
3419
        # Make sure the fork code is actually invoked by claiming two cores
 
3420
        self.overrideAttr(osutils, "local_concurrency", lambda: 2)
 
3421
        kwargs.setdefault("suite_decorators", []).append(tests.fork_decorator)
 
3422
        return TestUncollectedWarnings._run_selftest_with_suite(self, **kwargs)
 
3423
 
 
3424
 
 
3425
class TestEnvironHandling(tests.TestCase):
 
3426
 
 
3427
    def test_overrideEnv_None_called_twice_doesnt_leak(self):
 
3428
        self.assertFalse('MYVAR' in os.environ)
 
3429
        self.overrideEnv('MYVAR', '42')
 
3430
        # We use an embedded test to make sure we fix the _captureVar bug
 
3431
        class Test(tests.TestCase):
 
3432
            def test_me(self):
 
3433
                # The first call save the 42 value
 
3434
                self.overrideEnv('MYVAR', None)
 
3435
                self.assertEquals(None, os.environ.get('MYVAR'))
 
3436
                # Make sure we can call it twice
 
3437
                self.overrideEnv('MYVAR', None)
 
3438
                self.assertEquals(None, os.environ.get('MYVAR'))
 
3439
        output = StringIO()
 
3440
        result = tests.TextTestResult(output, 0, 1)
 
3441
        Test('test_me').run(result)
 
3442
        if not result.wasStrictlySuccessful():
 
3443
            self.fail(output.getvalue())
 
3444
        # We get our value back
 
3445
        self.assertEquals('42', os.environ.get('MYVAR'))
 
3446
 
 
3447
 
 
3448
class TestIsolatedEnv(tests.TestCase):
 
3449
    """Test isolating tests from os.environ.
 
3450
 
 
3451
    Since we use tests that are already isolated from os.environ a bit of care
 
3452
    should be taken when designing the tests to avoid bootstrap side-effects.
 
3453
    The tests start an already clean os.environ which allow doing valid
 
3454
    assertions about which variables are present or not and design tests around
 
3455
    these assertions.
 
3456
    """
 
3457
 
 
3458
    class ScratchMonkey(tests.TestCase):
 
3459
 
 
3460
        def test_me(self):
 
3461
            pass
 
3462
 
 
3463
    def test_basics(self):
 
3464
        # Make sure we know the definition of BZR_HOME: not part of os.environ
 
3465
        # for tests.TestCase.
 
3466
        self.assertTrue('BZR_HOME' in tests.isolated_environ)
 
3467
        self.assertEquals(None, tests.isolated_environ['BZR_HOME'])
 
3468
        # Being part of isolated_environ, BZR_HOME should not appear here
 
3469
        self.assertFalse('BZR_HOME' in os.environ)
 
3470
        # Make sure we know the definition of LINES: part of os.environ for
 
3471
        # tests.TestCase
 
3472
        self.assertTrue('LINES' in tests.isolated_environ)
 
3473
        self.assertEquals('25', tests.isolated_environ['LINES'])
 
3474
        self.assertEquals('25', os.environ['LINES'])
 
3475
 
 
3476
    def test_injecting_unknown_variable(self):
 
3477
        # BZR_HOME is known to be absent from os.environ
 
3478
        test = self.ScratchMonkey('test_me')
 
3479
        tests.override_os_environ(test, {'BZR_HOME': 'foo'})
 
3480
        self.assertEquals('foo', os.environ['BZR_HOME'])
 
3481
        tests.restore_os_environ(test)
 
3482
        self.assertFalse('BZR_HOME' in os.environ)
 
3483
 
 
3484
    def test_injecting_known_variable(self):
 
3485
        test = self.ScratchMonkey('test_me')
 
3486
        # LINES is known to be present in os.environ
 
3487
        tests.override_os_environ(test, {'LINES': '42'})
 
3488
        self.assertEquals('42', os.environ['LINES'])
 
3489
        tests.restore_os_environ(test)
 
3490
        self.assertEquals('25', os.environ['LINES'])
 
3491
 
 
3492
    def test_deleting_variable(self):
 
3493
        test = self.ScratchMonkey('test_me')
 
3494
        # LINES is known to be present in os.environ
 
3495
        tests.override_os_environ(test, {'LINES': None})
 
3496
        self.assertTrue('LINES' not in os.environ)
 
3497
        tests.restore_os_environ(test)
 
3498
        self.assertEquals('25', os.environ['LINES'])
 
3499
 
 
3500
 
 
3501
class TestDocTestSuiteIsolation(tests.TestCase):
 
3502
    """Test that `tests.DocTestSuite` isolates doc tests from os.environ.
 
3503
 
 
3504
    Since tests.TestCase alreay provides an isolation from os.environ, we use
 
3505
    the clean environment as a base for testing. To precisely capture the
 
3506
    isolation provided by tests.DocTestSuite, we use doctest.DocTestSuite to
 
3507
    compare against.
 
3508
 
 
3509
    We want to make sure `tests.DocTestSuite` respect `tests.isolated_environ`,
 
3510
    not `os.environ` so each test overrides it to suit its needs.
 
3511
 
 
3512
    """
 
3513
 
 
3514
    def get_doctest_suite_for_string(self, klass, string):
 
3515
        class Finder(doctest.DocTestFinder):
 
3516
 
 
3517
            def find(*args, **kwargs):
 
3518
                test = doctest.DocTestParser().get_doctest(
 
3519
                    string, {}, 'foo', 'foo.py', 0)
 
3520
                return [test]
 
3521
 
 
3522
        suite = klass(test_finder=Finder())
 
3523
        return suite
 
3524
 
 
3525
    def run_doctest_suite_for_string(self, klass, string):
 
3526
        suite = self.get_doctest_suite_for_string(klass, string)
 
3527
        output = StringIO()
 
3528
        result = tests.TextTestResult(output, 0, 1)
 
3529
        suite.run(result)
 
3530
        return result, output
 
3531
 
 
3532
    def assertDocTestStringSucceds(self, klass, string):
 
3533
        result, output = self.run_doctest_suite_for_string(klass, string)
 
3534
        if not result.wasStrictlySuccessful():
 
3535
            self.fail(output.getvalue())
 
3536
 
 
3537
    def assertDocTestStringFails(self, klass, string):
 
3538
        result, output = self.run_doctest_suite_for_string(klass, string)
 
3539
        if result.wasStrictlySuccessful():
 
3540
            self.fail(output.getvalue())
 
3541
 
 
3542
    def test_injected_variable(self):
 
3543
        self.overrideAttr(tests, 'isolated_environ', {'LINES': '42'})
 
3544
        test = """
 
3545
            >>> import os
 
3546
            >>> os.environ['LINES']
 
3547
            '42'
 
3548
            """
 
3549
        # doctest.DocTestSuite fails as it sees '25'
 
3550
        self.assertDocTestStringFails(doctest.DocTestSuite, test)
 
3551
        # tests.DocTestSuite sees '42'
 
3552
        self.assertDocTestStringSucceds(tests.IsolatedDocTestSuite, test)
 
3553
 
 
3554
    def test_deleted_variable(self):
 
3555
        self.overrideAttr(tests, 'isolated_environ', {'LINES': None})
 
3556
        test = """
 
3557
            >>> import os
 
3558
            >>> os.environ.get('LINES')
 
3559
            """
 
3560
        # doctest.DocTestSuite fails as it sees '25'
 
3561
        self.assertDocTestStringFails(doctest.DocTestSuite, test)
 
3562
        # tests.DocTestSuite sees None
 
3563
        self.assertDocTestStringSucceds(tests.IsolatedDocTestSuite, test)
 
3564
 
 
3565
 
 
3566
class TestSelftestExcludePatterns(tests.TestCase):
 
3567
 
 
3568
    def setUp(self):
 
3569
        super(TestSelftestExcludePatterns, self).setUp()
 
3570
        self.overrideAttr(tests, 'test_suite', self.suite_factory)
 
3571
 
 
3572
    def suite_factory(self, keep_only=None, starting_with=None):
 
3573
        """A test suite factory with only a few tests."""
 
3574
        class Test(tests.TestCase):
 
3575
            def id(self):
 
3576
                # We don't need the full class path
 
3577
                return self._testMethodName
 
3578
            def a(self):
 
3579
                pass
 
3580
            def b(self):
 
3581
                pass
 
3582
            def c(self):
 
3583
                pass
 
3584
        return TestUtil.TestSuite([Test("a"), Test("b"), Test("c")])
 
3585
 
 
3586
    def assertTestList(self, expected, *selftest_args):
 
3587
        # We rely on setUp installing the right test suite factory so we can
 
3588
        # test at the command level without loading the whole test suite
 
3589
        out, err = self.run_bzr(('selftest', '--list') + selftest_args)
 
3590
        actual = out.splitlines()
 
3591
        self.assertEquals(expected, actual)
 
3592
 
 
3593
    def test_full_list(self):
 
3594
        self.assertTestList(['a', 'b', 'c'])
 
3595
 
 
3596
    def test_single_exclude(self):
 
3597
        self.assertTestList(['b', 'c'], '-x', 'a')
 
3598
 
 
3599
    def test_mutiple_excludes(self):
 
3600
        self.assertTestList(['c'], '-x', 'a', '-x', 'b')
 
3601
 
 
3602
 
 
3603
class TestCounterHooks(tests.TestCase, SelfTestHelper):
 
3604
 
 
3605
    _test_needs_features = [features.subunit]
 
3606
 
 
3607
    def setUp(self):
 
3608
        super(TestCounterHooks, self).setUp()
 
3609
        class Test(tests.TestCase):
 
3610
 
 
3611
            def setUp(self):
 
3612
                super(Test, self).setUp()
 
3613
                self.hooks = hooks.Hooks()
 
3614
                self.hooks.add_hook('myhook', 'Foo bar blah', (2,4))
 
3615
                self.install_counter_hook(self.hooks, 'myhook')
 
3616
 
 
3617
            def no_hook(self):
 
3618
                pass
 
3619
 
 
3620
            def run_hook_once(self):
 
3621
                for hook in self.hooks['myhook']:
 
3622
                    hook(self)
 
3623
 
 
3624
        self.test_class = Test
 
3625
 
 
3626
    def assertHookCalls(self, expected_calls, test_name):
 
3627
        test = self.test_class(test_name)
 
3628
        result = unittest.TestResult()
 
3629
        test.run(result)
 
3630
        self.assertTrue(hasattr(test, '_counters'))
 
3631
        self.assertTrue(test._counters.has_key('myhook'))
 
3632
        self.assertEquals(expected_calls, test._counters['myhook'])
 
3633
 
 
3634
    def test_no_hook(self):
 
3635
        self.assertHookCalls(0, 'no_hook')
 
3636
 
 
3637
    def test_run_hook_once(self):
 
3638
        tt = features.testtools
 
3639
        if tt.module.__version__ < (0, 9, 8):
 
3640
            raise tests.TestSkipped('testtools-0.9.8 required for addDetail')
 
3641
        self.assertHookCalls(1, 'run_hook_once')