~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/TestUtil.py

  • Committer: Martin Pool
  • Date: 2007-04-04 06:17:31 UTC
  • mto: This revision was merged to the branch mainline in revision 2397.
  • Revision ID: mbp@sourcefrog.net-20070404061731-tt2xrzllqhbodn83
Contents of TODO file moved into bug tracker

Show diffs side-by-side

added added

removed removed

Lines of Context:
13
13
#
14
14
# You should have received a copy of the GNU General Public License
15
15
# along with this program; if not, write to the Free Software
16
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17
17
#
18
18
 
19
19
import sys
20
20
import logging
21
21
import unittest
22
22
 
23
 
# Mark this python module as being part of the implementation
24
 
# of unittest: this gives us better tracebacks where the last
25
 
# shown frame is the test code, not our assertXYZ.
26
 
__unittest = 1
27
 
 
28
23
 
29
24
class LogCollector(logging.Handler):
30
25
    def __init__(self):
47
42
def visitTests(suite, visitor):
48
43
    """A foreign method for visiting the tests in a test suite."""
49
44
    for test in suite._tests:
50
 
        #Abusing types to avoid monkey patching unittest.TestCase.
 
45
        #Abusing types to avoid monkey patching unittest.TestCase. 
51
46
        # Maybe that would be better?
52
47
        try:
53
48
            test.visit(visitor)
59
54
                visitTests(test, visitor)
60
55
            else:
61
56
                print "unvisitable non-unittest.TestCase element %r (%r)" % (test, test.__class__)
62
 
 
 
57
    
63
58
 
64
59
class TestSuite(unittest.TestSuite):
65
60
    """I am an extended TestSuite with a visitor interface.
74
69
 
75
70
 
76
71
class TestLoader(unittest.TestLoader):
77
 
    """Custom TestLoader to extend the stock python one."""
78
 
 
 
72
    """Custom  TestLoader to address some quirks in the stock python one."""
79
73
    suiteClass = TestSuite
80
 
    # Memoize test names by test class dict
81
 
    test_func_names = {}
82
74
 
83
75
    def loadTestsFromModuleNames(self, names):
84
76
        """use a custom means to load tests from modules.
85
77
 
86
 
        There is an undesirable glitch in the python TestLoader where a
87
 
        import error is ignore. We think this can be solved by ensuring the
 
78
        There is an undesirable glitch in the python TestLoader where a 
 
79
        import error is ignore. We think this can be solved by ensuring the 
88
80
        requested name is resolvable, if its not raising the original error.
89
81
        """
90
82
        result = self.suiteClass()
91
83
        for name in names:
92
 
            result.addTests(self.loadTestsFromModuleName(name))
93
 
        return result
94
 
 
95
 
    def loadTestsFromModuleName(self, name):
96
 
        result = self.suiteClass()
97
 
        module = _load_module_by_name(name)
98
 
 
99
 
        result.addTests(self.loadTestsFromModule(module))
100
 
        return result
101
 
 
102
 
    def loadTestsFromModule(self, module):
103
 
        """Load tests from a module object.
104
 
 
105
 
        This extension of the python test loader looks for an attribute
106
 
        load_tests in the module object, and if not found falls back to the
107
 
        regular python loadTestsFromModule.
108
 
 
109
 
        If a load_tests attribute is found, it is called and the result is
110
 
        returned.
111
 
 
112
 
        load_tests should be defined like so:
113
 
        >>> def load_tests(standard_tests, module, loader):
114
 
        >>>    pass
115
 
 
116
 
        standard_tests is the tests found by the stock TestLoader in the
117
 
        module, module and loader are the module and loader instances.
118
 
 
119
 
        For instance, to run every test twice, you might do:
120
 
        >>> def load_tests(standard_tests, module, loader):
121
 
        >>>     result = loader.suiteClass()
122
 
        >>>     for test in iter_suite_tests(standard_tests):
123
 
        >>>         result.addTests([test, test])
124
 
        >>>     return result
125
 
        """
126
 
        basic_tests = super(TestLoader, self).loadTestsFromModule(module)
127
 
        load_tests = getattr(module, "load_tests", None)
128
 
        if load_tests is not None:
129
 
            return load_tests(basic_tests, module, self)
130
 
        else:
131
 
            return basic_tests
132
 
 
133
 
    def getTestCaseNames(self, test_case_class):
134
 
        test_fn_names = self.test_func_names.get(test_case_class, None)
135
 
        if test_fn_names is not None:
136
 
            # We already know them
137
 
            return test_fn_names
138
 
 
139
 
        test_fn_names = unittest.TestLoader.getTestCaseNames(self,
140
 
                                                             test_case_class)
141
 
        self.test_func_names[test_case_class] = test_fn_names
142
 
        return test_fn_names
143
 
 
144
 
 
145
 
class FilteredByModuleTestLoader(TestLoader):
146
 
    """A test loader that import only the needed modules."""
147
 
 
148
 
    def __init__(self, needs_module):
149
 
        """Constructor.
150
 
 
151
 
        :param needs_module: a callable taking a module name as a
152
 
            parameter returing True if the module should be loaded.
153
 
        """
154
 
        TestLoader.__init__(self)
155
 
        self.needs_module = needs_module
156
 
 
157
 
    def loadTestsFromModuleName(self, name):
158
 
        if self.needs_module(name):
159
 
            return TestLoader.loadTestsFromModuleName(self, name)
160
 
        else:
161
 
            return self.suiteClass()
 
84
            _load_module_by_name(name)
 
85
            result.addTests(self.loadTestsFromName(name))
 
86
        return result
162
87
 
163
88
 
164
89
def _load_module_by_name(mod_name):