Número de casos de test JUnit
| Sigla | JTC (JTC(rec) en la variante recursiva del paquete) |
| Aspecto | «Tests» |
| Se mide en | paquete, módulo, proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumTestCasesPackage, NumTestCasesRecursivePackage, NumTestCasesModule, NumTestCasesProject |
En pocas palabras
Cuenta las clases que el framework de tests reconocería como clases de test. Se parece al número de ficheros de tests del proyecto, pero contado por lo que contienen las clases y no por dónde están.
Ojo. Aquí «caso de test» es la clase, siguiendo el nombre
TestCasede JUnit 3. En la terminología general de pruebas, un caso de test es un escenario concreto con sus entradas y resultados esperados, que se parece más a un método de test: ese recuento es el «JTM».
Qué mide
Cuántas unidades de agrupación de tests tiene el código. Sirve para ver la estructura de la suite (muchas clases
pequeñas o pocas grandes) cuando se combina con el «número de métodos de test», y para
detectar qué parte del código de test no son clases de test: comparado con el «número de clases de test»
(Ct), la diferencia son clases auxiliares, fixtures y bases.
Cómo se calcula
Qué es una clase de test lo decide cada framework. En JUnit 3, una subclase de junit.framework.TestCase. JUnit 5
define una clase de test como «cualquier clase de nivel superior, miembro estático o clase @Nested que contiene al
menos un método de test», y añade que no puede ser abstracta.
Ejemplo
import org.junit.jupiter.api.Test;
abstract class Base { @Test void a() { } } // tiene un método de test, pero es abstracta
class T extends Base { } // hereda el método de test de Base
class Plain { void a() { } } // no tiene tests
Con la definición de JUnit 5, solo T es una clase de test: Base es abstracta y JUnit no la ejecuta por sí
sola. JTC = 1. Stau Metro, que no mira si la clase es abstracta, da JTC = 2 (Base y T).
Cómo interpretarla
Sin valor bueno ni malo y sin umbrales. Un 0 en un módulo con código de producción importante merece atención. Un
JTC mucho menor que Ct indica que el código de test tiene muchas clases que no son tests, lo que puede ser
normal (utilidades, datos de prueba) o reflejar que un framework no se reconoce.
Relación con otras métricas
- «Número de clases de test» (
Ct): todas las clases del código de test, incluidas las que no tienen tests; su diferencia conJTCson las clases de apoyo. - «Número de métodos de test JUnit» (
JTM): los tests de cada una de estas clases. - «Número de aserciones de test JUnit» (
JTA): las comprobaciones que hacen.
En las herramientas
Stau Metro (NumTestCasesPackage, NumTestCasesRecursivePackage, NumTestCasesModule, NumTestCasesProject).
Una clase cuenta si entre todos sus métodos, propios o heredados, hay alguno anotado con una de las anotaciones de test
de JUnit 4, JUnit 5 o TestNG (las de «JTM»), o si es subclase de junit.framework.TestCase.
- Se recorren todas las clases del ámbito, no solo las de raíces de test: una clase de producción con un método
@Testtambién cuenta. - Cuentan las clases abstractas con tests (como
Baseen el ejemplo), las anidadas y las que solo heredan sus tests. El código no mira si la clase es abstracta, a diferencia de la definición de JUnit 5. - Las clases anónimas y locales se recorren como cualquier otra; una subclase anónima de una clase con tests
hereda sus métodos y también cuenta. Lo mismo vale para una interfaz con un método
defaultanotado con@Test. - La anotación se busca solo tal cual en el método: una anotación propia meta-anotada con
@Testno se reconoce. - Solo Java. Un paquete o un módulo sin clases Java no tiene fila; el proyecto siempre tiene valor.
Referencias
- JUnit, definiciones: https://docs.junit.org/current/writing-tests/definitions.html