CKTIS / Python
Charger les tests d’une classe avec loadTestsFromTestCase
Construisez une suite à partir d’une sous-classe de `unittest.TestCase` et distinguez les méthodes chargées des sous-tests qu’elles exécutent.
Version : Python 3.12
Syntaxe
unittest.defaultTestLoader.loadTestsFromTestCase(testCaseClass)
unittest.TestLoader().loadTestsFromTestCase(testCaseClass)Dans Python 3.12, TestLoader.loadTestsFromTestCase prend une sous-classe de unittest.TestCase, pas une instance. La méthode cherche les méthodes de cette classe, sans parcourir les fichiers comme discover() ni exécuter les tests. Elle renvoie une suite, de type unittest.TestSuite par défaut.
Le chargeur crée une instance distincte de la classe pour chaque méthode sélectionnée par getTestCaseNames(). Par défaut, il retient les méthodes dont le nom commence par test, y compris celles qui sont héritées. Le caractère de soulignement n’est pas obligatoire. Si aucune méthode n’est sélectionnée mais que la classe implémente runTest(), le chargeur crée un seul cas de test pour runTest().
Utilisez le chargeur partagé unittest.defaultTestLoader si vous n’avez pas besoin de réglages particuliers. Pour modifier un réglage tel que testMethodPrefix sans toucher au chargeur partagé, créez votre propre unittest.TestLoader(). Appelez countTestCases() avant d’exécuter la suite pour compter ses cas de test. Les itérations de subTest() ont lieu dans une méthode déjà chargée et n’ajoutent pas de cas distincts à la suite.
Exemples
import unittest
class TwoTests(unittest.TestCase):
def test_positive(self):
for n in range(1, 6):
with self.subTest(n=n):
self.assertEqual(abs(n), n)
def test_negative(self):
for n in range(-4, 0):
with self.subTest(n=n):
self.assertEqual(abs(n), -n)
class FourTests(TwoTests):
def test_zero(self):
self.assertEqual(abs(0), 0)
def test_negative_float(self):
self.assertEqual(abs(-1.5), 1.5)
def main():
loader = unittest.defaultTestLoader
for case_class in (TwoTests, FourTests):
suite = loader.loadTestsFromTestCase(case_class)
loaded = suite.countTestCases()
result = unittest.TestResult()
suite.run(result)
print(f"{case_class.__name__}: loaded={loaded}, run={result.testsRun}, ok={result.wasSuccessful()}")
if __name__ == "__main__":
main()
Résultat
TwoTests: loaded=2, run=2, ok=True FourTests: loaded=4, run=4, ok=True
`TwoTests` contient deux méthodes de test qui exécutent neuf sous-tests au total. `FourTests` hérite de ces deux méthodes et en ajoute deux. Ainsi, `loaded` et `run` valent tous deux 2 pour la première classe et 4 pour la seconde. `ok=True` sur les deux lignes indique que les deux suites ont réussi.
Leçons associées
- Python · Leçon 37 · Avancé · Version : 5
- Python · Leçon 34 · Intermédiaire · Version : 3