← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/TestUtil.py

  • Committer: John Arbash Meinel
  • Date: 2008-03-15 14:07:55 UTC
  • mto: This revision was merged to the branch mainline in revision 3315.
  • Revision ID: john@arbash-meinel.com-20080315140755-5d1bxutgwx4bnnt8
Avoid opening the master branch when we won't use it.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/tests/TestUtil.py
1
 
# Copyright (c) 2004 Canonical Limited
 
1
# Copyright (C) 2004, 2005, 2006 Canonical Ltd
2
2
#       Author: Robert Collins <robert.collins@canonical.com>
3
3
#
4
4
# This program is free software; you can redistribute it and/or modify
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
 
23
28
 
24
29
class LogCollector(logging.Handler):
25
30
    def __init__(self):
69
74
 
70
75
 
71
76
class TestLoader(unittest.TestLoader):
72
 
    """Custome TestLoader to set the right TestSuite class."""
 
77
    """Custom TestLoader to extend the stock python one."""
 
78
 
73
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
 
74
148
 
75
149
class TestVisitor(object):
76
150
    """A visitor for Tests"""