Número de ficheros Kotlin
| Sigla | KT |
| Aspecto | «Tamaño» |
| Se mide en | módulo, proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumKotlinFilesModule, NumKotlinFilesProject |
En pocas palabras
Cuenta los ficheros de código Kotlin de un módulo o del proyecto. Sirve para ver cuánto está escrito en Kotlin y, en proyectos mixtos, cómo se reparte el código entre Kotlin y Java.
Qué mide
El peso de Kotlin en número de ficheros. En un proyecto que migra de Java a Kotlin, o que mezcla ambos, es la mitad de la pregunta «¿en qué está escrito esto?»; la otra mitad es el «número de ficheros Java».
Ojo. Esta es una de las pocas métricas de Stau Metro que mira Kotlin. Para los ficheros Kotlin el plugin solo calcula este recuento y las «líneas de Kotlin»; el resto de métricas (clases, métodos, complejidad…) solo cubre Java. Un valor alto de
KTno significa que esas métricas lo reflejen.
Cómo se calcula
Se cuenta 1 por cada fichero de código fuente Kotlin (.kt) del ámbito. Los scripts de Kotlin (.kts, como
build.gradle.kts) no cuentan: son Kotlin, pero suelen ser configuración de la construcción o guiones, no código
del producto.
Cómo interpretarla
No tiene valor bueno ni malo y no tiene umbrales. Se lee comparado:
- con «
J», para ver la proporción entre lenguajes y cómo cambia en el tiempo; - con las «líneas de Kotlin», para el tamaño medio de un fichero: Kotlin admite varias clases y funciones de nivel superior en un mismo fichero, así que no compares el número de ficheros entre lenguajes sin mirar las líneas.
Relación con otras métricas
- «Número de ficheros» (
FILES): el total del que esta métrica es una parte. - «Número de ficheros Java» (
J), «HTML» (HTML) y «XML» (XML): los otros recuentos por tecnología. - «Líneas de Kotlin» (
L(KT)): el mismo censo medido en líneas.
En las herramientas
Stau Metro (NumKotlinFilesModule, NumKotlinFilesProject). Solo se calcula cuando el plugin de Kotlin del IDE
está presente. Cuenta los ficheros que el IDE interpreta como fuente Kotlin y que no son scripts: en un módulo con
K.kt, build.gradle.kts y A.java, el valor es 1. Valen las reglas de
«FILES» sobre qué ficheros recorre el análisis.