Complejidad ciclomática total
| Sigla | v(G)tot |
| Aspecto | «Complejidad» |
| Se mide en | paquete, módulo, proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Familia | «Métricas de McCabe» |
| Stau Metro | TotalCyclomaticComplexityPackage, TotalCyclomaticComplexityModule, TotalCyclomaticComplexityProject |
En pocas palabras
Suma la complejidad ciclomática de todos los métodos de un paquete, un módulo o el proyecto. Es una medida de cuánta lógica de decisión hay en esa parte del código, en total. Crece con el tamaño, así que no es ni buena ni mala por sí misma.
Qué mide
El volumen de lógica de decisión. Si cada punto de v(G) es, aproximadamente, un caso más que probar, la suma
da una idea del esfuerzo de prueba que representa una parte del código. Es la versión agregada de lo que la
«complejidad ponderada de los métodos» (WMC) es para una clase.
No tiene dirección: un módulo grande tiene un total alto porque hace muchas cosas, no porque esté mal hecho. Sirve para comparar, para priorizar y para ver tendencias.
Cómo se calcula
Con la «complejidad ciclomática» de cada método:
Como cada método vale al menos 1, el total es siempre mayor o igual que el número de métodos, y la diferencia es el número de decisiones de toda esa parte del código.
Ejemplo
Un paquete con tres métodos de complejidad 1, 4 y 7 tiene v(G)tot = 1 + 4 + 7 = 12, y 12 - 3 = 9 decisiones.
Su «complejidad ciclomática promedio» es 12 / 3 = 4.0.
Cómo interpretarla
Stau Metro no le da umbral de referencia, y no tendría sentido: el valor depende del tamaño.
- Priorizar. Entre varios paquetes o módulos, el de mayor total es donde más lógica hay que mantener y probar. Es un buen punto de partida para revisar la «cobertura de código».
- Dividir el total por el tamaño. Junto a la media (
v(G)avg) dice si el total viene de muchos métodos sencillos o de métodos complejos; junto a las «líneas de código sin comentarios» (NCLOC), da la densidad de decisiones por línea. - Seguir la evolución. Un total que crece más deprisa que las líneas de código indica que el código nuevo es más condicional que el existente.
Relación con otras métricas
- «Complejidad ciclomática» (
v(G)): la medida por método que se suma, con el mismo recuento. - «Complejidad ciclomática promedio» (
v(G)avg): este total dividido entre el número de métodos. - «Complejidad ponderada de los métodos» (
WMC): la suma por clase, con un recuento que no incluye&&,||nicatchy sin los métodos de las interfaces; por eso la suma de losWMCde un paquete no coincide con suv(G)tot. - «Número de métodos» (
METH): no es una cota inferior del total, porque cuenta también los métodos abstractos y los de las clases anónimas y locales, que aquí no tienen valor propio. - «Líneas de código sin comentarios» (
NCLOC): la medida de tamaño con la que más se correlaciona.
En las herramientas
Stau Metro (TotalCyclomaticComplexityPackage, TotalCyclomaticComplexityModule y
TotalCyclomaticComplexityProject). Suma la v(G) de los métodos con el mismo recuento y el mismo alcance que la
métrica de método CyclomaticComplexity:
- entran todos los métodos no abstractos de los ficheros Java analizados, incluidos los constructores, los métodos
default,staticy privados de las interfaces, y el código de test; un métodonativesuma 1; - los métodos de las clases anónimas o locales declaradas dentro de un método no cuentan aparte: sus decisiones se suman al método que las contiene; los de las clases anónimas de un inicializador de campo y de los cuerpos de las constantes de un enumerado sí cuentan;
- a nivel de paquete entran solo las clases del propio paquete, no las de sus subpaquetes;
- un paquete o un módulo tiene valor desde su primer método contado; el proyecto tiene siempre su fila.
SonarQube. La complejidad ciclomática (complexity) del conjunto del código es, según su documentación,
«básicamente la suma» de las calculadas a nivel de función. Las reglas de recuento por función son las suyas (ver la
página de la «complejidad ciclomática»).
Referencias
- McCabe, T. J. (1976). «A Complexity Measure». IEEE Transactions on Software Engineering, SE-2(4), 308-320. https://ieeexplore.ieee.org/document/1702388
- SonarQube, definición de métricas: https://docs.sonarsource.com/sonarqube-server/latest/user-guide/code-metrics/metrics-definition/