Número de veces invocado en código de test
| Sigla | CALLEDt |
| Aspecto | «Tests» |
| Se mide en | método |
| Tipo de valor | recuento (entero, mínimo 0; en el plugin, de tipo «score») |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumTimesCalledTest |
En pocas palabras
Cuenta cuántos sitios del código de test llaman a un método. Un método con llamadas desde los tests tiene al menos
alguien que lo ejercita; uno con cero no lo toca ningún test. Es la parte de «CALLED»
que viene de los tests.
Qué mide
Cuánto usan los tests un método concreto. Separa las llamadas que recibe desde los tests de las que recibe desde el código de producción, lo que permite dos preguntas:
- ¿Qué métodos de producción no llama ningún test? Son candidatos a pruebas que faltan. Es una aproximación estática: no sabe si un test los ejecuta de forma indirecta, a través de otro método.
- ¿Qué métodos solo se llaman desde tests? Si además
«
CALLEDp» es0, el método quizá solo exista para los tests y sea código muerto en producción.
A diferencia de la «cobertura», no se mide ejecutando los tests, sino leyendo el código: cuenta llamadas escritas, no ejecutadas.
Cómo se calcula
Un punto de llamada es un lugar concreto del código que nombra el método para invocarlo: una llamada m(), una
referencia Clase::m o, para un constructor, un new. Dos llamadas en la misma línea son dos puntos; una llamada
dentro de un bucle es uno, se ejecute las veces que se ejecute.
Ejemplo
// src/main/java
class Calc { int twice(int x) { return x * 2; } int unused() { return 0; } }
class Report { int total(Calc c) { return c.twice(1) + c.twice(2); } }
// src/test/java
import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.api.Test;
class CalcTest {
@Test void doubles() { assertEquals(4, new Calc().twice(2)); }
@Test void other() { new Calc().unused(); }
}
| Método | CALLED |
CALLEDp |
CALLEDt |
|---|---|---|---|
Calc.twice |
3 | 2 | 1 |
Calc.unused |
1 | 0 | 1 |
unused solo se llama desde un test: si ese test no existiera, sería código muerto.
Cómo interpretarla
Sin valor bueno ni malo y sin umbrales. Un CALLEDt de 0 en un método importante de producción indica que ningún
test lo llama directamente. Un valor positivo con CALLEDp en 0 indica un método que solo usan los tests.
Los propios métodos de test suelen tener 0: los invoca el framework por reflexión, no el código.
Relación con otras métricas
- «Número de veces invocado» (
CALLED): el total, de producción, test y cualquier otro sitio. - «Número de veces invocado en código de producción» (
CALLEDp): la otra parte. - «Número de llamadas a métodos» (
CALL): al revés, las llamadas que el método hace. - «Cobertura de código»: lo que los tests ejecutan de verdad.
En las herramientas
Stau Metro (NumTimesCalledTest). Busca en todo el proyecto las referencias al método, descarta las de
comentarios de documentación y las de import, y se queda con las que están en un fichero de una raíz de fuentes de
test. También cuentan las llamadas desde ficheros Kotlin. Una referencia desde un fichero sin código (un descriptor
XML) no es una llamada.
- Las llamadas hechas a través de un método de un supertipo del proyecto al que éste sobrescribe se atribuyen al
método que sobrescribe; las llamadas a métodos de bibliotecas o del JDK (
Object.toString(),Runnable.run()) no. Cada punto de llamada cuenta una vez, aunque llegue al método por varios caminos de la jerarquía. - La búsqueda abarca el proyecto entero, no solo el ámbito analizado.
- Un fichero que no está ni en una raíz de test ni en una de producción suma al total (
CALLED) pero no aCALLEDtni aCALLEDp; así,CALLEDpuede ser mayor que su suma. - Se publica valor para todos los métodos y constructores declarados en el código, abstractos incluidos, salvo los de clases anónimas o locales declaradas dentro de otro método.