Número de dependencias transitivas de paquete

Actualizado el 15 de noviembre de 2026

Sigla PDcy*
Aspecto «Acoplamiento»
Se mide en paquete
Tipo de valor entero, mínimo 0
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumTransitiveDependencyPackagesPackage

En pocas palabras

Cuenta todos los paquetes de los que depende un paquete, directa o indirectamente. Si app usa service, y service usa model y repo, entonces app depende de tres paquetes aunque solo nombre uno. Es lo que el paquete arrastra consigo si se reutiliza en otro sitio, y lo que en parte hay que entender para trabajar con él.

Qué mide

El alcance de las dependencias de un paquete. La «dependencia directa» (PDcy) dice a quién llama un paquete; la transitiva dice de cuánto del sistema depende en último término. Dos paquetes con PDcy igual a 1 pueden ser muy distintos: uno depende de un paquete de utilidades que no depende de nada; el otro, de un paquete que arrastra el resto del proyecto.

Cómo se calcula

Es el número de paquetes alcanzables desde P en el grafo de dependencias entre paquetes, siguiendo flechas a cualquier número de pasos, sin contar el propio P. Es el tamaño de la clausura transitiva del paquete en el grafo.

Si P está dentro de un ciclo, el recorrido vuelve a él; el propio paquete se descuenta igualmente, y los demás miembros del ciclo sí cuentan.

Ejemplo

Con los paquetes del ejemplo de «PDcy»:

Paquete PDcy Alcanza PDcy*
app 1 service, model, repo 3
service 2 model, repo 2
repo 1 model 1
model 0 — 0

Con un ciclo: si a depende de b, b de c, c de a y además c de d, cada uno de a, b y c alcanza a los otros dos y a d, así que vale 3; d vale 0.

Cómo interpretarla

  • La diferencia PDcy* - PDcy es lo que el paquete hereda sin nombrarlo. Una diferencia grande indica que sus dependencias directas son paquetes «pesados».
  • Un valor cercano al número total de paquetes del proyecto significa que el paquete depende, en la práctica, de todo. Es habitual en el punto de entrada de la aplicación y preocupante en un paquete de dominio.
  • Si muchos paquetes comparten casi el mismo valor alto, suele haber un ciclo grande en medio: lo confirma el «número de dependencias cíclicas».

Ojo. Una dependencia transitiva no siempre se nota al cambiar el código: que app alcance model a través de service no significa que un cambio en model rompa app. La métrica da la cota superior del alcance.

Para profundizar

Las dependencias transitivas entre componentes son la base del diseño físico de Lakos (1996), y de su dependencia acumulada de componentes, que agrega este tipo de recuento sobre todo el sistema. Ver la «dependencia acumulada de componentes».

Una propiedad útil: todos los miembros de un ciclo tienen el mismo valor, porque cada uno alcanza lo mismo que los demás. Si una tabla muestra un bloque de paquetes con idéntico PDcy*, es probable que formen un ciclo.

Relación con otras métricas

En las herramientas

Stau Metro (NumTransitiveDependencyPackagesPackage). Recorre el mismo grafo que PDcy, con sus mismas reglas (sin clases de test, sin librerías, solo referencias desde código Java del ámbito, pero con los paquetes de destino que queden fuera de él), y cuenta los paquetes alcanzables a cualquier distancia, sin el propio. Los paquetes de un ciclo comparten el mismo valor. Como solo se recorre el código del ámbito, una cadena que siga por código que queda fuera de él se corta ahí.

Referencias

  • Lakos, J. (1996). Large-Scale C++ Software Design. Addison-Wesley.