/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/tests/TestUtil.py

More work on roundtrip push support.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2004, 2005, 2006 Canonical Ltd
2
 
#       Author: Robert Collins <robert.collins@canonical.com>
3
 
#
4
 
# This program is free software; you can redistribute it and/or modify
5
 
# it under the terms of the GNU General Public License as published by
6
 
# the Free Software Foundation; either version 2 of the License, or
7
 
# (at your option) any later version.
8
 
#
9
 
# This program is distributed in the hope that it will be useful,
10
 
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
 
# GNU General Public License for more details.
13
 
#
14
 
# You should have received a copy of the GNU General Public License
15
 
# along with this program; if not, write to the Free Software
16
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17
 
#
18
 
 
19
 
import sys
20
 
import logging
21
 
import unittest
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
 
 
29
 
class LogCollector(logging.Handler):
30
 
    def __init__(self):
31
 
        logging.Handler.__init__(self)
32
 
        self.records=[]
33
 
    def emit(self, record):
34
 
        self.records.append(record.getMessage())
35
 
 
36
 
 
37
 
def makeCollectingLogger():
38
 
    """I make a logger instance that collects its logs for programmatic analysis
39
 
    -> (logger, collector)"""
40
 
    logger=logging.Logger("collector")
41
 
    handler=LogCollector()
42
 
    handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
43
 
    logger.addHandler(handler)
44
 
    return logger, handler
45
 
 
46
 
 
47
 
def visitTests(suite, visitor):
48
 
    """A foreign method for visiting the tests in a test suite."""
49
 
    for test in suite._tests:
50
 
        #Abusing types to avoid monkey patching unittest.TestCase. 
51
 
        # Maybe that would be better?
52
 
        try:
53
 
            test.visit(visitor)
54
 
        except AttributeError:
55
 
            if isinstance(test, unittest.TestCase):
56
 
                visitor.visitCase(test)
57
 
            elif isinstance(test, unittest.TestSuite):
58
 
                visitor.visitSuite(test)
59
 
                visitTests(test, visitor)
60
 
            else:
61
 
                print "unvisitable non-unittest.TestCase element %r (%r)" % (test, test.__class__)
62
 
    
63
 
 
64
 
class TestSuite(unittest.TestSuite):
65
 
    """I am an extended TestSuite with a visitor interface.
66
 
    This is primarily to allow filtering of tests - and suites or
67
 
    more in the future. An iterator of just tests wouldn't scale..."""
68
 
 
69
 
    def visit(self, visitor):
70
 
        """visit the composite. Visiting is depth-first.
71
 
        current callbacks are visitSuite and visitCase."""
72
 
        visitor.visitSuite(self)
73
 
        visitTests(self, visitor)
74
 
 
75
 
 
76
 
class TestLoader(unittest.TestLoader):
77
 
    """Custom TestLoader to extend the stock python one."""
78
 
 
79
 
    suiteClass = TestSuite
80
 
    # Memoize test names by test class dict
81
 
    test_func_names = {}
82
 
 
83
 
    def loadTestsFromModuleNames(self, names):
84
 
        """use a custom means to load tests from modules.
85
 
 
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 
88
 
        requested name is resolvable, if its not raising the original error.
89
 
        """
90
 
        result = self.suiteClass()
91
 
        for name in names:
92
 
            module = _load_module_by_name(name)
93
 
            result.addTests(self.loadTestsFromModule(module))
94
 
        return result
95
 
 
96
 
    def loadTestsFromModule(self, module):
97
 
        """Load tests from a module object.
98
 
 
99
 
        This extension of the python test loader looks for an attribute
100
 
        load_tests in the module object, and if not found falls back to the
101
 
        regular python loadTestsFromModule.
102
 
 
103
 
        If a load_tests attribute is found, it is called and the result is
104
 
        returned. 
105
 
 
106
 
        load_tests should be defined like so:
107
 
        >>> def load_tests(standard_tests, module, loader):
108
 
        >>>    pass
109
 
 
110
 
        standard_tests is the tests found by the stock TestLoader in the
111
 
        module, module and loader are the module and loader instances.
112
 
 
113
 
        For instance, to run every test twice, you might do:
114
 
        >>> def load_tests(standard_tests, module, loader):
115
 
        >>>     result = loader.suiteClass()
116
 
        >>>     for test in iter_suite_tests(standard_tests):
117
 
        >>>         result.addTests([test, test])
118
 
        >>>     return result
119
 
        """
120
 
        basic_tests = super(TestLoader, self).loadTestsFromModule(module)
121
 
        load_tests = getattr(module, "load_tests", None)
122
 
        if load_tests is not None:
123
 
            return load_tests(basic_tests, module, self)
124
 
        else:
125
 
            return basic_tests
126
 
 
127
 
    def getTestCaseNames(self, test_case_class):
128
 
        test_fn_names = self.test_func_names.get(test_case_class, None)
129
 
        if test_fn_names is not None:
130
 
            # We already calculate that
131
 
            return test_fn_names
132
 
 
133
 
        test_fn_names = unittest.TestLoader.getTestCaseNames(self,
134
 
                                                             test_case_class)
135
 
        self.test_func_names[test_case_class] = test_fn_names
136
 
        return test_fn_names
137
 
 
138
 
def _load_module_by_name(mod_name):
139
 
    parts = mod_name.split('.')
140
 
    module = __import__(mod_name)
141
 
    del parts[0]
142
 
    # for historical reasons python returns the top-level module even though
143
 
    # it loads the submodule; we need to walk down to get the one we want.
144
 
    while parts:
145
 
        module = getattr(module, parts.pop(0))
146
 
    return module
147
 
 
148
 
 
149
 
class TestVisitor(object):
150
 
    """A visitor for Tests"""
151
 
    def visitSuite(self, aTestSuite):
152
 
        pass
153
 
    def visitCase(self, aTestCase):
154
 
        pass