git log - explorando el historial de commits en Git

Publicado el Miércoles, 8 de agosto de 2012

Pro Git

Leyendo Pro Git en el capítulo 2 nos encontramos cómo explorar el historial de commits. El comando para ver el historial de nuestro proyecto es git log.

Normalmente git log muestra algo así:

commit 2f01d06c52340e658d0458bd48b86db0818f1923
Author: Fernando Briano 
Date:   Mon Aug 6 16:19:46 2012 -0300

    Updates Rails

commit 86cbc78f1ba66aaa0fb4ee608c17c3edbad04fc2
Author: Fernando Briano 
Date:   Mon Aug 6 15:56:47 2012 -0300

    Removes test/ folder
    Updates gems

Pero hay varios parámetros interesantes para aprovechar más la herramienta. Los dejo por acá para tener como referencia:

Parámetro Resultado

-p Muestra el diff introducido en cada commit

-n Siendo n un número, muestra los últimos n commits.

--stat Muestra estadísticas abreviadas de cada commit: archivos modificados, eliminados o agregados, líneas modificadas y un resumen.

--pretty

Cambia el formato de la salida de git log. Algunos por defecto son oneline, short, full y fuller. Podemos especificar el formato que más nos guste usando las siguientes opciones:

%H	Hash del commit
%h	Hash abreviado del commit
%T	Hash del árbol
%t	Hash abreviado del árbol
%P	Hashes padre
%p	Hashes padre abreviados
%an	Nombre del autor
%ae	E-Mail del autor
%ad	Fecha del autor
%ar	Fecha del autor, relativa
%cn	Nombre del committer
%ce	E-mail del committer
%cd	Fecha del committer
%cr	Fecha del committer, relativa
%s	Asunto

Ejemplo: git log --pretty=format:"%H - %an : %s"

--graph Muestra una gráfica ASCII con la historia de branches y merges.

--since, --after, --until, --before Limitar los commits a las fechas definidas (ej: --since=2.weeks)

--author, --committer Mostrar commits cuyo autor o committer machee con el string especificado

--grep Permite buscar commits por palabras en el mensaje del commit

path Permite especificar un nombre de archivo o directorio, para ver commits que introdujeron cambios en ese archivo.

Para no tener que recordar tanto comando, una vez que tenemos más o menos definido el formato que nos queda cómodo, podemos agregarlo como alias al bashrc con algo como esto:

alias gl='git log --stat --pretty=format:"%H - %an : %s"'

Pro Git es ahora el libro oficial de Git. Recuerden que pueden leerlo online, o comprarlo en papel en su tienda de libros favorita. Peden leer más información sobre git log en Git Basics - Viewing the Commit History.