Últimamente tengo que estar mirando mucho código que no es mío y, como todo el mundo sabe (¡o debiera! xD) el código de un ente y de otro pueden (y serán) muy diferentes, o hasta el mismo estilo de programación de una persona puede variar con el tiempo o con las necesidades/obligaciones/malestares/etc que tuviera en el momento de la creación de dicho código.

Y claro, una de las fases de vida de un proyecto (y la que es la más larga y tediosa), es la manutención de dicho código.

Así que nos encontramos con que hay que ampliar/mejorar/arreglar/etc un cacho de trozo de programa que sabe alguien para que sirve y que no hay alma en pena que entienda las malevolencias que debe hacer (yo perjuro que es una maldición en arameo), pero hay que tragarse el ego (nadie lleva bien que le insulten) y tratar de entender las maldiciones que suelta dicho ente.

Bien, lo que se suele decir es que con una buena documentación previa y con comentarios en el código se puede hacer ésto más o menos bien. Con esta premisa estoy de acuerdo, pero la considero insuficiente.

Lo siguiente, una vez que entiendes un poco lo que hace, es probarlo y ver que rejóspitos hace. Con ésto aprendemos más de la misión del ente y como lo hace. Si encima tenemos una batería de pruebas con el que saturarlo, tendremos todavía más información, dado que nos encontraremos con un contexto “virtual” de dicho ente.

Vale, ya lo tenemos, sabemos que hace y sabemos que queremos modificarlo y, por eso, atacamos al código para ver cómo lo hace… Y aquí nos quedamos con los comentarios anteriores y el saltar de función en función manualmente (o con ayudas del IDE haciendo click encima de la función, o viendo una lista de llamadas)… ¡Y nada más!

No sé si os pasa a vosotros, pero personalmente echo mucho de menos que no haya una herramienta visual para ver como cada función se comunica con otras, ver las llamadas que salen y las que entran, hasta inclusive inclustar eso en un debugger. Sé que hay por ahí una herramienta de pago que hace algo parecido a ésto (creo que está todavía en una versión beta) y que estoy seguro que mejora la interpretación del código antiguo de una manera antológica.

Imaginaros el que estáis viendo una función grande, que no sabéis muy bien como funciona… Encima llama a muchas funciones externas con un montón de parámetros… Tienes que dedicarle mucho tiempo por mucha información que nos den los IDEs actuales (o los grep de toda la vida :D). Con una herramienta que nos mostrara visualmente cada función (o similar) como un ente, con las llamadas a otras y los parámetros pasados y así poder ir navegando a través de las funciones rápidamente y visualmente, nos ayudaría enormemente.

Después de tantos diagramas, comentarios, documentación… ¿por qué una herramienta tan básica no existe?