Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Carregar testes de uma classe com loadTestsFromTestCase

Cria uma suite de testes a partir de uma subclasse de `unittest.TestCase` e distingue os métodos carregados dos subtestes executados dentro de cada método.

Versão: Python 3.12

Sintaxe

unittest.defaultTestLoader.loadTestsFromTestCase(testCaseClass)
unittest.TestLoader().loadTestsFromTestCase(testCaseClass)

Em Python 3.12, TestLoader.loadTestsFromTestCase recebe uma subclasse de unittest.TestCase, não uma instância. Procura os métodos nessa classe, sem pesquisar ficheiros como discover() nem executar os testes. Devolve uma suite de testes que, por omissão, é do tipo unittest.TestSuite.

O carregador cria uma instância distinta da classe para cada método selecionado por getTestCaseNames(). Com as definições predefinidas, seleciona os métodos cujo nome começa por test, incluindo os herdados. O carácter de sublinhado não é obrigatório. Se não for selecionado nenhum método, mas a classe implementar runTest(), o carregador cria um único caso de teste para runTest().

Usa o carregador partilhado unittest.defaultTestLoader se não precisares de definições próprias. Para alterar uma definição como testMethodPrefix sem modificar o carregador partilhado, cria o teu próprio unittest.TestLoader(). Usa countTestCases() antes de executar a suite para contar os seus casos. As iterações de subTest() ocorrem dentro de um método já carregado e não acrescentam casos distintos à suite.

Exemplos

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()

Resultado

TwoTests: loaded=2, run=2, ok=True
FourTests: loaded=4, run=4, ok=True

`TwoTests` tem dois métodos de teste que executam nove subtestes no total. `FourTests` herda ambos os métodos e acrescenta dois. Por isso, `loaded` e `run` valem ambos 2 para a primeira classe e 4 para a segunda. `ok=True` nas duas linhas indica que ambas as suites passaram.

Lições relacionadas

  • Python · Lição 37 · Avançado · Versão: 5
  • Python · Lição 34 · Intermédio · Versão: 3

Fontes