Métricas de código

Una referencia en español sobre las métricas de código: tamaño, complejidad, acoplamiento, cohesión, herencia, documentación, tests, diseño de paquetes y algunas más. De cada una dice qué mide, cómo se calcula, cómo se interpreta, de dónde sale y en qué difieren las herramientas que la calculan.

Para empezar

Qué es una métrica, cómo se lee una, las esenciales, rutas de lectura y los errores más frecuentes.

Fundamentos

Teoría de la medición, Goal-Question-Metric, umbrales, agregación y lo que dice la evidencia empírica.

Aspectos de calidad

Una guía por aspecto, con sus métricas y por dónde empezar.

Los aspectos de calidadLos doce aspectos en que se agrupan las métricas de esta referencia, la pregunta que contesta cada uno y cuántas métricas reúne.Guía del aspecto: TamañoQué miden las métricas de tamaño, por cuál empezar, cómo se relacionan y qué no dicen del código.Guía del aspecto: ComplejidadQué mide la complejidad del código, por qué métricas empezar y cuándo elegir la ciclomática, la cognitiva o NPath.Guía del aspecto: AcoplamientoCuánto depende cada parte del código de las demás y cuánto dependen las demás de ella: métricas, cómo se combinan y qué no ven.Guía del aspecto: CohesiónSi las partes de una clase o de un paquete forman una unidad: las variantes de LCOM, TCC y LCC, la cohesión relacional y por qué no se comparan.Guía del aspecto: Herencia y polimorfismoCómo usan las clases la herencia: forma de las jerarquías, qué se hereda, añade o sobrescribe, y los factores MOOD de proyecto.Guía del aspecto: EncapsulaciónCuánto esconde el código tras su interfaz pública: AHF y MHF por visibilidad declarada, E_RAT por uso real, y lo que ninguna ve.Guía del aspecto: DocumentaciónQué miden las métricas de comentarios, Javadoc y TODO, por cuál empezar, cómo se combinan y qué no dicen.Guía del aspecto: TestsQué dicen las métricas estáticas de tests, por cuál empezar, cómo se combinan y por qué no son cobertura.Guía del aspecto: Diseño de paquetesAbstracción, inestabilidad y distancia a la secuencia principal: si las dependencias entre paquetes apuntan hacia lo estable y abstracto.Guía del aspecto: MantenibilidadÍndice de mantenibilidad, ratio de deuda técnica y densidad de defectos: tres formas de resumir cuánto cuesta mantener el código.Guía del aspecto: DuplicaciónQué mide la duplicación de código, los cuatro tipos de clon y cómo leer la densidad de líneas duplicadas.Guía del aspecto: Evolución del códigoRotación, acoplamiento de cambio, puntos calientes y propiedad: métricas del historial de versiones y cómo cruzarlas con las del código.

Métricas

Una página por métrica: qué mide, cómo se calcula, cómo se interpreta y qué dicen las herramientas.

Familias

Los conjuntos clásicos: Chidamber y Kemerer, MOOD, Martin, Halstead, McCabe y los demás.

Referencia

Cómo se relacionan las métricas, qué calcula cada herramienta, el glosario y la bibliografía.