Métricas y Estadísticas (III): GitStats

GitStats, según se indica en la propia web del proyecto, es un generador de estadísticas a partir de la historia de un repositorio Git. Su instalación y uso es tremendamente sencillo, ya que tan sólo debemos clonarnos su repositorio Git en SourceForge de la siguiente manera:

~>git clone git://repo.or.cz/gitstats.git

O bien, instalar el paquete directamente:

~>sudo apt-get install gitstats

Como se puede entender, uno de los requisitos previos será tener instalado Git, además de Python (dado que es el lenguaje empleado en la herramienta para obtener las estadísticas) y GNUPlot, para la realización de los gráficos de resultados a modo de dashboards.

Una vez hecho esto, tan sólo debemos dirigirnos al directorio donde hemos instalado/descargado GitStats, y buscar su ejecutable, que poseerá el mismo nombre. Para comenzar a obtener los resultados, tan sólo debemos realizar una invocación desde línea de comandos de la siguiente manera:

~>./gitstats path_git_repository_to_study path_results

Es decir, como primer argumento indicamos la ubicación del proyecto sobre el que queremos obtener las estadísticas, y como segundo argumento, el path en el que queremos obtener los resultados. Tras un tiempo de procesamiento tras la invocación, tendremos en el directorio indicado todos nuestros resultados en forma de páginas HTML. Podremos comenzar por abrir el fichero llamado "index.html" en el que podremos ver información general del proyecto: nombre del proyecto, número total de líneas de código, número total de ficheros, número de autores, etc. Y a partir de ese momento, sólo nos queda navegar entre los distintos enlaces referidos a actividad, autores, ficheros, líneas, y tags, todo siempre acompañado de gráficos y tablas que facilitan sobremanera la visualización y análisis de los datos obtenidos.

Algunos contras son por ejemplo la imposibilidad de listar los commits y enlazar uno en concreto para conocer sus estadísticas particulares, o consultas sobre las licencias de los ficheros, lenguajes de programación empleados y en definitiva, mucha otra información que sí conseguimos en ohloh.net como comentamos en una entrada anterior, si bien es cierto que ohloh.net no nos ofrece la posibilidad de estudiar los meses (días de la semana, e incluso horas) de mayor actividad, por poner un ejemplo. En definitiva, otra buena herramienta cuyos resultados podemos combinar con los obtenidos por otras vías con tal de completar nuestros estudios sobre un proyecto en concreto.

Por último, indicar que también se encuentran disponibles herramientas similares a GitStats pero destinadas al análisis de repositorios CVS (StatCVS) y Subversion (StatSVN).