Líneas de código de test
| Sigla | LOCt (LOCt(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 | LinesOfTestCodePackage, LinesOfTestCodeRecursivePackage, LinesOfTestCodeModule, LinesOfTestCodeProject |
En pocas palabras
Cuenta las líneas que hay en el código de test: los ficheros que el proyecto tiene declarados como fuentes de test. Es el tamaño de la suite de tests, igual que las «líneas de código» son el tamaño del programa.
Qué mide
El volumen de código dedicado a probar. No dice si los tests son buenos ni cuánto código ejercitan; dice cuánto texto hay que mantener. Una suite con miles de líneas cuesta tiempo de lectura, de ejecución y de mantenimiento aunque no pruebe nada importante, y una con pocas líneas puede estar probando poco.
Por sí sola sirve de poco. Su uso natural es el denominador o el numerador de otras comparaciones: frente a las líneas de producción da la «ratio de test», y frente a las líneas sin comentarios muestra cuánto del test es comentario.
Cómo se calcula
Una línea cuenta si tiene algún carácter que no sea espacio ni tabulador. Las líneas vacías no cuentan; los
comentarios sí, igual que cualquier otro texto. Un «fichero de test» es el que está bajo una raíz de código fuente
marcada como de test (en Maven y Gradle, src/test/java y equivalentes).
Cómo interpretarla
No tiene valor bueno ni malo y no tiene umbrales. Compárala con:
- las «líneas de código de producción», para ver el equilibrio entre test y producción (es lo que resume la «ratio de test»);
- las «líneas sin comentarios de test», para ver cuánto del test es comentario;
- su propia evolución: un proyecto que crece en producción y no en tests deja
LOCtplano.
Un valor 0 en un módulo con código de producción significa que no tiene ficheros con líneas en sus fuentes de test
declaradas: no tiene tests, solo tiene recursos de test o sus tests quedan fuera del ámbito analizado.
Relación con otras métricas
- «Líneas de código sin comentarios (test)» (
NCLOCt): las mismas líneas sin los comentarios. - «Ratio de test» (
TEST_RAT):LOCtdividido entre las líneas de test más las de producción. - «Líneas de código» (
LOC): el total del elemento, sea de test o no. - «Líneas de código de producción» (
LOCp): la otra mitad de la comparación. - «Número de clases de test» (
Ct) y «de métodos de test» (JTM): el mismo código de test contado en clases y en métodos.
En las herramientas
Stau Metro (LinesOfTestCodePackage, LinesOfTestCodeRecursivePackage, LinesOfTestCodeModule,
LinesOfTestCodeProject). Suma las líneas no vacías de todos los ficheros que el índice del proyecto del IDE sitúa
en una raíz de fuentes de test, sin importar el lenguaje: cuentan el Java, el Kotlin y cualquier otro fichero de esa
raíz.
- Los ficheros bajo una raíz de recursos de test (
src/test/resources) no cuentan, ni en el paquete ni en el módulo ni en el proyecto. - En el paquete, los ficheros se asignan al paquete de su directorio. La variante recursiva suma además los subpaquetes; el paquete por defecto solo recibe sus propios ficheros.
- Cada fichero analizado crea la fila de su paquete o módulo, sea de test o no, de modo que un paquete sin tests da
0y no queda sin valor. - Solo se visitan los ficheros del ámbito analizado que pertenecen al contenido del proyecto y no están excluidos.
El valor del proyecto es la suma de las líneas de test de todos los ficheros analizados, es decir, la de sus módulos.